University of Cambridge Computing Service
				SSH CD

		version: 5

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 for Unix systems is OpenSSH 2.5.1p1
or later (newer releases were made during the creation of the CD)
Also included are programs for Win32 systems (PuTTY), MacOS
Nifty Telnet+ssh and MacOS SSH.

The main change in this CD is the switch to OpenSSH and the attempt to
support SSHV2 wherever possible.  There has also been an attempt to 
rationalise clients, so as not to have multiple versions depending on
which version of the OS you are running.

The CD has the following contents:

PREVIOUS	This is a directory containing the old versions of the
		CD.  If you have significant problems with the current
		version then try the ones in here, but PLEASE inform
		unix-support@ucs.cam.ac.uk of the details of your problems.
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.

OpenSSH_config	A configuration file for the Unix OpenSSH clients.

src		This directory contains the source code to the ssh clients
		where available

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.  It may not be allowed to use this software in
		the USA.  Consult a lawyer if in doubt.  There is also a 
                version of MacSSH which is an SSH V2 protocol, which you
                may need to connect to some sites.


freebsd hpux irix5 irix6 linux 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
		FreeBSD       Linux         README        config.guess  setup
		Irix          OSF1          Solaris2      known_hosts   src
		$ cd Solaris2
		$ ./ssh -l rjd4 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.
		...


	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:	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/Irix/ssh 
		and you wanted to connect to cus.cam.ac.uk then you
		would add the hostname after the command to give
			/CDROM/Irix/ssh 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:
                For historical and technical reasons sufficiently old
                versions of Linux may not run the standard version of ssh
                provided.  In this case use the one in the Older_Linuxes
                subdirectory of the Linux directory.

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 5a, 2002-07-10