3
3
eval 'exec /usr/bin/perl -w -S $0 ${1+"$@"}'
4
4
if 0; # not running under some shell
6
# to create a manpage for mailman2lurker, invoke the following command:
7
# pod2man --section=8 --center="Administrative commands" --release="" mailman2lurker mailman2lurker.8
11
mailman2lurker - Import mailman lists and their archives into a lurker database.
15
Z<> B<mailman2lurker> B<-i>|B<-p> [I<options>]
19
B<mailman2lurker> has mainly two functions. First, it parses mailman's lists
20
and creates a lurker configuration include out of them. Second, it imports
21
archives from mailman lists into a lurker database.
23
To build a new lurker database from mailmans archives, first run
24
'B<mailman2lurker -p>'. Next you need to add 'B<include =
25
/etc/lurker/lurker.conf.mailman>' into /etc/lurker/lurker.conf.local.
26
Finally import mailmans mboxes by running 'B<mailman2lurker -i>'.
28
If you want to add new lists to an already existing lurker configuration, run
29
'B<mailman2lurker -p -w newlists>' and afterwards 'B<mailman2lurker -i -f
30
newlists>'. This will import only the mbox files of mailman lists that have been
31
added to the lurker configuration because they were new to lurker.
37
=item B<-p>, B<--parse>
39
Parse mailman lists, and create a lurker configuration include file containing
40
all parsed lists. Lists that are already configured in lurker are ignored.
42
=item B<-i>, B<--import>
44
Import archives of all lists. This parses the lurker configuration and imports
45
the mailman mbox at /var/lib/mailman/archives/private/<list>.mbox/<list>.mbox
52
=item B<-c>, B<--config> <I<config>>
54
Use <I<config>> as lurker configuration file. Default: /etc/lurker/lurker.conf
56
=item B<-o>, B<--outfile> <I<outfile>>
58
Write list configuration to <I<outfile>>. If this is not specified,
59
<lurker.conf>.mailman will be used.
60
This option is only useful in conjunction with B<-p>.
62
=item B<-g>, B<--group> <I<group>>
64
Use <I<group>> for new lists. Default is 'undef'.
65
This option is only useful in conjunction with B<-p>.
67
=item B<-a>, B<--listhost> <I<listhost>>
69
Use <I<listhost>> as host for new list addresses. If a new list is called
70
'mylist' and <I<listhost>> is lists.org, then the list address will be
71
mylist@lists.org. Default is 'example.org'.
72
This option is only useful in conjunction with B<-p>.
74
=item B<-l>, B<--link> <I<url link>>
76
Use <I<url link>> as base for links of new lists. If a list is called 'mylist',
77
and <I<url link>> is 'http://lists.org', then the link address will be
78
http://lists.org/mylist. Default is 'http://example.org'.
79
This option is only useful in conjunction with B<-p>.
81
=item B<-s>, B<--lang> <I<language>>
83
Use <I<language>> as language for new lists. Needs to be a language token.
84
Default is 'en'. This option is only useful in conjunction with B<-p>.
86
=item B<-w>, B<--write-lists> <I<file>>
88
Write a list of all lists that have been added to the lurker configuration.
89
Safe that list in <I<file>>. Default is off.
90
This option is only useful in conjunction with B<-p>.
92
=item B<-x>, B<--list-cmd> <I<file>>
94
Use <I<command|file>> to get the list of mailman lists that should be parsed.
95
When <I<command|file>> is a command, it needs to end with ' |'.
96
Default is '/var/lib/mailman/bin/list_lists |'.
97
This option is only useful in conjunction with B<-p>.
99
=item B<-f>, B<--listfile> <I<file>>
101
Import only lists that are listed in <I<file>>.
102
This option is only useful in conjunction with B<-i>.
104
=item B<-d>, B<--lists> <I<one>[,I<two>,I<...>]>
106
Import only lists that are given as argument.
107
This option is only useful in conjunction with B<-i>.
109
=item B<-h>, B<--help>
111
Display a help message.
113
=item B<-v>, B<--version>
115
Display mailman2lurker's version number.
119
L<list_lists(8)>, L<lurker-index(8)>
123
This program was written by Jonas Meurer <jonas@freesources.org>.
127
mailman2lurker may be copied and modified under the terms of the GNU General
132
6
our $Version="0.2";
237
# to create a manpage for mailman2lurker, invoke the following command:
238
# pod2man --section=8 --center="Administrative commands" --release="" mailman2lurker mailman2lurker.8
242
mailman2lurker - Import mailman lists and their archives into a lurker database.
246
Z<> B<mailman2lurker> B<-i>|B<-p> [I<options>]
250
B<mailman2lurker> has mainly two functions. First, it parses mailman's lists
251
and creates a lurker configuration include out of them. Second, it imports
252
archives from mailman lists into a lurker database.
254
To build a new lurker database from mailmans archives, first run
255
'B<mailman2lurker -p>'. Next you need to add 'B<include =
256
/etc/lurker/lurker.conf.mailman>' into /etc/lurker/lurker.conf.local.
257
Finally import mailmans mboxes by running 'B<mailman2lurker -i>'.
259
If you want to add new lists to an already existing lurker configuration, run
260
'B<mailman2lurker -p -w newlists>' and afterwards 'B<mailman2lurker -i -f
261
newlists>'. This will import only the mbox files of mailman lists that have been
262
added to the lurker configuration because they were new to lurker.
268
=item B<-p>, B<--parse>
270
Parse mailman lists, and create a lurker configuration include file containing
271
all parsed lists. Lists that are already configured in lurker are ignored.
273
=item B<-i>, B<--import>
275
Import archives of all lists. This parses the lurker configuration and imports
276
the mailman mbox at /var/lib/mailman/archives/private/<list>.mbox/<list>.mbox
285
=item B<-c>, B<--config> <I<config>>
287
Use <I<config>> as lurker configuration file. Default: /etc/lurker/lurker.conf
289
=item B<-o>, B<--outfile> <I<outfile>>
291
Write list configuration to <I<outfile>>. If this is not specified,
292
<lurker.conf>.mailman will be used.
293
This option is only useful in conjunction with B<-p>.
295
=item B<-g>, B<--group> <I<group>>
297
Use <I<group>> for new lists. Default is 'undef'.
298
This option is only useful in conjunction with B<-p>.
300
=item B<-a>, B<--listhost> <I<listhost>>
302
Use <I<listhost>> as host for new list addresses. If a new list is called
303
'mylist' and <I<listhost>> is lists.org, then the list address will be
304
mylist@lists.org. Default is 'example.org'.
305
This option is only useful in conjunction with B<-p>.
307
=item B<-l>, B<--link> <I<url link>>
309
Use <I<url link>> as base for links of new lists. If a list is called 'mylist',
310
and <I<url link>> is 'http://lists.org', then the link address will be
311
http://lists.org/mylist. Default is 'http://example.org'.
312
This option is only useful in conjunction with B<-p>.
314
=item B<-s>, B<--lang> <I<language>>
316
Use <I<language>> as language for new lists. Needs to be a language token.
317
Default is 'en'. This option is only useful in conjunction with B<-p>.
319
=item B<-w>, B<--write-lists> <I<file>>
321
Write a list of all lists that have been added to the lurker configuration.
322
Safe that list in <I<file>>. Default is off.
323
This option is only useful in conjunction with B<-p>.
325
=item B<-x>, B<--list-cmd> <I<file>>
327
Use <I<command|file>> to get the list of mailman lists that should be parsed.
328
When <I<command|file>> is a command, it needs to end with ' |'.
329
Default is '/var/lib/mailman/bin/list_lists |'.
330
This option is only useful in conjunction with B<-p>.
332
=item B<-f>, B<--listfile> <I<file>>
334
Import only lists that are listed in <I<file>>.
335
This option is only useful in conjunction with B<-i>.
337
=item B<-d>, B<--lists> <I<one>[,I<two>,I<...>]>
339
Import only lists that are given as argument.
340
This option is only useful in conjunction with B<-i>.
342
=item B<-h>, B<--help>
344
Display a help message.
346
=item B<-v>, B<--version>
348
Display mailman2lurker's version number.
354
L<list_lists(8)>, L<lurker-index(8)>
358
This program was written by Jonas Meurer <jonas@freesources.org>.
362
mailman2lurker may be copied and modified under the terms of the GNU General