Changeset 54e422c1 for chapter06/db.xml


Ignore:
Timestamp:
02/03/2006 08:54:03 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
6a82dd9
Parents:
45b032f
Message:

Indenting chapter 6, part 4

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7340 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/db.xml

    r45b032f r54e422c1  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-db" role="wrap">
    7 <title>Berkeley DB-&db-version;</title>
    8 <?dbhtml filename="db.html"?>
    9 
    10 <indexterm zone="ch-system-db"><primary sortas="a-Berkeley-DB">Berkeley DB</primary></indexterm>
    11 
    12 <sect2 role="package"><title/>
    13 <para>The Berkeley DB package contains programs and utilities used by many other
    14 applications for database related functions.</para>
    15 
    16 <segmentedlist>
    17 <segtitle>&buildtime;</segtitle>
    18 <segtitle>&diskspace;</segtitle>
    19 <seglistitem><seg>1.2 SBU</seg><seg>78 MB</seg></seglistitem>
    20 </segmentedlist>
    21 
    22 <segmentedlist>
    23 <segtitle>&dependencies;</segtitle>
    24 <seglistitem><seg>Bash, Binutils, Coreutils,
    25 Diffutils, GCC, Glibc, Make and Sed.</seg></seglistitem>
    26 </segmentedlist>
    27 
    28 <tip>
    29 <title>Extra functionality for Berkeley DB in BLFS</title>
    30 <para>There are instructions to build this package in the BLFS book if you                          need to build the RPC server or additional language bindings. The                                   
    31 additional language bindings will require additional packages to be                                 
    32 installed. The BLFS instructions are located at
    33 <ulink url="&blfs-root;view/svn/server/databases.html#db"/>
    34 for suggested installation instructions.</para>
    35 </tip>
    36 
    37 </sect2>
    38 
    39 <sect2 role="installation">
    40 <title>Installation of Berkeley DB</title>
    41 
    42 <para>Prepare Berkeley DB for compilation:</para>
     9  <?dbhtml filename="db.html"?>
     10
     11  <title>Berkeley DB-&db-version;</title>
     12
     13  <indexterm zone="ch-system-db">
     14    <primary sortas="a-Berkeley-DB">Berkeley DB</primary>
     15  </indexterm>
     16
     17  <sect2 role="package">
     18    <title/>
     19
     20    <para>The Berkeley DB package contains programs and utilities used by many
     21    other applications for database related functions.</para>
     22
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
     26
     27      <seglistitem>
     28        <seg>1.2 SBU</seg>
     29        <seg>78 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
     32
     33    <segmentedlist>
     34      <segtitle>&dependencies;</segtitle>
     35
     36      <seglistitem>
     37        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Make and Sed.</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41    <tip>
     42      <title>Extra functionality for Berkeley DB in BLFS</title>
     43
     44      <para>There are instructions to build this package in the BLFS
     45      book if you need to build the RPC server or additional language
     46      bindings. The additional language bindings will require additional
     47      packages to be installed. The BLFS instructions are located at
     48      <ulink url="&blfs-root;view/svn/server/databases.html#db"/> for
     49      suggested installation instructions.</para>
     50    </tip>
     51
     52  </sect2>
     53
     54  <sect2 role="installation">
     55    <title>Installation of Berkeley DB</title>
     56
     57    <para>Prepare Berkeley DB for compilation:</para>
    4358
    4459<screen><userinput>cd build_unix &amp;&amp;
    4560../dist/configure --prefix=/usr --enable-compat185 --enable-cxx</userinput></screen>
    4661
    47 <para>The meaning of the configure options:</para>
    48 
    49 <variablelist>
    50 <varlistentry>
    51 <term><parameter>--enable-compat185</parameter></term>
    52 <listitem><para>This option enables building Berkeley DB 1.85 compatibility API.</para></listitem>
    53 </varlistentry>
    54 
    55 <varlistentry>
    56 <term><parameter>--enable-cxx</parameter></term>
    57 <listitem><para>This option enables building C++ API libraries.</para></listitem>
    58 </varlistentry>
    59 </variablelist>
    60 
    61 <para>Compile the package:</para>
     62    <variablelist>
     63      <title>The meaning of the configure options:</title>
     64
     65      <varlistentry>
     66        <term><parameter>--enable-compat185</parameter></term>
     67        <listitem>
     68          <para>This option enables building Berkeley DB 1.85 compatibility
     69          API.</para>
     70        </listitem>
     71      </varlistentry>
     72
     73      <varlistentry>
     74        <term><parameter>--enable-cxx</parameter></term>
     75        <listitem>
     76          <para>This option enables building C++ API libraries.</para>
     77        </listitem>
     78      </varlistentry>
     79
     80    </variablelist>
     81
     82    <para>Compile the package:</para>
    6283
    6384<screen><userinput>make</userinput></screen>
    6485
    65 <para>It is not possible to test the package meaningfully, because that
    66 would involve building TCL bindings. TCL bindings cannot be built properly
    67 now because TCL is linked against Glibc in <filename class="directory">/tools</filename>,
    68 not against Glibc in <filename class="directory">/usr</filename>.</para>
    69 
    70 <para>Install the package:</para>
     86    <para>It is not possible to test the package meaningfully, because
     87    that would involve building TCL bindings. TCL bindings cannot be
     88    built properly now because TCL is linked against Glibc in
     89    <filename class="directory">/tools</filename>, not against Glibc in
     90    <filename class="directory">/usr</filename>.</para>
     91
     92    <para>Install the package:</para>
    7193
    7294<screen><userinput>make docdir=/usr/share/doc/db-&db-version; install</userinput></screen>
    7395
    74 <para>The meaning of the make option:</para>
    75 
    76 <variablelist>
    77 <varlistentry>
    78 <term><parameter>docdir=...</parameter></term>
    79 <listitem><para>This variable specifies the correct place for the documentation.</para></listitem>
    80 </varlistentry>
    81 </variablelist>
    82 
    83 <para>Fix the ownerships of the installed files:</para>
     96    <variablelist>
     97      <title>The meaning of the make parameter:</title>
     98
     99      <varlistentry>
     100        <term><parameter>docdir=...</parameter></term>
     101        <listitem>
     102          <para>This variable specifies the correct place for the
     103          documentation.</para>
     104        </listitem>
     105      </varlistentry>
     106
     107    </variablelist>
     108
     109    <para>Fix the ownerships of the installed files:</para>
    84110
    85111<screen><userinput>chown root:root /usr/bin/db_* \
    … …  
    87113chown -R root:root /usr/share/doc/db-&db-version;</userinput></screen>
    88114
    89 </sect2>
    90 
    91 
    92 <sect2 id="contents-db" role="content"><title>Contents of Berkeley DB</title>
    93 <segmentedlist>
    94 <segtitle>Installed programs</segtitle>
    95 <seglistitem><seg>db_archive, db_checkpoint, db_deadlock, db_dump,
    96 db_hotbackup, db_load, db_printlog, db_recover, db_stat, db_upgrade and
    97 db_verify
    98 </seg></seglistitem>
    99 </segmentedlist>
    100 
    101 <segmentedlist>
    102 <segtitle>Installed libraries</segtitle>
    103 <seglistitem><seg>libdb.[so,a] and libdb_cxx.[so,a]</seg></seglistitem>
    104 </segmentedlist>
    105 
    106 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    107 <?dbfo list-presentation="list"?>
    108 <?dbhtml list-presentation="table"?>
    109 
    110 <varlistentry id="db_archive">
    111 <term><command>db_archive</command></term>
    112 <listitem>
    113 <para>Prints the pathnames of log files that are no longer in use</para>
    114 <indexterm zone="ch-system-db db_archive"><primary sortas="b-db_archive">db_archive</primary></indexterm>
    115 </listitem>
    116 </varlistentry>
    117 
    118 <varlistentry id="db_checkpoint">
    119 <term><command>db_checkpoint</command></term>
    120 <listitem>
    121 <para>A daemon used to monitor and checkpoint database logs</para>
    122 <indexterm zone="ch-system-db db_checkpoint"><primary sortas="b-db_checkpoint">db_checkpoint</primary></indexterm>
    123 </listitem>
    124 </varlistentry>
    125 
    126 <varlistentry id="db_deadlock">
    127 <term><command>db_deadlock</command></term>
    128 <listitem>
    129 <para>A daemon used to abort lock requests when deadlocks are detected</para>
    130 <indexterm zone="ch-system-db db_deadlock"><primary sortas="b-db_deadlock">db_deadlock</primary></indexterm>
    131 </listitem>
    132 </varlistentry>
    133 
    134 <varlistentry id="db_dump">
    135 <term><command>db_dump</command></term>
    136 <listitem>
    137 <para>Converts database files to a plain-text file format readable by <command>db_load</command></para>
    138 <indexterm zone="ch-system-db db_dump"><primary sortas="b-db_dump">db_dump</primary></indexterm>
    139 </listitem>
    140 </varlistentry>
    141 
    142 <varlistentry id="db_hotbackup">
    143 <term><command>db_hotbackup</command></term>
    144 <listitem>
    145 <para>Creates <quote>hot backup</quote> or <quote>hot failover</quote> snapshots of Berkeley DB databases</para>
    146 <indexterm zone="ch-system-db db_hotbackup"><primary sortas="b-db_hotbackup">db_hotbackup</primary></indexterm>
    147 </listitem>
    148 </varlistentry>
    149 
    150 <varlistentry id="db_load">
    151 <term><command>db_load</command></term>
    152 <listitem>
    153 <para>Is used to create database files from plain-text files</para>
    154 <indexterm zone="ch-system-db db_load"><primary sortas="b-db_load">db_load</primary></indexterm>
    155 </listitem>
    156 </varlistentry>
    157 
    158 <varlistentry id="db_printlog">
    159 <term><command>db_printlog</command></term>
    160 <listitem>
    161 <para>Converts database log files to human readable text</para>
    162 <indexterm zone="ch-system-db db_printlog"><primary sortas="b-db_printlog">db_printlog</primary></indexterm>
    163 </listitem>
    164 </varlistentry>
    165 
    166 <varlistentry id="db_recover">
    167 <term><command>db_recover</command></term>
    168 <listitem>
    169 <para>Is used to restore a database to a consistent state after a failure</para>
    170 <indexterm zone="ch-system-db db_recover"><primary sortas="b-db_recover">db_recover</primary></indexterm>
    171 </listitem>
    172 </varlistentry>
    173 
    174 <varlistentry id="db_stat">
    175 <term><command>db_stat</command></term>
    176 <listitem>
    177 <para>Displays statistics for Berkeley databases</para>
    178 <indexterm zone="ch-system-db db_stat"><primary sortas="b-db_stat">db_stat</primary></indexterm>
    179 </listitem>
    180 </varlistentry>
    181 
    182 <varlistentry id="db_upgrade">
    183 <term><command>db_upgrade</command></term>
    184 <listitem>
    185 <para>Is used to upgrade database files to a newer version of Berkeley DB</para>
    186 <indexterm zone="ch-system-db db_upgrade"><primary sortas="b-db_upgrade">db_upgrade</primary></indexterm>
    187 </listitem>
    188 </varlistentry>
    189 
    190 <varlistentry id="db_verify">
    191 <term><command>db_verify</command></term>
    192 <listitem>
    193 <para>Is used to run consistency checks on database files</para>
    194 <indexterm zone="ch-system-db db_verify"><primary sortas="b-db_verify">db_verify</primary></indexterm>
    195 </listitem>
    196 </varlistentry>
    197 
    198 
    199 <varlistentry id="libdb">
    200 <term><filename class="libraryfile">libdb.[so,a]</filename></term>
    201 <listitem>
    202 <para>Contains functions to manipulate database files from C programs</para>
    203 <indexterm zone="ch-system-db libdb"><primary sortas="c-libdb">libdb</primary></indexterm>
    204 </listitem>
    205 </varlistentry>
    206 
    207 <varlistentry id="libdb_cxx">
    208 <term><filename class="libraryfile">libdb_cxx.[so,a]</filename></term>
    209 <listitem>
    210 <para>Contains functions to manipulate database files from C++ programs</para>
    211 <indexterm zone="ch-system-db libdb_cxx"><primary sortas="c-libdb_cxx">libdb_cxx</primary></indexterm>
    212 </listitem>
    213 </varlistentry>
    214 </variablelist>
    215 
    216 </sect2>
     115  </sect2>
     116
     117  <sect2 id="contents-db" role="content">
     118    <title>Contents of Berkeley DB</title>
     119
     120    <segmentedlist>
     121      <segtitle>Installed programs</segtitle>
     122      <segtitle>Installed libraries</segtitle>
     123
     124      <seglistitem>
     125        <seg>db_archive, db_checkpoint, db_deadlock, db_dump, db_hotbackup,
     126        db_load, db_printlog, db_recover, db_stat, db_upgrade, and db_verify</seg>
     127        <seg>libdb.[so,a] and libdb_cxx.[so,a]</seg>
     128      </seglistitem>
     129    </segmentedlist>
     130
     131    <variablelist>
     132      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     133      <?dbfo list-presentation="list"?>
     134      <?dbhtml list-presentation="table"?>
     135
     136      <varlistentry id="db_archive">
     137        <term><command>db_archive</command></term>
     138        <listitem>
     139          <para>Prints the pathnames of log files that are no longer in use</para>
     140          <indexterm zone="ch-system-db db_archive">
     141            <primary sortas="b-db_archive">db_archive</primary>
     142          </indexterm>
     143        </listitem>
     144      </varlistentry>
     145
     146      <varlistentry id="db_checkpoint">
     147        <term><command>db_checkpoint</command></term>
     148        <listitem>
     149          <para>A daemon used to monitor and checkpoint database logs</para>
     150          <indexterm zone="ch-system-db db_checkpoint">
     151            <primary sortas="b-db_checkpoint">db_checkpoint</primary>
     152          </indexterm>
     153        </listitem>
     154      </varlistentry>
     155
     156      <varlistentry id="db_deadlock">
     157        <term><command>db_deadlock</command></term>
     158        <listitem>
     159          <para>A daemon used to abort lock requests when deadlocks are
     160          detected</para>
     161          <indexterm zone="ch-system-db db_deadlock">
     162            <primary sortas="b-db_deadlock">db_deadlock</primary>
     163          </indexterm>
     164        </listitem>
     165      </varlistentry>
     166
     167      <varlistentry id="db_dump">
     168        <term><command>db_dump</command></term>
     169        <listitem>
     170          <para>Converts database files to a plain-text file format readable
     171          by <command>db_load</command></para>
     172          <indexterm zone="ch-system-db db_dump">
     173            <primary sortas="b-db_dump">db_dump</primary>
     174          </indexterm>
     175        </listitem>
     176      </varlistentry>
     177
     178      <varlistentry id="db_hotbackup">
     179        <term><command>db_hotbackup</command></term>
     180        <listitem>
     181          <para>Creates <quote>hot backup</quote> or <quote>hot failover</quote>
     182          snapshots of Berkeley DB databases</para>
     183          <indexterm zone="ch-system-db db_hotbackup">
     184            <primary sortas="b-db_hotbackup">db_hotbackup</primary>
     185          </indexterm>
     186        </listitem>
     187      </varlistentry>
     188
     189      <varlistentry id="db_load">
     190        <term><command>db_load</command></term>
     191        <listitem>
     192          <para>Is used to create database files from plain-text files</para>
     193          <indexterm zone="ch-system-db db_load">
     194            <primary sortas="b-db_load">db_load</primary>
     195          </indexterm>
     196        </listitem>
     197      </varlistentry>
     198
     199      <varlistentry id="db_printlog">
     200        <term><command>db_printlog</command></term>
     201        <listitem>
     202          <para>Converts database log files to human readable text</para>
     203          <indexterm zone="ch-system-db db_printlog">
     204            <primary sortas="b-db_printlog">db_printlog</primary>
     205          </indexterm>
     206        </listitem>
     207      </varlistentry>
     208
     209      <varlistentry id="db_recover">
     210        <term><command>db_recover</command></term>
     211        <listitem>
     212          <para>Is used to restore a database to a consistent state after a
     213          failure</para>
     214          <indexterm zone="ch-system-db db_recover">
     215            <primary sortas="b-db_recover">db_recover</primary>
     216          </indexterm>
     217        </listitem>
     218      </varlistentry>
     219
     220      <varlistentry id="db_stat">
     221        <term><command>db_stat</command></term>
     222        <listitem>
     223          <para>Displays statistics for Berkeley databases</para>
     224          <indexterm zone="ch-system-db db_stat">
     225            <primary sortas="b-db_stat">db_stat</primary>
     226          </indexterm>
     227        </listitem>
     228      </varlistentry>
     229
     230      <varlistentry id="db_upgrade">
     231        <term><command>db_upgrade</command></term>
     232        <listitem>
     233          <para>Is used to upgrade database files to a newer version of
     234          Berkeley DB</para>
     235          <indexterm zone="ch-system-db db_upgrade">
     236            <primary sortas="b-db_upgrade">db_upgrade</primary>
     237          </indexterm>
     238        </listitem>
     239      </varlistentry>
     240
     241      <varlistentry id="db_verify">
     242        <term><command>db_verify</command></term>
     243        <listitem>
     244          <para>Is used to run consistency checks on database files</para>
     245          <indexterm zone="ch-system-db db_verify">
     246            <primary sortas="b-db_verify">db_verify</primary>
     247          </indexterm>
     248        </listitem>
     249      </varlistentry>
     250
     251
     252      <varlistentry id="libdb">
     253        <term><filename class="libraryfile">libdb.[so,a]</filename></term>
     254        <listitem>
     255          <para>Contains functions to manipulate database files from C
     256          programs</para>
     257          <indexterm zone="ch-system-db libdb">
     258            <primary sortas="c-libdb">libdb</primary>
     259          </indexterm>
     260        </listitem>
     261      </varlistentry>
     262
     263      <varlistentry id="libdb_cxx">
     264        <term><filename class="libraryfile">libdb_cxx.[so,a]</filename></term>
     265        <listitem>
     266          <para>Contains functions to manipulate database files from C++
     267          programs</para>
     268          <indexterm zone="ch-system-db libdb_cxx">
     269            <primary sortas="c-libdb_cxx">libdb_cxx</primary>
     270          </indexterm>
     271        </listitem>
     272      </varlistentry>
     273
     274    </variablelist>
     275
     276  </sect2>
    217277
    218278</sect1>
Note: See TracChangeset for help on using the changeset viewer.