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

  
 
  

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 mes-
     sages in mbox format.

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

     By default, lurker-index reads from standard input in mbox  format,  delim-
     ited  by  'From <addr> <date>' lines.  Be aware that if the mbox is not de-
     limited correctly between messages it will be interpretted as a single mes-
     sage 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  deliv-
	       ered  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 stan-
	       dard 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  up-
	       grades  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  dif-
	       fers  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 deliv-
	       ery 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  there-
	       after,  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 un-
     der 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 FIT-
     NESS 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.1.quarterly>

home | help