← Back to branch summary

~ubuntu-branches/ubuntu/natty/evolution-data-server/natty

« back to all changes in this revision

Viewing changes to libdb/docs/ref/dumpload/format.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
https://launchpad.net/bugs/42199
https://launchpad.net/bugs/229669
https://launchpad.net/bugs/173703
https://launchpad.net/bugs/360344
https://launchpad.net/bugs/508494
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
libdb/docs/ref/dumpload/format.html
1
 
<!--$Id$-->
2
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
3
 
<!--All rights reserved.-->
4
 
<!--See the file LICENSE for redistribution information.-->
5
 
<html>
6
 
<head>
7
 
<title>Berkeley DB Reference Guide: Dump output formats</title>
8
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
10
 
</head>
11
 
<body bgcolor=white>
12
 
<table width="100%"><tr valign=top>
13
 
<td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Dumping and Reloading</dl></h3></td>
14
 
<td align=right><a href="../../ref/dumpload/utility.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/dumpload/text.html"><img src="../../images/next.gif" alt="Next"></a>
15
 
</td></tr></table>
16
 
<p>
17
 
<h1 align=center>Dump output formats</h1>
18
 
<p>There are two output formats used by <a href="../../utility/db_dump.html">db_dump</a> and <a href="../../utility/db_dump.html">db_dump185</a>.
19
 
<p>In both output formats, the first few lines of the output contain header
20
 
information describing the underlying access method, filesystem page size,
21
 
and other bookkeeping information.
22
 
<p>The header information starts with a single line, VERSION=N, where N is
23
 
the version number of the dump output format.
24
 
<p>The header information is then output in name=value pairs, where name may
25
 
be any of the keywords listed in the <a href="../../utility/db_load.html">db_load</a> manual page, and
26
 
value will be its value.  Although this header information can be manually
27
 
edited before the database is reloaded, there is rarely any reason to do
28
 
so because all of this information can also be specified or overridden by
29
 
command-line arguments to <a href="../../utility/db_load.html">db_load</a>.
30
 
<p>The header information ends with single line HEADER=END.
31
 
<p>Following the header information are the key/data pairs from the
32
 
database.  If the database being dumped is a Btree or Hash database, or
33
 
if the <b>-k</b> option was specified, the output will be paired lines
34
 
of text where the first line of the pair is the key item, and the second
35
 
line of the pair is its corresponding data item.  If the database being
36
 
dumped is a Queue or Recno database, and the <b>-k</b> option was not
37
 
specified, the output will be lines of text where each line is the next
38
 
data item for the database.  Each of these lines is preceded by a single
39
 
space.
40
 
<p>If the <b>-p</b> option to <a href="../../utility/db_dump.html">db_dump</a> or <a href="../../utility/db_dump.html">db_dump185</a> was
41
 
specified, the key/data lines will consist of single characters
42
 
representing any characters from the database that are <i>printing
43
 
characters</i> and backslash (<b>\</b>) escaped characters
44
 
for any that were not.  Backslash characters appearing in the output mean
45
 
one of two things: if the backslash character precedes another backslash
46
 
character, it means that a literal backslash character occurred in the
47
 
key or data item.  If the backslash character precedes any other
48
 
character, the next two characters must be interpreted as hexadecimal
49
 
specification of a single character; for example, <b>\0a</b>
50
 
is a newline character in the ASCII character set.
51
 
<p>Although some care should be exercised, it is perfectly reasonable to use
52
 
standard text editors and tools to edit databases dumped using the
53
 
<b>-p</b> option before reloading them using the <a href="../../utility/db_load.html">db_load</a>
54
 
utility.
55
 
<p>Note that the definition of a printing character may vary from system to
56
 
system, so database representations created using the <b>-p</b>
57
 
option may be less portable than those created without it.
58
 
<p>If the <b>-p</b> option to <a href="../../utility/db_dump.html">db_dump</a> or <a href="../../utility/db_dump.html">db_dump185</a> is
59
 
not specified, each output line will consist of paired hexadecimal values;
60
 
for example, the line <b>726f6f74</b> is the string <b>root</b> in
61
 
the ASCII character set.
62
 
<p>In all output formats, the key and data items are ended by a single line
63
 
DATA=END.
64
 
<p>Where multiple databases have been dumped from a file, the overall output
65
 
will repeat; that is, a new set of headers and a new set of data items.
66
 
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/dumpload/utility.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/dumpload/text.html"><img src="../../images/next.gif" alt="Next"></a>
67
 
</td></tr></table>
68
 
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
69
 
</body>
70
 
</html>