go500 - Local Gopher index search to X.500 search gateway
SYNOPSIS
/usr/sbin/go500 [-b searchbase] [-d level] [-l] [-x host
name] [-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 Inter
net 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:
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 disas
sociate 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 corresponding 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).
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 Pro
ject (http://www.openldap.org/). OpenLDAP is derived from
University of Michigan LDAP 3.3 Release.
Man(1) output converted with
man2html