git.cworth.org Git - notmuch-wiki/blob - manpages/notmuch-dump-1.mdwn

   1 <h1>NOTMUCH-DUMP(1)</h1>
   2
   3 <h2>NAME</h2>
   4
   5 <pre>
   6        notmuch-dump - Creates a plain-text dump of the tags of each message.
   7 </pre>
   8
   9 <h2>SYNOPSIS</h2>
  10
  11 <pre>
  12        <b>notmuch</b> <b>dump</b> [ <<u>filename</u>> ] [--] [ <<u>search-term</u>>...]
  13 </pre>
  14
  15 <h2>DESCRIPTION</h2>
  16
  17 <pre>
  18        Dump tags for messages matching the given search terms.
  19 </pre>
  20
  21 <pre>
  22        Output is to the given filename, if any, or to stdout.  Note that using
  23        the filename argument is deprecated.
  24 </pre>
  25
  26 <pre>
  27        These tags are the only data in the  notmuch  database  that  can't  be
  28        recreated  from the messages themselves.  The output of notmuch dump is
  29        therefore the only critical thing to backup (and much more friendly  to
  30        incremental backup than the native database files.)
  31 </pre>
  32
  33 <pre>
  34        With  no  search  terms, a dump of all messages in the database will be
  35        generated.  A "--" argument instructs notmuch that the remaining  argu-
  36        ments are search terms.
  37 </pre>
  38
  39 <pre>
  40        See  <b>notmuch-search-terms</b>(7)  for  details  of the supported syntax for
  41        <search-terms>.
  42 </pre>
  43
  44 <h2>SEE ALSO</h2>
  45
  46 <pre>
  47        <b>notmuch</b>(1), <b>notmuch-config</b>(1), <b>notmuch-count</b>(1), <b>notmuch-hooks</b>(5), <b>not-</b>
  48        <b>much-new</b>(1),  <b>notmuch-reply</b>(1),  <b>notmuch-restore</b>(1), <b>notmuch-search</b>(1),
  49        <b>notmuch-search-terms</b>(7), <b>notmuch-show</b>(1), <b>notmuch-tag</b>(1)
  50 </pre>
  51
  52 <h1>Notmuch 0.13.2</h1>