Provided by: clustershell_1.5.1-1build1_all bug

NAME

       nodeset - compute advanced nodeset operations

SYNOPSIS

          nodeset [COMMAND] [OPTIONS] [nodeset1 [-ixX] nodeset2|...]

DESCRIPTION

       The   nodeset   command   is  an  utility  command  provided  with  the
       ClusterShell library which implements some features of the NodeSet  and
       RangeSet  classes.   It  provides  easy manipulation of indexed cluster
       nodes and node groups.

OPTIONS

          --version
                 show program's version number and exit

          -h, --help
                 show this help message and exit

          -s GROUPSOURCE, --groupsource=GROUPSOURCE
                 optional groups.conf(5) group source to use

          Commands:

                 -c, --count
                        show number of nodes in nodeset(s)

                 -e, --expand
                        expand nodeset(s) to separate nodes

                 -f, --fold
                        fold nodeset(s) (or separate nodes) into one nodeset

                 -l, --list
                        list node groups, followed by corresponding nodes when
                        specified  two  times (-ll), and also nodes count when
                        specified three times (-lll). See also -s GROUPSOURCE.

                 -r, --regroup
                        fold nodes using node groups (see -s GROUPSOURCE)

                 --groupsources
                        list all configured group sources (see groups.conf(5))

          Operations:

                 -x SUB_NODES, --exclude=SUB_NODES
                        exclude specified nodeset

                 -i AND_NODES, --intersection=AND_NODES
                        calculate nodesets intersection

                 -X XOR_NODES, --xor=XOR_NODES
                        calculate symmetric difference between nodesets

          Options:

                 -a, --all
                        call external node groups support to display all nodes

                 --autostep=AUTOSTEP
                        auto step threshold number when folding  nodesets,  if
                        not   specified,   auto  step  is  disabled.  Example:
                        autostep=4, "node2 node4 node6" folds  in  node[2,4,6]
                        but   autostep=3,   "node2   node4   node6"  folds  in
                        node[2-6/2]

                 -d, --debug
                        output more messages for debugging purpose

                 -q, --quiet
                        be quiet, print essential output only

                 -R, --rangeset
                        switch to RangeSet instead  of  NodeSet.  Useful  when
                        working on numerical cluster ranges, eg. 1,5,18-31

                 -G, --groupbase
                        hide group source prefix (always @groupname)

                 -S SEPARATOR, --separator=SEPARATOR
                        separator   string  to  use  when  expanding  nodesets
                        (default: ' ')

                 -I SLICE_RANGESET, --slice=SLICE_RANGESET
                        return sliced off result; examples  of  SLICE_RANGESET
                        are  "0" for simple index selection, or "1-9/2,16" for
                        complex rangeset selection

                 --split=MAXSPLIT
                        split result into a number of subsets

       For a short explanation of these options, see -h, --help.

       If a single hyphen-minus (-) is given as a nodeset,  it  will  be  read
       from standard input.

EXTENDED PATTERNS

       The  nodeset  command  benefits  from  ClusterShell  1.3  NodeSet basic
       arithmetic addition. This feature extends recognized string patterns by
       supporting  operators  matching  all Operations seen previously. String
       patterns are read from left  to  right,  by  proceeding  any  character
       operators accordinately.

       Supported character operators

              ,

                     indicates  that  the union of both left and right nodeset
                     should be computed before continuing

              !

                     indicates the difference operation

              &

                     indicates the intersection operation

              ^

                     indicates the symmetric difference (XOR) operation

              Care should be taken to escape these characters as  needed  when
              the shell does not interpret them literally.

       Examples of use of extended patterns

              $ nodeset -f node[0-7],node[8-10]
              node[0-10]

              $ nodeset -f node[0-10]!node[8-10]
              node[0-7]

              $ nodeset -f node[0-10]&node[5-13]
              node[5-10]

              $ nodeset -f node[0-10]^node[5-13]
              node[0-4,11-13]

       Example of advanced usage

              $ nodeset -f @gpu^@slurm:bigmem!@chassis[1-9/2]

              This  computes  a folded nodeset containing nodes found in group
              @gpu and @slurm:bigmem, but not in both, minus the  nodes  found
              in odd chassis groups from 1 to 9.

EXIT STATUS

       An  exit  status  of  zero  indicates success of the nodeset command. A
       non-zero exit status indicates failure.

EXAMPLES

       Getting the node count

              $ nodeset -c node[0-7,32-159]
              136

              $ nodeset -c node[0-7,32-159] node[160-163]
              140

              $ nodeset -c @login
              4

       Folding nodesets

              $ nodeset -f node[0-7,32-159] node[160-163]
              node[0-7,32-163]

       Expanding nodesets

              $ nodeset -e node[160-163]
              node160 node161 node162 node163

       Excluding nodes from nodeset

              $ nodeset -f node[32-159] -x node33
              node[32,34-159]

       Computing nodesets intersection

              $ nodeset -f node[32-159] -i node[0-7,20-21,32,156-159]
              node[32,156-159]

       Computing nodesets symmetric difference (xor)

              $ nodeset -f node[33-159] --xor node[32-33,156-159]
              node[32,34-155]

HISTORY

       Command syntax has been changed since nodeset  command  available  with
       ClusterShell  v1.1.  Operations,  like  --intersection  or  -x, are now
       specified between nodesets in the command line.

       ClusterShell v1.1:

              $ nodeset -f -x node[3,5-6,9] node[1-9]
              node[1-2,4,7-8]

       ClusterShell v1.2+:

              $ nodeset -f node[1-9] -x node[3,5-6,9]
              node[1-2,4,7-8]

SEE ALSO

       clush(1), clubak(1), groups.conf(5).

BUG REPORTS

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

AUTHOR

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

COPYRIGHT

       CeCILL-C V1