=============== notmuch-address =============== SYNOPSIS ======== **notmuch** **address** [*option* ...] <*search-term*> ... DESCRIPTION =========== Search for messages matching the given search terms, and display the addresses from them. Duplicate addresses are filtered out. See **notmuch-search-terms(7)** for details of the supported syntax for . Supported options for **address** include ``--format=``\ (**json**\ \|\ **sexp**\ \|\ **text**\ \|\ **text0**) Presents the results in either JSON, S-Expressions, newline character separated plain-text (default), or null character separated plain-text (compatible with **xargs(1)** -0 option where available). ``--format-version=N`` Use the specified structured output format version. This is intended for programs that invoke **notmuch(1)** internally. If omitted, the latest supported version will be used. ``--output=(sender|recipients|count)`` Controls which information appears in the output. This option can be given multiple times to combine different outputs. When neither --output=sender nor --output=recipients is given, --output=sender is implied. **sender** Output all addresses from the *From* header. Note: Searching for **sender** should be much faster than searching for **recipients**, because sender addresses are cached directly in the database whereas other addresses need to be fetched from message files. **recipients** Output all addresses from the *To*, *Cc* and *Bcc* headers. **count** Print the count of how many times was the address encountered during search. Note: With this option, addresses are printed only after the whole search is finished. This may take long time. ``--deduplicate=(no|mailbox)`` Control the deduplication of results. **no** Output all occurences of addresses in the matching messages. This is not applicable with --output=count. **mailbox** Deduplicate addresses based on the full, case sensitive name and email address, or mailbox. This is effectively the same as piping the --deduplicate=no output to **sort | uniq**, except for the order of results. This is the default. ``--sort=``\ (**newest-first**\ \|\ **oldest-first**) This option can be used to present results in either chronological order (**oldest-first**) or reverse chronological order (**newest-first**). By default, results will be displayed in reverse chronological order, (that is, the newest results will be displayed first). This option is not supported with --output=count. ``--exclude=(true|false)`` A message is called "excluded" if it matches at least one tag in search.tag\_exclude that does not appear explicitly in the search terms. This option specifies whether to omit excluded messages in the search process. The default value, **true**, prevents excluded messages from matching the search terms. **false** allows excluded messages to match search terms and appear in displayed results. EXIT STATUS =========== This command supports the following special exit status codes ``20`` The requested format version is too old. ``21`` The requested format version is too new. SEE ALSO ======== **notmuch(1)**, **notmuch-config(1)**, **notmuch-count(1)**, **notmuch-dump(1)**, **notmuch-hooks(5)**, **notmuch-insert(1)**, **notmuch-new(1)**, **notmuch-reply(1)**, **notmuch-restore(1)**, **notmuch-search-terms(7)**, **notmuch-show(1)**, **notmuch-tag(1)**, **notmuch-search(1)**