Poster of Linux kernelThe best gift for a Linux geek
MU

MU

Section: User Manuals (CFIND) Updated: 1
Local index Up

 

NAME

mu cfind - find contacts in the mu database and export them for use in other programs.

 

SYNOPSIS

mu cfind [options] [<pattern>]

 

DESCRIPTION

mu cfind is the mu command for finding contacts (name and e-mail address of people who were either the sender or receiver of mail). There are different output formats available, for importing the contacts into various tools.

 

SEARCHING CONTACTS

When you index your messages (see mu index), mu creates a list of unique e-mail addresses found, and the accompanying name. In case the same e-mail address is used with different names, the most recent non-empty name is used.

mu cfind starts a search for contacts that match a regular expression. For example:

   $ mu cfind '@gmail.com'

would find all contacts with a gmail-address, while

   $ mu cfind Mary

would find all contact with Mary in either name or e-mail address.

If you do not specify any search expression, mu cfind will return the full list of contacts.

The regular expressions are Perl-compatible (as per the PCRE-library).

 

OPTIONS

--format=plain|mutt-alias|mutt-ab|wl|org-contact|bbdb|csv
set the output format to the given value. The following are available:

| --format=   | description                       |
|-------------+-----------------------------------|
| plain       | default, simple list              |
| mutt-alias  | mutt alias-format                 |
| mutt-ab     | mutt external address book format |
| wl          | wanderlust addressbook format     |
| org-contact | org-mode org-contact format       |
| bbdb        | BBDB format                       |
| csv         | comma-separated values            |

 

RETURN VALUE

mu cfind returns 0 upon successful completion; if it the a search was performed, there needs to be a least one match. Anything else leads to a non-zero return value, for example:

| code | meaning | |------+--------------------------------| | 0 | ok | | 1 | general error | | 2 | no matches (for 'mu cfind') |

 

INTEGRATION WITH MUTT

You can use mu cfind as an external address book server for mutt. For this to work add the following to your muttrc:

set query_command = "mu cfind --format=mutt-ab '%s'"

Now, in mutt, you can easily search for e-mail address using the query-command, which is by default accessible by pressing Q.

 

BUGS

Please report bugs if you find them at http://code.google.com/p/mu0/issues/list.

 

AUTHOR

Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>

 

SEE ALSO

mu(1)mu-index(1)mu-find(1)pcrepattern(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
SEARCHING CONTACTS
OPTIONS
RETURN VALUE
INTEGRATION WITH MUTT
BUGS
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 07:53:10 GMT, June 15, 2011