Ignore:
Timestamp:
03/25/2020 09:46:27 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
f716ef4
Parents:
9bd10279
Message:

format filesystems chapter

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22895 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • postlfs/filesystems/xfsprogs.xml

    r9bd10279 r29244b7  
    3030    <title>Introduction to xfsprogs</title>
    3131
    32     <para>The <application>xfsprogs</application> package contains
    33     administration and debugging tools for the XFS file system.</para>
     32    <para>
     33      The <application>xfsprogs</application> package contains
     34      administration and debugging tools for the XFS file system.
     35    </para>
    3436
    3537    &lfs91_checked;
    … …  
    3840    <itemizedlist spacing="compact">
    3941      <listitem>
    40         <para>Download (HTTP): <ulink url="&xfsprogs-download-http;"/></para>
    41       </listitem>
    42       <listitem>
    43         <para>Download (FTP): <ulink url="&xfsprogs-download-ftp;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download MD5 sum: &xfsprogs-md5sum;</para>
    47       </listitem>
    48       <listitem>
    49         <para>Download size: &xfsprogs-size;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Estimated disk space required: &xfsprogs-buildsize;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated build time: &xfsprogs-time;</para>
     42        <para>
     43          Download (HTTP): <ulink url="&xfsprogs-download-http;"/>
     44        </para>
     45      </listitem>
     46      <listitem>
     47        <para>
     48          Download (FTP): <ulink url="&xfsprogs-download-ftp;"/>
     49        </para>
     50      </listitem>
     51      <listitem>
     52        <para>
     53          Download MD5 sum: &xfsprogs-md5sum;
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download size: &xfsprogs-size;
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Estimated disk space required: &xfsprogs-buildsize;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Estimated build time: &xfsprogs-time;
     69        </para>
    5670      </listitem>
    5771    </itemizedlist>
    … …  
    6579    <title>Kernel Configuration</title>
    6680
    67     <para>Enable the following options in the kernel configuration
    68     and recompile the kernel:</para>
     81    <para>
     82      Enable the following options in the kernel configuration
     83      and recompile the kernel:
     84    </para>
    6985
    7086<screen><literal>File systems ---&gt;
    … …  
    8096    <title>Installation of xfsprogs</title>
    8197
    82     <para>Install <application>xfsprogs</application> by running the following
    83     commands:</para>
     98    <para>
     99      Install <application>xfsprogs</application> by running the following
     100      commands:
     101    </para>
    84102
    85103 <screen><userinput>make DEBUG=-DNDEBUG     \
    … …  
    88106     LOCAL_CONFIGURE_OPTIONS="--enable-readline"</userinput></screen>
    89107
    90     <para>This package does not come with a test suite.</para>
    91 
    92     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     108    <para>
     109      This package does not come with a test suite.
     110    </para>
     111
     112    <para>
     113      Now, as the <systemitem class="username">root</systemitem> user:
     114    </para>
    93115
    94116<screen role="root"><userinput>make PKG_DOC_DIR=/usr/share/doc/xfsprogs-&xfsprogs-version; install     &amp;&amp;
    … …  
    105127    <title>Command Explanations</title>
    106128
    107     <para><command>make DEBUG=-DNDEBUG</command>: Turns off debugging
    108     symbols.</para>
    109 
    110     <para><parameter>INSTALL_USER=root INSTALL_GROUP=root</parameter>: This
    111     sets the owner and group of the installed files.</para>
    112 
    113     <para><parameter>LOCAL_CONFIGURE_OPTIONS="..."</parameter>: This passes
    114     extra configuration options to the <filename>configure</filename> script.
    115     The example <parameter>--enable-readline</parameter> parameter
    116     enables linking the XFS programs with the
    117     <filename class="libraryfile">libreadline.so</filename> library, in order
    118     to allow editing interactive commands.</para>
    119 
    120     <para><option>OPTIMIZER="..."</option>: Adding this parameter to
    121     the end of the <command>make</command> command overrides the
    122     default optimization settings.</para>
     129    <para>
     130      <command>make DEBUG=-DNDEBUG</command>: Turns off debugging
     131      symbols.
     132    </para>
     133
     134    <para>
     135      <parameter>INSTALL_USER=root INSTALL_GROUP=root</parameter>: This
     136      sets the owner and group of the installed files.
     137    </para>
     138
     139    <para>
     140      <parameter>LOCAL_CONFIGURE_OPTIONS="..."</parameter>: This passes
     141      extra configuration options to the <filename>configure</filename> script.
     142      The example <parameter>--enable-readline</parameter> parameter
     143      enables linking the XFS programs with the
     144      <filename class="libraryfile">libreadline.so</filename> library, in order
     145      to allow editing interactive commands.
     146    </para>
     147
     148    <para>
     149      <option>OPTIMIZER="..."</option>: Adding this parameter to
     150      the end of the <command>make</command> command overrides the
     151      default optimization settings.
     152    </para>
    123153
    124154  </sect2>
    … …  
    150180        <term><command>fsck.xfs</command></term>
    151181        <listitem>
    152           <para>simply exits with a zero status, since XFS
    153           partitions are checked at mount time.</para>
     182          <para>
     183            simply exits with a zero status, since XFS
     184            partitions are checked at mount time.
     185          </para>
    154186          <indexterm zone="xfsprogs fsck.xfs">
    155187            <primary sortas="b-fsck.xfs">fsck.xfs</primary>
    … …  
    161193        <term><command>mkfs.xfs</command></term>
    162194        <listitem>
    163           <para>constructs an XFS file system.</para>
     195          <para>
     196            constructs an XFS file system.
     197          </para>
    164198          <indexterm zone="xfsprogs mkfs.xfs">
    165199            <primary sortas="b-mkfs.xfs">mkfs.xfs</primary>
    … …  
    171205        <term><command>xfs_admin</command></term>
    172206        <listitem>
    173           <para>changes the parameters of an XFS file system.</para>
     207          <para>
     208            changes the parameters of an XFS file system.
     209          </para>
    174210          <indexterm zone="xfsprogs xfs_admin">
    175211            <primary sortas="b-xfs_admin">xfs_admin</primary>
    … …  
    181217        <term><command>xfs_bmap</command></term>
    182218        <listitem>
    183           <para>prints block mapping for an XFS file.</para>
     219          <para>
     220            prints block mapping for an XFS file.
     221          </para>
    184222          <indexterm zone="xfsprogs xfs_bmap">
    185223            <primary sortas="b-xfs_bmap">xfs_bmap</primary>
    … …  
    191229        <term><command>xfs_copy</command></term>
    192230        <listitem>
    193           <para>copies the contents of an XFS file system
    194           to one or more targets in parallel.</para>
     231          <para>
     232            copies the contents of an XFS file system
     233            to one or more targets in parallel.
     234          </para>
    195235          <indexterm zone="xfsprogs xfs_copy">
    196236            <primary sortas="b-xfs_copy">xfs_copy</primary>
    … …  
    202242        <term><command>xfs_estimate</command></term>
    203243        <listitem>
    204           <para>for each directory argument, estimates the space that directory
    205           would take if it were copied to an XFS filesystem
    206           (does not cross mount points).</para>
     244          <para>
     245            for each directory argument, estimates the space that directory
     246            would take if it were copied to an XFS filesystem
     247            (does not cross mount points).
     248          </para>
    207249          <indexterm zone="xfsprogs xfs_estimate">
    208250            <primary sortas="b-xfs_estimate">xfs_estimate</primary>
    … …  
    214256        <term><command>xfs_db</command></term>
    215257        <listitem>
    216           <para>is used to debug an XFS file system.</para>
     258          <para>
     259            is used to debug an XFS file system.
     260          </para>
    217261          <indexterm zone="xfsprogs xfs_db">
    218262            <primary sortas="b-xfs_db">xfs_db</primary>
    … …  
    224268        <term><command>xfs_freeze</command></term>
    225269        <listitem>
    226           <para>suspends access to an XFS file system.</para>
     270          <para>
     271            suspends access to an XFS file system.
     272          </para>
    227273          <indexterm zone="xfsprogs xfs_freeze">
    228274            <primary sortas="b-xfs_freeze">xfs_freeze</primary>
    … …  
    234280        <term><command>xfs_fsr</command></term>
    235281        <listitem>
    236           <para>applicable only to XFS filesystems, improves the organization
    237           of mounted filesystems, the reorganization algorithm operates on one
    238           file at a time, compacting or othewise  improving the layout of the
    239           file extents (contiguous blocks of file data).</para>
     282          <para>
     283            applicable only to XFS filesystems, improves the organization of
     284            mounted filesystems, the reorganization algorithm operates on one
     285            file at a time, compacting or othewise  improving the layout of the
     286            file extents (contiguous blocks of file data).
     287          </para>
    240288          <indexterm zone="xfsprogs xfs_fsr">
    241289            <primary sortas="b-xfs_fsr">xfs_fsr</primary>
    … …  
    247295        <term><command>xfs_growfs</command></term>
    248296        <listitem>
    249           <para>expands an XFS file system.</para>
     297          <para>
     298            expands an XFS file system.
     299          </para>
    250300          <indexterm zone="xfsprogs xfs_growfs">
    251301            <primary sortas="b-xfs_growfs">xfs_growfs</primary>
    … …  
    257307        <term><command>xfs_info</command></term>
    258308        <listitem>
    259           <para>is equivalent to invoking <command>xfs_growfs</command>, but
    260           specifying that no change to the file system is to be made.</para>
     309          <para>
     310            is equivalent to invoking <command>xfs_growfs</command>, but
     311            specifying that no change to the file system is to be made.
     312          </para>
    261313          <indexterm zone="xfsprogs xfs_info">
    262314            <primary sortas="b-xfs_info">xfs_info</primary>
    … …  
    268320        <term><command>xfs_io</command></term>
    269321        <listitem>
    270           <para>is a debugging tool like <command>xfs_db</command>, but is
    271           aimed at examining the regular file I/O path rather than the raw
    272           XFS volume itself.</para>
     322          <para>
     323            is a debugging tool like <command>xfs_db</command>, but is
     324            aimed at examining the regular file I/O path rather than the raw
     325            XFS volume itself.
     326          </para>
    273327          <indexterm zone="xfsprogs xfs_io">
    274328            <primary sortas="b-xfs_io">xfs_io</primary>
    … …  
    280334        <term><command>xfs_logprint</command></term>
    281335        <listitem>
    282           <para>prints the log of an XFS file system.</para>
     336          <para>
     337            prints the log of an XFS file system.
     338          </para>
    283339          <indexterm zone="xfsprogs xfs_logprint">
    284340            <primary sortas="b-xfs_logprint">xfs_logprint</primary>
    … …  
    290346        <term><command>xfs_mdrestore</command></term>
    291347        <listitem>
    292           <para>restores an XFS metadump image to a filesystem image.</para>
     348          <para>
     349            restores an XFS metadump image to a filesystem image.
     350          </para>
    293351          <indexterm zone="xfsprogs xfs_mdrestore">
    294352            <primary sortas="b-xfs_mdrestore">xfs_mdrestore</primary>
    … …  
    300358        <term><command>xfs_metadump</command></term>
    301359        <listitem>
    302           <para>copies XFS filesystem metadata to a file.</para>
     360          <para>
     361            copies XFS filesystem metadata to a file.
     362          </para>
    303363          <indexterm zone="xfsprogs xfs_metadump">
    304364            <primary sortas="b-xfs_metadump">xfs_metadump</primary>
    … …  
    310370        <term><command>xfs_mkfile</command></term>
    311371        <listitem>
    312           <para>creates an XFS file, padded with zeroes by default.</para>
     372          <para>
     373            creates an XFS file, padded with zeroes by default.
     374          </para>
    313375          <indexterm zone="xfsprogs xfs_mkfile">
    314376            <primary sortas="b-xfs_mkfile">xfs_mkfile</primary>
    … …  
    320382        <term><command>xfs_ncheck</command></term>
    321383        <listitem>
    322           <para>generates pathnames from inode numbers for an
    323           XFS file system.</para>
     384          <para>
     385            generates pathnames from inode numbers for an
     386            XFS file system.
     387          </para>
    324388          <indexterm zone="xfsprogs xfs_ncheck">
    325389            <primary sortas="b-xfs_ncheck">xfs_ncheck</primary>
    … …  
    331395        <term><command>xfs_quota</command></term>
    332396        <listitem>
    333           <para>is a utility for reporting and editing various
    334           aspects of filesystem quota.</para>
     397          <para>
     398            is a utility for reporting and editing various
     399            aspects of filesystem quota.
     400          </para>
    335401          <indexterm zone="xfsprogs xfs_quota">
    336402            <primary sortas="b-xfs_quota">xfs_quota</primary>
    … …  
    342408        <term><command>xfs_repair</command></term>
    343409        <listitem>
    344           <para>repairs corrupt or damaged XFS file systems.</para>
     410          <para>
     411            repairs corrupt or damaged XFS file systems.
     412          </para>
    345413          <indexterm zone="xfsprogs xfs_repair">
    346414            <primary sortas="b-xfs_repair">xfs_repair</primary>
    … …  
    352420        <term><command>xfs_rtcp</command></term>
    353421        <listitem>
    354           <para>copies a file to the real-time partition on an
    355           XFS file system.</para>
     422          <para>
     423            copies a file to the real-time partition on an
     424            XFS file system.
     425          </para>
    356426          <indexterm zone="xfsprogs xfs_rtcp">
    357427            <primary sortas="b-xfs_rtcp">xfs_rtcp</primary>
    … …  
    363433        <term><command>xfs_spaceman</command></term>
    364434        <listitem>
    365           <para>reports and controls free space usage in an
    366           XFS file system.</para>
     435          <para>
     436            reports and controls free space usage in an
     437            XFS file system.
     438          </para>
    367439          <indexterm zone="xfsprogs xfs_spaceman">
    368440            <primary sortas="b-xfs_spaceman">xfs_spaceman</primary>
    … …  
    374446        <term><filename class="libraryfile">libhandle.so</filename></term>
    375447        <listitem>
    376           <para>contains XFS-specific functions that provide a way to perform
    377           certain filesystem  operations without using a file descriptor to
    378           access filesystem objects.</para>
     448          <para>
     449            contains XFS-specific functions that provide a way to perform
     450            certain filesystem  operations without using a file descriptor to
     451            access filesystem objects.
     452          </para>
    379453          <indexterm zone="xfsprogs libhandle">
    380454            <primary sortas="c-libhandle">libhandle.so</primary>
Note: See TracChangeset for help on using the changeset viewer.