From: Amir Goldstein <amir73il@gmail.com>
To: "Darrick J. Wong" <djwong@kernel.org>
Cc: Eryu Guan <guaneryu@gmail.com>,
linux-xfs <linux-xfs@vger.kernel.org>,
fstests <fstests@vger.kernel.org>, Eryu Guan <guan@eryu.me>
Subject: Re: [PATCH 6/9] tools: make sure that test groups are described in the documentation
Date: Thu, 16 Sep 2021 08:58:37 +0300 [thread overview]
Message-ID: <CAOQ4uxhPA8dULNa9V+dZ0JPcsyxivXraZQ4vON_Q5=CPL8knKg@mail.gmail.com> (raw)
In-Reply-To: <163174939022.380880.4370326262613244115.stgit@magnolia>
On Thu, Sep 16, 2021 at 2:43 AM Darrick J. Wong <djwong@kernel.org> wrote:
>
> From: Darrick J. Wong <djwong@kernel.org>
>
> Create a file to document the purpose of each test group that is
> currently defined in fstests, and change mkgroupfile to check that every
> group mentioned in the tests is also mentioned in the documentation.
>
> Signed-off-by: Darrick J. Wong <djwong@kernel.org>
Reviewed-by: Amir Goldstein <amir73il@gmail.com>
> ---
> common/preamble | 21 ++++++++
> doc/group-names.txt | 135 +++++++++++++++++++++++++++++++++++++++++++++++++++
> tools/mkgroupfile | 33 +++++++++---
> 3 files changed, 181 insertions(+), 8 deletions(-)
> create mode 100644 doc/group-names.txt
>
>
> diff --git a/common/preamble b/common/preamble
> index 66b0ed05..64d79385 100644
> --- a/common/preamble
> +++ b/common/preamble
> @@ -23,6 +23,26 @@ _register_cleanup()
> trap "${cleanup}exit \$status" EXIT HUP INT QUIT TERM $*
> }
>
> +# Make sure each group is in the documentation file.
> +_check_groups() {
> + test -n "$GROUPNAME_DOC_FILE" || return 0
> +
> + local testname="$(echo "$0" | sed -e 's/^.*tests\///g')"
> + declare -a missing=()
> +
> + for group in "$@"; do
> + if ! grep -q "^${group}[[:space:]]" "$GROUPNAME_DOC_FILE"; then
> + missing+=("\"${group}\"")
> + fi
> + done
> + test "${#missing}" -eq 0 && return 0
> +
> + local suffix=
> + test "${#missing}" -gt 1 && suffix="s"
> + echo "$testname: group$suffix ${missing[@]} not mentioned in documentation." 1>&2
> + return 1
> +}
> +
> # Prepare to run a fstest by initializing the required global variables to
> # their defaults, sourcing common functions, registering a cleanup function,
> # and removing the $seqres.full file.
> @@ -42,6 +62,7 @@ _begin_fstest()
> # If we're only running the test to generate a group.list file,
> # spit out the group data and exit.
> if [ -n "$GENERATE_GROUPS" ]; then
> + _check_groups "$@" || exit 1
> echo "$seq $@"
> exit 0
> fi
> diff --git a/doc/group-names.txt b/doc/group-names.txt
> new file mode 100644
> index 00000000..e8e3477e
> --- /dev/null
> +++ b/doc/group-names.txt
> @@ -0,0 +1,135 @@
> +======================= =======================================================
> +Group Name: Description:
> +======================= =======================================================
> +all All known tests, automatically generated by ./check at
> + runtime
> +auto Tests that should be run automatically. These should
> + not require more than ~5 minutes to run.
> +quick Tests that should run in under 30 seconds.
> +deprecated Old tests that should not be run.
> +
> +acl Access Control Lists
> +admin xfs_admin functionality
> +aio general libaio async io tests
> +atime file access time
> +attr extended attributes
> +attr2 xfs v2 extended aributes
> +balance btrfs tree rebalance
> +bigtime timestamps beyond the year 2038
> +blockdev block device functionality
> +broken broken tests
> +cap Linux capabilities
> +casefold directory name casefolding
> +ci ASCII case-insensitive directory name lookups
> +clone FICLONE/FICLONERANGE ioctls
> +clone_stress stress testing FICLONE/FICLONERANGE
> +collapse fallocate FALLOC_FL_COLLAPSE_RANGE
> +compress file compression
> +convert btrfs ext[34] conversion tool
> +copy xfs_copy functionality
> +copy_range copy_file_range syscall
> +copyup overlayfs copyup
> +dangerous dangerous test that can crash the system
> +dangerous_bothrepair fuzzers to evaluate xfs_scrub + xfs_repair repair
> +dangerous_fuzzers fuzzers that can crash your computer
> +dangerous_norepair fuzzers to evaluate kernel metadata verifiers
> +dangerous_online_repair fuzzers to evaluate xfs_scrub online repair
> +dangerous_repair fuzzers to evaluate xfs_repair offline repair
> +dangerous_scrub fuzzers to evaluate xfs_scrub checking
> +data data loss checkers
> +dax direct access mode for persistent memory files
> +db xfs_db functional tests
> +dedupe FIEDEDUPERANGE ioctl
> +defrag filesystem defragmenters
> +dir directory test functions
> +dump dump and restore utilities
> +eio IO error reporting
> +encrypt encrypted file contents
> +enospc ENOSPC error reporting
> +exportfs file handles
> +filestreams XFS filestreams allocator
> +freeze filesystem freeze tests
> +fsck general fsck tests
> +fsmap FS_IOC_GETFSMAP ioctl
> +fsr XFS free space reorganizer
> +fuzzers filesystem fuzz tests
> +growfs increasing the size of a filesystem
> +hardlink hardlinks
> +health XFS health reporting
> +idmapped idmapped mount functionality
> +inobtcount XFS inode btree count tests
> +insert fallocate FALLOC_FL_INSERT_RANGE
> +ioctl general ioctl tests
> +io_uring general io_uring async io tests
> +label filesystem labelling
> +limit resource limits
> +locks file locking
> +log metadata logging
> +logprint xfs_logprint functional tests
> +long_rw long-soak read write IO path exercisers
> +metacopy overlayfs metadata-only copy-up
> +metadata filesystem metadata update exercisers
> +metadump xfs_metadump/xfs_mdrestore functionality
> +mkfs filesystem formatting tools
> +mount mount option and functionality checks
> +nested nested overlayfs instances
> +nfs4_acl NFSv4 access control lists
> +nonsamefs overlayfs layers on different filesystems
> +online_repair online repair functionality tests
> +other dumping ground, do not add more tests to this group
> +pattern specific IO pattern tests
> +perms access control and permission checking
> +pipe pipe functionality
> +pnfs PNFS
> +posix POSIX behavior conformance
> +prealloc fallocate for preallocating unwritten space
> +preallocrw fallocate, then read and write
> +punch fallocate FALLOC_FL_PUNCH_HOLE
> +qgroup btrfs qgroup feature
> +quota filesystem usage quotas
> +raid btrfs RAID
> +realtime XFS realtime volumes
> +recoveryloop crash recovery loops
> +redirect overlayfs redirect_dir feature
> +remote dump and restore with a remote tape
> +remount remounting filesystems
> +rename rename system call
> +repair xfs_repair functional tests
> +replace btrfs device replace
> +replay dm-logwrites replays
> +resize resize2fs functionality tests
> +richacl rich ACL feature
> +rmap XFS reverse mapping exercisers
> +rotate overlayfs upper layer rotate tests from the unionmount
> + test suite
> +rw read/write IO tests
> +samefs overlayfs when all layers are on the same fs
> +scrub filesystem metadata scrubbers
> +seed btrfs seeded filesystems
> +seek llseek functionality
> +send btrfs send/receive
> +shrinkfs decreasing the size of a filesystem
> +shutdown FS_IOC_SHUTDOWN ioctl
> +snapshot btrfs snapshots
> +soak long running soak tests of any kind
> +spaceman xfs_spaceman functional tests
> +splice splice system call
> +stress fsstress filesystem exerciser
> +subvol btrfs subvolumes
> +swap swap files
> +symlink symbolic links
> +tape dump and restore with a tape
> +thin thin provisioning
> +trim FITRIM ioctl
> +udf UDF functionality tests
> +union tests from the unionmount test suite
> +unlink O_TMPFILE unlinked files
> +unshare fallocate FALLOC_FL_UNSHARE_RANGE
> +v2log XFS v2 log format tests
> +verity fsverity
> +volume btrfs volume management
> +whiteout overlayfs whiteout functionality
> +xino overlayfs xino feature
> +zero fallocate FALLOC_FL_ZERO_RANGE
> +zone zoned (SMR) device support
> +======================= =======================================================
> diff --git a/tools/mkgroupfile b/tools/mkgroupfile
> index 0681e5d2..e4244507 100755
> --- a/tools/mkgroupfile
> +++ b/tools/mkgroupfile
> @@ -9,12 +9,28 @@ fi
>
> test_dir="$PWD"
> groupfile="$1"
> +GROUPNAME_DOC_FILE="$(readlink -m ../../doc/group-names.txt)"
> +export GROUPNAME_DOC_FILE
>
> if [ ! -x ../../check ]; then
> echo "$0: Run this from tests/XXX/."
> exit 1
> fi
>
> +cleanup() {
> + test -z "$groupfile" && return
> + test -z "$ngroupfile" && return
> +
> + if [ $ret -eq 0 ]; then
> + mv "$ngroupfile" "$groupfile"
> + else
> + rm -f "$ngroupfile"
> + fi
> +}
> +
> +ret=1 # trigger cleanup of temporary files unless we succeed
> +trap 'cleanup; exit $ret' EXIT INT TERM QUIT
> +
> generate_groupfile() {
> cat << ENDL
> # QA groups control file, automatically generated.
> @@ -24,19 +40,20 @@ ENDL
> cd ../../
> export GENERATE_GROUPS=yes
> grep -R -l "^_begin_fstest" "$test_dir/" 2>/dev/null | while read testfile; do
> - test -x "$testfile" && "$testfile"
> + test -x "$testfile" && "$testfile" || return 1
> done | sort -g
> + ret="${PIPESTATUS[1]}"
> cd "$test_dir"
> }
>
> if [ -z "$groupfile" ] || [ "$groupfile" = "-" ]; then
> # Dump the group file to stdout and exit
> + unset groupfile
> generate_groupfile
> - exit 0
> +else
> + # Otherwise, write the group file to disk somewhere.
> + ngroupfile="${groupfile}.new"
> + rm -f "$ngroupfile"
> + generate_groupfile >> "$ngroupfile"
> + # let cleanup rename or delete ngroupfile
> fi
> -
> -# Otherwise, write the group file to disk somewhere.
> -ngroupfile="${groupfile}.new"
> -rm -f "$ngroupfile"
> -generate_groupfile >> "$ngroupfile"
> -mv "$ngroupfile" "$groupfile"
>
next prev parent reply other threads:[~2021-09-16 5:58 UTC|newest]
Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-09-15 23:42 [PATCHSET v3 0/9] fstests: document all test groups Darrick J. Wong
2021-09-15 23:42 ` [PATCH 1/9] ceph: re-tag copy_file_range as being in the copy_range group Darrick J. Wong
2021-09-16 5:51 ` Amir Goldstein
2021-09-15 23:42 ` [PATCH 2/9] xfs: move reflink tests into the clone group Darrick J. Wong
2021-09-16 5:51 ` Amir Goldstein
2021-09-15 23:42 ` [PATCH 3/9] xfs: fix incorrect fuzz test group name Darrick J. Wong
2021-09-16 5:52 ` Amir Goldstein
2021-09-15 23:42 ` [PATCH 4/9] btrfs: fix incorrect subvolume " Darrick J. Wong
2021-09-16 5:52 ` Amir Goldstein
2021-09-15 23:43 ` [PATCH 5/9] generic/631: change this test to use the 'whiteout' group Darrick J. Wong
2021-09-16 5:53 ` Amir Goldstein
2021-09-15 23:43 ` [PATCH 6/9] tools: make sure that test groups are described in the documentation Darrick J. Wong
2021-09-16 5:58 ` Amir Goldstein [this message]
2021-09-15 23:43 ` [PATCH 7/9] tools: add missing license tags to my scripts Darrick J. Wong
2021-09-16 6:06 ` Amir Goldstein
2021-09-16 21:44 ` Darrick J. Wong
2021-09-15 23:43 ` [PATCH 8/9] new: only allow documented test group names Darrick J. Wong
2021-09-16 6:10 ` Amir Goldstein
2021-09-15 23:43 ` [PATCH 9/9] new: don't allow new tests in group 'other' Darrick J. Wong
2021-09-16 6:40 ` Amir Goldstein
2021-09-16 22:53 ` Darrick J. Wong
2021-09-17 2:31 ` Amir Goldstein
2021-09-17 16:00 ` Darrick J. Wong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAOQ4uxhPA8dULNa9V+dZ0JPcsyxivXraZQ4vON_Q5=CPL8knKg@mail.gmail.com' \
--to=amir73il@gmail.com \
--cc=djwong@kernel.org \
--cc=fstests@vger.kernel.org \
--cc=guan@eryu.me \
--cc=guaneryu@gmail.com \
--cc=linux-xfs@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).