1 .TH GO500 8C "22 September 1998" "OpenLDAP LDVERSION"
3 .\" Copyright 1998-1999 The OpenLDAP Foundation All Rights Reserved.
4 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 go500 \- Local Gopher index search to X.500 search gateway
8 .B LIBEXECDIR/go500 [\-b searchbase] [\-d level] [\-l]
9 .B [\-x hostname] [\-c rdncount] [\-f filterfile]
14 is the local gopher index search to X.500 search daemon.
15 It looks like a gopher index server to a gopher
16 client, translating the search criteria it is given into a
17 search of a pre-configured portion of the X.500 directory.
18 It uses LDAP to talk to X.500. By default, it listens on
19 port 5555 for connections from gopher clients.
23 server can be run either from
25 or as stand-alone server.
26 .SH STAND-ALONE OPERATION
29 as a stand-alone server, simply start it with no arguments
37 If you would like to start it at boot time add some lines like this to
44 if [ -f LIBEXECDIR/go500 ]; then
45 LIBEXECDIR/go500; echo ' go500'
49 .SH OPERATION WITH INETD
55 daemon, add a line like the following to your
57 file, or the equivalent:
65 Next, add a line like this to your
67 file, or the equivalent:
71 go500 stream tcp nowait nobody LIBEXECDIR/go500 go500 -I
75 For these changes to take effect with inetd, you will probably have
76 to send it it a HUP signal. See
79 .SH GOPHER CONFIGURATION
80 The next step is to configure your local gopher server to have an
83 With the standard unix gopher server, this
89 file is given below, with the things you should
94 Name=<Label of your choice>
98 Host=<host.running.go500.here>
102 You may also have to restart your gopher daemon, or remove the
110 .BI \-b " searchbase"
111 Specify an alternate starting point for searches. The argument should
112 be a Distinguished Name in the form defined by RFC 1485. For example,
113 the DN "o=University of Michigan, c=US" could be given to search the
114 University of Michigan portion of the X.500 tree.
117 Turn on debugging as defined by
119 If this option is specified,
121 will not fork or disassociate from the invoking terminal. Some general
122 operation and status messages are printed for any value of \fIlevel\fP.
123 \fIlevel\fP is taken as a bit string, with each bit corresponding to a
124 different kind of debugging information.
126 .BI \-f " filterfile"
127 Specify an alternate filter configuration file for use with the
128 .BR ldap_getfilter (3)
133 Enable logging of various status and errors to the LOG_LOCAL3 facility via
137 Specify an alternate port on which to listen for connections.
139 .BI \-t " templatefile"
140 Specify an alternate template configuration file for
142 .BR ldap_init_templates (3)
147 Specify the number of DN components to show for the names and DN attributes
148 within entries matching the search.
151 Specify an alternate host on which the ldap server is running.
157 Some implementations of inetd have a small limit on the number of arguments
158 that can be specified in the
159 .BR /etc/inetd.conf (5)
161 problems if you are using
163 with a lot of arguments.
165 The default values for most of the things you can specify with
166 options are configured at compile time in the
167 .B include/ldapconfig.h.edit
176 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
178 is derived from University of Michigan LDAP 3.3 Release.