Commit | Line | Data |
---|---|---|
f8beb284 MW |
1 | .TH ezmlmsubrc 5 |
2 | .SH NAME | |
3 | ezmlmsubrc \- set up a minimal sublist | |
4 | .SH SYNOPSIS | |
5 | .B ezmlm-make | |
6 | .B \-C ezmlmsubrc | |
7 | .B -options | |
8 | .I dir dot local host | |
9 | .SH DESCRIPTION | |
10 | .B ezmlmglrc | |
11 | instructs | |
12 | .B ezmlm-make(1) | |
13 | to create | |
14 | .I dir | |
15 | and files within it to support the | |
16 | .I local\fB@\fIhost | |
17 | sublist. The sublist handles bounces, but not subscriptions. It is intended | |
18 | for creation of sublists that are part of an SQL database supported distributed | |
19 | ezmlm list. For creation of regular sublists, use | |
20 | .B ezmlm-make(1) | |
21 | with | |
22 | .BR ezmlmrc(5) . | |
23 | .SH "REQUIRED SWITCHES" | |
24 | While these switches can be omitted, the list will not function unless they | |
25 | are specified. | |
26 | .TP | |
27 | .B \-3\fI mainlocal | |
28 | Local name of the main list for which this list is a sublist. If the sublist | |
29 | is a sublist for digests, | |
30 | .I mainlocal | |
31 | should refer to the mail list, i.e. stripped of ``-digest''. This is required | |
32 | in order for the bounce texts to refer to the correct archive. Use the | |
33 | .B \-d | |
34 | switch! | |
35 | .TP | |
36 | .B \-4\fI mainhost | |
37 | Host name of the main list for which this list is a sublist. | |
38 | .TP | |
39 | .B \-6\fI host:port:user:pass:db:table | |
40 | SQL connect info. Specifies the host and port to connect to, the user/password | |
41 | to use, the database name, and the root table name. | |
42 | The host defaults to ``localhost'', the database and table to ``ezmlm''. The | |
43 | port default is the default for the particular SQL server type used. For | |
44 | sublists disseminating a digest, ``table'' will end in ``_digest''. | |
45 | .SH OPTIONS | |
46 | .TP | |
47 | .B \-d | |
48 | This sublist is a sublist of a digest list. | |
49 | The | |
50 | .B \-3 | |
51 | argment used should be the local name of the main list, rather than | |
52 | the digest list, i.e. the terminal ``-digest'' should be stripped. | |
53 | .TP | |
54 | .B \-5\fI owner | |
55 | The address to which to redirect mail send to | |
56 | .IR local-\fBowner@\fIhost . | |
57 | The default is the owner address for the main list. | |
58 | .SH USAGE | |
59 | A common task is to create both a sublist for the main list and a sublist | |
60 | for the corresponding digest. Note that the local list names are given | |
61 | as is, whereas the main list name always refers to the main list itself | |
62 | (and not its digest). The main list is ``mainloc@mainhost'', the local | |
63 | sublist is ``me-sub1@myhost''; the main digest is ``mainloc-digest@mainhost'' | |
64 | and the local digest sublist is ``me-sub1-digest@myhost''. | |
65 | ||
66 | .EX | |
67 | ezmlm-make -Cezmlmsubrc -3 mainloc -4 mainhost -6 mainhost::user:pw:db:tab | |
68 | ~/DIR ~me/.qmail-sub1 me-sub1 myhost | |
69 | .EE | |
70 | ||
71 | .EX | |
72 | ezmlm-make -Cezmlmsubrc -d -3 mainloc -4 mainhost -6 mainhost::user:pw:db:tab | |
73 | \-d ~/DIR ~me/.qmail-sub1-digest me-sub1-digest myhost | |
74 | .EE | |
75 | .SH "SEE ALSO" | |
76 | ezmlm-make(1), | |
77 | ezmlm(5), | |
78 | ezmlmrc(5) | |
79 |