version 1.74, 2017/05/03 21:49:18 |
version 1.75, 2017/10/21 23:06:24 |
|
|
.Op Fl o Ar ssh_option |
.Op Fl o Ar ssh_option |
.Op Fl P Ar port |
.Op Fl P Ar port |
.Op Fl S Ar program |
.Op Fl S Ar program |
.Sm off |
.Ar source ... |
.Oo |
.Ar target |
.Op Ar user No @ |
|
.Ar host1 : |
|
.Oc Ar file1 |
|
.Sm on |
|
.Ar ... |
|
.Sm off |
|
.Oo |
|
.Op Ar user No @ |
|
.Ar host2 : |
|
.Oc Ar file2 |
|
.Sm on |
|
.Ek |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
copies files between hosts on a network. |
copies files between hosts on a network. |
|
|
will ask for passwords or passphrases if they are needed for |
will ask for passwords or passphrases if they are needed for |
authentication. |
authentication. |
.Pp |
.Pp |
File names may contain a user and host specification to indicate |
The |
that the file is to be copied to/from that host. |
.Ar target |
|
and |
|
.Ar destination |
|
may be specified as a local pathname, a remote host with optional path |
|
in the form |
|
.Oo Ar user Ns @ Oc Ns Ar host Ns : Ns Oo Ar path Oc , |
|
or an scp URI in the form |
|
.No scp:// Ns Oo Ar user Ns @ Oc Ns Ar host Ns |
|
.Oo : Ns Ar port Oc Ns Oo / Ns Ar path Oc . |
Local file names can be made explicit using absolute or relative pathnames |
Local file names can be made explicit using absolute or relative pathnames |
to avoid |
to avoid |
.Nm |
.Nm |
treating file names containing |
treating file names containing |
.Sq :\& |
.Sq :\& |
as host specifiers. |
as host specifiers. |
Copies between two remote hosts are also permitted. |
.Pp |
|
When copying between two remote hosts, if the URI format is used, a |
|
.Ar port |
|
may only be specified on the |
|
.Ar target |
|
if the |
|
.Fl 3 |
|
option is used. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |