ezmlm-test(1) ezmlm-test(1) NNAAMMEE ezmlm-test - test ezmlm programs SSYYNNOOPPSSIISS eezzmmllmm--tteesstt [ --oonn ][ --hh _h_o_s_t ][ --uu _u_s_e_r ][ --ll _s_q_l_u_s_e_r ][ --tt _s_q_l_t_a_b_l_e ][ --dd _s_q_l_d_a_t_a_b_a_s_e ][ --pp _s_q_l_p_a_s_s_w_o_r_d ][ --ss _s_e_c_t_i_o_n ] _d_i_r DDEESSCCRRIIPPTTIIOONN eezzmmllmm--tteesstt is run from the ezmlm build directory. It will test most of the functions of most of the programs in ezmlm-idx>=0.313. 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 exe- cute permission to the files in the build directory. For testing with an SQL database (requires ezmlm-idx>=0.32; see --pp), you need to have first created the tables in the database, e.g. using eezzmmllmm--mmkkttaabb. A number of switches allow overriding the default connec- tion information. eezzmmllmm--tteesstt 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 ‘‘~/__TST- DIR_err’’ is created. In cases of error, it often contains the error message form the failing program. eezzmmllmm--tteesstt should complete without error. As many invocations of the programs test several functions it is not easy to determine what went wrong if eezzmmllmm--tteesstt fails. Usually, ‘‘~/__TSTDIR__err’’ gives some leads, but then debugging of the particular program is required. Usu- ally, this involves recreating the failing circumstances, including environment variables. OOPPTTIIOONNSS --dd _s_q_l_d_a_t_a_b_a_s_e If SQL support is tested, use _s_q_l_d_a_t_a_b_a_s_e as the database, over- riding the default ‘‘ezmlm’’. See --pp. --hh _h_o_s_t Connect to an SQL server on _h_o_s_t, if an SQL database is used (see --pp). 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. --ll _s_q_l_u_s_e_r Connect as _s_q_l_u_s_e_r to the SQL server, if an SQL database is used (see --pp). By default, it is the same as the executing user as specified by the --uu switch or the default ‘‘eztest’’. --nn Test assuming qmail>=1.02 and ezmlm-idx>=0.32. Normally, this is auto-detected. This switch is for testing of eezzmmllmm--tteesstt and unlikely to be generally useful. --oo Test assuming an old (<1.02) version of qmail which does not support the DEFAULT environment variable. Normally, this is auto-detected, and DEFAULT support is used if qmail>=1.02 and ezmlm-idx>=0.32. The ‘‘old’’ style works with all versions of qmail, but requires adjustments for virtual domains. DEFAULT support makes these adjustments unnecessary. --pp _s_q_l_p_a_s_s_w_o_r_d Test with SQL support, and use _s_q_l_p_a_s_s_w_o_r_d 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 --pp ’’’’. --ss _s_e_c_t_i_o_n Restart eezzmmllmm--tteesstt from section _s_e_c_t_i_o_n. 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 eezzmmllmm--tteesstt. This option should not be needed. --tt _s_q_l_t_a_b_l_e Use _s_q_l_t_a_b_l_e as the table root name for the SQL database tables, if an SQL database is used (see --pp). Default is ‘‘list’’. --uu _u_s_e_r Execute eezzmmllmm--tteesstt as _u_s_e_r. Default is ‘‘eztest’’. The program refuses to run, unless the effective user name matches this user name. BBUUGGSS 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. SSEEEE AALLSSOO 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) ezmlm-test(1)