Tagged db.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4322 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-16 18:59:27 +00:00
parent 44680d4259
commit b742c85fe6

View File

@ -13,228 +13,263 @@
]> ]>
<sect1 id="db" xreflabel="Berkeley DB-&db-version;"> <sect1 id="db" xreflabel="Berkeley DB-&db-version;">
<sect1info> <?dbhtml filename="db.html"?>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="db.html"?>
<title>Berkeley DB-&db-version;</title>
<indexterm zone="db">
<primary sortas="a-Berkeley-DB">Berkeley DB</primary></indexterm>
<sect2> <sect1info>
<title>Introduction to <application>Berkeley DB</application></title> <othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<para>The <application>Berkeley DB</application> package contains programs and <title>Berkeley DB-&db-version;</title>
utilities used by many other applications for database related
functions.</para>
<sect3><title>Package information</title> <indexterm zone="db">
<itemizedlist spacing='compact'> <primary sortas="a-Berkeley-DB">Berkeley DB</primary>
<listitem><para>Download (HTTP): <ulink </indexterm>
url="&db-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&db-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &db-md5sum;</para></listitem>
<listitem><para>Download size: &db-size;</para></listitem>
<listitem><para>Estimated disk space required:
&db-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&db-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title><application>Berkeley DB</application> dependencies</title> <sect2 role="package">
<sect4><title>Optional</title> <title>Introduction to Berkeley DB</title>
<para><xref linkend="tcl"/> and <xref linkend="jdk"/></para>
</sect4>
</sect3>
</sect2> <para>The <application>Berkeley DB</application> package contains programs
and utilities used by many other applications for database related
functions.</para>
<sect2> <bridgehead renderas="sect3">Package Information</bridgehead>
<title>Installation of <application>Berkeley DB</application></title> <itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&db-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&db-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &db-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &db-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &db-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &db-time;</para>
</listitem>
</itemizedlist>
<para>Install <application>Berkeley DB</application> by running the following <bridgehead renderas="sect3">Berkeley DB Dependencies</bridgehead>
commands:</para>
<screen><userinput><command>cd build_unix &amp;&amp; <bridgehead renderas="sect4">Optional</bridgehead>
<para><xref linkend="tcl"/> and <xref linkend="jdk"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Berkeley DB</title>
<para>Install <application>Berkeley DB</application> by running the
following commands:</para>
<screen><userinput>cd build_unix &amp;&amp;
../dist/configure --prefix=/usr \ ../dist/configure --prefix=/usr \
--enable-compat185 \ --enable-compat185 \
--enable-cxx &amp;&amp; --enable-cxx &amp;&amp;
make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread"</command></userinput></screen> make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread"</userinput></screen>
<para>To test the results, start <command>tclsh</command> and issue:</para> <para>To test the results, start <command>tclsh</command> and issue:</para>
<screen><userinput><command>source ../test/test.tcl <screen><userinput>source ../test/test.tcl
run_parallel run_std</command></userinput></screen> run_parallel run_std</userinput></screen>
<para>Now, as the root user:</para> <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen><userinput role='root'><command>make docdir=/usr/share/doc/db-&db-version; install &amp;&amp; <screen role="root"><userinput>make docdir=/usr/share/doc/db-&db-version; install &amp;&amp;
chown root:root /usr/bin/db_* \ chown root:root /usr/bin/db_* \
/usr/lib/libdb* /usr/include/db* &amp;&amp; /usr/lib/libdb* /usr/include/db* &amp;&amp;
chown -R root:root /usr/share/doc/db-&db-version;</command></userinput></screen> chown -R root:root /usr/share/doc/db-&db-version;</userinput></screen>
</sect2> </sect2>
<sect2> <sect2 role="commands">
<title>Command explanations</title> <title>Command Explanations</title>
<para><command>cd build_unix &amp;&amp; <para><command>cd build_unix &amp;&amp;
../dist/configure --prefix=/usr...</command>: ../dist/configure --prefix=/usr...</command>:
This replaces the normal <command>./configure</command> command, as This replaces the normal <command>./configure</command> command, as
<application>Berkeley DB</application> comes with various <application>Berkeley DB</application> comes with various
build directories for different platforms.</para> build directories for different platforms.</para>
<para><parameter>--enable-compat185</parameter>: This switch enables <para><parameter>--enable-compat185</parameter>: This switch enables
building DB 1.85 compatibility <acronym>API</acronym>.</para> building DB 1.85 compatibility API.</para>
<para><parameter>--enable-cxx</parameter>: This switch enables building <para><parameter>--enable-cxx</parameter>: This switch enables building
C++ <acronym>API</acronym> libraries.</para> C++ API libraries.</para>
<para><command>make LIBSO_LIBS="-lpthread" <para><command>make LIBSO_LIBS="-lpthread"
LIBXSO_LIBS="-lpthread"</command>: <command>configure</command> does not LIBXSO_LIBS="-lpthread"</command>: <command>configure</command>
correctly handle <acronym>NPTL</acronym>. These variables force it to does not correctly handle NPTL. These variables force it to
properly link against <acronym>NPTL</acronym>.</para> properly link against NPTL.</para>
<para><command>make docdir=/usr/share/doc/db-&db-version; <para><command>make docdir=/usr/share/doc/db-&db-version;
install</command>: This installs the documentation in install</command>: This installs the documentation in
the correct place.</para> the correct place.</para>
<para><option>--enable-test</option>: Enables building the test suite <para><option>--enable-test</option>: Enables building the test suite
(requires the two Tcl switches below).</para> (requires the two Tcl switches below).</para>
<para><option>--enable-tcl --with-tcl=/usr/lib</option>: <para><option>--enable-tcl --with-tcl=/usr/lib</option>:
Enables <application>Tcl</application> support in DB and creates the Enables <application>Tcl</application> support in DB and creates the
<filename class="libraryfile">libdb_tcl</filename> libraries.</para> <filename class="libraryfile">libdb_tcl</filename> libraries.</para>
<para><option>--enable-java</option>: Enables <application>Java</application> <para><option>--enable-java</option>: Enables
support in DB and creates the <application>Java</application> support in DB and creates the
<filename class='libraryfile'>libdb_java</filename> libraries.</para> <filename class='libraryfile'>libdb_java</filename> libraries.</para>
<para><option>--enable-rpc</option>: Enables building the <para><option>--enable-rpc</option>: Enables building the
<application>Berkeley DB</application> <acronym>RPC</acronym> server.</para> <application>Berkeley DB</application> RPC server.</para>
</sect2> </sect2>
<sect2> <sect2 role="content">
<title>Contents</title> <title>Contents</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed Programs</segtitle> <segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle> <segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle> <segtitle>Installed Directory</segtitle>
<seglistitem> <seglistitem>
<seg>berkeley_db_svc, db_archive, db_checkpoint, db_deadlock, db_dump, <seg>berkeley_db_svc, db_archive, db_checkpoint, db_deadlock, db_dump,
db_load, db_printlog, db_recover, db_stat, db_upgrade and db_verify</seg> db_load, db_printlog, db_recover, db_stat, db_upgrade and db_verify</seg>
<seg>libdb.[so,a], libdb_cxx.[so,a], libdb_java.[so,a] and <seg>libdb.[so,a], libdb_cxx.[so,a], libdb_java.[so,a] and
libdb_tcl.[so,a]</seg> libdb_tcl.[so,a]</seg>
<seg>/usr/share/doc/db-&db-version;</seg> <seg>/usr/share/doc/db-&db-version;</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="berkeley_db_svc"> <varlistentry id="berkeley_db_svc">
<term><command>berkeley_db_svc</command></term> <term><command>berkeley_db_svc</command></term>
<listitem><para>is the <application>Berkeley DB</application> <listitem>
<acronym>RPC</acronym> server.</para> <para>is the <application>Berkeley DB</application>
<indexterm zone="db berkeley_db_svc"> RPC server.</para>
<primary sortas="b-berkeley_db_svc">berkeley_db_svc</primary> <indexterm zone="db berkeley_db_svc">
</indexterm></listitem> <primary sortas="b-berkeley_db_svc">berkeley_db_svc</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_archive"> <varlistentry id="db_archive">
<term><command>db_archive</command></term> <term><command>db_archive</command></term>
<listitem><para>prints the pathnames of log files that are no longer in <listitem>
use.</para> <para>prints the pathnames of log files that are no longer in
<indexterm zone="db db_archive"> use.</para>
<primary sortas="b-db_archive">db_archive</primary> <indexterm zone="db db_archive">
</indexterm></listitem> <primary sortas="b-db_archive">db_archive</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_checkpoint"> <varlistentry id="db_checkpoint">
<term><command>db_checkpoint</command></term> <term><command>db_checkpoint</command></term>
<listitem><para>is a daemon process used to monitor and checkpoint database <listitem>
logs.</para> <para>is a daemon process used to monitor and checkpoint database
<indexterm zone="db db_checkpoint"> logs.</para>
<primary sortas="b-db_checkpoint">db_checkpoint</primary> <indexterm zone="db db_checkpoint">
</indexterm></listitem> <primary sortas="b-db_checkpoint">db_checkpoint</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_deadlock"> <varlistentry id="db_deadlock">
<term><command>db_deadlock</command></term> <term><command>db_deadlock</command></term>
<listitem><para>is used to abort lock requests when deadlocks are <listitem>
detected.</para> <para>is used to abort lock requests when deadlocks are
<indexterm zone="db db_deadlock"> detected.</para>
<primary sortas="b-db_deadlock">db_deadlock</primary> <indexterm zone="db db_deadlock">
</indexterm></listitem> <primary sortas="b-db_deadlock">db_deadlock</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_dump"> <varlistentry id="db_dump">
<term><command>db_dump</command></term> <term><command>db_dump</command></term>
<listitem><para>converts database files to a flat file format readable by <listitem>
<command>db_load</command>.</para> <para>converts database files to a flat file format readable by
<indexterm zone="db db_dump"> <command>db_load</command>.</para>
<primary sortas="b-db_dump">db_dump</primary> <indexterm zone="db db_dump">
</indexterm></listitem> <primary sortas="b-db_dump">db_dump</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_load"> <varlistentry id="db_load">
<term><command>db_load</command></term> <term><command>db_load</command></term>
<listitem><para>is used to create database files from flat files created with <listitem>
<command>db_dump</command>.</para> <para>is used to create database files from flat files created with
<indexterm zone="db db_load"> <command>db_dump</command>.</para>
<primary sortas="b-db_load">db_load</primary> <indexterm zone="db db_load">
</indexterm></listitem> <primary sortas="b-db_load">db_load</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_printlog"> <varlistentry id="db_printlog">
<term><command>db_printlog</command></term> <term><command>db_printlog</command></term>
<listitem><para>converts database log files to human readable text.</para> <listitem>
<indexterm zone="db db_printlog"> <para>converts database log files to human readable text.</para>
<primary sortas="b-db_printlog">db_printlog</primary> <indexterm zone="db db_printlog">
</indexterm></listitem> <primary sortas="b-db_printlog">db_printlog</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_recover"> <varlistentry id="db_recover">
<term><command>db_recover</command></term> <term><command>db_recover</command></term>
<listitem><para>is used to restore a database to a consistent state after a <listitem>
failure.</para> <para>is used to restore a database to a consistent state after a
<indexterm zone="db db_recover"> failure.</para>
<primary sortas="b-db_recover">db_recover</primary> <indexterm zone="db db_recover">
</indexterm></listitem> <primary sortas="b-db_recover">db_recover</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_stat"> <varlistentry id="db_stat">
<term><command>db_stat</command></term> <term><command>db_stat</command></term>
<listitem><para>displays database environment statistics.</para> <listitem>
<indexterm zone="db db_stat"> <para>displays database environment statistics.</para>
<primary sortas="b-db_stat">db_stat</primary> <indexterm zone="db db_stat">
</indexterm></listitem> <primary sortas="b-db_stat">db_stat</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_upgrade"> <varlistentry id="db_upgrade">
<term><command>db_upgrade</command></term> <term><command>db_upgrade</command></term>
<listitem><para>is used to upgrade database files to a newer version of <listitem>
<application>Berkeley DB</application>.</para> <para>is used to upgrade database files to a newer version of
<indexterm zone="db db_upgrade"> <application>Berkeley DB</application>.</para>
<primary sortas="b-db_upgrade">db_upgrade</primary> <indexterm zone="db db_upgrade">
</indexterm></listitem> <primary sortas="b-db_upgrade">db_upgrade</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_verify"> <varlistentry id="db_verify">
<term><command>db_verify</command></term> <term><command>db_verify</command></term>
<listitem><para>is used to run consistency checks on database files.</para> <listitem>
<indexterm zone="db db_verify"> <para>is used to run consistency checks on database files.</para>
<primary sortas="b-db_verify">db_verify</primary> <indexterm zone="db db_verify">
</indexterm></listitem> <primary sortas="b-db_verify">db_verify</primary>
</varlistentry> </indexterm>
</variablelist> </listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>