VShell Server for UNIX

man pages


Section: User Commands (1)
Updated: Version 7.0



vcp - VanDyke Software Secure Shell file transfer program  


vcp [options] source [source ...] destination  


vcp is a simple file transfer program with Secure Shell-based strong encryption used to securely copy files over the network. vcp supports multiple sources. File source and destination are specified as follows:
     [[user@[domain@]host[#port]:]file File sources and destinations may contain a user, host and port specification to indicate that the file is to be copied to or from that host. Copies between two remote hosts are permitted. The following conditions apply:
* The user@ argument is optional. If it is not specified, your network username will be used.
* The host argument is optional. If it is not specified, your current host is used but local-to-local transfers will not be permitted.
* The #port argument is optional. If it is not specified, the default port 22 will be used.
* The file argument can contain the wildcard characters * and ?. vcp will expand these wildcard characters. Multiple wildcard characters are permitted in a file argument (e.g., "*.*" or "*.?"). vcp also supports file "globbing". The sequence [...] will match any one of the characters enclosed. Within [...], a pair of characters separated by a quotation mark (") matches any character lexically between the two. The backslash can be used to turn off wildcard characters (e.g., \* or \[).


Command-line options are described below.

Instructs vcp to automatically accept host keys. Note: This option should be used with caution. If a host key has changed, it will invalidate the ability to detect a man-in-the-middle attack.

Instructs vcp to use ASCII mode to transfer files.
--auth authentication list

The authentication methods to be used in a comma separated list. Valid methods are keyboard-interactive, publickey, password, and gssapi.
-c cipher

The cipher that the SSH2 server will use. Protocol strings or display strings are permitted.

Displays usage.
--http-proxy hostname[:port]

Specifies the http proxy to be used during connection.
-i file

The identity file to use for public-key authentication or a PKCS#12 file to use for X.509 authentication. If no file is specified, vcp will attempt to use all public keys in the $HOME/.vshell/publickey directory.
--kex KEX

Specifies which key exchange algorithm to use. Valid algorithms are diffie-hellman, diffie-hellman-group, Kerberos, and any OID (in dotted number format) supported by the GSSAPI provider.
--log file

Specifies the file where vcp will log all output, in addition to sending it to the console. If the file does not exist, vcp will create it; or, if the file does exist, vcp will append the output to it. If used in combination with the -v (verbose) option, the extra verbose output will also be logged.
-m MAC

The MAC that the SSH2 server will use.

 Instructs vcp to move the file(s).

Fails if prompted for user input.

Quiets (suppresses) screen output.
-p passphrase

The passphrase for your private key.

Preserves file attributes during copying.
--pw password

Your user password.

Copies folders recursively (if you use this option, your source must be a folder).
--socks4 server[:port]

Specifies the Socks version 4 server to be used during connection
--socks5 server[:port]

Specifies the Socks version 5 server to be used during connection
--spn hostname

Allows you to manually specify the SPN (Server Principal Name). The SPN is almost always of the form host@<server canonical name>. An example of a valid string is "host@mail.mydomain.com". If the server is in a different Kerberos realm, the realm name may need to be appended (e.g., host@mail.mydomain.com@KRBS.MYDOMAIN.COM.

Displays verbose connection debug information.
-z n

The compression level (0-9). By default, the compression level is set to 5. Setting the level to 0 turns off compression. When compression is on, vcp attempts to use zlib@openssh.com, zlib, and no compression, in that order, when making a connection.


The following are the locations of data files.
Host key files
The directory of these files is the same directory as the public key directory, which can be specified in the vshelld_config file. By default, the location is $HOME/.vshell/known_hosts.
Public key files
The directory of these files is specified in the vshelld_config file. By default, the location is $HOME/.vshell/publickey. Note: To find an acceptable public key match, vshelld (VShell(R) server for UNIX) will only look at files in the public key directory that end in .pub or that are named "authorized_keys". vshelld will not check those files with names that begin with a period (.). For example, file.pub would be checked to see if it contains a valid key, where as, .x.pub would not.


vkeygen(1), vpka(1), vsftp(1), vsh(1), vshelld(8), vshelld_config(5)



Copyright (C) 1995 - VanDyke Software, Inc.

VanDyke Software and VShell are trademarks of VanDyke Software, Inc. All other products and services mentioned are trademarks or registered trademarks of their respective companies.