pbsdsh(1)
pbsdsh(1B) PBS pbsdsh(1B)
NAME
pbsdsh - distribute tasks to nodes under pbs
SYNOPSIS
pbsdsh [-c copies] [-o] [-s] [-u] [-v] program [args]
pbsdsh [-n node] [-o] [-s] [-u] [-v] program [args]
pbsdsh [-h nodename] [-o] [-v] program [args]
DESCRIPTION
Executes (spawns) a normal Unix program on one or more nodes under con-
trol of the Portable Batch System, PBS. Pbsdsh uses the Task Manager
API, see tm_spawn(3), to distribute the program on the allocated nodes.
When run without the -c or the -n option, pbsdsh will spawn the program
on all nodes allocated to the PBS job. The spawns take place concur-
rently - all execute at (about) the same time.
NOTE: pbsdsh must be launched from from within an interactive or non-
interactive job.
OPTIONS
-c copies
The program is spawned on the first Copies nodes allocated.
This option is mutual exclusive with -n.
-h hostname
The program is spawned on the node specified.
-n node
The program is spawned on one node which is the n-th node
allocated. This option is mutual exclusive with -c.
-o Capture stdout of the spawned program. Normally stdout goes to
the job’s output.
-s If this option is given, the program is run in turn on each
node, one after the other.
-u The program is run once on each node (unique). This ignores the
number of allocated processors on a given node.
-v Verbose output about error conditions and task exit status is
produced.
OPERANDS
The first operand, program, is the program to execute.
Additional operands, args, are passed as arguments to the program.
STANDARD ERROR
The pbsdsh command will write a diagnostic message to standard error
for each error occurrence.
EXIT STATUS
Upon successful processing of all the operands presented to the
SEE ALSO
qsub(1B), tm_spawn(3B)
|
