]> asedeno.scripts.mit.edu Git - PuTTY.git/blob - doc/man-psft.but
12aa81f25750217360fbf89aca57898891fe0c5e
[PuTTY.git] / doc / man-psft.but
1 \cfg{man-identity}{psftp}{1}{2004-03-24}{PuTTY tool suite}{PuTTY tool suite}
2
3 \H{psftp-manpage} Man page for PSFTP
4
5 \S{psftp-manpage-name} NAME
6
7 \cw{psftp} \- interactive SFTP (secure file transfer protocol) client
8
9 \S{psftp-manpage-synopsis} SYNOPSIS
10
11 \c psftp [options] [user@]host
12 \e bbbbb  iiiiiii   iiiib iiii
13
14 \S{psftp-manpage-description} DESCRIPTION
15
16 \cw{psftp} is an interactive text-based client for the SSH-based SFTP
17 (secure file transfer) protocol.
18
19 \S{psftp-manpage-options} OPTIONS
20
21 The command-line options supported by \cw{psftp} are:
22
23 \dt \cw{-V}
24
25 \dd Show version information and exit.
26
27 \dt \cw{-pgpfp}
28
29 \dd Display the fingerprints of the PuTTY PGP Master Keys and exit,
30 to aid in verifying new files released by the PuTTY team.
31
32 \dt \cw{-b} \e{batchfile}
33
34 \dd Use specified batchfile.
35
36 \dt \cw{-bc}
37
38 \dd Output batchfile commands.
39
40 \dt \cw{-be}
41
42 \dd Don't stop batchfile processing on errors.
43
44 \dt \cw{-v}
45
46 \dd Show verbose messages.
47
48 \dt \cw{-load} \e{session}
49
50 \dd Load settings from saved session.
51
52 \dt \cw{-P} \e{port}
53
54 \dd Connect to port \e{port}.
55
56 \dt \cw{-l} \e{user}
57
58 \dd Set remote username to \e{user}.
59
60 \dt \cw{-batch}
61
62 \dd Disable interactive prompts.
63
64 \dt \cw{-pw} \e{password}
65
66 \dd Set remote password to \e{password}. \e{CAUTION:} this will likely
67 make the password visible to other users of the local machine (via
68 commands such as \q{\c{w}}).
69
70 \dt \cw{-1}
71
72 \dd Force use of SSH protocol version 1.
73
74 \dt \cw{-2}
75
76 \dd Force use of SSH protocol version 2.
77
78 \dt \cw{-4}, \cw{-6}
79
80 \dd Force use of IPv4 or IPv6 for network connections.
81
82 \dt \cw{-C}
83
84 \dd Enable SSH compression.
85
86 \dt \cw{-i} \e{keyfile}
87
88 \dd Private key file for user authentication. For SSH-2 keys, this key
89 file must be in PuTTY's PPK format, not OpenSSH's format or anyone
90 else's.
91
92 \lcont{ If you are using an authentication agent, you can also specify
93 a \e{public} key here (in RFC 4716 or OpenSSH format), to identify
94 which of the agent's keys to use. }
95
96 \dt \cw{\-noagent}
97
98 \dd Don't try to use an authentication agent.
99
100 \dt \cw{\-agent}
101
102 \dd Allow use of an authentication agent. (This option is only necessary
103 to override a setting in a saved session.)
104
105 \dt \cw{\-hostkey} \e{key}
106
107 \dd Specify an acceptable host public key. This option may be specified
108 multiple times; each key can be either a fingerprint (\cw{99:aa:bb:...}) or
109 a base64-encoded blob in OpenSSH's one-line format.
110
111 \lcont{ Specifying this option overrides automated host key
112 management; \e{only} the key(s) specified on the command-line will be
113 accepted (unless a saved session also overrides host keys, in which
114 case those will be added to), and the host key cache will not be
115 written. }
116
117 \dt \cw{\-sshlog} \e{logfile}
118
119 \dt \cw{\-sshrawlog} \e{logfile}
120
121 \dd These options make \cw{psftp} log protocol details to a file.
122 (Some of these may be sensitive, although by default an effort is made
123 to suppress obvious passwords.)
124
125 \lcont{
126 \cw{\-sshlog} logs decoded SSH packets and other events (those that
127 \cw{\-v} would print). \cw{\-sshrawlog} additionally logs the raw
128 encrypted packet data.
129 }
130
131 \S{psftp-manpage-commands} COMMANDS
132
133 For a list of commands available inside \cw{psftp}, type \cw{help}
134 at the \cw{psftp>} prompt.
135
136 \S{psftp-manpage-more-information} MORE INFORMATION
137
138 For more information on \cw{psftp} it's probably best to go and look at
139 the manual on the PuTTY web page:
140
141 \cw{http://www.chiark.greenend.org.uk/~sgtatham/putty/}
142
143 \S{psftp-manpage-bugs} BUGS
144
145 This man page isn't terribly complete. See the above web link for
146 better documentation.