source: postlfs/filesystems/xfs.xml@ 45b2f690

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 45b2f690 was 381628a, checked in by Dan Nichilson <dnicholson@…>, 18 years ago

Changed the XFS installation to be more consistent with the rest of the book

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6229 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.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 %general-entities;
6
7 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
19 <!ENTITY xfsprogs-download-http "http://mirrors.sunsite.dk/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
20 <!ENTITY xfsprogs-download-ftp "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
21 <!ENTITY xfsprogs-md5sum "d4a78fced98c0f3f32627a473e8e0a59">
22 <!ENTITY xfsprogs-size "878 KB">
23 <!ENTITY xfsprogs-buildsize "17.3 MB">
24 <!ENTITY xfsprogs-time "0.78 SBU">
25]>
26
27<sect1 id="xfs" xreflabel="XFS-&xfsprogs-version;">
28 <?dbhtml filename="xfsfs.html"?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 </sect1info>
34
35 <title>XFS-&xfsprogs-version;</title>
36
37 <indexterm zone="xfs">
38 <primary sortas="a-XFS">XFS</primary>
39 </indexterm>
40
41 <sect2 role="package">
42 <title>Introduction to XFS</title>
43
44 <para>The <application>XFS</application> package contains administration
45 and debugging tools for the XFS file system.</para>
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>Download (HTTP): <ulink url="&xfsprogs-download-http;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download (FTP): <ulink url="&xfsprogs-download-ftp;"/></para>
54 </listitem>
55 <listitem>
56 <para>Download MD5 sum: &xfsprogs-md5sum;</para>
57 </listitem>
58 <listitem>
59 <para>Download size: &xfsprogs-size;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated disk space required: &xfsprogs-buildsize;</para>
63 </listitem>
64 <listitem>
65 <para>Estimated build time: &xfsprogs-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <para condition="html" role="usernotes">User Notes:
70 <ulink url="&blfs-wiki;/xfs"/></para>
71
72 </sect2>
73
74 <sect2 role="installation">
75 <title>Installation of XFS</title>
76
77 <note>
78 <para>If you did not install the
79 <ulink url="&lfs-root;/chapter06/e2fsprogs.html">E2fsprogs</ulink>
80 package in LFS, you must install it, or
81 <ulink url="http://pecl.php.net/package/uuid">UUID</ulink> before
82 proceeding with the installation of <application>XFS</application>.</para>
83 </note>
84
85 <para>Install <application>XFS</application> by running the following
86 commands:</para>
87
88<screen><userinput>sed -i '/autoconf/d' Makefile &amp;&amp;
89make DEBUG=-DNDEBUG</userinput></screen>
90
91 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
92
93<screen role="root"><userinput>make install &amp;&amp;
94chmod -v 755 /lib/libhandle.so* &amp;&amp;
95install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &amp;&amp;
96install -v -m644 libhandle/.libs/libhandle.a /usr/lib &amp;&amp;
97ln -sv ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
98
99 </sect2>
100
101 <sect2 role="commands">
102 <title>Command Explanations</title>
103
104 <para><command>sed -i '/autoconf/d' Makefile</command>: This command
105 disables running <command>autoconf</command> because it is
106 unnecessary.</para>
107
108 <para><command>make DEBUG=-DNDEBUG</command>: The <application>XFS
109 </application> build will fail using the default -DDEBUG flags.</para>
110
111 <para><parameter>OPTIMIZER="..."</parameter>: Adding this parameter to
112 the <command>make</command> command overrides the default optimization
113 settings.</para>
114
115 <para><command>install -v ...</command>: These commands install the
116 static library and libtool archive for <filename>libhandle</filename>
117 since <command>make install</command> only installs the shared
118 library.</para>
119
120 <para><command>ln -sv ...</command>: This command installs a symlink
121 that is missed by the <command>make install</command> command.</para>
122
123 </sect2>
124
125 <sect2 role="content">
126 <title>Contents</title>
127
128 <segmentedlist>
129 <segtitle>Installed Programs</segtitle>
130 <segtitle>Installed Library</segtitle>
131 <segtitle>Installed Directory</segtitle>
132
133 <seglistitem>
134 <seg>fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap, xfs_check, xfs_copy,
135 xfs_db, xfs_freeze, xfs_growfs, xfs_info, xfs_io, xfs_logprint,
136 xfs_mkfile, xfs_ncheck, xfs_repair, and xfs_rtcp</seg>
137 <seg>libhandle.{so,a}</seg>
138 <seg>/usr/share/doc/xfsprogs</seg>
139 </seglistitem>
140 </segmentedlist>
141
142 <variablelist>
143 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
144 <?dbfo list-presentation="list"?>
145 <?dbhtml list-presentation="table"?>
146
147 <varlistentry id="fsck.xfs">
148 <term><command>fsck.xfs</command></term>
149 <listitem>
150 <para>simply exits with a zero status, since XFS
151 partitions are checked at mount time.</para>
152 <indexterm zone="xfs fsck.xfs">
153 <primary sortas="b-fsck.xfs">fsck.xfs</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry id="mkfs.xfs">
159 <term><command>mkfs.xfs</command></term>
160 <listitem>
161 <para>constructs an XFS file system.</para>
162 <indexterm zone="xfs mkfs.xfs">
163 <primary sortas="b-mkfs.xfs">mkfs.xfs</primary>
164 </indexterm>
165 </listitem>
166 </varlistentry>
167
168 <varlistentry id="xfs_admin">
169 <term><command>xfs_admin</command></term>
170 <listitem>
171 <para>changes the parameters of an XFS file system.</para>
172 <indexterm zone="xfs xfs_admin">
173 <primary sortas="b-xfs_admin">xfs_admin</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry id="xfs_bmap">
179 <term><command>xfs_bmap</command></term>
180 <listitem>
181 <para>prints block mapping for an XFS file.</para>
182 <indexterm zone="xfs xfs_bmap">
183 <primary sortas="b-xfs_bmap">xfs_bmap</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="xfs_check">
189 <term><command>xfs_check</command></term>
190 <listitem>
191 <para>checks XFS file system consistency.</para>
192 <indexterm zone="xfs xfs_check">
193 <primary sortas="b-xfs_check">xfs_check</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="xfs_copy">
199 <term><command>xfs_copy</command></term>
200 <listitem>
201 <para>copies the contents of an XFS file system
202 to one or more targets in parallel.</para>
203 <indexterm zone="xfs xfs_copy">
204 <primary sortas="b-xfs_copy">xfs_copy</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="xfs_db">
210 <term><command>xfs_db</command></term>
211 <listitem>
212 <para>is used to debug an XFS file system.</para>
213 <indexterm zone="xfs xfs_db">
214 <primary sortas="b-xfs_db">xfs_db</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="xfs_freeze">
220 <term><command>xfs_freeze</command></term>
221 <listitem>
222 <para>suspends access to an XFS file system.</para>
223 <indexterm zone="xfs xfs_freeze">
224 <primary sortas="b-xfs_freeze">xfs_freeze</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="xfs_growfs">
230 <term><command>xfs_growfs</command></term>
231 <listitem>
232 <para>expands an XFS file system.</para>
233 <indexterm zone="xfs xfs_growfs">
234 <primary sortas="b-xfs_growfs">xfs_growfs</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="xfs_info">
240 <term><command>xfs_info</command></term>
241 <listitem>
242 <para>is equivalent to invoking <command>xfs_growfs</command>, but
243 specifying that no change to the file system is to be made.</para>
244 <indexterm zone="xfs xfs_info">
245 <primary sortas="b-xfs_info">xfs_info</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="xfs_io">
251 <term><command>xfs_io</command></term>
252 <listitem>
253 <para>is a debugging tool like <command>xfs_db</command>, but is
254 aimed at examining the regular file I/O path rather than the raw
255 XFS volume itself.</para>
256 <indexterm zone="xfs xfs_io">
257 <primary sortas="b-xfs_io">xfs_io</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="xfs_logprint">
263 <term><command>xfs_logprint</command></term>
264 <listitem>
265 <para>prints the log of an XFS file system.</para>
266 <indexterm zone="xfs xfs_logprint">
267 <primary sortas="b-xfs_logprint">xfs_logprint</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="xfs_mkfile">
273 <term><command>xfs_mkfile</command></term>
274 <listitem>
275 <para>creates an XFS file, padded with zeroes by default.</para>
276 <indexterm zone="xfs xfs_mkfile">
277 <primary sortas="b-xfs_mkfile">xfs_mkfile</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="xfs_ncheck">
283 <term><command>xfs_ncheck</command></term>
284 <listitem>
285 <para>generates pathnames from inode numbers for an
286 XFS file system.</para>
287 <indexterm zone="xfs xfs_ncheck">
288 <primary sortas="b-xfs_ncheck">xfs_ncheck</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="xfs_quota">
294 <term><command>xfs_quota</command></term>
295 <listitem>
296 <para>is a utility for reporting and editing various
297 aspects of filesystem quota.</para>
298 <indexterm zone="xfs xfs_quota">
299 <primary sortas="b-xfs_quota">xfs_quota</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="xfs_repair">
305 <term><command>xfs_repair</command></term>
306 <listitem>
307 <para>repairs corrupt or damaged XFS file systems.</para>
308 <indexterm zone="xfs xfs_repair">
309 <primary sortas="b-xfs_repair">xfs_repair</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="xfs_rtcp">
315 <term><command>xfs_rtcp</command></term>
316 <listitem>
317 <para>copies a file to the real-time partition on an
318 XFS file system.</para>
319 <indexterm zone="xfs xfs_rtcp">
320 <primary sortas="b-xfs_rtcp">xfs_rtcp</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="libhandle">
326 <term><filename class='libraryfile'>libhandle.so</filename></term>
327 <listitem>
328 <para>contains functions to map filesystem handles to a
329 corresponding open file descriptor for that filesystem.</para>
330 <indexterm zone="xfs libhandle">
331 <primary sortas="c-libhandle">libhandle.so</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 </variablelist>
337
338 </sect2>
339
340</sect1>
Note: See TracBrowser for help on using the repository browser.