This directory contains a snapshot of the XFS CVS tree at the start of kernel
2.4.20.  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.20-i386 (ia64) as of 2002-11-29 00:21 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 or other alternate trees you will have to do
them yourself, using these patches as a starting point.  SGI do not track the
alternate kernel trees for XFS, there are too many differences.

Apply just the xfs-2.4.20-all-i386 patch against a pristine
2.4.20 kernel to get a snapshot of XFS for 2.4.20-i386 as of
2002-11-29 00:21 UTC.

Or apply the split patches in this order

  xfs-2.4.20-split-kdb-i386
  xfs-2.4.20-split-only
  xfs-2.4.20-split-quota32
  xfs-2.4.20-split-kernel
  xfs-2.4.20-split-misc
  xfs-2.4.20-split-acl
  xfs-2.4.20-split-dmapi

against a pristine 2.4.20 kernel to get a snapshot of XFS for
2.4.20-i386 as of 2002-11-29 00:21 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].*\$' -I '#define XFS_VERSION_STRING' -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.20-split-only

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

  xfs-2.4.20-split-quota32

    FIXME: These quota notes seem to be out of date, the quota code in XFS
           does not appear to match the URL.

    A local copy of Jan Kara's 32bit VFS quota patch.  It consists of these
    patches :-

	ftp://atrey.karlin.mff.cuni.cz/pub/local/jack/quota/v2.4/2.4.20-pre8/*

    If you are patching XFS against a 2.4.20-ac kernel then it may
    already contain some of these patches.  Reverse the above quota patches
    before applying xfs-2.4.20-split-quota32 to a 2.4.20-ac tree.

  xfs-2.4.20-split-kernel

    Changes to existing kernel files to build core XFS.  It also contains a
    couple of quota32 patches, where the XFS kernel patch has made changes
    that affect quota code.

  Applying just the -only, -kernel and -quota32 patches gets XFS support that
  excludes XFS access control lists (ACLs), DMAPI, debugging etc.  If core
  XFS (-only, -kernel, -quota32) does not compile, that is a bug.

Optional -split patches.

  xfs-2.4.20-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
    (kdb-v2.1-2.4.20-common-1 + i386-1).  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.20-split-misc

    Miscellaneous patches for XFS, they all hit existing kernel files.  This
    patch sets EXTRAVERSION=-xfs and adds XFS and KDB selections to default
    configs.

    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 Marcelo'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 Marcelo bugs then
    the misc patch will contain duplicate changes.

  xfs-2.4.20-split-acl

    Add XFS ACL support.

  xfs-2.4.20-split-dmapi

    Add XFS DMAPI support.

  xfs-2.4.20-split-ia64

    Add XFS support for IA64, apply after the base XFS patches.  Note that
    some kernels may have syscall tkill in ia64 slot 1217.  This is incorrect
    and will be removed by the IA64 maintainer, extended attribute syscalls
    start at 1217.