=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.

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<Author>

Egan Ford <egan@us.ibm.com>

=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>