2013-08-03 13:29:40 +02:00
|
|
|
.TH NOTMUCH-COUNT 1 2013-08-03 "Notmuch 0.16"
|
2011-12-19 03:38:24 +01:00
|
|
|
.SH NAME
|
2012-06-24 23:53:27 +02:00
|
|
|
notmuch-count \- count messages matching the given search terms
|
2011-12-19 03:38:24 +01:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
|
|
.B notmuch count
|
|
|
|
.RI [ options "... ] <" search-term ">..."
|
|
|
|
|
|
|
|
.SH 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.
|
|
|
|
|
2011-12-20 02:41:48 +01:00
|
|
|
See \fBnotmuch-search-terms\fR(7)
|
|
|
|
for details of the supported syntax for <search-terms>.
|
|
|
|
|
2011-12-19 03:38:24 +01:00
|
|
|
Supported options for
|
|
|
|
.B count
|
|
|
|
include
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
2013-08-17 14:11:31 +02:00
|
|
|
.B \-\-output=(messages|threads|files)
|
2011-12-19 03:38:24 +01:00
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
|
|
|
.B messages
|
|
|
|
|
|
|
|
Output the number of matching messages. This is the default.
|
|
|
|
.RE
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
|
|
|
.B threads
|
|
|
|
|
|
|
|
Output the number of matching threads.
|
|
|
|
.RE
|
2013-08-17 14:11:31 +02:00
|
|
|
.RS 4
|
|
|
|
.TP 4
|
|
|
|
.B 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).
|
|
|
|
.RE
|
2011-12-19 03:38:24 +01:00
|
|
|
.RE
|
2012-03-01 23:30:34 +01:00
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
2012-04-07 18:10:04 +02:00
|
|
|
.BR \-\-exclude=(true|false)
|
2012-03-01 23:30:34 +01:00
|
|
|
|
2012-04-07 18:10:04 +02:00
|
|
|
Specify whether to omit messages matching search.tag_exclude from the
|
|
|
|
count (the default) or not.
|
2012-03-01 23:30:34 +01:00
|
|
|
.RE
|
2013-03-31 11:46:01 +02:00
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
|
|
|
.BR \-\-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.
|
|
|
|
.RE
|
|
|
|
|
|
|
|
.RS 4
|
|
|
|
.TP 4
|
|
|
|
.BR "\-\-input=" <filename>
|
|
|
|
|
|
|
|
Read input from given file, instead of from stdin. Implies
|
|
|
|
.BR --batch .
|
|
|
|
.RE
|
|
|
|
|
2011-12-19 03:38:24 +01:00
|
|
|
.RE
|
|
|
|
.RE
|
2011-12-20 02:41:48 +01:00
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
|
|
|
\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-dump\fR(1),
|
2013-06-23 06:23:58 +02:00
|
|
|
\fBnotmuch-hooks\fR(5), \fBnotmuch-insert\fR(1), \fBnotmuch-new\fR(1),
|
|
|
|
\fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
|
2012-03-11 22:36:16 +01:00
|
|
|
\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
|
|
|
|
\fBnotmuch-tag\fR(1)
|