BOOK/chapter06/findutils.xml

   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-findutils" role="wrap">
   9   <?dbhtml filename="findutils.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>findutils</productname>
  13     <productnumber>&findutils-version;</productnumber>
  14     <address>&findutils-url;</address>
  15   </sect1info>
  16
  17   <title>Findutils-&findutils-version;</title>
  18
  19   <indexterm zone="ch-system-findutils">
  20     <primary sortas="a-Findutils">Findutils</primary>
  21   </indexterm>
  22
  23   <sect2 role="package">
  24     <title/>
  25
  26     <para>The Findutils package contains programs to find files. These programs
  27     are provided to recursively search through a directory tree and to
  28     create, maintain, and search a database (often faster than the recursive
  29     find, but unreliable if the database has not been recently updated).</para>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&findutils-ch6-sbu;</seg>
  37         <seg>&findutils-ch6-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Findutils</title>
  45
  46     <para>Prepare Findutils for compilation:</para>
  47
  48 <screen><userinput remap="configure">./configure --prefix=/usr --localstatedir=/var/lib/locate</userinput></screen>
  49
  50     <variablelist>
  51       <title>The meaning of the configure options:</title>
  52
  53       <varlistentry>
  54         <term><parameter>--localstatedir</parameter></term>
  55         <listitem>
  56           <para>This option changes the location of the <command>locate</command>
  57           database to be in <filename class="directory">/var/lib/locate</filename>,
  58           which is FHS-compliant.</para>
  59         </listitem>
  60       </varlistentry>
  61
  62     </variablelist>
  63
  64     <para>Compile the package:</para>
  65
  66 <screen><userinput remap="make">make</userinput></screen>
  67
  68     <para>To test the results, issue:</para>
  69
  70 <screen><userinput remap="test">make check</userinput></screen>
  71
  72     <para>Install the package:</para>
  73
  74 <screen><userinput remap="install">make install</userinput></screen>
  75
  76     <para>Two tests are known to fail in the chroot environment:
  77     sv-bug-54171.old-O3 and sv-bug-54171.new-O3.</para>
  78
  79     <para revision="sysv">Some of the scripts in the LFS-Bootscripts package
  80     depend on <command>find</command>.  As <filename
  81     class="directory">/usr</filename> may not be available during the early
  82     stages of booting, this program needs to be on the root partition.  The
  83     <command>updatedb</command> script also needs to be modified to correct an
  84     explicit path:</para>
  85
  86     <para revision="systemd"> Some packages in BLFS and beyond expect the
  87     <command>find</command> program in <filename
  88     class="directory">/bin</filename>, so make sure it's placed there:</para>
  89
  90 <screen><userinput remap="install">mv -v /usr/bin/find /bin
  91 sed -i 's|find:=${BINDIR}|find:=/bin|' /usr/bin/updatedb</userinput></screen>
  92
  93   </sect2>
  94
  95   <sect2 id="contents-findutils" role="content">
  96     <title>Contents of Findutils</title>
  97
  98     <segmentedlist>
  99       <segtitle>Installed programs</segtitle>
 100       <segtitle>Installed directory</segtitle>
 101
 102       <seglistitem>
 103         <seg>find, locate, updatedb, and xargs</seg>
 104         <seg>/var/lib/locate</seg>
 105       </seglistitem>
 106
 107     </segmentedlist>
 108
 109     <variablelist>
 110       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 111       <?dbfo list-presentation="list"?>
 112       <?dbhtml list-presentation="table"?>
 113
 114       <varlistentry id="find">
 115         <term><command>find</command></term>
 116         <listitem>
 117           <para>Searches given directory trees for files matching the specified
 118           criteria</para>
 119           <indexterm zone="ch-system-findutils find">
 120             <primary sortas="b-find">find</primary>
 121           </indexterm>
 122         </listitem>
 123       </varlistentry>
 124
 125       <varlistentry id="locate">
 126         <term><command>locate</command></term>
 127         <listitem>
 128           <para>Searches through a database of file names and reports the names
 129           that contain a given string or match a given pattern</para>
 130           <indexterm zone="ch-system-findutils locate">
 131             <primary sortas="b-locate">locate</primary>
 132           </indexterm>
 133         </listitem>
 134       </varlistentry>
 135
 136       <varlistentry id="updatedb">
 137       <term><command>updatedb</command></term>
 138         <listitem>
 139           <para>Updates the <command>locate</command> database; it scans the
 140           entire file system (including other file systems that are currently
 141           mounted, unless told not to) and puts every file name it finds into
 142           the database</para>
 143           <indexterm zone="ch-system-findutils updatedb">
 144             <primary sortas="b-updatedb">updatedb</primary>
 145           </indexterm>
 146         </listitem>
 147       </varlistentry>
 148
 149       <varlistentry id="xargs">
 150         <term><command>xargs</command></term>
 151         <listitem>
 152           <para>Can be used to apply a given command to a list of files</para>
 153           <indexterm zone="ch-system-findutils xargs">
 154             <primary sortas="b-xargs">xargs</primary>
 155           </indexterm>
 156         </listitem>
 157       </varlistentry>
 158
 159     </variablelist>
 160
 161   </sect2>
 162
 163 </sect1>