University of Cambridge Computing Service SSH CD version: 4 This CD contains a number of implementations of "ssh", a tool for connecting to a remote service over a cryptographically secured channel. It is designed as a drop-in replacement for "rlogin", "rsh" and "rcp". It can also function as a replacement for telnet. The version of ssh provided is 1.2.27. It also contains programs for Win32 systems and Macintoshes. The Win32 program is called "PuTTY" and is version 0.48. The MacOS program is an ssh-enabled version of NiftyTelnet, version 1.1-r3. The CD has the following contents: README This file. README.TXT A copy of this file with line termination geared up for Windows systems. README.MAC A copy of this file with line termination geared up for Macintoshes. LEGAL A legal notice about the use of this CD. LEGAL.TXT A copy of this file with line termination geared up for Windows systems. LEGAL.MAC A copy of this file with line termination geared up for Macintoshes. known_hosts This is list of the "public keys" of various Cambridge machines. They are chosen to be the ones that users are most likely to want to connect to from outside Cambridge. It is not necessary to use this file, but if you do not then ssh will post a warning when you connect to a system for the first time. (It will post the warning anyway if the system you are connecting to is not in the known_hosts file.) On a Unix system run the "known_hosts_setup" script in this directory to set up your account to use this known_hosts file if you have never used ssh before. If you have used ssh before, but want to use this set of known hosts then you should concatenate the CD's known_hosts file to the end of your .ssh/known_hosts file. known_hosts.txt A copy of this file with line termination geared up for Windows systems. known_hosts.mac A copy of this file with line termination geared up for Macintoshes. src This directory contains the source code to the Unix version of ssh used on this CD and for PuTTY. win32 This is the directory containing an application called "PuTTY" which is an Intel WindowsNT 4 (and Windows9x port) of ssh. See http://www.chiark.greenend.org.uk/~sgtatham/putty.html for details on PuTTY. Note that PuTTY defaults to running an unencrypted telnet program. You need to explicitly select ssh to run encrypted. alphaNT This has the corresponding version of PuTTY for Alpha NT 4. MacOS This contains version 3 of the SSH-enhanced NiftyTelnet program. This software may not be used in the USA. freebsd3 hpux9 irix5 irix6 linux_libc5 linux_libc6 osf1 solaris2 sunos4 These are the directories containing ssh for the various Unix operating systems. Within each there will be "ssh" and "scp" programs. There is also a "docs" subdirectory containing information about the platform and software used to build the version of ssh amd a "man1" subdirectory containing the manual pages for ssh and scp. So, to run the ssh program on a Solaris 2 system, for example: (You just type what comes after the $ prompts.) $ ls FreeBSD3 Linux_libc6 README config.guess setup Irix6 OSF1 Solaris2 known_hosts src $ cd Solaris2 $ ./ssh ursa.cus.cam.ac.uk rjd4@ursa.cus.cam.ac.uk's password: Last login: Fri Apr 23 16:37:48 1999 from cyclops.csi.cam. No mail. Solaris 2.6 [ursa,taurus] (CUS) ... And to read the man page $ man -M docs ssh Note for users of the Common Desktop Environment (CDE): Some CDE systems (e.g. Solaris 2) are configured to automatically mount CDs inserted in the drive and to pop up a file manager for them. This file manager will show the contents of the CD. Double click on the relevant operating system folder to open it. This will show the ssh and scp icons. Double clicking on ssh will pop up a window asking you to give a line of "options" and a line of "arguments". Strictly speaking, if you wanted to login to a system as a different user then the "-l remote_user" part of the command line is an "option" and the hostname is an argument. If you just complete the command line on the "arguments" line then it still works. So, if your local userid (on the machine you are running the CD on) was "bob" and you wanted to log in to ursa.cus.cam.ac.uk where your userid was "rjd4" then it would prompt you for Options: Arguments: and you would fill it in with Options: -l rjd4 Arguments: ursa.cus.cam.ac.uk If your userid was the same at both ends then you could leave the options section blank. There is no obligation to use the window manager to run this program; it can still be run from the command line. Note for users of Irix5 and Irix6: If you are using the Irix window manager then when you insert the CD the CDROM icon should change to indicate the presence of a CD in the drive. Double clicking on this will present you with a file manager showing all the operating system folders. Double clicking on the relevant Irix folder will give a file manager showing the ssh and scp programs as icons. Double clicking on ssh will pop up a window asking you to complete the ssh command line. Simply type in the name of the host you want to connect to after the command name and click the "OK" button. An xterm will then be popped up and ssh will run in that. So, if it filled in /CDROM/Irix6/ssh and you wanted to connect to ursa.cus.cam.ac.uk then you would add the hostname after the command to give /CDROM/Irix6/ssh ursa.cus.cam.ac.uk and then click "OK". There is no obligation to use the window manager to run this program; it can still be run from the command line. Note for users of Linux: Linux comes with two possible versions of the C library. If your system has version 6, used the programs in Linux_libc6. Otherwise, use the programs in Linux_libc5. To see which version you have run the following command: (You just type what comes after the $ prompts.) $ ls /lib/libc.* /lib/libc.so.6 So, in this example the version 6 libc is installed. If it had said /lib/libc.so.5 then we would have use the version 5 program. If you have both then use the Linux_libc6 version. Contact info: This CD was produced by the Unix Support group of the University of Cambridge Computing Service. E-mail: unix-support@ucs.cam.ac.uk Snail-mail: Unix Support University Computing Service New Museum Site Pembroke Street Cambridge CB2 3QG United Kingdom Telephone: (Please don't. Our telephone manner is cool at best, hostile at worst.) +44 1223 334728 Fax: +44 1223 334679 Revision information: Beta 3, 1999-06-04