:Title PuTTY User Manual 1 Title page=Top 1 Chapter 1: Introduction to PuTTY 2 Chapter 1: Introduction to PuTTY=t00000000 2 Section 1.1: What are SSH, Telnet and Rlogin?=t00000001 2 Section 1.2: How do SSH, Telnet and Rlogin differ?=t00000002 1 Chapter 2: Getting started with PuTTY 2 Chapter 2: Getting started with PuTTY=t00000003 2 Section 2.1: Starting a session=t00000004 2 Section 2.2: Verifying the Host Key (SSH only)=t00000005 2 Section 2.3: Logging In=t00000006 2 Section 2.4: After Logging In=t00000007 2 Section 2.5: Logging Out=t00000008 1 Chapter 3: Using PuTTY 2 Chapter 3: Using PuTTY=t00000009 2 Section 3.1: During your session 3 Section 3.1: During your session=t00000010 3 Section 3.1.1: Copying and pasting text=t00000011 3 Section 3.1.2: Scrolling the screen back=t00000012 3 Section 3.1.3: The System menu 4 Section 3.1.3: The System menu=t00000013 4 Section 3.1.3.1: The PuTTY Event Log=t00000014 4 Section 3.1.3.2: Starting new sessions=t00000015 4 Section 3.1.3.3: Changing your session settings=t00000016 4 Section 3.1.3.4: Copy All to Clipboard=t00000017 4 Section 3.1.3.5: Clearing and resetting the terminal=t00000018 4 Section 3.1.3.6: Full screen mode=t00000019 1 Section 3.2: Creating a log file of your session=t00000020 1 Section 3.3: Altering your character set configuration=t00000021 1 Section 3.4: Using X11 forwarding in SSH=t00000022 1 Section 3.5: Using port forwarding in SSH=t00000023 1 Section 3.6: Making raw TCP connections=t00000024 1 Chapter 4: Configuring PuTTY 2 Chapter 4: Configuring PuTTY=t00000025 2 Section 4.1: The Session panel 3 Section 4.1: The Session panel=t00000026 3 Section 4.1.1: The host name section=session.hostname 3 Section 4.1.2: Loading and storing saved sessions=session.saved 3 Section 4.1.3: ‘Close Window on Exit’=session.coe 2 Section 4.2: The Logging panel 3 Section 4.2: The Logging panel=logging.main 3 Section 4.2.1: ‘Log file name’=logging.filename 3 Section 4.2.2: ‘What to do if the log file already exists’=logging.exists 2 Section 4.3: The Terminal panel 3 Section 4.3: The Terminal panel=t00000027 3 Section 4.3.1: ‘Auto wrap mode initially on’=terminal.autowrap 3 Section 4.3.2: ‘DEC Origin Mode initially on’=terminal.decom 3 Section 4.3.3: ‘Implicit CR in every LF’=terminal.lfhascr 3 Section 4.3.4: ‘Use background colour to erase screen’=terminal.bce 3 Section 4.3.5: ‘Enable blinking text’=terminal.blink 3 Section 4.3.6: ‘Answerback to ^E’=terminal.answerback 3 Section 4.3.7: ‘Local echo’=terminal.localecho 3 Section 4.3.8: ‘Local line editing’=terminal.localedit 2 Section 4.4: The Keyboard panel 3 Section 4.4: The Keyboard panel=t00000028 3 Section 4.4.1: Changing the action of the Backspace key=keyboard.backspace 3 Section 4.4.2: Changing the action of the Home and End keys=keyboard.homeend 3 Section 4.4.3: Changing the action of the function keys and keypad=keyboard.funkeys 3 Section 4.4.4: Controlling Application Cursor Keys mode=keyboard.appcursor 3 Section 4.4.5: Controlling Application Keypad mode=keyboard.appkeypad 3 Section 4.4.6: Using NetHack keypad mode=keyboard.nethack 3 Section 4.4.7: Enabling a DEC-like Compose key=keyboard.compose 3 Section 4.4.8: ‘Control-Alt is different from AltGr’=keyboard.ctrlalt 2 Section 4.5: The Bell panel 3 Section 4.5: The Bell panel=t00000029 3 Section 4.5.1: ‘Set the style of bell’=bell.style 3 Section 4.5.2: ‘Taskbar/caption indication on bell’=bell.taskbar 3 Section 4.5.3: ‘Control the bell overload behaviour’=bell.overload 2 Section 4.6: The Window panel 3 Section 4.6: The Window panel=t00000030 3 Section 4.6.1: Setting the size of the PuTTY window=window.size 3 Section 4.6.2: What to do when the window is resized=window.resize 3 Section 4.6.3: Controlling scrollback=window.scrollback 2 Section 4.7: The Appearance panel 3 Section 4.7: The Appearance panel=t00000031 3 Section 4.7.1: Controlling the appearance of the cursor=appearance.cursor 3 Section 4.7.2: Controlling the font used in the terminal window=appearance.font 3 Section 4.7.3: Controlling the window title=appearance.title 3 Section 4.7.4: ‘Hide mouse pointer when typing in window’=appearance.hidemouse 3 Section 4.7.5: Controlling the window border=appearance.border 2 Section 4.8: The Behaviour panel 3 Section 4.8: The Behaviour panel=t00000032 3 Section 4.8.1: ‘Warn before closing window’=behaviour.closewarn 3 Section 4.8.2: ‘Window closes on ALT-F4’=behaviour.altf4 3 Section 4.8.3: ‘System menu appears on ALT-Space’=behaviour.altspace 3 Section 4.8.4: ‘System menu appears on Alt alone’=behaviour.altonly 3 Section 4.8.5: ‘Ensure window is always on top’=behaviour.alwaysontop 3 Section 4.8.6: ‘Full screen on Alt-Enter’=behaviour.altenter 2 Section 4.9: The Translation panel 3 Section 4.9: The Translation panel=t00000033 3 Section 4.9.1: Controlling character set translation=translation.codepage 3 Section 4.9.2: ‘Caps Lock acts as Cyrillic switch’=translation.cyrillic 3 Section 4.9.3: Controlling display of line drawing characters=translation.linedraw 2 Section 4.10: The Selection panel 3 Section 4.10: The Selection panel=t00000034 3 Section 4.10.1: Controlling the pasting of line drawing characters=selection.linedraw 3 Section 4.10.2: Pasting in Rich Text Format=selection.rtf 3 Section 4.10.3: Changing the actions of the mouse buttons=selection.buttons 3 Section 4.10.4: ‘Shift overrides application's use of mouse’=selection.shiftdrag 3 Section 4.10.5: Default selection mode=selection.rect 3 Section 4.10.6: Configuring word-by-word selection=selection.charclasses 2 Section 4.11: The Colours panel 3 Section 4.11: The Colours panel=t00000035 3 Section 4.11.1: ‘Bolded text is a different colour’=colours.bold 3 Section 4.11.2: ‘Attempt to use logical palettes’=colours.logpal 3 Section 4.11.3: Adjusting the colours in the terminal window=colours.config 2 Section 4.12: The Connection panel 3 Section 4.12: The Connection panel=t00000036 3 Section 4.12.1: ‘Terminal-type string’=connection.termtype 3 Section 4.12.2: ‘Auto-login username’=connection.username 3 Section 4.12.3: Using keepalives to prevent disconnection=connection.keepalive 3 Section 4.12.4: ‘Disable Nagle's algorithm’=connection.nodelay 2 Section 4.13: The Telnet panel 3 Section 4.13: The Telnet panel=t00000037 3 Section 4.13.1: ‘Terminal-speed string’=telnet.termspeed 3 Section 4.13.2: Setting environment variables on the server=telnet.environ 3 Section 4.13.3: ‘Handling of OLD_ENVIRON ambiguity’=telnet.oldenviron 3 Section 4.13.4: Passive and active Telnet negotiation modes=telnet.passive 3 Section 4.13.5: ‘Keyboard sends telnet Backspace and Interrupt’=telnet.specialkeys 3 Section 4.13.6: ‘Return key sends telnet New Line instead of ^M’=telnet.newline 2 Section 4.14: The Rlogin panel 3 Section 4.14: The Rlogin panel=t00000038 3 Section 4.14.1: ‘Terminal-speed string’=rlogin.termspeed 3 Section 4.14.2: ‘Local username’=rlogin.localuser 2 Section 4.15: The SSH panel 3 Section 4.15: The SSH panel=t00000039 3 Section 4.15.1: Executing a specific command on the server=ssh.command 3 Section 4.15.2: ‘Don't allocate a pseudo-terminal’=ssh.nopty 3 Section 4.15.3: ‘Enable compression’=ssh.compress 3 Section 4.15.4: ‘Preferred SSH protocol version’=ssh.protocol 3 Section 4.15.5: ‘Imitate SSH 2 MAC bug’=ssh.buggymac 3 Section 4.15.6: Encryption algorithm selection=ssh.ciphers 2 Section 4.16: The Auth panel 3 Section 4.16: The Auth panel=t00000040 3 Section 4.16.1: ‘Attempt TIS or CryptoCard authentication’=ssh.auth.tis 3 Section 4.16.2: ‘Attempt keyboard-interactive authentication’=ssh.auth.ki 3 Section 4.16.3: ‘Allow agent forwarding’=ssh.auth.agentfwd 3 Section 4.16.4: ‘Allow attempted changes of username in SSH2’=ssh.auth.changeuser 3 Section 4.16.5: ‘Private key file for authentication’=ssh.auth.privkey 2 Section 4.17: The Tunnels panel 3 Section 4.17: The Tunnels panel=t00000041 3 Section 4.17.1: X11 forwarding=ssh.tunnels.x11 3 Section 4.17.2: Port forwarding=ssh.tunnels.portfwd 3 Section 4.17.3: Controlling the visibility of forwarded ports=ssh.tunnels.portfwd.localhost 1 Section 4.18: Storing configuration in a file=t00000042 1 Chapter 5: Using PSCP to transfer files securely 2 Chapter 5: Using PSCP to transfer files securely=t00000043 2 Section 5.1: Starting PSCP=t00000044 2 Section 5.2: PSCP Usage 3 Section 5.2: PSCP Usage=t00000045 3 Section 5.2.1: The basics 4 Section 5.2.1: The basics=t00000046 4 Section 5.2.1.1: user=t00000047 4 Section 5.2.1.2: host=t00000048 4 Section 5.2.1.3: source=t00000049 4 Section 5.2.1.4: target=t00000050 3 Section 5.2.2: Options 4 Section 5.2.2: Options=t00000051 4 Section 5.2.2.1: -p preserve file attributes=t00000052 4 Section 5.2.2.2: -q quiet, don't show statistics=t00000053 4 Section 5.2.2.3: -r copies directories recursively=t00000054 4 Section 5.2.2.4: -v show verbose messages=t00000055 4 Section 5.2.2.5: -P port connect to specified port=t00000056 4 Section 5.2.2.6: -pw passw login with specified password=t00000057 4 Section 5.2.2.7: -batch avoid interactive prompts=t00000058 2 Section 5.2.3: Return value=t00000059 2 Section 5.2.4: Using public key authentication with PSCP=t00000060 1 Section 5.3: Secure iXplorer=t00000061 1 Chapter 6: Using PSFTP to transfer files securely 2 Chapter 6: Using PSFTP to transfer files securely=t00000062 2 Section 6.1: Starting PSFTP 3 Section 6.1: Starting PSFTP=t00000063 3 Section 6.1.1: -l: specify a user name=t00000064 3 Section 6.1.2: -P: specify a port number=t00000065 3 Section 6.1.3: -v: show verbose messages=t00000066 3 Section 6.1.4: -pw: specify a password=t00000067 3 Section 6.1.5: -b: specify a file containing batch commands=t00000068 3 Section 6.1.6: -bc: display batch commands as they are run=t00000069 3 Section 6.1.7: -be: continue batch processing on errors=t00000070 3 Section 6.1.8: -batch: avoid interactive prompts=t00000071 2 Section 6.2: Running PSFTP 3 Section 6.2: Running PSFTP=t00000072 3 Section 6.2.1: General quoting rules for PSFTP commands=t00000073 3 Section 6.2.2: The open command: start a session=t00000074 3 Section 6.2.3: The quit command: end your session=t00000075 3 Section 6.2.4: The help command: get quick online help=t00000076 3 Section 6.2.5: The cd and pwd commands: changing the remote working directory=t00000077 3 Section 6.2.6: The lcd and lpwd commands: changing the local working directory=t00000078 3 Section 6.2.7: The get command: fetch a file from the server=t00000079 3 Section 6.2.8: The put command: send a file to the server=t00000080 3 Section 6.2.9: The reget and reput commands: resuming file transfers=t00000081 3 Section 6.2.10: The dir command: list remote files=t00000082 3 Section 6.2.11: The chmod command: change permissions on remote files=t00000083 3 Section 6.2.12: The del command: delete remote files=t00000084 3 Section 6.2.13: The mkdir command: create remote directories=t00000085 3 Section 6.2.14: The rmdir command: remove remote directories=t00000086 3 Section 6.2.15: The ren command: rename remote files=t00000087 3 Section 6.2.16: The ! command: run a local Windows command=t00000088 1 Section 6.3: Using public key authentication with PSFTP=t00000089 1 Chapter 7: Using the command-line connection tool Plink 2 Chapter 7: Using the command-line connection tool Plink=t00000090 2 Section 7.1: Starting Plink=t00000091 2 Section 7.2: Using Plink 3 Section 7.2: Using Plink=t00000092 3 Section 7.2.1: Using Plink for interactive logins=t00000093 3 Section 7.2.2: Using Plink for automated connections=t00000094 3 Section 7.2.3: Options 4 Section 7.2.3: Options=t00000095 4 Section 7.2.3.1: -v show verbose messages=t00000096 4 Section 7.2.3.2: Protocol selection options=t00000097 4 Section 7.2.3.3: -P port connect to specified port=t00000098 4 Section 7.2.3.4: -pw passw login with specified password=t00000099 4 Section 7.2.3.5: -l username login with specified username=t00000100 4 Section 7.2.3.6: -batch avoid interactive prompts=t00000101 4 Section 7.2.3.7: -m filename read command from a file=t00000102 4 Section 7.2.3.8: -L and -R set up port forwarding=t00000103 1 Section 7.3: Using Plink in batch files and scripts=t00000104 1 Section 7.4: Using Plink with CVS=t00000105 1 Section 7.5: Using Plink with WinCVS=t00000106 1 Chapter 8: Using public keys for SSH authentication 2 Chapter 8: Using public keys for SSH authentication=t00000107 2 Section 8.1: Public key authentication - an introduction=t00000108 2 Section 8.2: Using PuTTYgen, the PuTTY key generator 3 Section 8.2: Using PuTTYgen, the PuTTY key generator=t00000109 3 Section 8.2.1: Generating a new key=t00000110 3 Section 8.2.2: Selecting the type of key=puttygen.keytype 3 Section 8.2.3: Selecting the size (strength) of the key=puttygen.bits 3 Section 8.2.4: The ‘Generate’ button=puttygen.generate 3 Section 8.2.5: The ‘Key fingerprint’ box=puttygen.fingerprint 3 Section 8.2.6: Setting a comment for your key=puttygen.comment 3 Section 8.2.7: Setting a passphrase for your key=puttygen.passphrase 3 Section 8.2.8: Saving your private key to a disk file=puttygen.savepriv 3 Section 8.2.9: Saving your public key to a disk file=puttygen.savepub 3 Section 8.2.10: ‘Public key for pasting into authorized_keys file’=puttygen.pastekey 3 Section 8.2.11: Reloading a private key=puttygen.load 1 Section 8.3: Getting ready for public key authentication=t00000111 1 Chapter 9: Using Pageant for authentication 2 Chapter 9: Using Pageant for authentication=pageant.general 2 Section 9.1: Getting started with Pageant=t00000112 2 Section 9.2: The Pageant main window 3 Section 9.2: The Pageant main window=t00000113 3 Section 9.2.1: The key list box=pageant.keylist 3 Section 9.2.2: The ‘Add Key’ button=pageant.addkey 3 Section 9.2.3: The ‘Remove Key’ button=pageant.remkey 2 Section 9.3: The Pageant command line 3 Section 9.3: The Pageant command line=t00000114 3 Section 9.3.1: Making Pageant automatically load keys on startup=t00000115 3 Section 9.3.2: Making Pageant run another program=t00000116 1 Section 9.4: Using agent forwarding=t00000117 1 Section 9.5: Security considerations=t00000118 1 Appendix A: PuTTY FAQ 2 Appendix A: PuTTY FAQ=t00000119 2 Section A.1: Features supported in PuTTY 3 Section A.1: Features supported in PuTTY=t00000120 3 Question A.1.1: Does PuTTY support SSH v2?=t00000121 3 Question A.1.2: Does PuTTY support reading OpenSSH or ssh.com SSHv2 private key files?=t00000122 3 Question A.1.3: Does PuTTY support SSH v1?=t00000123 3 Question A.1.4: Does PuTTY support local echo?=t00000124 3 Question A.1.5: Does PuTTY support storing its settings in a disk file?=t00000125 3 Question A.1.6: Does PuTTY support full-screen mode, like a DOS box?=t00000126 3 Question A.1.7: Does PuTTY have the ability to remember my password so I don't have to type it every time?=t00000127 3 Question A.1.8: Is there an option to turn off the annoying host key prompts?=t00000128 3 Question A.1.9: Will you write an SSH server for the PuTTY suite, to go with the client?=t00000129 2 Section A.2: Ports to other operating systems 3 Section A.2: Ports to other operating systems=t00000130 3 Question A.2.1: Will there be a port to Windows CE?=t00000131 3 Question A.2.2: Is there a port to Windows 3.1?=t00000132 3 Question A.2.3: Will there be a port to the Mac?=t00000133 3 Question A.2.4: Will there be a port to Unix?=t00000134 3 Question A.2.5: Will there be a port to EPOC?=t00000135 2 Section A.3: Embedding PuTTY in other programs 3 Section A.3: Embedding PuTTY in other programs=t00000136 3 Question A.3.1: Is the SSH or Telnet code available as a DLL?=t00000137 3 Question A.3.2: Is the SSH or Telnet code available as a Visual Basic component?=t00000138 3 Question A.3.3: How can I use PuTTY to make an SSH connection from within another program?=t00000139 2 Section A.4: Details of PuTTY's operation 3 Section A.4: Details of PuTTY's operation=t00000140 3 Question A.4.1: What terminal type does PuTTY use?=t00000141 3 Question A.4.2: Where does PuTTY store its data?=t00000142 2 Section A.5: HOWTO questions 3 Section A.5: HOWTO questions=t00000143 3 Question A.5.1: How can I make PuTTY start up maximised?=t00000144 3 Question A.5.2: How can I create a Windows shortcut to start a particular saved session directly?=t00000145 3 Question A.5.3: How can I start an SSH session straight from the command line?=t00000146 3 Question A.5.4: How do I copy and paste between PuTTY and other Windows applications?=t00000147 3 Question A.5.5: How do I use X forwarding and port forwarding? I can't find the Tunnels panel.=t00000148 3 Question A.5.6: How do I use all PuTTY's features (public keys, port forwarding, SSH v2, etc.) in PSCP, PSFTP and Plink?=t00000149 3 Question A.5.7: How do I use PSCP.EXE? When I double-click it gives me a command prompt window which then closes instantly.=t00000150 3 Question A.5.8: How do I use PSCP to copy a file whose name has spaces in?=t00000151 2 Section A.6: Troubleshooting 3 Section A.6: Troubleshooting=t00000152 3 Question A.6.1: Why do I see ‘Incorrect MAC received on packet’?=t00000153 3 Question A.6.2: I clicked on a colour in the Colours panel, and the colour didn't change in my terminal.=t00000154 3 Question A.6.3: Plink on Windows 95 says it can't find WS2_32.DLL.=t00000155 3 Question A.6.4: My PuTTY sessions close after an hour and tell me ‘Server failed host key check’.=t00000156 3 Question A.6.5: After trying to establish an SSH 2 connection, PuTTY says ‘Out of memory’ and dies.=t00000157 3 Question A.6.6: When I run full-colour applications, I see areas of black space where colour ought to be.=t00000158 3 Question A.6.7: When I change some terminal settings, nothing happens.=t00000159 3 Question A.6.8: I can't type characters that require the AltGr key.=t00000160 3 Question A.6.9: My PuTTY sessions unexpectedly close after they are idle for a while.=t00000161 3 Question A.6.10: PuTTY's network connections time out too quickly when network connectivity is temporarily lost.=t00000162 3 Question A.6.11: When I cat a binary file, I get `PuTTYPuTTYPuTTY' on my command line.=t00000163 3 Question A.6.12: When I cat a binary file, my window title changes to a nonsense string.=t00000164 3 Question A.6.13: My keyboard stops working once PuTTY displays the password prompt.=t00000165 3 Question A.6.14: One or more function keys don't do what I expected in a server-side application.=t00000166 2 Section A.7: Security questions 3 Section A.7: Security questions=t00000167 3 Question A.7.1: Is it safe for me to download PuTTY and use it on a public PC?=t00000168 3 Question A.7.2: What does PuTTY leave on a system? How can I clean up after it?=t00000169 3 Question A.7.3: How come PuTTY now supports DSA, when the website used to say how insecure it was?=t00000170 2 Section A.8: Administrative questions 3 Section A.8: Administrative questions=t00000171 3 Question A.8.1: Would you like me to register you a nicer domain name?=t00000172 3 Question A.8.2: Would you like free web hosting for the PuTTY web site?=t00000173 3 Question A.8.3: Why don't you move PuTTY to SourceForge?=t00000174 3 Question A.8.4: Why can't I subscribe to the putty-bugs mailing list?=t00000175 3 Question A.8.5: If putty-bugs isn't a general-subscription mailing list, what is?=t00000176 3 Question A.8.6: How can I donate to PuTTY development?=t00000177 3 Question A.8.7: Where can I buy silly putty?=t00000178 3 Question A.8.8: How do I pronounce PuTTY?=t00000179 1 Appendix B: Feedback and bug reporting 2 Appendix B: Feedback and bug reporting=t00000180 2 Section B.1: General guidelines=t00000181 2 Section B.2: Reporting bugs=t00000182 2 Section B.3: Requesting extra features=t00000183 2 Section B.4: Requesting features that have already been requested=t00000184 2 Section B.5: Web server administration=t00000185 2 Section B.6: Asking permission for things=t00000186 2 Section B.7: Mirroring the PuTTY web site=t00000187 2 Section B.8: Praise and compliments=t00000188 2 Section B.9: E-mail address=t00000189 1 Appendix C: PuTTY Licence 2 Appendix C: PuTTY Licence=t00000190