xenial (1) putty.1.gz

Provided by: putty_0.67-3+deb9u1build0.16.04.1_amd64 bug

NAME

       putty - GUI SSH, Telnet and Rlogin client for X

SYNOPSIS

       putty [ options ] [ host ]

DESCRIPTION

       putty  is  a graphical SSH, Telnet and Rlogin client for X. It is a direct port of the Windows SSH client
       of the same name.

OPTIONS

       The command-line options supported by putty are:

       --display display-name
              Specify the X display on which to open putty. (Note this option has  a  double  minus  sign,  even
              though  none  of  the  others  do.  This  is because this option is supplied automatically by GTK.
              Sorry.)

       -fn font-name
              Specify the font to use for normal text displayed in the terminal.

       -fb font-name
              Specify the font to use for bold text displayed in the terminal. If the BoldAsColour  resource  is
              set  to  1  (the default), bold text will be displayed in different colours instead of a different
              font, so this option will be ignored. If BoldAsColour is set to 0 or 2 and you do  not  specify  a
              bold font, putty will overprint the normal font to make it look bolder.

       -fw font-name
              Specify  the font to use for double-width characters (typically Chinese, Japanese and Korean text)
              displayed in the terminal.

       -fwb font-name
              Specify the font to use for bold double-width characters (typically Chinese, Japanese  and  Korean
              text). Like -fb, this will be ignored unless the BoldAsColour resource is set to 0 or 2.

       -geometry geometry
              Specify  the  size  of the terminal, in rows and columns of text. See X(7) for more information on
              the syntax of geometry specifications.

       -sl lines
              Specify the number of lines of scrollback to save off the top of the terminal.

       -fg colour
              Specify the foreground colour to use for normal text.

       -bg colour
              Specify the background colour to use for normal text.

       -bfg colour
              Specify the foreground colour to use for bold text, if the BoldAsColour resource is set to 1  (the
              default) or 2.

       -bbg colour
              Specify  the foreground colour to use for bold reverse-video text, if the BoldAsColour resource is
              set to 1 (the default) or 2. (This colour is best thought of as the bold version of the background
              colour; so it only appears when text is displayed in the background colour.)

       -cfg colour
              Specify the foreground colour to use for text covered by the cursor.

       -cbg colour
              Specify  the  background colour to use for text covered by the cursor. In other words, this is the
              main colour of the cursor.

       -title title
              Specify the initial title of the terminal window. (This  can  be  changed  under  control  of  the
              server.)

       -sb- or +sb
              Tells putty not to display a scroll bar.

       -sb    Tells putty to display a scroll bar: this is the opposite of -sb-. This is the default option: you
              will probably only need to specify it explicitly  if  you  have  changed  the  default  using  the
              ScrollBar resource.

       -log logfile, -sessionlog logfile
              This  option  makes  putty  log  all the terminal output to a file as well as displaying it in the
              terminal.

       -sshlog logfile

       -sshrawlog logfile
              For SSH connections, these options make putty log protocol details to a file. (Some of  these  may
              be sensitive, although by default an effort is made to suppress obvious passwords.)

              -sshlog  logs  decoded  SSH  packets  and  other  events  (those  that -v would print). -sshrawlog
              additionally logs the raw encrypted packet data.

       -cs charset
              This option specifies the character set in which putty should assume  the  session  is  operating.
              This character set will be used to interpret all the data received from the session, and all input
              you type or paste into putty will be converted into this character set before being  sent  to  the
              session.

              Any  character  set  name which is valid in a MIME header (and supported by putty) should be valid
              here (examples are `ISO-8859-1', `windows-1252' or `UTF-8'). Also, any character encoding which is
              valid in an X logical font description should be valid (`ibm-cp437', for example).

              putty's default behaviour is to use the same character encoding as its primary font. If you supply
              a Unicode (iso10646-1) font, it will default to the UTF-8 character set.

              Character set names are case-insensitive.

       -nethack
              Tells putty to enable NetHack keypad mode, in which  the  numeric  keypad  generates  the  NetHack
              hjklyubn  direction  keys. This enables you to play NetHack with the numeric keypad without having
              to use the NetHack number_pad option (which requires you to press `n' before any repeat count). So
              you can move with the numeric keypad, and enter repeat counts with the normal number keys.

       -help, --help
              Display a message summarizing the available options.

       -pgpfp Display  the  fingerprints of the PuTTY PGP Master Keys, to aid in verifying new files released by
              the PuTTY team.

       -load session
              Load a saved session by name. This allows you to run a saved session  straight  from  the  command
              line without having to go through the configuration box first.

       -ssh, -telnet, -rlogin, -raw, -serial
              Select the protocol putty will use to make the connection.

       -l username
              Specify the username to use when logging in to the server.

       -L [srcaddr:]srcport:desthost:destport
              Set  up  a local port forwarding: listen on srcport (or srcaddr:srcport if specified), and forward
              any connections over the SSH connection to the destination address desthost:destport.  Only  works
              in SSH.

       -R [srcaddr:]srcport:desthost:destport
              Set  up  a  remote port forwarding: ask the SSH server to listen on srcport (or srcaddr:srcport if
              specified), and to forward any connections back over the SSH connection where the client will pass
              them on to the destination address desthost:destport. Only works in SSH.

       -D [srcaddr:]srcport
              Set  up  dynamic port forwarding. The client listens on srcport (or srcaddr:srcport if specified),
              and implements a SOCKS server. So you can point SOCKS-aware applications at  this  port  and  they
              will automatically use the SSH connection to tunnel all their connections. Only works in SSH.

       -P port
              Specify the port to connect to the server on.

       -A, -a Enable  (-A)  or  disable  (-a)  SSH  agent forwarding. Currently this only works with OpenSSH and
              SSH-1.

       -X, -x Enable (-X) or disable (-x) X11 forwarding.

       -T, -t Enable (-t) or disable (-T) the allocation of a pseudo-terminal at the server end.

       -C     Enable zlib-style compression on the connection.

       -1, -2 Select SSH protocol version 1 or 2.

       -i keyfile
              Specify a private key file to use for user authentication. For SSH-2 keys, this key file  must  be
              in PuTTY's format, not OpenSSH's or anyone else's.

       -hostkey key
              Specify  an  acceptable host public key. This option may be specified multiple times; each key can
              be either a fingerprint (99:aa:bb:...) or a base64-encoded blob in OpenSSH's one-line format.

              Specifying this option overrides automated host key management; only the key(s) specified  on  the
              command-line  will  be  accepted  (unless  a saved session also overrides host keys, in which case
              those will be added to), and the host key cache will not be written.

       -sercfg configuration-string
              Specify the configuration parameters for the serial port, in  -serial  mode.  configuration-string
              should be a comma-separated list of configuration parameters as follows:

                    Any single digit from 5 to 9 sets the number of data bits.

                    `1', `1.5' or `2' sets the number of stop bits.

                    Any other numeric string is interpreted as a baud rate.

                    A  single  lower-case letter specifies the parity: `n' for none, `o' for odd, `e' for even,
                     `m' for mark and `s' for space.

                    A single upper-case letter specifies the flow control: `N' for none, `X' for XON/XOFF,  `R'
                     for RTS/CTS and `D' for DSR/DTR.

SAVED SESSIONS

       Saved sessions are stored in a .putty/sessions subdirectory in your home directory.

MORE INFORMATION

       For more information on PuTTY, it's probably best to go and look at the manual on the web page:

       http://www.chiark.greenend.org.uk/~sgtatham/putty/

BUGS

       This man page isn't terribly complete.