X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/putty/blobdiff_plain/ded53fce5af6818acc2da88653b56c5c94377b8e..2e8324fc5624af5e4d3de5955bf781cf8a7c027c:/doc/pscp.but?ds=sidebyside

diff --git a/doc/pscp.but b/doc/pscp.but
index c7e2ca7c..9b79dd56 100644
--- a/doc/pscp.but
+++ b/doc/pscp.but
@@ -1,4 +1,4 @@
-\versionid $Id: pscp.but,v 1.8 2001/02/04 15:35:36 owen Exp $
+\versionid $Id: pscp.but,v 1.10 2001/02/19 10:54:18 simon Exp $
 
 \#FIXME: Need examples
 
@@ -61,8 +61,8 @@ To receive (a) file(s) from a remote server:
 
 \c pscp [options] [user@]host:source target
 
-So to copy the file /c{/etc/hosts} from the server /c{example.com} as
-user /c{fred} to the file \c{c:\temp\example-hosts.txt}, you would type:
+So to copy the file \c{/etc/hosts} from the server \c{example.com} as
+user \c{fred} to the file \c{c:\\temp\\example-hosts.txt}, you would type:
 
 \c pscp fred@example.com:/etc/hosts c:\temp\example-hosts.txt
 
@@ -70,8 +70,8 @@ To send (a) file(s) to a remote server:
 
 \c pscp [options] source [source...] [user@]host:target
 
-So to copy the local file /c{c:\documents\csh-whynot.txt} to the
-server /c{example.com} as user /c{fred} to the file
+So to copy the local file \c{c:\\documents\\csh-whynot.txt} to the
+server \c{example.com} as user \c{fred} to the file
 \c{/tmp/csh-whynot} you would type:
 
 \c pscp c:\documents\csh-whynot.txt fred@example.com:/tmp/csh-whynot
@@ -185,9 +185,34 @@ line.
 
 Since specifying passwords in scripts is a bad idea for security
 reasons, you might want instead to consider using public-key
-authentication (see \k{pubkey}).  PSCP will attempt to authenticate
-with any key specified in a saved session's configuration or with a
-key stored in Pageant (see \k{pageant}) before asking for a password.
+authentication; see \k{pscp-pubkey}.
+
+\S{pscp-pubkey} Using public key authentication with PSCP
+
+Like PuTTY, PSCP can authenticate using a public key instead of a
+password. There are two ways you can do this.
+
+Firstly, PSCP can use PuTTY saved sessions in place of hostnames
+(see \k{pscp-usage-basics-host}). So you would do this:
+
+\b Run PuTTY, and create a PuTTY saved session (see
+\k{config-saving}) which specifies your private key file (see
+\k{config-auth}). You will probably also want to specify a username
+to log in as (see \k{config-username}).
+
+\b In PSCP, you can now use the name of the session instead of a
+hostname: \c{pscp sessionname:file localfile}.
+
+Secondly, PSCP will attempt to authenticate using Pageant if Pageant
+is running (see \k{pageant}). So you would do this:
+
+\b Ensure Pageant is running, and has your private key stored in it.
+
+\b Specify a user and host name to PSCP as normal. PSCP will
+automatically detect Pageant and try to use the keys within it.
+
+For more general information on public-key authentication, see
+\k{pubkey}.
 
 \H{pscp-ixplorer} \i{Secure iXplorer}