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/.