User Commands ezmlm-manage(1) NNNNAAAAMMMMEEEE ezmlm-manage - automatically manage a mailing list SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee [[[[----bbbbBBBBccccCCCCddddDDDDeeeeEEEEffffFFFFllllLLLLmmmmMMMMssssSSSSqqqqQQQQuuuuUUUUvvvvVVVV]]]] _d_i_r DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee handles administrative requests for the mailing list stored in _d_i_r, as well as for the associated digest list. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee is normally invoked from a ....qqqqmmmmaaaaiiiillll file. It reads a mail message from its standard input, and a mail envelope from the SSSSEEEENNNNDDDDEEEERRRR, LLLLOOOOCCCCAAAALLLL, and HHHHOOOOSSSSTTTT environment vari- ables. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee expects LLLLOOOOCCCCAAAALLLL to be of the form _l_i_s_t----_a_c_t_i_o_n---- _b_o_x====_d_o_m_a_i_n. Here _l_i_s_t is the first line of _d_i_r////iiiinnnnllllooooccccaaaallll, _a_c_t_i_o_n is a request, and _b_o_x@@@@_d_o_m_a_i_n is the target of the request. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee sends a response to the target. It attaches the original message to the end of its response. LLLLOOOOCCCCAAAALLLL may instead be of the form _l_i_s_t----_a_c_t_i_o_n. Then the envelope sender is used as the target. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee expects HHHHOOOOSSSSTTTT to match the first line of _d_i_r////iiiinnnnhhhhoooosssstttt. If _l_i_s_t is the first line of _d_i_r////iiiinnnnllllooooccccaaaallll followed by ``- digest'', the request is assumed to be for the associated digest list. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee handles these requests similarly, except that digest list subscriber addresses are stored in _d_i_r////ddddiiiiggggeeeesssstttt////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss, rather than in _d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss. If _l_i_s_t _d_i_r////iiiinnnnllllooooccccaaaallll followed by ``-allow'', the request is assumed to be for the associated _d_i_r////aaaalllllllloooowwww//// database. This database is used to store aliases of subscribers for lists allowing only posts only if the envelope sender is a sub- scriber. Actions on the _d_i_r////aaaalllllllloooowwww//// database follow the same rules as for the main list. The ezmlm messages are the same as those used for normal subscription, but refer to the _l_i_s_t----aaaalllllllloooowwww@@@@_h_o_s_t list. As this feature is designed for advanced uses and remote administrators only, this is not a problem. NNNNOOOOTTTTEEEE:::: No message is sent out to confirm additions to or removals from this database. However, the user can verify the change using the _q_u_e_r_y action. The _l_i_s_t----ddddeeeennnnyyyy addresses similarly controls _d_i_r////ddddeeeennnnyyyy//// database for blocking posts with certain envelope senders. This database is available to remote administrators only, and only if the list has been set up with this feature (see eeeezzzzmmmmllllmmmm---- mmmmaaaannnnaaaaggggeeee((((1111))))). NNNNOOOOTTTTEEEE:::: No message is sent out to confirm addi- tions to or removals from this database. However, the SunOS 5.11 Last change: 1 User Commands ezmlm-manage(1) remote admin can verify the change using the _q_u_e_r_y action. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee copies _d_i_r////mmmmaaaaiiiilllliiiinnnngggglllliiiisssstttt into a MMMMaaaaiiiilllliiiinnnngggg----LLLLiiiisssstttt field in its response. If the incoming message has a MMMMaaaaiiiilllliiiinnnngggg----LLLLiiiisssstttt field, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee refuses to respond. eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee also refuses to respond to bounce messages. OOOOPPPPTTTTIIIIOOOONNNNSSSS -bbbb (Default.) eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will add general instructions and the request to the outgoing message. -BBBB eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will not add general instructions and the request to the outgoing message. This information gives the recipient of a confirmation request some information about the inciting message. Use of this switch will deny the recipient that information. -cccc (Default.) eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will reply to -_g_e_t commands. -CCCC eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will not reply to -_g_e_t commands. This is useful for closed lists, where the owner for some rea- son wants to keep an archive, without making it avail- able. -dddd Alias for the -eeee switch for backwards compatibility. -DDDD Alias for the -EEEE switch for backwards compatibility. -eeee eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee allows remote administrators to edit files in _d_i_r////tttteeeexxxxtttt//// via E-mail. -EEEE (Default.) Text file editing not allowed. -ffff (Default.) The information in the ``From:'' is extracted from subscribe confirm messages and added to _d_i_r////LLLLoooogggg together with the subscriber address. This makes it easier for the list owner to help a subscriber who cannot determine his/her subscription address. If the -SSSS switch is used, the information is instead extracted from the subscribe request. -FFFF Ignore ``From:'' headers. -llll eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will send a subscriber list in reply to the -_l_i_s_t command and the number of subscribers in reply to the -_l_i_s_t_n comman if _d_i_r////mmmmooooddddssssuuuubbbb or _d_i_r////rrrreeeemmmmooootttteeee exist and target (the address the reply is to be sent to) is a moderator. -LLLL (Default.) eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will ignore the -_l_i_s_t and -_l_i_s_t_n commands. SunOS 5.11 Last change: 2 User Commands ezmlm-manage(1) -mmmm For lists with moderated subscription, require modera- tor approval also for unsubscribe requests. Remote admins are normally informed about unsuccessful unsub- scribes. This creates problems when there is more than one moderator. Therefore, when the -mmmm switch is used, the notification is suppressed. Moderators can still determine the result by using the -_q_u_e_r_y command. -MMMM (Default.) Requests to unsubscribe from moderated lists do not require moderator approval. -_n (Default.) Target addresses will be notified if the are added or removed from the subscriber list. -_N Target addresses will not be notified if they are added/removed from the subscriber list by remote admin or moderator action. Also, the target will not be noti- fied if they were successfully added/removed when the -SSSS and -UUUU switches, respectively, are used. -qqqq (Default.) Quiet. The list-owner is not notified of subscription events. -QQQQ The list-owner is notified about failed unsubscribe attempts. Usually, these are from subscribers that do not remember their subscription address and require administrative assistance. Remote admins are notified when a unsubscribe request initiated by them fails. Thus, the owner is not notified about these events even if the -QQQQ switch is used. -QQQQQQQQ As for -QQQQ, and in addition, the list-owner is notified about all additions to or removals from the subscriber database. This is sometimes desired by owners of small lists. -ssss (Default.) eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will handle subscriptions with the normal target handshake. -SSSS eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will eliminate the target handshake from the subscription process. This allows anyone to sub- scribe anybody else. DO NOT use this option, unless you know what you are doing. This option may be useful for some moderated lists. -uuuu (Default.) eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will handle unsubscribe requests with the normal target handshake. -UUUU eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will eliminate the target handshake from the unsubscription process. This allows anyone to unsubscribe anybody else. DO NOT use this option, unless you know what you are doing. SunOS 5.11 Last change: 3 User Commands ezmlm-manage(1) -vvvv Display eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee version information. -VVVV Display eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee version information. CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR SSSSEEEETTTTSSSS If _d_i_r////cccchhhhaaaarrrrsssseeeetttt exists, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee 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. Incoming text for the -_e_d_i_t is accepted unencoded or in either of these encodings. SSSSUUUUBBBBSSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS If _a_c_t_i_o_n is sssscccc...._c_o_o_k_i_e, where _c_o_o_k_i_e is an appropriate code (depending on the target, the approximate time, and other factors), eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee adds the target to the mailing list if subscriptions are not moderated. For subscription moderated lists, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee sends a confirmation request to the moderators with the right ttttcccc...._c_o_o_k_i_e address in its response. If _a_c_t_i_o_n is ttttcccc...._c_o_o_k_i_e, where _c_o_o_k_i_e is an appropriate code (depending on the target, the approximate time, and other factors), eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee adds the target to the mailing list. If the target was not already a subscriber, a welcome mes- sage is sent to the target. If _a_c_t_i_o_n is ssssuuuubbbbssssccccrrrriiiibbbbeeee, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee does not subscribe the target, but it identifies the right sssscccc...._c_o_o_k_i_e address in its response. This confirmation mechanism (1) verifies that the target is reachable and (2) protects the target against forged sub- scription requests. Actions of uuuucccc...._c_o_o_k_i_e and uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeee are used in the same way to delete the target from the mailing list. Unsub- scribes do not require moderator confirmation. Actions of vvvvcccc...._c_o_o_k_i_e are used to confirm moderator-initiated unsubscribes for lists configured with remote administration (see MODERATION). If _a_c_t_i_o_n is qqqquuuueeeerrrryyyy, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee returns a message to the target indicating whether or not the target address is a subscriber. If _a_c_t_i_o_n is iiiinnnnffffoooo or ffffaaaaqqqq, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee returns the contents SunOS 5.11 Last change: 4 User Commands ezmlm-manage(1) of _d_i_r////tttteeeexxxxtttt////iiiinnnnffffoooo or _d_i_r////tttteeeexxxxtttt////iiiinnnnffffoooo, respectively. If _d_i_r////ppppuuuubbbblllliiiicccc does not exist, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee rejects all sub- scription and unsubscription attempts. However, if the list is configured with remote administration, moderator- initiated subscribe and unsubscribe requests will still be honored. Also, if _a_c_t_i_o_n is _h_e_l_p, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will still send help. TTTTEEEEXXXXTTTT FFFFIIIILLLLEEEE EEEEDDDDIIIITTTTIIIINNNNGGGG If _a_c_t_i_o_n is eeeeddddiiiitttt, the -eeee switch is used, and the target address is that of a remote administrator, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will reply with a list of editable file in _d_i_r////tttteeeexxxxtttt//// and instruc- tions for editing. Cookies for editing expire approximately 27.8 hours after they are issued, or when a file has been changed, whichever is sooner. The size of the updated file is limited to 5120 bytes. If _a_c_t_i_o_n is eeeeddddiiiitttt...._f_i_l_e, the -eeee switch is used, and the tar- get address is that of a remote administrator, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will return an editable copy of _f_i_l_e. If _a_c_t_i_o_n is eeeedddd...._c_o_o_k_i_e, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will verify that the edit cookie is still valid and that the file has not been modified since the cookie was issued. If the cookie passes these tests, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will update _d_i_r////tttteeeexxxxtttt/_f_i_l_e. AAAARRRRCCCCHHHHIIIIVVVVEEEE RRRREEEETTTTRRRRIIIIEEEEVVVVAAAALLLLSSSS If _a_c_t_i_o_n is ggggeeeetttt...._n_u_m, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee sends back message _n_u_m from _d_i_r////aaaarrrrcccchhhhiiiivvvveeee////. This can be disabled with the -CCCC command line switch. If _d_i_r////ppppuuuubbbblllliiiicccc does not exist, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee rejects all archive retrieval attempts. MMMMOOOODDDDEEEERRRRAAAATTTTIIIIOOOONNNN If _d_i_r////mmmmooooddddssssuuuubbbb exists, subscriptions are moderated. Users can unsubscribe without moderator action, but moderator confir- mation is required for subscriptions. If _d_i_r////mmmmooooddddssssuuuubbbb starts with a forward slash, it is assumed that the content this is the base directory for the modera- tor database ( _m_o_d_d_i_r). Otherwise, _m_o_d_d_i_r is assumed to be _d_i_r////mmmmoooodddd////. The moderator names are assumed to be stored in a set of files in /_m_o_d_d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss////. I to add, remove, and list moderators, use respectively: eeeezzzzmmmmllllmmmm----ssssuuuubbbb _m_o_d_d_i_r _u_s_e_r@_h_o_s_t SunOS 5.11 Last change: 5 User Commands ezmlm-manage(1) eeeezzzzmmmmllllmmmm----uuuunnnnssssuuuubbbb _m_o_d_d_i_r _u_s_e_r@_h_o_s_t eeeezzzzmmmmllllmmmm----lllliiiisssstttt _m_o_d_d_i_r Subscription requests from potential subscribers will be sent for a second round of confirmation to all the modera- tors. If a moderator approves the request, a message con- firming the subscription will be sent to the subscriber. The subscriber will not know which moderator approved the sub- scription. If more than one moderator replies to the confirmation request, the subscriber will not receive duplicate messages about being on (or not on) the mailing list. Unsubscribe requests from users are handled as for non- moderated lists. All subscribe confirmation requests requiring moderator action have a subject of CCCCOOOONNNNFFFFIIIIRRRRMMMM ssssuuuubbbbssssccccrrrriiiibbbbeeee ttttoooo _l_i_s_t_n_a_m_e@_h_o_s_t. All unsubscribe confirmation requests in reply to moderator-initiated unsubscribe dialogs have a subject of CCCCOOOONNNNFFFFIIIIRRRRMMMM uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeee ffffrrrroooommmm _l_i_s_t_n_a_m_e@_h_o_s_t. If _d_i_r////rrrreeeemmmmooootttteeee exists (remote administration), moderators can initiate a request to subscribe a user 'username@userhost' by sending mail to _l_i_s_t_n_a_m_e- _s_u_b_s_c_r_i_b_e-uuuusssseeeerrrrnnnnaaaammmmeeee====uuuusssseeeerrrrhhhhoooosssstttt@_h_o_s_t. The moderator (not the subscriber) will receive the confirmation request, and can complete the transaction. Moderators' request to unsubscribe users are handled analogously. Once an address is success- fully added to or removed from the subscriber database by a moderator or remote admin, the user is notified of the action. If a moderator or remote admin's subscribe confirma- tion does not result in a change, i.e. if the address already was a subscriber, no notification is sent. If a remote admin's unsubscribe confirmation does not result in a change, i.e. the address was not a subscriber, a notifica- tion is sent to the remote admin. This is to make the remote admin aware that the address unsubscribed most likely is not the subscriber's subscription address. _d_i_r////rrrreeeemmmmooootttteeee starts with a forward slash, it is assumed that the content this is the base directory for the moderator database ( _m_o_d_d_i_r). The moderator names are assumed to be stored in a set of files in /_m_o_d_d_i_r////ssssuuuubbbbssssccccrrrriiiibbbbeeeerrrrssss////. If both _d_i_r////mmmmooooddddssssuuuubbbb and _d_i_r////rrrreeeemmmmooootttteeee exist, and both contain directory names, the directory name in _d_i_r////mmmmooooddddssssuuuubbbb is used, and the _d_i_r////rrrreeeemmmmooootttteeee entry is ignored. It is possible to set up a mailinglist for moderators only by using _d_i_r////mmmmoooodddd//// as the list directory. Make sure that such SunOS 5.11 Last change: 6 User Commands ezmlm-manage(1) a list is not public! Otherwise, anyone can become a modera- tor by subscribing to this list. If action is -hhhheeeellllpppp and target is a moderator, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will in addition to the usual help send _d_i_r////tttteeeexxxxtttt////mmmmoooodddd----hhhheeeellllpppp containing instructions for moderators. If action is -lllliiiisssstttt and target is a moderator, the list is set up for subscription moderation or remote administration, and the -_l command line switch is used, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will reply with an unsorted subscriber list. Extensions for dig- est subscribers and auxillary databases are supported (see above). If action is -lllloooogggg, eeeezzzzmmmmllllmmmm----mmmmaaaannnnaaaaggggeeee will reply with the contents of the _L_o_g file with the same access restrictions as for the -lllliiiisssstttt action. SSSSEEEEEEEE AAAALLLLSSSSOOOO ezmlm-make(1), ezmlm-return(1), ezmlm-send(1), ezmlm-sub(1), ezmlm-unsub(1), ezmlm-list(1), ezmlm(5), qmail-command(8) SunOS 5.11 Last change: 7