1 Configuration file with sections
2 ================================
4 Configuration file with sections is useful for running xfstests on multiple
5 file systems, or multiple file system setups in a single run without any
6 help of external scripts.
12 Syntax for defining a section is the following:
16 Section name should consist of alphanumeric characters and '_'. Anything
17 else is forbidden and the section will not be recognised.
19 Each section in the configuration file should contain options in the format
23 'OPTION' must not contain any white space characters. 'value' can contain
24 any character you want with one simple limitation - characters ' and " can
25 only appear at the start and end of the 'value', however it is not required.
27 Note that options are carried between sections so the same options does not
28 have to be specified in each and every sections. However caution should be
29 exercised not to leave unwanted options set from previous sections.
35 For every section xfstests will run with specified options and will produce
36 separate results in the '$RESULT_BASE/$section_name' directory.
39 Different mount options
40 -----------------------
42 Specifying different mount options in difference config sections is allowed.
43 When MOUNT_OPTIONS differs in the following section TEST_DEV will be remounted
44 with new MOUNT_OPTIONS automatically before running the test.
50 Having different file systems in different config sections is allowed. When
51 FSTYP differs in the following section the FSTYP file system will be created
52 automatically before running the test.
54 Note that if MOUNT_OPTIONS, MKFS_OPTIONS, or FSCK_OPTIONS are not directly
55 specified in the section it will be reset to the default for a given file
58 You can also force the file system recreation by specifying RECREATE_TEST_DEV.
60 Run specified section only
61 --------------------------
63 Specifying '-s' argument with section name will run only the section
64 specified. The '-s' argument can be specified multiple times to allow multiple
67 The options are still carried between section, that includes the sections
68 which are not going to be run. So you can do something like
74 SCRATCH_MNT=/mnt/test1
86 ./check -s xfs -s btrfs
88 to check xfs and btrfs only. All the devices and mounts are still going to
89 be parsed from the section [ext4].
94 Here is an example of config file with sections:
100 SCRATCH_MNT=/mnt/test1
101 MKFS_OPTIONS="-q -F -b4096"
103 RESULT_BASE="`pwd`/results/`date +%d%m%y_%H%M%S`"
106 MKFS_OPTIONS="-q -F -b1024"
109 MKFS_OPTIONS="-q -F -b4096 -O ^has_journal"
117 MOUNT_OPTIONS="-o noatime"
121 TEST_DEV=192.168.14.1:6789:/
122 TEST_FS_MOUNT_OPTS="-o name=admin,secret=AQDuEBtYKEYRINGSECRETriSC8YJGDZsQHcr7g=="