ezmlm-test(1)

NAME
ezmlm-test - test ezmlm programs

SYNOPSIS
ezmlm-test [ -s subdb ] [ -h host ] [ -u user ] [ -l sqluser ] [ -t sqltable ] [ -d sqldatabase ] [ -p sqlpassword ]

DESCRIPTION
ezmlm-test is run from the ezmlm build directory. It will test most of the functions of most of the programs in ezmlm-idx. The program prints status and error messages to stdout. It requires that qmail runs on the host and that mail delivery to a local user functions. The invoking user should have read and execute permission to the files in the build directory, and write permission in the current directory. For testing with an SQL database, a number of switches allow overriding the default connection information. ezmlm-test creates a test list in the directory ``__TSTDIR'' (in the current directory). This directory and ``dot.qmail-__tstlist*'' will be overwritten/removed by the program. In addition, the file ``__TSTDIR_err'' is created. In cases of error, it often contains the error message from the failing program. ezmlm-test should complete without error. As many invocations of the programs test several functions it is not easy to determine what went wrong if ezmlm-test fails. Usually, ``__TSTDIR__err'' gives some leads, but then debugging of the particular program is required. Usually, this involves recreating the failing circumstances, including environment variables.

OPTIONS

-d sqldatabase
    If SQL support is tested, use sqldatabase as the database, overriding the default ``ezmlm''. See -p.

-h host
    Connect to an SQL server on host, if an SQL database is used (see -p). Default is empty, which for most database managers defaults to localhost/unix socket. To specify a non-default port, add ``:port'' to the host name.

-p sqlpassword
    Test with SQL support, and use sqlpassword as the connection password. By default, local databases, rather than an SQL database are used for testing. To use the SQL database with an empty password, specify -p ''.

-s subdb
    Use the subdb plugin for the subscriber databases.

-t sqltable
    Use sqltable as the table root name for the SQL database tables, if an SQL database is used (see -s). Default is ``list''.

-u sqluser
    Connect as sqluser to the SQL server, if an SQL database is used (see -p). Default is ``eztest''.

BUGS
On some systems, some of the tests give a broken pipe error. This is because code needs to be added to the make_message function to capture error messages. These errors can be safely ignored for now.

SEE ALSO
ezmlm(5), ezmlm-clean(1), ezmlm-gate(1), ezmlm-get(1), ezmlm-idx(1), ezmlm-issubn(1), ezmlm-list(1), ezmlm-make(1), ezmlm-manage(1), ezmlm-moderate(1), ezmlm-request(1), ezmlm-return(1), ezmlm-send(1), ezmlm-split(1), ezmlm-store(1), ezmlm-sub(1), ezmlm-tstdig(1), ezmlm-unsub(1), ezmlm-warn(1)