home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 400-499 / ff473.lzh / CNewsSrc / cnews_src.lzh / man / relaynews.man < prev    next >
Text File  |  1991-01-05  |  12KB  |  199 lines
  1.  
  2.  
  3.  
  4. RELAYNEWS(8)          MAINTENANCE COMMANDS           RELAYNEWS(8)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      relaynews - store and forward netnews articles
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrreeeellllaaaayyyynnnneeeewwwwssss [ ----iiiinnnnrrrrssss ] [ ----dddd ffffhhhhllllmmmmtttt ] [ ----xxxx excluded-site ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  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////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg and  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.   ----iiii  redirects
  25.      stdout  only to ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg.  ----nnnn enables ``NNTP mode''
  26.      in which history  entries  are  generated  as  articles  are
  27.      rejected.   ----ssss makes discarding an article a serious matter,
  28.      justifying a  non-zero  exit  status  (for  the  benefit  of
  29.      _i_n_e_w_s).   ----xxxx excludes _e_x_c_l_u_d_e_d-_s_i_t_e from the list of netnews
  30.      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.      An article which contains an AAAAllllssssoooo----CCCCoooonnnnttttrrrroooollll:::: header is treated
  42.      normally except that the contents of the header are executed
  43.      as if they were the contents of a CCCCoooonnnnttttrrrroooollll:::: header.  Such  an
  44.      article is a form of _h_y_b_r_i_d _m_e_s_s_a_g_e since it functions as an
  45.      ordinary article yet also causes  control  functions  to  be
  46.      executed.   The  SSSSuuuuppppeeeerrrrsssseeeeddddeeeessss:::: header is a special case and is
  47.      rewritten internally _o_n_l_y to AAAAllllssssoooo----CCCCoooonnnnttttrrrroooollll:::: ccccaaaannnncccceeeellll.
  48.  
  49.      Articles which contain no locally-known (to the _a_c_t_i_v_e file)
  50.      newsgroups  yet  accepted by the local subscription list are
  51.      filed exactly once, in the jjjjuuuunnnnkkkk pseudo-group, and  forwarded
  52.      as  usual.   If all newsgroups in the article are refused by
  53.      the local subscription list or are refused by an xxxx in _a_c_t_i_v_e
  54.      file  entries,  then  the  article will be _d_i_s_c_a_r_d_e_d and not
  55.      filed in jjjjuuuunnnnkkkk.
  56.  
  57.      Locally-generated articles need  not  be  permitted  by  the
  58.      local  subscription  list  but  are otherwise processed nor-
  59.      mally; this is for backward  compatibility  and  perhaps  to
  60.  
  61.  
  62.  
  63. Sun Microsystems   Last change: 2 January 1990                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RELAYNEWS(8)          MAINTENANCE COMMANDS           RELAYNEWS(8)
  71.  
  72.  
  73.  
  74.      keep the local subscription list short by not requiring ggggeeeennnn----
  75.      eeeerrrraaaallll and the like to be named.
  76.  
  77. FFFFIIIILLLLEEEESSSS
  78.      ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss     netnews article tree
  79.      ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////ccccoooommmmpppp////uuuunnnniiiixxxx////wwwwiiiizzzzaaaarrrrddddssss
  80.                          example   newsgroup    directory    (for
  81.                          ccccoooommmmpppp....uuuunnnniiiixxxx....wwwwiiiizzzzaaaarrrrddddssss)
  82.      ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg////_s_y_s_t_e_m////ttttooooggggoooo
  83.                          default  ssssyyyyssss  file  FFFF,  ffff  and  IIII  flags
  84.                          filename
  85.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////ssssyyyyssss   determines who receives  broadcast  net-
  86.                          news  articles, which ones, and how they
  87.                          are to be sent articles
  88.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////aaaaccccttttiiiivvvveeee
  89.                          contains  locally-legal  newsgroups  and
  90.                          (un)moderated flag
  91.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy
  92.                          record of articles received
  93.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy....{{{{ddddiiiirrrr,,,,ppppaaaagggg}}}}
  94.                          _d_b_m(3) index into hhhhiiiissssttttoooorrrryyyy
  95.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////wwwwhhhhooooaaaammmmiiii
  96.                          if present, contains news system's  site
  97.                          name, overriding any other host names
  98.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg   log of incoming articles
  99.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg
  100.                          log of errors, should be empty
  101.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////bbbbiiiinnnn   system-specific directory of programs to
  102.                          override  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn  and its sub-
  103.                          directories
  104.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccttttllll
  105.                          directory of programs to implement  con-
  106.                          trol messages
  107.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////rrrreeeellllaaaayyyy////rrrreeeellllaaaayyyynnnneeeewwwwssss
  108.                          the lean, mean news-relayin' machine
  109.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwssssrrrreeeeppppllllyyyy
  110.                          generates a return address from  article
  111.                          headers
  112.  
  113. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  114.      _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)
  115.      ARPA Internet RFCs 1036 and 850
  116.  
  117. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  118.      Usually found in ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.
  119.      _R_e_l_a_y_n_e_w_s's exit status is a bit vector of status bits;  see
  120.      nnnneeeewwwwssss////iiiinnnncccclllluuuuddddeeee////nnnneeeewwwwssss....hhhh for the bit definitions.
  121.      If _r_e_l_a_y_n_e_w_s cannot establish safe standard file descriptors
  122.      and  standardise  its  environment  (notably PATH, SHELL and
  123.      IFS), probably due to failure of  _m_a_l_l_o_c(3),  it  will  exit
  124.      with status of 1 and without writing any complaints on stan-
  125.      dard error (eeeerrrrrrrrlllloooogggg), as a security precaution.
  126.  
  127.  
  128.  
  129. Sun Microsystems   Last change: 2 January 1990                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RELAYNEWS(8)          MAINTENANCE COMMANDS           RELAYNEWS(8)
  137.  
  138.  
  139.  
  140. HHHHIIIISSSSTTTTOOOORRRRYYYY
  141.      Written by Geoff Collyer at the  University  of  Toronto  as
  142.      part of the C news project.
  143.  
  144. BBBBUUUUGGGGSSSS
  145.      An article with a header that does not  fit  entirely  in  a
  146.      static  buffer  and  on  a  machine without real links (e.g.
  147.      something like  Eunice  but  on  a  PDP-11)  will  be  filed
  148.      incorrectly:   any symbolic links under ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss will
  149.      point at a non-existent filename.
  150.  
  151.      A control message which  cannot  be  filed  in  the  ccccoooonnnnttttrrrroooollll
  152.      pseudo-group  and  which cannot be filed in the jjjjuuuunnnnkkkk pseudo-
  153.      group because jjjjuuuunnnnkkkk is not in the _a_c_t_i_v_e file  will  generate
  154.      an  error  message  which  refers to the groups in its NNNNeeeewwwwssss----
  155.      ggggrrrroooouuuuppppssss:::: header instead of referring to the  ccccoooonnnnttttrrrroooollll  pseudo-
  156.      group.
  157.  
  158.      _R_e_l_a_y_n_e_w_s could run faster in some circumstances  and  would
  159.      be simpler if CCCCoooonnnnttttrrrroooollll:::: were required to be the first header,
  160.      if present, and if NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: were required to be the next.
  161.  
  162.      The whole control message and hybrid message situation is  a
  163.      festering  bug.   Either  control  messages  should be elim-
  164.      inated, or all forms of  backward  compatibility  should  be
  165.      dropped  (including  CCCCoooonnnnttttrrrroooollll::::  and  SSSSuuuuppppeeeerrrrsssseeeeddddeeeessss::::)   and  only
  166.      AAAAllllssssoooo----CCCCoooonnnnttttrrrroooollll:::: should be supported.
  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. Sun Microsystems   Last change: 2 January 1990                  3
  196.  
  197.  
  198.  
  199.