1CLUBAK(1) ClusterShell User Manual CLUBAK(1)
2
3
4
6 clubak - format output from clush/pdsh-like output and more
7
9 clubak [ OPTIONS ]
10
12 clubak formats text from standard input containing lines of the form
13 "node:output". It is fully backward compatible with dshbak(1) but pro‐
14 vides additional features. For instance, clubak always displays its re‐
15 sults sorted by node/nodeset.
16
17 You do not need to use clubak when using clush(1) as all output format‐
18 ting features are already included in. It is provided for other usages,
19 like post-processing results of the form "node:output".
20
21 Like clush(1), clubak uses the ClusterShell.MsgTree module of the Clus‐
22 terShell library (see pydoc ClusterShell.MsgTree).
23
25 clubak should be started with connected standard input.
26
28 --version
29 show clubak version number and exit
30
31 -b, -c gather nodes with same output (-c is provided for dshbak(1) com‐
32 patibility)
33
34 -d, --debug
35 output more messages for debugging purpose
36
37 -L disable header block and order output by nodes
38
39 -r, --regroup
40 fold nodeset using node groups
41
42 -s GROUPSOURCE, --groupsource=GROUPSOURCE
43 optional groups.conf(5) group source to use
44
45 --groupsconf=FILE
46 use alternate config file for groups.conf(5)
47
48 -G, --groupbase
49 do not display group source prefix (always @groupname)
50
51 -S SEPARATOR, --separator=SEPARATOR
52 node / line content separator string (default: :)
53
54 -F, --fast
55 faster but memory hungry mode (preload all messages per node)
56
57 -T, --tree
58 message tree trace mode; switch to enable ClusterShell.MsgTree
59 trace mode, all keys/nodes being kept for each message element
60 of the tree, thus allowing special output gathering
61
62 --color=WHENCOLOR
63 clush can use NO_COLOR, CLICOLOR and CLICOLOR_FORCE environment
64 variables. --color command line option always takes precedence
65 over environment variables. NO_COLOR takes precedence over CLI‐
66 COLOR_FORCE which takes precedence over CLICOLOR. --color tells
67 whether to use ANSI colors to surround node or nodeset pre‐
68 fix/header with escape sequences to display them in color on the
69 terminal. WHENCOLOR is never, always or auto (which use color if
70 standard output refers to a terminal). Color is set to [34m
71 (blue foreground text) and cannot be modified.
72
73 --diff show diff between gathered outputs
74
76 An exit status of zero indicates success of the clubak command.
77
79 1. clubak can be used to gather some recorded clush(1) results:
80
81 Record clush(1) results in a file:
82 # clush -w node[1-7] uname -r >/tmp/clush_output
83 # clush -w node[32-159] uname -r >>/tmp/clush_output
84
85
86 Display file gathered results (in line-mode):
87 # clubak -bL </tmp/clush_output
88
89
90 2. Another example, iterate over node* text files in current directory
91 and gather characters count for all of them:
92 # find -name "node*" -exec wc -c {} ; | awk '{ gsub("./","",$2); print $2": "$1 }' | clubak -bL
93 node[1,3]: 7
94 node2: 9
95
96
98 cluset(1), clush(1), nodeset(1), groups.conf(5).
99
100 http://clustershell.readthedocs.org/
101
103 Use the following URL to submit a bug report or feedback:
104 https://github.com/cea-hpc/clustershell/issues
105
107 Stephane Thiell <sthiell@stanford.edu>
108
110 GNU Lesser General Public License version 2.1 or later (LGPLv2.1+)
111
112
113
114
1151.8.4 2021-11-03 CLUBAK(1)