Flashnux

GNU/Linux man pages

Livre :
Expressions régulières,
Syntaxe et mise en oeuvre :

ISBN : 978-2-7460-9712-4
EAN : 9782746097124
(Editions ENI)

GNU/Linux

Debian 6.0.2

(Squeeze)

nodeset(1)


NODESET

NODESET

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXTENDED PATTERNS
EXIT STATUS
EXAMPLES
HISTORY
SEE ALSO
BUG REPORTS
AUTHOR
COPYRIGHT

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



nodeset(1)