.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ACTIVE 5" .TH ACTIVE 5 "2022-07-10" "INN 2.7.2" "InterNetNews Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" active \- List of newsgroups carried by the server .SH "DESCRIPTION" .IX Header "DESCRIPTION" The file \fIpathdb\fR/active lists the newsgroups carried by \s-1INN.\s0 This file is generally maintained using \fBctlinnd\fR\|(8) to create and remove groups, or by letting \fBcontrolchan\fR\|(8) do so on the basis of received control messages; this file is then updated and a backup stored in \fIpathdb\fR/active.old. Note that the \fBnewsgroups\fR\|(5) file normally contains the descriptions of the newsgroups carried by the news server. .PP The \fIactive\fR file should not be edited directly without throttling \fBinnd\fR, and must be reloaded using \fBctlinnd\fR before \fBinnd\fR is unthrottled. Editing it directly even with those precautions may make it inconsistent with the overview database and won't update \fIactive.times\fR, so \fBctlinnd\fR should be used to make modifications whenever possible. .PP Each newsgroup should be listed only once. Each line specifies one group. The order of groups does not matter. Within each newsgroup, received articles for that group are assigned monotonically increasing numbers as unique names. If an article is posted to newsgroups not mentioned in this file, those newsgroups are ignored. .PP If none of the newsgroups listed in the Newsgroups header field body of an article are present in this file, the article is either rejected (if \fIwanttrash\fR is false in \fIinn.conf\fR), or is filed into the newsgroup \&\f(CW\*(C`junk\*(C'\fR and, when \f(CW\*(C`Aj\*(C'\fR is not set in the \fInewsfeeds\fR feed pattern, only propagated to sites that receive the \f(CW\*(C`junk\*(C'\fR newsgroup (if \fIwanttrash\fR is true). .PP Each line of this file consists of four fields separated by a space: .PP .Vb 1 \& .Ve .PP The first field is the name of the newsgroup. The newsgroup \f(CW\*(C`junk\*(C'\fR is special, as mentioned above. The newsgroup \f(CW\*(C`control\*(C'\fR and any newsgroups beginning with \f(CW\*(C`control.\*(C'\fR are also special; control messages are filed into a control.* newsgroup named after the type of control message if that group exists, and otherwise are filed into the newsgroup \f(CW\*(C`control\*(C'\fR (without regard to what newsgroups are listed in the Newsgroups header field body). If \fImergetogroups\fR is set to true in \fIinn.conf\fR, newsgroups that begin with \f(CW\*(C`to.\*(C'\fR are also treated specially; see \&\fBinnd\fR\|(8). .PP The second field is the highest article number that has been used in that newsgroup. The third field is the lowest article number in the group; this number is not guaranteed to be accurate, and should only be taken to be a hint. It is normally updated nightly as part of the expire process; see \fBnews.daily\fR\|(8) and look for \f(CW\*(C`lowmark\*(C'\fR or \f(CW\*(C`renumber\*(C'\fR for more details. Note that because of article cancellations, there may be gaps in the numbering sequence. If the lowest article number is greater than the highest article number, then there are no articles in the newsgroup. In order to make it possible to update an entry in-place without rewriting the entire file, the second and third fields are padded out with leading zeros to make them a fixed width. .PP The fourth field contains one of the following status: .PP .Vb 6 \& y Local postings and articles from peers are allowed. \& m The group is moderated and all postings must be approved. \& n No local postings are allowed, only articles from peers. \& j Articles from peers are filed in the junk group instead. \& x No local postings, and articles from peers are ignored. \& =foo.bar Articles are filed in the group foo.bar instead. .Ve .PP If a newsgroup has the \f(CW\*(C`j\*(C'\fR status, no articles will be filed in that newsgroup. Local postings are not accepted; if an article for that newsgroup is received from a remote site, and if it is not crossposted to some other valid group, it will be filed into the \f(CW\*(C`junk\*(C'\fR newsgroup instead. This is different than simply not listing the group, since the article will still be accepted and can be propagated to other sites, and the \f(CW\*(C`junk\*(C'\fR group can be made available to readers if wished. .PP If the field begins with an equal sign, the newsgroup is an alias. Articles cannot be posted to that newsgroup, but they can be received from other sites. Any articles received from peers for that newsgroup are treated as if they were actually posted to the group named after the equal sign. Note that the Newsgroups header field of the articles is not modified. (Alias groups are typically used during a transition and are typically created manually with \fBctlinnd\fR\|(8).) An alias should not point to another alias. .PP Note that \fIreaders.conf\fR can be configured so that local posts to newsgroups with status \f(CW\*(C`j\*(C'\fR, \f(CW\*(C`n\*(C'\fR or \f(CW\*(C`x\*(C'\fR are accepted. .SH "MINIMAL ACTIVE FILE" .IX Header "MINIMAL ACTIVE FILE" For \fBinnd\fR to be able to start, the three groups \f(CW\*(C`control\*(C'\fR, \&\f(CW\*(C`control.cancel\*(C'\fR and \f(CW\*(C`junk\*(C'\fR need to be in the \fIactive\fR file. Besides, if \fImergetogroups\fR is set to true in \fIinn.conf\fR, the newsgroup \f(CW\*(C`to\*(C'\fR also needs to exist. .PP The minimal \fIactive\fR file shipped with \s-1INN\s0 is: .PP .Vb 6 \& control 0000000000 0000000001 n \& control.cancel 0000000000 0000000001 n \& control.checkgroups 0000000000 0000000001 n \& control.newgroup 0000000000 0000000001 n \& control.rmgroup 0000000000 0000000001 n \& junk 0000000000 0000000001 n .Ve .PP (Note that the second and the third field may differ if the news server has already been in use.) .PP There are more control.* pseudogroups here than needed by \fBinnd\fR to start; the corresponding control messages will be filed into them. The \f(CW\*(C`n\*(C'\fR status is so that users cannot post directly to these groups (control messages should only be posted to the groups that they affect). If you do not want these groups to be visible to clients, do not delete them but simply hide them in \fBreaders.conf\fR\|(5). .PP To create additional groups after the server is running, you can use \&\f(CW\*(C`ctlinnd newgroup\*(C'\fR. You can also synchronize your newsgroup list to that of another server by using \fBactsync\fR\|(8) or get the \fIactive\fR file of another \s-1NNTP\s0 server with \fBgetlist\fR\|(1). And do not forget to update your \fInewsgroups\fR file, which can be automatically done thanks to \&\fBdocheckgroups\fR called with the \fB\-u\fR flag. .SH "HISTORY" .IX Header "HISTORY" Written by Rich \f(CW$alz\fR for InterNetNews. Converted to \&\s-1POD\s0 by Russ Allbery . .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBactive.times\fR\|(5), \fBactsync\fR\|(8), \fBcontrolchan\fR\|(8), \fBctlinnd\fR\|(8), \fBdocheckgroups\fR\|(8), \&\fBgetlist\fR\|(1), \fBinn.conf\fR\|(5), \fBinnd\fR\|(8), \fBmod\-active\fR\|(8), \fBnews.daily\fR\|(8), \fBnewsgroups\fR\|(5), \&\fBreaders.conf\fR\|(5).