unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob 9a7e4bacf4591fa0b2faf8b6220271c490c1214b 2045 bytes (raw)
name: doc/man1/notmuch-count.rst 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
.. _notmuch-count(1):

=============
notmuch-count
=============

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
database will be displayed.

See :any:`notmuch-search-terms(7)` for details of the supported syntax for
<search-terms>.

Supported options for **count** include

.. program:: count

.. option:: --output=(messages|threads|files)

   **messages**
     Output the number of matching messages. This is the default.

   **threads**
     Output the number of matching threads.

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

.. option:: --exclude=(true|false)

   Specify whether to omit messages matching search.exclude\_tags from
   the count (the default) or not.

.. option:: --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.

.. option:: --lastmod

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

.. option:: --input=<filename>

   Read input from given file, instead of from stdin. Implies
   ``--batch``.

SEE ALSO
========

:any:`notmuch(1)`,
:any:`notmuch-config(1)`,
:any:`notmuch-dump(1)`,
:any:`notmuch-hooks(5)`,
:any:`notmuch-insert(1)`,
:any:`notmuch-new(1)`,
:any:`notmuch-reply(1)`,
:any:`notmuch-restore(1)`,
:any:`notmuch-search(1)`,
:any:`notmuch-search-terms(7)`,
:any:`notmuch-show(1)`,
:any:`notmuch-tag(1)`

debug log:

solving 9a7e4bacf459 ...
found 9a7e4bacf459 in https://yhetil.org/notmuch.git/

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).