NAME

       pshbak - format output from pdsh command

SYNOPSIS

       pshbak [OPTION]...

DESCRIPTION

       pshbak  formats  output from parallel shells such as pdsh and dsh, into a more readable output. It can be
       used as a drop-in replacement for dshbak.

       Output from pdsh, where each line is prefixed by a hostname followed by  a  colon,  is  read  via  stdin,
       collected  per  hostname,  and  printed  in a per hostname fashion.  With the often used -c option, hosts
       having identical output are collected and the output is printed only once.

OPTIONS

       -c, --collect
              Collect hosts having identical output and make the identical  output  appear  to  only  once.  The
              collected hostlist representing the nodes is shown in the header before the output.

       -d, --unified-diff
              Print  only  the  most  frequent output in full. Then print any diverging output as a unified diff
              relative the most frequent output. This mode of operation implies the --collect option

       -C, --collect-similar
              Collect hosts having relatively similar output, and print the identical part of  the  output  only
              once.  The  parts  of  the  output which differs among the hosts are replaced with enumerated tags
              ([DIFF1], [DIFF2], ...).  For two outputs to be considered relatively similar, they  must  contain
              the  same number of lines, and in total, the lines must not be too different.  The differences can
              be printed using either the --format-diff or the --spliced-diff option.

       --spliced-diff
              When using --collect-similar, lines containing  differences  are  prefixed  by  its  hostname  and
              printed together with the collected part of the output.

       --no-collected
              When  using  --collect-similar,  don't  print  the  collected  part. This is intended to be useful
              together with the --format-diff option.

       --format-diff FORMAT
              When using --collect-similar, after to collected part, format and print the differences  for  each
              host  as  specified  by  FORMAT.   FORMAT  is expected to be a text string containing zero or more
              occurrences of $h, $1, $2, $3..., which in the output will be replaced by hostname, DIFF1,  DIFF2,
              DIFF3, etc.

       -n, --count
              Show the number of hosts in the header (before the hostlist).

       -g, --with-garbage
              Also print any output not conforming to the "host:output" format in a special NON-FORMATTED OUTPUT
              section  before  the correctly formatted data. The default mode of operation is to silently ignore
              non-conforming lines.

       --color [yes|no]
              Control whether ANSI color codes should be used.  The default behavior is  to  enable  ANSI  color
              codes when writing to a normal tty, and disable it otherwise.

       -h, --help
              Display a brief help message.

EXAMPLES

       Collect information about the running kernel version in a compute cluster having node names n1, n2, ...,
       n400 using pdsh and pshbak:
              pdsh -w n[1-400] uname -r | pshbak -c

AUTHOR

       Written by Mattias Slabanja <slabanja@chalmers.se>.

       The program is published at http://www.nsc.liu.se/~kent/python-hostlist/

SEE ALSO

       hostlist(1), pdsh(1), dshbak(1)

       The    hostlist    expression    syntax    is    used    by    several   programs   developed   at   LLNL
       (https://computing.llnl.gov/linux/), for example SLURM (https://computing.llnl.gov/linux/slurm/) and Pdsh
       (http://code.google.com/p/pdsh/).

       See the HOSTLIST EXPRESSIONS section of the pdsh(1) manual page for a short introduction to the  hostlist
       syntax.

                                                  Version 2.2.1                                        pshbak(1)