ezmlm-test
Section: User Commands (1)
Index
Return to Main Contents
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- BUGS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 18:00:51 GMT, June 16, 2008