pbsdsh (1) Linux Manual Page
pbsdsh – distribute task 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 control 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 concurrently – all execute at (about) the same time.
Users will find the PBS_TASKNUM , PBS_NODENUM , and the PBS_VNODENUM environmental variables useful. They contain the TM task id, the node identifier, and the cpu (virtual node) identifier.
Options
- -c copies
- The program is spawned on the first nodes allocated. This option is mutual exclusive with -n.
- -n node
- The program is spawned on one node which is the node allocted. This option is mutual exclusive with -c.
- -h hostname
- The program is spawned on the node specified.
- -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 processers on a given node.
- -v
- Verbose output about error conditions and task exit status is produced.
- -n node
Operands
The first operand, is the program to execute. Additional operands, 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 command, the exit status will be a value of zero. If the pbsdsh command fails to process any operand, or fails to contact the MOM daemon on the localhost the command exits with a value greater than zero.