oracular (1) lbdb-fetchaddr.1.gz

NAME

       lbdb-fetchaddr - grab addresses from mails and append them to lbdb database

SYNOPSIS

       lbdb-fetchaddr [-d dateformat] [-x headerfieldlist] [-c charset] [-a] [-f databasefile]
       lbdb-fetchaddr [-v|-h]

DESCRIPTION

       lbdb-fetchaddr  is  a  shell  script which reads a mail on stdin. It extracts the contents of some header
       fields (default: `From:', `To:', `Cc:', `Resent-From:', and `Resent-To:')  from  the  mail  header  (only
       addresses   with   a   real   name)   and   appends   them  to  the  database  file,  which  defaults  to
       $XDG_DATA_HOME/lbdb/m_inmail.db or $HOME/.lbdb/m_inmail.utf-8 if  the  latter  already  exists  (backward
       compatibility).

       For  performance issues lbdb-fetchaddr appends new addresses to this file without removing duplicates. To
       get rid of duplicates, the program lbdb-munge exists, which is run by  m_inmail  if  needed  and  removes
       duplicates.

       To use this program, put the following lines into your $HOME/.procmailrc:
            :0hc
            | lbdb-fetchaddr

       lbdb-fetchaddr  writes the actual date to the third column of the database by using strftime(3).  It uses
       "%Y-%m-%d %H:%M" as the default date format (e.g. "1999-04-29 14:33"). You can change this by  using  the
       -d option to select a different date format string as parameter of lbdb-fetchaddr command like
            :0hc
            | lbdb-fetchaddr -d "%y-%m-%d"
       which results in e.g. "99-04-29".

OPTIONS

       -v     Print version number of lbdb-fetchaddr.

       -h     Print short help of lbdb-fetchaddr.

       -d dateformat
              Use the given date format using strftime(3) syntax.

       -x headerfields
              A  colon  separated  list  of header fields, which should be searched for mail addresses.  If this
              option isn't given, we fall back to `from:to:cc:resent-from:resent-to'.

       -c charset
              The charset which will be used to write the  database.  This  should  be  the  charset  which  the
              application  expects  (normally the one from your current locale).  If this option isn't given, we
              fall back to `utf-8'.

       -a     Also grab addresses without a real name.  Use the local part of the mail address as real name.

       -f databasefile
              Use   the   given   file   for   storing   the   grabbed   addresses   instead   of   using    the
              $XDG_DATA_HOME/lbdb/m_inmail.db resp.  $HOME/.lbdb/m_inmail.utf-8 default.

FILES

       $XDG_DATA_HOME/lbdb/m_inmail.db
       $HOME/.lbdb/m_inmail.utf-8 (old version before using $XDG_DATA_HOME)
       $HOME/.lbdb/m_inmail.list (old version used for ISO-8859-15 encoded addresses)
       /usr/lib/lbdb/fetchaddr
       /usr/lib/lbdb/m_inmail

SEE ALSO

       lbdbq(1), lbdb_dotlock(1), procmail(1), procmailrc(5), strftime(3).

CREDITS

       Most  of  the  really  interesting code of this program (namely, the RFC 822 address parser used by lbdb-
       fetchaddr) was stolen from Michael Elkins' mutt mail user agent. Additional credits go  to  Brandon  Long
       for putting the query functionality into mutt.

AUTHOR

       The  lbdb package was written by Thomas Roessler <roessler@guug.de> and is now maintained and extended by
       Roland Rosenfeld <roland@spinnaker.de>.