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

FreeBSD Manual Pages

  
 
  

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

NAME
       notmuch-count - count messages matching the given search	terms

SYNOPSIS
       notmuch count [option ...] <search-term>	...

DESCRIPTION
       Count messages matching the search terms.

       The number of matching messages (or threads) is output to stdout.

       With no search terms, a count of	all messages (or threads) in the data-
       base will be displayed.

       See  notmuch-search-terms  for  details	of  the	 supported  syntax for
       <search-terms>.

       Supported options for count include

       --output=(messages|threads|files)

	      messages
		     Output the	number of matching messages. This is  the  de-
		     fault.

	      threads
		     Output the	number of matching threads.

	      files  Output  the number	of files associated with matching mes-
		     sages. This may be	bigger than  the  number  of  matching
		     messages  due  to	duplicates (i.e. multiple files	having
		     the same message-id).

       --exclude=(true|false)
	      Specify whether to omit  messages	 matching  search.exclude_tags
	      from the count (the default) or not.

       --batch
	      Read  queries  from a file (stdin	by default), one per line, and
	      output the number	of matching messages (or threads)  to  stdout,
	      one  per	line. On an empty input	line the count of all messages
	      (or threads) in the database will	be output. This	option is  not
	      compatible with specifying search	terms on the command line.

       --lastmod
	      Append lastmod (counter for number of database updates) and UUID
	      to  the output. lastmod values are only comparable between data-
	      bases with the same UUID.

       --input=<filename>
	      Read input from given  file,  instead  of	 from  stdin.  Implies
	      --batch.

SEE ALSO
       notmuch,	 notmuch-config,  notmuch-dump,	notmuch-hooks, notmuch-insert,
       notmuch-new,    notmuch-reply,	  notmuch-restore,     notmuch-search,
       notmuch-search-terms, notmuch-show, notmuch-tag

AUTHOR
       Carl Worth and many others

COPYRIGHT
       2009-2025, Carl Worth and many others

0.39				 Apr 12, 2025		      NOTMUCH-COUNT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=notmuch-count&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help