Tweak documentation of -V option.
[sgt/putty] / doc / man-pl.but
1 \cfg{man-identity}{plink}{1}{2004-03-24}{PuTTY tool suite}{PuTTY tool suite}
2
3 \H{plink-manpage} Man page for Plink
4
5 \S{plink-manpage-name} NAME
6
7 \cw{plink} \- PuTTY link, command line network connection tool
8
9 \S{plink-manpage-synopsis} SYNOPSIS
10
11 \c plink [options] [user@]host [command]
12 \e bbbbb iiiiiii iiiib iiii iiiiiii
13
14 \S{plink-manpage-description} DESCRIPTION
15
16 \cw{plink} is a network connection tool supporting several protocols.
17
18 \S{plink-manpage-options} OPTIONS
19
20 The command-line options supported by \cw{plink} are:
21
22 \dt \cw{-V}
23
24 \dd Show version information and exit.
25
26 \dt \cw{-v}
27
28 \dd Show verbose messages.
29
30 \dt \cw{-load} \e{session}
31
32 \dd Load settings from saved session.
33
34 \dt \cw{-ssh}
35
36 \dd Force use of SSH protocol (default).
37
38 \dt \cw{-telnet}
39
40 \dd Force use of Telnet protocol.
41
42 \dt \cw{-rlogin}
43
44 \dd Force use of rlogin protocol.
45
46 \dt \cw{-raw}
47
48 \dd Force raw mode.
49
50 \dt \cw{-P} \e{port}
51
52 \dd Connect to port \e{port}.
53
54 \dt \cw{-l} \e{user}
55
56 \dd Set remote username to \e{user}.
57
58 \dt \cw{-m} \e{path}
59
60 \dd Read remote command(s) from local file \e{path}.
61
62 \dt \cw{-batch}
63
64 \dd Disable interactive prompts.
65
66 \dt \cw{-pw} \e{password}
67
68 \dd Set remote password to \e{password}.
69
70 \dt \cw{\-L} \cw{[}\e{srcaddr}\cw{:]}\e{srcport}\cw{:}\e{desthost}\cw{:}\e{destport}
71
72 \dd Set up a local port forwarding: listen on \e{srcport} (or
73 \e{srcaddr}:\e{srcport} if specified), and forward any connections
74 over the SSH connection to the destination address
75 \e{desthost}:\e{destport}. Only works in SSH.
76
77 \dt \cw{\-R} \cw{[}\e{srcaddr}\cw{:]}\e{srcport}\cw{:}\e{desthost}\cw{:}\e{destport}
78
79 \dd Set up a remote port forwarding: ask the SSH server to listen on
80 \e{srcport} (or \e{srcaddr}:\e{srcport} if specified), and to
81 forward any connections back over the SSH connection where the
82 client will pass them on to the destination address
83 \e{desthost}:\e{destport}. Only works in SSH.
84
85 \dt \cw{\-D} [\e{srcaddr}:]\e{srcport}
86
87 \dd Set up dynamic port forwarding. The client listens on
88 \e{srcport} (or \e{srcaddr}:\e{srcport} if specified), and
89 implements a SOCKS server. So you can point SOCKS-aware applications
90 at this port and they will automatically use the SSH connection to
91 tunnel all their connections. Only works in SSH.
92
93 \dt \cw{-X}
94
95 \dd Enable X11 forwarding.
96
97 \dt \cw{-x}
98
99 \dd Disable X11 forwarding (default).
100
101 \dt \cw{-A}
102
103 \dd Enable agent forwarding.
104
105 \dt \cw{-a}
106
107 \dd Disable agent forwarding (default).
108
109 \dt \cw{-t}
110
111 \dd Enable pty allocation (default if a command is NOT specified).
112
113 \dt \cw{-T}
114
115 \dd Disable pty allocation (default if a command is specified).
116
117 \dt \cw{-1}
118
119 \dd Force use of SSH protocol version 1.
120
121 \dt \cw{-2}
122
123 \dd Force use of SSH protocol version 2.
124
125 \dt \cw{-C}
126
127 \dd Enable SSH compression.
128
129 \dt \cw{-i} \e{path}
130
131 \dd Private key file for authentication.
132
133 \dt \cw{-s}
134
135 \dd Remote command is SSH subsystem (SSH-2 only).
136
137 \S{plink-manpage-more-information} MORE INFORMATION
138
139 For more information on plink, it's probably best to go and look at
140 the manual on the PuTTY web page:
141
142 \W{http://www.chiark.greenend.org.uk/~sgtatham/putty/}\cw{http://www.chiark.greenend.org.uk/~sgtatham/putty/}
143
144 \S{plink-manpage-bugs} BUGS
145
146 This man page isn't terribly complete. See the above web link for
147 better documentation.