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