GO500(8C)																 GO500(8C)

NAME

       go500 - Local Gopher index search to X.500 search gateway

SYNOPSIS

       /usr/sbin/go500 [-b searchbase] [-d level] [-l] [-x hostname] [-c rdncount] [-f filterfile] [-t templatefile] [-p port] [-I]

DESCRIPTION

       go500  is  the  local  gopher index search to X.500 search daemon.  It looks like a gopher index server to a gopher client, translating the
       search criteria it is given into a search of a pre-configured portion of the X.500 directory.  It uses LDAP to talk to X.500.  By  default,
       it listens on port 5555 for connections from gopher clients.

       The go500 server can be run either from inetd(8) or as stand-alone server.

STAND-ALONE OPERATION
       To start go500 as a stand-alone server, simply start it with no arguments

	    /usr/sbin/go500

       If you would like to start it at boot time add some lines like this to the etc/rc.local or equivalent file:

	    if [ -f /usr/sbin/go500 ]; then
		 /usr/sbin/go500; echo ' go500'
	    fi

OPERATION WITH INETD

       To  arrange to have go500 started from inetd(8), the Internet protocol daemon, add a line like the following to your /etc/services file, or
       the equivalent:

	   go500	   5555/tcp	   go500

       Next, add a line like this to your /etc/inetd.conf file, or the equivalent:

	   go500   stream  tcp	   nowait  nobody  /usr/sbin/go500    go500 -I

       For these changes to take effect with inetd, you will probably have to send it it a HUP signal.	See inetd(8) for more details.

GOPHER CONFIGURATION

       The next step is to configure your local gopher server to have an entry for go500.  With the standard unix gopher server, this can be  done
       with a .link file.  A sample .link file is given below, with the things you should change given in <>'s:

	    Name=<Label of your choice>
	    Type=7
	    Port=5555
	    Path=
	    Host=<host.running.go500.here>

       You may also have to restart your gopher daemon, or remove the .cache file.  See gopherd(8) for more details.

OPTIONS

       -b searchbase
	      Specify an alternate starting point for searches.  The argument should be a Distinguished Name in the form defined by RFC 1485.  For
	      example, the DN "o=University of Michigan, c=US" could be given to search the University of Michigan portion of the X.500 tree.

       -d level
	      Turn on debugging as defined by level.  If this option is specified, go500 will not fork or disassociate from the invoking terminal.
	      Some general operation and status messages are printed for any value of level.  level is taken as a bit string, with each bit corre-
	      sponding to a different kind of debugging information.

       -f filterfile
	      Specify an alternate filter configuration file for use with the ldap_getfilter(3) facility, used by go500.

       -l     Enable logging of various status and errors to the LOG_DAEMON facility via syslog(8).

       -p port
	      Specify an alternate port on which to listen for connections.

       -t templatefile
	      Specify an alternate template  configuration  file  for use  with  the ldap_init_templates(3) facility, used by go500.

       -c rdncount
	      Specify the number of DN components to show for the names and DN attributes within entries matching the search.

       -x hostname
	      Specify an alternate host on which the ldap server is running.

       -I     Run from inetd(8).

NOTES

       Some implementations of inetd have a small limit on the number of arguments that can be specified in the /etc/inetd.conf(5) file.  This can
       cause problems if you are using go500 with a lot of arguments.

       The  default  values  for  most	of the things you can specify with options are configured at compile time in the include/ldapconfig.h.edit
       include file.

SEE ALSO

       ldap(3), inetd(8), gopherd(8), go500gw(8)

ACKNOWLEDGEMENTS

       OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).  OpenLDAP is derived from University  of  Michigan
       LDAP 3.3 Release.

OpenLDAP 2.0.27-Release 					  20 August 2000							 GO500(8C)