ezmlm-tstdig(1) ezmlm-tstdig(1) NNAAMMEE ezmlm-tstdig - Tests if a digest should be created SSYYNNOOPPSSIISS eezzmmllmm--ttssttddiigg [ --kk _k_b_y_t_e_s ] [ --mm _m_s_g ] [ --tt _t_i_m_e ] _d_i_r eezzmmllmm--ttssttddiigg reads files in the list directory _d_i_r and determines if any of the criteria specified by the options are met. If they are, or if all options specified are 0, eezzmmllmm--ttssttddiigg exits with success (0). Otherwise, eezzmmllmm--ttssttddiigg exits (99), or in case of errors, (100) for permanent and (111) for temporary errors. The normal use of eezzmmllmm--ttssttddiigg is to place it in a script so that eezzmmllmm--ggeett((11)) is executed if eezzmmllmm--ttssttddiigg exists 0, but skipped other- wise. eezzmmllmm--ttssttddiigg uses LOCAL to adapt its behavior so that it can be used from the command line, a script, or from within _d_i_r//eeddiittoorr, or _d_i_r//mmaann-- aaggeerr. If invoked from _d_i_r//eeddiittoorr, the eezzmmllmm--ttssttddiigg line should end in ’|| exit 99’. When used here, eezzmmllmm--ttssttddiigg if digest generation crite- ria are met tests a timestamp in _d_i_r//ttssttddiigg. If _d_i_r//ttssttddiigg is more than 1 hour old or a digest has been successfully created since _d_i_r//ttssttddiigg was written, eezzmmllmm--ttssttddiigg will set the timestamp to the cur- rent time and exit 0. Otherwise it will exit 99. This is to guard against initiating duplicate digests when messages arrive while digest- ing is in progress. OOPPTTIIOONNSS --kk Success if more than _k_b_y_t_e_s of message body has accumulated since the latest digest. --mm Success if more than _m_s_g messages have accumulated since the latest digest. --tt Success if more than _t_i_m_e hours have passed since the latest digest. UUSSAAGGEE This is an example script for ezmlm-tstdig usage. #!/bin/sh #usage: script dir diglist@host #digest if > 64 kbytes message bodies, # > 30 messages, or # > 48 hours since last digest. # ezmlm bin path - modify for your setup EZPATH=’/usr/local/bin/ezmlm’ EZTST="${EZPATH}/ezmlm-tstdig" EZGET="${EZPATH}/ezmlm-get" ${EZTST} -k64 -m30 -t48 "$1" || exit 0 ${EZGET} -t "’$2’" "’$1’" < /dev/null # improve by testing exit status BBUUGGSS Obviously, eezzmmllmm--ttssttddiigg should be integrated into the digesting program so that _d_i_r//ttssttddiigg will not be not necessary. This may be done in the next version. SSEEEE AALLSSOO ezmlm-get(1), ezmlm-make(1), ezmlm-manage(1), ezmlm-send(1), ezmlm(5) ezmlm-tstdig(1)