1puttytel(1) PuTTY tool suite puttytel(1)
2
3
4
6 puttytel - GUI Telnet, Rlogin, and SUPDUP client for X
7
9 puttytel [ options ] [ host ]
10
12 puttytel is a graphical Telnet, Rlogin, and SUPDUP client for X. It is
13 a direct port of the Windows Telnet, Rlogin, and SUPDUP client of the
14 same name, and a cut-down cryptography-free version of PuTTY.
15
17 The command-line options supported by puttytel are:
18
19 --display display-name
20 Specify the X display on which to open puttytel. (Note this op‐
21 tion has a double minus sign, even though none of the others do.
22 This is because this option is supplied automatically by GTK.
23 Sorry.)
24
25 -fn font-name
26 Specify the font to use for normal text displayed in the termi‐
27 nal. For example, -fn fixed, -fn "Monospace 12".
28
29 -fb font-name
30 Specify the font to use for bold text displayed in the terminal.
31 If the BoldAsColour resource is set to 1 (the default), bold
32 text will be displayed in different colours instead of a differ‐
33 ent font, so this option will be ignored. If BoldAsColour is set
34 to 0 or 2 and you do not specify a bold font, puttytel will
35 overprint the normal font to make it look bolder.
36
37 -fw font-name
38 Specify the font to use for double-width characters (typically
39 Chinese, Japanese and Korean text) displayed in the terminal.
40
41 -fwb font-name
42 Specify the font to use for bold double-width characters (typi‐
43 cally Chinese, Japanese and Korean text). Like -fb, this will be
44 ignored unless the BoldAsColour resource is set to 0 or 2.
45
46 -geometry geometry
47 Specify the size of the terminal, in rows and columns of text.
48 See X(7) for more information on the syntax of geometry specifi‐
49 cations.
50
51 -sl lines
52 Specify the number of lines of scrollback to save off the top of
53 the terminal.
54
55 -fg colour
56 Specify the foreground colour to use for normal text.
57
58 -bg colour
59 Specify the background colour to use for normal text.
60
61 -bfg colour
62 Specify the foreground colour to use for bold text, if the
63 BoldAsColour resource is set to 1 (the default) or 2.
64
65 -bbg colour
66 Specify the foreground colour to use for bold reverse-video
67 text, if the BoldAsColour resource is set to 1 (the default) or
68 2. (This colour is best thought of as the bold version of the
69 background colour; so it only appears when text is displayed in
70 the background colour.)
71
72 -cfg colour
73 Specify the foreground colour to use for text covered by the
74 cursor.
75
76 -cbg colour
77 Specify the background colour to use for text covered by the
78 cursor. In other words, this is the main colour of the cursor.
79
80 -title title
81 Specify the initial title of the terminal window. (This can be
82 changed under control of the server.)
83
84 -sb- or +sb
85 Tells puttytel not to display a scroll bar.
86
87 -sb Tells puttytel to display a scroll bar: this is the opposite of
88 -sb-. This is the default option: you will probably only need to
89 specify it explicitly if you have changed the default using the
90 ScrollBar resource.
91
92 -log logfile, -sessionlog logfile
93 This option makes puttytel log all the terminal output to a file
94 as well as displaying it in the terminal.
95
96 -cs charset
97 This option specifies the character set in which puttytel should
98 assume the session is operating. This character set will be used
99 to interpret all the data received from the session, and all in‐
100 put you type or paste into puttytel will be converted into this
101 character set before being sent to the session.
102
103 Any character set name which is valid in a MIME header (and sup‐
104 ported by puttytel) should be valid here (examples are
105 `ISO-8859-1', `windows-1252' or `UTF-8'). Also, any character
106 encoding which is valid in an X logical font description should
107 be valid (`ibm-cp437', for example).
108
109 puttytel's default behaviour is to use the same character encod‐
110 ing as its primary font. If you supply a Unicode (iso10646-1)
111 font, it will default to the UTF-8 character set.
112
113 Character set names are case-insensitive.
114
115 -nethack
116 Tells puttytel to enable NetHack keypad mode, in which the nu‐
117 meric keypad generates the NetHack hjklyubn direction keys. This
118 enables you to play NetHack with the numeric keypad without hav‐
119 ing to use the NetHack number_pad option (which requires you to
120 press `n' before any repeat count). So you can move with the nu‐
121 meric keypad, and enter repeat counts with the normal number
122 keys.
123
124 -help, --help
125 Display a message summarizing the available options.
126
127 -pgpfp Display the fingerprints of the PuTTY PGP Master Keys, to aid in
128 verifying new files released by the PuTTY team.
129
130 -load session
131 Load a saved session by name. This allows you to run a saved
132 session straight from the command line without having to go
133 through the configuration box first.
134
135 -telnet, -rlogin, -supdup, -raw
136 Select the protocol puttytel will use to make the connection.
137
138 -proxycmd command
139 Instead of making a TCP connection, use command as a proxy; net‐
140 work traffic will be redirected to the standard input and output
141 of command. command must be a single word, so is likely to need
142 quoting by the shell.
143
144 The special strings %host and %port in command will be replaced
145 by the hostname and port number you want to connect to; to get a
146 literal % sign, enter %%.
147
148 Backslash escapes are also supported, such as sequences like \n
149 being replaced by a literal newline; to get a literal backslash,
150 enter \\. (Further escaping may be required by the shell.)
151
152 (See the main PuTTY manual for full details of the supported %-
153 and backslash-delimited tokens, although most of them are proba‐
154 bly not very useful in this context.)
155
156 -l username
157 Specify the username to use when logging in to the server.
158
159 -P port
160 Specify the port to connect to the server on.
161
162 -4, -6 Force use of IPv4 or IPv6 for network connections.
163
165 Saved sessions are stored in a .putty/sessions subdirectory in your
166 home directory.
167
169 For more information on PuTTY and PuTTYtel, it's probably best to go
170 and look at the manual on the web page:
171
172 https://www.chiark.greenend.org.uk/~sgtatham/putty/
173
175 This man page isn't terribly complete.
176
177
178
179PuTTY tool suite 2004‐03‐24 puttytel(1)