576 lines
9.0 KiB
HTML
576 lines
9.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of SCP</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>SCP</H1>
|
|
Section: User Commands (1)<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
<BR>BSD mandoc<BR>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
|
|
|
|
<B>scp</B>
|
|
|
|
- OpenSSH secure file copy
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>scp</B>
|
|
|
|
[-<B>346BCpqrTv </B>[-<B>c </B><I>cipher</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>F </B><I>ssh_config</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>i </B><I>identity_file</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>J </B><I>destination</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>l </B><I>limit</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>o </B><I>ssh_option</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>P </B><I>port</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>S </B><I>program</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
<I>source ... target</I>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>scp</B>
|
|
|
|
|
|
copies files between hosts on a network.
|
|
It uses
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1)
|
|
|
|
|
|
for data transfer, and uses the same authentication and provides the
|
|
same security as
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<B>scp</B>
|
|
|
|
|
|
will ask for passwords or passphrases if they are needed for
|
|
authentication.
|
|
<P>
|
|
|
|
The
|
|
<I>source</I>
|
|
|
|
and
|
|
<I>target</I>
|
|
|
|
may be specified as a local pathname, a remote host with optional path
|
|
in the form
|
|
|
|
[user @ host : [path]
|
|
|
|
]
|
|
|
|
|
|
|
|
or a URI in the form
|
|
|
|
<B>scp:// </B>[user @ host [: port [/ path]
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
Local file names can be made explicit using absolute or relative pathnames
|
|
to avoid
|
|
<B>scp</B>
|
|
|
|
|
|
treating file names containing
|
|
`:'
|
|
|
|
as host specifiers.
|
|
<P>
|
|
|
|
When copying between two remote hosts, if the URI format is used, a
|
|
<I>port</I>
|
|
|
|
may only be specified on the
|
|
<I>target</I>
|
|
|
|
if the
|
|
-<B>3</B>
|
|
|
|
option is used.
|
|
<P>
|
|
|
|
The options are as follows:
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="1"><B>-3</B>
|
|
|
|
|
|
<DD>
|
|
Copies between two remote hosts are transferred through the local host.
|
|
Without this option the data is copied directly between the two remote
|
|
hosts.
|
|
Note that this option disables the progress meter.
|
|
<DT id="2"><B>-4</B>
|
|
|
|
|
|
<DD>
|
|
Forces
|
|
<B>scp</B>
|
|
|
|
|
|
to use IPv4 addresses only.
|
|
<DT id="3"><B>-6</B>
|
|
|
|
|
|
<DD>
|
|
Forces
|
|
<B>scp</B>
|
|
|
|
|
|
to use IPv6 addresses only.
|
|
<DT id="4"><B>-B</B>
|
|
|
|
|
|
<DD>
|
|
Selects batch mode (prevents asking for passwords or passphrases).
|
|
<DT id="5"><B>-C</B>
|
|
|
|
|
|
<DD>
|
|
Compression enable.
|
|
Passes the
|
|
-<B>C</B>
|
|
|
|
flag to
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1)
|
|
|
|
|
|
to enable compression.
|
|
<DT id="6"><B>-c </B><I>cipher</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Selects the cipher to use for encrypting the data transfer.
|
|
This option is directly passed to
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<DT id="7"><B>-F </B><I>ssh_config</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Specifies an alternative
|
|
per-user configuration file for
|
|
<B>ssh</B>
|
|
|
|
|
|
This option is directly passed to
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<DT id="8"><B>-i </B><I>identity_file</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Selects the file from which the identity (private key) for public key
|
|
authentication is read.
|
|
This option is directly passed to
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<DT id="9"><B>-J </B><I>destination</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Connect to the target host by first making an
|
|
<B>scp</B>
|
|
|
|
|
|
connection to the jump host described by
|
|
<I>destination</I>
|
|
|
|
and then establishing a TCP forwarding to the ultimate destination from
|
|
there.
|
|
Multiple jump hops may be specified separated by comma characters.
|
|
This is a shortcut to specify a
|
|
<B>ProxyJump</B>
|
|
|
|
configuration directive.
|
|
This option is directly passed to
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<DT id="10"><B>-l </B><I>limit</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Limits the used bandwidth, specified in Kbit/s.
|
|
<DT id="11"><B>-o </B><I>ssh_option</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Can be used to pass options to
|
|
<B>ssh</B>
|
|
|
|
in the format used in
|
|
ssh_config5.
|
|
|
|
|
|
This is useful for specifying options
|
|
for which there is no separate
|
|
<B>scp</B>
|
|
|
|
command-line flag.
|
|
For full details of the options listed below, and their possible values, see
|
|
ssh_config5.
|
|
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="12"><B>AddressFamily</B>
|
|
<DD>
|
|
<DT id="13"><B>BatchMode</B>
|
|
<DD>
|
|
<DT id="14"><B>BindAddress</B>
|
|
<DD>
|
|
<DT id="15"><B>BindInterface</B>
|
|
<DD>
|
|
<DT id="16"><B>CanonicalDomains</B>
|
|
<DD>
|
|
<DT id="17"><B>CanonicalizeFallbackLocal</B>
|
|
<DD>
|
|
<DT id="18"><B>CanonicalizeHostname</B>
|
|
<DD>
|
|
<DT id="19"><B>CanonicalizeMaxDots</B>
|
|
<DD>
|
|
<DT id="20"><B>CanonicalizePermittedCNAMEs </B><DT><B>CASignatureAlgorithms</B>
|
|
<DD>
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="21"><B>CertificateFile</B>
|
|
<DD>
|
|
<DT id="22"><B>ChallengeResponseAuthentication</B>
|
|
<DD>
|
|
<DT id="23"><B>CheckHostIP</B>
|
|
<DD>
|
|
<DT id="24"><B>Ciphers</B>
|
|
<DD>
|
|
<DT id="25"><B>Compression</B>
|
|
<DD>
|
|
<DT id="26"><B>ConnectionAttempts</B>
|
|
<DD>
|
|
<DT id="27"><B>ConnectTimeout</B>
|
|
<DD>
|
|
<DT id="28"><B>ControlMaster</B>
|
|
<DD>
|
|
<DT id="29"><B>ControlPath</B>
|
|
<DD>
|
|
<DT id="30"><B>ControlPersist</B>
|
|
<DD>
|
|
<DT id="31"><B>GlobalKnownHostsFile</B>
|
|
<DD>
|
|
<DT id="32"><B>GSSAPIAuthentication</B>
|
|
<DD>
|
|
<DT id="33"><B>GSSAPIDelegateCredentials</B>
|
|
<DD>
|
|
<DT id="34"><B>HashKnownHosts</B>
|
|
<DD>
|
|
<DT id="35"><B>Host</B>
|
|
<DD>
|
|
<DT id="36"><B>HostbasedAuthentication</B>
|
|
<DD>
|
|
<DT id="37"><B>HostbasedKeyTypes</B>
|
|
<DD>
|
|
<DT id="38"><B>HostKeyAlgorithms</B>
|
|
<DD>
|
|
<DT id="39"><B>HostKeyAlias</B>
|
|
<DD>
|
|
<DT id="40"><B>Hostname</B>
|
|
<DD>
|
|
<DT id="41"><B>IdentitiesOnly</B>
|
|
<DD>
|
|
<DT id="42"><B>IdentityAgent</B>
|
|
<DD>
|
|
<DT id="43"><B>IdentityFile</B>
|
|
<DD>
|
|
<DT id="44"><B>IPQoS</B>
|
|
<DD>
|
|
<DT id="45"><B>KbdInteractiveAuthentication</B>
|
|
<DD>
|
|
<DT id="46"><B>KbdInteractiveDevices</B>
|
|
<DD>
|
|
<DT id="47"><B>KexAlgorithms</B>
|
|
<DD>
|
|
<DT id="48"><B>LogLevel</B>
|
|
<DD>
|
|
<DT id="49"><B>MACs </B><DT><B>NoHostAuthenticationForLocalhost</B>
|
|
<DD>
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="50"><B>NumberOfPasswordPrompts</B>
|
|
<DD>
|
|
<DT id="51"><B>PasswordAuthentication</B>
|
|
<DD>
|
|
<DT id="52"><B>PKCS11Provider</B>
|
|
<DD>
|
|
<DT id="53"><B>Port</B>
|
|
<DD>
|
|
<DT id="54"><B>PreferredAuthentications</B>
|
|
<DD>
|
|
<DT id="55"><B>ProxyCommand</B>
|
|
<DD>
|
|
<DT id="56"><B>ProxyJump</B>
|
|
<DD>
|
|
<DT id="57"><B>PubkeyAcceptedKeyTypes</B>
|
|
<DD>
|
|
<DT id="58"><B>PubkeyAuthentication</B>
|
|
<DD>
|
|
<DT id="59"><B>RekeyLimit</B>
|
|
<DD>
|
|
<DT id="60"><B>SendEnv</B>
|
|
<DD>
|
|
<DT id="61"><B>ServerAliveInterval</B>
|
|
<DD>
|
|
<DT id="62"><B>ServerAliveCountMax</B>
|
|
<DD>
|
|
<DT id="63"><B>SetEnv</B>
|
|
<DD>
|
|
<DT id="64"><B>StrictHostKeyChecking</B>
|
|
<DD>
|
|
<DT id="65"><B>TCPKeepAlive</B>
|
|
<DD>
|
|
<DT id="66"><B>UpdateHostKeys</B>
|
|
<DD>
|
|
<DT id="67"><B>User</B>
|
|
<DD>
|
|
<DT id="68"><B>UserKnownHostsFile</B>
|
|
<DD>
|
|
<DT id="69"><B>VerifyHostKeyDNS</B>
|
|
<DD>
|
|
</DL>
|
|
<P>
|
|
|
|
<DT id="70"><B>-P </B><I>port</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Specifies the port to connect to on the remote host.
|
|
Note that this option is written with a capital
|
|
`P'
|
|
|
|
|
|
because
|
|
-<B>p</B>
|
|
|
|
is already reserved for preserving the times and modes of the file.
|
|
<DT id="71"><B>-p</B>
|
|
|
|
|
|
<DD>
|
|
Preserves modification times, access times, and modes from the
|
|
original file.
|
|
<DT id="72"><B>-q</B>
|
|
|
|
|
|
<DD>
|
|
Quiet mode: disables the progress meter as well as warning and diagnostic
|
|
messages from
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1).
|
|
|
|
|
|
<DT id="73"><B>-r</B>
|
|
|
|
|
|
<DD>
|
|
Recursively copy entire directories.
|
|
Note that
|
|
<B>scp</B>
|
|
|
|
|
|
follows symbolic links encountered in the tree traversal.
|
|
<DT id="74"><B>-S </B><I>program</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Name of
|
|
<I>program</I>
|
|
|
|
to use for the encrypted connection.
|
|
The program must understand
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1)
|
|
|
|
|
|
options.
|
|
<DT id="75"><B>-T</B>
|
|
|
|
|
|
<DD>
|
|
Disable strict filename checking.
|
|
By default when copying files from a remote host to a local directory
|
|
<B>scp</B>
|
|
|
|
|
|
checks that the received filenames match those requested on the command-line
|
|
to prevent the remote end from sending unexpected or unwanted files.
|
|
Because of differences in how various operating systems and shells interpret
|
|
filename wildcards, these checks may cause wanted files to be rejected.
|
|
This option disables these checks at the expense of fully trusting that
|
|
the server will not send unexpected filenames.
|
|
<DT id="76"><B>-v</B>
|
|
|
|
|
|
<DD>
|
|
Verbose mode.
|
|
Causes
|
|
<B>scp</B>
|
|
|
|
|
|
and
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1)
|
|
|
|
|
|
to print debugging messages about their progress.
|
|
This is helpful in
|
|
debugging connection, authentication, and configuration problems.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>EXIT STATUS</H2>
|
|
|
|
Ex -std scp
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+sftp">sftp</A>(1),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+ssh">ssh</A>(1),
|
|
|
|
|
|
ssh-add1,
|
|
|
|
|
|
ssh-agent1,
|
|
|
|
|
|
ssh-keygen1,
|
|
|
|
|
|
ssh_config5,
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?8+sshd">sshd</A>(8)
|
|
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>HISTORY</H2>
|
|
|
|
<B>scp</B>
|
|
|
|
|
|
is based on the rcp program in
|
|
BSD source code from the Regents of the University of California.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
An Timo Rinne Aq Mt <A HREF="mailto:tri@iki.fi">tri@iki.fi</A>
|
|
|
|
An Tatu Ylonen Aq Mt <A HREF="mailto:ylo@cs.hut.fi">ylo@cs.hut.fi</A>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="77"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="78"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="79"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="80"><A HREF="#lbAE">EXIT STATUS</A><DD>
|
|
<DT id="81"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="82"><A HREF="#lbAG">HISTORY</A><DD>
|
|
<DT id="83"><A HREF="#lbAH">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:26 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|