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 / newsmaint.man < prev    next >
Text File  |  1991-01-05  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4. NEWSMAINT(8)          MAINTENANCE COMMANDS           NEWSMAINT(8)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      newshist - extract history line for news article(s)
  10.      newsdaily - maintain news log files and report problems
  11.      newswatch - keep an eye on news system for difficulties
  12.      newsboot - clean up news debris on reboot
  13.      locknews - lock news system for manual tinkering
  14.      addgroup, delgroup - add and delete newsgroups, locally only
  15.      adddirs - make any missing directories for active newsgroups
  16.      addfeed - add a news feed
  17.      act.to.times - create active.times file for news readers
  18.      histfrom, newsfrom - list news arriving over  specific  time
  19.      range
  20.      addmissing - add missing news articles to history file
  21.  
  22. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  23.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwsssshhhhiiiisssstttt msgid ...
  24.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwssssddddaaaaiiiillllyyyy [ guru ... ]
  25.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwsssswwwwaaaattttcccchhhh [ guru ... ]
  26.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwssssbbbbooooooootttt
  27.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////lllloooocccckkkknnnneeeewwwwssss
  28.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaaddddddddggggrrrroooouuuupppp group {yyyy|nnnn|mmmm|xxxx|====_r_e_a_l_g_r_o_u_p}
  29.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////ddddeeeellllggggrrrroooouuuupppp group
  30.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaaddddddddddddiiiirrrrssss
  31.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaaddddddddffffeeeeeeeedddd [ ----LLLL ] site groups
  32.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaacccctttt....ttttoooo....ttttiiiimmmmeeeessss activefile
  33.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////hhhhiiiissssttttffffrrrroooommmm startdate [ enddate ]
  34.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwssssffffrrrroooommmm startdate [ enddate ]
  35.      ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaaddddddddmmmmiiiissssssssiiiinnnngggg
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      These programs are utilities useful in maintaining a C  News
  39.      system and diagnosing problems in it.
  40.  
  41.      _N_e_w_s_h_i_s_t prints the history line for each article identified
  42.      by a _m_s_g_i_d.
  43.  
  44.      _N_e_w_s_d_a_i_l_y performs minor maintenance chores  that  typically
  45.      should  be  done  once  a  day  for the news system:  saving
  46.      copies of log files and truncating  them,  reporting  logged
  47.      errors,  checking  for  anomalies  suggesting  something  is
  48.      wrong, and cleaning out leftover files.  _N_e_w_s_d_a_i_l_y saves one
  49.      generation  of  old  _l_o_g  files and three generations of old
  50.      _e_r_r_l_o_g and _b_a_t_c_h_l_o_g files.  It reports problems to the named
  51.      _g_u_r_us (default:  `usenet').
  52.  
  53.      _N_e_w_s_w_a_t_c_h looks  for  indications  of  news  problems  on  a
  54.      shorter time scale than those reported by _n_e_w_s_d_a_i_l_y, notably
  55.      strangely-persistent lock files that may  indicate  a  news-
  56.      system  failure.   It  typically should be run a few times a
  57.      day.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Microsystems    Last change: 13 Oct 1990                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NEWSMAINT(8)          MAINTENANCE COMMANDS           NEWSMAINT(8)
  71.  
  72.  
  73.  
  74.      _N_e_w_s_b_o_o_t  should  be  run  from  /_e_t_c/_r_c  or  the   system's
  75.      equivalent on reboot.  It cleans up files that the news sys-
  76.      tem might have left lying about if the system crashed  while
  77.      news was being processed, notably old lock files.
  78.  
  79.      _L_o_c_k_n_e_w_s locks the news system, starts up a  shell  for  the
  80.      user,  and  waits around to unlock the news system when that
  81.      shell terminates.  This simplifies manual maintenance.
  82.  
  83.      _A_d_d_g_r_o_u_p and _d_e_l_g_r_o_u_p respectively add a newsgroup  (with  a
  84.      specified flags field for the _a_c_t_i_v_e file, normally `y' [see
  85.      _n_e_w_s(5)]) and delete a newsgroup manually, with proper lock-
  86.      ing.   The  effect  is  purely local; no control message (to
  87.      propagate the change to other machines) is sent.
  88.  
  89.      _A_d_d_d_i_r_s sweeps through the _a_c_t_i_v_e file checking that  direc-
  90.      tories  exist  for  all  newsgroups.  (_R_e_l_a_y_n_e_w_s will create
  91.      directories as needed, but some user-interface software gets
  92.      upset  if  a  newsgroup  exists but its directory does not.)
  93.      This is mostly useful when adding groups in bulk,  based  on
  94.      another site's _a_c_t_i_v_e file.
  95.  
  96.      _A_d_d_f_e_e_d adds a line to the _s_y_s file specifying that the _s_i_t_e
  97.      should  be  fed the _g_r_o_u_p_s, and creates a suitable outbound-
  98.      batching directory.  If the ----LLLL option is given, the  LLLL  flag
  99.      is  included to restrict the feed to locally-generated arti-
  100.      cles only.  If _g_r_o_u_p_s does not include a  distribution  list
  101.      (separated  from  the newsgroups by a `/'), the default dis-
  102.      tribution list `/all' is appended.  If _g_r_o_u_p_s is of the form
  103.      ====_n_a_m_e,  this  specifies the same groups as those fed to site
  104.      `_n_a_m_e', with the exception that `to._n_a_m_e'  is  rewritten  to
  105.      `to._s_i_t_e'.
  106.  
  107.      _A_c_t._t_o._t_i_m_e_s emits (on standard output) a  new  _a_c_t_i_v_e._t_i_m_e_s
  108.      file  (see _a_c_t_i_v_e._t_i_m_e_s(5)) based on the contents of _a_c_t_i_v_e_-
  109.      _f_i_l_e, which should normally be /_u_s_r/_l_i_b/_n_e_w_s/_a_c_t_i_v_e.
  110.  
  111.      _H_i_s_t_f_r_o_m emits (on standard output) all  history  lines  for
  112.      unexpired  articles  arriving between _s_t_a_r_t_d_a_t_e and _e_n_d_d_a_t_e.
  113.      The dates must be acceptable to  _g_e_t_d_a_t_e  (see  _n_e_w_s_a_u_x(8)).
  114.      The default _e_n_d_d_a_t_e is ``now''.
  115.  
  116.      _N_e_w_s_f_r_o_m runs _h_i_s_t_f_r_o_m and processes its output to produce a
  117.      list  of  absolute  pathnames  of  articles arriving between
  118.      _s_t_a_r_t_d_a_t_e and _e_n_d_d_a_t_e (default ``now'').
  119.  
  120.      _A_d_d_m_i_s_s_i_n_g scans the _h_i_s_t_o_r_y file and the news-article  tree
  121.      to  find articles that are not in the history file, and adds
  122.      them to the file, rebuilding the _d_b_z database to match.
  123.  
  124. FFFFIIIILLLLEEEESSSS
  125.      /usr/lib/news/history   history file
  126.  
  127.  
  128.  
  129. Sun Microsystems    Last change: 13 Oct 1990                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NEWSMAINT(8)          MAINTENANCE COMMANDS           NEWSMAINT(8)
  137.  
  138.  
  139.  
  140.      /usr/lib/news/history.pag_d_b_z database for history file
  141.      /usr/lib/news/history.dir_d_b_z database for history file
  142.      /usr/lib/news/log       current news log
  143.      /usr/lib/news/log.o     previous news log
  144.      /usr/lib/news/errlog    current news-error log
  145.      /usr/lib/news/errlog.o* old news-error logs
  146.      /usr/lib/news/batchlog  current news-batcher log
  147.      /usr/lib/news/batchlog.o*old news-batcher logs
  148.      /usr/spool/news/in.cominginput-spooling area
  149.      /usr/spool/news/out.goingoutput-batching area
  150.      /usr/lib/news/watchtime last time _n_e_w_s_w_a_t_c_h was run
  151.      /usr/lib/news/active    list of current newsgroups
  152.      /usr/lib/news/active.oldbackup copy created by _a_d_d_g_r_o_u_p and _d_e_l_g_r_o_u_p
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      df(1), uucp(1), ls(1),  ctime(3),  getdate(3),  hostname(1),
  156.      grep(1),   news(5),   expire(8),   newsbatch(8),   rnews(8),
  157.      newsaux(8)
  158.  
  159. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  160.      _L_o_c_k_n_e_w_s complains and exits if it is  unable  to  lock  the
  161.      news system; this is typically a matter of either inadequate
  162.      permissions or news activity already in progress.
  163.  
  164.      _A_d_d_f_e_e_d looks for a ////ddddeeeeffffaaaauuuulllltttt//// line or a line for _s_i_t_e in the
  165.      _b_a_t_c_h_p_a_r_m_s  file,  and  if  none is found, warns the user to
  166.      create one.
  167.  
  168.      _A_d_d_m_i_s_s_i_n_g complains and exits if it is unable to  lock  the
  169.      news system, if _e_x_p_i_r_e appears to be running, or if there is
  170.      not enough space for a temporary copy of  the  _h_i_s_t_o_r_y  file
  171.      and  database.  It also notes the presence of articles which
  172.      did not have intelligible headers  (which  are  placed  into
  173.      history with an entry specifying immediate expiry).
  174.  
  175. HHHHIIIISSSSTTTTOOOORRRRYYYY
  176.      Written at U of Toronto by Henry Spencer and Geoff Collyer.
  177.  
  178. BBBBUUUUGGGGSSSS
  179.      _L_o_c_k_n_e_w_s is a bit crude.
  180.  
  181.      _D_e_l_g_r_o_u_p  does  not  remove  files   or   directories   from
  182.      /usr/spool/news, although it prints a reminder to do so.
  183.  
  184.      The ====_n_a_m_e form of _a_d_d_f_e_e_d cannot  cope  with  continued  _s_y_s
  185.      lines.
  186.  
  187.      _A_d_d_f_e_e_d assumes that attention to the _b_a_t_c_h_p_a_r_m_s  file  suf-
  188.      fices  to  get batching going for a new feed, which is naive
  189.      if you are running _s_e_n_d_b_a_t_c_h_e_s selectively, i.e. with  argu-
  190.      ments.
  191.  
  192.  
  193.  
  194.  
  195. Sun Microsystems    Last change: 13 Oct 1990                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. NEWSMAINT(8)          MAINTENANCE COMMANDS           NEWSMAINT(8)
  203.  
  204.  
  205.  
  206.      _A_d_d_m_i_s_s_i_n_g does not cope properly with  articles  which  are
  207.      already in history but with an incomplete list of pathnames;
  208.      the result is duplicate message-IDs  in  history  until  the
  209.      article(s)  expire,  which  is  relatively  harmless but may
  210.      interfere with access to those articles.
  211.  
  212.      Various nuisances can result if  the  maintenance  utilities
  213.      are  run  as _r_o_o_t rather than as the owner of the news data-
  214.      base.  It's difficult to defend against this.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Microsystems    Last change: 13 Oct 1990                    4
  262.  
  263.  
  264.  
  265.