1 \cfg{man-identity}{pscp}{1}{2004-03-24}{PuTTY tool suite}{PuTTY tool suite}
3 \H{pscp-manpage} Man page for PSCP
5 \S{pscp-manpage-name} NAME
7 \cw{pscp} \- command-line SCP (secure copy) / SFTP client
9 \S{pscp-manpage-synopsis} SYNOPSIS
11 \c pscp [options] [user@]host:source target
12 \e bbbb iiiiiii iiiib iiiibiiiiii iiiiii
13 \c pscp [options] source [source...] [user@]host:target
14 \e bbbb iiiiiii iiiiii iiiiii iiiib iiiibiiiiii
15 \c pscp [options] -ls [user@]host:filespec
16 \e bbbb iiiiiii bbb iiiib iiiibiiiiiiii
18 \S{pscp-manpage-description} DESCRIPTION
20 \cw{pscp} is a command-line client for the SSH-based SCP (secure
21 copy) and SFTP (secure file transfer protocol) protocols.
23 \S{pscp-manpage-options} OPTIONS
25 The command-line options supported by \e{pscp} are:
29 \dd Show version information and exit.
33 \dd Display the fingerprints of the PuTTY PGP Master Keys and exit,
34 to aid in verifying new files released by the PuTTY team.
38 \dd Remote directory listing.
42 \dd Preserve file attributes.
46 \dd Quiet, don't show statistics.
50 \dd Copy directories recursively.
54 \dd Allow server-side wildcards (DANGEROUS).
58 \dd Show verbose messages.
60 \dt \cw{-load} \e{session}
62 \dd Load settings from saved session.
66 \dd Connect to port \e{port}.
70 \dd Set remote username to \e{user}.
74 \dd Disable interactive prompts.
76 \dt \cw{-pw} \e{password}
78 \dd Set remote password to \e{password}. \e{CAUTION:} this will likely
79 make the password visible to other users of the local machine (via
80 commands such as \q{\c{w}}).
84 \dd Force use of SSH protocol version 1.
88 \dd Force use of SSH protocol version 2.
92 \dd Enable SSH compression.
94 \dt \cw{-i} \e{keyfile}
96 \dd Private key file for user authentication. For SSH-2 keys, this key
97 file must be in PuTTY's PPK format, not OpenSSH's format or anyone
100 \lcont{ If you are using an authentication agent, you can also specify
101 a \e{public} key here (in RFC 4716 or OpenSSH format), to identify
102 which of the agent's keys to use. }
104 \dt \cw{\-hostkey} \e{key}
106 \dd Specify an acceptable host public key. This option may be specified
107 multiple times; each key can be either a fingerprint (\cw{99:aa:bb:...}) or
108 a base64-encoded blob in OpenSSH's one-line format.
110 \lcont{ Specifying this option overrides automated host key
111 management; \e{only} the key(s) specified on the command-line will be
112 accepted (unless a saved session also overrides host keys, in which
113 case those will be added to), and the host key cache will not be
118 \dd Force use of SCP protocol.
122 \dd Force use of SFTP protocol.
124 \dt \cw{\-sshlog} \e{logfile}
126 \dt \cw{\-sshrawlog} \e{logfile}
128 \dd These options make \cw{pscp} log protocol details to a file.
129 (Some of these may be sensitive, although by default an effort is made
130 to suppress obvious passwords.)
133 \cw{\-sshlog} logs decoded SSH packets and other events (those that
134 \cw{\-v} would print). \cw{\-sshrawlog} additionally logs the raw
135 encrypted packet data.
138 \S{pscp-manpage-more-information} MORE INFORMATION
140 For more information on \cw{pscp} it's probably best to go and look at
141 the manual on the PuTTY web page:
143 \W{http://www.chiark.greenend.org.uk/~sgtatham/putty/}\cw{http://www.chiark.greenend.org.uk/~sgtatham/putty/}
145 \S{pscp-manpage-bugs} BUGS
147 This man page isn't terribly complete. See the above web link for
148 better documentation.