← Back to branch summary

~ubuntu-branches/ubuntu/precise/gnat-gps/precise

« back to all changes in this revision

Viewing changes to kernel/src_info/sn/snsrc/db-2.7.7/docs/ref/dumpload/format.html

  • Committer: Package Import Robot
  • Author(s): Ludovic Brenta
  • Date: 2012-01-15 15:42:21 UTC
  • mfrom: (10.1.10 sid)
  • Revision ID: package-import@ubuntu.com-20120115154221-ccysuzvh02pkhuwq
Tags: 5.0-6
Rebuild against libgtkada 2.24.1.

Show diffs side-by-side

added added

removed removed

Lines of Context:
kernel/src_info/sn/snsrc/db-2.7.7/docs/ref/dumpload/format.html
1
 
<! "@(#)format.so       10.2 (Sleepycat) 11/2/98">
2
 
<!Copyright 1997, 1998 by Sleepycat Software, Inc.  All rights reserved.>
3
 
<html>
4
 
<body bgcolor=white>
5
 
<head>
6
 
<title>Berkeley DB Reference Guide: Dumping and Reloading</title>
7
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
8
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btr
9
 
ee,hash,hashing,transaction,transactions,locking,logging,access method,access me
10
 
thods,java,C,C++">
11
 
</head>
12
 
<h3>Berkeley DB Reference Guide: Dumping and Reloading</h3>
13
 
<p>
14
 
<h1 align=center>Dump output formats</h1>
15
 
<p>
16
 
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>.
17
 
<p>
18
 
In both output formats, the first few lines of the output contain header
19
 
information describing the underlying access method, filesystem page size
20
 
and other bookkeeping information.  This information is output in
21
 
<b>name=value</b> pairs, where <b>name</b> may be any of the keywords
22
 
listed in the <a href="../../utility/db_load.html">db_load</a> manual page, and <b>value</b> will be its
23
 
value.  While this header information can be manually edited before the
24
 
database is reloaded, there is rarely any reason to do so, as all of this
25
 
information can also be specified or overridden by command-line arguments
26
 
to <a href="../../utility/db_load.html">db_load</a>.
27
 
<p>
28
 
Following the header information are the key/data pairs from the database.
29
 
If the database being dumped is of type Btree or Hash, the output will be
30
 
paired lines of text, where the first line of the pair is the key item,
31
 
and the second line of the pair is its corresponding data item.  If the
32
 
database being dumped is of type Recno, the output will be lines of text,
33
 
where each line is the next data item for the database.
34
 
<p>
35
 
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
36
 
specified, the key/data lines will consist of single characters representing
37
 
any characters from the database that are <i>printing characters</i>
38
 
and backslash \ escaped characters for any that were not.
39
 
Backslash characters appearing in the output mean one of two things: if
40
 
the backslash character precedes another backslash character, it means
41
 
that a literal backslash character occurred in the key or data item.  If
42
 
the backslash character precedes any other character, the next two
43
 
characters must be interpreted as hexadecimal specification of a single
44
 
character, e.g., \0a is a newline character in the ASCII
45
 
character set.
46
 
<p>
47
 
Although some care should be exercised, it is perfectly reasonable to use
48
 
standard text editors and tools to edit databases dumped using the
49
 
<b>-p</b> option before re-loading them using the <a href="../../utility/db_load.html">db_load</a>
50
 
utility.
51
 
<p>
52
 
Note that the definition of a printing character may vary from system to
53
 
system, and so database representations created using the <b>-p</b>
54
 
option may be less portable than those created without it.
55
 
<p>
56
 
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
57
 
not specified, each output line will consist of paired hexadecimal values,
58
 
e.g., the line <b>726f6f74</b> is the string <b>root</b> in the ASCII
59
 
character set.
60
 
<p>
61
 
In all output formats, a single newline character ends both the key and
62
 
data items.
63
 
<p>
64
 
<a href="../../ref/dumpload/utility.html"><img src="../../images/prev.gif"></a>
65
 
<a href="../../ref/toc.html"><img src="../../images/toc.gif"></a>
66
 
<a href="../../ref/dumpload/text.html"><img src="../../images/next.gif"></a>
67
 
</tt>
68
 
</body>
69
 
</html>