home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / duucp-1.17 / AU-117b4-man.lha / man / BatchNews < prev    next >
Encoding:
Text File  |  1993-12-15  |  3.3 KB  |  95 lines
  1.  
  2. NAME
  3.     BatchNews - collect news batches for forwarding to other sites.
  4.  
  5.  
  6. SYNTAX
  7.     BatchNews [-h hostname] [-t temporary-directory]
  8.  
  9.  
  10. DESCRIPTION
  11.     The BatchNews program scans the UUSpool:batch directory for text files
  12.     containing lists of news articles (prepared by rnews) which are to be
  13.     forwarded to other sites. The names of these files will be the names of
  14.     the respective systems to which news is to be forwarded.
  15.  
  16.     BatchNews compresses each batch of news and then calls 'uux' to spool
  17.     the batch for delivery to the target system. When batching is completed
  18.     for a particular system, that UUSpool:batch/<sysname> file is deleted.
  19.  
  20.     BatchNews is intentionally decoupled from the 'uuxqt' program (it isn't
  21.     run by uuxqt) so that you can schedule the times at which news batching
  22.     is performed (using crontab entries), providing you some degree of control
  23.     over when outgoing news activity takes place without restricting login
  24.     times, etc.
  25.  
  26.     By default, BatchNews will batch news for all systems which have files in
  27.     UUSpool:Batch. Using the -h argument, the caller may force only a single
  28.     host to be batched for.
  29.  
  30.     By default, BatchNews creates its temporary files (which consist of copies
  31.     of the news articles to be sent to a destination system) in the UUNews
  32.     directory, and its compressed temporary. Using the -t argument and routing
  33.     these temporaries to RAM: or a subdirectory thereof can significantly
  34.     speed up the batching process.
  35.  
  36.     News batching is driven by a file named UULib:sys. Entries in the file
  37.     have the form:
  38.  
  39.         # Forward the following groups to system jojo -
  40.  
  41.         jojo:comp.*, \
  42.              gnu.*, \
  43.              misc.jobs.offered
  44.  
  45.         # Forward everything except misc.jobs.offered to fubar
  46.         #
  47.  
  48.         fubar:*,-misc.jobs.offered
  49.  
  50.     (see UUMan:Sys for more information on the Sys file)
  51.  
  52.     Lines beginning with a number sign (#) are comments and are ignored. Each
  53.     entry in the file is essentially treated as one very long line which can
  54.     be continued over many physical lines through the use of the backslash
  55.     continutation character (\). The format of the 'sys' file is somewhat
  56.     different from what is implemented on Unix systems. Each "entry" is a
  57.     simple pattern which may contain wildcards (*, ?). The 'rnews' program
  58.     compares the newsgroup name against each of these patterns until either
  59.     a match is detected or the end of the list is reached.
  60.  
  61.  
  62. CONFIG VARIABLES
  63.  
  64.     BatchBits       12/13/14/15/16
  65.  
  66.         Set number of bits for compression, 12 to 16.  You can set it
  67.         higher if you have lots of memory.  This also depends on what the
  68.         sites you feed can handle.  Generally anything greater than 14 bit
  69.         compression is overkill.
  70.  
  71.     DomainPath      N/Y
  72.  
  73.         If 'Y' then your full domain name will be put into the Path:
  74.         instead of just your uucp node name.  ONLY use this option if
  75.         your newsfeed requires a full domain name in the news Path:
  76.         line.
  77.  
  78.     SpoolSize       65000
  79.  
  80.         Set maximum file size for batched spool files, before compression.
  81.  
  82.  
  83. NOTES
  84.         To speed BatchNews up:
  85.  
  86.                 Move temporaries to RAM: (use -t)
  87.  
  88.                 Make UUX resident
  89.  
  90.                 Run BatchNews more often
  91.  
  92.  
  93. BUGS
  94.         Doesn't allow for alternate compression types.
  95.