ezmlm-store(1) ezmlm-store(1) NNAAMMEE ezmlm-store - store messages posted to a moderated lists and send mod- eration requests to the moderator(s). SSYYNNOOPPSSIISS eezzmmllmm--ssttoorree [[--bbBBccCCmmMMppPPrrRRssSSvvVV]] _d_i_r DDEESSCCRRIIPPTTIIOONN eezzmmllmm--ssttoorree reads a mail message and stores it in _d_i_r//mmoodd//ppeennddiinngg//.. eezzmmllmm--ssttoorree also sends a moderation request with a copy of the message to the list of moderators stored in _d_i_r//mmoodd//ssuubbssccrriibbeerrss//.. If _d_i_r//mmoodd-- ppoosstt contains a directory name, _m_o_d_d_i_r, with a leading forward slash, the moderator list in _/_m_o_d_d_i_r_/_s_u_b_s_c_r_i_b_e_r_s_/ is used instead. This allows separate sets of moderators for subscription and message moderation, as well as the use of the same moderator list for several eezzmmllmm mailing lists, owned by the same user. If the --ss switch is used, the moderators are divided into two sets. Those pointed to by _d_i_r//mmooddppoosstt which will receive confirmation requests for posts with their SENDER address, and those stored with the base directory _d_i_r//mmoodd// which will receive moder- ation requests for messages posted from SENDERs not part of the first group. This can be used to have a set of trusted users (‘‘moderating’’ themselves to thwart SENDER faking), and a set of more traditional mod- erators, which receive approval requests for other posts. NNoottee:: The contents of _d_i_r//mmooddppoosstt do not affect the location of the message moderation queue. If SENDER is a moderator, the request is sent to that moderator only. The moderation request includes cookies for message rejection and acceptance. The moderator can take either action by replying to the appropriate address. For moderator convenience, the _a_c_c_e_p_t address is given in the ‘‘Reply-To:’’ header, and the _r_e_j_e_c_t address in the ‘‘From:’’ header. If the list is set up with remote administration and the sender is not a moderator, the ‘‘Cc:’’ header will contain a confirmation address to add the sender to the ‘‘allow’’ database. This allows the moderator to both approve the post and add the sender to the list of accepted posters by replying to ‘‘all’’. The (default) subject of all message moderation requests is MMOODDEERRAATTEE ffoorr _l_i_s_t_n_a_m_e_@_h_o_s_t_. Once the request has been successfully sent to the moderators, eezzmmllmm-- ssttoorree sets the owner-execute bit of the message in _d_i_r//mmoodd//ppeennddiinngg//.. Messages without this bit set are the result of incomplete executions of eezzmmllmm--ssttoorree and are ignored. At the beginning of the message, eezzmmllmm--ssttoorree prints a new MMaaiilliinngg--LLiisstt field with the contents of _d_i_r//mmaaiilliinngglliisstt. It rejects the message if there is already a MMaaiilliinngg--LLiisstt field. eezzmmllmm--ssttoorree does not distribute bounce messages: if the environment variable SSEENNDDEERR is set, and is either empty or ##@@[[]], eezzmmllmm--ssttoorree rejects the message. OOPPTTIIOONNSS --bb (Default.) With the moderation request, send both headers and body of the message to be moderated. --BB With the moderation request, send header, but not body of the message to be moderated. This may be useful if moderation is used to allow one or a few poorly connected addresses to post, and posts are very large (e.g. when the list is used as a dis- tribution channel of e.g. catalogs). --ccCCrrRR Passed on to eezzmmllmm--sseenndd((11)) in case this program is executed. This happens only if _d_i_r//mmooddppoosstt does not exist. --mm (Default.) The post is sent as a MIME enclosure. --MM The post is appended to the message. --ss The contents of _d_i_r//mmooddppoosstt with the default _d_i_r//mmoodd// are used as the base directory for self-approving users, whereas _d_i_r//mmoodd// is used as the base directory for the moderators to whom approval requests for other posts are sent. --SS (Default.) The contents of _d_i_r//mmooddppoosstt with the default _d_i_r//mmoodd// are used as the base directory for the moderators for all moderator functions. --pp (Default.) Anyone can post. Posts that are not from a moderator are sent out to all moderators for approval. Posts that are from a moderator are sent only to that moderator. --PP Only moderators can post. Those posts are sent to the posting moderator for approval. Posts from other addresses are bounced. This can be used to relatively securely restrict posts to mes- sages originating from a given set of addresses. --vv Display eezzmmllmm--mmaannaaggee version information. --VV Display eezzmmllmm--mmaannaaggee version information. UUSSAAGGEE First of all, remember that eezzmmllmm--ssttoorree will simply execute eezzmmllmm-- sseenndd((11)) unless _d_i_r//mmooddppoosstt exists. For the switches, use --PP for lists where only moderators can post securely, i.e. they are asked to approve their own posts after posting, whereas other SENDERs are rejected. For low-security more convenient versions of this type of restriction, see eezzmmllmm--ggaattee((11)). Normally (no switches), posts from moderators are sent for approval only to the sending moderator, whereas posts from other addresses are sent to all moderators. Thus, you can set up an announcement list by adding all potential posters as moderators. However, you may also want to allow others to post, as long as the posts are approved. This would be default eezzmmllmm--ssttoorree function. To make the set of ‘‘approved posters’’ who approve their own posts, different from the set of addresses that approve posts from other users, use the --ss switch. Add a directory name to _d_i_r//mmooddppoosstt. This directory is the base directory of the ‘‘approved posters’’ database. Add the moderators for other posts to _d_i_r//mmoodd// using eezzmmllmm--ssuubb((11)). CCHHAARRAACCTTEERR SSEETTSS If _d_i_r//cchhaarrsseett exists, eezzmmllmm--ssttoorree will use the character set listed for all messages. Otherwise, the default ‘‘us-ascii’’ will be used. The character set can be suffixed by ‘‘:’’ followed by a code. If the code is ‘‘Q’’, outgoing messages are sent as ‘‘Quoted-Printable’’, if it is ’‘B’’ they are sent ‘‘base64’’ encoded. Otherwise, text is sent as is. SSEEEE AALLSSOO ezmlm-clean(1), ezmlm-manage(1), ezmlm-make(1), ezmlm-moderate(1), ezmlm(5) ezmlm-store(1)