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

FreeBSD Manual Pages

  
 
  

home | help
NOTMUCH-ADDRESS(1)		    notmuch		    NOTMUCH-ADDRESS(1)

NAME
       notmuch-address - output	addresses from matching	messages

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
       <search-terms>.

       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 sep-
	      arated  plain-text  (compatible  with  xargs(1)  -0 option where
	      available).

       --format-version=N
	      Use the specified	structured output format version. This is  in-
	      tended  for programs that	invoke notmuch(1) internally. If omit-
	      ted, the latest supported	version	will be	used.

       --output=(sender|recipients|count|address)
	      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,	--out-
	      put=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 encoun-
		     tered during search.

		     Note:  With this option, addresses	are printed only after
		     the whole search is finished. This	may take long time.

	      address
		     Output only the email addresses instead of	the full mail-
		     boxes  with names and email addresses. This option	has no
		     effect on the JSON	or S-Expression	output formats.

       --deduplicate=(no|mailbox|address)
	      Control the deduplication	of results.

	      no     Output all	occurrences of addresses in the	matching  mes-
		     sages. 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  de-
		     fault.

	      address
		     Deduplicate  addresses  based on the case insensitive ad-
		     dress part	of the mailbox.	Of all the variants (with dif-
		     ferent  name  or case), print the one occurring most fre-
		     quently among the matching	messages. If --output=count is
		     specified,	include	all variants in	the count.

       --sort=(newest-first|oldest-first)
	      This option can be used to present results in either chronologi-
	      cal order	(oldest-first) or reverse  chronological  order	 (new-
	      est-first).

	      By  default,  results will be displayed in reverse chronological
	      order, (that is, the newest results will be displayed first).

	      However, if either --output=count	 or  --deduplicate=address  is
	      specified,  this	option is ignored and the order	of the results
	      is unspecified.

       --exclude=(true|false)
	      A	message	is called "excluded" if	it matches at least one	tag in
	      search.exclude_tags  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	match-
	      ing 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), not-
       much-hooks(5),  notmuch-insert(1),  notmuch-new(1),   notmuch-reply(1),
       notmuch-restore(1),   notmuch-search-terms(7),	notmuch-show(1),  not-
       much-tag(1), notmuch-search(1)

AUTHOR
       Carl Worth and many others

COPYRIGHT
       2009-2020, Carl Worth and many others

0.31.3				 Feb 28, 2021		    NOTMUCH-ADDRESS(1)

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=notmuch-address&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help