ezmlm-test
Section: User Commands (1)
Index
Return to Main Contents
NAME
ezmlm-test - test ezmlm programs
SYNOPSIS
ezmlm-test
[
-h host
][
-u user
][
-l sqluser
][
-t sqltable
][
-d sqldatabase
][
-p sqlpassword
][
-s section
]
dir
DESCRIPTION
ezmlm-test
is run from the ezmlm build directory. It will test most of the functions
of most of the programs in ezmlmx. 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. By default, it runs as the
user ``eztest'' who should have read and execute permission to the files
in the build directory.
For testing with an SQL database; see
-p),
you need to have first created the tables in the database, e.g. using
ezmlm-mktab.
A number of switches allow overriding the default connection information.
ezmlm-test
creates the list ``eztest-__tstlist@host''
in the directory ``~/__TSTDIR''. This directory and ``~/.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 form 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.
- -l sqluser
-
Connect as
sqluser
to the SQL server, if an SQL database is used (see
-p).
By default, it is the same as the executing user as
specified by the
-u
switch or the default ``eztest''.
- -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 section
-
Restart
ezmlm-test
from section
section.
This can be used to resume execution if the 30 s given for mail delivery
was not sufficient for the test message to be delivered. ``9'' can be
used to clean up any files remaining after incomplete execution of
ezmlm-test.
This option should not be needed.
- -t sqltable
-
Use
sqltable
as the table root name for the SQL database tables, if an SQL database
is used (see
-p).
Default is ``list''.
- -u user
-
Execute
ezmlm-test
as
user.
Default is ``eztest''. The program refuses to run, unless the effective
user name matches this user name.
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-mktab(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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- BUGS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 11:12:50 GMT, July 10, 2025