view release on metacpan or  search on metacpan

t/data/generate/control-archive/output/thread  view on Meta::CPAN

        [\link[https://archives.eyrie.org/software/\3.tar.xz][tar.xz]
        (\link[https://archives.eyrie.org/software/\3.tar.xz.asc]
              [PGP signature])]]
\==[download] [3]
    [\1 \version[\2]\break
     \link[https://archives.eyrie.org/software/\3.tar.gz][tar.gz]
     (\link[https://archives.eyrie.org/software/\3.tar.gz.asc]
           [signature])\break
     \link[https://archives.eyrie.org/software/\3.tar.xz][tar.xz]
     (\link[https://archives.eyrie.org/software/\3.tar.xz.asc]
           [signature])\break
    Released \release[\2]]

\heading[control-archive][software]

\h1[control-archive]

\quote[

    Usenet is like a herd of performing elephants with diarrhea — massive,
    difficult to redirect, awe-inspiring, entertaining, and a source of
    mind-boggling amounts of excrement when you least expect it.

][Gene Spafford][]

\div(sidebar)[
    \h2[Download]

    \download[control-archive][control-archive]
        [usenet/control-archive-\version[control-archive]]

    \link[https://archives.eyrie.org/software/ARCHIVE/control-archive/]
         [Archive]

    \h2[Documentation]

    \link[readme.html][General overview] \break
    \link[news.html][Change summary] \break
    \link[control-summary.html][control-summary manual page] \break
    \link[export-control.html][export-control manual page] \break
    \link[generate-files.html][generate-files manual page] \break
    \link[process-control.html][process-control manual page] \break
    \link[update-control.html][update-control manual page]

    \h2[Development]

    \link[https://github.com/rra/control-archive]
         [GitHub] \break
    \link[https://github.com/rra/control-archive/issues]
         [Bug tracker] \break
    \link[https://git.eyrie.org/?p=usenet/control.archive.git]
         [Git repository] \break
]

\h2[Blurb]

This software generates an INN control.ctl configuration file from
hierarchy configuration fragments, verifies control messages using GnuPG
where possible, processes new control messages to update a newsgroup list,
archives new control messages, and exports the list of newsgroups in a
format suitable for synchronizing the newsgroup list of a Netnews news
server.  It is the software that maintains the control message and
newsgroup lists available from ftp.isc.org.

\h2[Description]

This package contains three major components:

\bullet[

  All of the configuration used to generate a \code[control.ctl] file for
  INN and the \code[PGPKEYS] and \code[README.html] files distributed with
  pgpcontrol, along with the script to generate those files.

]
\bullet[

  Software to process control messages, verify them against that
  authorization information, and maintain a control message archive and
  list of active newsgroups.  Software is also included to generate
  reports of recent changes to the list of active newsgroups.

]
\bullet[

  The documentation files included in the control message archive and
  newsgroup lists on ftp.isc.org.

]
Manual changes to the canonical newsgroup list are supported in a way that
generates the same log messages and uses the same locking structure so
that they can co-exist with automated changes and be included in the same
reports.

This is the software that generates the
\link[ftp://ftp.isc.org/pub/usenet/CONFIG/][active newsgroup lists] and
\link[ftp://ftp.isc.org/pub/usenet/control/][control message archive]
hosted on ftp.isc.org, and the source of the \code[control.ctl] file
provided with INN.

For a web presentation of the information recorded here, as well as other
useful information about Usenet hierarchies, please see the
\link[http://usenet.trigofacile.com/hierarchies/][list of Usenet managed
hierarchies].

\h2[Requirements]

Perl 5.6 or later plus the following additional Perl modules are required:

\bullet(packed)[Compress::Zlib (included in Perl 5.10 and later)]
\bullet(packed)[Date::Parse (part of TimeDate)]
\bullet(packed)[Net::NNTP (included in Perl 5.8 and later)]
\bullet(packed)[Text::Template]

\link[https://www.gnu.org/software/gzip/][gzip] and
\link[http://www.bzip.org/][bzip2] are required.  Both are generally available
with current operating systems, possibly as supplemental packages.

process-control expects to be fed file names and message IDs of control
messages on standard input and therefore needs to be run from a news
server or some other source of control messages.  A minimalist news server