Re: [PATCH] xfsdocs: updates to XFS User Guide

[Geoffrey Wehrman <gwehrman@xxxxxxx>]

On Fri, Jul 02, 2010 at 03:14:54AM -0400, Lachlan McIlroy wrote:
| Hi all, it's been a while since I posted here!
| 
| Various updates to chapters 1,2,4 and 5 of the XFS User Guide.
| 
| Fixed various spelling/grammar mistakes, updated outdated and/or
| incorrect facts, added some new slides for delayed allocation and
| direct i/o and fixed some XML formatting for command line examples.

I asked our tech pubs editor for comments.  Lori always has good editing
advice.

----- Forwarded message from Lachlan McIlroy <lmcilroy@xxxxxxxxxx> -----

+                                       Extended attributes (ie Access Control 
Lists)
                                                             ^^
                                                             such as


+                                       Extent based allocation (incl. 
unwritten extents)
                                                                 ^^^^^
                                                                 including


                <listitem><para>Filesystem blocks are comprised of one or more 
device-level sectors.</para></listitem>
                                                      ^^^^^^^^^
                                                      composed


+               <listitem><para>Through direct IOs of specific alignment (ie 
stripe boundaries)</para></listitem>
                                                                          ^^
                                                                          such 
as

+                       <listitem><para>free block count is 
decremented</para></listitem>
                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                        decrements free block count


+               <listitem><para>Reduces fragmentation by combining writes and 
allocating extents in large chunks</para></listitem>
                                ^^^^^^^^^^^^^^^^^^^^^
                                Fragmentation is reduced


+               <listitem><para>Files written randomly (ie memory mapped) can 
now be allocated contiguously</para></listitem>
                                                        ^^
                                                        such as those that are


+               <listitem><para>Data does not pass through the file system 
cache</para></listitem>
                                                               ^^^^^^^^^^^
                                                               filesystem



+               <listitem><para>Backup programs can work without polluting the 
page cache</para></listitem>
                                                ^^^
                                                that can 
                                                  or
                                                , so that they can
                                                
                                                 ??     

+               <para>Direct I/O can align block allocations on strip 
unit/width boundaries</para>
                                                                ^^^^^
                                                                stripe
                                                                 
                                                                 ?


+               <listitem><para>In memory XFS inode used only by the 
filesystem</para></listitem>
                                ^^^^^^^^^
                                In-memory


+               <para>Log replay will apply filesystem and metadata changes 
during mount that had been
                                                                                
   ^^^^^
                                                                                
   a mount



+               <para>mkfs.xfs supports a large number of options for 
configurating many different XFS filesystems</para>
                                                                      
^^^^^^^^^^^^^
                                                                      
configuring


+               <listitem><para>Allocator will rotor data extents across 
allocations groups to leave room for inodes</para></listitem>
                                               ^^^^
                                               rotate ?


+               <listitem><para>Only available on 64 bit 
machines</para></listitem>
                                                  ^^^^^^
                                                  64bit
                                                  (to be consistent with other 
uses here)


+               <para>If neither of these two options are specified, then 
filesystem will behave as if
                                                                          
^^^^^^^^^^
                                                                          the 
filesystem



-- 
Geoffrey Wehrman