source: content/databases/db.xml@ bcbca63

10.0 10.1 11.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since bcbca63 was bcbca63, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated build entities and added indexing tags to Berkeley DB instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3608 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY db-download-http " ">
8 <!ENTITY db-download-ftp "ftp://sleepycat1.inetu.net/releases/db-&db-version;.tar.gz">
9 <!ENTITY db-md5sum "fcc481d52c3b80e20a328f8c0cb042bd">
10 <!ENTITY db-size "5.7 MB">
11 <!ENTITY db-buildsize "68 MB (additional 140 MB to run parallel standard testsuite)">
12 <!ENTITY db-time "1.23 SBU (additional 74.5 SBU to run parallel standard testsuite)">
13]>
14
15<sect1 id="db" xreflabel="Berkeley DB-&db-version;">
16<sect1info>
17<othername>$LastChangedBy$</othername>
18<date>$Date$</date>
19</sect1info>
20<?dbhtml filename="db.html"?>
21<title>Berkeley DB-&db-version;</title>
22<indexterm zone="db">
23<primary sortas="a-Berkeley-DB">Berkeley DB</primary></indexterm>
24
25<sect2>
26<title>Introduction to <application>Berkeley DB</application></title>
27
28<para>The <application>Berkeley DB</application> package contains programs and
29utilities used by many other applications for database related
30functions.</para>
31
32<sect3><title>Package information</title>
33<itemizedlist spacing='compact'>
34<listitem><para>Download (HTTP): <ulink
35url="&db-download-http;"/></para></listitem>
36<listitem><para>Download (FTP): <ulink
37url="&db-download-ftp;"/></para></listitem>
38<listitem><para>Download MD5 sum: &db-md5sum;</para></listitem>
39<listitem><para>Download size: &db-size;</para></listitem>
40<listitem><para>Estimated disk space required:
41&db-buildsize;</para></listitem>
42<listitem><para>Estimated build time:
43&db-time;</para></listitem></itemizedlist>
44</sect3>
45
46<sect3><title><application>Berkeley DB</application> dependencies</title>
47<sect4><title>Optional</title>
48<para><xref linkend="tcl"/> and <xref linkend="j2sdk"/></para>
49</sect4>
50</sect3>
51
52</sect2>
53
54<sect2>
55<title>Installation of <application>Berkeley DB</application></title>
56
57<para>Install <application>Berkeley DB</application> by running the following
58commands:</para>
59
60<screen><userinput><command>cd build_unix &amp;&amp;
61../dist/configure --prefix=/usr \
62 --enable-compat185 \
63 --enable-cxx &amp;&amp;
64make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread"</command></userinput></screen>
65
66<para>Now, as the root user:</para>
67
68<screen><userinput role='root'><command>make docdir=/usr/share/doc/db-&db-version; install &amp;&amp;
69chown root:root /usr/bin/db_* \
70/usr/lib/libdb* /usr/include/db* &amp;&amp;
71chown -R root:root /usr/share/doc/db-&db-version;</command></userinput></screen>
72
73</sect2>
74
75<sect2>
76<title>Command explanations</title>
77
78<para><command>cd build_unix &amp;&amp;
79../dist/configure --prefix=/usr...</command>:
80This replaces the normal <command>./configure</command> command, as
81<application>Berkeley DB</application> comes with various
82build directories for different platforms.</para>
83
84<para><parameter>--enable-compat185</parameter>: This switch enables
85building DB 1.85 compatibility <acronym>API</acronym>.</para>
86
87<para><parameter>--enable-cxx</parameter>: This switch enables building
88C++ <acronym>API</acronym> libraries.</para>
89
90<para><command>make LIBSO_LIBS="-lpthread"
91LIBXSO_LIBS="-lpthread"</command>: <command>configure</command> does not
92correctly handle <acronym>NPTL</acronym>. These variables force it to
93properly link against <acronym>NPTL</acronym>.</para>
94
95<para><command>make docdir=/usr/share/doc/db-&db-version;
96install</command>: This installs the documentation in
97the correct place.</para>
98
99<para><option>--enable-tcl --with-tcl=/usr/lib</option>:
100Enables <application>Tcl</application> support in DB and creates the
101<filename class="libraryfile">libdb_tcl</filename> libraries.</para>
102
103<para><option>--enable-java</option>: Enables <application>Java</application>
104support in DB and creates the
105<filename class='libraryfile'>libdb_java</filename> libraries.</para>
106
107<para><option>--enable-rpc</option>: Enables building the
108<application>Berkeley DB</application> <acronym>RPC</acronym> server.</para>
109
110</sect2>
111
112<sect2>
113<title>Contents</title>
114
115<segmentedlist>
116<segtitle>Installed Programs</segtitle>
117<segtitle>Installed Libraries</segtitle>
118<segtitle>Installed Directory</segtitle>
119
120<seglistitem>
121<seg>berkeley_db_svc, db_archive, db_checkpoint, db_deadlock, db_dump,
122db_load, db_printlog, db_recover, db_stat, db_upgrade and db_verify</seg>
123<seg>libdb.[so,a], libdb_cxx.[so,a], libdb_java.[so,a] and
124libdb_tcl.[so,a]</seg>
125<seg>/usr/share/doc/db-&db-version;</seg>
126</seglistitem>
127</segmentedlist>
128
129<variablelist>
130<bridgehead renderas="sect3">Short Descriptions</bridgehead>
131<?dbfo list-presentation="list"?>
132
133<varlistentry id="berkeley_db_svc">
134<term><command>berkeley_db_svc</command></term>
135<listitem><para>is the <application>Berkeley DB</application>
136<acronym>RPC</acronym> server.</para>
137<indexterm zone="db berkeley_db_svc">
138<primary sortas="b-berkeley_db_svc">berkeley_db_svc</primary>
139</indexterm></listitem>
140</varlistentry>
141
142<varlistentry id="db_archive">
143<term><command>db_archive</command></term>
144<listitem><para>prints the pathnames of log files that are no longer in
145use.</para>
146<indexterm zone="db db_archive">
147<primary sortas="b-db_archive">db_archive</primary>
148</indexterm></listitem>
149</varlistentry>
150
151<varlistentry id="db_checkpoint">
152<term><command>db_checkpoint</command></term>
153<listitem><para>is a daemon process used to monitor and checkpoint database
154logs.</para>
155<indexterm zone="db db_checkpoint">
156<primary sortas="b-db_checkpoint">db_checkpoint</primary>
157</indexterm></listitem>
158</varlistentry>
159
160<varlistentry id="db_deadlock">
161<term><command>db_deadlock</command></term>
162<listitem><para>is used to abort lock requests when deadlocks are
163detected.</para>
164<indexterm zone="db db_deadlock">
165<primary sortas="b-db_deadlock">db_deadlock</primary>
166</indexterm></listitem>
167</varlistentry>
168
169<varlistentry id="db_dump">
170<term><command>db_dump</command></term>
171<listitem><para>converts database files to a flat file format readable by
172<command>db_load</command>.</para>
173<indexterm zone="db db_dump">
174<primary sortas="b-db_dump">db_dump</primary>
175</indexterm></listitem>
176</varlistentry>
177
178<varlistentry id="db_load">
179<term><command>db_load</command></term>
180<listitem><para>is used to create database files from flat files created with
181<command>db_dump</command>.</para>
182<indexterm zone="db db_load">
183<primary sortas="b-db_load">db_load</primary>
184</indexterm></listitem>
185</varlistentry>
186
187<varlistentry id="db_printlog">
188<term><command>db_printlog</command></term>
189<listitem><para>converts database log files to human readable text.</para>
190<indexterm zone="db db_printlog">
191<primary sortas="b-db_printlog">db_printlog</primary>
192</indexterm></listitem>
193</varlistentry>
194
195<varlistentry id="db_recover">
196<term><command>db_recover</command></term>
197<listitem><para>is used to restore a database to a consistent state after a
198failure.</para>
199<indexterm zone="db db_recover">
200<primary sortas="b-db_recover">db_recover</primary>
201</indexterm></listitem>
202</varlistentry>
203
204<varlistentry id="db_stat">
205<term><command>db_stat</command></term>
206<listitem><para>displays database environment statistics.</para>
207<indexterm zone="db db_stat">
208<primary sortas="b-db_stat">db_stat</primary>
209</indexterm></listitem>
210</varlistentry>
211
212<varlistentry id="db_upgrade">
213<term><command>db_upgrade</command></term>
214<listitem><para>is used to upgrade database files to a newer version of
215<application>Berkeley DB</application>.</para>
216<indexterm zone="db db_upgrade">
217<primary sortas="b-db_upgrade">db_upgrade</primary>
218</indexterm></listitem>
219</varlistentry>
220
221<varlistentry id="db_verify">
222<term><command>db_verify</command></term>
223<listitem><para>is used to run consistency checks on database files.</para>
224<indexterm zone="db db_verify">
225<primary sortas="b-db_verify">db_verify</primary>
226</indexterm></listitem>
227</varlistentry>
228</variablelist>
229
230</sect2>
231
232</sect1>
Note: See TracBrowser for help on using the repository browser.