Provided by: clustershell_1.5.1-1build1_all bug


       groups.conf - Configuration file for ClusterShell external node groups


       The  ClusterShell  library  obtains node groups configuration options from the system-wide
       configuration file /etc/clustershell/groups.conf.

       The configuration file has a format in the style of RFC 822 composed of  several  sections
       which may be present in any order. Sections are:

       Main   General options definition


              External  commands  definition  for  group  source Group_source (map, all, list and

       Configuration parameters of the Main section are described below.

              Specify the default group source used by the NodeSet parser when the user does  not
              specify explicitly the group source (eg. "@io").

       Configuration parameters of each group source section are described below.

       map    Specify  the  external  shell  command used to resolve a group name into a nodeset,
              list of nodes or list of nodeset (separated by  space  characters  or  by  carriage
              returns). The variable $GROUP is replaced before executing the command.

       all    Optional external shell command that should return a nodeset, list of nodes or list
              of nodeset of all nodes for this group source. If not specified, the  library  will
              try  to  resolve  all  nodes  by  using the list external command in the same group
              source followed by map for each group.

       list   Optional external shell command that should return the list of all groups for  this
              group source (separated by space characters or by carriage returns).

              Optional  external  shell  command  used to find the group(s) of a single node. The
              variable $NODE is previously replaced. If this upcall is not specified, the reverse
              operation  is  computed  in  memory  by  the library from the list and map external
              calls. Also, if the number of nodes to  reverse  is  greater  than  the  number  of
              available groups, the reverse external command is avoided automatically.

       Each  external  command  might  return  a  non-zero  return code when the operation is not
       doable. But if the call return zero, for instance, for a non-existing group, the user will
       not receive any error when trying to resolve such unknown group.  The desired behaviour is
       up to the system administrator.


       All external command results are cached in memory to avoid multiple calls.


       Simple configuration file for local groups and slurm partitions binding.

       default: local

       map:  awk -F: '/^$GROUP:/ {print $2}' /etc/clustershell/groups
       list: awk -F: '/^w/ {print $1}' /etc/clustershell/groups

       map: sinfo -h -o "%N" -p $GROUP
       all: sinfo -h -o "%N"
       list: sinfo -h -o "%P"
       reverse: sinfo -h -N -o "%P" -n $NODE



              System-wide external node groups configuration file.


       clush(1), clubak(1), nodeset(1)


       Stephane Thiell, CEA DAM  <>


       CeCILL-C V1