home *** CD-ROM | disk | FTP | other *** search
/ ftp.muug.mb.ca / 2014.06.ftp.muug.mb.ca.tar / ftp.muug.mb.ca / pub / src / gopher / gopher1.01 / misc / waisgopher / README < prev    next >
Text File  |  1992-06-10  |  3KB  |  112 lines
  1.            Waisgopher  -- A WAIS to Gopher gateway.
  2.          Paul Lindner <lindner@boombox.micro.umn.edu>
  3.                    
  4.                  March 1992.
  5.  
  6. Note:  The waisgopher functionality has been folded into the gopherd
  7. server as of version 1.0.  You really don't need this beast, just plop
  8. .src files into your servers gopher data directory.
  9.  
  10.  
  11. Intro
  12. -----
  13.  
  14. Hey, gopher isn't the only cool network text distribution thing in the
  15. world.  Lots of information is contained in databases only searchable
  16. by WAIS software.  The waisgopher gateway allows you to add a WAIS
  17. database into Gopherspace.
  18.  
  19. It's not quite the prettiest code out there.  But it's much faster
  20. than the little hack that straps gopher to a WWW in Switzerland and
  21. then to WAIS.
  22.  
  23. So here it is.  I'll be working on it and making improvements given
  24. time. 
  25.  
  26.  
  27. Compilation.
  28. ------------
  29.  
  30. You should have recieved three files in your distribution
  31.  
  32. waisgopher.README   --  What you're reading now
  33. Makefile.gopher     --  A special makefile for waisgopher (do *not*
  34.                         rename this file as "Makefile"!) 
  35. waisgopher.c        --  The actual code
  36.  
  37. Copy waisgopher.c and Makefile.gopher into the "ui" directory of your
  38. wais-8-b4 distribution i.e.
  39.  
  40.   % cp waisgopher.c Makefile.gopher $(WAISdir)/ui
  41.  
  42. Now cd into the directory you just copied the files into. i.e.
  43.  
  44.   % cd $(WAISdir)/ui
  45.  
  46. And type the following:
  47.  
  48.   % make waisgopher -f Makefile.gopher
  49.  
  50. This will create the executable "waisgopher" in the WAIS bin
  51. directory.
  52.  
  53. Note:  If you're using the wais-8-b3.1 or wais-8-b3-ses distributions
  54. comment out the function "PrintStatus()" in the waisgopher.c file.
  55.  
  56. Usage
  57. -----
  58.  
  59. waisgopher -h <hostname> [-p <port num>]
  60.  
  61.   -h   specifies the host that's running the gateway.
  62.  
  63.   -p   specifies the port that this thing is running on.  You usually
  64.        won't need this.  The gateway tries to find out what port it's
  65.        on.
  66.  
  67.  
  68. Getting the darn thing running
  69. ------------------------------
  70.  
  71. The waisgopher gateway is typically run from inetd, although it can
  72. also be run from the command line (which isn't of much use as a
  73. gateway really...)  Here's how I set my up on a sun running SunOS
  74. 4.1.1.  (your system will probably differ though...)
  75.  
  76. Let's suppose that we're going to add the lyrics wais database into
  77. gopher.  The first thing we need is the ".src" file for the database
  78. we're interested in.
  79.  
  80. Once we have that we set up the system files to run the gateway
  81. automatically.
  82.  
  83. Add an entry to /etc/services:
  84.  
  85.    waisgopher  4171/tcp
  86.  
  87. % cd /var/yp; make    # Update the YP databases
  88.  
  89. Add a nice long line to /etc/inetd.conf
  90.  
  91. waisgopher    stream tcp nowait lindner /home/mudhoney/lindner/src/wais-8-b4/bin/waisgopher waisgopher -h mudhoney.micro.umn.edu
  92.  
  93. Okay, now as root do a:
  94.  
  95.   # kill -HUP {pid of inetd}
  96.  
  97. Now add a link in your GopherSpace:
  98.  
  99.   Type=7
  100.   Name=Lyrics Thing
  101.   Path=/home/mudhoney/lindner/wais-sources/lyrics.src
  102.   Host=mudhoney.micro.umn.edu
  103.   Port=4171
  104.  
  105. Zim alla bing, it's done!  Hooray!
  106.  
  107. You can then continue to add other wais databases just by changing the path
  108. variable on the links you make.  This requires that you have a client
  109. that can understand newer links, such as the UNIX client distributed
  110. with this package or any version after March 1992.
  111.  
  112.