Standards, Environments, and Macros ezmlm(5) NNNNAAAAMMMMEEEE ezmlm - format of ezmlm directory OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW An eeeezzzzmmmmllllmmmm directory, _d_i_r, stores information about an eeeezzzzmmmmllllmmmm mailing list. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee creates _d_i_r; eeeezzzzmmmmllllmmmm----ssssuuuubbbb and eeeezzzzmmmmllllmmmm---- uuuunnnnssssuuuubbbb manipulate the subscriber list stored under _d_i_r; eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee handles administrative requests automatically; eeeezzzzmmmmllllmmmm----sssseeeennnndddd sends a message to all subscribers listed in _d_i_r and also maintains a message archive and message subject index if the list is configured to do so. eeeezzzzmmmmllllmmmm----rrrreeeejjjjeeeecccctttt rejects messages that have an empty subject, or a subject consisting of only a command word; eeeezzzzmmmmllllmmmm----rrrreeeettttuuuurrrrnnnn handles bounces; eeeezzzzmmmmllllmmmm----wwwwaaaarrrrnnnn warns users for which messages bounce and eventually removes them from the subscriber list. eeeezzzzmmmmllllmmmm----iiiiddddxxxx can create a subject index from an existing list archive. eeeezzzzmmmmllllmmmm----ggggeeeetttt manages message, index, and thread retrieval from the archive, as well as the generation of message digests; eeeezzzzmmmmllllmmmm----ccccrrrroooonnnn provides a restricted interface to cron for the generation of digest generation trigger mes- sages; eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee queues messages of moderated lists and sends a moderation request to the moderator(s); eeeezzzzmmmmllllmmmm---- mmmmooooddddeeeerrrraaaatttteeee processes moderation requests to accept the queued message to the list via eeeezzzzmmmmllllmmmm----sssseeeennnndddd,,,, or to return the message to the sender; eeeezzzzmmmmllllmmmm----cccclllleeeeaaaannnn cleans up the moderation queue and returns to the sender any messages that have timed-out; eeeezzzzmmmmllllmmmm----ggggaaaatttteeee posts messages that come from a SENDER in an address database, and sends remaining messages out for moderation; eeeezzzzmmmmllllmmmm----cccchhhheeeecccckkkk is used to diagnose problems with ezmlm mailing list configuration; eeeezzzzmmmmllllmmmm----iiiissssssssuuuubbbb and eeeezzzzmmmmllllmmmm---- iiiissssssssuuuubbbbnnnn determine if a SENDER is a subscriber or a member of a collection of addresses; eeeezzzzmmmmllllmmmm----ttttssssttttddddiiiigggg determines if it is time to create a new digest based on the number and volume of messages and the amount of time that has passed since the last digest was issued; eeeezzzzmmmmllllmmmm----rrrreeeeqqqquuuueeeesssstttt can be used to answer eeeezzzzmmmmllllmmmm commands in the subject line easing migration from other mailing list managers. It can also function as a glo- bal interface mimicking the interface of other mailing list manager. eeeezzzzmmmmllllmmmm----ggggllllmmmmaaaakkkkeeee can set up the global interface, and eeeezzzzmmmmllllmmmm----ggggllllccccoooonnnnffff can create a configuration file for the global interface from your lists. SSSSUUUUBBBBSSSSCCCCRRRRIIIIBBBBEEEERRRRSSSS _d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss is a directory containing the subscriber list. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee allows automatic subscription if _d_i_r////ppppuuuubbbblllliiiicccc exists. The list is hashed into 53 files, named @@@@ through tttt in ASCII. A nonexistent file is treated as an empty file. Each file contains a series of addresses. An address can be any string of non-NUL characters up to 400 bytes long. Each SunOS 5.11 Last change: 1 Standards, Environments, and Macros ezmlm(5) address is preceded by the letter T and followed by a NUL. For reliability, when an address is added to or removed from the mailing list, the relevant file is recreated under a temporary name inside _d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss and then moved into place. _d_i_r////kkkkeeeeyyyy is a binary file. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee uses _d_i_r////kkkkeeeeyyyy to create confirmation numbers. Anyone who can guess the con- tents of _d_i_r////kkkkeeeeyyyy can forge subscription requests. eeeezzzzmmmmllllmmmm---- mmmmaaaakkkkeeee does not put much effort into making _d_i_r////kkkkeeeeyyyy difficult to guess; for better security, you should add some random garbage to _d_i_r////kkkkeeeeyyyy. AAAARRRRCCCCHHHHIIIIVVVVEEEE _d_i_r////aaaarrrrcccchhhhiiiivvvveeee is a directory containing messages previously sent to subscribers. eeeezzzzmmmmllllmmmm----sssseeeennnndddd archives all new messages if _d_i_r////aaaarrrrcccchhhhiiiivvvveeeedddd exists. If _d_i_r////iiiinnnnddddeeeexxxxeeeedddd exists, eeeezzzzmmmmllllmmmm----sssseeeennnndddd also maintains a message subject and author index. Messages sent to the mailing list are numbered from 1 upwards, whether or not they are archived. _d_i_r////nnnnuuuummmm is the number of messages sent so far followed by ':', followed by the cumulative amount of message body that has passed eeeezzzzmmmmllllmmmm----sssseeeennnndddd stored as kbytes * 4 (4 corresponds to 1kb). _d_i_r////aaaarrrrcccchhhhiiiivvvveeee has subdirectories, each subdirectory storing up to 100 messages. Message number 100m+n, with n between 0 and 99, is stored in _d_i_r////aaaarrrrcccchhhhiiiivvvveeee////_m////_n. For example, message number 15307 is stored in _d_i_r////aaaarrrrcccchhhhiiiivvvveeee////111155553333////00007777. The message index is stored in the file iiiinnnnddddeeeexxxx in the same subdirectory of _d_i_r////aaaarrrrcccchhhhiiiivvvveeee holding the corresponding messages. Thus, the subject index contains up to 100 entries. The subject index contains message subjects that are normal- ized so that the original message and all replies have the same entry. The subject index is used for advanced message retrieval functions. For safety, the subject index is created under a temporary name inside _d_i_r////aaaarrrrcccchhhhiiiivvvveeee and then moved into place. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will ignore message files without the owner- execute bit set. eeeezzzzmmmmllllmmmm----sssseeeennnndddd turns on the owner-execute bit after safely writing the message to disk. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee by default adds eeeezzzzmmmmllllmmmm----ggggeeeetttt to _d_i_r////mmmmaaaannnnaaaaggggeeeerrrr to han- dle -_g_e_t, -_i_n_d_e_x, and -_t_h_r_e_a_d requests. If eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee is invoked with a _d_i_g_c_o_d_e command line argument, digest crea- tion is enabled by putting this argument on the eeeezzzzmmmmllllmmmm----ggggeeeetttt command line. SunOS 5.11 Last change: 2 Standards, Environments, and Macros ezmlm(5) BBBBOOOOUUUUNNNNCCCCEEEESSSS _d_i_r////bbbboooouuuunnnncccceeee is a directory containing bounce messages. eeeezzzzmmmmllllmmmm----rrrreeeettttuuuurrrrnnnn stores several types of files here. DDDDEEEELLLLIIIIVVVVEEEERRRRYYYY IIIINNNNSSSSTTTTRRRRUUUUCCCCTTTTIIIIOOOONNNNSSSS eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up four files to control mailing list deliveries. Each file is a series of delivery instructions in ddddooootttt----qqqqmmmmaaaaiiiillll format. _d_i_r////eeeeddddiiiittttoooorrrr handles incoming mailing list submissions. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////eeeeddddiiiittttoooorrrr to invoke eeeezzzzmmmmllllmmmm----sssseeeennnndddd to immediately forward each message to all subscribers and then to run eeeezzzzmmmmllllmmmm----wwwwaaaarrrrnnnn. _d_i_r////oooowwwwnnnneeeerrrr handles incoming messages for the mailing list's owner. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////oooowwwwnnnneeeerrrr to store messages in _d_i_r////MMMMaaaaiiiillllbbbbooooxxxx and then to run eeeezzzzmmmmllllmmmm----wwwwaaaarrrrnnnn. _d_i_r////bbbboooouuuunnnncccceeeerrrr handles incoming bounce messages. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////bbbboooouuuunnnncccceeeerrrr to invoke eeeezzzzmmmmllllmmmm----rrrreeeettttuuuurrrrnnnn. eeeezzzzmmmmllllmmmm----wwwwaaaarrrrnnnn is no longer invoked here due to the load it places on systems with many large lists with many bounces. _d_i_r////mmmmaaaannnnaaaaggggeeeerrrr handles incoming administrative requests. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////mmmmaaaannnnaaaaggggeeeerrrr to invoke eeeezzzzmmmmllllmmmm----ggggeeeetttt, eeeezzzzmmmmllllmmmm---- mmmmaaaannnnaaaaggggeeee, and then eeeezzzzmmmmllllmmmm----wwwwaaaarrrrnnnn. _d_i_r////mmmmooooddddeeeerrrraaaattttoooorrrr handles incoming message _a_c_c_e_p_t and _r_e_j_e_c_t requests for moderated lists. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////mmmmooooddddeeeerrrraaaattttoooorrrr to invoke eeeezzzzmmmmllllmmmm----mmmmooooddddeeeerrrraaaatttteeee, and .BR ezmlm-clean . DDDDIIIIGGGGEEEESSSSTTTTSSSS eeeezzzzmmmmllllmmmm----ggggeeeetttt can create digests if it is invoked from the com- mand line, from _d_i_r////eeeeddddiiiittttoooorrrr, or from _d_i_r////mmmmaaaannnnaaaaggggeeeerrrr. The pro- gram functions in slightly different ways in these 3 set- tings (see eeeezzzzmmmmllllmmmm----ggggeeeetttt((((1111))))). To enable automatic digests for a mailing list, use the eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee -dddd switch. To also enable the generation of dig- ests at specific times dictated by mailed trigger messages, a _d_i_g_c_o_d_e should be specified on the eeeezzzzmmmmllllmmmm----ggggeeeetttt command line. This can be done by specifying _d_i_g_c_o_d_e as a fifth argument to eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee when setting up the list. _d_i_g_c_o_d_e must be alphanumeric and is case-insensitive. To generate trigger messages, use eeeezzzzmmmmllllmmmm----ccccrrrroooonnnn((((1111)))) as an inter- face to ccccrrrroooonnnndddd((((8888)))) or use ccccrrrroooonnnndddd directly. _d_i_r////nnnnuuuummmm contains the number of the last message processed, followed by ':' and a number that is increased by 1 for each 256 bytes of message body text processed. The latter number SunOS 5.11 Last change: 3 Standards, Environments, and Macros ezmlm(5) is used by eeeezzzzmmmmllllmmmm----ttttssssttttddddiiiigggg to determine if a new digest is due. _d_i_r////ddddiiiiggggnnnnuuuummmm contains the contents of _d_i_r////nnnnuuuummmm at the time of the last regular digest creation, followed by a ':', fol- lowed by a timestamp. It is updated after each regular dig- est is sent. _d_i_r////ddddiiiiggggiiiissssssssuuuueeee contains the issue number of the last regular digest. It is incremented for each regular digest sent. The following user crontab entry (all on one line) generates a digest of the list _l_i_s_t@_h_o_s_t._d_o_m_a_i_n at 1600 every day: 00 16 * * * /var/qmail/bin/qmail-inject list-dig.digcode Alternatively, eeeezzzzmmmmllllmmmm----ccccrrrroooonnnn can be used: % ezmlm-cron -t 16:00 list@host digcode eeeezzzzmmmmllllmmmm----ggggeeeetttt can also be run from the shell: To generate a dig- est to _l_i_s_t-_d_i_g_e_s_t@_h_o_s_t from the list housed in ~_j_o_e/_l_i_s_t: % ezmlm-get ~joe/list Like other eeeezzzzmmmmllllmmmm----ggggeeeetttt replies, digest can be sent in several formats. See eeeezzzzmmmmllllmmmm----ggggeeeetttt((((1111)))) for more info. MMMMOOOODDDDEEEERRRRAAAATTTTIIIIOOOONNNN There are three aspects of moderation: moderation of posts, moderation of subscriptions, and "remote administration", i.e. giving the moderator the right to (un)subscribe any user. eeeezzzzmmmmllllmmmm handles these three aspects separately. The two first aspects enhance security, while the third decreases security, but makes list administration considerably easier. By default, the moderator database is the same for all three functions. While "remote administration" and subscription moderation always use the same database, the moderators for message moderation can be different. Even with subscription moderation, the user has to verify the request. This is to ensure that the user initiating the request really controls the address. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee options exist to disable the user handshake, which may be useful in some circumstances. For moderation options, the moderators are by stored in a subscriber list in _m_o_d_d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss. By default _m_o_d_d_i_r is _d_i_r////mmmmoooodddd. Moderators can be added and removed with: eeeezzzzmmmmllllmmmm----ssssuuuubbbb _m_o_d_d_i_r _m_o_d_e_r_a_t_o_r@_h_o_s_t SunOS 5.11 Last change: 4 Standards, Environments, and Macros ezmlm(5) eeeezzzzmmmmllllmmmm----uuuunnnnssssuuuubbbb _m_o_d_d_i_r _m_o_d_e_r_a_t_o_r@_h_o_s_t For subscription moderation, touch _d_i_r////mmmmooooddddssssuuuubbbb after adding moderator(s). For remote administration, touch _d_i_r////rrrreeeemmmmooootttteeee. If the contents of these files start with a leading forward slash, it is assumed to be the name of mmmmooooddddddddiiiirrrr subscription moderation. If both files exist and start with a forward slash, the _d_i_r////rrrreeeemmmmooootttteeee contents are ignored. Moderators are stored in a subscriber list in the ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss subdirectory of mmmmooooddddddddiiiirrrr. If no directory names are specified, the default, _d_i_r////mmmmoooodddd, is used. In all cases, the _s_u_b_s_c_r_i_b_e_r_s subdirectory of the base directory must exists/be created. Moderation of messages is achieved by creating _d_i_r////mmmmooooddddppppoooosssstttt and modifying _d_i_r////eeeeddddiiiittttoooorrrr to invoke eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee.... eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee stores the message in _d_i_r////mmmmoooodddd////ppppeeeennnnddddiiiinnnngggg and sends a moderation request to all moderators stored in _m_o_d_d_i_r. If _d_i_r////mmmmooooddddppppoooosssstttt does not exist, eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee posts messages directly, and eeeezzzzmmmmllllmmmm----cccclllleeeeaaaannnn does nothing. If _d_i_r////mmmmooooddddppppoooosssstttt contains a directory name starting with a forward slash, this directory is used as _m_o_d_d_i_r for message moderation. Moderators are stored in a subscriber list in the _s_u_b_s_c_r_i_b_e_r_s subdirectory of _m_o_d_d_i_r. If no directory names are specified, the default, _d_i_r////mmmmoooodddd, is used. _d_i_r////mmmmooooddddeeeerrrraaaattttoooorrrr is linked to _d_o_t-aaaacccccccceeeepppptttt----ddddeeeeffffaaaauuuulllltttt and _d_o_t-rrrreeeejjjjeeeecccctttt----ddddeeeeffffaaaauuuulllltttt. It handles replies from the moderators. In addition to a moderator list, the directories _d_i_r////mmmmoooodddd////ppppeeeennnnddddiiiinnnngggg, _d_i_r////mmmmoooodddd////aaaacccccccceeeepppptttteeeedddd, and _d_i_r////mmmmoooodddd////rrrreeeejjjjeeeecccctttteeeedddd must exist. These directories contain the message moderation queue. If _d_i_r////mmmmoooodddd////mmmmooooddddttttiiiimmmmeeee it determines the minimal time in hours that messages wait in the moderation queue, before they are returned to sender with the message in _d_i_r////tttteeeexxxxtttt////mmmmoooodddd----ttttiiiimmmmeeeeoooouuuutttt. If a -_h_e_l_p command is send for a moderator and _d_i_r////mmmmooooddddssssuuuubbbb or _d_i_r////rrrreeeemmmmooootttteeee exist, a more detailed help message stored in _d_i_r////tttteeeexxxxtttt////mmmmoooodddd----hhhheeeellllpppp will be sent together with the regular help. This text should not contain secrets. If _d_i_r////tttteeeexxxxtttt////mmmmoooodddd----hhhheeeellllpppp does not exist, _d_i_r////tttteeeexxxxtttt////hhhheeeellllpppp will be sent. If a -_l_i_s_t command is sent for a moderator and _d_i_r////mmmmooooddddssssuuuubbbb or _d_i_r////rrrreeeemmmmooootttteeee exist, and the eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee -llll command line switch is specified, a subscriber list will be returned. If an -_e_d_i_t._f_i_l_e command is sent for a moderator and _d_i_r////rrrreeeemmmmooootttteeee exist, and the eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee -dddd command line SunOS 5.11 Last change: 5 Standards, Environments, and Macros ezmlm(5) switch is specified, tttteeeexxxxtttt////ffffiiiilllleeee is returned together with an eeeezzzzmmmmllllmmmm cookie. The remote administrator may return an edited version of the file, which will be stored, provided that the cookie is valid. See eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee((((1111)))) for more info. TTTTEEEEXXXXTTTT _d_i_r////tttteeeexxxxtttt is a directory containing files sent out by eeeezzzzmmmmllllmmmm---- mmmmaaaannnnaaaaggggeeee in response to administrative requests: ttttoooopppp Introducing eeeezzzzmmmmllllmmmm. This is placed at the top of each response. bbbboooottttttttoooommmm Explaining how to use eeeezzzzmmmmllllmmmm. This is placed at the bottom of each response. ssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm Explaining how to confirm a subscription request. ssssuuuubbbb----ooookkkk Acknowledging successful subscription. ssssuuuubbbb----nnnnoooopppp Acknowledging a subscription request for an address already on the mailing list. ssssuuuubbbb----bbbbaaaadddd Rejecting a bad subscription confirmation number. uuuunnnnssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm Explaining how to confirm an unsubscription request, and explaining how to figure out the subscription address. uuuunnnnssssuuuubbbb----ooookkkk Acknowledging successful unsubscription. uuuunnnnssssuuuubbbb----nnnnoooopppp Acknowledging an unsubscription request for an address not on the mailing list. uuuunnnnssssuuuubbbb----bbbbaaaadddd Rejecting a bad unsubscription confirmation number. ggggeeeetttt----bbbbaaaadddd Rejecting a bad archive retrieval request. ddddiiiiggggeeeesssstttt Text copied into the _A_d_m_i_n_i_s_t_r_a_t_i_v_i_a section of the digest. Usually, this will contain subscription info for the digest, as well as information on how to post to the list. ttttrrrraaaaiiiilllleeeerrrr If this files exists, it is copied to the end of all messages to the list. ffffaaaaqqqq Sent in response to the _f_a_q command. Usually contains frequently asked questions and answers specific for the mailing list. SunOS 5.11 Last change: 6 Standards, Environments, and Macros ezmlm(5) iiiinnnnffffoooo Sent in response to the _i_n_f_o command. Usually contains a descripition, policy, etc, for the list. The first line should in itself be a very brief description of the list. bbbboooouuuunnnncccceeee----wwwwaaaarrrrnnnn Pointing out that messages have bounced. bbbboooouuuunnnncccceeee----pppprrrroooobbbbeeee Pointing out that a warning message has bounced. bbbboooouuuunnnncccceeee----nnnnuuuummmm Explaining that eeeezzzzmmmmllllmmmm----rrrreeeettttuuuurrrrnnnn has kept a list of bounced message numbers. ddddiiiigggg----bbbboooouuuunnnncccceeee----nnnnuuuummmm Explaining that digest messages have bounced. All other text files are used for both the main list and the digest list. bbbboooouuuunnnncccceeee----bbbboooottttttttoooommmm Separating the bounce message. mmmmoooodddd----hhhheeeellllpppp is set to list moderators issuing a -_h_e_l_p command. It contains instructions for modera- tors, but it is relatively trivial for a non-moderator to read it. Don't put secrets here. mmmmoooodddd----rrrreeeejjjjeeeecccctttt is the returned to the sender of a rejected post. mmmmoooodddd----ttttiiiimmmmeeeeoooouuuutttt is returned if the message timed-out without moderator action. mmmmoooodddd----ssssuuuubbbb is added to the text confirming subscription and unsubscription instead of bbbboooottttttttoooommmm and the requesting message, for actions that were approved by a moderator. Not copying the requesting message hides the moderator iden- tity from the subscriber. mmmmoooodddd----rrrreeeeqqqquuuueeeesssstttt is the text sent to the moderators to request moderator action on a posted message. mmmmoooodddd----uuuunnnnssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm Requesting that the moderator confirm a request to subscribe. If this file does not exist, ssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm will be used. mmmmoooodddd----uuuunnnnssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm Requesting that the moderator confirm a request to unsubscribe. If this file does not exist, uuuunnnnssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm will be used. eeeeddddiiiitttt----ddddoooo Instructions sent to the remote administrator SunOS 5.11 Last change: 7 Standards, Environments, and Macros ezmlm(5) together with a copy of a _d_i_r////tttteeeexxxxtttt file and editing instructions. eeeeddddiiiitttt----lllliiiisssstttt A list of editable files in _d_i_r////tttteeeexxxxtttt with a one-line description send to a remote administrator in response to a -_e_d_i_t command. eeeeddddiiiitttt----ddddoooonnnneeee Sent to the remote administrator after an edited _d_i_r////tttteeeexxxxtttt file has been successfully saved. Several tags in the text files are replaced by ezmlm pro- grams. All programs replace the tag <<<<####llll####>>>> with the name of the list or the list-digest, as appropriate for the request, and <<<<####hhhh####>>>> with the hostname for the list. eeeezzzzmmmmllllmmmm----sssseeeennnndddd and eeeezzzzmmmmllllmmmm----ggggeeeetttt replace <<<<####nnnn####>>>> with the current message number in added headers from _d_i_r////hhhheeeeaaaaddddeeeerrrraaaadddddddd and text files. eeeezzzzmmmmllllmmmm----ggggeeeetttt does this for digest messages, where the current message is the number of the first message in the digest. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee replaces the tag <<<<####AAAA####>>>> anywhere on a line with the subscrip- tion address, and <<<<####RRRR####>>>> anywhere on a line with the address the subscriber must reply to. Only the first tag on any line is processed. For backwards compatibility, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee replaces the line !!!!AAAA in any of these files with the name of the subscription address. It replaces the line !!!!RRRR in ssssuuuubbbb----ccccoooonnnnffffiiiirrrrmmmm and uuuunnnnssssuuuubbbb---- ccccoooonnnnffffiiiirrrrmmmm with the address that the subscriber must reply to. eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee replaces the tag <<<<####AAAA####>>>> anywhere on a line with the address for accepting the message, and <<<<####RRRR####>>>> anywhere on a line with the address for rejecting the message. Only the first tag on any line is processed. For backwards compatibility, eeeezzzzmmmmllllmmmm----ssssttttoooorrrreeee also replaces the line !!!!AAAA with the address for accepting the message and the line !!!!RRRR with the address for rejecting the message. OOOOUUUUTTTTGGGGOOOOIIIINNNNGGGG MMMMEEEESSSSSSSSAAAAGGGGEEEE EEEEDDDDIIIITTTTIIIINNNNGGGG _d_i_r////hhhheeeeaaaaddddeeeerrrrrrrreeeemmmmoooovvvveeee is a list of bad header field names, one per line. eeeezzzzmmmmllllmmmm----sssseeeennnndddd removes these header fields from all outgoing messages. eeeezzzzmmmmllllmmmm----mmmmaaaakkkkeeee sets up _d_i_r////hhhheeeeaaaaddddeeeerrrrrrrreeeemmmmoooovvvveeee to remove RRRReeeettttuuuurrrrnnnn----PPPPaaaatttthhhh, RRRReeeettttuuuurrrrnnnn----RRRReeeecccceeeeiiiipppptttt----TTTToooo, and RRRReeeettttuuuurrrrnnnn----PPPPaaaatttthhhh fields. _d_i_r////hhhheeeeaaaaddddeeeerrrraaaadddddddd is a list of new header fields. eeeezzzzmmmmllllmmmm----sssseeeennnndddd adds these fields to every outgoing message. eeeezzzzmmmmllllmmmm----sssseeeennnndddd sets up _d_i_r////hhhheeeeaaaaddddeeeerrrraaaadddddddd to add XXXX----NNNNoooo----AAAArrrrcccchhhhiiiivvvveeee:::: yyyyeeeessss and PPPPrrrreeeecccceeeeddddeeeennnncccceeee::::bulk.... If _d_i_r////mmmmiiiimmmmeeeerrrreeeemmmmoooovvvveeee exists, eeeezzzzmmmmllllmmmm----sssseeeennnndddd removed parts with the corresponding content-types from composite MIME messages. If SunOS 5.11 Last change: 8 Standards, Environments, and Macros ezmlm(5) the eeeezzzzmmmmllllmmmm----rrrreeeejjjjeeeecccctttt _d_i_r argument is specified, simple MIME mes- sages of these content-types are rejected. If _d_i_r////mmmmiiiimmmmeeeerrrreeeejjjjeeeecccctttt exists, and the eeeezzzzmmmmllllmmmm----rrrreeeejjjjeeeecccctttt _d_i_r argument is specified, simple MIME messages of these content-types, or composite MIME messages with any body part of these content-types are rejected. If _d_i_r////sssseeeeqqqquuuueeeennnncccceeee exists, the first line is added as a header to all outgoing messages, followed by a space and the mes- sage number. The message number is useful for archive retrievals, since some mail systems do not reveal the return-path to the user. NNNNOOOOTTTTEEEE:::: Sublists have their own mes- sage counter. Adding a sequence header from a sublists will give you the sublist message number which is different from the main list message number. _d_i_r////pppprrrreeeeffffiiiixxxx is a subject prefix. If this file exists, its contents are prefixed to the subject of the post in the out- going message. The archived message is not processed. Attempts are made to not duplicate an existing prefix in replies. Think twice before using this option. A prefix takes unnecessary space on the subject line and most mail clients can easily filter on other headers, such as 'Mailing-List:'. If _d_i_r////pppprrrreeeeffffiiiixxxx ccccoooonnnnttttaaaaiiiinnnnssss aaaa ssssiiiinnnngggglllleeee ''''####'''',,,, tttthhhhiiiissss number. The use of this feature is inadvisable and violates internet mail standards. However, it is very popular in e.g. Japan. If you must use this feature, make sure you are aware that you may be causing problems to users, sublists, etc. _d_i_r////tttteeeexxxxtttt////ttttrrrraaaaiiiilllleeeerrrr is a message trailer. If this file exists, it's contents are copied to the end of outgoing messages. Only lines terminated with new-line are copied. No trailer is copied to the archived version of the message. MMMMIIIISSSSCCCCEEEELLLLLLLLAAAANNNNYYYY The first line of _d_i_r////mmmmaaaaiiiilllliiiinnnngggglllliiiisssstttt is a line of text. eeeezzzzmmmmllllmmmm----sssseeeennnndddd creates a new MMMMaaaaiiiilllliiiinnnngggg----LLLLiiiisssstttt field, showing the contents of _d_i_r////mmmmaaaaiiiilllliiiinnnngggglllliiiisssstttt, in every outgoing message. If _d_i_r////lllliiiissssttttiiiidddd exists, ezmlm programs create a new LLLLiiiisssstttt----IIIIDDDD field, showing the contents of the first line of _d_i_r////lllliiiissssttttiiiidddd, in every outgoing message. The list-id should be unique and within name space controlled by the owner. It should remain constant even if lists move and be of the format List-ID: optional_text This header would result from a _d_i_r////lllliiiissssttttiiiidddd file containing ``optional_text ''. See _h_t_t_p://_w_w_w._w_i_t_h_i_n._c_o_m/~_c_h_a_n_d_h_o_k/_i_e_t_f/_l_i_s_t_i_d._s_h_t_m_l for more info. SunOS 5.11 Last change: 9 Standards, Environments, and Macros ezmlm(5) The first lines of _d_i_r////oooouuuuttttllllooooccccaaaallll and _d_i_r////oooouuuutttthhhhoooosssstttt give the outgoing name of the mailing list. These are used by eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee and eeeezzzzmmmmllllmmmm----sssseeeennnndddd to construct sender addresses for outgoing messages. The first lines of _d_i_r////iiiinnnnllllooooccccaaaallll and _d_i_r////iiiinnnnhhhhoooosssstttt give the incoming name of the mailing list. These are used by eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee to parse incoming envelopes. Normally _i_n_l_o_c_a_l and _i_n_h_o_s_t are the same as _o_u_t_l_o_c_a_l and _o_u_t_h_o_s_t, but some- times they are different, with _o_u_t_l_o_c_a_l@@@@_o_u_t_h_o_s_t forwarded to _i_n_l_o_c_a_l@@@@_i_n_h_o_s_t. If _d_i_r////ssssuuuubbbblllliiiisssstttt exists, this mailing list is a sublist, redistributing messages from a parent mailing list. The first line of _d_i_r////ssssuuuubbbblllliiiisssstttt is the name of the parent list. This affects the behavior of eeeezzzzmmmmllllmmmm----sssseeeennnndddd. If _d_i_r////qqqqmmmmqqqqppppsssseeeerrrrvvvveeeerrrrssss exists, eeeezzzzmmmmllllmmmm----sssseeeennnndddd and eeeezzzzmmmmllllmmmm----ggggeeeetttt will use qqqqmmmmaaaaiiiillll----qqqqmmmmqqqqppppcccc((((1111)))) to send posts and digests. Other mail will use the normal qmail mechanism. If qqqqmmmmaaaaiiiillll----qqqqmmmmqqqqppppcccc is modified correctly, server IP addresses listed one per line in _d_i_r////qqqqmmmmqqqqppppsssseeeevvvveeeerrrrssss will be tried in order, rather than the default servers specified in /_v_a_r/_q_m_a_i_l/_c_o_n_t_r_o_l. If _d_i_r////mmmmssssggggssssiiiizzzzeeee exists, it is assumed to contain ``max:min'', where ``max'' is the maximum size in bytes of an acceptable message body, and ``min'' the corresponding minimal size. Either will be ignored if zero or omitted. If the eeeezzzzmmmmllllmmmm---- rrrreeeejjjjeeeecccctttt command line specifies the list directory, messages not meeting the size criteria are rejected. If _d_i_r////cccchhhhaaaarrrrsssseeeetttt exists, the first line is assumed to represent a valid MIME character set, which is used for all outgoing MIME messages sent by eeeezzzzmmmmllllmmmm----ggggeeeetttt and the message moderation programs. The character set string may be suf- fixed with ':' and 'Q' or 'B' to send all outgoing text (ezmlm messages, digest table-of-contents, moderation requests, etc) encoded in ``Quoted-Printable'' or ``base64'' encoding. By default, no encoding is done, which may result in the transmission of characters with the high bit set. When encoding is specified, trigger messages and other parts of the reply that should not be encoded are sent as separate MIME parts. _d_i_r////lllloooocccckkkk is an empty file. Any program that reads or writes the subscriber list, or adds messages to the archive, locks _d_i_r////lllloooocccckkkk. _d_i_r////LLLLoooogggg is an advisory log of subscription and unsubscrip- tion actions. WWWWAAAARRRRNNNNIIIINNNNGGGG:::: LLLLoooogggg is not protected against system crashes. Log entries may be missing or corrupted if the system goes down. There is Log for each of the accessory SunOS 5.11 Last change: 10 Standards, Environments, and Macros ezmlm(5) address databases as well. Thus, the log for digest sub- scribers is _d_i_r////ddddiiiiggggeeeesssstttt////LLLLoooogggg. If enabled, these logs can be retrieved by remote administrators (see eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee((((1111))))). _d_i_r////ddddiiiiggggeeeesssstttt contains items specific for the digest list. _d_i_r////ddddiiiiggggeeeesssstttt////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss contains hash files of digest sub- scriber addresses. _d_i_r////ddddiiiiggggeeeesssstttt////LLLLoooogggg, _d_i_r////ddddiiiiggggeeeesssstttt////bbbboooouuuunnnncccceeee, _d_i_r////ddddiiiiggggeeeesssstttt////lllloooocccckkkkbbbboooouuuunnnncccceeee, and _d_i_r////ddddiiiiggggeeeesssstttt////lllloooocccckkkk have functions for the digest list that mirror that of the corresponding files in _d_i_r. _d_i_r////ssssqqqqllll contains SQL server access information for list that are configured to use an SQL database for storage. _d_i_r////ttttssssttttddddiiiigggg is a timestamp used temporarily by eeeezzzzmmmmllllmmmm---- ttttssssttttddddiiiigggg((((1111)))) to coordinate digesting. SSSSEEEEEEEE AAAALLLLSSSSOOOO ezmlm-check(1), ezmlm-clean(1), ezmlm-gate(1), ezmlm-get(1), ezmlm-idx(1), ezmlm-issub(1), ezmlm-issubn(1), ezmlm- list(1), ezmlm-make(1), ezmlm-manage(1), ezmlm-moderate(1), ezmlm-request(1), ezmlm-return(1), ezmlm-send(1), ezmlm- store(1), ezmlm-sub(1), ezmlm-tstdig(1), ezmlm-unsub(1), ezmlm-warn(1), dot-qmail(5) SunOS 5.11 Last change: 11