Author: randy Date: 2005-03-30 10:32:22 -0700 (Wed, 30 Mar 2005) New Revision: 3608
Modified: trunk/BOOK/content/databases/db.xml trunk/BOOK/general.ent Log: Updated build entities and added indexing tags to Berkeley DB instructions Modified: trunk/BOOK/content/databases/db.xml =================================================================== --- trunk/BOOK/content/databases/db.xml 2005-03-29 19:54:57 UTC (rev 3607) +++ trunk/BOOK/content/databases/db.xml 2005-03-30 17:32:22 UTC (rev 3608) @@ -8,8 +8,8 @@ <!ENTITY db-download-ftp "ftp://sleepycat1.inetu.net/releases/db-&db-version;.tar.gz";> <!ENTITY db-md5sum "fcc481d52c3b80e20a328f8c0cb042bd"> <!ENTITY db-size "5.7 MB"> - <!ENTITY db-buildsize "68 MB"> - <!ENTITY db-time "1.23 SBU"> + <!ENTITY db-buildsize "68 MB (additional 140 MB to run parallel standard testsuite)"> + <!ENTITY db-time "1.23 SBU (additional 74.5 SBU to run parallel standard testsuite)"> ]> <sect1 id="db" xreflabel="Berkeley DB-&db-version;"> @@ -19,6 +19,8 @@ </sect1info> <?dbhtml filename="db.html"?> <title>Berkeley DB-&db-version;</title> +<indexterm zone="db"> +<primary sortas="a-Berkeley-DB">Berkeley DB</primary></indexterm> <sect2> <title>Introduction to <application>Berkeley DB</application></title> @@ -59,16 +61,12 @@ ../dist/configure --prefix=/usr \ --enable-compat185 \ --enable-cxx && -make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread" && -make docdir=/usr/share/doc/db-&db-version; install</command></userinput></screen> +make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread"</command></userinput></screen> -<para><emphasis>Note:</emphasis> If you build the package as an unprivileged -user, then switch to the root user to install the package, -<application>Berkeley DB</application> will install the files with ownerships -of the user building the package. This is undesireable. Change the ownership of -the installed files using the following commands:</para> +<para>Now, as the root user:</para> -<screen><userinput><command>chown root:root /usr/bin/db_* \ +<screen><userinput role='root'><command>make docdir=/usr/share/doc/db-&db-version; install && +chown root:root /usr/bin/db_* \ /usr/lib/libdb* /usr/include/db* && chown -R root:root /usr/share/doc/db-&db-version;</command></userinput></screen> @@ -87,88 +85,147 @@ building DB 1.85 compatibility <acronym>API</acronym>.</para> <para><parameter>--enable-cxx</parameter>: This switch enables building -C++ <acronym>API</acronym>.</para> +C++ <acronym>API</acronym> libraries.</para> <para><command>make LIBSO_LIBS="-lpthread" -LIBXSO_LIBS="-lpthread"</command>: configure does not correctly handle -<acronym>NPTL</acronym>. These variables force it to properly link -against <acronym>NPTL</acronym>.</para> +LIBXSO_LIBS="-lpthread"</command>: <command>configure</command> does not +correctly handle <acronym>NPTL</acronym>. These variables force it to +properly link against <acronym>NPTL</acronym>.</para> <para><command>make docdir=/usr/share/doc/db-&db-version; install</command>: This installs the documentation in the correct place.</para> <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> -<para><option>--enable-java</option>: enables <application>Java</application> +<para><option>--enable-java</option>: Enables <application>Java</application> support in DB and creates the <filename class='libraryfile'>libdb_java</filename> libraries.</para> +<para><option>--enable-rpc</option>: Enables building the +<application>Berkeley DB</application> <acronym>RPC</acronym> server.</para> + </sect2> <sect2> <title>Contents</title> -<para>The <application>Berkeley DB</application> package contains -<command>db_archive</command>, -<command>db_checkpoint</command>, -<command>db_deadlock</command>, -<command>db_dump</command>, -<command>db_load</command>, -<command>db_printlog</command>, -<command>db_recover</command>, -<command>db_stat</command>, -<command>db_upgrade</command>, -<command>db_verify</command> and the -<filename class='libraryfile'>libdb</filename> libraries. +<segmentedlist> +<segtitle>Installed Programs</segtitle> +<segtitle>Installed Libraries</segtitle> +<segtitle>Installed Directory</segtitle> -</para> +<seglistitem> +<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> +<seg>libdb.[so,a], libdb_cxx.[so,a], libdb_java.[so,a] and +libdb_tcl.[so,a]</seg> +<seg>/usr/share/doc/db-&db-version;</seg> +</seglistitem> +</segmentedlist> -</sect2> +<variablelist> +<bridgehead renderas="sect3">Short Descriptions</bridgehead> +<?dbfo list-presentation="list"?> -<sect2><title>Description</title> +<varlistentry id="berkeley_db_svc"> +<term><command>berkeley_db_svc</command></term> +<listitem><para>is the <application>Berkeley DB</application> +<acronym>RPC</acronym> server.</para> +<indexterm zone="db berkeley_db_svc"> +<primary sortas="b-berkeley_db_svc">berkeley_db_svc</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_archive</title> -<para><command>db_archive</command> prints the pathnames of log files that are -no longer in use.</para></sect3> +<varlistentry id="db_archive"> +<term><command>db_archive</command></term> +<listitem><para>prints the pathnames of log files that are no longer in +use.</para> +<indexterm zone="db db_archive"> +<primary sortas="b-db_archive">db_archive</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_checkpoint</title> -<para><command>db_checkpoint</command> is a daemon process used to monitor and -checkpoint database logs.</para></sect3> +<varlistentry id="db_checkpoint"> +<term><command>db_checkpoint</command></term> +<listitem><para>is a daemon process used to monitor and checkpoint database +logs.</para> +<indexterm zone="db db_checkpoint"> +<primary sortas="b-db_checkpoint">db_checkpoint</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_deadlock</title> -<para><command>db_deadlock</command> is used to abort lock requests when -deadlocks are detected.</para></sect3> +<varlistentry id="db_deadlock"> +<term><command>db_deadlock</command></term> +<listitem><para>is used to abort lock requests when deadlocks are +detected.</para> +<indexterm zone="db db_deadlock"> +<primary sortas="b-db_deadlock">db_deadlock</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_dump</title> -<para><command>db_dump</command> converts database files to a flat file format -readable by <command>db_load</command>.</para></sect3> +<varlistentry id="db_dump"> +<term><command>db_dump</command></term> +<listitem><para>converts database files to a flat file format readable by +<command>db_load</command>.</para> +<indexterm zone="db db_dump"> +<primary sortas="b-db_dump">db_dump</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_load</title> -<para><command>db_load</command> is used to create database files from flat -files created with <command>db_dump</command>.</para></sect3> +<varlistentry id="db_load"> +<term><command>db_load</command></term> +<listitem><para>is used to create database files from flat files created with +<command>db_dump</command>.</para> +<indexterm zone="db db_load"> +<primary sortas="b-db_load">db_load</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_printlog</title> -<para><command>db_printlog</command> converts database log files to human -readable text.</para></sect3> +<varlistentry id="db_printlog"> +<term><command>db_printlog</command></term> +<listitem><para>converts database log files to human readable text.</para> +<indexterm zone="db db_printlog"> +<primary sortas="b-db_printlog">db_printlog</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_recover</title> -<para><command>db_recover</command> is used to restore a database to a -consistent state after a failure.</para></sect3> +<varlistentry id="db_recover"> +<term><command>db_recover</command></term> +<listitem><para>is used to restore a database to a consistent state after a +failure.</para> +<indexterm zone="db db_recover"> +<primary sortas="b-db_recover">db_recover</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_stat</title> -<para><command>db_stat</command> displays database environment statistics. -</para></sect3> +<varlistentry id="db_stat"> +<term><command>db_stat</command></term> +<listitem><para>displays database environment statistics.</para> +<indexterm zone="db db_stat"> +<primary sortas="b-db_stat">db_stat</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_upgrade</title> -<para><command>db_upgrade</command> is used to upgrade database files to a -newer version of <application>Berkeley DB</application>.</para></sect3> +<varlistentry id="db_upgrade"> +<term><command>db_upgrade</command></term> +<listitem><para>is used to upgrade database files to a newer version of +<application>Berkeley DB</application>.</para> +<indexterm zone="db db_upgrade"> +<primary sortas="b-db_upgrade">db_upgrade</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>db_verify</title> -<para><command>db_verify</command> is used to run consistency checks on -database files.</para></sect3> +<varlistentry id="db_verify"> +<term><command>db_verify</command></term> +<listitem><para>is used to run consistency checks on database files.</para> +<indexterm zone="db db_verify"> +<primary sortas="b-db_verify">db_verify</primary> +</indexterm></listitem> +</varlistentry> +</variablelist> </sect2> Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2005-03-29 19:54:57 UTC (rev 3607) +++ trunk/BOOK/general.ent 2005-03-30 17:32:22 UTC (rev 3608) @@ -1,4 +1,4 @@ -<!ENTITY day "29"> +<!ENTITY day "30"> <!ENTITY month "03"> <!ENTITY year "2005"> <!ENTITY version "svn-&year;&month;&day;"> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
