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 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 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 MERCHANTABILITY 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)