home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / auucp+-1.02 / auucpplus1_02d2.lzh / man / relaynews < prev    next >
Encoding:
Text File  |  1990-09-12  |  11.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4.           RELAYNEWS(8)                 386/ix                  RELAYNEWS(8)
  5.  
  6.  
  7.  
  8.           NAME
  9.                relaynews - store and forward netnews articles
  10.  
  11.           SYNOPSIS
  12.                rrrreeeellllaaaayyyynnnneeeewwwwssss [ ----iiiinnnnrrrrssss ] [ ----dddd ffffhhhhllllmmmmtttt ] [ ----xxxx excluded-site ]
  13.  
  14.           DESCRIPTION
  15.                _R_e_l_a_y_n_e_w_s installs locally and broadcasts (network) news
  16.                articles read from its standard input.  Typically the arti-
  17.                cles will be in a batch (see _n_e_w_s(5)), which must _n_o_t be
  18.                compressed (see _c_o_m_p_r_e_s_s(1)).  Articles are usually queued
  19.                for transmission to one's netnews neighbours via _n_e_w_s_-
  20.                _b_a_t_c_h(8) and thence via _u_u_x(1) or _m_a_i_l(1).
  21.  
  22.                ----dddd turns on debugging of ffffiling, hhhheaders, llllocking, mmmmatching,
  23.                ttttransmission.  ----rrrr redirects stdout and stderr to
  24.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg and ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.  ----iiii
  25.                redirects stdout only to ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg.  ----nnnn enables
  26.                ``NNTP mode'' in which history entries are generated as
  27.                articles are rejected.  ----ssss makes discarding an article a
  28.                serious matter, justifying a non-zero exit status (for the
  29.                benefit of _i_n_e_w_s).  ----xxxx excludes _e_x_c_l_u_d_e_d-_s_i_t_e from the list
  30.                of netnews neighbours to receive article(s).
  31.  
  32.                _C_o_n_t_r_o_l _m_e_s_s_a_g_e_s, recognised by their CCCCoooonnnnttttrrrroooollll:::: headers (or
  33.                _f_o_r _b_a_c_k_w_a_r_d _c_o_m_p_a_t_i_b_i_l_i_t_y _O_N_L_Y a NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header con-
  34.                taining a single newsgroup ending in ....ccccttttllll), are filed under
  35.                the ccccoooonnnnttttrrrroooollll pseudo-group only, but are forwarded as usual,
  36.                by examining their NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: and DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: headers.
  37.                Note that posting to the ccccoooonnnnttttrrrroooollll pseudo-group will not cause
  38.                a message to be treated as a control message; ccccoooonnnnttttrrrroooollll is not
  39.                a real newsgroup.
  40.  
  41.                Articles which contain no locally-known (to the _a_c_t_i_v_e file)
  42.                newsgroups yet accepted by the local subscription list are
  43.                filed exactly once, in the jjjjuuuunnnnkkkk pseudo-group, and forwarded
  44.                as usual.  If all newsgroups in the article are refused by
  45.                the local subscription list or are refused by an xxxx in _a_c_t_i_v_e
  46.                file entries, then the article will be _d_i_s_c_a_r_d_e_d and not
  47.                filed in jjjjuuuunnnnkkkk.
  48.  
  49.                Locally-generated articles need not be permitted by the
  50.                local subscription list but are otherwise processed nor-
  51.                mally; this is for backward compatibility and perhaps to
  52.                keep the local subscription list short by not requiring ggggeeeennnn----
  53.                eeeerrrraaaallll and the like to be named.
  54.  
  55.           FILES
  56.                ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss     netnews article tree
  57.                ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////ccccoooommmmpppp////uuuunnnniiiixxxx////wwwwiiiizzzzaaaarrrrddddssss
  58.                                    example newsgroup directory (for
  59.                                    ccccoooommmmpppp....uuuunnnniiiixxxx....wwwwiiiizzzzaaaarrrrddddssss)
  60.                ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg////_s_y_s_t_e_m////ttttooooggggoooo
  61.  
  62.  
  63.           Rev. 4 July 1989                                           Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           RELAYNEWS(8)                 386/ix                  RELAYNEWS(8)
  71.  
  72.  
  73.  
  74.                                    default ssssyyyyssss file FFFF, ffff and IIII flags
  75.                                    filename
  76.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////ssssyyyyssss
  77.                                    determines who receives broadcast net-
  78.                                    news articles, which ones, and how they
  79.                                    are to be sent articles
  80.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////aaaaccccttttiiiivvvveeee
  81.                                    contains locally-legal newsgroups and
  82.                                    (un)moderated flag
  83.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy
  84.                                    record of articles received
  85.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy....{{{{ddddiiiirrrr,,,,ppppaaaagggg}}}}
  86.                                    _d_b_m(3) index into hhhhiiiissssttttoooorrrryyyy
  87.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////wwwwhhhhooooaaaammmmiiii
  88.                                    if present, contains news system's site
  89.                                    name, overriding any other host names
  90.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg
  91.                                    log of incoming articles
  92.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg
  93.                                    log of errors, should be empty
  94.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////bbbbiiiinnnn
  95.                                    system-specific directory of programs to
  96.                                    override ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn and its
  97.                                    subdirectories
  98.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccttttllll
  99.                                    directory of programs to implement con-
  100.                                    trol messages
  101.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////rrrreeeellllaaaayyyy////rrrreeeellllaaaayyyynnnneeeewwwwssss
  102.                                    the lean, mean news-relayin' machine
  103.                ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwssssrrrreeeeppppllllyyyy
  104.                                    generates a return address from article
  105.                                    headers
  106.  
  107.           SEE ALSO
  108.                _c_o_m_p_r_e_s_s(1), _m_a_i_l(1), _u_u_x(1), _d_b_m(3), _n_e_w_s(5), _n_e_w_s_b_a_t_c_h(8)
  109.                ARPA Internet RFCs 1036 and 850
  110.  
  111.           DIAGNOSTICS
  112.                Usually found in ////uuuussssrrrr////llllbbbbiiiinnnn////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.
  113.                _R_e_l_a_y_n_e_w_s's exit status is a bit vector of status bits; see
  114.                nnnneeeewwwwssss////iiiinnnncccclllluuuuddddeeee////nnnneeeewwwwssss....hhhh for the bit definitions.
  115.  
  116.           HISTORY
  117.                Written by Geoff Collyer at the University of Toronto as
  118.                part of the C news project.
  119.  
  120.           BUGS
  121.                An article with a header that does not fit entirely in a
  122.                static buffer and on a machine without real links (e.g.
  123.                something like Eunice but on a PDP-11) will be filed
  124.                incorrectly:  any symbolic links under /usr/spool/news will
  125.                point at a non-existent filename.
  126.                A control message which cannot be filed in the ccccoooonnnnttttrrrroooollll
  127.  
  128.  
  129.           Rev. 4 July 1989                                           Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           RELAYNEWS(8)                 386/ix                  RELAYNEWS(8)
  137.  
  138.  
  139.  
  140.                pseudo-group and which cannot be filed in the jjjjuuuunnnnkkkk pseudo-
  141.                group because jjjjuuuunnnnkkkk is not in the _a_c_t_i_v_e file will generate
  142.                an error message which refers to the groups in its NNNNeeeewwwwssss----
  143.                ggggrrrroooouuuuppppssss:::: header instead of referring to the ccccoooonnnnttttrrrroooollll pseudo-
  144.                group.
  145.                _R_e_l_a_y_n_e_w_s could run faster in some circumstances and would
  146.                be simpler if _C_o_n_t_r_o_l: were required to be the first header,
  147.                if present, and if _N_e_w_s_g_r_o_u_p_s: were required to be the next.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           Rev. 4 July 1989                                           Page 3
  196.  
  197.  
  198.  
  199.