Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
LURKER-INDEX(1)		    General Commands Manual	       LURKER-INDEX(1)

       lurker-index -- imports messages	into the archive

       lurker-index  [-c <config-file>]	 [-l <list>]  [-i <mbox/maildir>]  [-v
       -d -n -u	-f]  [-m]

       lurker-index indexes messages from standard input and  stores  them  in
       the lurker database.  It	imports	either a single	message, or a batch of
       messages	in mbox	format.

       It is important to note that lurker messages in order and may miss  new
       messages	delivered during the import. For this reason, you should setup
       lurker to  receive  new	mail  before  importing	 old  mail.  Only  use
       lurker-index on inactive	mail folders!

       By  default, lurker-index reads from standard input in mbox format, de-
       limited by 'From	<addr> <date>' lines.  Be aware	that if	 the  mbox  is
       not  delimited  correctly between messages it will be interpretted as a
       single message with an invalid date. To read  other  sources,  see  the
       '-i' option.  If	input is a single email, use '-m'.

       -c config-file
		 Use this config file for lurker settings.

       -l listid Import	 messages to the named mailing list. This should match
		 the value in the lurker.conf after the	'list =	' entry.

       -m	 Import	a single message. In this mode lurker will  never  in-
		 terpret  'From	 ' lines as message delimiters.	When being fed
		 newly delivered mail, this is the preferred  mode  of	opera-
		 tion.	 Try to	turn off the 'From ' escaping of your MTA when
		 using this mode, as lurker does it's own  escaping  which  is
		 generally smarter.

		 This  option  should  be used when lurker-index is invoked by
		 the MTA for newly delivered email.

       -i mbox/maildir
		 Import	 messages  from	 the  specified	 mailbox  or  maildir.
		 Lurker-index  by  default  reads a mailbox (mbox format) from
		 standard input. If the	'-i' parameter is a file, the file  is
		 assumed to be in the mbox format and is read instead of stan-
		 dard input.  If the parameter is a directory,	the  directory
		 is assumed to be in maildir format.

		 If  '-m'  is  used, the input MUST be a raw email, preferably
		 with a	mbox header, never a maildir.

       -v	 Verbose operation. Lurker will	output statistics about	import
		 speed	to  assist you in tweaking options for best throughput
		 on your system. It also helps you know	how  much  longer  you
		 will have to wait.

       -d	 Drop duplicates per list. This	option will check the database
		 to see	if the message has already been	imported to a  mailing
		 list.	Only if	it has not been	imported will lurker append it
		 to the	mailbox. Even without this option lurker does not  in-
		 dex  a	 message  twice. If an import failed part-way through,
		 you probably want this	option to avoid	needless  replication.
		 However,  to  generate	mailboxes which	accurately reflect de-
		 livery, leave the option off.

       -n	 Don't compress	messages. This will increase the database size
		 and  import  speed.  Lurker  can handle a database with mixed
		 compressed and	uncompressed messages. However,	zcat/gzip  and
		 database  upgrades cannot. If you need	these to function, you
		 should	never mix compressed and uncompressed messages	within
		 a single mailing list.

       -u	 Trust user Date headers from the email	more than the delivery
		 time. Normally	lurker compares	the two	and if the  user  time
		 differs too much from the delivery time, the delivery time is
		 used instead.	When this option is used, lurker  will	simply
		 trust	the  user Date header whenever it exists, otherwise it
		 uses the delivery time.

		 This option should never be used as a default.	It is intended
		 for  dealing with corrupt mailboxes or	maildirs. A better so-
		 lution	than using this	option is to find an uncorrupted  copy
		 of the	mail.

       -f	 Fast  import  (but vulnerable to power-failure). This may im-
		 prove the lifetime of	your  hard-disk	 and  increase	import
		 speed by up to	30%. However, if the power fails during	import
		 or shortly thereafter,	it is possible you will	 have  a  cor-
		 rupted	 database.  If you use a journaling filesystem,	lurker
		 guarantees no corruption when you OMIT	this parameter.

       lurker-prune(1),	lurker-params(1), lurker-list(1), lurker-search(1)

       lurker documentation on

       Copyright (C) 2002: Wesley W. Terpstra <>

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the	GNU General Public License as published	by the
       Free Software Foundation; version 2.

       This program is distributed in the hope that it	will  be  useful,  but
       WITHOUT	ANY  WARRANTY;	without	 even  the  implied  warranty  of MER-
       Public License for more details.

       You should have received	a copy of the GNU General Public License along
       with this program; if not, write	to the Free Software Foundation, Inc.,
       59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

       Before  reporting a bug,	please confirm that the	bug you	found is still
       present in the latest official release. If the problem  persists,  then
       send  mail  with	 instructions  describing  how to reproduce the	bug to



Want to link to this manual page? Use this URL:

home | help