Provided by: clustershell_1.5.1-1_all bug

NAME
       clush.conf - Configuration file for clush


DESCRIPTION
       clush(1)  obtains  configuration  options from the following sources in
       the following order:

          1. command-line options

          2. user configuration file (~/.clush.conf)

          3. system-wide configuration file (/etc/clustershell/clush.conf)

       For each parameter, the first obtained value will be used.

       The configuration file has a format in the style of RFC 822 composed of
       one main section:

       Main   Program options definition

   [Main]
       Configuration parameters of the Main section are described below.

       fanout Size of the sliding window of ssh connectors.

       connect_timeout
              Timeout  in  seconds  to  allow  a connection to establish. This
              parameter is passed to ssh. If set to 0, no timeout occurs.

       command_timeout
              Timeout in seconds to allow a  command  to  complete  since  the
              connection  has  been  established.  This parameter is passed to
              ssh.  In addition, the ClusterShell  library  ensures  that  any
              commands   complete   in   less   than   (   connect_timeout   +
              command_timeout ). If set to 0, no timeout occurs.

       color  Whether  to  use  ANSI  colors  to  surround  node  or   nodeset
              prefix/header  with escape sequences to display them in color on
              the terminal. Valid arguments are never, always or  auto  (which
              use  color if standard output/error refer to a terminal). Colors
              are set to [34m (blue foreground text) for stdout and [31m  (red
              foreground text) for stderr, and cannot be modified.

       fd_max Maximum  number  of  open  file  descriptors permitted per clush
              process (soft resource limit for open  files).  This  limit  can
              never  exceed  the  system  (hard)  limit. The fd_max (soft) and
              system (hard)  limits  should  be  high  enough  to  run  clush,
              although their values depend on your fanout value.

       history_size
              Set  the  maximum  number  of  history  entries saved in the GNU
              readline history list. Negative values imply  unlimited  history
              file size.

       node_count
              Should  clush  display  additional  (node  count) information in
              buffer header? (yes/no)

       verbosity
              Set the verbosity level: 0 (quiet), 1 (default), 2 (verbose)  or
              more (debug).

       ssh_user
              Set the ssh user to use for remote connection (default is to not
              specify).

       ssh_path
              Set the ssh binary path to use for remote connection (default is
              /usr/bin/ssh).

       ssh_options
              Set additional options to pass to the underlying ssh command.


EXAMPLES
       Simple configuration file.

   clush.conf
       [Main]
       fanout: 128
       connect_timeout: 15
       command_timeout: 0
       history_size: 100
       color: auto
       fd_max: 10240
       node_count: yes


FILES
       ~/.clush.conf

              This is the per-user configuration file.

       /etc/clustershell/clush.conf

              System-wide configuration file.


HISTORY
       As  of  ClusterShell version 1.3, the External section has been removed
       from clush.conf.  External commands whose outputs were  used  by  clush
       (-a,  -g,  -X)  are  now  handled  by the library itself and defined in
       groups.conf(5).


SEE ALSO
       clush(1), nodeset(1), groups.conf(5)

       http://clustershell.sourceforge.net/


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


COPYRIGHT
       CeCILL-C V1