IBM's Journaled File System (JFS) for Linux
JFS DMAPI
Version 1.0.3, March 28, 2004


The Data Storage Management (XDSM) API is a CAE Specification.  It defines
APIs which use events to notify Data Management (DM) applications about
operations on files, enable DM applications to store arbitrary attribute
information with a file, support managed regions within a file, and use
DMAPI access rights to control access to a file object.  DMAPI refers to
the interface defined by the XDSM Specification.

There are two components necessary to use DMAPI on JFS: the user space
portion (provided in the form of a library) and the kernel space portion
(provided in the form of a kernel patch).  Once the patch is applied and
the kernel built correctly, a JFS partition simply needs to be mounted
with the proper options in order to enable DMAPI.


LIBRARY INSTALLATION
--------------------
There are 3 methods to install the JFS DMAPI library:

A. Installation - RPM
---------------------
1)  You can use the RPM distribution to build the JFS DMAPI library:

        rpmbuild -tb libjfsdm-1.0.3.tar.gz


B. Installation - Building From Source From Tar Ball
----------------------------------------------------
After the source has been unzipped and untarred:

1)  Change directory into the top of the libjfsdm source tree.

2)  Run the configure script:

        ./configure

3)  Compile the library:

        make

4)  Install the library:

        make install


C. Installation - Building From Source From CVS Tree
----------------------------------------------------
After the source has been retrieved from the CVS Tree:

1)  Change directory into the top of the libjfsdm source tree.

2)  Run the autogen.sh script:

        ./autogen.sh

3)  Compile the library:

        make

4)  Install the library:

        make install


KERNEL PATCH INSTALLATION
-------------------------

1)  Apply the kernel patch from the top of the kernel source tree:

        patch -p1 < dmapi-2.6.6-rc3.patch

2)  Configure kernel to enable JFS DMAPI by going to the "File Systems"
    section of the configuration menu and enabling "JFS DMAPI (XDSM) Support"
    (CONFIG_JFS_DMAPI=y) under "JFS filesystem support"

3)  Recompile the kernel/modules (CONFIG_JFS=y/m)

4)  Install the kernel/modules (CONFIG_JFS=y/m)


MOUNT PARTITION
---------------

1)  Mount the JFS partition (this example assumes mount point is the
    /jfsdmapi directory and the device is /dev/hdb3):

        mount -t jfs -o dmapi,mtpt=/jfsdmapi /dev/hdb3 /jfsdmapi


CVS ACCESS
----------
anonymous cvs access is available for the JFS tree, the JFS utilities tree
and the JFS DMAPI library tree from the oss.software.ibm.com server.  It
contains the latest source code for JFS and its utilities and DMAPI library.

id anoncvs
password anoncvs
CVSROOT should be set to :pserver:anoncvs@oss.software.ibm.com:/usr/cvs/jfs

To checkout 2.4.x series of the JFS files enter the following:
cvs checkout linux24

To checkout the JFS utilities enter the following:
cvs checkout jfsutils

To checkout the JFS DMAPI library enter the following:
cvs checkout libjfsdm


SEE ALSO
--------
README file included in the JFS file system

http://oss.software.ibm.com/jfs


Please send bugs, comments, cards and letters to shaggy@austin.ibm.com.

The JFS mailing lists can be subscribed to by using any of the links containing "subscribe"
along the left side of our web page at http://oss.software.ibm.com/jfs/.