home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume26 / uuhost-2.1 / README < prev    next >
Encoding:
Text File  |  1992-04-18  |  3.5 KB  |  124 lines
  1. UUHOST 2.1
  2. ==========
  3.     
  4.     This is uuhost 2.1
  5.  
  6.     It is a new [and as far as I'm concerned, better :-] program.
  7.     It needs not run as root, the databases are smaller (text only),
  8.     and does more for me than all others have done so far :-)
  9.  
  10.     Uuhost reads the UUCP maps which live in a directory, and builds a
  11.     smallish database, containing just enough data to read the UUCP and
  12.     USENET information from the maps.
  13.     
  14.     - Edit the Makefile. Set the variables described at the top of the
  15.       Makefile to desired values.
  16.  
  17.     - Do a `make'. This should produce 
  18.         uusplit        executable
  19.         uulookup    executable
  20.         uuhost        shell-script
  21.         uuhost.1    manual page
  22.  
  23.     - Do a "make install"
  24.       This will copy  the uuhost program to your LOCALBIN directory, 
  25.       uusplit to your BINDIR directory, and uulookup to your
  26.       LOOKUPBINDIR directory. Note: Neither BINDIR nor LOOKUPBINDIR
  27.       need not be in the user's path.
  28.       Please install the manual page `uuhost.1' manually.
  29.  
  30.     - Run "uuhost -l"   It should show you a list of contents of your
  31.       maps directory.
  32.  
  33.     - Try "uuhost -r u.usa.ca.1" or similar. That should work too.
  34.  
  35.     - Now run "uuhost -index" This will take a while. The index is
  36.       being built. (should not take much longer than five minutes)
  37.  
  38.     - Try "uuhost hostname" where hostname is a host that you know 
  39.       about.
  40.  
  41.     - Set up "uuhost -index" so that it runs once a day. This can be
  42.       done via crontab:
  43.  
  44.         00  07  *  *  *  uuhost -index
  45.  
  46.  
  47.     - Congratulations. Finished.
  48.  
  49.     - If you have problems, bugs or suggestions,  please contact me. 
  50.         My name is  Jan-Piet Mens, and my address is
  51.         <jpm@Logix.DE>
  52.         
  53. INTERNALS
  54. =========
  55.  
  56. uuhost -index
  57. =============
  58.  
  59. This program reads all files in the MAPSDIR directory.
  60. Here is the map entry from the file `u.deu.2' (line 1451) for my site:
  61.  
  62.     #N    logixwi, logix.de, .logix.de
  63.     #S    Tandon 486/25;SCO UNIX 3.2.2
  64.     #O    Logix GmbH
  65.     #C    Jan-Piet Mens
  66.     #E    postmaster@logixwi.logix.de
  67.     #T    +49 611 309797
  68.     #P    Moritzstrasse 50, D-W-6200 Wiesbaden, Germany
  69.     #L
  70.     #W    cs@Germany.EU.net; 910228 / bs@Germany.EU.net ; 911016
  71.     #U    unido
  72.     #
  73.     logixwi    unido(HOURLY)
  74.     logixwi    .logix.de
  75.  
  76. The `#N' entry contains three names (I call them hostnames, although that
  77. is not quite correct :-) 
  78. The `uusplit' program gets the `#N' line passed to it, prepended by  a 
  79. line number (produced by grep). It will split that line into individual
  80. hostnames, producing:
  81.  
  82.     logixwi    u.deu.2    1451
  83.     logix.de    u.deu.2    1451
  84.     .logix.de    u.deu.2    1451
  85.  
  86. These lines are put into the UUHOSTINDEX database. `uuhost -index' does
  87. this for each `#N' in all files in the MAPSDIR directory. The database is
  88. then sorted by the first field.
  89.  
  90. When `uuhost' looks for a hostname, it parses (with help of `uulookup') the
  91. database, finds (or doesn't) the desired entry, and Charly 's your uncle.
  92.  
  93. Problems, Praise & Bugs
  94. =======================
  95.     Please direct these to  Jan-Piet Mens <jpm@Logix.DE>
  96.  
  97. Thanks! to ...
  98. ==============
  99.  
  100. Mon Oct 21 20:38:26 MET 1991
  101.     From: btr.com!thad (Thaddeus P. Floryan)
  102.     Message-Id: <9110211245.AA09299@public.BTR.COM>
  103.  
  104.     One comment: on my systems (3B1, CT MightyFrame, etc.) the 
  105.     "uuhost -index" would abort due to "Cannot fork: too many processes."
  106.  
  107.     Finally discovered the problem to be ksh.  By using /bin/sh it 
  108.     worked fine per:
  109.  
  110.         $ sh uuhost -index
  111.  
  112.     Thanks for the great program!
  113.  
  114.     Thad Floryan [ thad@btr.com (OR) {decwrl, mips, fernwood}!btr!thad ]
  115.  
  116. Tue Oct 22 18:28:27 MET 1991
  117.     Thad Floryan [ thad@btr.com (OR) {decwrl, mips, fernwood}!btr!thad ]
  118.     Added #F expansion.
  119.  
  120. Tue Oct 22 19:15:05 MET 1991
  121.     <pat@rwing>  (Pat Myrto)
  122.     "Suggest adding option to produce mail address. "
  123.     I've added -u for doing it. Thanks.
  124.