Return to beta_caveats.html CVS log

Up to [Development] / xfs-website.orig

Beta announce and doc pages.

<& xfsTemplate,top=>1,side=>1 &>

<!-- Start Project Content -->
<h2>
<b><font face="ARIAL NARROW,HELVETICA">XFS Beta Release Caveats</font></b></h2>

<p>
You must take the following issues into account
when you create and administer
XFS filesystems with the current release of XFS for Linux.
</p>

<h3>Size and Memory Limitations</h3>

<li>
2 Terabyte filesystem limitation

<p>
Currently XFS is limited to filesystem smaller that 2 terabytes.
This is due to limitations in the Linux block device I/O layers.
</p>

<p>
The XFS team is working with Linux developers to improve the Linux
I/O layers. The improvements will include the support neccesary to 
exceed 2 Tbyte filesystems.
</p>

<li>
4 Gbyte memory limitation
<h3>Required Compiler and Library Releases</h3>

<li>
gcc version 2.91.66 required
</li>

<p>
Due to known problems with later versions of gcc,
version 2.91.66 must be used when compiling XFS
and the associated kernel.
This is the default compiler on RedHat 6.2 systems.
Other distributions may be using a later version.
The easiest way to check what version is in
use is by running <tt>gcc -v</tt>.
</p>

<li>
glibc version 2.1.3 required
</li>

<p>
The version of glibc primarily used for development and testing 
has been 2.1.3.
Other versions should be considered "status unknown".
</p>

<h3>XFS Features</h3>

<li>
New system calls
</li>

<p>
A preliminary set of system calls to support extended attributes 
has been added. This interface will most likely change as it becomes
more defined and other Linux developers contribute their thoughts.
</p>

<li>
Migrating to XFS 
</li>

<p>
The Linux version of dump and restore can be used to migrate 
data from a non-XFS volume to an XFS volume.
Linux dump, however, cannot be used to dump an XFS volume as it uses
ext2 library functions.
</p>

<li>
Backup and Restore
</li>

<p>
xfsdump and xfsrestore should be used for backup and restore
of XFS volumes. xfsdump and xfsrestore currently support
file extents but not extended attributes.
DMAPI and quotas are not yet supported in Linux XFS,
nor are they supported in xfsdump and xfsrestore.
</p>

<h3>XFS Caveats and Limitations</h3>

<li>
XFS version 2 directory format recommended
</li>

<p>
XFS supports two directory formats, referred to as
version 1 and version 2.  For Linux XFS,
the version 2 directory format is strongly recommended.
Due to 32 bit size limitations in the Linux inode,
XFS version 1 directories will
fail after any given directories reach a certain number of files.
</p>

<li>
4k filesystem block size limitation
</li>

<p>
For the current release of XFS, the filesystem block size is limited
to the size of a memory page.  On a x86 architecture that size is 4 Kbytes.
</p>

<p>
Note that files systems created on an IRIX/MIPS platform must have been 
created with a 4 Kbyte block size in order to be mounted on a ia32 Linux system.
File systems not created with a 4k block will fail to mount with an error
indicating the mis-match.
</p>

<li>
Unwritten extents unsupported
</li>

<p>
The unwritten extent feature is not yet operational
and should be turned off when mkfs is executed, using
the following argument to the <tt>mkfs</tt> command:
</p>

<p>
<tt>-d unwritten=0</tt>
</p>

<p>
Currently this is the default setting for mkfs.xfs on Linux.
</p>

<li>
Asynchronous and Direct I/O unsupported
</li>

<p>
Specifying the O_SYNC flag does not currently yield asynchronous
I/O behavior;  this flag is silently ignored.  This capability
will be added in a future release.
</p>

<p>
Direct I/O is not yet operational. It is scheduled
for a later beta release.
</p>

<li>
Quotas unsupported 
</li>

<p>
Support for filesystem quotas is not yet operational.
</p>

<li>
Changing filesystem permissions
</li>
<p>
It is possible to remount an XFS filesystem to change its permissions
from read/write to read-only.  This support is needed for
XFS to function as a root filesystem.
</p>

<li>
Issues with filesystem remounts
</li>

<p>
Issuing the remount call to a non-busy XFS filesystem does not always
work correctly. The usual result will be a hung processes.  The
occurs primarily when executing the
mount -o remount command.
</p>

<p>
Mounting files using the loop filesystem on an XFS partition does not work 
and usually results in a system panic.
</p>

<br>


<& xfsTemplate,bottom=>1 &>