[comp.binaries.ibm.pc] v03INF2: ftp.man, Beginner's Guide to FTP

boneill@hawk.ulowell.edu (Brian O'Neill) (05/26/89)

Checksum: 3450706750  (Verify with "brik -cv")
Posting-number: Volume 03, Issue INF2
Submitted-by: boneill@hawk.ulowell.edu (Brian O'Neill)
Archive-name: v03info/ftp.man

[Date of Last Change: 3/26/89 Release 1.2]

[This file is available via FTP from swan.ulowell.edu (129.62.224.1), file
ibmpc/General/ftp.man -B]

			GETTING BINARIES VIA FTP

Entire contents Copyright (c) 1989 by Brian O'Neill.  This manual was
created to aid people in the usage of binary postings on UseNet.
Permission to copy this file is granted, so long as credit is given to
those who helped.  A list of those people appear at the end of this
posting.

    FTP stands for File Transfer Protocol.  It allows a person to transfer
files between two systems, generally connect over Ethernet networks or
long-haul networks, such as the Internet.

    If your hosts system has FTP and is connected to the Internet, you
can access very large amounts of archives available on a number of
systems, such as Simtel20 or uunet.uu.net.  This is a simplified use
manual, and will use two examples, one a TOPS-20 system
(wsmr-simtel20.army.mil), and one Unix system (swan.ulowell.edu, my
local system).

    The simplest way to initiate FTP would be to give the command 'ftp
<system-name>', where <system-name> is the remote system you are
connecting to, either a name (wsmr-simtel20.army.mil, if you have an
entry in /etc/hosts or are accessing a Domain-name Server) or the InterNet
address (26.2.0.74, for Simtel20).  After a short wait, you will be prompted 
for your username.  If you do not have an account on the remote system, some
systems allow you to use 'anonymous'.  This gives you a restricted
access path.

    You would then be prompted for a password.  Some systems will tell
you to send your real identity as the password.  What you type doesn't
matter, but it is suggested to give your mail address.  Other systems
need a password of 'guest', or something similar.

    After that, you should receive the FTP prompt (usually ftp>), and
now have access.  You can get a directory of files be giving a 'dir'
command, or if the remote system is Unix-based, 'ls -l' will give the
familiar output.  On Simtel20, there is a file available in the
default anonymous ftp directory that explains what Simtel20 is, and
where files are located.  The name is 'SIMTEL-ARCHIVES.INFO.nn, where
".nn" is a file generation number.  You don't need to specify the file
generation number when requesting the file.  In fact, it's better not
to because you will always get the latest generation that way.

    Unix systems will all have the familiar directory structure, and
moving around is done with the familiar 'cd' or 'cwd' command.
TOPS-20 systems have a different structure, but movement is still
accomplished with the 'cd' command.

    I will use Simtel20 as the first example. To start, give the
command 'ftp wsmr-simtel20.army.mil' from your shell prompt, or 'open
wsmr-simtel20.army,mil' from the 'ftp>' prompt.  If this host is not
in your /etc/hosts file or you do not have access to a Domain-name Server,
use '26.2.0.74' in it's place.  After a few seconds, you'll be prompted 
for your username.  Type 'anonymous', and when prompted for password, 
give your e-mail address (more as a courtesy than anything else), or if 
you prefer, 'guest'.  You should then shortly get back the 'ftp>' prompt.  
If you receive an error message stating that there are too many anonymous 
logins, wait a few minutes and try again. Simtel20 has limited access,
especially during normal business hours.

    Now, say you want to see what is stored for MS-DOS programs.
Simtel20 is a DEC System-20 running the TOPS-20 operating system.  The
directory structure is 'DISK:<DIRECTORY.SUBDIRECTORY>'.  For MS-DOS
programs, the main directory is 'PD1:<MSDOS>'.  In here there is a
file called 'MSDOS.CRCLST', which is updated almost daily.  It
contains a list of all files within the MS-DOS subdirectories, along
with file size and CRC value.

    To get this list, first switch to that directory by saying 'cd
pd1:<msdos>' (TOPS-20 is not case sensitive).  If you are prompted for
another password just ignore the request.  When you get the 'ftp>'
prompt back, you can then say 'get msdos.crclst'.  This will initiate
the transfer, and after a few minutes it will be completed.  The
beauty of Unix is that while you are transfering something big, you
can put it in the background and do something else.

    Say you wanted to get ProComm Plus. According to the list, it is
in PD1:<MSDOS.PROCOMM>.  So, you can enter 'cd pd1:<msdos.procomm>'.
A 'dir' will show all the files in that directory.  (You may wish not
to use too many 'dir' commands, as they are sometimes fairly slow).

    Now, you want the file 'pcplustd.arc'.  First, you must tell your
host what kind of file it is.  On most Unix systems, 'binary' or 'set
type binary' or 'set type I' will work.  However, as Simtel20 runs a
different OS that has different word sizes (36 bits) you must specify
'tenex' or 'type L 8' to transfer properly.  You can then issue a 'get
pcplustd.arc' command, and after a short while, you have ProComm Plus.
To end your session, enter the 'bye' command.

    Unix is a little more familiar for most people with Internet access. 
For example, you might wish to get the latest version DSZ from 
swan.ulowell.edu.  First, you give the 'ftp swan.ulowell.edu' command (or 
ftp 129.63.224.1), giving 'anonymous' for the username, and your address 
as the password.  You can then use the 'dir' or 'ls -l' commands to scan 
the directories.  After logging in, you'll notice a directory called 
'ibmpc'.  You can use 'cd ibmpc', and you're inside.

    The ibmpc directory is subdivided into different subdirectories,
such as Comm, SysUtil, and Programming.  DSZ is a communications
program, so you can then 'cd Comm'.  Once again, there are several
subdirectories, giving the names of several communications programs,
and one marked 'Protocols'. Inside that directory is where DSZ is
located.  There you'll find the latest version of DSZ (dsz0319.arc at
this time).  Since it is a binary file, you must give the command
'binary' or 'set file type binary' to let FTP know.  Then you can
issue the 'get' command.

    Different systems have different organizations for their files,
and the above example is just the way I have it set up.  By 'poking'
around other systems, you can learn how their files are set up, and
zip around much faster.  Note, however, that FTP will not allow you
outside the FTP 'root' directory, usually ~ftp on most systems.  So,
poking about the entire system is not permitted.

    Other features of FTP can be found in the manual - please check there.

    Messages regarding problems, complaints or suggestions for
Simtel20 should be addressed to 'action@wsmr-simtel20.army.mil'.

		THANKS TO ALL THOSE WHO HELPED...

I'd like to thank all those who helped in the creation of the manuals,
and were patient enough for it to be released:

		Craig Browning
		William Davidsen
		Mike Driscoll
		Bill Fenner
		John Foulkes
		Steven Harding
		Mac Michaels
		Derek Nazareth
		Russ Nelson
		Kevin Reilly
		Keith Petersen