MAN page from Mandrake Other ldap-servers-3.3-3.i386.rpm

GO500GW

Section: Maintenance Commands (8C)
Updated: 27 November 1994
Index

NAME

go500gw - General Gopher to X.500 gateway for browsing and searching

SYNOPSIS

/usr/sbin/go500gw [-a] [-d level] [-f filterfile][-t templatefile] [-c rdncount][-h helpfile] [-l] [-p listenport][-P ldapport] [-x ldaphost] [-I]

DESCRIPTION

go500gwis the general gopher to X.500 browsing and search gateway daemon.It speaks gopher on one side and X.500 (via LDAP)on the other. It presents the X.500 DIT as a tree of menus,search items, and documents in gopher space, supporting bothbrowsing and searching of X.500 via a gopher client. By default,it listens on port 7777 for connections from gopher clients.

Thego500gwserver can be run either frominetd(8)or as stand-alone server.

STAND-ALONE OPERATION

To startgo500gwas a stand-alone server, simply start it with no arguments

        /usr/sbin/go500gw

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

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

OPERATION WITH INETD

To arrange to havego500gwstarted frominetd(8),theInternetprotocoldaemon, add a line like the following to your/etc/services(5)file, or the equivalent:

    go500gw           7777/tcp        go500gw

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

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

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

GOPHER CONFIGURATION

The next step is to configure your local gopher server to have anentry forgo500gw.With the standard unix gopher server, thiscan be done with a.linkfile. A sample.linkfile is given below, with the things you should change given in <>'s:

        Name=<Label of your choice>        Type=1        Port=7777        Path=1<optional RFC 1779-format DN at which to start browsing>        Host=<host.running.go500gw.here>

You may also have to restart your gopher daemon, or remove the.cachefile.

OPTIONS

-a: Search aliases when doing LDAP searches. The default is not tosearch aliases.
-d level: Turn on debugging as defined bylevel.If this option is specified,go500gwwill not fork or disassociate from the invoking terminal. Some generaloperation and status messages are printed for any value of level.level is taken as a bit string, with each bit corresponding to adifferent kind of debugging information.
-f filterfile: Specify an alternate filter configuration file for use with theldap_getfilter(3)facility, used bygo500gw.
-h helpfile: Specify an alternate help file. The help file is what is displayedin the "About the Gopher to X.500 Gateway" menu item.
-l: Enable logging of various status and errors to the LOG_LOCAL3 facility viasyslog(8).
-p listenport: Specify an alternate port on which to listen for connections.
-P ldapport: Specify an alternate port on which to contact the LDAP server.
-t templatefile: Specify an alternate template configuration file foruse with theldap_init_templates(3)facility, used bygo500gw .
-c rdncount: Specify the number of DN components to show for the names and DN attributeswithin entries matching the search.
-x hostname: Specify an alternate host on which the ldap server is running.
-I: Run frominetd(8).

NOTES

Some implementations of inetd have a small limit on the number of argumentsthat can be specified in the/etc/inetd.conf(5)file. This can causeproblems if you are usinggo500gwwith a lot of arguments.

The default values for most of the things you can specify withoptions are configured at compile time in theinclude/ldapconfig.h.editinclude file.

This document was created byman2html,using the manual pages.