1 .TH GO500GW 8C "20 August 2000" "OpenLDAP LDVERSION"
3 .\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved.
4 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 go500gw \- General Gopher to X.500 gateway for browsing and searching
8 .B LIBEXECDIR/go500gw [\-a] [\-d level] [\-f filterfile]
9 .B [\-t templatefile] [\-c rdncount]
10 .B [\-h helpfile] [\-l] [\-p listenport]
11 .B [\-P ldapport] [\-x ldaphost] [\-I]
14 is the general gopher to X.500 browsing and search gateway daemon.
15 It speaks gopher on one side and X.500 (via LDAP)
16 on the other. It presents the X.500 DIT as a tree of menus,
17 search items, and documents in gopher space, supporting both
18 browsing and searching of X.500 via a gopher client. By default,
19 it listens on port 7777 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/go500gw ]; then
45 LIBEXECDIR/go500gw; echo ' go500gw'
49 .SH OPERATION WITH INETD
53 .BR inetd (8), the Internet protocol
54 daemon, add a line like the following to your
56 file, or the equivalent:
60 go500gw 7777/tcp go500gw
64 Next, add a line like this to your
65 .BR /etc/inetd.conf (5)
66 file, or the equivalent:
70 go500gw stream tcp nowait nobody LIBEXECDIR/go500gw go500gw -I
74 For these changes to take effect with inetd, you will probably have
75 to send it it a HUP signal. See
78 .SH GOPHER CONFIGURATION
79 The next step is to configure your local gopher server to have an
82 With the standard unix gopher server, this
87 file is given below, with the things you should change given in <>'s:
91 Name=<Label of your choice>
94 Path=1<optional RFC 2253-format DN at which to start browsing>
95 Host=<host.running.go500gw.here>
99 You may also have to restart your gopher daemon, or remove the
105 Search aliases when doing LDAP searches. The default is not to
109 Turn on debugging as defined by
111 If this option is specified,
113 will not fork or disassociate from the invoking terminal. Some general
114 operation and status messages are printed for any value of \fIlevel\fP.
115 \fIlevel\fP is taken as a bit string, with each bit corresponding to a
116 different kind of debugging information.
118 .BI \-f " filterfile"
119 Specify an alternate filter configuration file for use with the
120 .BR ldap_getfilter (3)
125 Specify an alternate help file. The help file is what is displayed
126 in the "About the Gopher to X.500 Gateway" menu item.
129 Enable logging of various status and errors to the LOG_LOCAL3 facility via
132 .BI \-p " listenport"
133 Specify an alternate port on which to listen for connections.
136 Specify an alternate port on which to contact the LDAP server.
138 .BI \-t " templatefile"
139 Specify an alternate template configuration file for
141 .BI ldap_init_templates (3)
146 Specify the number of DN components to show for the names and DN attributes
147 within entries matching the search.
150 Specify an alternate host on which the ldap server is running.
156 Some implementations of inetd have a small limit on the number of arguments
157 that can be specified in the
158 .BR /etc/inetd.conf (5)
160 problems if you are using
162 with a lot of arguments.
164 The default values for most of the things you can specify with
165 options are configured at compile time in the
166 .B include/ldapconfig.h.edit
170 .BR ldap_getfilter (3),
176 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
178 is derived from University of Michigan LDAP 3.3 Release.