ezmlm-cron(1) ezmlm-cron(1) NNAAMMEE ezmlm-cron - Sets up digest request messages generation via crond SSYYNNOOPPSSIISS eezzmmllmm--ccrroonn [ --ccCCddDDllLL ][ --ww _d_o_w ][ --tt _h_h_:_m_m ][ --ii _h_r_s ] _l_i_s_t_a_d_r _c_o_d_e_[_f_] DDEESSCCRRIIPPTTIIOONN eezzmmllmm--ccrroonn is a very restrictive interface to ccrroonndd((88)). It edits the effective user’s ~/crontab (see crontab(5)) file. It then executes ccrroonnttaabb((11)) to update crond(8) with the changes. eezzmmllmm--ccrroonn sets up the generation of trigger messages to the list _l_i_s_- _t_a_d_r and the digest code _c_o_d_e. A optional digest format specifier _f can be added to _c_o_d_e. eezzmmllmm--ccrroonn reads _d_i_r//eezzccrroonnrrcc, where _d_i_r is the home directory of the effective user. The first line of this file is the host name, ’host’, to which bounces should be sent. Any bounces for lists set up by ’user’ will go to ’user@host’. Subsequent lines are entries for users made up of: _u_s_e_r_:_l_o_c_a_l_:_h_o_s_t_:_n_u_m_:_[_l_i_s_t_1_[_,_l_i_s_t_2_._._._]_]. The ’:’-separated parame- ters are: _u_s_e_r the user name to which this line corresponds. _l_o_c_a_l the list address must start with exactly these characters (case sensitive). If this field is empty, any list local address is allowed. _h_o_s_t the list host name must exactly match this parameter (case insensitive). If this field is empty, any list host address is allowed. (Host names for the list and the digest list must still match.) _n_u_m the user is permitted a maximum of _n_u_m entries. _l_i_s_t_1 _[_,_l_i_s_t_2_._._._] a set of complete list names separated by commas. The user may edit entries for these lists, even if they do not match the cri- teria set above. If these lists exist, they are counted in determining _n_u_m. No while space is allowed before or between list names. If no list names are specified, the final ’:’ can be omitted. The first line matching the executing user will be used. If eezzmmllmm--ccrroonn is installed SUID _e_u_s_e_r, the configuration and crontab files from that user’s home directory will be used for all eezzmmllmm--ccrroonn actions. This way, users on a system can be given limited ccrroonndd((88)) access via eezzmmllmm--ccrroonn restricted by _d_i_r//eezzccrroonnrrcc and to the generation of digest trigger messages. This is especially useful for users without shell access or access to ccrroonndd((88)). _e_u_s_e_r is usually ’ezmlm’. To install eezzmmllmm--ccrroonn SUID ezmlm: # chown ezmlm /usr/local/bin/ezmlm/ezmlm-cron # chmod 4555 /usr/local/bin/ezmlm/ezmlm-cron eezzmmllmm--ccrroonn refuses to run if installed SUID root. eezzmmllmm--ccrroonn when executed by ’root’, will still use the files in ~root. To allow ccrroonndd((88)) access, you may need to list the effective user (all users allowed access or ~ezmlm if eezzmmllmm--ccrroonn is installed SUID ezmlm) in //eettcc//ccrroonn..aallllooww. See ccrroonnttaabb((11)) for further information. OOPPTTIIOONNSS The --cc, --dd, and --ll switches are mutually exclusive. --cc List user entry from _e_z_c_r_o_n_r_c. --CC (Default.) Do not list user entry. --dd Delete entry. eezzmmllmm--ccrroonn will search _~_e_u_s_e_r//ccrroonnttaabb for an entry belonging to the executing user, permitted by _~_e_u_s_e_r//eezzccrroonnrrcc and matching the command line arguments sup- plied. _c_o_d_e is ignored and may be omitted. --DD (Default.) Do not delete entry. --ii _h_r_s Generate trigger message with _h_r_s hours interval. Accepted intervals are 0, 1 ,2, 3, 6, 12, 24, 48, and 72 hours. Other numbers will be silently adjusted upwards to the nearest accepted interval (intervals above 72 hours will result in weekly trigger messages). --ll List entries. If no other command line arguments are given, eezzmmllmm--ccrroonn lists the entries created in the name of the user. If _l_i_s_t_a_d_r is given, eezzmmllmm--ccrroonn will list the entries for all the matching lists, even if the entries were not set up by the cur- rent user. Arguments, if given, still have to comply with the rules set in _e_z_c_r_o_n_r_c. Crude ccrroonnttaabb((55)) lines are listed. These are taken from the ~/crontab file. Usually, these are active entries, although if the last execution of ccrroonnttaabb((11)) failed, they may not be. --LL (Default.) Do not list entry. --tt _h_h_:_m_m The time for the trigger message. Other trigger messages will be sent _h_r_s hours before and after this time. --ww _d_o_w The days of the week on which trigger messages are sent. day 0 and 7 are Sunday, 1 is Monday, etc (see crontab(5)). The string specified for _d_o_w must consists of single comma-separated digits in the range ’0’-’7’ only. The default is every day, except for _h_r_s of 48 (default Monday, Wednesday, Friday), 72 (default Mon- day and Thursday), or greater than 72 (default Monday). Both _h_r_s and _d_o_w can be specified. In this case, trigger messages are sent on the day specified by _d_o_w at the interval specified by _h_r_s. If _h_r_s is greater than 24 h, it is ignored and trigger messages are generated daily or as specified by _d_o_w. FFIILLEESS _~_e_u_s_e_r_/_e_z_c_r_o_n_r_c The configuration file for eezzmmllmm--ccrroonn. _e_u_s_e_r is the effective user id. This is the executing user, unless eezzmmllmm--ccrroonn is installed SUID _o_t_h_e_r_u_s_e_r, in which case it is _o_t_h_e_r_u_s_e_r. _~_e_u_s_e_r_/_c_r_o_n_t_a_b The file edited by eezzmmllmm--ccrroonn. _e_u_s_e_r is the effective user. _~_e_u_s_e_r_/_c_r_o_n_t_a_b_l The lock file used to assure that only one process at a time is editing the ccrroonndd((88)) settings. _e_u_s_e_r is the effective user. BBUUGGSS eezzmmllmm--ccrroonn should use the output of ’crontab -l’ to list crontab lines, rather than parse the crontab file (and assume that the last execution of ccrroonnttaabb((11)) was successful). SSEEEE AALLSSOO crond(8), crontab(1), crontab(5), ezmlm(5), ezmlm-get(1) ezmlm-cron(1)