1NOTMUCH-COUNT(1)                    notmuch                   NOTMUCH-COUNT(1)
2
3
4

NAME

6       notmuch-count - count messages matching the given search terms
7

SYNOPSIS

9       notmuch count [option ...] <search-term> ...
10

DESCRIPTION

12       Count messages matching the search terms.
13
14       The number of matching messages (or threads) is output to stdout.
15
16       With no search terms, a count of all messages (or threads) in the data‐
17       base will be displayed.
18
19       See notmuch-search-terms(7) for details of  the  supported  syntax  for
20       <search-terms>.
21
22       Supported options for count include
23
24       --output=(messages|threads|files)
25
26              messages
27                     Output  the  number  of  matching  messages.  This is the
28                     default.
29
30              threads
31                     Output the number of matching threads.
32
33              files  Output the number of files associated with matching  mes‐
34                     sages.  This  may  be  bigger than the number of matching
35                     messages due to duplicates (i.e.  multiple  files  having
36                     the same message-id).
37
38       --exclude=(true|false)
39              Specify  whether  to  omit messages matching search.exclude_tags
40              from the count (the default) or not.
41
42       --batch
43              Read queries from a file (stdin by default), one per  line,  and
44              output  the  number of matching messages (or threads) to stdout,
45              one per line. On an empty input line the count of  all  messages
46              (or  threads) in the database will be output. This option is not
47              compatible with specifying search terms on the command line.
48
49       --lastmod
50              Append lastmod (counter for number of database updates) and UUID
51              to  the output. lastmod values are only comparable between data‐
52              bases with the same UUID.
53
54       --input=<filename>
55              Read input from given  file,  instead  of  from  stdin.  Implies
56              --batch.
57

SEE ALSO

59       notmuch(1),  notmuch-config(1), notmuch-dump(1), notmuch-hooks(5), not‐
60       much-insert(1), notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
61       notmuch-search(1),   notmuch-search-terms(7),   notmuch-show(1),   not‐
62       much-tag(1)
63

AUTHOR

65       Carl Worth and many others
66
68       2009-2020, Carl Worth and many others
69
70
71
72
730.31.3                           Dec 25, 2020                 NOTMUCH-COUNT(1)
Impressum