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

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