/usr/share/doc/mailutils-doc/mailutils.html/Dump-Formats.html is in mailutils-doc 1:2.99.98-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA
Copyright (C) 1999-2004, 2008-2012 Free Software Foundation,
Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover, and no Back-Cover texts.
A copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: Dump Formats</title>
<meta name="description" content="GNU Mailutils Manual: Dump Formats">
<meta name="keywords" content="GNU Mailutils Manual: Dump Formats">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="mu-dbm.html#mu-dbm" rel="up" title="mu dbm">
<link href="Dbm-Exit-Codes.html#Dbm-Exit-Codes" rel="next" title="Dbm Exit Codes">
<link href="Dump-the-Database.html#Dump-the-Database" rel="prev" title="Dump the Database">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Dump-Formats"></a>
<div class="header">
<p>
Next: <a href="Dbm-Exit-Codes.html#Dbm-Exit-Codes" accesskey="n" rel="next">Dbm Exit Codes</a>, Previous: <a href="Dump-the-Database.html#Dump-the-Database" accesskey="p" rel="prev">Dump the Database</a>, Up: <a href="mu-dbm.html#mu-dbm" accesskey="u" rel="up">mu dbm</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Dump-Formats-1"></a>
<h4 class="subsubsection">3.17.11.6 Dump Formats</h4>
<p>As of version 2.99.98, <code>mu dbm</code> supports two formats
for dumping DBM databases. Both formats are line-oriented. Comments
are introduced with a sharp (‘<samp>#</samp>’) sign in the column 0 of a line,
followed by at least one white space character (space or tab). Sharp
sign followed by a colon (‘<samp>#:</samp>’) introduces a <em>paragmatic
comment</em>, which carries some additional information to the loader.
</p>
<a name="dump-version-0_002e0"></a><p>The <em>version 0.0</em> format is suitable for databases whose records
contain only ASCII data. In this format, each record occupies a
separate line, which consists of the key and value separated by a
single <small>TAB</small> character. Empty lines are ignored. For example:
</p>
<div class="example">
<pre class="example">$ mu list /etc/mail/users.db
root guessme
smith pAssword
qed fooBar
</pre></div>
<p>The output in version 0.0 format is human readable and can be used as
input to the popauth utility (see <i>popauth</i> (<strong>Editor’s note: dangling link</strong>). However, version 0.0
has serious drawbacks. First of all, it is not suitable for databases
that contain binary data. Secondly, it cannot properly handle keys
beginning with a sharp sign or containing <small>TAB</small>. The version 1.0
format is free from these drawbacks.
</p>
<a name="dump-version-1_002e0"></a><p>The <em>version 1.0</em> dump format begins with a <em>header</em>
containing important information about the file, such as its file
name, ownership and file mode. This information is stored in
pragmatic comments and allows <code>mu dbm load</code> to easily recreate
an exact copy of the file. The following comments are defined:
</p>
<dl compact="compact">
<dt>#:version=1.0</dt>
<dd><p>Indicates that the data that follow are in version 1.0 format.
</p></dd>
<dt>#:filename=<var>s</var></dt>
<dd><p>Original database file name, without directory parts.
</p></dd>
<dt>#:uid=<var>n</var></dt>
<dd><p>Owner UID.
</p></dd>
<dt>#:user=<var>s</var></dt>
<dd><p>Owner name.
</p></dd>
<dt>#:gid=<var>n</var></dt>
<dd><p>Owner GID
</p></dd>
<dt>#:group=<var>s</var></dt>
<dd><p>Owner group name.
</p></dd>
<dt>#:mode=<var>o</var></dt>
<dd><p>File mode in octal
</p></dd>
</dl>
<p>Following this header are actual data. Each record is output in two
parts: key and value. Each part begins with a ‘<samp>#:len=<var>n</var></samp>’
construct on a line by itself, where <var>n</var> is the length of the data
in decimal. This line is followed by one or more lines of the actual
data, encoded in base64. The data are formatted so that each line
does not exceed 76 bytes in length (not counting the terminating
newline). An example of this format follows:
</p>
<div class="example">
<pre class="example"># Database dump file created by GNU Mailutils 2.99.93 on
# Tue Nov 1 13:28:03 2011
#:version=1.0
#:file=users.db
#:uid=0,user=root,gid=25,group=mail,mode=640
#:len=6
c21pdGgA
#:len=9
cEFzc3dvcmQA
#:len=5
cm9vdAA=
#:len=8
Z3Vlc3NtZQA=
#:len=4
cWVkAA==
#:len=7
Zm9vQmFyAA==
</pre></div>
<hr>
<div class="header">
<p>
Next: <a href="Dbm-Exit-Codes.html#Dbm-Exit-Codes" accesskey="n" rel="next">Dbm Exit Codes</a>, Previous: <a href="Dump-the-Database.html#Dump-the-Database" accesskey="p" rel="prev">Dump the Database</a>, Up: <a href="mu-dbm.html#mu-dbm" accesskey="u" rel="up">mu dbm</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|