ptmv

Description

Command Line Arguments

ptmv [-m <machine_file>|-M <machine_list>] [-f] [-o <compression_option>] <source1> <source2>... <destination>

-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

Force the copy. Remove any existing destination.

-o <transfer_option>

The manner in which ptmv transfers files can be configured by specifying any of the following options:

force_compression - ptmv may attempt to use compression if it is available on the host system. Typically, it only compresses when not copying already compressed files. Use this option to force the use of compression.

no_compression - Use this option to disable the use of compression.

no_checking - Normally, ptmv does checking to ensure correct data transmission. Use this option to disable this feature, possibly speeding up transmission.

force_tar - ptmv may use tar to transfer large directories to speed transfers. Use this option to force the use of tar.

no_tar - Use this option to disable the use of tar.

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 move the directories /home/johndoe/project and /home/johndoe/data from the local machine to the directory /home/johndoe on the machines specified in the file "destination_machines" use

ptmv -m destination_machines /home/johndoe/project /home/johndoe/data /home/johndoe

To make the same move, specifying the machines on the command line, use

ptmv -M "host1 host2 host3" /home/johndoe/project /home/johndoe/data /home/johndoe

To copy to similarly named hosts as in the previous example, an abbreviation can be used

ptmv -M "host%d@1-3" /home/johndoe/project /home/johndoe/data /home/johndoe

where the %d is replaced by the numbers 1-3 when the copy is performed.

See Also

Contact Emil Ong about issues concerning this page.