ptdistrib

Description

ptdistrib distributes a task on a list of files to specified hosts.

Command Line Arguments

ptdistrib [-m <machine_file>|-M <machine_list>] [-fFrh] <command> [<file1> <file2> <file3>...]

-m <machine_file>

Specify a file with a list of destination machines. It is incorrect to use this with the -M option. This option must preceed all others.

-M <machine_list>

Specify a list of destination machines. The entire list must be surrounded by quotes. It is incorrect to use this with the -m option. This option must preceed all others.

-f

fetch the output files of the command being run and place them in the current directory

-F

fetch the output files of the command being run and place them in the separate directories for each different host

-r

retry (If the processing of a file fails on any host, try to process it again. Continue until all files have been successfully processed)

-h

print a usage message

<command>

the command to run. All instances of "{}" in the command will be replaced by the current file being processed

[<file1> <file2> <file3>...]

the list of files to distribute

Environment Variables

PT_MACHINE_FILE

If PT_MACHINE_FILE is set, the command will attempt to open the file whose name is stored in PT_MACHINE_FILE. This will be used if neither the -m or -M options are given.

Examples

To compile all the C files in the current directory into object files and fetch the object files back to the current host on the machines specified in the file "destination_machines" use

ptdistrib -m destination_machines -f "cc -c {}" *.c

To do the same action, specifying the machines on the command line, use

ptdistrib -M "host1 host2 host3" -f "cc -c {}" *.c

Notes

Retry should be used sparingly.

See Also

Contact Emil Ong about issues concerning this page.