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, delimited 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 interpret 'From ' lines as message delimiters. When being fed newly
		 delivered mail, this is the preferred mode of operation.  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 standard  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 index 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 delivery, 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 com-
		 pressed 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 solution
		 than using this option is to find an uncorrupted copy of the mail.

       -f	 Fast import (but vulnerable to power-failure). This may improve 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 corrupted 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)