home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / duucp-1.17 / AU-117b-man.lha / man / RNews < prev    next >
Encoding:
Text File  |  1993-11-26  |  5.6 KB  |  138 lines
  1. RNews                                                                     RNews
  2.  
  3. NAME
  4.  
  5.         RNews - unbatch, store, and forward news articles.
  6.  
  7. SYNOPSIS
  8.  
  9.         RNews [-D number] [-x number] [-h] [-n] [-o] [-t directory] [-1]
  10.               [-p] [-u decompressor] [newsfile] [<newsfile]
  11.  
  12. DESCRIPTION
  13.  
  14.         RNEWS is normally run by UUXQT and POSTNEWS to accept new news
  15.         articles and post them to UUNEWS:. If the UULib:Sys file so
  16.         indicates, a flag record is created in the UUSpool:Batch
  17.         directory to queue the article to other hosts.
  18.  
  19.         The input to RNEWS is either a batch of articles, or a single
  20.         news article. If it is a batch, it may be either compressed
  21.         (using the standard Unix cunbatch format) or uncompressed.
  22.  
  23.         RNEWS is more efficient when newsfile is NOT standard input.
  24.  
  25.         If RNEWS fails, a terse error message is printed to stdout, and
  26.         additional information is stored in UUSpool:Logfile. On failure,
  27.         RNEWS returns thirty (30).
  28.  
  29.         On success, RNEWS returns zero (0).
  30.  
  31. OPTIONS
  32.  
  33.         -1:         If more than one newsgroup on the Newsgroup header
  34.                     is kept locally, only store the first in the news
  35.                     tree.
  36.  
  37.         -D number:  Set debugging level.
  38.  
  39.                     If "number" is 10 or more, temporary files created
  40.                     by RNEWS are not removed.
  41.  
  42.         -h:         Do not use hardlinks to store articles which exist
  43.                     in multiple newsgroups. Instead, create copies.
  44.  
  45.                     (Only used for Exec V37 and above.)
  46.  
  47.         -n:         Dummy. Process all articles, but do not store them in
  48.                     news tree.
  49.  
  50.                     (Used in debugging.)
  51.  
  52.         -o:         Create and maintain NewsOverview style article summaries
  53.                     in the news directories.
  54.  
  55.                     (Not yet implemented.)
  56.  
  57.         -p:         RNEWS is being called by POSTNEWS, and shouldn't run
  58.                     any decompression program, even if specified by a
  59.                     -u argument.
  60.  
  61.         -t dir:     Specify a directory where RNEWS temporary files are
  62.                     stored. If this is set to RAM: or T:, then RNEWS can
  63.                     be expected to execute much more quickly. However,
  64.                     it will consume much more memory.
  65.  
  66.         -x number:  Set logging level. When "number" is one (1) or higher,
  67.                     additional information is logged, at some cost in
  68.                     additional processor and I/O time.
  69.  
  70.         -u decomp:  Specify the decompression program to be used by RNEWS.
  71.                     RNEWS has the "compress" algorithm built-in, others
  72.                     require an external program. Typically this will be
  73.                     "gunzip".
  74.  
  75.                     (Only allowed for Exec v37 and above.)
  76. NOTES
  77.  
  78.         Local postings are much more efficient if RNEWS is called with
  79.         the -p argument. Otherwise, if the -u argument is also specified,
  80.         RNEWS will attempt to decompress the input file prior to deciding
  81.         that the input is a local post.
  82.  
  83.         The GZIP format is much more efficient in terms of data compression
  84.         than the standard "compress" method used by default in AmigaUUCP
  85.         (and by C News). This means that files may take a much shorter
  86.         period of time to receive via UUCP. The advantage to the "compress"
  87.         method is that RNEWS has that algorithm built-in. To use another
  88.         decompressor, the -u argument is provided (for C News RELAYNEWS,
  89.         the -d argument is used). The alternate decompressor will typically
  90.         be GUNZIP, which can deal with "pack", "compress" and "gzip" format
  91.         batches. To use this as your default, place the following line in your
  92.         UULib:Config file:
  93.  
  94.                 RNEWS   UUCP:C/RNews -u gunzip
  95.  
  96.         Obviously, GUNZIP must be in the search path, or an absolute path
  97.         specified. Other default options may also be specified (such as
  98.         -h and '-t t:'). Your performance will be best if your version
  99.         of GUNZIP is pure (and made resident).
  100.  
  101.         RNEWS supports two methods of notifying external programs
  102.         that new news has arrived:
  103.  
  104.             1. If a public message port named "T:NewsRdy" exists, then
  105.                RNEWS will cause the associated signal of that message
  106.                port to the task set for that message port (SigBit and
  107.                SigTask).
  108.  
  109.             2. If UULib:Config has an entry for NewsReadyCmd then RNEWS
  110.                will execute that program according to the following
  111.                template:
  112.  
  113.                         "RUN NewsReadyCmd -x T:NewsRdy"
  114.  
  115.                where you replace "NewsReadyCmd" with the name of the
  116.                program you wish to run. RNEWS will create a file named
  117.                "T:NewsRdy" (if it does not already exist) prior to
  118.                calling that program (the intent being to provide a
  119.                mechanism for timestamping the last news arrival).
  120.  
  121.         These options are tried in order. They are not required, and
  122.         most installations will not have a use for them.
  123.  
  124.         RNews does not process Control messages per se, but will file
  125.         them into UUNews:Control if Control is listed as a valid newsgroup
  126.         in your UULib:Newsgroups file. If Control is not listed as valid
  127.         newsgroup, RNews will "drop control message on the floor" and not
  128.         store them at all on your system. When RNews detects a Control
  129.         message, a note is logged in UUSpool:Logfile.
  130.  
  131. REFERENCES
  132.  
  133.         BatchNews
  134.         Config
  135.         PostNews
  136.         Sys
  137.         UUXqt
  138.