You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
node / line content separator string (default: \fI:\fP)
82
82
.TP
83
-
.B\-F\fP,\fB\-\-fast
83
+
.B\-F\fP,\fB\-\-fast
84
84
faster but memory hungry mode (preload all messages per node)
85
85
.TP
86
-
.B\-T\fP,\fB\-\-tree
86
+
.B\-T\fP,\fB\-\-tree
87
87
message tree trace mode; switch to enable \fBClusterShell.MsgTree\fP trace mode, all keys/nodes being kept for each message element of the tree, thus allowing special output gathering
88
88
.TP
89
89
.BI\-\-color\fB=WHENCOLOR
90
90
\fBclush\fP can use NO_COLOR, CLICOLOR and CLICOLOR_FORCE environment variables. \fB\-\-color\fP command line option always takes precedence over environment variables. NO_COLOR takes precedence over CLICOLOR_FORCE which takes precedence over CLICOLOR. \fB\-\-color\fP tells whether to use ANSI colors to surround node or nodeset prefix/header with escape sequences to display them in color on the terminal. \fIWHENCOLOR\fP is \fBnever\fP, \fBalways\fP or \fBauto\fP (which use color if standard output refers to a terminal). Color is set to [34m (blue foreground text) and cannot be modified.
91
91
.TP
92
-
.B\-\-diff
92
+
.B\-\-diff
93
93
show diff between gathered outputs
94
94
.UNINDENT
95
95
.SH EXIT STATUS
@@ -121,7 +121,7 @@ Another example, iterate over \fInode*\fP text files in current directory and ga
@@ -70,22 +70,22 @@ use alternate config file for groups.conf(5)
70
70
.BCommands:
71
71
.INDENT7.0
72
72
.TP
73
-
.B\-c\fP,\fB\-\-count
73
+
.B\-c\fP,\fB\-\-count
74
74
show number of nodes in nodeset(s)
75
75
.TP
76
-
.B\-e\fP,\fB\-\-expand
76
+
.B\-e\fP,\fB\-\-expand
77
77
expand nodeset(s) to separate nodes (see also \-S \fISEPARATOR\fP)
78
78
.TP
79
-
.B\-f\fP,\fB\-\-fold
79
+
.B\-f\fP,\fB\-\-fold
80
80
fold nodeset(s) (or separate nodes) into one nodeset
81
81
.TP
82
-
.B\-l\fP,\fB\-\-list
82
+
.B\-l\fP,\fB\-\-list
83
83
list node groups, list node groups and nodes (\fB\-ll\fP) or list node groups, nodes and node count (\fB\-lll\fP). When no argument is specified at all, this command will list all node group names found in selected group source (see also \-s \fIGROUPSOURCE\fP). If any nodesets are specified as argument, this command will find node groups these nodes belongs to (individually). Optionally for each group, the fraction of these nodes being member of the group may be displayed (with \fB\-ll\fP), and also member count/total group node count (with \fB\-lll\fP). If a single hyphen\-minus (\-) is given as a nodeset, it will be read from standard input.
84
84
.TP
85
-
.B\-r\fP,\fB\-\-regroup
85
+
.B\-r\fP,\fB\-\-regroup
86
86
fold nodes using node groups (see \-s \fIGROUPSOURCE\fP)
87
87
.TP
88
-
.B\-\-groupsources
88
+
.B\-\-groupsources
89
89
list all active group sources (see \fBgroups.conf\fP(5))
90
90
.UNINDENT
91
91
.TP
@@ -105,23 +105,23 @@ calculate symmetric difference between sets
105
105
.BOptions:
106
106
.INDENT7.0
107
107
.TP
108
-
.B\-a\fP,\fB\-\-all
108
+
.B\-a\fP,\fB\-\-all
109
109
call external node groups support to display all nodes
110
110
.TP
111
111
.BI\-\-autostep\fB=AUTOSTEP
112
-
enable a\-b/step style syntax when folding nodesets, value is min node count threshold (integer \(aq4\(aq, percentage \(aq50%\(aq or \(aqauto\(aq). If not specified, auto step is disabled (best for compatibility with other cluster tools. Example: autostep=4, \(dqnode2 node4 node6\(dq folds in node[2,4,6] but autostep=3, \(dqnode2 node4 node6\(dq folds in node[2\-6/2].
112
+
enable a\-b/step style syntax when folding nodesets, value is min node count threshold (integer \(aq4\(aq, percentage \(aq50%\(aq or \(aqauto\(aq). If not specified, auto step is disabled (best for compatibility with other cluster tools. Example: autostep=4, "node2 node4 node6" folds in node[2,4,6] but autostep=3, "node2 node4 node6" folds in node[2\-6/2].
113
113
.TP
114
-
.B\-d\fP,\fB\-\-debug
114
+
.B\-d\fP,\fB\-\-debug
115
115
output more messages for debugging purpose
116
116
.TP
117
-
.B\-q\fP,\fB\-\-quiet
117
+
.B\-q\fP,\fB\-\-quiet
118
118
be quiet, print essential output only
119
119
.TP
120
-
.B\-R\fP,\fB\-\-rangeset
120
+
.B\-R\fP,\fB\-\-rangeset
121
121
switch to RangeSet instead of NodeSet. Useful when
122
122
working on numerical cluster ranges, eg. 1,5,18\-31
123
123
.TP
124
-
.B\-G\fP,\fB\-\-groupbase
124
+
.B\-G\fP,\fB\-\-groupbase
125
125
hide group source prefix (always \fI@groupname\fP)
return sliced off result; examples of SLICE_RANGESET are \(dq0\(dq for simple index selection, or \(dq1\-9/2,16\(dq for complex rangeset selection
135
+
return sliced off result; examples of SLICE_RANGESET are "0" for simple index selection, or "1\-9/2,16" for complex rangeset selection
136
136
.TP
137
137
.BI\-\-split\fB=MAXSPLIT
138
138
split result into a number of subsets
139
139
.TP
140
-
.B\-\-contiguous
141
-
split result into contiguous subsets (ie. for nodeset, subsets will contain nodes with same pattern name and a contiguous range of indexes, like foobar[1\-100]; for rangeset, subsets with consists in contiguous index ranges)\(dq\(dq\(dq
140
+
.B\-\-contiguous
141
+
split result into contiguous subsets (ie. for nodeset, subsets will contain nodes with same pattern name and a contiguous range of indexes, like foobar[1\-100]; for rangeset, subsets with consists in contiguous index ranges)"""
142
142
.TP
143
143
.BI\-\-axis\fB=RANGESET
144
144
for nD nodesets, fold along provided axis only. Axis are indexed from 1 to n and can be specified here either using the rangeset syntax, eg. \(aq1\(aq, \(aq1\-2\(aq, \(aq1,3\(aq, or by a single negative number meaning that the indices is counted from the end. Because some nodesets may have several different dimensions, axis indices are silently truncated to fall in the allowed range.
@@ -225,7 +225,7 @@ node[0\-4,11\-13]
225
225
.sp
226
226
This computes a folded nodeset containing nodes found in group @gpu and @slurm:bigmem, but not in both, minus the nodes found in odd chassis groups from 1 to 9.
227
227
.TP
228
-
.B\(dqAllnodes\(dqextension
228
+
.B"Allnodes"extension
229
229
The \fB@*\fP and \fB@SOURCE:*\fP special notations may be used in extended patterns to represent all nodes (in SOURCE) according to the \fIall\fP external shell command (see \fBgroups.conf\fP(5)) and are equivalent to:
230
230
.INDENT7.0
231
231
.INDENT3.5
@@ -469,7 +469,7 @@ dc3n[4\-5]
469
469
.SH HISTORY
470
470
.sp
471
471
\fBcluset\fP was added in 1.7.3 to avoid a conflict with xCAT\(aqs \fBnodeset\fP
472
-
command and also to conform with ClusterShell\(aqs \(dqclu*\(dq command nomenclature.
472
+
command and also to conform with ClusterShell\(aqs "clu*" command nomenclature.
Copy file name to clipboardExpand all lines: doc/man/man1/clush.1
+1-4Lines changed: 1 addition & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
.\" Man page generated from reStructuredText.
2
2
.
3
-
.TH CLUSH 1 "2023-02-09" "1.9.1" "ClusterShell User Manual"
3
+
.TH CLUSH 1 "2023-09-29" "1.9.2" "ClusterShell User Manual"
4
4
.SH NAME
5
5
clush \- execute shell commands on a cluster
6
6
.
@@ -165,9 +165,6 @@ optional \fBgroups.conf\fP(5) group source to use
165
165
.B\-n\fP,\fB\-\-nostdin
166
166
do not watch for possible input from stdin; this should be used when \fBclush\fP is run in the background (or in scripts).
167
167
.TP
168
-
.B\-\-sudo
169
-
enable sudo password prompt: a prompt will ask for your sudo password and sudo will be used to run your commands on the target nodes. The password must be the same on all target nodes. The actual sudo command used by \fBclush\fP can be changed in \fBclush.conf\fP(5) or in command line using \fB\-Osudo_command="..."\fP\&. The configured \fBsudo_command\fP must be able to read a password on stdin followed by a new line (which is what \fBsudo\-S\fP does).
0 commit comments