MAILMAN2LURKER(8) Administrative commands MAILMAN2LURKER(8)
NAME
mailman2lurker - Import mailman lists and their archives into a lurker database.
SYNOPSIS
mailman2lurker -i|-p [options]
DESCRIPTION
mailman2lurker has mainly two functions. First, it parses mailman's lists and creates a lurker configuration include out of them. Second,
it imports archives from mailman lists into a lurker database.
To build a new lurker database from mailmans archives, first run 'mailman2lurker -p'. Next you need to add 'include =
/etc/lurker/lurker.conf.mailman' into /etc/lurker/lurker.conf.local. Finally import mailmans mboxes by running 'mailman2lurker -i'.
If you want to add new lists to an already existing lurker configuration, run 'mailman2lurker -p -w newlists' and afterwards
'mailman2lurker -i -f newlists'. This will import only the mbox files of mailman lists that have been added to the lurker configuration
because they were new to lurker.
COMMANDS
-p, --parse
Parse mailman lists, and create a lurker configuration include file containing all parsed lists. Lists that are already configured in
lurker are ignored.
-i, --import
Import archives of all lists. This parses the lurker configuration and imports the mailman mbox at
/var/lib/mailman/archives/private/<list>.mbox/<list>.mbox for every list.
OPTIONS
-c, --config <config>
Use <config> as lurker configuration file. Default: /etc/lurker/lurker.conf
-o, --outfile <outfile>
Write list configuration to <outfile>. If this is not specified, <lurker.conf>.mailman will be used. This option is only useful in
conjunction with -p.
-g, --group <group>
Use <group> for new lists. Default is 'undef'. This option is only useful in conjunction with -p.
-a, --listhost <listhost>
Use <listhost> as host for new list addresses. If a new list is called 'mylist' and <listhost> is lists.org, then the list address will
be mylist@lists.org. Default is 'example.org'. This option is only useful in conjunction with -p.
-l, --link <url link>
Use <url link> as base for links of new lists. If a list is called 'mylist', and <url link> is 'http://lists.org', then the link
address will be http://lists.org/mylist. Default is 'http://example.org'. This option is only useful in conjunction with -p.
-s, --lang <language>
Use <language> as language for new lists. Needs to be a language token. Default is 'en'. This option is only useful in conjunction
with -p.
-w, --write-lists <file>
Write a list of all lists that have been added to the lurker configuration. Safe that list in <file>. Default is off. This option is
only useful in conjunction with -p.
-x, --list-cmd <file>
Use <command|file> to get the list of mailman lists that should be parsed. When <command|file> is a command, it needs to end with '
|'. Default is '/var/lib/mailman/bin/list_lists |'. This option is only useful in conjunction with -p.
-f, --listfile <file>
Import only lists that are listed in <file>. This option is only useful in conjunction with -i.
-d, --lists <one[,two,...]>
Import only lists that are given as argument. This option is only useful in conjunction with -i.
-h, --help
Display a help message.
-v, --version
Display mailman2lurker's version number.
SEE ALSO
list_lists(8), lurker-index(8)
AUTHOR
This program was written by Jonas Meurer <jonas@freesources.org>.
COPYRIGHT
mailman2lurker may be copied and modified under the terms of the GNU General Public License.
2011-09-19 MAILMAN2LURKER(8)