2017-02-28 14:18:35 +02:00
|
|
|
|
|
|
|
|
To run xfstest on overlayfs, configure the variables of TEST and SCRATCH
|
|
|
|
|
partitions to be used as the "base fs" and run './check -overlay'.
|
|
|
|
|
|
|
|
|
|
For example, the following config file can be used to run tests on
|
|
|
|
|
xfs test/scratch partitions:
|
|
|
|
|
|
|
|
|
|
TEST_DEV=/dev/sda5
|
|
|
|
|
TEST_DIR=/mnt/test
|
|
|
|
|
SCRATCH_DEV=/dev/sda6
|
|
|
|
|
SCRATCH_MNT=/mnt/scratch
|
|
|
|
|
FSTYP=xfs
|
|
|
|
|
|
|
|
|
|
Using the same config file, but executing './check -overlay' will
|
|
|
|
|
use the same partitions as base fs for overlayfs directories
|
|
|
|
|
and set TEST_DIR/SCRATCH_MNT values to overlay mount points, i.e.:
|
|
|
|
|
/mnt/test/ovl-mnt and /mnt/scratch/ovl-mnt, for the context of
|
|
|
|
|
individual tests.
|
2017-02-28 14:18:36 +02:00
|
|
|
|
|
|
|
|
'./check -overlay' does not support mkfs and fsck on the base fs, so
|
|
|
|
|
the base fs should be pre-formatted before starting the -overlay run.
|
|
|
|
|
An easy way to accomplish this is by running './check <some test>' once,
|
|
|
|
|
before running './check -overlay'.
|
|
|
|
|
|
2018-03-01 20:13:44 +08:00
|
|
|
'./check -overlay' support check overlay test and scratch dirs,
|
|
|
|
|
OVERLAY_FSCK_OPTIONS should be set instead of FSCK_OPTIONS if fsck
|
|
|
|
|
options need to given directly.
|
|
|
|
|
|
2017-02-28 14:18:36 +02:00
|
|
|
Because of the lack of mkfs support, multi-section config files are only
|
|
|
|
|
partly supported with './check -overlay'. Only multi-section files that
|
|
|
|
|
do not change FSTYP and MKFS_OPTIONS can be safely used with -overlay.
|
|
|
|
|
|
|
|
|
|
For example, the following multi-section config file can be used to
|
|
|
|
|
run overlay tests on the same base fs, but with different mount options:
|
|
|
|
|
|
|
|
|
|
[xfs]
|
|
|
|
|
TEST_DEV=/dev/sda5
|
|
|
|
|
TEST_DIR=/mnt/test
|
|
|
|
|
SCRATCH_DEV=/dev/sda6
|
|
|
|
|
SCRATCH_MNT=/mnt/scratch
|
|
|
|
|
FSTYP=xfs
|
|
|
|
|
|
|
|
|
|
[xfs_pquota]
|
|
|
|
|
MOUNT_OPTIONS="-o pquota"
|
|
|
|
|
TEST_FS_MOUNT_OPTS="-o noatime"
|
|
|
|
|
OVERLAY_MOUNT_OPTIONS="-o redirect_dir=off"
|
2018-03-01 20:13:44 +08:00
|
|
|
OVERLAY_FSCK_OPTIONS="-n -o redirect_dir=off"
|
2017-02-28 14:18:36 +02:00
|
|
|
|
|
|
|
|
In the example above, MOUNT_OPTIONS will be used to mount the base scratch fs,
|
2018-03-01 20:13:44 +08:00
|
|
|
TEST_FS_MOUNT_OPTS will be used to mount the base test fs,
|
|
|
|
|
OVERLAY_MOUNT_OPTIONS will be used to mount both test and scratch overlay and
|
|
|
|
|
OVERLAY_FSCK_OPTIONS will be used to check both test and scratch overlay.
|
2020-05-31 14:01:54 +03:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Unionmount Testsuite
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
xfstests can be used as a test harness to run unionmount testsuite test cases
|
|
|
|
|
and provide extended test coverage for overlayfs.
|
|
|
|
|
|
|
|
|
|
To enable running unionmount testsuite, clone the git repository from:
|
|
|
|
|
https://github.com/amir73il/unionmount-testsuite.git
|
|
|
|
|
under the xfstests src directory, or set the environment variable
|
|
|
|
|
UNIONMOUNT_TESTSUITE to the local path where the repository was cloned.
|
|
|
|
|
|
|
|
|
|
Run './check -overlay -g overlay/union' to execute all the unionmount testsuite
|
|
|
|
|
test cases.
|
