3 news.daily \- do regular Usenet system administration
12 performs a number of important Usenet administrative functions.
13 This includes producing a status report, removing old news articles,
14 processing log files, rotating the archived log files, renumbering the
16 removing any old socket files found in the
17 .I <pathrun in inn.conf>
18 directory, and collecting the output.
19 .I "This program should be run under the news administrator's id, not as root."
23 performs all of its functions and mails the output to the news administrator,
24 .IR <USER\ specified\ with\ \-\-with\-news\-master\ at\ configure> .
25 By specifying ``keywords'' on the command line, it is possible to
26 modify the functions performed, as well as change the arguments given to
32 should be run once a day, typically out of
34 It may be run more often, but such invocations should at least use the
35 \&``norotate'' keyword (or perhaps the \&``notdaily'' keyword) to
36 prevent the log files from being processed and rotated too fast.
40 program is used to prevent simultaneous executions.
43 The following keywords may be used:
46 This uses the ``\fB\-z\fP'' flag when invoking
50 The names of articles to be removed are written to a temporary file, and
51 then renamed after expiration by calling
55 Specify the file to use as the
65 file and database in the same directory as the current files.
66 Using this keyword specifies a different local to build the new files
67 (by passing the ``\fB\-d\fP'' flag to
69 which will then be moved to the right location when finished.
72 This keyword disables the status report generated by
76 Without this keyword, the status report is the first function performed,
77 just prior to obtaining the
84 expects to be run only once a day, and it does
85 various things (like rotating logs) that normally should only be done on
86 daily basis. Use this keyword any extra times
89 day and the normal logfile processing (and rotation) will not be done.
94 is invoked to remove old news articles.
95 Using this keyword disables this function.
100 is invoked to remove old overview database, if
104 Using this keyword disables this function.
108 normally appends information to
109 .I <pathlog in inn.conf>/expire.log
112 Using this keyword causes the
114 output to be handled as part of
117 It has no effect if the ``noexpire'' keyword is used.
119 .IR flags= "'args\ for\ expire'"
122 is invoked with argument ``\-v1''.
123 Using this keyword changes the arguments to those specified.
124 Be careful to use quotes if multiple arguments are needed.
125 This keyword has no effect if the ``noexpire'' keyword is used.
130 is invoked to process the log files.
131 Using this keyword disables all log processing functions.
134 By default, log processing includes rotating and cleaning out log files.
135 Using this keyword disables the rotating and cleaning aspect of the log
136 processing: the logs files are only scanned for information and no contents
139 This keyword has no effect if the ``nologs'' keyword is used.
140 The ``norotate'' keyword is passed on to
145 This keyword disables the
148 Normally, the low-water marks for all newsgroups (see
153 By default, any socket
155 socket that has not been modified for two days will be removed.
156 Using this keyword disables this function.
160 normally sends a mail message containing the results to the administrator.
161 Using this keyword causes this message to be sent to stdout and stderr instead.
162 Normally, all utilities invoked by the script have their stdout and stderr
163 redirected into a file.
164 If the file is empty, no message is sent.
169 program is called after expiration to purge the overview databases.
170 If no overview data is created, the ``expireover''
171 keyword is not needed. This is the case that the server runs only for
174 .IR expireoverflags= "'args\ for\ expireover'"
175 If the ``expireover'' keyword is used, this keyword may be used to specify
176 the flags to be passed to
178 If the ``delayrm'' keyword is used, then the default value is ``\-z''
179 and the list of deleted files; otherwise, the default value is ``\-s''.
182 The program specified by the given path is executed just before any
184 A typical use is to specify an alternate expiration program and use the
185 \&``noexpire'' keyword.
186 Multiple programs may be specified; they will be invoked in order.
188 .IR postexec= "'post executed program'"
189 The program specified by the given path is executed just after all
191 Multiple programs may be specified; they will be invoked in order.
194 If the ``lowmark'' keyword is used,
196 lowmark is used for renumbering
200 renumber operation will take long time. With ``lowmark'' keyword this will
202 If the ``lowmark'' keyword is used,
203 \&``norenumber'' keyword is not needed, since
205 specifies it implicitly.
208 Sets the environment variable TMPDIR to the specified path.
209 Various parts of the expire process, such as sort, will then use this
210 path as the directory for temporary files.
213 and this manual page written by Landon Curt Noll <chongo@toad.com> and
214 Rich $alz <rsalz@uunet.uu.net>.
216 This is revision \\$3, dated \\$4.
218 .R$ $Id: news.daily.8 6398 2003-07-12 19:15:50Z rra $