3 newslog \- description of Usenet log files
5 Most log files created by Usenet programs reside in the
6 .I <pathlog in inn.conf>
7 directory and have a ``.log'' extension.
8 Several versions are usually kept with an additional extension such as ``.1'',
9 ``.2'', etc. \(em the higher the number, the older the log.
10 The older versions may be compressed and thus may have a ``.1.gz'',
11 ``.2.gz'', etc. extension.
15 script and related utilities (see
17 are responsible for rotating and compressing these files.
19 Some log files always have data, others only have data if there is a
20 problem, and others are only created if a particular program is used
21 or configuration parameter is set.
26 monitors the size of all log files.
28 The following files will only accumulate data under the direction of
39 In order to create these files, the ``message'' and ``action'' fields of
41 should be chosen from the following table:
45 .ta \w'newgroup 'u +\w'doit=newgroup 'u
46 Message Action Meaning
47 all log=miscctl Log all messages by default
48 default log=miscctl Log unknown messages
49 newgroup doit=newgroup Create group and log message
50 newgroup log=newgroup Log message
51 rmgroup doit=rmgroup Remove group and log message
52 rmgroup log=rmgroup Log message
53 ``other'' doit=miscctl log and process the message
54 ``other'' log=miscctl Log message
58 Here, ``other'' refers to any other control message such as:
71 The following is a list of log files:
74 This file maintains a count of the number of newgroup and rmgroup control
75 messages seen for each newsgroup.
76 The count is of the number of control messages with the indicated
77 arguments, regardless if they were actually processed.
78 All control arguments, including invalid ones, are counted.
79 This file is updated by
83 if either the newgroup or rmgroup logs exist.
84 This file is not rotated.
87 This file contains the standard output and standard error of any program
90 such as channel feeds configured in
92 This file should normally be empty.
94 will print the entire contents of this log file if it is non-empty.
99 is going to expire old news articles, it writes the date to this file,
100 followed by any output from
103 All lines but the first are indented four spaces.
108 is configured as described above, all control messages except newgroup
109 and rmgroup are appended to this file by
111 There will be a summary line describing the message and the action
112 taken, followed by the article indented by four spaces, and a blank line.
117 is configured as described above, all newgroup messages are appended
118 to this file using the same format as for
122 This file logs articles received by
125 summarizes the rejected articles reported in this file.
128 All critical error messages issued by
130 are appended to this file via
132 This log file should be empty.
134 will print the entire contents of this log file if it is non-empty.
135 You should have the following line in your system
137 file, using a tab character for the delimiter:
141 news.crit <pathlog in inn.conf>/news.crit
145 (A typical entry is shown; it should agree with
146 .I <pathlog in inn.conf>.)
149 All major error messages issued by
151 are appended to this file via
153 This log file should be empty.
155 will print the entire contents of this log file if it is non-empty.
156 You should have the following line in your system
158 file, using a tab character for the delimiter:
162 news.err <pathlog in inn.conf>/news.err
166 (A typical entry is shown; it should agree with
167 .I <pathlog in inn.conf>.)
170 All standard error messages and status messages issued by
172 are appended to this file via
179 to summarize this file.
180 You should have the following line in your system
182 file, using a tab character for the delimiter:
186 news.notice <pathlog in inn.conf>/news.notice
189 (A typical entry is shown; it should agree with
190 .I <pathlog in inn.conf>.)
195 programs appends all status messages to this file.
200 is configured as described above, all rmgroup messages are appended to this
201 file using the same format as for
205 This log maintains a count of the number of articles that were rejected
206 because they were posted to newsgroups that do not exist at the local site.
207 This file is updated by
209 and maintained in reverse numeric order (the most popular rejected group
211 This file is not rotated.
213 Written by Landon Curt Noll <chongo@toad.com> and Rich $alz
214 <rsalz@uunet.uu.net> for InterNetNews.
216 This is revision \\$3, dated \\$4.
218 .R$ $Id: newslog.5 6398 2003-07-12 19:15:50Z rra $