testcases/kernel/fs/ext4-new-features/README

TEST SUITE:

The directory ext4-new-features contains the tests related to the ext4
filesystem's new features.

Ext4 is an advanced level of the ext3 filesystem which incorporates scalability
and reliability enhancements for supporting large filesystems(64 bit) in keeping
with increasing disk capacities and state-of-the-art feature requirements. More
extensive information of ext4 can be found at the ext4 wiki site at the URL:
http://ext4.wiki.kernel.org

There are total 117 testcases for ext4 new features test that have been added.
Now, these testcases can test multi-block alloc/delayed alloc, inode version
field on disk, journal checksumming, nanosec timestamps, online defrag, persist
prealloc, subdirectory limit and uninit groups of ext4.
The detail information of ext4 new features can be found at the URL:
http://ext4.wiki.kernel.org/index.php/New_ext4_features


TESTS AIM:

The aim of the tests is to test ext4 new features.


TEST STEPS:
# cd LTPROOT/testcases/kernel/fs/ext4-new-features
# ./configure
# make
# make install
# cd LTPROOT
# ./runltp -f fs_ext4

**This testsuite wouldn't be built when doing LTP default build. We MUST do it
  by ourself.


NOTE:

1. This test can be run by root only.
2. Your MUST run *configure* in this directory to config the tool of ffsb and
   specify a partition to be used for test before compiling the tool, and be
   CAREFUL the data on the specified partition would be DESTROYED. It is better
   that the size of partition is between 5G and 10G. If the partition is too
   big, the test will spend much time. It is unnecessary.
3. Before starting test ext4 new features, please check whether ext4 filesystem
   is compiled into the kernel or not, and the kernel version is *2.6.31* or
   above.
4. A snapshot of config file options is given below:
   ONFIG_EXT4_FS=y
   CONFIG_EXT4DEV_COMPAT=y
   CONFIG_EXT4_FS_XATTR=y
   CONFIG_EXT4_FS_POSIX_ACL=y
   CONFIG_EXT4_FS_SECURITY=y

5. Beside that, the following packages are necessary:
   e2fsprogs
     (http://www.rpmfind.net/linux/rpm2html/search.php?query=e2fsprogs)
   e2fsprogs-devel
     (http://www.rpmfind.net/linux/rpm2html/search.php?query=e2fsprogs-devel)
   e2fsprogs-libs
     (http://www.rpmfind.net/linux/rpm2html/search.php?query=e2fsprogs-libs)
   and the version of these packages should be 1.41.4 or above, otherwise the
   test will fail.


FILES DESCRIPTION:

configure
---------
This is a config script that is used to configure the ffsb tool and specify a
partition for test. And the data on the specified partition would be destroyed.
Be careful! Beside that, you MUST run this script before compile the testcases.

ext4-delalloc-mballoc
---------------------
Directory containing the shell script which is used to test multi-block
allocation and delayed allocation of ext4.

ext4-ffsb-config
----------------
Directory containing the config of ffsb for test.

ext4-inode-version
------------------
Directory containing the shell script which is used to test inode version field
on disk of ext4.

ext4-journal-checksum
---------------------
Directory containing the shell script which is used to test journal checksumming
of ext4.

ext4-nsec-timestamps
--------------------
Directory containing the shell script which is used to test nanosec timestamps
of ext4.

ext4-online-defrag
------------------
Directory containing the shell script which is used to test online defrag
feature of ext4.

ext4-persist-prealloc
---------------------
Directory containing the shell script which is used to test persist prealloc
feature of ext4.

ext4-subdir-limit
-----------------
Directory containing the shell script which is used to test subdirectory limit
of ext4. According to the kernel documentation, we create more than 32000
subdirectorys on the ext4 filesystem.

ext4-uninit-groups
------------------
Directory containing the shell script which is used to test uninitialized groups
feature of ext4.

ffsb-6.0-rc2
------------
This directory contains The Flexible Filesystem Benchmark (FFSB) tool. We use
this tool to create some files to fill the test partition. This tool was written
by Sonny Rao(raosanth@us.ibm.com).

ext4_funcs.sh
-------------
This script contains some functions for ext4 new features test script.
such as: ext4_setup, ext4_cleanup

run_ext4_test.sh
----------------
This script runs all the 119 testcases.

Makefile
--------
Each directory in this directory has its usual makefile, it is for its
directory.

README
------
The one you have gone through.