NAME

sendd - Flush glist's Mailinglist Spool

SYNOPSIS

        Run from crontab:

        00-59 * * * * /path/to/sendd -s

        Or in daemon mode:

        /path/to/sendd -D -t time_to_sleep

COMMAND LINE SWITCHES AND OPTIONS

        Usage: sendd [-v] [-n] {-D [-t time_to_sleep]|-s}

-D

        Run the program in daemon mode.

-t

        Time (in seconds) which we'll be sleeping
        between each run. (only in deamon mode)

-s

        Run once and exit.

-v

        Give verbose error and info messages in logging

-n

        Debug mode. Don't really send mail and do not
        delete the queue file.

DESCRIPTION

        Sendd is the program that flushes glist's mailinglist spool.

        It checks for files in the PREFIX/spool/outgoing directory.
        For each file it finds it will:

        1. Move the file to the PREFIX/spool/send directory.
        2. Parse the file and generate the headers
        3. Connect to the DB in the X-DB_Server and X-Database headers
           and get the e-mail addresses from the push list id X-Push_list_id
           or get the files from the mailinglist file (if the mailinglist type is file)
        4. Generate Bcc/Resent-bcc information in correct format from the list of
           approved e-mail addresses.
        5. Send the mail if it finds all required headers
        6. If the mail was send successfully; delete the message file.

        If the message couldn't be parsed it will be moved to the defer directory,
        which is PREFIX/spool/deferred.

CONFIGURATION

        Configuration is done in the script it self.
        Thogh this is preferred to be changed in the Makefile,
        this can be done in the script as well.

        In the first lines of sendd you can configure the following variables:

PREFIX

        Sendd's prefix path.

SENDMAIL

        The full path to the sendmail program, with options.
        (usually sendmail -t)

USE_SQL

        Set to db2 or pgsql. Defines if the DBI and DBD::Pg/DBD::DB2 modules should be used,
        and postgresql/db2 support is implemented.

FILES

PREFIX/etc/glist.passwd

        The database of passwords.
        This file has the following format:

        servername:dbname:user:pass

        NOTE: This must only be readable by the uid sendd runs as.
        Please also note that it's generally a bad idea to run
        sendd as root.  

Message files in PREFIX/spool/outgoing

        Each message file should be like this:

        Header part
        <empty line>
        Body Part

        The following headers are required:

        From            - The sender of the message
        To              - The recipient of the message
        Subject         - The subject of the message

        The following headers are optional depending if the list
        is sql or file based:

        X-DB_Server     - The database server we should connect to
        X-Database      - The database we should use on the server
        X-Push_list_id  - The id of the member list to use
        X-File          - The file containing the recipients
        

REQUIREMENTS

Perl 5

        Maybe even Perl 5.6?

POSIX

        Should be in the standard perl distribution.

Getopt:Std

        Should be in the standard perl distribution.

File::Copy

        Should be in the standard perl distribution.

DBI

        The CPAN module can install this for you:

        # perl -MCPAN -e shell
        cpan> install DBI

DBD::Pg

        The CPAN module can install this for you:

        # export POSTGRES_INCLUDE=/path/to/postgres/include
        # export POSTGRES_LIB=/path/to/postgres/lib
        # perl -MCPAN -e shell
        cpan> install DBD::Pg

Postfix / Sendmail

        http://www.postfix.org
        http://www.sendmail.org

VERSION

        This is version 1.00, derived from listspoold 1.00

TODO

        * If somehow (despite the locking check) the daemon manages to run twice,
        the message can in some rare conditions be sent twice.

        This can be fixed by adding another queue where the message will be moved
        as soon as it is found by the daemon. Actions after this will be done
        with the file in the new directory.

        This is done in version listspoold 1.00

BUGS

        None known as of this date :)

HISTORY

        This is an glist implementation of listspool version 1.0

AUTHOR

        Ask Solem Hoel <ask@unixmonks.net>, http://www.unixmonks.net