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.