SSH Tectia  
Previous Next Up [Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
    Using SSH Tectia Server for IBM z/OS >>
    Configuring the Server >>
    Configuring the Client >>
    Authentication >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
    Examples of Use >>
    Man Pages >>
        scp2
        sftp2
        ssh-add2
        ssh-agent2
        ssh-dummy-shell
        ssh-keygen2
        ssh-probe2
        ssh-sft-stage
        ssh2
        ssh2_config
        sshd-check-conf
        sshd2
        sshd2_config
        sshd2_subconfig
        sshregex
    Log Messages >>

scp2

SCP2(1)                        SSH2                       SCP2(1)


NAME
       scp2 - secure copy client


SYNOPSIS
       scp2 [-D debug_level_spec] [-d ] [-p ] [-u ] [--verbose ]
       [-v ] [--help ] [-h ] [-c  cipher ] [-S ssh2-path]
       [-P ssh2-port] [-t ] [-f ] [-1 ] [-4 ] [-6 ] [-r ] [-B ]
       [-b buffer_size] [-N max_requests] [-a[arg]] [-q ] [-Q ]
       [--statistics [yes|no|simple]] [--interactive ] [-I ]
       [--overwrite ] [--whole-file ] [-W ] [--checksum ] [--ver-
       sion ] [-V ] [--force-lower-case ] [-o ssh2-options]
       [-i file] [[user@]host[#port]:]file ...
       [[user@]host[#port]:]file_or_dir


DESCRIPTION
       scp2 (Secure Copy) is used to copy files securely over the
       network. It uses ssh2 for data  transfer  and  authentica-
       tion,  and  provides  the  same level of security as ssh2.
       Unlike rcp, scp2 will ask for passwords or passphrases  if
       they are needed for authentication.  You can also use your
       public key for authentication.  See ssh-agent2(1) and ssh-
       add2(1).

       Any filename may contain a host, user, and port specifica-
       tion to indicate that the file is  to  be  copied  to/from
       that host.  Copies between two remote hosts are permitted.
       The host parameter can optionally be  enclosed  in  square
       brackets  ([]) to allow the use of semicolons (for example
       IPv6 addresses).  file can contain globbing patterns (type
       zsh_fileglob).   All  special characters can be escaped to
       include them in file, but this means that if you  want  to
       use  escapes so that they will be used in the glob pattern
       (to escape special characters), you have  to  escape  them
       with '\\'.  Read more about zsh_fileglob from sshregex(1).


OPTIONS
       -D debug_level_spec
              Prints  extensive  debug  information  to   stderr.
              debug_level_spec  is  a  number  between  0 and 99,
              where  99  specifies  that  all  debug  information
              should be displayed.

       -d     Forces the destination to be a directory.  If it is
              not, scp2 will exit with an error message.

       -p     Preserves file attributes and timestamps.

       -u     Removes source files  after  copying.   This  makes
              scp2 work more like mv than cp.

       -v,--verbose
              Verbose mode.  Equivalent to the -D 2 option.

       -h,--help
              Displays a short help.

       -c cipher
              Selects  the  encryption  algorithm  that ssh2 will
              use.  Multiple -c options are allowed.  A single -c
              flag can have only one cipher.

       -S ssh2-path
              Specifies the path to ssh2 used in connecting.

       -o ssh2-options
              Specifies  options  to  give  to ssh2.  Use as with
              ssh2, see ssh2(1).

       -i file
              Specifies the identity file to give to ssh2.

       -P ssh2-port
              Specifies the remote port to ssh2.  Ports can  also
              be  defined on a file-to-file basis.  See SYNOPSIS.

       -t or -f
              Compatibility mode.  Invokes scp1  with  the  given
              command  line  to handle the connection.  scp1 must
              be in the path.

       -1     Invokes scp1 with the rest  of  the  given  command
              line.

              This argument must be the first on the command line
              and separate from  all  other  one-character  argu-
              ments.  It must not be used when -t or -f are used.

       -4     Instructs ssh2 to use IPv4.

       -6     Instructs ssh2 to use IPv6.

       -r     Copies directories recursively.   Does  not  follow
              symbolic links.

       -B     Invokes ssh2 in batch mode.

       -b buffer_size
              Defines  the  maximum  buffer  size for one request
              (default 32768 bytes).

       -N max_requests
              Defines the maximum number of  concurrent  requests
              (default 10).

       -a[arg]
              Transfers  files  using  ASCII  mode, i.e. newlines
              will be converted on the fly. See command ascii  in
              sftp2(1).   If  the  server  does not advertise the
              newline convention, you can give it a hint by  giv-
              ing the argument -a. The default is to set the des-
              tination newline convention, but  you  can  specify
              either  one  by prefixing the argument with src: or
              dest: for source or destination convention, respec-
              tively. Advanced example: scp -asrc:unix -adest:dos
              src_host:src_file dest_host:dest_file.

       -q     Quiet mode (only fatal errors are reported).

       -Q     Hides the progress indicator.

       -V,--version
              Displays version.

       -I,--interactive
              Prompts whether to overwrite an  existing  destina-
              tion file (does not work with -B (batch mode)).

       --overwrite
              Specifies whether to overwrite existing destination
              file(s). Default is yes. Takes  an  optional  argu-
              ment, with which you can disable overwriting.

       -W,--whole-file
              Specifies  that  incremental  hashing  is not used.
              Default is to use hashing to  determine  whether  a
              data  block  is  identical  before transferring it.
              Takes  an  an  optional   argument   (-Wno,--whole-
              file=no),  which  enables incremental hashing if it
              was disabled.

       --checksum
              If the file size of source and destination files is
              identical, determines whether the files are identi-
              cal with an MD5 checksum. This is the default.  You
              can  disable this feature with an optional argument
              (--checksum=no). Note that file times,  permissions
              etc.  are  still  updated if needed (or asked for),
              even if actual file transfer does not take place.

       --statistics [yes|no|simple]
              Takes a  mandatory  argument  with  which  you  can
              choose the statistics style. The default is yes for
              full-blown statistics that fit  the  screen  width.
              Other possibilities are no for disabling statistics
              (analogous to the -Q option), and simple  which  is
              the  default  reporting  style when there is no tty
              (e.g. in cron jobs).

       --force-lower-case
              Causes upper case ASCII characters  in  the  source
              filename to be converted into lower case characters
              in the destination  filename.   Takes  an  optional
              yes/no argument, i.e. (--force-lower-case=no).  The
              default is no.


EXIT VALUE
       0      Operation was successful.
       1, 2   Operation resulted in an undetermined error  within
              sshfilecopy.
       3      Destination is not a directory, but a directory was
              specified by the user.
       4      Connecting to the host failed.
       5      Connection lost.
       6      File does not exist.
       7      No permission to access file.
       8      Undetermined error from sshfilexfer.
       9      File transfer protocol mismatch.


EXAMPLES
       Copy files from your local system to a remote system:

       $ scp localfile user@remotehost:/dest/dir/for/file/

       Copy files from a remote system to your local disk:

       $ scp user@remotehost:/dir/for/file/remotefile
              /dest/dir/for/file


INSTALLATION
       scp2 uses ssh2 in network connections. Note that the  sub-
       system  'sftp-server' must be defined in the sshd2(8) con-
       figuration file in the remote end for scp2 to work.


AUTHORS
       SSH Communications Security Corp.

       For more information, see http://www.ssh.com.


SEE ALSO
       ssh2(1),  sshd2(8),  ssh-keygen2(1),  ssh-agent2(1),  ssh-
       add2(1), sftp2(1) rlogin(1), rsh(1), telnet(1)

Previous Next Up [Contents] [Index]


[ Contact Information | Support | Feedback | SSH Home Page | SSH Products ]

Copyright © 2006 SSH Communications Security Corp.
This software is protected by international copyright laws. All rights reserved.
Copyright Notice