3 ezmlm-test \- test ezmlm programs
26 is run from the ezmlm build directory. It will test most of the functions
27 of most of the programs in ezmlm-idx>=0.313. The program prints status
28 and error messages to stdout. It requires that qmail runs on the host and that
29 mail delivery to a local user functions. By default, it runs as the
30 user ``eztest'' who should have read and execute permission to the files
31 in the build directory.
33 For testing with an SQL database (requires ezmlm-idx>=0.32; see
35 you need to have first created the tables in the database, e.g. using
37 A number of switches allow overriding the default connection information.
40 creates the list ``eztest-__tstlist@host''
41 in the directory ``~/__TSTDIR''. This directory and ``~/.qmail-__tstlist*''
42 will be overwritten/removed by the program. In addition,
43 the file ``~/__TSTDIR_err'' is created. In cases of error, it often contains
44 the error message form the failing program.
47 should complete without error.
48 As many invocations of the programs test several functions it is not easy
49 to determine what went wrong if
51 fails. Usually, ``~/__TSTDIR__err'' gives some leads, but then debugging
52 of the particular program is required. Usually, this involves recreating
53 the failing circumstances, including environment variables.
57 If SQL support is tested, use
59 as the database, overriding the default ``ezmlm''. See
63 Connect to an SQL server on
65 if an SQL database is used (see
67 Default is empty, which for most database managers defaults to
68 localhost/unix socket. To specify a non-default port,
69 add ``:port'' to the host name.
74 to the SQL server, if an SQL database is used (see
76 By default, it is the same as the executing user as
79 switch or the default ``eztest''.
82 Test assuming qmail>=1.02 and ezmlm-idx>=0.32. Normally, this is auto-detected.
83 This switch is for testing of
85 and unlikely to be generally useful.
88 Test assuming an old (<1.02) version of qmail which does not support
89 the DEFAULT environment variable. Normally, this is auto-detected, and
90 DEFAULT support is used if qmail>=1.02 and ezmlm-idx>=0.32. The ``old''
91 style works with all versions of qmail, but requires adjustments for
92 virtual domains. DEFAULT support makes these adjustments unnecessary.
95 Test with SQL support, and use
97 as the connection password. By default, local databases, rather than an
98 SQL database are used for testing. To use the SQL database with an
99 empty password, specify
107 This can be used to resume execution if the 30 s given for mail delivery
108 was not sufficient for the test message to be delivered. ``9'' can be
109 used to clean up any files remaining after incomplete execution of
111 This option should not be needed.
116 as the table root name for the SQL database tables, if an SQL database
126 Default is ``eztest''. The program refuses to run, unless the effective
127 user name matches this user name.
129 On some systems, some of the tests give a broken pipe error. This is because
130 code needs to be added to the make_message function to capture error messages.
131 These errors can be safely ignored for now.