source: BOOK/final-system/common/findutils.xml@ a8a8b9e

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since a8a8b9e was 427015f, checked in by Chris Staub <chris@…>, 16 years ago

Update lists of installed programs

  • Property mode set to 100644
File size: 6.2 KB
Line 
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 <title>Findutils-&findutils-version;</title>
12
13 <indexterm zone="ch-system-findutils">
14 <primary sortas="a-Findutils">Findutils</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Findutils package contains programs to find files. These programs
21 are provided to recursively search through a directory tree and to
22 create, maintain, and search a database (often faster than the recursive
23 find, but unreliable if the database has not been recently updated).</para>
24
25 </sect2>
26
27 <sect2 role="installation">
28 <title>Installation of Findutils</title>
29
30 <para os="a">Prepare Findutils for compilation:</para>
31
32<screen os="b"><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/locate \
33 --localstatedir=/var/lib/locate</userinput></screen>
34
35 <variablelist os="c">
36 <title>The meaning of the configure options:</title>
37
38 <varlistentry>
39 <term><parameter>--localstatedir</parameter></term>
40 <listitem>
41 <para>This option changes the location of the <command>locate</command>
42 database to be in <filename class="directory">/var/lib/locate</filename>,
43 which is FHS-compliant.</para>
44 </listitem>
45 </varlistentry>
46
47 </variablelist>
48
49 <para os="d">Compile the package:</para>
50
51<screen os="e"><userinput>make</userinput></screen>
52
53 <para os="f">To test the results, issue:
54 <userinput>make check</userinput>.</para>
55
56 <para os="g">Install the package:</para>
57
58<screen os="h"><userinput>make install</userinput></screen>
59
60 <para os="i">The <command>find</command> program is used by some of the scripts
61 in the CLFS-Bootscripts package. As <filename
62 class="directory">/usr</filename> may not be available during the early
63 stages of booting, the <command>find</command> binary needs to be on
64 the root partition:</para>
65
66<screen os="j"><userinput>mv -v /usr/bin/find /bin</userinput></screen>
67
68 <para os="k">The <command>updatedb</command> script needs to be modified
69 to point to the new location for <command>find</command>:</para>
70
71<screen os="l"><userinput>sed -i 's@find:=${BINDIR}@find:=/bin@' /usr/bin/updatedb</userinput></screen>
72
73 </sect2>
74
75 <sect2 id="contents-findutils" role="content">
76 <title>Contents of Findutils</title>
77
78 <segmentedlist>
79 <segtitle>Installed programs</segtitle>
80
81 <seglistitem>
82 <seg>bigram, code, find, frcode, locate, oldfind, updatedb, and xargs</seg>
83 </seglistitem>
84 </segmentedlist>
85
86 <variablelist>
87 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
88 <?dbfo list-presentation="list"?>
89 <?dbhtml list-presentation="table"?>
90
91 <varlistentry id="bigram">
92 <term><command>bigram</command></term>
93 <listitem>
94 <para>Was formerly used to produce <command>locate</command>
95 databases</para>
96 <indexterm zone="ch-system-findutils bigram">
97 <primary sortas="b-bigram">bigram</primary>
98 </indexterm>
99 </listitem>
100 </varlistentry>
101
102 <varlistentry id="code">
103 <term><command>code</command></term>
104 <listitem>
105 <para>Was formerly used to produce <command>locate</command>
106 databases; it is the ancestor of <command>frcode</command>.</para>
107 <indexterm zone="ch-system-findutils code">
108 <primary sortas="b-code">code</primary>
109 </indexterm>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry id="find">
114 <term><command>find</command></term>
115 <listitem>
116 <para>Searches given directory trees for files matching the specified
117 criteria</para>
118 <indexterm zone="ch-system-findutils find">
119 <primary sortas="b-find">find</primary>
120 </indexterm>
121 </listitem>
122 </varlistentry>
123
124 <varlistentry id="frcode">
125 <term><command>frcode</command></term>
126 <listitem>
127 <para>Is called by <command>updatedb</command> to compress the list
128 of file names; it uses front-compression, reducing the database size
129 by a factor of four to five.</para>
130 <indexterm zone="ch-system-findutils frcode">
131 <primary sortas="b-frcode">frcode</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="locate">
137 <term><command>locate</command></term>
138 <listitem>
139 <para>Searches through a database of file names and reports the names
140 that contain a given string or match a given pattern</para>
141 <indexterm zone="ch-system-findutils locate">
142 <primary sortas="b-locate">locate</primary>
143 </indexterm>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry id="oldfind">
148 <term><command>oldfind</command></term>
149 <listitem>
150 <para>Needs description</para>
151 <indexterm zone="ch-system-findutils oldfind">
152 <primary sortas="b-oldfind">oldfind</primary>
153 </indexterm>
154 </listitem>
155 </varlistentry>
156
157 <varlistentry id="updatedb">
158 <term><command>updatedb</command></term>
159 <listitem>
160 <para>Updates the <command>locate</command> database; it scans the
161 entire file system (including other file systems that are currently
162 mounted, unless told not to) and puts every file name it finds into
163 the database</para>
164 <indexterm zone="ch-system-findutils updatedb">
165 <primary sortas="b-updatedb">updatedb</primary>
166 </indexterm>
167 </listitem>
168 </varlistentry>
169
170 <varlistentry id="xargs">
171 <term><command>xargs</command></term>
172 <listitem>
173 <para>Can be used to apply a given command to a list of files</para>
174 <indexterm zone="ch-system-findutils xargs">
175 <primary sortas="b-xargs">xargs</primary>
176 </indexterm>
177 </listitem>
178 </varlistentry>
179
180 </variablelist>
181
182 </sect2>
183
184</sect1>
Note: See TracBrowser for help on using the repository browser.