home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume6 / misc.patches1 / nbatcher.page < prev   
Encoding:
Internet Message Format  |  1986-11-30  |  2.7 KB

  1. From: cca!caip!cbmvax!bpa!espo (Bob Esposito)
  2. Subject: Revised manual page for Nbatcher
  3.  
  4. I found 3 small errors in nbatcher.1  I sending you the corrected manual page.
  5.  
  6. =============================================
  7. .TH NBATCHER 1 LOCAL
  8. .SH NAME
  9. nbatcher  \- new batching system for news
  10. .SH SYNOPSIS
  11. .B nbatcher
  12. .IR "(run out of " cron ".)"
  13. .SH DESCRIPTION
  14. .PP
  15. .I Nbatcher
  16. is a program designed to send batched USENET data out
  17. in an orderly and controlled fashion, while providing alternative
  18. transmission methods.  As such, it is a replacement for
  19. .I csendbatch
  20. and the like, which typically require many entries in
  21. .IR crontab .
  22. .I Nbatcher
  23. is intended to be run hourly out of
  24. .I cron
  25. as the USENET administrator (NEWSID).
  26. .PP
  27. .I Nbatcher
  28. scans the file
  29. .I nbatcher.ctl
  30. in the NEWSLIB directory to determine if work should be spooled
  31. for a system.  In the control file, lines starting with asterisks
  32. are ignored; data lines are comprised of five colon\-separated
  33. fields:
  34. .RS
  35. site:hour:bits:queue_size:command
  36. .RE
  37. .TP
  38. The ``site'' field is the USENET neighbor; it is the same as the site in the
  39. news
  40. .I sys
  41. file.
  42. .TP
  43. The ``hours'' field is patterned after
  44. .IR cron's.
  45. If the hour is ``off,'' no work is spooled for the site.  An hour of
  46. ``*'' matches every hour.  It is also possible to specify specific
  47. hours, (e.g., 8, 09, or 22), a comma-separated list (e.g., 8,09,22),
  48. or a twenty\-four range, like 10-\15 for 10am through 3pm and 22\-4,
  49. for 10pm through 4am.
  50. .TP
  51. The ``bits'' field specifies the number of bits to use in compression;
  52. it should be a number between nine and 16, inclusive, or null.  If
  53. a number is specified, it is passed on to the
  54. .I compress
  55. program via the ``\-b'' flag.
  56. .TP
  57. The ``queue_size'' field specifies the maximum number of bytes allowed
  58. in the UUCP queue for this site.  The default is 100K.
  59. The UUCP queue size is determined by lookin in the
  60. .IR /usr/spool/uucp/ site
  61. directory; if it doesn't exist, the check is bypassed.  If there is
  62. data in the UUCP queue,
  63. .I nbatcher
  64. will only queue up as many USENET transfers as will fit within the limit
  65. specified by the ``queue_size'' field.
  66. .TP
  67. The ``command'' field is used to specific the UUCP command that should
  68. be used to queue the job; the default is ``uux \- \-r site!rnews'';
  69. note the absence of the ``\-z'' flag.
  70. .PP
  71. To set up a USENET neighbor to be controlled by nbatcher, the news
  72. .I sys
  73. entry for the neighbor must be modified to specify the ``F'' flag,
  74. and the file used to contain the article names must be
  75. .RI BATCHDIR/sysname ,
  76. where BATCHDIR is set in the Makefile as distributed.
  77. .SH "FILES"
  78. NEWSLIB/nbatcher.log
  79. .br
  80. .in +1i
  81. a logfile of failures, postponements, etc.
  82. .in -1i
  83. .SH BUGS
  84. Parsing of the control file is fairly robust, but not perfect.
  85.  
  86.  
  87.