git.notmuchmail.org Git - notmuch/blob - man/man1/notmuch-dump.1

   1 .TH NOTMUCH-DUMP 1 2011-12-04 "Notmuch 0.10.2"
   2 .SH NAME
   3 notmuch-dump \- Creates a plain-text dump of the tags of each message.
   4
   5 .SH SYNOPSIS
   6
   7 .B "notmuch dump"
   8 .RI "[ <" filename "> ] [--]"
   9 .RI "[ <" search-term ">...]"
  10
  11 .B "notmuch restore"
  12 .RB [ "--accumulate" ]
  13 .RI "[ <" filename "> ]"
  14
  15 .SH DESCRIPTION
  16
  17 .TP
  18 .BR dump " [<filename>]"
  19
  20 Dump tags for messages matching the given search terms.
  21
  22 Output is to the given filename, if any, or to stdout.  Note that
  23 using the filename argument is deprecated.
  24
  25 These tags are the only data in the notmuch database that can't be
  26 recreated from the messages themselves.  The output of notmuch dump is
  27 therefore the only critical thing to backup (and much more friendly to
  28 incremental backup than the native database files.)
  29
  30 With no search terms, a dump of all messages in the database will be
  31 generated.  A "--" argument instructs notmuch that the
  32 remaining arguments are search terms.
  33
  34 .TP
  35 .BR restore " [--accumulate] [<filename>]"
  36
  37 Restores the tags from the given file (see
  38 .BR "notmuch dump" ")."
  39
  40 The input is read from the given filename, if any, or from stdin.
  41
  42 Note: The dump file format is specifically chosen to be
  43 compatible with the format of files produced by sup-dump.
  44 So if you've previously been using sup for mail, then the
  45 .B "notmuch restore"
  46 command provides you a way to import all of your tags (or labels as
  47 sup calls them).
  48
  49 The --accumulate switch causes the union of the existing and new tags to be
  50 applied, instead of replacing each message's tags as they are read in from the
  51 dump file.
  52 .RE
  53
  54 See the
  55 .B "SEARCH SYNTAX"
  56 section below for details of the supported syntax for <search-terms>.
  57 .RE