=head1 Name

B<pscp> - parallel remote copy

=head1 B<Synopsis>

B<pscp> [-i I<suffix>] [I<scp options> I<...>] [B<-f> I<fanout>] I<filename> [I<filename> I<...>] I<noderange:destinationdirectory>

B<pscp> {B<-h>|B<--help>|B<-v>|B<--version>}

=head1 B<Description>

B<pscp> is a utility used to copy a single or multiple set of files and/or
directories  to  a  single or range of nodes and/or groups in parallel.

B<pscp> is a front-end to the remote copy B<scp>.

Note:  this command does not support the xcatd client/server communication and therefore must be run on the management node. It does not support hierarchy, use xdcp to run remote copy command from the
management node to the compute node via a service node.

B<pscp> is NOT multicast, but is parallel unicasts.

=head1 B<Options>

=over 7

=item B<-f> I<fanout>

Specifies a fanout value for the maximum number of  concur-
rently  executing  remote shell processes.

=item B<-i> I<suffix>

Interfaces to be used.

=item B<scp options>

See B<scp(1)>

=item B<filename>

A space delimited list of files to copy. If B<-r> is passed as an scp option, directories may be specified as well.

=item B<noderange:destination>

A L<noderange(3)|noderange.3> and destination directory.  The : is required.

=item B<-h>|B<--help>

Print help.

=item B<-v>|B<--version>

Print version.

=back

=over 4

=item B<XCATPSHFANOUT>

Specifies  the fanout value. This variable is overridden by
the B<-f> flag.  Default is 64.

=back

=head1 B<Examples>

B<pscp> B<-r> I</usr/local> I<node1,node3:/usr/local>
B<pscp> I<passwd> I<group> I<rack01:/etc>

=head1 B<See> B<Also>

L<noderange(3)|noderange.3>, L<pping(1)|pping.1>, L<prsync(1)|prsync.1>, L<psh(1)|psh.1>
