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

FreeBSD Manual Pages

  
 
  

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

NAME
       lurker-index -- imports messages	into the archive

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

DESCRIPTION
       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'.

OPTIONS
       -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.

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

       lurker documentation on http://lurker.sourceforge.net/

COPYRIGHT
       Copyright (C) 2002: Wesley W. Terpstra <terpstra@users.sourceforge.net>

       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-
       CHANTABILITY  or	FITNESS	FOR A PARTICULAR PURPOSE.  See the GNU General
       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.

BUGS
       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
       <lurker-users@lists.sourceforge.net>.

							       LURKER-INDEX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lurker-index&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help