chiark / gitweb /
Commit 2.4.5-5 as unpacked
[innduct.git] / doc / man / mod-active.8
1 .\" $Revision: 5909 $
2 .TH MOD-ACTIVE 8
3 .SH NAME
4 mod-active \- batch processing of ctlinnd newgroup/rmgroup/changegroup
5 .SH SYNOPSIS
6 .B mod-active
7 [
8 .I ctlinnd_command_file
9 ]
10 .SH DESCRIPTION
11 .B mod-active
12 is a
13 .B perl
14 script that updates the
15 .I active
16 file based on its input lines of ctlinnd newgroup, rmgroup and
17 changegroup commands.  It pauses the server briefly while the existing
18 active file is read and rewritten, which not only keeps
19 .B innd
20 from updating the active file but also locks against other instances
21 of
22 .BR mod-active .
23 .PP
24 The input to
25 .B mod-active
26 can come either from one or more files named on the command line, or
27 from the standard input.  Typically its input is the output from the
28 .B docheckgroups
29 or
30 .B actsync
31 commands.  Every line which contains the string "ctlinnd newgroup",
32 "ctlinnd rmgroup", or "ctlinnd changegroup", optionally preceded by
33 whitespace and/or the path to 
34 .BR ctlinnd ,
35 is noted for the update.  Redundant commands, such as a newgroup
36 directive for a group that already exists, are silently ignored.  All
37 other lines in the input are also silently ignored.
38 .PP
39 After the new 
40 .I active
41 file has been generated, the existing one is renamed to
42 .I active.old
43 and the new one is moved into place.  The script then displays the
44 differences between the two files.
45 .PP
46 Any groups that were added to the
47 .I active
48 file are also added to the
49 .I active.times
50 file with the string "checkgroups-update".
51 .SH BUGS
52 Though
53 .B innd
54 is paused while
55 .B mod-active
56 works, it is not inconceivable that there could be a conflict if
57 something else tries to update the active file during the relatively
58 short time that mod-active is working.  The two most realistic ways I
59 can think of for this to happen are either by an administrator
60 concurrently doing a manual ctlinnd command, or by
61 .B innd 
62 receiving a control message, then
63 .B mod-active
64 pausing the server, then the control message handler script that
65 .B innd
66 forked running its own
67 .B ctlinnd
68 command while
69 .B mod-active
70 is working.
71 I've been using
72 .B mod-active
73 regularly for several years, though, and never had either problem.
74 .SH HISTORY
75 Written by David C Lawrence <tale@isc.org>.
76 .de R$
77 This is revision \\$3, dated \\$4.
78 ..
79 .SH "SEE ALSO"
80 .IR active (5),
81 .IR active.times (5),
82 .IR actsync (8),
83 .IR ctlinnd (8),
84 .IR innd (8).