source: final-system/common/findutils.xml @ bf8c11f

Last change on this file since bf8c11f was bf8c11f, checked in by Jim Gifford <clfs@…>, 18 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 5.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6  %general-entities;
7  %patches-entities;
8]>
9
10<sect1 id="ch-system-findutils" role="wrap">
11  <?dbhtml filename="findutils.html"?>
12
13  <title>Findutils-&findutils-version;</title>
14
15  <indexterm zone="ch-system-findutils">
16    <primary sortas="a-Findutils">Findutils</primary>
17  </indexterm>
18
19  <sect2 role="package">
20    <title/>
21
22    <para>The Findutils package contains programs to find files. These programs
23    are provided to recursively search through a directory tree and to
24    create, maintain, and search a database (often faster than the recursive
25    find, but unreliable if the database has not been recently updated).</para>
26
27    <segmentedlist>
28      <segtitle>&buildtime;</segtitle>
29      <segtitle>&diskspace;</segtitle>
30
31      <seglistitem>
32        <seg>Not checked yet</seg>
33        <seg>Not checked yet</seg>
34      </seglistitem>
35    </segmentedlist>
36
37    <segmentedlist>
38      <segtitle>&dependencies;</segtitle>
39
40      <seglistitem>
41        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
42        Grep, Make and Sed</seg>
43      </seglistitem>
44    </segmentedlist>
45
46  </sect2>
47
48  <sect2 role="installation">
49    <title>Installation of Findutils</title>
50
51    <para os="a">Prepare Findutils for compilation:</para>
52
53<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/locate \
54    --localstatedir=/var/lib/locate</userinput></screen>
55
56    <variablelist os="b">
57      <title>The meaning of the configure options:</title>
58
59      <varlistentry>
60        <term><parameter>--localstatedir</parameter></term>
61        <listitem>
62          <para>This option changes the location of the <command>locate</command>
63          database to be in <filename class="directory">/var/lib/locate</filename>,
64          which is FHS-compliant.</para>
65        </listitem>
66      </varlistentry>
67
68    </variablelist>
69
70    <para os="c">Compile the package:</para>
71
72<screen os="d"><userinput>make</userinput></screen>
73
74    <para os="e">To test the results, issue:
75    <userinput>make check</userinput>.</para>
76
77    <para os="f">Install the package:</para>
78
79<screen os="g"><userinput>make install</userinput></screen>
80
81  </sect2>
82
83  <sect2 id="contents-findutils" role="content">
84    <title>Contents of Findutils</title>
85
86    <segmentedlist>
87      <segtitle>Installed programs</segtitle>
88
89      <seglistitem>
90        <seg>bigram, code, find, frcode, locate, updatedb, and xargs</seg>
91      </seglistitem>
92    </segmentedlist>
93
94    <variablelist>
95      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
96      <?dbfo list-presentation="list"?>
97      <?dbhtml list-presentation="table"?>
98
99      <varlistentry id="bigram">
100        <term><command>bigram</command></term>
101        <listitem>
102          <para>Was formerly used to produce <command>locate</command>
103          databases</para>
104          <indexterm zone="ch-system-findutils bigram">
105            <primary sortas="b-bigram">bigram</primary>
106          </indexterm>
107        </listitem>
108      </varlistentry>
109
110      <varlistentry id="code">
111        <term><command>code</command></term>
112        <listitem>
113          <para>Was formerly used to produce <command>locate</command>
114          databases; it is the ancestor of <command>frcode</command>.</para>
115          <indexterm zone="ch-system-findutils code">
116            <primary sortas="b-code">code</primary>
117          </indexterm>
118        </listitem>
119      </varlistentry>
120
121      <varlistentry id="find">
122        <term><command>find</command></term>
123        <listitem>
124          <para>Searches given directory trees for files matching the specified
125          criteria</para>
126          <indexterm zone="ch-system-findutils find">
127            <primary sortas="b-find">find</primary>
128          </indexterm>
129        </listitem>
130      </varlistentry>
131
132      <varlistentry id="frcode">
133        <term><command>frcode</command></term>
134        <listitem>
135          <para>Is called by <command>updatedb</command> to compress the list
136          of file names; it uses front-compression, reducing the database size
137          by a factor of four to five.</para>
138          <indexterm zone="ch-system-findutils frcode">
139            <primary sortas="b-frcode">frcode</primary>
140          </indexterm>
141        </listitem>
142      </varlistentry>
143
144      <varlistentry id="locate">
145        <term><command>locate</command></term>
146        <listitem>
147          <para>Searches through a database of file names and reports the names
148          that contain a given string or match a given pattern</para>
149          <indexterm zone="ch-system-findutils locate">
150            <primary sortas="b-locate">locate</primary>
151          </indexterm>
152        </listitem>
153      </varlistentry>
154
155      <varlistentry id="updatedb">
156        <term><command>updatedb</command></term>
157        <listitem>
158          <para>Updates the <command>locate</command> database; it scans the
159          entire file system (including other file systems that are currently
160          mounted, unless told not to) and puts every file name it finds into
161          the database</para>
162          <indexterm zone="ch-system-findutils updatedb">
163            <primary sortas="b-updatedb">updatedb</primary>
164          </indexterm>
165        </listitem>
166      </varlistentry>
167
168      <varlistentry id="xargs">
169        <term><command>xargs</command></term>
170        <listitem>
171          <para>Can be used to apply a given command to a list of files</para>
172          <indexterm zone="ch-system-findutils xargs">
173            <primary sortas="b-xargs">xargs</primary>
174          </indexterm>
175        </listitem>
176      </varlistentry>
177
178    </variablelist>
179
180  </sect2>
181
182</sect1>
Note: See TracBrowser for help on using the repository browser.