mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-01-18 21:17:38 +00:00
f2ab0c5d05
Cherry picked from the multilib branch
151 lines
4.6 KiB
XML
151 lines
4.6 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
%general-entities;
|
|
]>
|
|
|
|
<sect1 id="ch-system-findutils" role="wrap">
|
|
<?dbhtml filename="findutils.html"?>
|
|
|
|
<sect1info condition="script">
|
|
<productname>findutils</productname>
|
|
<productnumber>&findutils-version;</productnumber>
|
|
<address>&findutils-url;</address>
|
|
</sect1info>
|
|
|
|
<title>Findutils-&findutils-version;</title>
|
|
|
|
<indexterm zone="ch-system-findutils">
|
|
<primary sortas="a-Findutils">Findutils</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title/>
|
|
|
|
<para>The Findutils package contains programs to find files. These programs
|
|
are provided to recursively search through a directory tree and to
|
|
create, maintain, and search a database (often faster than the recursive
|
|
find, but is unreliable if the database has not been recently updated).</para>
|
|
|
|
<segmentedlist>
|
|
<segtitle>&buildtime;</segtitle>
|
|
<segtitle>&diskspace;</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>&findutils-fin-sbu;</seg>
|
|
<seg>&findutils-fin-du;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Findutils</title>
|
|
|
|
<para>Prepare Findutils for compilation:</para>
|
|
|
|
<screen><userinput remap="configure">case $(uname -m) in
|
|
i?86) TIME_T_32_BIT_OK=yes ./configure --prefix=/usr --localstatedir=/var/lib/locate ;;
|
|
x86_64) ./configure --prefix=/usr --localstatedir=/var/lib/locate ;;
|
|
esac</userinput></screen>
|
|
|
|
<variablelist>
|
|
<title>The meaning of the configure options:</title>
|
|
|
|
<varlistentry>
|
|
<term><parameter>--localstatedir</parameter></term>
|
|
<listitem>
|
|
<para>This option changes the location of the <command>locate</command>
|
|
database to be in <filename class="directory">/var/lib/locate</filename>,
|
|
which is FHS-compliant.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Compile the package:</para>
|
|
|
|
<screen><userinput remap="make">make</userinput></screen>
|
|
|
|
<para>To test the results, issue:</para>
|
|
|
|
<screen><userinput remap="test">chown -Rv tester .
|
|
su tester -c "PATH=$PATH make check"</userinput></screen>
|
|
|
|
<para>Install the package:</para>
|
|
|
|
<screen><userinput remap="install">make install</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="contents-findutils" role="content">
|
|
<title>Contents of Findutils</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed programs</segtitle>
|
|
<segtitle>Installed directory</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>find, locate, updatedb, and xargs</seg>
|
|
<seg>/var/lib/locate</seg>
|
|
</seglistitem>
|
|
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="find">
|
|
<term><command>find</command></term>
|
|
<listitem>
|
|
<para>Searches given directory trees for files matching the specified
|
|
criteria</para>
|
|
<indexterm zone="ch-system-findutils find">
|
|
<primary sortas="b-find">find</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="locate">
|
|
<term><command>locate</command></term>
|
|
<listitem>
|
|
<para>Searches through a database of file names and reports the names
|
|
that contain a given string or match a given pattern</para>
|
|
<indexterm zone="ch-system-findutils locate">
|
|
<primary sortas="b-locate">locate</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="updatedb">
|
|
<term><command>updatedb</command></term>
|
|
<listitem>
|
|
<para>Updates the <command>locate</command> database; it scans the
|
|
entire file system (including other file systems that are currently
|
|
mounted, unless told not to) and puts every file name it finds into
|
|
the database</para>
|
|
<indexterm zone="ch-system-findutils updatedb">
|
|
<primary sortas="b-updatedb">updatedb</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="xargs">
|
|
<term><command>xargs</command></term>
|
|
<listitem>
|
|
<para>Can be used to apply a given command to a list of files</para>
|
|
<indexterm zone="ch-system-findutils xargs">
|
|
<primary sortas="b-xargs">xargs</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|