/usr/share/doc/mailutils-doc/mailutils.html/Create-a-Database.html

<!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, 2014-2015 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 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: Create a Database</title>

<meta name="description" content="GNU Mailutils Manual: Create a Database">
<meta name="keywords" content="GNU Mailutils Manual: Create a Database">
<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="Add-Records-to-a-Database.html#Add-Records-to-a-Database" rel="next" title="Add Records to a Database">
<link href="mu-dbm.html#mu-dbm" rel="prev" title="mu dbm">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
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.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="Create-a-Database"></a>
<div class="header">
<p>
Next: <a href="Add-Records-to-a-Database.html#Add-Records-to-a-Database" accesskey="n" rel="next">Add Records to a Database</a>, Up: <a href="mu-dbm.html#mu-dbm" accesskey="u" rel="up">mu dbm</a> &nbsp; [<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="Create-a-Database-1"></a>
<h4 class="subsubsection">2.17.11.1 Create a Database</h4>
<p>The <samp>create</samp> subcommand and its synonym <samp>load</samp> instruct
the tool to create a new database: 
</p>
<div class="example">
<pre class="example">mu dbm create file.db
</pre></div>

<p>If the argument file already exists, it will be truncated prior to
adding new records to it.
</p>
<p>The data to populate the database with are read from the standard
input.  The <code>mu dbm</code> command supports several formats for
these data, which are discussed later.  In the simplest case (a so
called &lsquo;<samp>format 0.0</samp>&rsquo;) each input line must consist of two fields
separated by any amount of whitespace.  The first field is treated as
a key and the second one as the corresponding value. 
</p>
<p>The usual way to read data from a file is, of course, by redirecting
the file to the standard input as in: 
</p>
<div class="example">
<pre class="example">mu dbm create file.db &lt; input.txt
</pre></div>

<p>There is also a special option for that purpose: <samp>--file</samp>
(<samp>-f</samp>).  Thus, the following command is equivalent to the one
above:
</p>
<div class="example">
<pre class="example">mu dbm create --file input.txt file.db 
</pre></div>

<p>The <samp>--file</samp> option has the advantage that it allows, in
conjunction with another options, for copying input file metadata
(owner UID, GID and file mode) to the created database.  For example,
the following command ensures that the created database file will have
the same metadata as the input file: 
</p>
<div class="example">
<pre class="example">mu dbm create --file input.txt --copy-permissions file.db
</pre></div>

<p>The <samp>--copy-permissions</samp> (<samp>-P</samp>) option is the one that
does the job.
</p>
<p>There are also other ways to control mode and ownership of the created
database, which are described below. 
</p>
<p>More advanced dump formats (e.g.  &lsquo;<samp>version 1.0</samp>&rsquo; format) carry
additional information about the file, including its original name,
ownership and mode.  If input is in one of these formats, the file
name argument becomes optional.  If it is not supplied, the name
stored in the input stream will be used.  For example, supposing that
the file <samp>users.dump</samp> is in format 1.0, the following command
suffices to restore the original filename, ownership, mode and, of
course, data:
</p>
<div class="example">
<pre class="example">mu dbm create --file users.dump
</pre></div>

<hr>
<div class="header">
<p>
Next: <a href="Add-Records-to-a-Database.html#Add-Records-to-a-Database" accesskey="n" rel="next">Add Records to a Database</a>, Up: <a href="mu-dbm.html#mu-dbm" accesskey="u" rel="up">mu dbm</a> &nbsp; [<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>
mailutils-doc 1:2.99.99-1ubuntu2 / usr / share / doc / mailutils-doc / mailutils.html / Create-a-Database.html
