This directory contains a snapshot of the XFS CVS tree at the start of
kernel 2.4.16.  The snapshot can be downloaded as a single patch
containing all the XFS kernel code, it has also been split into several
patches to make it easier to port XFS to other architectures and for
distributors to include XFS in their distributions.

You can apply the -all-i386 (ia64) patch to get a snapshot of XFS for
2.4.16-i386 (ia64) as of 2001-12-04 03:15 UTC.  Or you can selectively
apply the -split patches.  Do not mix the -all and -split patches, that
will result in patch errors and/or duplicate code.

The -all and -split patches are provided as a courtesy and are not
supported.  They are created after the initial upgrade to a new kernel
and are not changed afterwards.  In particular any bug fixes or XFS/kdb
changes for pre-release kernels are _not_ reflected here.  The main
method of XFS distribution is via the XFS CVS tree, if you want an up
to date version of XFS then use CVS.

If you want patches for the -ac tree you will have to do them yourself,
using these patches as a starting point.  SGI do not track the -ac tree
for XFS, there are too many VM differences.

Apply just the xfs-2.4.16-all-i386 patch against a pristine 2.4.16
kernel to get a snapshot of XFS for 2.4.16-i386 as of 2001-12-04 03:15
UTC.

Apply just the xfs-2.4.16-all-ia64-011128 patch against 2.4.16 +
ia64-011128 patch to get a snapshot of XFS for 2.4.16-ia64-011128 as of
2001-12-04 03:15 UTC.  This includes kdb for ia64 but excludes
kbuild-2.5.

Or apply the split patches in this order

  xfs-2.4.16-split-kdb-i386
  xfs-2.4.16-split-only
  xfs-2.4.16-split-kernel
  xfs-2.4.16-split-kbuild-2.5
  xfs-2.4.16-split-misc
  xfs-2.4.16-split-acl-extattr

against a pristine 2.4.16 kernel to get a snapshot of XFS for
2.4.16-i386 as of 2001-12-04 03:15 UTC.

In either case the result should be identical to CVS except for RCS
identifiers and some generated files which are shipped but should not
be.  Running

  diff -urN -I '$[ABD-Z].*\$' -x CVS -x aic7xxx -x defkeymap.c

between the result of applying these patches and the corresponding XFS
CVS tree should find no differences.

When using the -split patches, some are required, other patches are
optional.  Again, do not mix the -all and -split patches, use one or
the other.

Required -split patches.

  xfs-2.4.16-split-only

    All the new files added by XFS.  No changes to existing files.

  xfs-2.4.16-split-kernel

    Changes to existing kernel files to build core XFS.  Applying just
    the -only and -kernel patches gets XFS support that excludes XFS
    extended attributes, access control lists (ACLs), DMAPI, debugging
    etc.  If core XFS (-only plus -kernel) does not compile, that is a
    bug.

Optional -split patches.

  xfs-2.4.16-split-kdb-i386

    The SGI kernel debugger for i386 is included in the XFS CVS tree,
    this patch is identical to the one in the kdb project area.  For
    XFS on architectures other than ix86 you must omit this patch.  You
    can use the IA64 kdb patch if you are building XFS on IA64.

  xfs-2.4.16-split-kbuild-2.5

    XFS is ready for compiling with kbuild 2.5.  This patch contains
    the extra files and additions required to hook XFS into kbuild 2.5.
    See http://marc.theaimsgroup.com/?l=linux-xfs&m=100510835713728&w=2
    for instructions on building XFS with kbuild 2.5.

    For technical reasons, some changes may be in both the kbuild 2.5
    patch and in XFS so you may get duplicate patches, just say 'n' to
    "assume -R" and "apply anyway" messages.  This patch assumes that
    you are applying the kdb and acl-extattr patches, if not then you
    will have to edit the XFS for kbuild 2.5 patch accordingly.

  xfs-2.4.16-split-misc

    Miscellaneous patches for XFS, they all hit existing kernel files.
    This patch sets EXTRAVERSION=-xfs, adds XFS and KDB selections to
    default configs and ensures that XFS source does not include files
    from outside the kernel tree.

    Files that are shipped and overwritten (such as SCSI firmware)
    cause problems for the SGI source repository tools and have been
    deleted from the XFS CVS tree.  The misc patch reflects those
    deletions.

    If Linus's tree contains bugs that prevent XFS from compiling or
    running then SGI will include fixes in XFS CVS, even though the
    bugs are nothing to do with XFS.  If you have already fixed the
    Linus bugs then the misc patch will contain duplicate changes.

  xfs-2.4.16-split-acl-extattr

    Adds the hooks for extended attributes, it changes syscall tables
    and central fs code so it is packaged as a separate patch.  Adding
    extended attributes also makes XFS ACL and DMAPI support available.