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.
+ With no search terms, a count of all messages (or threads) in the
+ database will be displayed.
See <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7) for details of the supported syntax for
<search-terms>.
Supported options for <b>count</b> include
- <b>--output=(messages|threads)</b>
+ <b>--output=(messages|threads|files)</b>
<b>messages</b>
Output the number of matching threads.
+ <b>files</b>
+
+ Output the number of files associated with matching mes-
+ sages. This may be bigger than the number of matching mes-
+ sages due to duplicates (i.e. multiple files having the
+ same message-id).
+
<b>--exclude=(true|false)</b>
- Specify whether to omit messages matching search.tag_exclude
+ Specify whether to omit messages matching search.tag_exclude
from the count (the default) or not.
<b>--batch</b>
- 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
+ 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.
<b>--input=</b><filename>
- Read input from given file, instead of from stdin. Implies
+ Read input from given file, instead of from stdin. Implies
<b>--batch</b>.
</pre>
<h2>SEE ALSO</h2>
<pre>
- <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-insert-1/'>not-</a>
- <a href='../notmuch-insert-1/'>much-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1), <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),
- <a href='../notmuch-search-1/'>notmuch-search</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/'>notmuch-</a>
+ <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>notmuch-hooks</a>(5), <a href='../notmuch-insert-1/'>not-</a>
+ <a href='../notmuch-insert-1/'>much-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1), <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),
+ <a href='../notmuch-search-1/'>notmuch-search</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/'>notmuch-</a>
<a href='../notmuch-tag-1/'>tag</a>(1)
</pre>
-<h2>Notmuch 0.16</h2>
+<h2>Notmuch 0.17</h2>