Not logged in

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:update documentation
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:b29d6ef0cc9f6a8be964959241df608e2b818f95
User & Date: brandon 2013-11-17 14:58:46
Context
2013-11-17
14:59
update docs check-in: 239d096001 user: brandon tags: trunk
14:58
update documentation check-in: b29d6ef0cc user: brandon tags: trunk
14:44
fix the NEWS a bit check-in: 15951d48c4 user: brandon tags: trunk
Changes

Changes to NEWS.

44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
GNU/Linux) distribution (zeptodb-2.0.2-x86_64.sw.tar.gz).  Both can be
installed via the swbis tool swinstall.  The source distribution is
automatically configured and built after it is installed with
swinstall. The built binaries can then be installed via the swconfig
tool:

    $ swinstall -s :zeptodb-2.0.2-src.sw.tar.gz @/usr/local
    [configure output]
    $ swconfig zeptodb @/usr/local
    [make

The x86_64 binary distribution will require up-to-date GNU libc (2.18)
and GDBM (1.10) libraries.  The binaries will be installed in the
proper places at the prefix of your choice when you run swinstall.
For example, to install to /usr/local:

    $ swinstall -s :zeptodb-2.0.2-x86_64.sw.tar.gz @/usr/local







|

|







44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
GNU/Linux) distribution (zeptodb-2.0.2-x86_64.sw.tar.gz).  Both can be
installed via the swbis tool swinstall.  The source distribution is
automatically configured and built after it is installed with
swinstall. The built binaries can then be installed via the swconfig
tool:

    $ swinstall -s :zeptodb-2.0.2-src.sw.tar.gz @/usr/local
    [configure and make build output]
    $ swconfig zeptodb @/usr/local
    [make install output]

The x86_64 binary distribution will require up-to-date GNU libc (2.18)
and GDBM (1.10) libraries.  The binaries will be installed in the
proper places at the prefix of your choice when you run swinstall.
For example, to install to /usr/local:

    $ swinstall -s :zeptodb-2.0.2-x86_64.sw.tar.gz @/usr/local

Changes to www/html_node/Commands.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Commands</title>

<meta name="description" content="zeptodb: Commands">
<meta name="keywords" content="zeptodb: Commands">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="zdbc.html#zdbc" rel="next" title="zdbc">
<link href="Back_002dends.html#Back_002dends" rel="previous" title="Back-ends">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Commands"></a>
<div class="header">
<p>
Next: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Commands-1"></a>
<h2 class="chapter">2 Commands</h2>

<p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
databases and storing records in them; <code>zdbf</code>, for fetching


|







 







|







 







|







 







|







1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Commands</title>

<meta name="description" content="zeptodb: Commands">
<meta name="keywords" content="zeptodb: Commands">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="zdbc.html#zdbc" rel="next" title="zdbc">
<link href="Back_002dends.html#Back_002dends" rel="prev" title="Back-ends">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Commands"></a>
<div class="header">
<p>
Next: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Commands-1"></a>
<h2 class="chapter">2 Commands</h2>

<p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
databases and storing records in them; <code>zdbf</code>, for fetching

Changes to www/html_node/Copying-This-Manual.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Copying This Manual</title>

<meta name="description" content="zeptodb: Copying This Manual">
<meta name="keywords" content="zeptodb: Copying This Manual">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="next" title="GNU Free Documentation License">
<link href="zdbr.html#zdbr" rel="previous" title="zdbr">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Copying-This-Manual"></a>
<div class="header">
<p>
Next: <a href="Index.html#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="Commands.html#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Copying-This-Manual-1"></a>
<h2 class="appendix">Appendix A Copying This Manual</h2>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.


|







 







|







 







|







 







|







1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Copying This Manual</title>

<meta name="description" content="zeptodb: Copying This Manual">
<meta name="keywords" content="zeptodb: Copying This Manual">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="next" title="GNU Free Documentation License">
<link href="zdbr.html#zdbr" rel="prev" title="zdbr">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Copying-This-Manual"></a>
<div class="header">
<p>
Next: <a href="Index.html#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="Commands.html#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Copying-This-Manual-1"></a>
<h2 class="appendix">Appendix A Copying This Manual</h2>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.

Changes to www/html_node/GNU-Free-Documentation-License.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
...
544
545
546
547
548
549
550
551
552
553
554
555
556
557
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: GNU Free Documentation License</title>

<meta name="description" content="zeptodb: GNU Free Documentation License">
<meta name="keywords" content="zeptodb: GNU Free Documentation License">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="up" title="Copying This Manual">
<link href="Index.html#Index" rel="next" title="Index">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="previous" title="Copying This Manual">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="GNU-Free-Documentation-License"></a>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="GNU-Free-Documentation-License-1"></a>
<h3 class="section">A.1 GNU Free Documentation License</h3>
<div align="center">Version 1.3, 3 November 2008
</div>

................................................................................
to permit their use in free software.
</p>


<hr>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>


|







 







|







 







|







 







|







 







|






1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
...
544
545
546
547
548
549
550
551
552
553
554
555
556
557
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: GNU Free Documentation License</title>

<meta name="description" content="zeptodb: GNU Free Documentation License">
<meta name="keywords" content="zeptodb: GNU Free Documentation License">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="up" title="Copying This Manual">
<link href="Index.html#Index" rel="next" title="Index">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="prev" title="Copying This Manual">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="GNU-Free-Documentation-License"></a>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="GNU-Free-Documentation-License-1"></a>
<h3 class="section">A.1 GNU Free Documentation License</h3>
<div align="center">Version 1.3, 3 November 2008
</div>

................................................................................
to permit their use in free software.
</p>


<hr>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>

Changes to www/html_node/Index.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Index</title>

<meta name="description" content="zeptodb: Index">
<meta name="keywords" content="zeptodb: Index">
<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="#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="previous" title="GNU Free Documentation License">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Index"></a>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Index-1"></a>
<h2 class="unnumbered">Index</h2>





</body>
</html>


|







 







|













|







 







|











1
2
3
4
5
6
7
8
9
10
..
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
..
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Index</title>

<meta name="description" content="zeptodb: Index">
<meta name="keywords" content="zeptodb: Index">
<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="#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="prev" title="GNU Free Documentation License">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Index"></a>
<div class="header">
<p>
Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Index-1"></a>
<h2 class="unnumbered">Index</h2>





</body>
</html>

Changes to www/html_node/Introduction.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Introduction</title>

<meta name="description" content="zeptodb: Introduction">
<meta name="keywords" content="zeptodb: Introduction">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Back_002dends.html#Back_002dends" rel="next" title="Back-ends">
<link href="index.html#Top" rel="previous" title="Top">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Introduction"></a>
<div class="header">
<p>
Next: <a href="Commands.html#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="index.html#Top" accesskey="p" rel="previous">Top</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Introduction-1"></a>
<h2 class="chapter">1 Introduction</h2>

<p>zeptodb is a small collection of relatively tiny tools for interacting
with flat (non-relational) databases.  In fact, they are merely
minimal command-line tools implementing the functionality of a DBM
library.  Thus, the databases they manipulate are simple, key-value
hash tables.



</p>
<p>These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.
They may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.
</p>
<table class="menu" border="0" cellspacing="0">


<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="1">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>




</body>
</html>


|







 







|













|
|







 







|





|
|
|
|
|
>
>
>








>
>
|








1
2
3
4
5
6
7
8
9
10
..
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
..
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Introduction</title>

<meta name="description" content="zeptodb: Introduction">
<meta name="keywords" content="zeptodb: Introduction">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Tutorial.html#Tutorial" rel="next" title="Tutorial">
<link href="index.html#Top" rel="prev" title="Top">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Introduction"></a>
<div class="header">
<p>
Next: <a href="Commands.html#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="index.html#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Introduction-1"></a>
<h2 class="chapter">1 Introduction</h2>

<p>zeptodb is a small collection of relatively tiny command-line tools for
interacting with DBM databases.  For the uninitiated, DBM databases are
flat (non-relational) a databases; in other words, they are persistent
key-value hash tables. Typically they are created via a library for C,
Python, Perl, etc. These tools fill in a gap by providing useful
command-line tools. Some DBM libraries come with really basic binaries
for manipulating the databases, but they are not designed to be very
flexible or useful in the real world.
</p>
<p>These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.
They may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="Tutorial.html#Tutorial" accesskey="1">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="2">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>




</body>
</html>

Changes to www/html_node/index.html.

1
2
3
4
5
6
7
8
9
10
..
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
..
74
75
76
77
78
79
80

81
82
83
84
85
86
87
88
..
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
...
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
167
168
169
170
171
172
173
174
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Top</title>

<meta name="description" content="zeptodb: Top">
<meta name="keywords" content="zeptodb: Top">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
................................................................................
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">

<ul class="no-bullet">
  <li><a name="toc-Introduction-1" href="Introduction.html#Introduction">1 Introduction</a>
  <ul class="no-bullet">

    <li><a name="toc-Back_002dends-1" href="Back_002dends.html#Back_002dends">1.1 Back-ends</a></li>
  </ul></li>
  <li><a name="toc-Commands-1" href="Commands.html#Commands">2 Commands</a>
  <ul class="no-bullet">
    <li><a name="toc-zdbc-1" href="zdbc.html#zdbc">2.1 zdbc</a></li>
    <li><a name="toc-zdbs-1" href="zdbs.html#zdbs">2.2 zdbs</a></li>
    <li><a name="toc-zdbf-1" href="zdbf.html#zdbf">2.3 zdbf</a></li>
    <li><a name="toc-zdbr-1" href="zdbr.html#zdbr">2.4 zdbr</a></li>
................................................................................
</ul>
</div>


<a name="Top"></a>
<div class="header">
<p>
Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="previous">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zeptodb"></a>
<h1 class="top">zeptodb</h1>

<p>This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
</p>
<p>Copyright &copy; 2013  Brandon Invergo
</p>
<blockquote>
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
................................................................................
<tr><td align="left" valign="top">&bull; <a href="Index.html#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

Introduction



</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="5">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Commands

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="zdbc.html#zdbc" accesskey="6">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbs.html#zdbs" accesskey="7">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbf.html#zdbf" accesskey="8">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr" accesskey="9">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Copying This Manual

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr></table>

<hr>
<div class="header">
<p>
Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="previous">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>


|







 







|







 







>
|







 







|





|







 







>
>
|




|

|

|

|












|






1
2
3
4
5
6
7
8
9
10
..
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
..
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
..
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
...
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
167
168
169
170
171
172
173
174
175
176
177
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: Top</title>

<meta name="description" content="zeptodb: Top">
<meta name="keywords" content="zeptodb: Top">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
................................................................................
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">

<ul class="no-bullet">
  <li><a name="toc-Introduction-1" href="Introduction.html#Introduction">1 Introduction</a>
  <ul class="no-bullet">
    <li><a name="toc-Tutorial-1" href="Tutorial.html#Tutorial">1.1 Tutorial</a></li>
    <li><a name="toc-Back_002dends-1" href="Back_002dends.html#Back_002dends">1.2 Back-ends</a></li>
  </ul></li>
  <li><a name="toc-Commands-1" href="Commands.html#Commands">2 Commands</a>
  <ul class="no-bullet">
    <li><a name="toc-zdbc-1" href="zdbc.html#zdbc">2.1 zdbc</a></li>
    <li><a name="toc-zdbs-1" href="zdbs.html#zdbs">2.2 zdbs</a></li>
    <li><a name="toc-zdbf-1" href="zdbf.html#zdbf">2.3 zdbf</a></li>
    <li><a name="toc-zdbr-1" href="zdbr.html#zdbr">2.4 zdbr</a></li>
................................................................................
</ul>
</div>


<a name="Top"></a>
<div class="header">
<p>
Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zeptodb"></a>
<h1 class="top">zeptodb</h1>

<p>This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
</p>
<p>Copyright &copy; 2013  Brandon Invergo
</p>
<blockquote>
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
................................................................................
<tr><td align="left" valign="top">&bull; <a href="Index.html#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

Introduction

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="Tutorial.html#Tutorial" accesskey="5">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="6">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Commands

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="zdbc.html#zdbc" accesskey="7">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbs.html#zdbs" accesskey="8">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbf.html#zdbf" accesskey="9">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Copying This Manual

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr></table>

<hr>
<div class="header">
<p>
Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>

Changes to www/html_node/zdbf.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbf</title>

<meta name="description" content="zeptodb: zdbf">
<meta name="keywords" content="zeptodb: zdbf">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="zdbr.html#zdbr" rel="next" title="zdbr">
<link href="zdbs.html#zdbs" rel="previous" title="zdbs">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbf"></a>
<div class="header">
<p>
Next: <a href="zdbr.html#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="zdbs.html#zdbs" accesskey="p" rel="previous">zdbs</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbf-1"></a>
<h3 class="section">2.3 zdbf</h3>

<p><code>zdbf</code> is used to fetch records from a database file.  Queries
are read from <samp>stdin</samp> or, optionally, from a text file.  Records


|







 







|







 







|







 







|







1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbf</title>

<meta name="description" content="zeptodb: zdbf">
<meta name="keywords" content="zeptodb: zdbf">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="zdbr.html#zdbr" rel="next" title="zdbr">
<link href="zdbs.html#zdbs" rel="prev" title="zdbs">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbf"></a>
<div class="header">
<p>
Next: <a href="zdbr.html#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="zdbs.html#zdbs" accesskey="p" rel="prev">zdbs</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbf-1"></a>
<h3 class="section">2.3 zdbf</h3>

<p><code>zdbf</code> is used to fetch records from a database file.  Queries
are read from <samp>stdin</samp> or, optionally, from a text file.  Records

Changes to www/html_node/zdbr.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbr</title>

<meta name="description" content="zeptodb: zdbr">
<meta name="keywords" content="zeptodb: zdbr">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="next" title="Copying This Manual">
<link href="zdbf.html#zdbf" rel="previous" title="zdbf">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbr"></a>
<div class="header">
<p>
Previous: <a href="zdbf.html#zdbf" accesskey="p" rel="previous">zdbf</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbr-1"></a>
<h3 class="section">2.4 zdbr</h3>

<p><code>zdbr</code> is used to remove records from a database.  The records
to be removed are specified by their keys and are entered via


|







 







|







 







|







 







|







1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbr</title>

<meta name="description" content="zeptodb: zdbr">
<meta name="keywords" content="zeptodb: zdbr">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="Copying-This-Manual.html#Copying-This-Manual" rel="next" title="Copying This Manual">
<link href="zdbf.html#zdbf" rel="prev" title="zdbf">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbr"></a>
<div class="header">
<p>
Previous: <a href="zdbf.html#zdbf" accesskey="p" rel="prev">zdbf</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbr-1"></a>
<h3 class="section">2.4 zdbr</h3>

<p><code>zdbr</code> is used to remove records from a database.  The records
to be removed are specified by their keys and are entered via

Changes to www/html_node/zdbs.html.

1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbs</title>

<meta name="description" content="zeptodb: zdbs">
<meta name="keywords" content="zeptodb: zdbs">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="zdbf.html#zdbf" rel="next" title="zdbf">
<link href="zdbc.html#zdbc" rel="previous" title="zdbc">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbs"></a>
<div class="header">
<p>
Next: <a href="zdbf.html#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="zdbc.html#zdbc" accesskey="p" rel="previous">zdbc</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbs-1"></a>
<h3 class="section">2.2 zdbs</h3>

<p><code>zdbs</code> is used to store records in a database file.  Records
are entered via <samp>stdin</samp> or, optionally, they are read from an


|







 







|







 







|







 







|







1
2
3
4
5
6
7
8
9
10
..
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
..
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb: zdbs</title>

<meta name="description" content="zeptodb: zdbs">
<meta name="keywords" content="zeptodb: zdbs">
<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="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Commands.html#Commands" rel="up" title="Commands">
<link href="zdbf.html#zdbf" rel="next" title="zdbf">
<link href="zdbc.html#zdbc" rel="prev" title="zdbc">
<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}
................................................................................

</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="zdbs"></a>
<div class="header">
<p>
Next: <a href="zdbf.html#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="zdbc.html#zdbc" accesskey="p" rel="prev">zdbc</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="zdbs-1"></a>
<h3 class="section">2.2 zdbs</h3>

<p><code>zdbs</code> is used to store records in a database file.  Records
are entered via <samp>stdin</samp> or, optionally, they are read from an

Changes to www/zeptodb.dvi.gz.

cannot compute difference between binary files

Changes to www/zeptodb.html.

1
2
3
4
5
6
7
8
9
10
..
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
..
73
74
75
76
77
78
79

80
81
82
83
84
85
86
87
..
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
...
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
167
168
169
170
171
172
173
174
175
176



177
178
179
180
181
182
183
184


185
186
187
188
189























































































































































190
191
192
193
194
195
196
197
198
199
200
201
202
203
...
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
...
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
...
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
...
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
...
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
...
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
...
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb</title>

<meta name="description" content="zeptodb">
<meta name="keywords" content="zeptodb">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
................................................................................
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">

<ul class="no-bullet">
  <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a>
  <ul class="no-bullet">

    <li><a name="toc-Back_002dends-1" href="#Back_002dends">1.1 Back-ends</a></li>
  </ul></li>
  <li><a name="toc-Commands-1" href="#Commands">2 Commands</a>
  <ul class="no-bullet">
    <li><a name="toc-zdbc-1" href="#zdbc">2.1 zdbc</a></li>
    <li><a name="toc-zdbs-1" href="#zdbs">2.2 zdbs</a></li>
    <li><a name="toc-zdbf-1" href="#zdbf">2.3 zdbf</a></li>
    <li><a name="toc-zdbr-1" href="#zdbr">2.4 zdbr</a></li>
................................................................................
</ul>
</div>


<a name="Top"></a>
<div class="header">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="previous">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zeptodb"></a>
<h1 class="top">zeptodb</h1>

<p>This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
</p>
<p>Copyright &copy; 2013  Brandon Invergo
</p>
<blockquote>
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
................................................................................
<tr><td align="left" valign="top">&bull; <a href="#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

Introduction



</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="5">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Commands

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="6">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="7">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="8">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbr" accesskey="9">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Copying This Manual

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr></table>

<hr>
<a name="Introduction"></a>
<div class="header">
<p>
Next: <a href="#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="#Top" accesskey="p" rel="previous">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Introduction-1"></a>
<h2 class="chapter">1 Introduction</h2>

<p>zeptodb is a small collection of relatively tiny tools for interacting
with flat (non-relational) databases.  In fact, they are merely
minimal command-line tools implementing the functionality of a DBM
library.  Thus, the databases they manipulate are simple, key-value
hash tables.



</p>
<p>These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.
They may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.
</p>
<table class="menu" border="0" cellspacing="0">


<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="1">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>























































































































































<a name="Back_002dends"></a>
<div class="header">
<p>
Previous: <a href="#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Back_002dends-1"></a>
<h3 class="section">1.1 Back-ends</h3>

<p>By default, zeptodb uses the <a href="http://www.gnu.org/software/gdb">GNU dbm</a> (GDBM) library to create and manipulate the DBM databases.
Alternatively, you may choose to use the
<a href="http://fallabs.com/kyotocabinet/">Kyoto Cabinet</a> library
instead.  This is specified by passing the
<samp>--with-kyotocabinet</samp> option to the <samp>configure</samp> script
before compiling zeptodb.
................................................................................
not as widely available in GNU/Linux distributions as GDBM so it often
must be installed manually.
</p>
<hr>
<a name="Commands"></a>
<div class="header">
<p>
Next: <a href="#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Commands-1"></a>
<h2 class="chapter">2 Commands</h2>

<p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
databases and storing records in them; <code>zdbf</code>, for fetching
records from databases; and <code>zdbr</code>, for removing records from
................................................................................
</table>


<hr>
<a name="zdbc"></a>
<div class="header">
<p>
Next: <a href="#zdbs" accesskey="n" rel="next">zdbs</a>, Previous: <a href="#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbc-1"></a>
<h3 class="section">2.1 zdbc</h3>

<p><code>zdbc</code> is used to create a new database file.  It accepts two
options, one to choose the number of buckets for the database and the
other to choose the size of the memory-mapped region.  These options
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbs"></a>
<div class="header">
<p>
Next: <a href="#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="#zdbc" accesskey="p" rel="previous">zdbc</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbs-1"></a>
<h3 class="section">2.2 zdbs</h3>

<p><code>zdbs</code> is used to store records in a database file.  Records
are entered via <samp>stdin</samp> or, optionally, they are read from an
input file, with one record per line.  Each record should consist of
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbf"></a>
<div class="header">
<p>
Next: <a href="#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="#zdbs" accesskey="p" rel="previous">zdbs</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbf-1"></a>
<h3 class="section">2.3 zdbf</h3>

<p><code>zdbf</code> is used to fetch records from a database file.  Queries
are read from <samp>stdin</samp> or, optionally, from a text file.  Records
with key values that match the queries will be printed to
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbr"></a>
<div class="header">
<p>
Previous: <a href="#zdbf" accesskey="p" rel="previous">zdbf</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbr-1"></a>
<h3 class="section">2.4 zdbr</h3>

<p><code>zdbr</code> is used to remove records from a database.  The records
to be removed are specified by their keys and are entered via
<samp>stdin</samp> or, optionally, they are read from a text file.  If many
................................................................................
</p></dd>
</dl>

<hr>
<a name="Copying-This-Manual"></a>
<div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Copying-This-Manual-1"></a>
<h2 class="appendix">Appendix A Copying This Manual</h2>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
</table>

<hr>
<a name="GNU-Free-Documentation-License"></a>
<div class="header">
<p>
Previous: <a href="#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="GNU-Free-Documentation-License-1"></a>
<h3 class="section">A.1 GNU Free Documentation License</h3>
<div align="center">Version 1.3, 3 November 2008
</div>

<div class="display">
................................................................................
</p>


<hr>
<a name="Index"></a>
<div class="header">
<p>
Previous: <a href="#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Index-1"></a>
<h2 class="unnumbered">Index</h2>


<hr>



</body>
</html>


|







 







|







 







>
|







 







|




|







 







>
>
|




|

|

|

|













|




|
|
|
|
|
>
>
>








>
>
|




>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>



|


|







 







|







 







|







 







|







 







|







 







|







 







|













|







 







|











1
2
3
4
5
6
7
8
9
10
..
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
..
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
..
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
...
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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
...
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
...
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
...
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
...
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
...
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
...
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
....
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

Copyright (C) 2013  Brandon Invergo

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.


The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>zeptodb</title>

<meta name="description" content="zeptodb">
<meta name="keywords" content="zeptodb">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
................................................................................
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">

<ul class="no-bullet">
  <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a>
  <ul class="no-bullet">
    <li><a name="toc-Tutorial-1" href="#Tutorial">1.1 Tutorial</a></li>
    <li><a name="toc-Back_002dends-1" href="#Back_002dends">1.2 Back-ends</a></li>
  </ul></li>
  <li><a name="toc-Commands-1" href="#Commands">2 Commands</a>
  <ul class="no-bullet">
    <li><a name="toc-zdbc-1" href="#zdbc">2.1 zdbc</a></li>
    <li><a name="toc-zdbs-1" href="#zdbs">2.2 zdbs</a></li>
    <li><a name="toc-zdbf-1" href="#zdbf">2.3 zdbf</a></li>
    <li><a name="toc-zdbr-1" href="#zdbr">2.4 zdbr</a></li>
................................................................................
</ul>
</div>


<a name="Top"></a>
<div class="header">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zeptodb"></a>
<h1 class="top">zeptodb</h1>

<p>This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
</p>
<p>Copyright &copy; 2013  Brandon Invergo
</p>
<blockquote>
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
................................................................................
<tr><td align="left" valign="top">&bull; <a href="#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

Introduction

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Tutorial" accesskey="5">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="6">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Commands

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="7">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="8">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="9">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Copying This Manual

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr></table>

<hr>
<a name="Introduction"></a>
<div class="header">
<p>
Next: <a href="#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Introduction-1"></a>
<h2 class="chapter">1 Introduction</h2>

<p>zeptodb is a small collection of relatively tiny command-line tools for
interacting with DBM databases.  For the uninitiated, DBM databases are
flat (non-relational) a databases; in other words, they are persistent
key-value hash tables. Typically they are created via a library for C,
Python, Perl, etc. These tools fill in a gap by providing useful
command-line tools. Some DBM libraries come with really basic binaries
for manipulating the databases, but they are not designed to be very
flexible or useful in the real world.
</p>
<p>These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.
They may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Tutorial" accesskey="1">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="2">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Tutorial"></a>
<div class="header">
<p>
Next: <a href="#Back_002dends" accesskey="n" rel="next">Back-ends</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Tutorial-1"></a>
<h3 class="section">1.1 Tutorial</h3>

<p>The zeptodb tools are used to create small databases that are stored to
disk and then to store, fetch and remove records from those databases.
Note that these databases are much simpler than, say, SQL databases.
The databases follow the DBM format as created by the GDBM library
see <a href="#Back_002dends">Back-ends</a>.  Each record in a DBM database consists of a key and
a value.  All keys and values are stored as plain text, regardless of
their formats.
</p>
<p>First, you create a new database with <code>zdbc</code>:
</p>
<div class="example">
<pre class="example">$ zdbc foo.db
</pre></div>

<p>You can customize the creation of a database in two ways.  The first is
by specifying the number of &quot;buckets&quot; that comprise the database,
specified via the <samp>-b</samp>/<samp>--num-buckets</samp> option.  A DBM
database can be imagined as a series of buckets.  When a new item is
added, an algorithm determines which bucket it belongs in based on its
value.  Likewise, the same algorithm will be used in determining the
bucket from which to fetch an item.  If each bucket only contains a
maximum of one item, then you are guaranteed to be able to find any item
in the same amount of time as any other item.  On the other hand, if the
number of buckets is smaller than the number of items, then when you go
to fetch an item from a bucket, you might then have to search through
all the items in that bucket to find the one that you want.  This might
slow you down.  On the other hand, if the number of buckets is far
greater than the maximum number of items that will be added, the
algorithm will be wasteful.  Thus it&rsquo;s best to use a number of buckets
that will be slightly greater than the expected maximum number of items.
As a rule of them, use about four times more buckets.
</p>
<p>The second option is the size (in bytes) of the memory mapped region to
use, via the <samp>-m</samp>/<samp>--mmap-size</samp> option.  While the
database is stored on the disk as a file, when it is opened by zeptodb,
some or all of that file is mapped in a one-to-one manner with a region
of virtual memory.  Thus, when the program reads from some address in
that region of memory, it reads directly from the corresponding address
in the file.  This will generally speed up reading and writing compared
to traditional file access.  If the memory-mapped region is smaller than
the size of the database, only portions of the file can be mapped at a
time, thus slowing down performance.  Therefore, it is recommended to
use a sufficiently larger value than the size of the database (taking
into account the expected number of records and the size of the data
that is expected to fill the record values).
</p>
<p>Thus, for a big database, you might do:
</p>
<div class="example">
<pre class="example">$ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
</pre></div>

<p>With the database created, you may now store values to it using
<code>zdbs</code>.  <code>zdbs</code> normally takes its input from
<samp>stdin</samp>.  It expects one record per line and for each key/value
pair to be separated by a delimiter character (&rsquo;|&rsquo; by default).  Note
that records are unique: an attempt to store a record with a
pre-existing key will overwrite that record with a new value.
</p>
<p>For example, let&rsquo;s say that you have a text file <samp>emails.txt</samp>
containing the following records:
</p>
<div class="example">
<pre class="example">Brandon|foo@example.com
Joe|bar@example.com
Mary|baz@example.com
</pre></div>

<p>You could store the records in <samp>foo.db</samp> like so:
</p>
<div class="example">
<pre class="example">$ zdbs foo.db &lt;emails.txt
</pre></div>

<p>Note that if you simply don&rsquo;t like shell redirections like this, you can
also use the <samp>-i</samp> or <samp>--input</samp> option to specify the input
file:
</p>
<div class="example">
<pre class="example">$ zdbs -i emails.txt foo.db
</pre></div>

<p>Of course, it&rsquo;s more likely that you&rsquo;ll want to pipe in records from
some other process:
</p>
<div class="example">
<pre class="example">$ fancy_pipeline.sh | zdbs foo.db
</pre></div>

<p>If your records are formatted differently, using, say, &rsquo;-&rsquo; as the
delimiter (i.e &quot;key-value&quot;), you would specify it using the <samp>-d</samp>
or <samp>--delimiter</samp> option.
</p>
<p>Records can then be fetched from the database using <code>zdbf</code>.  In
this case, queries in the form of keys with one key per line are read
from <samp>stdin</samp>:
</p>
<div class="example">
<pre class="example">$ zdbf foo.db
Brandon
foo@example.com
Joe
bar@example.com
Jon
../trunk/src/zdbf: Key does not exist in the database: Jon: Invalid argument
</pre></div>

<p>As with <code>zdbs</code>, you can also specify a file containing the
queries using the <samp>-i</samp> option or you can read them in through a
pipe.
</p>
<p>If you would prefer the output to include the key, you must specify your
desired delimiter using the <samp>-d</samp> option:
</p>
<div class="example">
<pre class="example">$ echo Brandon | zdbf -d':' foo.db
Brandon:foo@example.com
</pre></div>

<p>Finally, you can dump out all of the contents of the database using the
<samp>-a</samp> option.  Note that the order of the records is in no way
guaranteed.
</p>
<div class="example">
<pre class="example">$ zdbf -d'|' -a foo.db
Joe|bar@example.com
Brandon|foo@example.com
Mary|baz@example.com
</pre></div>

<p>Records may then be removed from the database using <code>zdbr</code>.
<code>zdbr</code> operates in a very similar way to <code>zdbf</code>:
</p>
<div class="example">
<pre class="example">$ zdbr foo.db &lt;&lt;EOF
&gt; Brandon
&gt; Joe
&gt; EOF
$ zdbf -a -d'|' foo.db
Mary|baz@example.com
</pre></div>

<hr>
<a name="Back_002dends"></a>
<div class="header">
<p>
Previous: <a href="#Tutorial" accesskey="p" rel="prev">Tutorial</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Back_002dends-1"></a>
<h3 class="section">1.2 Back-ends</h3>

<p>By default, zeptodb uses the <a href="http://www.gnu.org/software/gdb">GNU dbm</a> (GDBM) library to create and manipulate the DBM databases.
Alternatively, you may choose to use the
<a href="http://fallabs.com/kyotocabinet/">Kyoto Cabinet</a> library
instead.  This is specified by passing the
<samp>--with-kyotocabinet</samp> option to the <samp>configure</samp> script
before compiling zeptodb.
................................................................................
not as widely available in GNU/Linux distributions as GDBM so it often
must be installed manually.
</p>
<hr>
<a name="Commands"></a>
<div class="header">
<p>
Next: <a href="#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Commands-1"></a>
<h2 class="chapter">2 Commands</h2>

<p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
databases and storing records in them; <code>zdbf</code>, for fetching
records from databases; and <code>zdbr</code>, for removing records from
................................................................................
</table>


<hr>
<a name="zdbc"></a>
<div class="header">
<p>
Next: <a href="#zdbs" accesskey="n" rel="next">zdbs</a>, Previous: <a href="#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbc-1"></a>
<h3 class="section">2.1 zdbc</h3>

<p><code>zdbc</code> is used to create a new database file.  It accepts two
options, one to choose the number of buckets for the database and the
other to choose the size of the memory-mapped region.  These options
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbs"></a>
<div class="header">
<p>
Next: <a href="#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="#zdbc" accesskey="p" rel="prev">zdbc</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbs-1"></a>
<h3 class="section">2.2 zdbs</h3>

<p><code>zdbs</code> is used to store records in a database file.  Records
are entered via <samp>stdin</samp> or, optionally, they are read from an
input file, with one record per line.  Each record should consist of
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbf"></a>
<div class="header">
<p>
Next: <a href="#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="#zdbs" accesskey="p" rel="prev">zdbs</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbf-1"></a>
<h3 class="section">2.3 zdbf</h3>

<p><code>zdbf</code> is used to fetch records from a database file.  Queries
are read from <samp>stdin</samp> or, optionally, from a text file.  Records
with key values that match the queries will be printed to
................................................................................
</p></dd>
</dl>

<hr>
<a name="zdbr"></a>
<div class="header">
<p>
Previous: <a href="#zdbf" accesskey="p" rel="prev">zdbf</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="zdbr-1"></a>
<h3 class="section">2.4 zdbr</h3>

<p><code>zdbr</code> is used to remove records from a database.  The records
to be removed are specified by their keys and are entered via
<samp>stdin</samp> or, optionally, they are read from a text file.  If many
................................................................................
</p></dd>
</dl>

<hr>
<a name="Copying-This-Manual"></a>
<div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Copying-This-Manual-1"></a>
<h2 class="appendix">Appendix A Copying This Manual</h2>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
</td></tr>
</table>

<hr>
<a name="GNU-Free-Documentation-License"></a>
<div class="header">
<p>
Previous: <a href="#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="GNU-Free-Documentation-License-1"></a>
<h3 class="section">A.1 GNU Free Documentation License</h3>
<div align="center">Version 1.3, 3 November 2008
</div>

<div class="display">
................................................................................
</p>


<hr>
<a name="Index"></a>
<div class="header">
<p>
Previous: <a href="#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Index-1"></a>
<h2 class="unnumbered">Index</h2>


<hr>



</body>
</html>

Changes to www/zeptodb.html.gz.

cannot compute difference between binary files

Changes to www/zeptodb.html_node.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.info.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.pdf.

cannot compute difference between binary files

Changes to www/zeptodb.texi.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.txt.

1
2

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
..
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
zeptodb
1 Introduction

  1.1 Back-ends
2 Commands
  2.1 zdbc
  2.2 zdbs
  2.3 zdbf
  2.4 zdbr
Appendix A Copying This Manual
  A.1 GNU Free Documentation License
Index
zeptodb
*******

This manual is for zeptodb (version 2.0.1, updated 3 July 2013).

   Copyright (C) 2013 Brandon Invergo

     Permission is granted to copy, distribute and/or modify this
     document under the terms of the GNU Free Documentation License,
     Version 1.3 or any later version published by the Free Software
     Foundation; with no Invariant Sections, no Front-Cover Texts, and
................................................................................
     Foundation Web site at <http://www.gnu.org/licenses/fdl.html>.

   The document was typeset with GNU Texinfo (http://www.texinfo.org/).

1 Introduction
**************

zeptodb is a small collection of relatively tiny tools for interacting
with flat (non-relational) databases.  In fact, they are merely minimal
command-line tools implementing the functionality of a DBM library.
Thus, the databases they manipulate are simple, key-value hash tables.





   These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.  They
may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.




























































































































1.1 Back-ends
=============

By default, zeptodb uses the GNU dbm (http://www.gnu.org/software/gdb)
(GDBM) library to create and manipulate the DBM databases.
Alternatively, you may choose to use the Kyoto Cabinet
(http://fallabs.com/kyotocabinet/) library instead.  This is specified
by passing the '--with-kyotocabinet' option to the 'configure' script


>
|











|







 







|
|
|
|
>
>
>
>







>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
..
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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
zeptodb
1 Introduction
  1.1 Tutorial
  1.2 Back-ends
2 Commands
  2.1 zdbc
  2.2 zdbs
  2.3 zdbf
  2.4 zdbr
Appendix A Copying This Manual
  A.1 GNU Free Documentation License
Index
zeptodb
*******

This manual is for zeptodb (version 2.0.2, updated 13 November 2013).

   Copyright (C) 2013 Brandon Invergo

     Permission is granted to copy, distribute and/or modify this
     document under the terms of the GNU Free Documentation License,
     Version 1.3 or any later version published by the Free Software
     Foundation; with no Invariant Sections, no Front-Cover Texts, and
................................................................................
     Foundation Web site at <http://www.gnu.org/licenses/fdl.html>.

   The document was typeset with GNU Texinfo (http://www.texinfo.org/).

1 Introduction
**************

zeptodb is a small collection of relatively tiny command-line tools for
interacting with DBM databases.  For the uninitiated, DBM databases are
flat (non-relational) a databases; in other words, they are persistent
key-value hash tables.  Typically they are created via a library for C,
Python, Perl, etc.  These tools fill in a gap by providing useful
command-line tools.  Some DBM libraries come with really basic binaries
for manipulating the databases, but they are not designed to be very
flexible or useful in the real world.

   These tools may be helpful in scripts, for example, when persistant
data storage is needed but when a full database would be overkill.  They
may also be useful if, for whatever reason, one would like to
manipulate, via the command-line or scripts, DBM databases created by
other programs.

1.1 Tutorial
============

The zeptodb tools are used to create small databases that are stored to
disk and then to store, fetch and remove records from those databases.
Note that these databases are much simpler than, say, SQL databases.
The databases follow the DBM format as created by the GDBM library *note
Back-ends::.  Each record in a DBM database consists of a key and a
value.  All keys and values are stored as plain text, regardless of
their formats.

   First, you create a new database with 'zdbc':

     $ zdbc foo.db

   You can customize the creation of a database in two ways.  The first
is by specifying the number of "buckets" that comprise the database,
specified via the '-b'/'--num-buckets' option.  A DBM database can be
imagined as a series of buckets.  When a new item is added, an algorithm
determines which bucket it belongs in based on its value.  Likewise, the
same algorithm will be used in determining the bucket from which to
fetch an item.  If each bucket only contains a maximum of one item, then
you are guaranteed to be able to find any item in the same amount of
time as any other item.  On the other hand, if the number of buckets is
smaller than the number of items, then when you go to fetch an item from
a bucket, you might then have to search through all the items in that
bucket to find the one that you want.  This might slow you down.  On the
other hand, if the number of buckets is far greater than the maximum
number of items that will be added, the algorithm will be wasteful.
Thus it's best to use a number of buckets that will be slightly greater
than the expected maximum number of items.  As a rule of them, use about
four times more buckets.

   The second option is the size (in bytes) of the memory mapped region
to use, via the '-m'/'--mmap-size' option.  While the database is stored
on the disk as a file, when it is opened by zeptodb, some or all of that
file is mapped in a one-to-one manner with a region of virtual memory.
Thus, when the program reads from some address in that region of memory,
it reads directly from the corresponding address in the file.  This will
generally speed up reading and writing compared to traditional file
access.  If the memory-mapped region is smaller than the size of the
database, only portions of the file can be mapped at a time, thus
slowing down performance.  Therefore, it is recommended to use a
sufficiently larger value than the size of the database (taking into
account the expected number of records and the size of the data that is
expected to fill the record values).

   Thus, for a big database, you might do:

     $ zdbc --num-buckets=10000 --mmap-size=512000000 big.db

   With the database created, you may now store values to it using
'zdbs'.  'zdbs' normally takes its input from 'stdin'.  It expects one
record per line and for each key/value pair to be separated by a
delimiter character ('|' by default).  Note that records are unique: an
attempt to store a record with a pre-existing key will overwrite that
record with a new value.

   For example, let's say that you have a text file 'emails.txt'
containing the following records:

     Brandon|foo@example.com
     Joe|bar@example.com
     Mary|baz@example.com

   You could store the records in 'foo.db' like so:

     $ zdbs foo.db <emails.txt

   Note that if you simply don't like shell redirections like this, you
can also use the '-i' or '--input' option to specify the input file:

     $ zdbs -i emails.txt foo.db

   Of course, it's more likely that you'll want to pipe in records from
some other process:

     $ fancy_pipeline.sh | zdbs foo.db

   If your records are formatted differently, using, say, '-' as the
delimiter (i.e "key-value"), you would specify it using the '-d' or
'--delimiter' option.

   Records can then be fetched from the database using 'zdbf'.  In this
case, queries in the form of keys with one key per line are read from
'stdin':

     $ zdbf foo.db
     Brandon
     foo@example.com
     Joe
     bar@example.com
     Jon
     ../trunk/src/zdbf: Key does not exist in the database: Jon: Invalid argument

   As with 'zdbs', you can also specify a file containing the queries
using the '-i' option or you can read them in through a pipe.

   If you would prefer the output to include the key, you must specify
your desired delimiter using the '-d' option:

     $ echo Brandon | zdbf -d':' foo.db
     Brandon:foo@example.com

   Finally, you can dump out all of the contents of the database using
the '-a' option.  Note that the order of the records is in no way
guaranteed.

     $ zdbf -d'|' -a foo.db
     Joe|bar@example.com
     Brandon|foo@example.com
     Mary|baz@example.com

   Records may then be removed from the database using 'zdbr'.  'zdbr'
operates in a very similar way to 'zdbf':

     $ zdbr foo.db <<EOF
     > Brandon
     > Joe
     > EOF
     $ zdbf -a -d'|' foo.db
     Mary|baz@example.com

1.2 Back-ends
=============

By default, zeptodb uses the GNU dbm (http://www.gnu.org/software/gdb)
(GDBM) library to create and manipulate the DBM databases.
Alternatively, you may choose to use the Kyoto Cabinet
(http://fallabs.com/kyotocabinet/) library instead.  This is specified
by passing the '--with-kyotocabinet' option to the 'configure' script

Changes to www/zeptodb.txt.gz.

cannot compute difference between binary files