-\versionid $Id: using.but,v 1.22 2004/04/08 12:38:53 simon Exp $
+\versionid $Id: using.but,v 1.27 2004/08/12 20:55:58 jacob Exp $
\C{using} Using PuTTY
\S{using-sysmenu} The \i{System menu}
If you click the left mouse button on the icon in the top left
-corner of PuTTY's window, or click the right mouse button on the
-title bar, you will see the standard Windows system menu containing
-items like Minimise, Move, Size and Close.
+corner of PuTTY's terminal window, or click the right mouse button
+on the title bar, you will see the standard Windows system menu
+containing items like Minimise, Move, Size and Close.
PuTTY's system menu contains extra program features in addition to
the Windows standard options. These extra menu commands are
you, you should mail the PuTTY authors \#{FIXME} and give details
(see \k{feedback}).
+For more options relating to X11 forwarding, see \k{config-ssh-x11}.
+
\H{using-port-forwarding} Using \i{port forwarding} in SSH
The SSH protocol has the ability to forward arbitrary network
\I{saved sessions, loading from command line}The \c{-load} option
causes PuTTY to load configuration details out of a saved session.
If these details include a host name, then this option is all you
-need to make PuTTY start a session (although Plink still requires an
-explicitly specified host name).
+need to make PuTTY start a session.
You need double quotes around the session name if it contains spaces.
Connection panel of the PuTTY configuration box (see
\k{config-username}).
-\S2{using-cmdline-portfwd} \i\c{-L}, \i\c{-R} and \i\c{-D}: set up
-\i{port forwardings}
+\S2{using-cmdline-portfwd} \I{-L-upper}\c{-L}, \I{-R-upper}\c{-R}
+and \I{-D-upper}\c{-D}: set up \i{port forwardings}
As well as setting up port forwardings in the PuTTY configuration
(see \k{config-ssh-portfwd}), you can also set up forwardings on the
\k{config-command}). However, the \c{-m} option expects to be given
a local file name, and it will read a command from that file. On
most Unix systems, you can even put multiple lines in this file and
-execute more than one command in sequence, or a whole shell script.
+execute more than one command in sequence, or a whole shell script;
+but this will not work on all servers (and is known not to work
+with certain \q{embedded} servers such as routers).
This option is not available in the file transfer tools PSCP and
PSFTP.
-\S2{using-cmdline-p} \i\c{-P}: specify a \i{port number}
+\S2{using-cmdline-p} \I{-P-upper}\c{-P}: specify a \i{port number}
The \c{-P} option is used to specify the port number to connect to. If
you have a Telnet server running on port 9696 of a machine instead of
protocol. Due to fundamental limitations of Telnet and Rlogin, these
protocols do not support automated password authentication.
-\S2{using-cmdline-agent} \i\c{-A} and \i\c{-a}: control \i{agent
+\S2{using-cmdline-agent} \I{-A-upper}\c{-A} and \i\c{-a}: control \i{agent
forwarding}
The \c{-A} option turns on SSH agent forwarding, and \c{-a} turns it
These options are not available in the file transfer tools PSCP and
PSFTP.
-\S2{using-cmdline-x11} \i\c{-X} and \i\c{-x}: control \i{X11
+\S2{using-cmdline-x11} \I{-X-upper}\c{-X} and \i\c{-x}: control \i{X11
forwarding}
The \c{-X} option turns on X11 forwarding in SSH, and \c{-x} turns
These options are not available in the file transfer tools PSCP and
PSFTP.
-\S2{using-cmdline-pty} \i\c{-t} and \i\c{-T}: control
+\S2{using-cmdline-pty} \i\c{-t} and \I{-T-upper}\c{-T}: control
\i{pseudo-terminal allocation}
The \c{-t} option ensures PuTTY attempts to allocate a
These options are not available in the file transfer tools PSCP and
PSFTP.
-\S2{using-cmdline-compress} \i\c{-C}: enable \i{compression}
+\S2{using-cmdline-compress} \I{-C-upper}\c{-C}: enable \i{compression}
The \c{-C} option enables compression of the data sent across the
network. This option is only meaningful if you are using SSH.