unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

scp(1)                           User Commands                          scp(1)



NAME
       scp - secure copy (remote file copy program)

SYNOPSIS
       scp  [-pqrvBC46] [-F ssh_config] [-S program] [-P port] [-c cipher] [-i
       identity_file]  [-o  ssh_option]   [   [user@]host1:]file1   [...]    [
       [user@]host2:]file2

DESCRIPTION
       The scp utility copies files between hosts on a network. It uses ssh(1)
       for data transfer, and uses the same authentication  and  provides  the
       same  security  as ssh(1). Unlike rcp(1), scp will ask for passwords or
       passphrases if they are needed for authentication.

       Any file name may contain a host and  user  specification  to  indicate
       that  the  file  is  to be copied to/from that host. Copies between two
       remote hosts are permitted.

OPTIONS
       The following options are supported:

       -4                      Forces scp to use IPv4 addresses only.



       -6                      Forces scp to use IPv6 addresses only.



       -B                      Selects batch mode. (Prevents asking for  pass-
                               words or passphrases.)



       -c cipher               Selects  the  cipher  to use for encrypting the
                               data transfer. This option is  directly  passed
                               to ssh(1).



       -C                      Compression  enable.  Passes  the  -C  flag  to
                               ssh(1) to enable compression.



       -F ssh_config           Specifies an alternative per-user configuration
                               file for ssh(1.).



       -i identity_file        Selects  the file from which the identity (pri-
                               vate key) for RSA authentication is read.  This
                               option is directly passed to ssh(1).



       -o ssh_option           The given option is directly passed to ssh(1).



       -p                      Preserves modification times, access times, and
                               modes from the original file.



       -P port                 Specifies the port to connect to on the  remote
                               host. Notice that this option is written with a
                               capital `P', because -p is already reserved for
                               preserving  the  times and modes of the file in
                               rcp(1).



       -q                      Disables the progress meter.



       -r                      Recursively copies entire directories.



       -S program              Specifies the name of the program  to  use  for
                               the  encrypted  connection.  The  program  must
                               understand ssh(1) options.



       -v                      Verbose mode. Causes scp and  ssh(1)  to  print
                               debugging  messages  about their progress. This
                               is helpful in debugging connection, authentica-
                               tion, and configuration problems.



OPERANDS
       The following operands are supported:

       host1, host2,...The name(s) of the host from or to which the file is to
                       be copied.



       file1, file2,...The file(s) to be copied.



EXIT STATUS
       The following exit values are returned:

       0        Successful completion.



       1        An error occurred.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWsshu
       Interface StabilityEvolving


SEE ALSO
       rcp(1),  ssh(1),  ssh-add(1),  ssh-agent(1),  ssh-keygen(1),  sshd(1M),
       attributes(5)

       To  view  license  terms,  attribution,  and copyright for OpenSSH, the
       default  path  is  /var/sadm/pkg/SUNWsshdr/install/copyright.  If   the
       Solaris  operating  environment  has been installed anywhere other than
       the default, modify the given path to access the file at the  installed
       location.

AUTHORS
       scp  is  based  on  the  rcp(1) program in the BSD source code from the
       Regents of the University of California. The authors are Timo Rinne and
       Tatu Ylonen.



SunOS 5.10                        9 Jan 2004                            scp(1)