source: chapter08/gdbm.xml@ ae3f78a

11.0 11.1 11.1-rc1 arm ml-11.0 multilib trunk xry111/clfs-ng xry111/lfs-next
Last change on this file since ae3f78a was ae3f78a, checked in by Xi Ruoyao <xry111@…>, 9 months ago

gdbm: document gdbmtool tests fail, add -k

  • Property mode set to 100644
File size: 4.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-gdbm" role="wrap">
9 <?dbhtml filename="gdbm.html"?>
10
11 <sect1info condition="script">
12 <productname>gdbm</productname>
13 <productnumber>&gdbm-version;</productnumber>
14 <address>&gdbm-url;</address>
15 </sect1info>
16
17 <title>GDBM-&gdbm-version;</title>
18
19 <indexterm zone="ch-system-gdbm">
20 <primary sortas="a-Gdbm">GDBM</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The GDBM package contains the GNU Database Manager. It is a library
27 of database functions that use extensible hashing and works similar to the
28 standard UNIX dbm. The library provides primitives for storing key/data
29 pairs, searching and retrieving the data by its key and deleting a key
30 along with its data. </para>
31
32 <segmentedlist>
33 <segtitle>&buildtime;</segtitle>
34 <segtitle>&diskspace;</segtitle>
35
36 <seglistitem>
37 <seg>&gdbm-fin-sbu;</seg>
38 <seg>&gdbm-fin-du;</seg>
39 </seglistitem>
40 </segmentedlist>
41
42 </sect2>
43
44 <sect2 role="installation">
45 <title>Installation of GDBM</title>
46<!--
47 <para>First, fix an issue first identified by gcc-10:</para>
48
49<screen><userinput remap="pre">sed -r -i '/^char.*parseopt_program_(doc|args)/d' src/parseopt.c</userinput></screen>
50-->
51 <para>Prepare GDBM for compilation:</para>
52
53<screen><userinput remap="configure">./configure --prefix=/usr \
54 --disable-static \
55 --enable-libgdbm-compat</userinput></screen>
56
57 <variablelist>
58 <title>The meaning of the configure option:</title>
59
60 <varlistentry>
61 <term><envar>--enable-libgdbm-compat</envar></term>
62 <listitem>
63 <para>This switch enables building the libgdbm compatibility library.
64 Some packages outside of LFS may require the older DBM
65 routines it provides.</para>
66 </listitem>
67 </varlistentry>
68 </variablelist>
69
70 <para>Compile the package:</para>
71
72<screen><userinput remap="make">make</userinput></screen>
73
74 <para>To test the results, issue:</para>
75
76<screen><userinput remap="test">make -k check</userinput></screen>
77
78 <para>
79 The gdbmtool tests are known to fail with some DejaGNU
80 <literal>ERROR</literal> messages. In the summary it's
81 shown as one unresolved testcase.
82 </para>
83
84 <para>Install the package:</para>
85
86<screen><userinput remap="install">make install</userinput></screen>
87
88 </sect2>
89
90 <sect2 id="contents-gdbm" role="content">
91 <title>Contents of GDBM</title>
92
93 <segmentedlist>
94 <segtitle>Installed programs</segtitle>
95 <segtitle>Installed libraries</segtitle>
96
97 <seglistitem>
98 <seg>gdbm_dump, gdbm_load, and gdbmtool</seg>
99 <seg>libgdbm.so and libgdbm_compat.so</seg>
100 </seglistitem>
101 </segmentedlist>
102
103 <variablelist>
104 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
105 <?dbfo list-presentation="list"?>
106 <?dbhtml list-presentation="table"?>
107
108 <varlistentry id="gdbm_dump">
109 <term><command>gdbm_dump</command></term>
110 <listitem>
111 <para>Dumps a GDBM database to a file</para>
112 <indexterm zone="ch-system-gdbm gdbm_dump">
113 <primary sortas="b-gdbm_dump">gdbm_dump</primary>
114 </indexterm>
115 </listitem>
116 </varlistentry>
117
118 <varlistentry id="gdbm_load">
119 <term><command>gdbm_load</command></term>
120 <listitem>
121 <para>Recreates a GDBM database from a dump file</para>
122 <indexterm zone="ch-system-gdbm gdbm_load">
123 <primary sortas="b-gdbm_load">gdbm_load</primary>
124 </indexterm>
125 </listitem>
126 </varlistentry>
127
128 <varlistentry id="gdbmtool">
129 <term><command>gdbmtool</command></term>
130 <listitem>
131 <para>Tests and modifies a GDBM database</para>
132 <indexterm zone="ch-system-gdbm gdbmtool">
133 <primary sortas="b-gdbmtool">gdbmtool</primary>
134 </indexterm>
135 </listitem>
136 </varlistentry>
137
138 <varlistentry id="libgdbm">
139 <term><filename class="libraryfile">libgdbm</filename></term>
140 <listitem>
141 <para>Contains functions to manipulate a hashed database</para>
142 <indexterm zone="ch-system-gdbm libgdbm">
143 <primary sortas="c-libgdbm">libgdbm</primary>
144 </indexterm>
145 </listitem>
146 </varlistentry>
147
148 <varlistentry id="libgdbm_compat">
149 <term><filename class="libraryfile">libgdbm_compat</filename></term>
150 <listitem>
151 <para>Compatibility library containing older DBM functions</para>
152 <indexterm zone="ch-system-gdbm libgdbm_compat">
153 <primary sortas="c-libgdbm_compat">libgdbm_compat</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
158 </variablelist>
159
160 </sect2>
161
162</sect1>
Note: See TracBrowser for help on using the repository browser.