.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MAILMAN2LURKER 8" .TH MAILMAN2LURKER 8 "2016-12-20" " " "Administrative commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" mailman2lurker \- Import mailman lists and their archives into a lurker database. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \fBmailman2lurker\fR \fB\-i\fR|\fB\-p\fR [\fIoptions\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBmailman2lurker\fR 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. .PP To build a new lurker database from mailmans archives, first run \&'\fBmailman2lurker \-p\fR'. Next you need to add '\fBinclude = /etc/lurker/lurker.conf.mailman\fR' into /etc/lurker/lurker.conf.local. Finally import mailmans mboxes by running '\fBmailman2lurker \-i\fR'. .PP If you want to add new lists to an already existing lurker configuration, run \&'\fBmailman2lurker \-p \-w newlists\fR' and afterwards '\fBmailman2lurker \-i \-f newlists\fR'. This will import only the mbox files of mailman lists that have been added to the lurker configuration because they were new to lurker. .SH "COMMANDS" .IX Header "COMMANDS" .IP "\fB\-p\fR, \fB\-\-parse\fR" 4 .IX Item "-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. .IP "\fB\-i\fR, \fB\-\-import\fR" 4 .IX Item "-i, --import" Import archives of all lists. This parses the lurker configuration and imports the mailman mbox at /var/lib/mailman/archives/private/.mbox/.mbox for every list. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-c\fR, \fB\-\-config\fR <\fIconfig\fR>" 4 .IX Item "-c, --config " Use <\fIconfig\fR> as lurker configuration file. Default: /etc/lurker/lurker.conf .IP "\fB\-o\fR, \fB\-\-outfile\fR <\fIoutfile\fR>" 4 .IX Item "-o, --outfile " Write list configuration to <\fIoutfile\fR>. If this is not specified, .mailman will be used. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-g\fR, \fB\-\-group\fR <\fIgroup\fR>" 4 .IX Item "-g, --group " Use <\fIgroup\fR> for new lists. Default is 'undef'. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-a\fR, \fB\-\-listhost\fR <\fIlisthost\fR>" 4 .IX Item "-a, --listhost " Use <\fIlisthost\fR> as host for new list addresses. If a new list is called \&'mylist' and <\fIlisthost\fR> is lists.org, then the list address will be mylist@lists.org. Default is 'example.org'. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-l\fR, \fB\-\-link\fR <\fIurl link\fR>" 4 .IX Item "-l, --link " Use <\fIurl link\fR> as base for links of new lists. If a list is called 'mylist', and <\fIurl link\fR> 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 \fB\-p\fR. .IP "\fB\-s\fR, \fB\-\-lang\fR <\fIlanguage\fR>" 4 .IX Item "-s, --lang " Use <\fIlanguage\fR> as language for new lists. Needs to be a language token. Default is 'en'. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-w\fR, \fB\-\-write\-lists\fR <\fIfile\fR>" 4 .IX Item "-w, --write-lists " Write a list of all lists that have been added to the lurker configuration. Safe that list in <\fIfile\fR>. Default is off. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-x\fR, \fB\-\-list\-cmd\fR <\fIfile\fR>" 4 .IX Item "-x, --list-cmd " Use <\fIcommand|file\fR> to get the list of mailman lists that should be parsed. When <\fIcommand|file\fR> is a command, it needs to end with ' |'. Default is '/var/lib/mailman/bin/list_lists |'. This option is only useful in conjunction with \fB\-p\fR. .IP "\fB\-f\fR, \fB\-\-listfile\fR <\fIfile\fR>" 4 .IX Item "-f, --listfile " Import only lists that are listed in <\fIfile\fR>. This option is only useful in conjunction with \fB\-i\fR. .IP "\fB\-d\fR, \fB\-\-lists\fR <\fIone\fR[,\fItwo\fR,\fI...\fR]>" 4 .IX Item "-d, --lists " Import only lists that are given as argument. This option is only useful in conjunction with \fB\-i\fR. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Display a help message. .IP "\fB\-v\fR, \fB\-\-version\fR" 4 .IX Item "-v, --version" Display mailman2lurker's version number. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIlist_lists\fR\|(8), \fIlurker\-index\fR\|(8) .SH "AUTHOR" .IX Header "AUTHOR" This program was written by Jonas Meurer . .SH "COPYRIGHT" .IX Header "COPYRIGHT" mailman2lurker may be copied and modified under the terms of the \s-1GNU\s0 General Public License.