1psftp(1)                       PuTTY tool suite                       psftp(1)
2
3
4

NAME

6       psftp - interactive SFTP (secure file transfer protocol) client
7

SYNOPSIS

9       psftp [options] [user@]host
10

DESCRIPTION

12       psftp  is  an interactive text-based client for the SSH-based SFTP (se‐
13       cure file transfer) protocol.
14

OPTIONS

16       The command-line options supported by psftp are:
17
18       -V     Show version information and exit.
19
20       -pgpfp Display the fingerprints of the PuTTY PGP Master Keys and  exit,
21              to aid in verifying new files released by the PuTTY team.
22
23       -b batchfile
24              Use specified batchfile.
25
26       -bc    Output batchfile commands.
27
28       -be    Don't stop batchfile processing on errors.
29
30       -v     Show verbose messages.
31
32       -load session
33              Load settings from saved session.
34
35       -P port
36              Connect to port port.
37
38       -proxycmd command
39              Instead of making a TCP connection, use command as a proxy; net‐
40              work traffic will be redirected to the standard input and output
41              of  command. command must be a single word, so is likely to need
42              quoting by the shell.
43
44              The special strings %host and %port in command will be  replaced
45              by the hostname and port number you want to connect to; to get a
46              literal % sign, enter %%.
47
48              Backslash escapes are also supported, such as sequences like  \n
49              being replaced by a literal newline; to get a literal backslash,
50              enter \\. (Further escaping may be required by the shell.)
51
52              (See the main PuTTY manual for full details of the supported  %-
53              and backslash-delimited tokens, although most of them are proba‐
54              bly not very useful in this context.)
55
56       -l user
57              Set remote username to user.
58
59       -batch Disable interactive prompts.
60
61       -no-sanitise-stderr
62              By default, PSFTP will filter control characters from the  stan‐
63              dard  error channel from the server, to prevent remote processes
64              sending confusing escape sequences. This option forces the stan‐
65              dard error channel to not be filtered.
66
67       -pw password
68              Set  remote password to password. CAUTION: this will likely make
69              the password visible to other users of the  local  machine  (via
70              commands such as `w').
71
72       -1     Force use of SSH protocol version 1.
73
74       -2     Force use of SSH protocol version 2.
75
76       -ssh-connection
77              Force  use  of  the `bare ssh-connection' protocol. This is only
78              likely to be useful when connecting to a psusan(1) server,  most
79              likely with an absolute path to a Unix-domain socket in place of
80              host.
81
82       -ssh   Force use of the SSH protocol. (This is usually not needed; it's
83              only likely to be useful if you need to override some other con‐
84              figuration of the `bare ssh-connection' protocol.)
85
86       -4, -6 Force use of IPv4 or IPv6 for network connections.
87
88       -C     Enable SSH compression.
89
90       -i keyfile
91              Private key file for user authentication. For SSH-2  keys,  this
92              key  file must be in PuTTY's PPK format, not OpenSSH's format or
93              anyone else's.
94
95              If you are using an authentication agent, you can also specify a
96              public  key  here  (in  RFC 4716 or OpenSSH format), to identify
97              which of the agent's keys to use.
98
99       -noagent
100              Don't try to use an authentication agent.
101
102       -agent Allow use of an authentication agent. (This option is only  nec‐
103              essary to override a setting in a saved session.)
104
105       -hostkey key
106              Specify an acceptable host public key. This option may be speci‐
107              fied multiple times;  each  key  can  be  either  a  fingerprint
108              (SHA256:AbCdE..., 99:aa:bb:..., etc) or a base64-encoded blob in
109              OpenSSH's one-line format.
110
111              Specifying this option overrides automated host key  management;
112              only  the  key(s) specified on the command-line will be accepted
113              (unless a saved session also overrides host keys, in which  case
114              those  will  be  added  to),  and the host key cache will not be
115              written.
116
117       -sshlog logfile
118
119
120       -sshrawlog logfile
121              These options make psftp log protocol details to a  file.  (Some
122              of these may be sensitive, although by default an effort is made
123              to suppress obvious passwords.)
124
125              -sshlog logs decoded SSH packets and other events (those that -v
126              would  print).  -sshrawlog  additionally  logs the raw encrypted
127              packet data.
128
129       -logoverwrite
130              If PSFTP is configured to write to a log file that  already  ex‐
131              ists, discard the existing file.
132
133       -logappend
134              If  PSFTP  is configured to write to a log file that already ex‐
135              ists, append new log data to the existing file.
136

COMMANDS

138       For a list of commands available inside psftp, type help at the  psftp>
139       prompt.
140

MORE INFORMATION

142       For  more information on psftp it's probably best to go and look at the
143       manual on the PuTTY web page:
144
145       https://www.chiark.greenend.org.uk/~sgtatham/putty/
146

BUGS

148       This man page isn't terribly complete. See the above web link for  bet‐
149       ter documentation.
150
151
152
153PuTTY tool suite                  2004‐03‐24                          psftp(1)