VI.f Setting up links for the anonymous ftp gateway
---------------------------------------------------
The anonoymous ftp gateway allows the client to access the directories and
files of an anonymous FTP host via the gopher menu system.  The "ftplink" 
pseudo-search function can be used as a general service for creating links to 
aFTP hosts' top directories and returning them as menu items to the client. 
To  install this service on your gopher server, put the following tuple in a
.links  file:

	Name=Query a specific anonymous FTP host
	Type=7
	Port=+
	Path=7$ftplink
	Host=+

If the client shoots at the item corresponding to this tuple and enters an
anonymous FTP host's Internet address as the search term (e.g.,
Niord.SHSU.edu), the gopher server will return a tuple with the following
format:

	Name=Link to aFTP host Niord.SHSU.edu
	Type=1
	Port=<your server's port>
	Path=ftp:Niord.SHSU.edu@/
	Host=<your server's address> 

The client can then shoot at the item corresponding to this tuple, and your
server will respond by using its gateway to obtain a listing of the anonymous 
FTP server's top directory, construct a series of tuples for accessing its
files and subdirectories, and return that to the client as a menu.  The
extensions of files are used to determine the gopher object types (e.g., 0, 4,
9, I, s). Directory objects are, of course, assigned Type=1.

If you wish to create a directory of specific links to anonymous FTP hosts, 
the Path specification for gateway tuples has the following format:
	
	Path=ftp:site@path

where 'site' is the anonymous FTP host's Internet address, and 'path' is that 
to the directory or file, converted to Unix format for OpenVMS hosts.  The
single character path '/' is used for the host's default anonymous login
directory. For OpenVMS anonymous FTP hosts, a device can be included in the
path, but must be  followed by a directory specification, e.g.:

	Path=ftp:dmc.com@uucp_public:/000000/

This feature was added to the OpenVMSGopherServer for hosts which specify
their anonymous account trees via search list logicals.

If an error or access violation is reported by the anonymous FTP server, this
is returned to the client as a menu item whose name is the FTP error code
number followed by the text of the error or access violation message.  If a
network connection error, unrecoverable transmission error, or internal gopher
server error occurs, the item name will be 'Server error:' follow by a
description of its nature.  In both cases, the tuple for that item will be
your Server Error file (containing the information for reporting the error to
the gopher server administrator), _server_error.range.

.