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


SYNOPSIS

       /usr/sbin/go500gw [-a] [-d level] [-f filterfile] [-t tem­
       platefile]  [-c  rdncount]  [-h helpfile] [-l] [-p listen­
       port] [-P ldapport] [-x ldaphost] [-I]


DESCRIPTION

       go500gw is 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 both browsing and searching of X.500 via
       a  gopher client.  By default, it listens on port 7777 for
       connections from gopher clients.

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


STAND-ALONE OPERATION

       To  start go500gw as 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 to the /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 have go500gw started from inetd(8),theInter­
       netprotocol daemon, 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  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 go500gw.  With the standard unix gopher
       server, this can be done with  a  .link  file.   A  sample

       change given in <>'s:

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

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


OPTIONS

       -a     Search  aliases  when  doing  LDAP  searches.   The
              default is not to search aliases.

       -d level
              Turn on debugging as defined  by  level.   If  this
              option  is specified, go500gw will not fork or dis­
              associate 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
              go500gw.

       -h helpfile
              Specify an alternate help file.  The help  file  is
              what is displayed in the "About the Gopher to X.500
              Gateway" menu item.

       -l     Enable logging of various status and errors to  the
              LOG_DAEMON facility via syslog(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
              for use  with  the ldap_init_templates(3) facility,
              used by go500gw .

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


       -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 go500gw 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), ldap_getfilter(3), inetd(8), gopherd(8), go500(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