source: postlfs/filesystems/xfs.xml@ 61e8418

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 61e8418 was 7004ebe, checked in by Dan Nichilson <dnicholson@…>, 18 years ago

Removed XFS note to install UUID as it is installed in LFS

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6344 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.4 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 <para>Install <application>XFS</application> by running the following
78 commands:</para>
79
80<screen><userinput>sed -i '/autoconf/d' Makefile &amp;&amp;
81make DEBUG=-DNDEBUG</userinput></screen>
82
83 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
84
85<screen role="root"><userinput>make install &amp;&amp;
86chmod -v 755 /lib/libhandle.so* &amp;&amp;
87install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &amp;&amp;
88install -v -m644 libhandle/.libs/libhandle.a /usr/lib &amp;&amp;
89ln -sv ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
90
91 </sect2>
92
93 <sect2 role="commands">
94 <title>Command Explanations</title>
95
96 <para><command>sed -i '/autoconf/d' Makefile</command>: This command
97 disables running <command>autoconf</command> because it is
98 unnecessary.</para>
99
100 <para><command>make DEBUG=-DNDEBUG</command>: The <application>XFS
101 </application> build will fail using the default -DDEBUG flags.</para>
102
103 <para><parameter>OPTIMIZER="..."</parameter>: Adding this parameter to
104 the <command>make</command> command overrides the default optimization
105 settings.</para>
106
107 <para><command>install -v ...</command>: These commands install the
108 static library and libtool archive for <filename>libhandle</filename>
109 since <command>make install</command> only installs the shared
110 library.</para>
111
112 <para><command>ln -sv ...</command>: This command installs a symlink
113 that is missed by the <command>make install</command> command.</para>
114
115 </sect2>
116
117 <sect2 role="content">
118 <title>Contents</title>
119
120 <segmentedlist>
121 <segtitle>Installed Programs</segtitle>
122 <segtitle>Installed Library</segtitle>
123 <segtitle>Installed Directory</segtitle>
124
125 <seglistitem>
126 <seg>fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap, xfs_check, xfs_copy,
127 xfs_db, xfs_freeze, xfs_growfs, xfs_info, xfs_io, xfs_logprint,
128 xfs_mkfile, xfs_ncheck, xfs_repair, and xfs_rtcp</seg>
129 <seg>libhandle.{so,a}</seg>
130 <seg>/usr/share/doc/xfsprogs</seg>
131 </seglistitem>
132 </segmentedlist>
133
134 <variablelist>
135 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
136 <?dbfo list-presentation="list"?>
137 <?dbhtml list-presentation="table"?>
138
139 <varlistentry id="fsck.xfs">
140 <term><command>fsck.xfs</command></term>
141 <listitem>
142 <para>simply exits with a zero status, since XFS
143 partitions are checked at mount time.</para>
144 <indexterm zone="xfs fsck.xfs">
145 <primary sortas="b-fsck.xfs">fsck.xfs</primary>
146 </indexterm>
147 </listitem>
148 </varlistentry>
149
150 <varlistentry id="mkfs.xfs">
151 <term><command>mkfs.xfs</command></term>
152 <listitem>
153 <para>constructs an XFS file system.</para>
154 <indexterm zone="xfs mkfs.xfs">
155 <primary sortas="b-mkfs.xfs">mkfs.xfs</primary>
156 </indexterm>
157 </listitem>
158 </varlistentry>
159
160 <varlistentry id="xfs_admin">
161 <term><command>xfs_admin</command></term>
162 <listitem>
163 <para>changes the parameters of an XFS file system.</para>
164 <indexterm zone="xfs xfs_admin">
165 <primary sortas="b-xfs_admin">xfs_admin</primary>
166 </indexterm>
167 </listitem>
168 </varlistentry>
169
170 <varlistentry id="xfs_bmap">
171 <term><command>xfs_bmap</command></term>
172 <listitem>
173 <para>prints block mapping for an XFS file.</para>
174 <indexterm zone="xfs xfs_bmap">
175 <primary sortas="b-xfs_bmap">xfs_bmap</primary>
176 </indexterm>
177 </listitem>
178 </varlistentry>
179
180 <varlistentry id="xfs_check">
181 <term><command>xfs_check</command></term>
182 <listitem>
183 <para>checks XFS file system consistency.</para>
184 <indexterm zone="xfs xfs_check">
185 <primary sortas="b-xfs_check">xfs_check</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="xfs_copy">
191 <term><command>xfs_copy</command></term>
192 <listitem>
193 <para>copies the contents of an XFS file system
194 to one or more targets in parallel.</para>
195 <indexterm zone="xfs xfs_copy">
196 <primary sortas="b-xfs_copy">xfs_copy</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="xfs_db">
202 <term><command>xfs_db</command></term>
203 <listitem>
204 <para>is used to debug an XFS file system.</para>
205 <indexterm zone="xfs xfs_db">
206 <primary sortas="b-xfs_db">xfs_db</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="xfs_freeze">
212 <term><command>xfs_freeze</command></term>
213 <listitem>
214 <para>suspends access to an XFS file system.</para>
215 <indexterm zone="xfs xfs_freeze">
216 <primary sortas="b-xfs_freeze">xfs_freeze</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="xfs_growfs">
222 <term><command>xfs_growfs</command></term>
223 <listitem>
224 <para>expands an XFS file system.</para>
225 <indexterm zone="xfs xfs_growfs">
226 <primary sortas="b-xfs_growfs">xfs_growfs</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="xfs_info">
232 <term><command>xfs_info</command></term>
233 <listitem>
234 <para>is equivalent to invoking <command>xfs_growfs</command>, but
235 specifying that no change to the file system is to be made.</para>
236 <indexterm zone="xfs xfs_info">
237 <primary sortas="b-xfs_info">xfs_info</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="xfs_io">
243 <term><command>xfs_io</command></term>
244 <listitem>
245 <para>is a debugging tool like <command>xfs_db</command>, but is
246 aimed at examining the regular file I/O path rather than the raw
247 XFS volume itself.</para>
248 <indexterm zone="xfs xfs_io">
249 <primary sortas="b-xfs_io">xfs_io</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="xfs_logprint">
255 <term><command>xfs_logprint</command></term>
256 <listitem>
257 <para>prints the log of an XFS file system.</para>
258 <indexterm zone="xfs xfs_logprint">
259 <primary sortas="b-xfs_logprint">xfs_logprint</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="xfs_mkfile">
265 <term><command>xfs_mkfile</command></term>
266 <listitem>
267 <para>creates an XFS file, padded with zeroes by default.</para>
268 <indexterm zone="xfs xfs_mkfile">
269 <primary sortas="b-xfs_mkfile">xfs_mkfile</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="xfs_ncheck">
275 <term><command>xfs_ncheck</command></term>
276 <listitem>
277 <para>generates pathnames from inode numbers for an
278 XFS file system.</para>
279 <indexterm zone="xfs xfs_ncheck">
280 <primary sortas="b-xfs_ncheck">xfs_ncheck</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="xfs_quota">
286 <term><command>xfs_quota</command></term>
287 <listitem>
288 <para>is a utility for reporting and editing various
289 aspects of filesystem quota.</para>
290 <indexterm zone="xfs xfs_quota">
291 <primary sortas="b-xfs_quota">xfs_quota</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="xfs_repair">
297 <term><command>xfs_repair</command></term>
298 <listitem>
299 <para>repairs corrupt or damaged XFS file systems.</para>
300 <indexterm zone="xfs xfs_repair">
301 <primary sortas="b-xfs_repair">xfs_repair</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="xfs_rtcp">
307 <term><command>xfs_rtcp</command></term>
308 <listitem>
309 <para>copies a file to the real-time partition on an
310 XFS file system.</para>
311 <indexterm zone="xfs xfs_rtcp">
312 <primary sortas="b-xfs_rtcp">xfs_rtcp</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="libhandle">
318 <term><filename class='libraryfile'>libhandle.so</filename></term>
319 <listitem>
320 <para>contains functions to map filesystem handles to a
321 corresponding open file descriptor for that filesystem.</para>
322 <indexterm zone="xfs libhandle">
323 <primary sortas="c-libhandle">libhandle.so</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 </variablelist>
329
330 </sect2>
331
332</sect1>
Note: See TracBrowser for help on using the repository browser.