pdsh.1 (2012 03)

pdsh(1) pdsh-2.16 pdsh(1)
(hpux11.31)
-m block | cyclic
Set block versus cyclic allocation of processes to nodes. Default is block.
-r railmask
Set the rail bitmask for a job on a multirail system. The default railmask is 1, which corresponds
to rail 0 only. Each bit set in the argument to -r corresponds to a rail on the system, so a value of
2 would correspond to rail 1 only, and 3 would indicate to use both rail 1 and rail 0.
Machines Module Options
-a Target all nodes from machines file.
Genders Module Options
In addition to the genders options presented below, the genders attribute pdsh_rcmd_type may also be
used in the genders database to specify an alternate rcmd connect type than the pdsh default for hosts
with this attribute. For example, the following line in the genders file
host0 pdsh_rcmd_type=ssh
would cause pdsh to use ssh to connect to host0, even if rsh were the default. This can be overridden on
the commandline with the "rcmd_type:host0" syntax.
-A Target all nodes in genders database. The -A option will target every host listed in genders -- if
you want to omit some hosts by default, see the -a option below.
-a Target all nodes in genders database except those with the "pdsh_all_skip" attribute. This is
shorthand for running "pdsh -A -X pdsh_all_skip ..."
-g attr[=val][,attr[=val],...]
Target nodes that match any of the specified genders attributes (with optional values). Conflicts
with -a and -w options. This option targets the alternate hostnames in the genders database by
default. The -i option provided by the genders module may be used to translate these to the
canonical genders hostnames. If the installed version of genders supports it, attributes supplied
to -g may also take the form of genders queries. Genders queries will query the genders data-
base for the union, intersection, difference, or complement of genders attributes and values. The
set operation union is represented by two pipe symbols (’||’), intersection by two ampersand
symbols (’&&’), difference by two minus symbols (’--’), and complement by a tilde (’˜’).
Parentheses may be used to change the order of operations. See the nodeattr(1) manpage for
examples of genders queries.
-X attr[=val][,attr[=val],...]
Exclude nodes that match any of the specified genders attributes (optionally with values). This
option may be used in combination with any other of the node selection options (e.g. -w, -g, -a, -X
may also take the form of genders queries. Please see documentation for the genders -g option
for more information about genders queries.
-i Request translation between canonical and alternate hostnames.
-F filename
Read genders information from filename instead of the system default genders file.
nodeupdown Module Options
-v Eliminate target nodes that are considered "down" by libnodeupdown.
slurm Module Options
The slurm module allows pdsh to target nodes based on currently running SLURM jobs. The slurm
module is typically called after all other node selection options have been processed, and if no nodes have
been selected, the module will attempt to read a running jobid from the SLURM_JOBID environment
variable (which is set when running under a SLURM allocation). If SLURM_JOBID references an invalid
job, it will be silently ignored.
-j jobid[,jobid,...]
Target list of nodes allocated to the SLURM job jobid. This option may be used multiple times to
target multiple SLURM jobs. The special argument "all" can be used to target all nodes running
SLURM jobs, e.g. -j all.
HP-UX 11i Version 3: March 2012 − 3 − Hewlett-Packard Company 3