home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff319.lzh / CNewsSrc / cnews.orig.lzh / notebook / ctlfiles < prev    next >
Text File  |  1989-06-27  |  4KB  |  116 lines
  1. .DA "9 June 1989"
  2. .TL
  3. Files in /usr/lib/news (aka NEWSCTL)
  4. .AU
  5. Henry Spencer
  6. .AI
  7. Dept. of Zoology
  8. University of Toronto
  9. .LP
  10. The following files can appear in \fI/usr/lib/news\fR (or wherever the
  11. site's ``NEWSCTL''
  12. directory\(emsee \fIDirectory Layout and PATH in C News\fR\(emis).
  13. There may be others for the sake of local news readers, etc., but these
  14. are the ones C News knows about.
  15. .IP "active" 15
  16. Major control file:
  17. list of newsgroups recognized at this site, including current maximum
  18. and minimum article numbers and moderation status.
  19. Updated by \fIrelaynews\fR and \fIupact\fR.
  20. .IP "active.old"
  21. Previous \fIactive\fR.
  22. Created by \fIupact\fR.
  23. .IP "active.times"
  24. List of created newsgroups and when they were created, aimed at making it
  25. possible for news readers to be smarter about knowing when a group is new.
  26. Not yet supported by standard news readers.
  27. .IP "batchlog"
  28. Latest batcher log, created by \fIsendbatches\fR,
  29. showing backlogs.
  30. .IP "batchlog.o*"
  31. Previous batcher logs.
  32. .IP "batchparms"
  33. Control file for \fIsendbatches\fR, specifying how to feed other sites.
  34. .IP "bin"
  35. Master override directory for programs, searched before any other by
  36. all C News software.
  37. Normally contains only the \fIconfig\fR shell file
  38. specifying where to find everything else.
  39. .IP "errlog"
  40. Error log from \fIrelaynews\fR.
  41. .IP "errlog.o*"
  42. Previous \fIerrlog\fRs.
  43. .IP "explist"
  44. Control file for \fIexpire\fR, specifying what gets expired, and when,
  45. and what archiving is done.
  46. .IP "history"
  47. List of articles currently known at this site, with reception dates and
  48. pathnames.
  49. Updated by \fIrelaynews\fR and \fIexpire\fR.
  50. .IP "history.dir"
  51. Part of the \fIdbm\fR index for \fIhistory\fR.
  52. .IP "history.pag"
  53. Other part of the \fIdbm\fR index for \fIhistory\fR.
  54. .IP "history.o"
  55. Previous \fIhistory\fR.
  56. Created by \fIexpire\fR.
  57. .IP "localgroups"
  58. List of local groups and descriptions, for use by \fIcheckgroups\fR
  59. control-message handler (which uses it to decide what groups are
  60. legitimate even though the \fIcheckgroups\fR message did not mention them).
  61. Each line is a group name, a tab, and a terse description of the group.
  62. The descriptions are read only by humans.
  63. .IP "log"
  64. Log file from \fIrelaynews\fR, reporting what was received and when.
  65. .IP "log.o*"
  66. Previous \fIlog\fRs.
  67. .IP "mailname"
  68. Name of the site for purposes of mail, typically a domainized name.
  69. Used in building ``From:'' lines in newly-posted news.
  70. If not present,
  71. ``\fIhostname\fB.uucp\fR'' is assumed.
  72. .IP "mailpaths"
  73. Mailing routes for submissions to moderated newsgroups.
  74. .IP "newsgroups"
  75. File created by \fIcheckgroups\fR processing, with names and descriptions
  76. of newsgroups.
  77. For human reading only.
  78. Format identical to that of \fIlocalgroups\fR.
  79. .IP "newsgroups.bac"
  80. Previous \fInewsgroups\fR file.
  81. Created by \fIcheckgroups\fR processing.
  82. .IP "organization"
  83. Name of the organization,
  84. for \fIinews\fR's use in creating the \fIOrganization:\fR header
  85. for a posted article.
  86. .IP "postdefltdist"
  87. Default distribution (if any; default ``world'') for \fIpostnews\fR.
  88. .IP "postdefltgroup"
  89. Default newsgroup (if any; default is to insist on the user supplying one)
  90. for \fIpostnews\fR.
  91. .IP "replyusepath"
  92. This file should exist if and only if the local ``mail'' command is
  93. unable to handle `@' addresses,
  94. meaning that replies to control messages (etc.) must use the ``Path:''
  95. line instead of ``From:''.
  96. The contents are ignored.
  97. .IP "server"
  98. Host name of the news server, where all operations (posting, etc.)
  99. should be done.
  100. If file does not exist, current host is assumed.
  101. .IP "setnewsids"
  102. Set-uid-root program to get user and group ids correct for \fIrelaynews\fR.
  103. Needed only
  104. if the system is old enough to refuse to do \fIsetuid(geteuid())\fR.
  105. Included in NEWSCTL rather than NEWSBIN because its presence is a significant
  106. policy issue for the administrator, i.e. it is, sort of, a control file.
  107. .IP "sys"
  108. Major control file specifying what groups are legitimate here, and what groups
  109. are fed to other sites.
  110. .IP "watchtime"
  111. Last time \fInewswatch\fR was run.
  112. .IP "whoami"
  113. Name of the system for news purposes, for \fInewshostname\fR.
  114. If file does not exist,
  115. other sources (\fIhostname\fR etc.) are consulted.
  116.