NAME
    feedlog - log data from an INN feed to a database

SYNOPSIS
    feedlog [-Vhdq] [--conffile *filename*]

REQUIREMENTS
    See "README" in doc.

DESCRIPTION
    This script will log overview data and complete headers to a database
    table for further examination by parsing a feed from INN. It will parse
    that information and write it to a mysql database table in real time.

    All reporting is done to *syslog* via *news* facility. If feedlog fails
    to initiate a database connection at startup, it will log to *syslog*
    with *CRIT* priority and go in an endless loop, trying again to connect
    every 5 seconds, as terminating would only result in a rapid respawn.

  Configuration
    feedlog will read its configuration from newsstats.conf which should be
    present in etc/ via Config::Auto or from a configuration file submitted
    by the --conffile option.

    See "INSTALL" in doc for an overview of possible configuration options.

OPTIONS
    -V, --version
       Display version and copyright information and exit.

    -h, --help
       Display this man page and exit.

    -d, --debug
       Print debugging information to STDERR while parsing STDIN. You'll
       find that information most probably in your INN errlog file.

    -q, --quiet
       Suppress logging to syslog.

    --conffile *filename*
       Read configuration from *filename* instead of newsstats.conf.

INSTALLATION
    See "INSTALL" in doc.

EXAMPLES
    Set up a feed like that in your INN newsfeeds file:

        ## gather statistics for NewsStats
        newsstats!
                :!*,de.*
                :Tc,WmtfbsPNH,Ac:/path/to/feedlog.pl

    See "INSTALL" in doc for further information.

FILES
    bin/feedlog.pl
        The script itself.

    lib/NewsStats.pm
        Library functions for the NewsStats package.

    etc/newsstats.conf
        Runtime configuration file.

BUGS
    Please report any bugs or feature requests to the author or use the bug
    tracker at <https://code.virtcomm.de/thh/newsstats/issues>!

SEE ALSO
    - "README" in doc

    - "INSTALL" in doc

    This script is part of the NewsStats package.

AUTHOR
    Thomas Hochstein <thh@thh.name>

COPYRIGHT AND LICENSE
    Copyright (c) 2010-2013 Thomas Hochstein <thh@thh.name>

    This program is free software; you may redistribute it and/or modify it
    under the same terms as Perl itself.

