scp.1

   1 .\"  -*- nroff -*-
   2 .\"
   3 .\" scp.1
   4 .\"
   5 .\" Author: Tatu Ylonen <ylo@cs.hut.fi>
   6 .\"
   7 .\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
   8 .\"                    All rights reserved
   9 .\"
  10 .\" Created: Sun May  7 00:14:37 1995 ylo
  11 .\"
  12 .\" $Id$
  13 .\"
  14 .Dd September 25, 1999
  15 .Dt SCP 1
  16 .Os
  17 .Sh NAME
  18 .Nm scp
  19 .Nd secure copy (remote file copy program)
  20 .Sh SYNOPSIS
  21 .Nm scp
  22 .Op Fl pqrvC46
  23 .Op Fl S Ar program
  24 .Op Fl P Ar port
  25 .Op Fl c Ar cipher
  26 .Op Fl i Ar identity_file
  27 .Sm off
  28 .Oo
  29 .Op Ar user@
  30 .Ar host1 No :
  31 .Oc Ns Ar file1
  32 .Sm on
  33 .Op Ar ...
  34 .Sm off
  35 .Oo
  36 .Op Ar user@
  37 .Ar host2 No :
  38 .Oc Ar file2
  39 .Sm on
  40 .Sh DESCRIPTION
  41 .Nm
  42 copies files between hosts on a network.
  43 It uses
  44 .Xr ssh 1
  45 for data transfer, and uses the same authentication and provides the
  46 same security as
  47 .Xr ssh 1 .
  48 Unlike
  49 .Xr rcp 1 ,
  50 .Nm
  51 will ask for passwords or passphrases if they are needed for
  52 authentication.
  53 .Pp
  54 Any file name may contain a host and user specification to indicate
  55 that the file is to be copied to/from that host.
  56 Copies between two remote hosts are permitted.
  57 .Pp
  58 The options are as follows:
  59 .Bl -tag -width Ds
  60 .It Fl c Ar cipher
  61 Selects the cipher to use for encrypting the data transfer.
  62 This option is directly passed to
  63 .Xr ssh 1 .
  64 .It Fl i Ar identity_file
  65 Selects the file from which the identity (private key) for RSA
  66 authentication is read.
  67 This option is directly passed to
  68 .Xr ssh 1 .
  69 .It Fl p
  70 Preserves modification times, access times, and modes from the
  71 original file.
  72 .It Fl r
  73 Recursively copy entire directories.
  74 .It Fl v
  75 Verbose mode.
  76 Causes
  77 .Nm
  78 and
  79 .Xr ssh 1
  80 to print debugging messages about their progress.
  81 This is helpful in
  82 debugging connection, authentication, and configuration problems.
  83 .It Fl B
  84 Selects batch mode (prevents asking for passwords or passphrases).
  85 .It Fl q
  86 Disables the progress meter.
  87 .It Fl C
  88 Compression enable.
  89 Passes the
  90 .Fl C
  91 flag to
  92 .Xr ssh 1
  93 to enable compression.
  94 .It Fl P Ar port
  95 Specifies the port to connect to on the remote host.
  96 Note that this option is written with a capital
  97 .Sq P ,
  98 because
  99 .Fl p
 100 is already reserved for preserving the times and modes of the file in
 101 .Xr rcp 1 .
 102 .It Fl S Ar program
 103 Name of
 104 .Ar program
 105 to use for the encrypted connection. The program must understand
 106 .Xr ssh 1
 107 options.
 108 .It Fl 4
 109 Forces
 110 .Nm
 111 to use IPv4 addresses only.
 112 .It Fl 6
 113 Forces
 114 .Nm
 115 to use IPv6 addresses only.
 116 .El
 117 .Sh AUTHORS
 118 Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>
 119 .Sh HISTORY
 120 .Nm
 121 is based on the
 122 .Xr rcp 1
 123 program in BSD source code from the Regents of the University of
 124 California.
 125 .Sh SEE ALSO
 126 .Xr rcp 1 ,
 127 .Xr ssh 1 ,
 128 .Xr ssh-add 1 ,
 129 .Xr ssh-agent 1 ,
 130 .Xr ssh-keygen 1 ,
 131 .Xr sshd 8