mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-12-28 20:31:43 +01:00
5dd59d2a5e
Actually the previous default was not documented explicitely. I moved the batch-tag section first because it seemed that the formats were previously documented in order default, other.
100 lines
2.8 KiB
Groff
100 lines
2.8 KiB
Groff
.TH NOTMUCH-DUMP 1 2013-12-30 "Notmuch 0.17"
|
|
.SH NAME
|
|
notmuch-dump \- creates a plain-text dump of the tags of each message
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B "notmuch dump"
|
|
.RB [ "\-\-format=(sup|batch-tag)" "] [--]"
|
|
.RI "[ --output=<" filename "> ] [--]"
|
|
.RI "[ <" search-term ">...]"
|
|
|
|
.SH DESCRIPTION
|
|
|
|
Dump tags for messages matching the given search terms.
|
|
|
|
Output is to the given filename, if any, or to stdout.
|
|
|
|
These tags are the only data in the notmuch database that can't be
|
|
recreated from the messages themselves. The output of notmuch dump is
|
|
therefore the only critical thing to backup (and much more friendly to
|
|
incremental backup than the native database files.)
|
|
|
|
.TP 4
|
|
.B \-\-format=(sup|batch-tag)
|
|
|
|
Notmuch restore supports two plain text dump formats, both with one message-id
|
|
per line, followed by a list of tags.
|
|
|
|
.RS 4
|
|
.TP 4
|
|
.B batch-tag
|
|
|
|
The default
|
|
.B batch-tag
|
|
dump format is intended to more robust against malformed message-ids
|
|
and tags containing whitespace or non-\fBascii\fR(7) characters.
|
|
Each line has the form
|
|
|
|
.RS 4
|
|
.RI "+<" "encoded-tag" "> " "" "+<" "encoded-tag" "> ... -- " "" " id:<" quoted-message-id >
|
|
|
|
Tags are hex-encoded by replacing every byte not matching the regex
|
|
.B [A-Za-z0-9@=.,_+-]
|
|
with
|
|
.B %nn
|
|
where nn is the two digit hex encoding. The message ID is a valid Xapian
|
|
query, quoted using Xapian boolean term quoting rules: if the ID contains
|
|
whitespace or a close paren or starts with a double quote, it must be
|
|
enclosed in double quotes and double quotes inside the ID must be doubled.
|
|
The astute reader will notice this is a special case of the batch input
|
|
format for \fBnotmuch-tag\fR(1); note that the single message-id query is
|
|
mandatory for \fBnotmuch-restore\fR(1).
|
|
|
|
.RE
|
|
.RE
|
|
|
|
.RS 4
|
|
.TP 4
|
|
.B sup
|
|
|
|
The
|
|
.B sup
|
|
dump file format is specifically chosen to be
|
|
compatible with the format of files produced by sup-dump.
|
|
So if you've previously been using sup for mail, then the
|
|
.B "notmuch restore"
|
|
command provides you a way to import all of your tags (or labels as
|
|
sup calls them).
|
|
Each line has the following form
|
|
|
|
.RS 4
|
|
.RI < message-id >
|
|
.B (
|
|
.RI < tag "> ..."
|
|
.B )
|
|
|
|
with zero or more tags are separated by spaces. Note that (malformed)
|
|
message-ids may contain arbitrary non-null characters. Note also
|
|
that tags with spaces will not be correctly restored with this format.
|
|
|
|
.RE
|
|
|
|
.RE
|
|
|
|
|
|
With no search terms, a dump of all messages in the database will be
|
|
generated. A "--" argument instructs notmuch that the
|
|
remaining arguments are search terms.
|
|
|
|
See \fBnotmuch-search-terms\fR(7)
|
|
for details of the supported syntax for <search-terms>.
|
|
|
|
.RE
|
|
.SH SEE ALSO
|
|
|
|
\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
|
|
\fBnotmuch-hooks\fR(5), \fBnotmuch-insert\fR(1), \fBnotmuch-new\fR(1),
|
|
\fBnotmuch-reply\fR(1), \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
|
|
\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),
|
|
\fBnotmuch-tag\fR(1)
|