1 <h1>NOTMUCH-ADDRESS(1)</h1>
5 notmuch-address - output addresses from matching messages
10 <b>notmuch</b> <b>address</b> [<u>option</u> ...] <<u>search-term</u>> ...
15 Search for messages matching the given search terms, and display the
16 addresses from them. Duplicate addresses are filtered out.
18 See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of the supported syntax for
21 Supported options for <b>address</b> include
23 <b>--format=(json|sexp|text|text0)</b>
24 Presents the results in either JSON, S-Expressions, newline
25 character separated plain-text (default), or null character
26 separated plain-text (compatible with <b>xargs</b>(1) -0 option
29 <b>--format-version=N</b>
30 Use the specified structured output format version. This is
31 intended for programs that invoke <a href='../notmuch-1/'>notmuch</a>(1) internally. If
32 omitted, the latest supported version will be used.
34 <b>--output=(sender|recipients|count)</b>
35 Controls which information appears in the output. This option
36 can be given multiple times to combine different outputs. When
37 neither --output=sender nor --output=recipients is given, --out‐
38 put=sender is implied.
40 <b>sender</b> Output all addresses from the <u>From</u> header.
42 Note: Searching for <b>sender</b> should be much faster than
43 searching for <b>recipients</b>, because sender addresses are
44 cached directly in the database whereas other addresses
45 need to be fetched from message files.
48 Output all addresses from the <u>To</u>, <u>Cc</u> and <u>Bcc</u> headers.
50 <b>count</b> Print the count of how many times was the address encoun‐
53 Note: With this option, addresses are printed only after
54 the whole search is finished. This may take long time.
56 <b>--sort=(newest-first|oldest-first)</b>
57 This option can be used to present results in either chrono‐
58 logical order (<b>oldest-first</b>) or reverse chronological order
59 (<b>newest-first</b>).
61 By default, results will be displayed in reverse chronologi‐
62 cal order, (that is, the newest results will be displayed
65 This option is not supported with --output=count.
67 <b>--exclude=(true|false)</b>
68 A message is called "excluded" if it matches at least one tag
69 in search.tag_exclude that does not appear explicitly in the
70 search terms. This option specifies whether to omit excluded
71 messages in the search process.
73 The default value, <b>true</b>, prevents excluded messages from
74 matching the search terms.
76 <b>false</b> allows excluded messages to match search terms and
77 appear in displayed results.
82 This command supports the following special exit status codes
84 <b>20</b> The requested format version is too old.
86 <b>21</b> The requested format version is too new.
91 <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not‐</a>
92 <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-insert-1/'>notmuch-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
93 <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>not‐</a>
94 <a href='../notmuch-tag-1/'>much-tag</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1)
99 Carl Worth and many others
104 2014, Carl Worth and many others