home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / N / CNEWS / _CNEWS.TAR / usr / doc / cnews / docs / ctlfiles < prev    next >
Encoding:
Text File  |  1994-09-02  |  5.5 KB  |  201 lines
  1. .Ch "Files in /usr/lib/news (aka NEWSCTL)"
  2. .Df files NEWSCTL
  3. .LP
  4. The following files can appear in \fI/usr/lib/news\fR (or wherever the
  5. site's ``NEWSCTL''
  6. .Df NEWSCTL
  7. directory\(emsee \fIDirectory Layout and PATH in C News\fR\(emis).
  8. There may be others for the sake of local news readers, etc., but these
  9. are the ones C News knows about.
  10. .IP "active" 15
  11. .Df active
  12. .Df files active
  13. Major control file:
  14. list of newsgroups recognized at this site, including current maximum
  15. and minimum article numbers and moderation status.
  16. Updated by \fIrelaynews\fR and \fIupact\fR.
  17. .IP "active.old"
  18. .Df active.old
  19. .Df files active.old
  20. Previous \fIactive\fR.
  21. Created by \fIupact\fR.
  22. .IP "active.times"
  23. .Df active.times
  24. .Df files active.times
  25. List of created newsgroups and when they were created, aimed at making it
  26. possible for news readers to be smarter about knowing when a group is new.
  27. Only supported by some standard news readers.
  28. .IP "batchlog"
  29. .Df batchlog
  30. .Df files batchlog
  31. Latest batcher log, created by \fIsendbatches\fR,
  32. showing backlogs.
  33. .IP "batchlog.o*"
  34. .Df batchlog.o*
  35. .Df files batchlog.o*
  36. Previous batcher logs.
  37. .IP "batchparms"
  38. .Df batchparms
  39. .Df files batchparms
  40. Control file for \fIsendbatches\fR, specifying how to feed other sites.
  41. .IP "bin"
  42. .Df files bin
  43. Master override directory for programs, searched before any other by
  44. all C News software.
  45. Normally contains only the \fIconfig\fR shell file
  46. specifying where to find everything else.
  47. .IP "errlog"
  48. .Df errlog
  49. .Df files errlog
  50. Error log from \fIrelaynews\fR.
  51. .IP "errlog.o*"
  52. .Df errlog.o*
  53. .Df files errlog.o*
  54. Previous \fIerrlog\fRs.
  55. .IP "explist"
  56. .Df explist
  57. .Df files explist
  58. Control file for \fIexpire\fR, specifying what gets expired, and when,
  59. and what archiving is done.
  60. .IP "history"
  61. .Df history
  62. .Df files history
  63. List of articles currently known at this site, with reception dates and
  64. pathnames.
  65. Updated by \fIrelaynews\fR and \fIexpire\fR.
  66. .IP "history.dir"
  67. .Df history.dir
  68. .Df files history.dir
  69. Part of the \fIdbm\fR index for \fIhistory\fR.
  70. .IP "history.pag"
  71. .Df history.pag
  72. .Df files history.pag
  73. Other part of the \fIdbm\fR index for \fIhistory\fR.
  74. .IP "history.n"
  75. .Df history.n
  76. .Df files history.n
  77. Temporary version of
  78. .I history ,
  79. while
  80. .I expire
  81. is running;
  82. can be left behind if
  83. .I expire
  84. terminates abnormally.
  85. .IP "history.n.dir"
  86. .Df history.n.dir
  87. .Df files history.n.dir
  88. Part of the \fIdbm\fR index for \fIhistory.n\fR.
  89. .IP "history.n.pag"
  90. .Df history.n.pag
  91. .Df files history.n.pag
  92. Other part of the \fIdbm\fR index for \fIhistory.n\fR.
  93. .IP "history.o"
  94. .Df history.o
  95. .Df files history.o
  96. Previous \fIhistory\fR.
  97. Created by \fIexpire\fR.
  98. .IP "localgroups"
  99. .Df localgroups
  100. .Df files localgroups
  101. .Ix checkgroups
  102. List of local groups and descriptions, for use by \fIcheckgroups\fR
  103. control-message handler (which uses it to decide what groups are
  104. legitimate even though the \fIcheckgroups\fR message did not mention them).
  105. Each line is a group name, a tab, and a terse description of the group.
  106. The descriptions are read only by humans.
  107. .IP "log"
  108. .Df log
  109. .Df files log
  110. Log file from \fIrelaynews\fR, reporting what was received and when.
  111. .IP "log.o*"
  112. .Df log.o*
  113. .Df files log.o*
  114. Previous \fIlog\fRs.
  115. .IP "mailname"
  116. .Df mailname
  117. .Df files mailname
  118. .Ix From:
  119. Name of the site for purposes of mail, typically a domainized name.
  120. Used in building ``From:'' lines in newly-posted news.
  121. If not present,
  122. ``\fIhostname\fB.uucp\fR'' is assumed.
  123. .IP "mailpaths"
  124. .Df mailpaths
  125. .Df files mailpaths
  126. Mailing routes for submissions to moderated newsgroups.
  127. .IP "newsgroups"
  128. .Df newsgroups
  129. .Df files newsgroups
  130. .Ix checkgroups
  131. File created by \fIcheckgroups\fR processing,
  132. with names and descriptions
  133. of newsgroups.
  134. For human reading only.
  135. Format identical to that of \fIlocalgroups\fR.
  136. .IP "newsgroups.bac"
  137. .Df newsgroups.bac
  138. .Df files newsgroups.bac
  139. Previous \fInewsgroups\fR file.
  140. Created by \fIcheckgroups\fR processing.
  141. .IP "organization"
  142. .Df organization
  143. .Df files organization
  144. .Ix Organization:
  145. Name of the organization,
  146. for \fIinews\fR's use in creating the \fIOrganization:\fR header
  147. for a posted article.
  148. .IP "postdefltdist"
  149. .Df postdefltdist
  150. .Df files postdefltdist
  151. Default distribution (if any; default ``world'') for \fIpostnews\fR.
  152. .IP "postdefltgroup"
  153. .Df postdefltgroup
  154. .Df files postdefltgroup
  155. Default newsgroup (if any; default is to insist on the user supplying one)
  156. for \fIpostnews\fR.
  157. .IP "replyusepath"
  158. .Df replyusepath
  159. .Df files replyusepath
  160. This file should exist if and only if the local ``mail'' command is
  161. unable to handle `@' addresses,
  162. meaning that replies to control messages (etc.)
  163. must use the ``Path:''
  164. line instead of ``From:''.
  165. The contents are ignored.
  166. .IP "server"
  167. .Df server
  168. .Df files server
  169. Host name of the news server,
  170. where all operations (posting, etc.)
  171. should be done.
  172. If file does not exist,
  173. current host is assumed.
  174. .IP "setnewsids"
  175. .Df setnewsids
  176. .Ix setuid
  177. Set-uid-root program to get user and group ids correct for \fIrelaynews\fR.
  178. Needed only
  179. if the system is old enough to refuse to do \fIsetuid(geteuid())\fR.
  180. Included in NEWSCTL rather than NEWSBIN because its presence is a significant
  181. policy issue for the administrator, i.e. it is, sort of, a control file.
  182. .IP "sys"
  183. .Df sys
  184. .Df files sys
  185. Major control file specifying what groups are legitimate here, and what groups
  186. are fed to other sites.
  187. .IP "watchtime"
  188. .Df watchtime
  189. .Df files watchtime
  190. Last time \fInewswatch\fR was run.
  191. .IP "whoami"
  192. .Df whoami
  193. .Df files whoami
  194. Name of the system for news purposes,
  195. for \fInewshostname\fR.
  196. .Ix newshostname
  197. If file does not exist,
  198. other sources (\fIhostname\fR etc.)
  199. .Ix hostname
  200. are consulted.
  201.