Initial creation
[ikiwiki.git] / docs / user / mailing_list_commands / index.mdwn
1 The DragonFly mailing lists use BestServ to handle mailing list administration
2
3 ## For the impatient
4
5 Mail **listname-request@dragonflybsd.org**, where **listname** is the name of the mailing list you want to subscribe to.  You will get a confirmation email.  Reply to this email after changing "REJECT" to "ACCEPT" in the subject.
6
7 If you want to test your subscription, use the test@dragonflybsd.org list.
8
9
10 ## Synopsis of BestServ list aliases
11
12       listname - post to the list
13       listname-response - authentication responses sent here
14       listname-request - send subscribe/unsubscribe/etc...
15       listname-command - send moderator command requests
16       listname-errors - (error return for bounces, invisible)
17       listname-owner - send mail to the moderator of the list
18
19       bestserv-owner - moderator of the whole mailing list manager
20       bestserv-errors - (error return for bounces, invisible)
21
22 ## Getting This Help File
23
24 Email a message to the request address of the list. For example, if the list is called 'test', you would email a message to 'test-request@hostname.domain'. On this server, it would be 'test-request@lists.dragonflybsd.org'.
25
26 The body of the message should contain a single line, left justified, containing the keyword 'help' in lower case.
27
28 The list server will generally respond with this help file.
29
30 ##  Authentication
31
32 Many of the requests you make to the list server requires authentication. The list server authenticates a request by emailing a message back to you with a special Subject: line. The message contains complete iunstructions. You normally Reply the message (such that the original Subject is still in the Subject: header, possibly with an Re: in front of it). You must edit the REJECT clause in the Subject line to say ACCEPT if you want to go ahead and run your original command.
33
34 You must be sure to leave the ID clause intact or the list manager will not be able to authenticate your request.
35
36 The purpose of authentication is to ensure that a valid return email address exists and to disuade spammers from crashing the list. The moderator has the ability to turn on authentication AND moderation for any request, so you may not get an immediate response.
37
38 ## Subscribing
39
40 To subscribe to a list you normally send email to the -request address of the list, as in 'test-request@hostname.domain'. The body of the message should contain the keyword 'subscribe' alone or, if you want to subscribe a third party address, the subscribe keyword may be followed by an email address.
41
42       subscribe
43
44 or
45
46       subscribe email-address
47
48 Unless the list is a digest-only list you will receive an email for each posting to the list. If you wish to receive a digest version of the list (which could be delayed by a few hours) use the subdigest command instead of subscribe. 
49
50 ## Third Party Subscribes
51
52 A Third Party Subscribe occurs when person A subscribes person B rather then just himself. This is normally allowed. The list manager will most likely have recipient verification turned on, which means that person B will be sent an email asking him or her to acknowledge the subscription before that person is actually added to the list.
53
54 If you receive a third party verification request and you do not want to be on the list, simply ignore the mail. 
55
56 ## Posting from multiple email addresses
57
58 By default, most lists only allow subscribed addresses to post to the list. You can add other addresses to the list with the 'alias' command.
59
60       alias email-address
61
62 This allows you to post to the list from another email-address without the list distribution being sent to that address. You can add as many aliases as you like. 
63
64 ## Unsubscribing
65
66 To unsubscribe from a list, send the 'unsubscribe' command. You can also unsubscribe third parties by adding an email address.
67
68       unsubscribe
69
70 or
71
72       unsubscribe email-address
73
74 Note that if you have several list aliases, you should unsubscribe from those aliases as well as the one you are receiving the list on. 
75
76 ## List Information
77
78 You can request list-specific information with the 'info' command.