1CLUBAK(1)                  ClusterShell User Manual                  CLUBAK(1)
2
3
4

NAME

6       clubak - format output from clush/pdsh-like output and more
7

SYNOPSIS

9       clubak [ OPTIONS ]
10

DESCRIPTION

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  additonal  features.  For  instance,  clubak always displays its
15       results 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

INVOCATION

25       clubak should be started with connected standard input.
26

OPTIONS

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       -G, --groupbase
46              do not display group source prefix (always @groupname)
47
48       -S SEPARATOR, --separator=SEPARATOR
49              node / line content separator string (default: :)
50
51       -F, --fast
52              faster but memory hungry mode (preload all messages per node)
53
54       -T, --tree
55              message tree trace mode; switch to  enable  ClusterShell.MsgTree
56              trace  mode,  all keys/nodes being kept for each message element
57              of the tree, thus allowing special output gathering
58
59       --color=WHENCOLOR
60              whether to use ANSI colors to  surround  node  or  nodeset  pre‐
61              fix/header with escape sequences to display them in color on the
62              terminal. WHENCOLOR is never, always or auto (which use color if
63              standard  output  refers  to  a  terminal). Color is set to [34m
64              (blue foreground text) and cannot be modified.
65

EXIT STATUS

67       An exit status of zero indicates success of the clubak command.
68

EXAMPLES

70       1. clubak can be used to gather some recorded clush(1) results:
71
72       Record clush(1) results in a file:
73              # clush -w node[1-7] uname -r >/tmp/clush_output
74              # clush -w node[32-159] uname -r >>/tmp/clush_output
75
76
77       Display file gathered results (in line-mode):
78              # clubak -bL </tmp/clush_output
79
80
81       2. Another example, iterate over node* text files in current  directory
82          and gather characters count for all of them:
83             # find -name "node*" -exec wc -c {} ; | awk '{ gsub("./","",$2); print $2": "$1 }' | clubak -bL
84             node[1,3]: 7
85             node2: 9
86
87

SEE ALSO

89       clush(1), nodeset(1), groups.conf(5).
90

BUG REPORTS

92       Use the following URL to submit a bug report or feedback:
93              http://sourceforge.net/apps/trac/clustershell/report
94

AUTHOR

96       Stephane Thiell, CEA DAM  <stephane.thiell@cea.fr>
97

99       CeCILL-C V1
100
101
102
103
1041.5.1                             2011-06-09                         CLUBAK(1)
Impressum