table of contents
| pscp(1) | PuTTY tool suite | pscp(1) |
NAME¶
pscp - command-line SCP (secure copy) / SFTP clientSYNOPSIS¶
pscp [options] [user@]host:source target pscp [options] source [source...] [user@]host:target pscp [options] -ls [user@]host:filespec
DESCRIPTION¶
pscp is a command-line client for the SSH-based SCP (secure copy) and SFTP (secure file transfer protocol) protocols.OPTIONS¶
The command-line options supported by pscp are:- -V
- Show version information and exit.
- -pgpfp
- Display the fingerprints of the PuTTY PGP Master Keys and exit, to aid in verifying new files released by the PuTTY team.
- -ls
- Remote directory listing.
- -p
- Preserve file attributes.
- -q
- Quiet, don't show statistics.
- -r
- Copy directories recursively.
- -unsafe
- Allow server-side wildcards (DANGEROUS).
- -v
- Show verbose messages.
- -load session
- Load settings from saved session.
- -P port
- Connect to port port.
- -proxycmd command
- Instead of making a TCP connection, use command as a proxy; network traffic will be redirected to the standard input and output of command. command must be a single word, so is likely to need quoting by the shell.
The special strings %host and %port in command will be replaced by the hostname and port number you want to connect to; to get a literal % sign, enter %%.
Backslash escapes are also supported, such as sequences like \n being replaced by a literal newline; to get a literal backslash, enter \\. (Further escaping may be required by the shell.)
(See the main PuTTY manual for full details of the supported %- and backslash-delimited tokens, although most of them are probably not very useful in this context.)
- -l user
- Set remote username to user.
- -batch
- Disable interactive prompts.
- -pw password
- Set remote password to password. CAUTION: this will likely make the password visible to other users of the local machine (via commands such as `w').
- -1
- Force use of SSH protocol version 1.
- -2
- Force use of SSH protocol version 2.
- -4, -6
- Force use of IPv4 or IPv6 for network connections.
- -C
- Enable SSH compression.
- -i keyfile
- Private key file for user authentication. For SSH-2 keys, this key file must be in PuTTY's PPK format, not OpenSSH's format or anyone else's.
If you are using an authentication agent, you can also specify a public key here (in RFC 4716 or OpenSSH format), to identify which of the agent's keys to use.
- -noagent
- Don't try to use an authentication agent.
- -agent
- Allow use of an authentication agent. (This option is only necessary to override a setting in a saved session.)
- -hostkey key
- Specify an acceptable host public key. This option may be specified multiple times; each key can be either a fingerprint (99:aa:bb:...) or a base64-encoded blob in OpenSSH's one-line format.
Specifying this option overrides automated host key management; only the key(s) specified on the command-line will be accepted (unless a saved session also overrides host keys, in which case those will be added to), and the host key cache will not be written.
- -scp
- Force use of SCP protocol.
- -sftp
- Force use of SFTP protocol.
- -sshlog logfile
- -sshrawlog logfile
- These options make pscp log protocol details to a file. (Some of these may be sensitive, although by default an effort is made to suppress obvious passwords.)
-sshlog logs decoded SSH packets and other events (those that -v would print). -sshrawlog additionally logs the raw encrypted packet data.
MORE INFORMATION¶
For more information on pscp it's probably best to go and look at the manual on the PuTTY web page:BUGS¶
This man page isn't terribly complete. See the above web link for better documentation.| 2004‐03‐24 | PuTTY tool suite |