Rationalise and document log options somewhat.

[PuTTY.git] / doc / man-pscp.but

diff --git a/doc/man-pscp.but b/doc/man-pscp.but
index c330a1ac98c5beeb5d3d18dfa6ff376d2c7e0727..1b95d4d243f9c3af6015d7196e80dc24e5153c32 100644 (file)
--- a/doc/man-pscp.but
+++ b/doc/man-pscp.but
@@ -28,6 +28,11 @@ The command-line options supported by \e{pscp} are:
 
 \dd Show version information and exit.
 
+\dt \cw{-pgpfp}
+
+\dd Display the fingerprints of the PuTTY PGP Master Keys and exit,
+to aid in verifying new files released by the PuTTY team.
+
 \dt \cw{-ls}
 
 \dd Remote directory listing.
@@ -70,7 +75,9 @@ The command-line options supported by \e{pscp} are:
 
 \dt \cw{-pw} \e{password}
 
-\dd Set remote password to \e{password}.
+\dd Set remote password to \e{password}. \e{CAUTION:} this will likely
+make the password visible to other users of the local machine (via
+commands such as \q{\c{w}}).
 
 \dt \cw{-1}
 
@@ -86,7 +93,19 @@ The command-line options supported by \e{pscp} are:
 
 \dt \cw{-i} \e{path}
 
-\dd Private key file for authentication.
+\dd Private key file for user authentication.
+
+\dt \cw{\-hostkey} \e{key}
+
+\dd Specify an acceptable host public key. This option may be specified
+multiple times; each key can be either a fingerprint (\cw{99:aa:bb:...}) or
+a base64-encoded blob in OpenSSH's one-line format.
+
+\lcont{ Specifying this option overrides automated host key
+management; \e{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. }
 
 \dt \cw{-scp}
 
@@ -96,6 +115,20 @@ The command-line options supported by \e{pscp} are:
 
 \dd Force use of SFTP protocol.
 
+\dt \cw{\-sshlog} \e{logfile}
+
+\dt \cw{\-sshrawlog} \e{logfile}
+
+\dd These options make \cw{pscp} log protocol details to a file.
+(Some of these may be sensitive, although by default an effort is made
+to suppress obvious passwords.)
+
+\lcont{
+\cw{\-sshlog} logs decoded SSH packets and other events (those that
+\cw{\-v} would print). \cw{\-sshrawlog} additionally logs the raw
+encrypted packet data.
+}
+
 \S{pscp-manpage-more-information} MORE INFORMATION
 
 For more information on \cw{pscp} it's probably best to go and look at