mod-active(8) [suse man page]

MOD-ACTIVE(8)						    InterNetNews Documentation						     MOD-ACTIVE(8)

NAME

       mod-active - Batch processing of newsgroups creation and removal commands

SYNOPSIS

       mod-active [ctlinnd-command-file ...]

DESCRIPTION

       mod-active is a Perl script that updates the active file based on its input lines of ctlinnd "newgroup", "rmgroup" and "changegroup"
       commands.  It pauses the server briefly while the existing active file is read and rewritten, which not only keeps innd from updating the
       active file but also locks against other instances of mod-active.

       The script must be run as the news user.

       The input to mod-active can come either from one or more ctlinnd-command-file files named on the command line, or from the standard input.
       Typically its input is the output from the docheckgroups or actsync commands.  Every line which contains the string "ctlinnd newgroup",
       "ctlinnd rmgroup", or "ctlinnd changegroup", optionally preceded by whitespace and/or the path to ctlinnd, is noted for the update.
       Redundant commands, such as a newgroup directive for a group that already exists, are silently ignored.	All other lines in the input are
       also silently ignored.  After the new active file has been generated, the existing one is renamed to active.old and the new one is moved
       into place.  The script then displays the differences between the two files.  Any groups that were added to the active file are also added
       to the active.times file with the string "checkgroups-update".

       Please note that no syntax checking is performed on group names by mod-active.

BUGS

       Though innd is paused while mod-active works, it is not inconceivable that there could be a conflict if something else tries to update the
       active file during the relatively short time that mod-active is working.  The two most realistic ways for this to happen are either by an
       administrator concurrently doing a manual ctlinnd command, or by innd receiving a control message, then mod-active pausing the server, then
       the control message handler script that innd forked running its own ctlinnd command while mod-active is working.  Note that such scenarios
       are very unlikely to happen.

HISTORY

       Written by David C Lawrence <tale@isc.org> for InterNetNews.  Converted to POD by Julien Elie.

SEE ALSO

       active(5), active.times(5), actsync(8), ctlinnd(8), docheckgroups(8), innd(8).

INN 2.5.2							    2009-05-21							     MOD-ACTIVE(8)

MAKEACTIVE(8)						      System Manager's Manual						     MAKEACTIVE(8)

NAME

       makeactive - tool to recover Usenet active file.

SYNOPSIS

       makeactive [ -m ] [ -o ]

DESCRIPTION

       Makeactive  invokes  find(1)  to  get  a  list  of  all directories in the news spool tree, /var/spool/news.  It discards directories named
       lost+found as well as those that have a period in them.	It scans all other directories for all-numeric filenames and determines the  high-
       est  and lowest number.	The program's output is a set of active(5) file lines.	Because there is no way to know if a group is moderated or
       disabled, the fourth field of all entries will be y.  Also, mid-level directories that aren't newsgroups will also  created  as	newsgroups
       with no entries (for example, there is a ``comp.sources.unix'' group, but no ``comp.sources'').

OPTIONS

       -m     If  the  ``-m''  flag is given, then makeactive will attempt to adjust the highest and lowest article numbers wherever possible.	If
	      articles are found in a newsgroup, the numbers will reflect what what was found.	If no articles are found in a newsgroup, the  high
	      number  from the old file will be kept, and the low number will be set to one more then the high number.	This flag may only be used
	      if the ``-o'' flag is used.

       -o     If the ``-o'' flag is used, makeactive will read an existing active file for the list of group names and just renumber  all  groups.
	      It  will	preserve the fourth field of the active file if one is present.  This is analogous to the ctlinnd(8) ``renumber'' command,
	      except that innd(8) should throttled or not running.  Do not use this flag with output redirected to the standard active file!

EXIT STATUS

       Makeactive exits with non-zero status if any problems occurred.

EXAMPLES

       A typical way to use the program is with the following /bin/sh commands:
	      ctlinnd throttle "Rebuilding active file"
	      TEMP=${TMPDIR-/var/spool/news/in.coming/tmp}/act$$
	      if [ -f /var/lib/news/active ] ; then
		  if makeactive -o >${TEMP} ; then
		      mv ${TEMP} /var/lib/news/active
		  fi
	      else
		  if makeactive >${TEMP} ; then
		      # Edit to restore moderated
		      # and aliased groups.
		      ...
		      mv ${TEMP} /var/lib/news/active
		  fi
	      fi
	      ctlinnd reload active "New active file"
	      ctlinnd go ''

HISTORY

       Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is revision 1.3, dated 1996/10/29.

SEE ALSO

       active(5), ctlinnd(8), dbz(3), filechan(8), history(5), innd(8), newsfeeds(5), makehistory(8), newsrequeue(8).

																     MAKEACTIVE(8)