2 #-----------------------------------------------------------------------
3 # Copyright (c) 2000-2006 Silicon Graphics, Inc. All Rights Reserved.
4 # This program is free software; you can redistribute it and/or modify
5 # it under the terms of the GNU General Public License as published by
6 # the Free Software Foundation; either version 2 of the License, or
7 # (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19 # Contact information: Silicon Graphics, Inc., 1500 Crittenden Lane,
20 # Mountain View, CA 94043, USA, or: http://www.sgi.com
21 #-----------------------------------------------------------------------
25 BC=$(which bc 2> /dev/null) || BC=
27 # Some tests are not relevant or functional when testing XFS realtime
28 # subvolumes along with the rtinherit=1 mkfs option. In these cases,
29 # this test will opt-out of the test.
30 _require_no_rtinherit()
32 [ "$FSTYP" = "xfs" ] && echo "$MKFS_OPTIONS" |
33 egrep -q "rtinherit([^=]|=1|$)" && \
34 _notrun "rtinherit mkfs option is not supported by this test."
40 _notrun "this test requires 'bc' tool for doing math operations"
46 [ $# -le 0 ] && return
47 LANG=C echo "scale=0; $@" | "$BC" -q 2> /dev/null
52 if [ "$HOSTOS" == "Linux" ]
54 command dd --help 2>&1 | grep noxfer >/dev/null
58 command dd status=noxfer $@
67 # Prints the md5 checksum of a given file
70 md5sum $1 | cut -d ' ' -f1
73 # Write a byte into a range of a file
79 local xfs_io_args="$5"
81 $XFS_IO_PROG $xfs_io_args -f -c "pwrite -S $pattern $offset $len" "$file"
84 # mmap-write a byte into a range of a file
92 $XFS_IO_PROG -f -c "mmap -rw 0 $mmap_len" -c "mwrite -S $pattern $offset $len" "$file"
95 # ls -l w/ selinux sometimes puts a dot at the end:
96 # -rwxrw-r--. id1 id2 file1
97 # Also filter out lost+found directory on extN file system if present
101 ls -l $* | sed "s/\(^[-rwxdlbcpsStT]*\)\. /\1 /" | grep -v 'lost+found'
119 echo "$_err_msg" | tee -a $seqres.full
120 echo "(see $seqres.full for details)"
123 # make sure we have a standard umask
126 # check for correct setup and source the $FSTYP specific functions now
129 [ "$XFS_LOGPRINT_PROG" = "" ] && _fatal "xfs_logprint not found"
130 [ "$XFS_REPAIR_PROG" = "" ] && _fatal "xfs_repair not found"
131 [ "$XFS_DB_PROG" = "" ] && _fatal "xfs_db not found"
132 [ "$MKFS_XFS_PROG" = "" ] && _fatal "mkfs_xfs not found"
137 [ "$MKFS_UDF_PROG" = "" ] && _fatal "mkfs_udf/mkudffs not found"
140 [ "$MKFS_BTRFS_PROG" = "" ] && _fatal "mkfs.btrfs not found"
145 [ "$MKFS_EXT4_PROG" = "" ] && _fatal "mkfs.ext4 not found"
148 [ "$MKFS_F2FS_PROG" = "" ] && _fatal "mkfs.f2fs not found"
165 [ "$MKFS_REISER4_PROG" = "" ] && _fatal "mkfs.reiser4 not found"
170 [ "$UBIUPDATEVOL_PROG" = "" ] && _fatal "ubiupdatevol not found"
174 if [ ! -z "$REPORT_LIST" ]; then
181 $MOUNT_PROG `_mount_ops_filter $*`
184 # Call _mount to do mount operation but also save mountpoint to
185 # MOUNTED_POINT_STACK. Note that the mount point must be the last parameter
188 local mnt_point=${!#}
189 local mnt_dev=${@:(-2):1}
190 local scratch_opts=""
191 if [ "$mnt_dev" = "$SCRATCH_DEV" ]; then
192 _scratch_options mount
193 scratch_opts="$SCRATCH_OPTIONS"
196 _mount $scratch_opts $*
197 if [ $? -eq 0 ]; then
198 MOUNTED_POINT_STACK="$mnt_point $MOUNTED_POINT_STACK"
204 # Unmount the last mounted mountpoint in MOUNTED_POINT_STACK
205 # and return it to caller
208 local last_mnt=`echo $MOUNTED_POINT_STACK | awk '{print $1}'`
210 if [ -n "$last_mnt" ]; then
211 $UMOUNT_PROG $last_mnt
213 MOUNTED_POINT_STACK=`echo $MOUNTED_POINT_STACK | cut -d\ -f2-`
216 # Unmount all mountpoints in MOUNTED_POINT_STACK and clear the stack
219 if [ -n "$MOUNTED_POINT_STACK" ]; then
220 $UMOUNT_PROG $MOUNTED_POINT_STACK
222 MOUNTED_POINT_STACK=""
232 if [ "$FSTYP" != "xfs" ]; then
238 SCRATCH_OPTIONS="$SCRATCH_OPTIONS -f"
247 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
248 SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${rt_opt}rtdev=$SCRATCH_RTDEV"
249 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
250 SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${log_opt}logdev=$SCRATCH_LOGDEV"
260 if [ "$FSTYP" != "xfs" ]; then
274 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_RTDEV" ] && \
275 TEST_OPTIONS="$TEST_OPTIONS ${rt_opt}rtdev=$TEST_RTDEV"
276 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_LOGDEV" ] && \
277 TEST_OPTIONS="$TEST_OPTIONS ${log_opt}logdev=$TEST_LOGDEV"
283 local last_index=$(( $# - 1 ))
285 #get mount point to handle dmapi mtpt option correctly
286 [ $last_index -gt 0 ] && shift $last_index
289 echo $params | sed -e 's/dmapi/dmi/' \
290 | $PERL_PROG -ne "s#mtpt=[^,|^\n|^\s]*#mtpt=$fs_escaped\1\2#; print;"
294 # Used for mounting non-scratch devices (e.g. loop, dm constructs)
295 # with the safe set of scratch mount options (e.g. loop image may be
296 # hosted on $SCRATCH_DEV, so can't use external scratch devices).
297 _common_dev_mount_options()
299 echo $MOUNT_OPTIONS $SELINUX_MOUNT_OPTIONS $*
302 _scratch_mount_options()
304 _scratch_options mount
306 echo `_common_dev_mount_options $*` $SCRATCH_OPTIONS \
307 $SCRATCH_DEV $SCRATCH_MNT
314 local fstyp=`$DF_PROG $dir | tail -1 | $AWK_PROG '{print $2}'`
317 xfs_info $dir | grep -q "ftype=1"
320 local dev=`$DF_PROG $dir | tail -1 | $AWK_PROG '{print $1}'`
321 tune2fs -l $dev | grep -q filetype
324 local testfile=$dir/$$.ftype
326 # look for DT_UNKNOWN files
327 local unknowns=$(src/t_dir_type $dir u | wc -l)
329 # 0 unknowns is success
335 # mount scratch device with given options but don't check mount status
338 if [ "$FSTYP" == "overlay" ]; then
339 _overlay_scratch_mount $*
342 _mount -t $FSTYP `_scratch_mount_options $*`
345 # mount scratch device with given options and _fail if mount fails
348 _try_scratch_mount $* || _fail "mount failed"
355 _overlay_scratch_unmount
358 $UMOUNT_PROG $SCRATCH_MNT
361 $UMOUNT_PROG $SCRATCH_DEV
370 if test -n "$opts"; then
371 mount -o "remount,$opts" $SCRATCH_MNT
375 _scratch_cycle_mount()
379 if [ "$FSTYP" = tmpfs ]; then
380 _scratch_remount "$opts"
383 if test -n "$opts"; then
387 _try_scratch_mount "$opts" || _fail "cycle mount failed"
392 if [ $FSTYP = "overlay" ]; then
393 # In lagacy overlay usage, it may specify directory as
394 # SCRATCH_DEV, in this case OVL_BASE_SCRATCH_DEV
395 # will be null, so check OVL_BASE_SCRATCH_DEV before
396 # running shutdown to avoid shutting down base fs accidently.
397 if [ -z $OVL_BASE_SCRATCH_DEV ]; then
398 _fail "_scratch_shutdown: call _require_scratch_shutdown first in test"
400 src/godown $* $OVL_BASE_SCRATCH_MNT
403 src/godown $* $SCRATCH_MNT
409 if [ "$FSTYP" == "overlay" ]; then
410 _overlay_test_mount $*
414 _mount -t $FSTYP $TEST_OPTIONS $TEST_FS_MOUNT_OPTS $SELINUX_MOUNT_OPTIONS $* $TEST_DEV $TEST_DIR
419 if [ "$FSTYP" == "overlay" ]; then
420 _overlay_test_unmount
422 $UMOUNT_PROG $TEST_DEV
428 if [ "$FSTYP" = tmpfs ]; then
435 _scratch_mkfs_options()
437 _scratch_options mkfs
438 echo $SCRATCH_OPTIONS $MKFS_OPTIONS $* $SCRATCH_DEV
441 # Do the actual mkfs work on SCRATCH_DEV. Firstly mkfs with both MKFS_OPTIONS
442 # and user specified mkfs options, if that fails (due to conflicts between mkfs
443 # options), do a second mkfs with only user provided mkfs options.
445 # First param is the mkfs command without any mkfs options and device.
446 # Second param is the filter to remove unnecessary messages from mkfs stderr.
447 # Other extra mkfs options are followed.
453 local extra_mkfs_options=$*
455 local tmp=`mktemp -u`
457 # save mkfs output in case conflict means we need to run again.
458 # only the output for the mkfs that applies should be shown
459 eval "$mkfs_cmd $MKFS_OPTIONS $extra_mkfs_options $SCRATCH_DEV" \
460 2>$tmp.mkfserr 1>$tmp.mkfsstd
463 # a mkfs failure may be caused by conflicts between $MKFS_OPTIONS and
464 # $extra_mkfs_options
465 if [ $mkfs_status -ne 0 -a -n "$extra_mkfs_options" ]; then
467 echo -n "** mkfs failed with extra mkfs options "
468 echo "added to \"$MKFS_OPTIONS\" by test $seq **"
469 echo -n "** attempting to mkfs using only test $seq "
470 echo "options: $extra_mkfs_options **"
473 # running mkfs again. overwrite previous mkfs output files
474 eval "$mkfs_cmd $extra_mkfs_options $SCRATCH_DEV" \
475 2>$tmp.mkfserr 1>$tmp.mkfsstd
479 # output stored mkfs output, filtering unnecessary output from stderr
481 eval "cat $tmp.mkfserr | $mkfs_filter" >&2
483 rm -f $tmp.mkfserr $tmp.mkfsstd
493 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
494 options="-l $SCRATCH_LOGDEV"
496 xfs_metadump $options "$@" $SCRATCH_DEV $dumpfile
499 _setup_large_ext4_fs()
504 [ "$LARGE_SCRATCH_DEV" != yes ] && return 0
505 [ -z "$SCRATCH_DEV_EMPTY_SPACE" ] && SCRATCH_DEV_EMPTY_SPACE=0
506 [ $SCRATCH_DEV_EMPTY_SPACE -ge $fs_size ] && return 0
508 # Default free space in the FS is 50GB, but you can specify more via
509 # SCRATCH_DEV_EMPTY_SPACE
510 local space_to_consume=$(($fs_size - 50*1024*1024*1024 - $SCRATCH_DEV_EMPTY_SPACE))
512 # mount the filesystem and create 16TB - 4KB files until we consume
513 # all the necessary space.
514 _try_scratch_mount 2>&1 >$tmp_dir/mnt.err
516 if [ $status -ne 0 ]; then
518 cat $tmp_dir/mnt.err >&2
519 rm -f $tmp_dir/mnt.err
522 rm -f $tmp_dir/mnt.err
524 local file_size=$((16*1024*1024*1024*1024 - 4096))
526 while [ $space_to_consume -gt $file_size ]; do
529 -c "truncate $file_size" \
530 -c "falloc -k 0 $file_size" \
531 $SCRATCH_MNT/.use_space.$nfiles 2>&1
533 if [ $status -ne 0 ]; then
537 space_to_consume=$(( $space_to_consume - $file_size ))
538 nfiles=$(($nfiles + 1))
541 # consume the remaining space.
542 if [ $space_to_consume -gt 0 ]; then
544 -c "truncate $space_to_consume" \
545 -c "falloc -k 0 $space_to_consume" \
546 $SCRATCH_MNT/.use_space.$nfiles 2>&1
549 export NUM_SPACE_FILES=$nfiles
552 if [ $status -ne 0 ]; then
553 echo "large file prealloc failed"
554 cat $tmp_dir/mnt.err >&2
562 local mkfs_cmd="$MKFS_EXT4_PROG -F"
563 local mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
564 local tmp=`mktemp -u`
567 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
568 $mkfs_cmd -O journal_dev $MKFS_OPTIONS $SCRATCH_LOGDEV && \
569 mkfs_cmd="$mkfs_cmd -J device=$SCRATCH_LOGDEV"
571 _scratch_do_mkfs "$mkfs_cmd" "$mkfs_filter" $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
574 if [ $mkfs_status -eq 0 -a "$LARGE_SCRATCH_DEV" = yes ]; then
575 # manually parse the mkfs output to get the fs size in bytes
576 local fs_size=`cat $tmp.mkfsstd | awk ' \
577 /^Block size/ { split($2, a, "="); bs = a[2] ; } \
578 / inodes, / { blks = $3 } \
579 /reserved for the super user/ { resv = $1 } \
580 END { fssize = bs * blks - resv; print fssize }'`
582 _setup_large_ext4_fs $fs_size
586 # output mkfs stdout and stderr
589 rm -f $tmp.mkfserr $tmp.mkfsstd
601 # do nothing for cifs
607 # do nothing for ceph
610 # do nothing for glusterfs
613 # do nothing for overlay
616 # do nothing for pvfs2
619 $MKFS_UDF_PROG $MKFS_OPTIONS $* $TEST_DEV > /dev/null
622 $MKFS_BTRFS_PROG $MKFS_OPTIONS $* $TEST_DEV > /dev/null
625 $MKFS_PROG -t $FSTYP -- -F $MKFS_OPTIONS $* $TEST_DEV
628 yes | $MKFS_PROG -t $FSTYP -- $MKFS_OPTIONS $* $TEST_DEV
635 local tmp=`mktemp -u`
644 # do nothing for overlay
647 # do nothing for pvfs2
650 $MKFS_UDF_PROG $MKFS_OPTIONS $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
653 $MKFS_BTRFS_PROG $MKFS_OPTIONS $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
656 $MKFS_PROG -t $FSTYP -- -F $MKFS_OPTIONS $* \
657 2>$tmp.mkfserr 1>$tmp.mkfsstd
660 $MKFS_PROG -t $FSTYP -- -f $MKFS_OPTIONS $* \
661 2>$tmp.mkfserr 1>$tmp.mkfsstd
664 yes | $MKFS_PROG -t $FSTYP -- $MKFS_OPTIONS $* \
665 2>$tmp.mkfserr 1>$tmp.mkfsstd
669 if [ $? -ne 0 ]; then
670 # output stored mkfs output
676 rm -f $tmp.mkfserr $tmp.mkfsstd
679 # remove all files in $SCRATCH_MNT, useful when testing on NFS/CIFS
680 _scratch_cleanup_files()
684 # Avoid rm -rf /* if we messed up
685 [ -n "$OVL_BASE_SCRATCH_MNT" ] || return 1
686 _overlay_base_scratch_mount || return 1
687 rm -rf $OVL_BASE_SCRATCH_MNT/* || return 1
688 _overlay_mkdirs $OVL_BASE_SCRATCH_MNT
689 # leave base fs mouted so tests can setup lower/upper dir files
692 [ -n "$SCRATCH_MNT" ] || return 1
694 rm -rf $SCRATCH_MNT/*
707 nfs*|cifs|ceph|overlay|glusterfs|pvfs2|9p)
708 # unable to re-create this fstyp, just remove all files in
709 # $SCRATCH_MNT to avoid EEXIST caused by the leftover files
710 # created in previous runs
711 _scratch_cleanup_files
715 # do nothing for tmpfs
719 # erase the UBI volume; reformated automatically on next mount
720 $UBIUPDATEVOL_PROG ${SCRATCH_DEV} -t
724 _scratch_mkfs_ext4 $*
732 mkfs_cmd="$MKFS_UDF_PROG"
736 mkfs_cmd="$MKFS_BTRFS_PROG"
740 mkfs_cmd="$MKFS_PROG -t $FSTYP -- -F"
741 mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
743 # put journal on separate device?
744 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
745 $mkfs_cmd -O journal_dev $MKFS_OPTIONS $SCRATCH_LOGDEV && \
746 mkfs_cmd="$mkfs_cmd -J device=$SCRATCH_LOGDEV"
749 mkfs_cmd="$MKFS_PROG -t $FSTYP -- -F"
750 mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
753 mkfs_cmd="$MKFS_F2FS_PROG"
757 mkfs_cmd="yes | $MKFS_PROG -t $FSTYP --"
758 mkfs_filter="grep -v -e ^mkfs\.ocfs2"
761 mkfs_cmd="yes | $MKFS_PROG -t $FSTYP --"
766 _scratch_do_mkfs "$mkfs_cmd" "$mkfs_filter" $*
770 # Helper function to get a spare or replace-target device from
771 # configured SCRATCH_DEV_POLL, must call _scratch_dev_pool_get()
772 # before _spare_dev_get(). Replace-target-device/Spare-device will
773 # be assigned to SPARE_DEV.
774 # As of now only one replace-target-device/spare-device can be
778 # _scratch_dev_pool_get() <ndevs>
782 # _scratch_dev_pool_put()
786 typeset -p SCRATCH_DEV_POOL_SAVED >/dev/null 2>&1
787 if [ $? -ne 0 ]; then
788 _fail "Bug: unset val, must call _scratch_dev_pool_get before _spare_dev_get"
791 if [ -z "$SCRATCH_DEV_POOL_SAVED" ]; then
792 _fail "Bug: str empty, must call _scratch_dev_pool_get before _spare_dev_get"
795 # Check if the spare is already assigned
796 typeset -p SPARE_DEV >/dev/null 2>&1
797 if [ $? -eq 0 ]; then
798 if [ ! -z "$SPARE_DEV" ]; then
799 _fail "Bug: SPARE_DEV = $SPARE_DEV already assigned"
803 local ndevs=`echo $SCRATCH_DEV_POOL| wc -w`
804 local config_ndevs=`echo $SCRATCH_DEV_POOL_SAVED| wc -w`
806 if [ $ndevs -eq $config_ndevs ]; then
807 _notrun "All devs used no spare"
809 # Get a dev that is not used
810 local -a devs="( $SCRATCH_DEV_POOL_SAVED )"
811 SPARE_DEV=${devs[@]:$ndevs:1}
817 typeset -p SPARE_DEV >/dev/null 2>&1
818 if [ $? -ne 0 ]; then
819 _fail "Bug: unset val, must call _spare_dev_get before its put"
822 if [ -z "$SPARE_DEV" ]; then
823 _fail "Bug: str empty, must call _spare_dev_get before its put"
830 # Generally test cases will have..
831 # _require_scratch_dev_pool X
832 # to make sure it has the enough scratch devices including
833 # replace-target and spare device. Now arg1 here is the
834 # required number of scratch devices by a-test-case excluding
835 # the replace-target and spare device. So this function will
836 # set SCRATCH_DEV_POOL to the specified number of devices.
839 # _scratch_dev_pool_get() <ndevs>
842 # _scratch_dev_pool_put()
844 _scratch_dev_pool_get()
846 if [ $# -ne 1 ]; then
847 _fail "Usage: _scratch_dev_pool_get ndevs"
851 local config_ndevs=`echo $SCRATCH_DEV_POOL| wc -w`
852 local -a devs="( $SCRATCH_DEV_POOL )"
854 typeset -p config_ndevs >/dev/null 2>&1
855 if [ $? -ne 0 ]; then
856 _fail "Bug: cant find SCRATCH_DEV_POOL ndevs"
859 if [ $config_ndevs -lt $test_ndevs ]; then
860 _notrun "Need at least test requested number of ndevs $test_ndevs"
863 SCRATCH_DEV_POOL_SAVED=${SCRATCH_DEV_POOL}
864 export SCRATCH_DEV_POOL_SAVED
865 SCRATCH_DEV_POOL=${devs[@]:0:$test_ndevs}
866 export SCRATCH_DEV_POOL
869 _scratch_dev_pool_put()
871 typeset -p SCRATCH_DEV_POOL_SAVED >/dev/null 2>&1
872 if [ $? -ne 0 ]; then
873 _fail "Bug: unset val, must call _scratch_dev_pool_get before _scratch_dev_pool_put"
876 if [ -z "$SCRATCH_DEV_POOL_SAVED" ]; then
877 _fail "Bug: str empty, must call _scratch_dev_pool_get before _scratch_dev_pool_put"
880 export SCRATCH_DEV_POOL=$SCRATCH_DEV_POOL_SAVED
881 export SCRATCH_DEV_POOL_SAVED=""
888 # if dup profile is in mkfs options call _scratch_mkfs instead
889 # because dup profile only works with single device
890 if [[ "$*" =~ dup ]]; then
893 $MKFS_BTRFS_PROG $MKFS_OPTIONS $* $SCRATCH_DEV_POOL > /dev/null
897 echo "_scratch_pool_mkfs is not implemented for $FSTYP" 1>&2
902 # Return the amount of free memory available on the system
905 free -b | grep ^Mem | awk '{print $4}'
908 # Create fs of certain size on scratch device
909 # _scratch_mkfs_sized <size in bytes> [optional blocksize]
910 _scratch_mkfs_sized()
918 def_blksz=`echo $MKFS_OPTIONS|sed -rn 's/.*-b ?size= ?+([0-9]+).*/\1/p'`
920 ext2|ext3|ext4|ext4dev|udf|btrfs|reiser4|ocfs2|reiserfs)
921 def_blksz=`echo $MKFS_OPTIONS| sed -rn 's/.*-b ?+([0-9]+).*/\1/p'`
928 [ -n "$def_blksz" ] && blocksize=$def_blksz
929 [ -z "$blocksize" ] && blocksize=4096
933 if ! [[ $fssize =~ $re ]] ; then
934 _notrun "error: _scratch_mkfs_sized: fs size \"$fssize\" not an integer."
936 if ! [[ $blocksize =~ $re ]] ; then
937 _notrun "error: _scratch_mkfs_sized: block size \"$blocksize\" not an integer."
940 local blocks=`expr $fssize / $blocksize`
942 if [ "$HOSTOS" == "Linux" -a -b "$SCRATCH_DEV" ]; then
943 local devsize=`blockdev --getsize64 $SCRATCH_DEV`
944 [ "$fssize" -gt "$devsize" ] && _notrun "Scratch device too small"
949 # don't override MKFS_OPTIONS that set a block size.
950 echo $MKFS_OPTIONS |egrep -q "b?size="
951 if [ $? -eq 0 ]; then
952 _scratch_mkfs_xfs -d size=$fssize
954 _scratch_mkfs_xfs -d size=$fssize -b size=$blocksize
957 ext2|ext3|ext4|ext4dev)
958 ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
961 # mkfs.gfs2 doesn't automatically shrink journal files on small
962 # filesystems, so the journal files may end up being bigger than the
963 # filesystem, which will cause mkfs.gfs2 to fail. Until that's fixed,
964 # shrink the journal size to at most one eigth of the filesystem and at
965 # least 8 MiB, the minimum size allowed.
966 local min_journal_size=8
967 local default_journal_size=128
968 if (( fssize/8 / (1024*1024) < default_journal_size )); then
969 local journal_size=$(( fssize/8 / (1024*1024) ))
970 (( journal_size >= min_journal_size )) || journal_size=$min_journal_size
971 MKFS_OPTIONS="-J $journal_size $MKFS_OPTIONS"
973 ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -O -b $blocksize $SCRATCH_DEV $blocks
976 yes | ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
979 $MKFS_UDF_PROG $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
983 (( fssize <= 1024 * 1024 * 1024 )) && mixed_opt='--mixed'
984 $MKFS_BTRFS_PROG $MKFS_OPTIONS $mixed_opt -b $fssize $SCRATCH_DEV
987 ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS $SCRATCH_DEV $blocks
990 ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
993 # mkfs.resier4 requires size in KB as input for creating filesystem
994 $MKFS_REISER4_PROG $MKFS_OPTIONS -y -b $blocksize $SCRATCH_DEV \
995 `expr $fssize / 1024`
998 # mkfs.f2fs requires # of sectors as an input for the size
999 local sector_size=`blockdev --getss $SCRATCH_DEV`
1000 $MKFS_F2FS_PROG $MKFS_OPTIONS $SCRATCH_DEV `expr $fssize / $sector_size`
1003 local free_mem=`_free_memory_bytes`
1004 if [ "$free_mem" -lt "$fssize" ] ; then
1005 _notrun "Not enough memory ($free_mem) for tmpfs with $fssize bytes"
1007 export MOUNT_OPTIONS="-o size=$fssize $TMPFS_MOUNT_OPTIONS"
1010 _notrun "Filesystem $FSTYP not supported in _scratch_mkfs_sized"
1015 # Emulate an N-data-disk stripe w/ various stripe units
1016 # _scratch_mkfs_geom <sunit bytes> <swidth multiplier> [optional blocksize]
1017 _scratch_mkfs_geom()
1019 local sunit_bytes=$1
1020 local swidth_mult=$2
1022 [ -z "$blocksize" ] && blocksize=4096
1024 local sunit_blocks=$(( sunit_bytes / blocksize ))
1025 local swidth_blocks=$(( sunit_blocks * swidth_mult ))
1029 MKFS_OPTIONS+=" -b size=$blocksize, -d su=$sunit_bytes,sw=$swidth_mult"
1032 MKFS_OPTIONS+=" -b $blocksize -E stride=$sunit_blocks,stripe_width=$swidth_blocks"
1035 _notrun "can't mkfs $FSTYP with geometry"
1041 # Create fs of certain blocksize on scratch device
1042 # _scratch_mkfs_blocksized blocksize
1043 _scratch_mkfs_blocksized()
1048 if ! [[ $blocksize =~ $re ]] ; then
1049 _notrun "error: _scratch_mkfs_sized: block size \"$blocksize\" not an integer."
1054 _scratch_mkfs_xfs $MKFS_OPTIONS -b size=$blocksize
1057 ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV
1060 ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -O -b $blocksize $SCRATCH_DEV
1063 yes | ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize -C $blocksize $SCRATCH_DEV
1066 _notrun "Filesystem $FSTYP not supported in _scratch_mkfs_blocksized"
1075 xfs_io -x -c "resblks $1" $SCRATCH_MNT
1083 # Repair scratch filesystem. Returns 0 if the FS is good to go (either no
1084 # errors found or errors were fixed) and nonzero otherwise; also spits out
1085 # a complaint on stderr if fsck didn't tell us that the FS is good to go.
1086 _repair_scratch_fs()
1090 _scratch_xfs_repair "$@" 2>&1
1092 if [ "$res" -ne 0 ]; then
1093 echo "xfs_repair returns $res; replay log?"
1096 if [ "$res" -gt 0 ]; then
1097 echo "mount returns $res; zap log?"
1098 _scratch_xfs_repair -L 2>&1
1099 echo "log zap returns $?"
1101 umount "$SCRATCH_MNT"
1103 _scratch_xfs_repair "$@" 2>&1
1106 if [ $res -ne 0 ]; then
1107 _dump_err2 "xfs_repair failed, err=$res"
1112 # Let's hope fsck -y suffices...
1113 fsck -t $FSTYP -y $SCRATCH_DEV 2>&1
1120 _dump_err2 "fsck.$FSTYP failed, err=$res"
1132 echo "Usage: _get_pids_by_name process-name" 1>&2
1136 # Algorithm ... all ps(1) variants have a time of the form MM:SS or
1137 # HH:MM:SS before the psargs field, use this as the search anchor.
1139 # Matches with $1 (process-name) occur if the first psarg is $1
1140 # or ends in /$1 ... the matching uses sed's regular expressions,
1141 # so passing a regex into $1 will work.
1146 -e 's/[ ][ ]*/ /g' \
1149 -e "/[0-9]:[0-9][0-9] *[^ ]*\/$1 /s/ .*//p" \
1150 -e "/[0-9]:[0-9][0-9] *$1 /s/ .*//p"
1154 # _df_device : get an IRIX style df line for a given device
1156 # - returns "" if not mounted
1157 # - returns fs type in field two (ala IRIX)
1158 # - joins line together if split by fancy df formatting
1159 # - strips header etc
1166 echo "Usage: _df_device device" 1>&2
1170 # Note that we use "==" here so awk doesn't try to interpret an NFS over
1171 # IPv6 server as a regular expression.
1172 $DF_PROG 2>/dev/null | $AWK_PROG -v what=$1 '
1173 ($1==what) && (NF==1) {
1187 # _df_dir : get an IRIX style df line for device where a directory resides
1189 # - returns fs type in field two (ala IRIX)
1190 # - joins line together if split by fancy df formatting
1191 # - strips header etc
1198 echo "Usage: _df_dir device" 1>&2
1202 $DF_PROG $1 2>/dev/null | $AWK_PROG -v what=$1 '
1218 # return percentage used disk space for mounted device
1224 echo "Usage: _used device" 1>&2
1228 _df_device $1 | $AWK_PROG '{ sub("%", "") ; print $6 }'
1231 # return the FS type of a mounted device
1237 echo "Usage: _fs_type device" 1>&2
1242 # The Linux kernel shows NFSv4 filesystems in df output as
1243 # filesystem type nfs4, although we mounted it as nfs earlier.
1244 # Fix the filesystem type up here so that the callers don't
1245 # have to bother with this quirk.
1247 _df_device $1 | $AWK_PROG '{ print $2 }' | \
1248 sed -e 's/nfs4/nfs/' -e 's/fuse.glusterfs/glusterfs/'
1251 # return the FS mount options of a mounted device
1253 # should write a version which just parses the output of mount for IRIX
1254 # compatibility, but since this isn't used at all, at the moment I'll leave
1261 echo "Usage: _fs_options device" 1>&2
1265 $AWK_PROG -v dev=$1 '
1266 match($1,dev) { print $4 }
1270 # returns device number if a file is a block device
1276 echo "Usage: _is_block_dev dev" 1>&2
1281 if [ -L "$dev" ]; then
1282 dev=`readlink -f "$dev"`
1285 if [ -b "$dev" ]; then
1286 src/lstat64 "$dev" | $AWK_PROG '/Device type:/ { print $9 }'
1290 # returns device number if a file is a character device
1294 if [ $# -ne 1 ]; then
1295 echo "Usage: _is_char_dev dev" 1>&2
1300 if [ -L "$dev" ]; then
1301 dev=`readlink -f "$dev"`
1304 if [ -c "$dev" ]; then
1305 src/lstat64 "$dev" | $AWK_PROG '/Device type:/ { print $9 }'
1309 # Do a command, log it to $seqres.full, optionally test return status
1310 # and die if command fails. If called with one argument _do executes the
1311 # command, logs it, and returns its exit status. With two arguments _do
1312 # first prints the message passed in the first argument, and then "done"
1313 # or "fail" depending on the return status of the command passed in the
1314 # second argument. If the command fails and the variable _do_die_on_error
1315 # is set to "always" or the two argument form is used and _do_die_on_error
1316 # is set to "message_only" _do will print an error message to
1317 # $seqres.out and exit.
1321 if [ $# -eq 1 ]; then
1323 elif [ $# -eq 2 ]; then
1328 echo "Usage: _do [note] cmd" 1>&2
1332 (eval "echo '---' \"$cmd\"") >>$seqres.full
1333 (eval "$cmd") >$tmp._out 2>&1
1335 cat $tmp._out >>$seqres.full
1337 if [ $# -eq 2 ]; then
1338 if [ $ret -eq 0 ]; then
1345 && [ "$_do_die_on_error" = "always" \
1346 -o \( $# -eq 2 -a "$_do_die_on_error" = "message_only" \) ]
1348 [ $# -ne 2 ] && echo
1349 eval "echo \"$cmd\" failed \(returned $ret\): see $seqres.full"
1356 # bail out, setting up .notrun file. Need to kill the filesystem check files
1357 # here, otherwise they are set incorrectly for the next test.
1361 echo "$*" > $seqres.notrun
1362 echo "$seq not run: $*"
1363 rm -f ${RESULT_DIR}/require_test*
1364 rm -f ${RESULT_DIR}/require_scratch*
1370 # just plain bail out
1374 echo "$*" | tee -a $seqres.full
1375 echo "(see $seqres.full for details)"
1380 # tests whether $FSTYP is one of the supported filesystems for a test
1388 if [ "$f" = "$FSTYP" -o "$f" = "generic" ]
1394 _notrun "not suitable for this filesystem type: $FSTYP"
1398 # tests whether $FSTYP is one of the supported OSes for a test
1406 if [ "$h" = "$HOSTOS" ]
1412 _notrun "not suitable for this OS: $HOSTOS"
1415 # check if a FS on a device is mounted
1416 # if so, verify that it is mounted on mount point
1417 # if fstype is given as argument, verify that it is also
1418 # mounted with correct fs type
1428 # find $dev as the source, and print result in "$dev $mnt" format
1429 local mount_rec=`findmnt -rncv -S $dev -o SOURCE,TARGET`
1430 [ -n "$mount_rec" ] || return 1 # 1 = not mounted
1432 # if it's mounted, make sure its on $mnt
1433 if [ "$mount_rec" != "$dev $mnt" ]; then
1434 echo "$devname=$dev is mounted but not on $mntname=$mnt - aborting"
1435 echo "Already mounted result:"
1437 return 2 # 2 = mounted on wrong mnt
1440 if [ -n "$type" -a "`_fs_type $dev`" != "$type" ]; then
1441 echo "$devname=$dev is mounted but not a type $type filesystem"
1442 # raw $DF_PROG cannot handle NFS/CIFS/overlay correctly
1444 return 3 # 3 = mounted as wrong type
1446 return 0 # 0 = mounted as expected
1449 # this test needs a scratch partition - check we're ok & unmount it
1450 # No post-test check of the device is required. e.g. the test intentionally
1451 # finishes the test with the filesystem in a corrupt state
1452 _require_scratch_nocheck()
1456 echo $SCRATCH_DEV | egrep -q ":/?" > /dev/null 2>&1
1457 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1458 _notrun "this test requires a valid \$SCRATCH_DEV"
1460 if [ ! -d "$SCRATCH_MNT" ]; then
1461 _notrun "this test requires a valid \$SCRATCH_MNT"
1465 if [ -z "$SCRATCH_DEV" ]; then
1466 _notrun "this test requires a valid \$SCRATCH_DEV"
1468 if [ ! -d "$SCRATCH_MNT" ]; then
1469 _notrun "this test requires a valid \$SCRATCH_MNT"
1473 echo $SCRATCH_DEV | grep -q ":/" > /dev/null 2>&1
1474 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1475 _notrun "this test requires a valid \$SCRATCH_DEV"
1477 if [ ! -d "$SCRATCH_MNT" ]; then
1478 _notrun "this test requires a valid \$SCRATCH_MNT"
1482 echo $SCRATCH_DEV | grep -q "://" > /dev/null 2>&1
1483 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1484 _notrun "this test requires a valid \$SCRATCH_DEV"
1486 if [ ! -d "$SCRATCH_MNT" ]; then
1487 _notrun "this test requires a valid \$SCRATCH_MNT"
1491 echo $SCRATCH_DEV | grep -q "//" > /dev/null 2>&1
1492 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1493 _notrun "this test requires a valid \$SCRATCH_DEV"
1495 if [ ! -d "$SCRATCH_MNT" ]; then
1496 _notrun "this test requires a valid \$SCRATCH_MNT"
1500 if [ -z "$OVL_BASE_SCRATCH_MNT" -o ! -d "$OVL_BASE_SCRATCH_MNT" ]; then
1501 _notrun "this test requires a valid \$OVL_BASE_SCRATCH_MNT as ovl base dir"
1503 # if $SCRATCH_MNT is derived from $OVL_BASE_SCRATCH_MNT then
1504 # don't check $SCRATCH_MNT dir here because base fs may not be mounted
1505 # and we will create the mount point anyway on _overlay_mount
1506 if [ "$SCRATCH_MNT" != "$OVL_BASE_SCRATCH_MNT/$OVL_MNT" -a ! -d "$SCRATCH_MNT" ]; then
1507 _notrun "this test requires a valid \$SCRATCH_MNT"
1511 if [ -z "$SCRATCH_DEV" -o ! -d "$SCRATCH_MNT" ];
1513 _notrun "this test requires a valid \$SCRATCH_MNT and unique $SCRATCH_DEV"
1517 # ubifs needs an UBI volume. This will be a char device, not a block device.
1518 if [ ! -c "$SCRATCH_DEV" ]; then
1519 _notrun "this test requires a valid UBI volume for \$SCRATCH_DEV"
1521 if [ ! -d "$SCRATCH_MNT" ]; then
1522 _notrun "this test requires a valid \$SCRATCH_MNT"
1526 if [ -z "$SCRATCH_DEV" -o "`_is_block_dev "$SCRATCH_DEV"`" = "" ]
1528 _notrun "this test requires a valid \$SCRATCH_DEV"
1530 if [ "`_is_block_dev "$SCRATCH_DEV"`" = "`_is_block_dev "$TEST_DEV"`" ]
1532 _notrun "this test requires a valid \$SCRATCH_DEV"
1534 if [ ! -d "$SCRATCH_MNT" ]
1536 _notrun "this test requires a valid \$SCRATCH_MNT"
1541 _check_mounted_on SCRATCH_DEV $SCRATCH_DEV SCRATCH_MNT $SCRATCH_MNT
1543 [ $err -le 1 ] || exit 1
1546 # if it's mounted, unmount it
1547 if ! _scratch_unmount
1549 echo "failed to unmount $SCRATCH_DEV"
1553 rm -f ${RESULT_DIR}/require_scratch
1556 # we need the scratch device and it should be checked post test.
1559 _require_scratch_nocheck
1560 touch ${RESULT_DIR}/require_scratch
1563 # require a scratch dev of a minimum size (in kb)
1564 _require_scratch_size()
1566 [ $# -eq 1 ] || _fail "_require_scratch_size: expected size param"
1569 local devsize=`_get_device_size $SCRATCH_DEV`
1570 [ $devsize -lt $1 ] && _notrun "scratch dev too small"
1574 # this test needs a test partition - check we're ok & mount it
1580 echo $TEST_DEV | egrep -q ":/?" > /dev/null 2>&1
1581 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1582 _notrun "this test requires a valid \$TEST_DEV"
1584 if [ ! -d "$TEST_DIR" ]; then
1585 _notrun "this test requires a valid \$TEST_DIR"
1589 if [ -z "$TEST_DEV" ]; then
1590 _notrun "this test requires a valid \$TEST_DEV"
1592 if [ ! -d "$TEST_DIR" ]; then
1593 _notrun "this test requires a valid \$TEST_DIR"
1597 echo $TEST_DEV | grep -q ":/" > /dev/null 2>&1
1598 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1599 _notrun "this test requires a valid \$TEST_DEV"
1601 if [ ! -d "$TEST_DIR" ]; then
1602 _notrun "this test requires a valid \$TEST_DIR"
1606 echo $TEST_DEV | grep -q "//" > /dev/null 2>&1
1607 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1608 _notrun "this test requires a valid \$TEST_DEV"
1610 if [ ! -d "$TEST_DIR" ]; then
1611 _notrun "this test requires a valid \$TEST_DIR"
1615 echo $TEST_DEV | grep -q "://" > /dev/null 2>&1
1616 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1617 _notrun "this test requires a valid \$TEST_DIR"
1619 if [ ! -d "$TEST_DIR" ]; then
1620 _notrun "this test requires a valid \$TEST_DIR"
1624 if [ -z "$OVL_BASE_TEST_DIR" -o ! -d "$OVL_BASE_TEST_DIR" ]; then
1625 _notrun "this test requires a valid \$TEST_DIR as ovl base dir"
1627 if [ ! -d "$TEST_DIR" ]; then
1628 _notrun "this test requires a valid \$TEST_DIR"
1632 if [ -z "$TEST_DEV" -o ! -d "$TEST_DIR" ];
1634 _notrun "this test requires a valid \$TEST_DIR and unique $TEST_DEV"
1638 # ubifs needs an UBI volume. This will be a char device, not a block device.
1639 if [ ! -c "$TEST_DEV" ]; then
1640 _notrun "this test requires a valid UBI volume for \$TEST_DEV"
1642 if [ ! -d "$TEST_DIR" ]; then
1643 _notrun "this test requires a valid \$TEST_DIR"
1647 if [ -z "$TEST_DEV" ] || [ "`_is_block_dev "$TEST_DEV"`" = "" ]
1649 _notrun "this test requires a valid \$TEST_DEV"
1651 if [ "`_is_block_dev "$SCRATCH_DEV"`" = "`_is_block_dev "$TEST_DEV"`" ]
1653 _notrun "this test requires a valid \$TEST_DEV"
1655 if [ ! -d "$TEST_DIR" ]
1657 _notrun "this test requires a valid \$TEST_DIR"
1662 _check_mounted_on TEST_DEV $TEST_DEV TEST_DIR $TEST_DIR
1664 [ $err -le 1 ] || exit 1
1669 echo "!!! failed to mount $TEST_DEV on $TEST_DIR"
1673 touch ${RESULT_DIR}/require_test
1679 [ -z "$SCRATCH_LOGDEV" -o ! -b "$SCRATCH_LOGDEV" ] && ret=1
1680 [ "$USE_EXTERNAL" != yes ] && ret=1
1685 # this test needs a logdev
1689 [ -z "$SCRATCH_LOGDEV" -o ! -b "$SCRATCH_LOGDEV" ] && \
1690 _notrun "This test requires a valid \$SCRATCH_LOGDEV"
1691 [ "$USE_EXTERNAL" != yes ] && \
1692 _notrun "This test requires USE_EXTERNAL to be enabled"
1694 # ensure its not mounted
1695 $UMOUNT_PROG $SCRATCH_LOGDEV 2>/dev/null
1698 # this test requires loopback device support
1702 if [ "$HOSTOS" != "Linux" ]
1704 _notrun "This test requires linux for loopback device support"
1707 modprobe loop >/dev/null 2>&1
1708 if grep loop /proc/devices >/dev/null 2>&1
1712 _notrun "This test requires loopback device support"
1716 # this test requires ext2 filesystem support
1720 if [ "$HOSTOS" != "Linux" ]
1722 _notrun "This test requires linux for ext2 filesystem support"
1725 modprobe ext2 >/dev/null 2>&1
1726 if grep ext2 /proc/filesystems >/dev/null 2>&1
1730 _notrun "This test requires ext2 filesystem support"
1734 # this test requires tmpfs filesystem support
1738 modprobe tmpfs >/dev/null 2>&1
1739 grep -q tmpfs /proc/filesystems ||
1740 _notrun "this test requires tmpfs support"
1743 # this test requires that (large) loopback device files are not in use
1745 _require_no_large_scratch_dev()
1747 [ "$LARGE_SCRATCH_DEV" = yes ] && \
1748 _notrun "Large filesystem testing in progress, skipped this test"
1751 # this test requires that a realtime subvolume is in use, and
1752 # that the kernel supports realtime as well.
1756 [ "$USE_EXTERNAL" = yes ] || \
1757 _notrun "External volumes not in use, skipped this test"
1758 [ "$SCRATCH_RTDEV" = "" ] && \
1759 _notrun "Realtime device required, skipped this test"
1762 # This test requires that a realtime subvolume is not in use
1764 _require_no_realtime()
1766 [ "$USE_EXTERNAL" = "yes" ] && [ -n "$SCRATCH_RTDEV" ] && \
1767 _notrun "Test not compatible with realtime subvolumes, skipped this test"
1770 # this test requires that a specified command (executable) exists
1771 # $1 - command, $2 - name for error message
1773 # Note: the command string might have parameters, so strip them before checking
1774 # whether it is executable.
1777 if [ $# -eq 2 ]; then
1779 elif [ $# -eq 1 ]; then
1782 _fail "usage: _require_command <command> [<name>]"
1785 local command=`echo "$1" | awk '{ print $1 }'`
1786 if [ ! -x "$command" ]; then
1787 _notrun "$name utility required, skipped this test"
1791 # this test requires the device to be valid block device
1793 _require_block_device()
1795 if [ -z "$1" ]; then
1796 echo "Usage: _require_block_device <dev>" 1>&2
1799 if [ "`_is_block_dev "$1"`" == "" ]; then
1800 _notrun "require $1 to be valid block disk"
1804 # this test requires a path to refere to a local block or character device
1806 _require_local_device()
1808 if [ -z "$1" ]; then
1809 echo "Usage: _require_local_device <dev>" 1>&2
1812 if [ "`_is_block_dev "$1"`" != "" ]; then
1815 if [ "`_is_char_dev "$1"`" != "" ]; then
1818 _notrun "require $1 to be local device"
1821 # brd based ram disks erase the device when they receive a flush command when no
1822 # active references are present. This causes problems for DM devices sitting on
1823 # top of brd devices as DM doesn't hold active references to the brd device.
1824 _require_sane_bdev_flush()
1826 echo $1 | grep -q "^/dev/ram[0-9]\+$"
1827 if [ $? -eq 0 ]; then
1828 _notrun "This test requires a sane block device flush"
1832 # this test requires a specific device mapper target
1833 _require_dm_target()
1837 # require SCRATCH_DEV to be a valid block device with sane BLKFLSBUF
1839 _require_block_device $SCRATCH_DEV
1840 _require_sane_bdev_flush $SCRATCH_DEV
1841 _require_command "$DMSETUP_PROG" dmsetup
1843 modprobe dm-$target >/dev/null 2>&1
1845 $DMSETUP_PROG targets 2>&1 | grep -q ^$target
1846 if [ $? -ne 0 ]; then
1847 _notrun "This test requires dm $target support"
1851 # this test requires the ext4 kernel support crc feature on scratch device
1853 _require_scratch_ext4_crc()
1855 _scratch_mkfs_ext4 >/dev/null 2>&1
1856 dumpe2fs -h $SCRATCH_DEV 2> /dev/null | grep -q metadata_csum || _notrun "metadata_csum not supported by this filesystem"
1857 _try_scratch_mount >/dev/null 2>&1 \
1858 || _notrun "Kernel doesn't support metadata_csum feature"
1862 # Check whether the specified feature whether it is supported by
1863 # mkfs.ext4 and the kernel.
1864 _require_scratch_ext4_feature()
1866 if [ -z "$1" ]; then
1867 echo "Usage: _require_scratch_ext4_feature feature"
1870 $MKFS_EXT4_PROG -F $MKFS_OPTIONS -O "$1" \
1871 $SCRATCH_DEV 512m >/dev/null 2>&1 \
1872 || _notrun "mkfs.ext4 doesn't support $1 feature"
1873 _try_scratch_mount >/dev/null 2>&1 \
1874 || _notrun "Kernel doesn't support the ext4 feature(s): $1"
1878 # this test requires that external log/realtime devices are not in use
1880 _require_nonexternal()
1882 [ "$USE_EXTERNAL" = yes ] && \
1883 _notrun "External device testing in progress, skipped this test"
1886 # this test requires that the kernel supports asynchronous I/O
1889 $here/src/feature -A
1894 _notrun "kernel does not support asynchronous I/O"
1897 _fail "unexpected error testing for asynchronous I/O support"
1902 # this test requires that a (specified) aio-dio executable exists
1903 # and that the kernel supports asynchronous I/O.
1904 # $1 - command (optional)
1910 AIO_TEST=src/aio-dio-regress/aiodio_sparse2
1911 [ -x $AIO_TEST ] || _notrun "aio-dio utilities required"
1913 AIO_TEST=src/aio-dio-regress/$1
1914 [ -x $AIO_TEST ] || _notrun "$AIO_TEST not built"
1920 # this test requires that a test program exists under src/
1921 # $1 - command (require)
1923 _require_test_program()
1926 [ -x $prog ] || _notrun "$prog not built"
1929 # run an aio-dio program
1935 echo "usage: _run_aiodio command_name" 2>&1
1941 local testtemp=$TEST_DIR/aio-testfile
1943 $AIO_TEST $testtemp 2>&1
1950 # this test requires y2038 sysfs switch and filesystem
1951 # timestamp ranges support.
1954 local device=${1:-$TEST_DEV}
1955 local sysfsdir=/proc/sys/fs/fs-timestamp-check-on
1957 if [ ! -e $sysfsdir ]; then
1958 _notrun "no kernel support for y2038 sysfs switch"
1962 read tsmin tsmax <<<$(_filesystem_timestamp_range $device)
1963 if [ $tsmin -eq -1 -a $tsmax -eq -1 ]; then
1964 _notrun "filesystem $FSTYP timestamp bounds are unknown"
1968 _filesystem_timestamp_range()
1970 local device=${1:-$TEST_DEV}
1973 if [ $(dumpe2fs -h $device 2>/dev/null | grep "Inode size:" | cut -d: -f2) -gt 128 ]; then
1974 echo "-2147483648 15032385535"
1976 echo "-2147483648 2147483647"
1981 echo "-2147483648 2147483647"
1987 echo "-2147483648 2147483647"
1995 # indicate whether YP/NIS is active or not
2000 dn=$(domainname 2>/dev/null)
2001 local ypcat=$(type -P ypcat)
2002 test -n "${dn}" -a "${dn}" != "(none)" -a "${dn}" != "localdomain" -a -n "${ypcat}"
2006 # cat the password file
2010 [ $(_yp_active) -eq 0 ] && ypcat passwd
2014 # cat the group file
2018 [ $(_yp_active) -eq 0 ] && ypcat group
2022 # check for a user on the machine, fsgqa as default
2030 _cat_passwd | grep -q $qa_user
2031 [ "$?" == "0" ] || _notrun "$qa_user user not defined."
2032 echo /bin/true | su $qa_user
2033 [ "$?" == "0" ] || _notrun "$qa_user cannot execute commands."
2036 # check for a group on the machine, fsgqa as default
2044 _cat_group | grep -q $qa_group
2045 [ "$?" == "0" ] || _notrun "$qa_group group not defined."
2051 s,.*Permission\sdenied.*,Permission denied,;
2052 s,.*no\saccess\sto\stty.*,,;
2053 s,.*no\sjob\scontrol\sin\sthis\sshell.*,,;
2060 echo $1 | su -s /bin/bash $qa_user 2>&1 | _filter_user_do
2063 _require_xfs_io_command()
2067 echo "Usage: _require_xfs_io_command command [switch]" 1>&2
2073 local param_checked=0
2076 local testfile=$TEST_DIR/$$.xfs_io
2080 testio=`$XFS_IO_PROG -F -f -c "chproj 0" $testfile 2>&1`
2083 local testcopy=$TEST_DIR/$$.copy.xfs_io
2084 $XFS_IO_PROG -F -f -c "pwrite 0 4k" $testfile > /dev/null 2>&1
2085 testio=`$XFS_IO_PROG -F -f -c "copy_range $testfile" $testcopy 2>&1`
2086 rm -f $testcopy > /dev/null 2>&1
2089 testio=`$XFS_IO_PROG -F -f -c "falloc $param 0 1m" $testfile 2>&1`
2092 "fpunch" | "fcollapse" | "zero" | "fzero" | "finsert" | "funshare")
2093 local blocksize=$(_get_block_size $TEST_DIR)
2094 testio=`$XFS_IO_PROG -F -f -c "pwrite 0 $((5 * $blocksize))" \
2095 -c "fsync" -c "$command $blocksize $((2 * $blocksize))" \
2099 # If 'ranged' is passed as argument then we check to see if fiemap supports
2100 # ranged query params
2101 if echo "$param" | grep -q "ranged"; then
2102 param=$(echo "$param" | sed "s/ranged//")
2103 $XFS_IO_PROG -c "help fiemap" | grep -q "\[offset \[len\]\]"
2104 [ $? -eq 0 ] || _notrun "xfs_io $command ranged support is missing"
2106 testio=`$XFS_IO_PROG -F -f -c "pwrite 0 20k" -c "fsync" \
2107 -c "fiemap -v $param" $testfile 2>&1`
2111 local testlink=$TEST_DIR/$$.link.xfs_io
2112 testio=`$XFS_IO_PROG -F -f -c "flink $testlink" $testfile 2>&1`
2113 rm -f $testlink > /dev/null 2>&1
2116 # Check O_TMPFILE support in xfs_io, kernel and fs
2117 testio=`$XFS_IO_PROG -T -c quit $TEST_DIR 2>&1`
2118 echo $testio | egrep -q "invalid option|Is a directory" && \
2119 _notrun "xfs_io $command support is missing"
2120 echo $testio | grep -q "Operation not supported" && \
2121 _notrun "O_TMPFILE is not supported"
2124 testio=`$XFS_IO_PROG -f -c "fsmap" $testfile 2>&1`
2125 echo $testio | grep -q "Inappropriate ioctl" && \
2126 _notrun "xfs_io $command support is missing"
2129 testio=`$XFS_IO_PROG -c "label" $TEST_DIR 2>&1`
2132 # -c "open $f" is broken in xfs_io <= 4.8. Along with the fix,
2133 # a new -C flag was introduced to execute one shot commands.
2134 # Check for -C flag support as an indication for the bug fix.
2135 testio=`$XFS_IO_PROG -F -f -C "open $testfile" $testfile 2>&1`
2136 echo $testio | grep -q "invalid option" && \
2137 _notrun "xfs_io $command support is missing"
2140 # -N (RWF_NOWAIT) only works with direct vectored I/O writes
2141 local pwrite_opts=" "
2142 if [ "$param" == "-N" ]; then
2144 pwrite_opts+="-V 1 -b 4k"
2146 testio=`$XFS_IO_PROG -f $opts -c \
2147 "pwrite $pwrite_opts $param 0 4k" $testfile 2>&1`
2151 testio=`$XFS_IO_PROG -x -c "$command probe 0" $TEST_DIR 2>&1`
2152 echo $testio | grep -q "Inappropriate ioctl" && \
2153 _notrun "xfs_io $command support is missing"
2156 testio=`$XFS_IO_PROG -f -c "utimes" 0 0 0 0 $testfile 2>&1`
2160 testio=`$XFS_IO_PROG -c "syncfs" $testfile 2>&1`
2163 testio=`$XFS_IO_PROG -c "help $command" 2>&1`
2166 rm -f $testfile 2>&1 > /dev/null
2167 echo $testio | grep -q "not found" && \
2168 _notrun "xfs_io $command support is missing"
2169 echo $testio | grep -q "Operation not supported\|Inappropriate ioctl" && \
2170 _notrun "xfs_io $command failed (old kernel/wrong fs?)"
2171 echo $testio | grep -q "Invalid" && \
2172 _notrun "xfs_io $command failed (old kernel/wrong fs/bad args?)"
2173 echo $testio | grep -q "foreign file active" && \
2174 _notrun "xfs_io $command not supported on $FSTYP"
2175 echo $testio | grep -q "Function not implemented" && \
2176 _notrun "xfs_io $command support is missing (missing syscall?)"
2178 [ -n "$param" ] || return
2180 if [ $param_checked -eq 0 ]; then
2181 $XFS_IO_PROG -c "help $command" | grep -q "^ $param --" || \
2182 _notrun "xfs_io $command doesn't support $param"
2184 # xfs_io could result in "command %c not supported" if it was
2185 # built on kernels not supporting pwritev2() calls
2186 echo $testio | grep -q "\(invalid option\|not supported\)" && \
2187 _notrun "xfs_io $command doesn't support $param"
2191 # check that kernel and filesystem support direct I/O
2194 if [ $FSTYP = "ext4" ] ; then
2195 if echo "$MOUNT_OPTIONS" | grep -q "test_dummy_encryption"; then
2196 _notrun "ext4 encryption doesn't support O_DIRECT"
2197 elif echo "$MOUNT_OPTIONS" | grep -q "data=journal"; then
2198 _notrun "ext4 data journaling doesn't support O_DIRECT"
2201 local testfile=$TEST_DIR/$$.direct
2202 $XFS_IO_PROG -F -f -d -c "pwrite 0 20k" $testfile > /dev/null 2>&1
2203 if [ $? -ne 0 ]; then
2204 _notrun "O_DIRECT is not supported"
2206 rm -f $testfile 2>&1 > /dev/null
2209 _format_swapfile() {
2216 # Swap files must be nocow on Btrfs.
2217 $CHATTR_PROG +C "$fname" > /dev/null 2>&1
2218 _pwrite_byte 0x61 0 "$sz" "$fname" >> $seqres.full
2219 mkswap "$fname" >> $seqres.full
2222 # Check that the filesystem supports swapfiles
2223 _require_scratch_swapfile()
2227 _scratch_mkfs >/dev/null
2230 # Minimum size for mkswap is 10 pages
2231 _format_swapfile "$SCRATCH_MNT/swap" $(($(get_page_size) * 10))
2233 if ! swapon "$SCRATCH_MNT/swap" >/dev/null 2>&1; then
2235 _notrun "swapfiles are not supported"
2238 swapoff "$SCRATCH_MNT/swap" >/dev/null 2>&1
2242 # Check that a fs has enough free space (in 1024b blocks)
2247 local blocks=$2 # in units of 1024
2248 local gb=$(( blocks / 1024 / 1024 ))
2250 local free_blocks=`df -kP $mnt | grep -v Filesystem | awk '{print $4}'`
2251 [ $free_blocks -lt $blocks ] && \
2252 _notrun "This test requires at least ${gb}GB free on $mnt to run"
2256 # Check if the filesystem supports sparse files.
2258 # Unfortunately there is no better way to do this than a manual black list.
2260 _require_sparse_files()
2264 _notrun "Sparse files not supported by this filesystem type: $FSTYP"
2273 #boot_params always present in debugfs
2274 [ -d "$DEBUGFS_MNT/boot_params" ] || _notrun "Debugfs not mounted"
2277 _require_fail_make_request()
2279 [ -f "$DEBUGFS_MNT/fail_make_request/probability" ] \
2280 || _notrun "$DEBUGFS_MNT/fail_make_request \
2281 not found. Seems that CONFIG_FAIL_MAKE_REQUEST kernel config option not enabled"
2284 # Disable extent zeroing for ext4 on the given device
2285 _ext4_disable_extent_zeroout()
2287 local dev=${1:-$TEST_DEV}
2288 local sdev=`_short_dev $dev`
2290 [ -f /sys/fs/ext4/$sdev/extent_max_zeroout_kb ] && \
2291 echo 0 >/sys/fs/ext4/$sdev/extent_max_zeroout_kb
2294 # Check if the file system supports seek_data/hole
2295 _require_seek_data_hole()
2297 local dev=${1:-$TEST_DEV}
2298 local testfile=$TEST_DIR/$$.seek
2299 local testseek=`$here/src/seek_sanity_test -t $testfile 2>&1`
2301 rm -f $testfile &>/dev/null
2302 echo $testseek | grep -q "Kernel does not support" && \
2303 _notrun "File system does not support llseek(2) SEEK_DATA/HOLE"
2304 # Disable extent zeroing for ext4 as that change where holes are
2306 if [ "$FSTYP" = "ext4" ]; then
2307 _ext4_disable_extent_zeroout $dev
2313 _require_test_program "runas"
2318 "$here/src/runas" "$@"
2321 _require_richacl_prog()
2323 _require_command "$GETRICHACL_PROG" getrichacl
2324 _require_command "$SETRICHACL_PROG" setrichacl
2327 _require_scratch_richacl_xfs()
2329 _scratch_mkfs_xfs_supported -m richacl=1 >/dev/null 2>&1 \
2330 || _notrun "mkfs.xfs doesn't have richacl feature"
2331 _scratch_mkfs_xfs -m richacl=1 >/dev/null 2>&1
2332 _try_scratch_mount >/dev/null 2>&1 \
2333 || _notrun "kernel doesn't support richacl feature on $FSTYP"
2337 _require_scratch_richacl_ext4()
2339 _scratch_mkfs -O richacl >/dev/null 2>&1 \
2340 || _notrun "can't mkfs $FSTYP with option -O richacl"
2341 _try_scratch_mount >/dev/null 2>&1 \
2342 || _notrun "kernel doesn't support richacl feature on $FSTYP"
2346 _require_scratch_richacl_support()
2349 $GETFATTR_PROG -n system.richacl >/dev/null 2>&1 \
2350 || _notrun "this test requires richacl support on \$SCRATCH_DEV"
2354 _require_scratch_richacl()
2357 xfs) _require_scratch_richacl_xfs
2359 ext4) _require_scratch_richacl_ext4
2362 _require_scratch_richacl_support
2364 *) _notrun "this test requires richacl support on \$SCRATCH_DEV"
2369 _scratch_mkfs_richacl()
2372 xfs) _scratch_mkfs_xfs -m richacl=1
2374 ext4) _scratch_mkfs -O richacl
2382 # check if the given device is mounted, if so, return mount point
2386 local fstype=${2:-$FSTYP}
2388 if [ $# -lt 1 ]; then
2389 echo "Usage: _is_dev_mounted <device> [fstype]" 1>&2
2393 findmnt -rncv -S $dev -t $fstype -o TARGET | head -1
2396 # check if the given dir is a mount point, if so, return mount point
2397 _is_dir_mountpoint()
2400 local fstype=${2:-$FSTYP}
2402 if [ $# -lt 1 ]; then
2403 echo "Uasge: _is_dir_mountpoint <dir> [fstype]" 1>&2
2407 findmnt -rncv -t $fstype -o TARGET $dir | head -1
2410 # remount a FS to a new mode (ro or rw)
2416 echo "Usage: _remount device ro/rw" 1>&2
2422 if ! mount -o remount,$mode $device
2424 echo "_remount: failed to remount filesystem on $device as $mode"
2429 # Run the appropriate repair/check on a filesystem
2431 # if the filesystem is mounted, it's either remounted ro before being
2432 # checked or it's unmounted and then remounted
2435 # If set, we remount ro instead of unmounting for fsck
2438 _umount_or_remount_ro()
2442 echo "Usage: _umount_or_remount_ro <device>" 1>&2
2447 local mountpoint=`_is_dev_mounted $device`
2449 if [ $USE_REMOUNT -eq 0 ]; then
2450 $UMOUNT_PROG $device
2457 _mount_or_remount_rw()
2459 if [ $# -ne 3 ]; then
2460 echo "Usage: _mount_or_remount_rw <opts> <dev> <mnt>" 1>&2
2467 if [ $USE_REMOUNT -eq 0 ]; then
2468 if [ "$FSTYP" != "overlay" ]; then
2469 _mount -t $FSTYP $mount_opts $device $mountpoint
2471 _overlay_mount $device $mountpoint
2473 if [ $? -ne 0 ]; then
2474 _dump_err "!!! failed to remount $device on $mountpoint"
2484 # Check a generic filesystem in no-op mode; this assumes that the
2485 # underlying fsck program accepts "-n" for a no-op (check-only) run,
2486 # and that it will still return an errno for corruption in this mode.
2488 # Filesystems which don't support this will need to define their
2489 # own check routine.
2491 _check_generic_filesystem()
2495 # If type is set, we're mounted
2496 local type=`_fs_type $device`
2499 if [ "$type" = "$FSTYP" ]
2502 local mountpoint=`_umount_or_remount_ro $device`
2505 fsck -t $FSTYP $FSCK_OPTIONS $device >$tmp.fsck 2>&1
2508 _log_err "_check_generic_filesystem: filesystem on $device is inconsistent"
2509 echo "*** fsck.$FSTYP output ***" >>$seqres.full
2510 cat $tmp.fsck >>$seqres.full
2511 echo "*** end fsck.$FSTYP output" >>$seqres.full
2519 echo "*** mount output ***" >>$seqres.full
2520 _mount >>$seqres.full
2521 echo "*** end mount output" >>$seqres.full
2522 elif [ "$type" = "$FSTYP" ]
2525 _mount_or_remount_rw "$MOUNT_OPTIONS" $device $mountpoint
2529 if [ $ok -eq 0 ]; then
2531 if [ "$iam" != "check" ]; then
2540 # Filter the knowen errors the UDF Verifier reports.
2541 _udf_test_known_error_filter()
2543 egrep -v "PVD 60 Error: Interchange Level: 1, Maximum Interchange Level: 0|FSD 28 Error: Interchange Level: 1, Maximum Interchange Level: 1,|PVD 72 Warning: Volume Set Identifier: \"\*IRIX UDF\",|Warning: [0-9]+ unused blocks NOT marked as unallocated."
2547 _check_udf_filesystem()
2549 [ "$DISABLE_UDF_TEST" == "1" ] && return
2551 if [ $# -ne 1 -a $# -ne 2 ]
2553 echo "Usage: _check_udf_filesystem device [last_block]" 1>&2
2557 if [ ! -x $here/src/udf_test ]
2559 echo "udf_test not installed, please download and build the Philips"
2560 echo "UDF Verification Software from http://www.extra.research.philips.com/udf/."
2561 echo "Then copy the udf_test binary to $here/src/."
2562 echo "If you do not wish to run udf_test then set environment variable DISABLE_UDF_TEST"
2569 if [ $# -eq 2 ]; then
2570 opt_arg="-lastvalidblock $(( $2 - 1 ))"
2573 rm -f $seqres.checkfs
2574 sleep 1 # Due to a problem with time stamps in udf_test
2575 $here/src/udf_test $opt_arg $device | tee $seqres.checkfs | egrep "Error|Warning" | \
2576 _udf_test_known_error_filter | \
2577 egrep -iv "Error count:.*[0-9]+.*total occurrences:.*[0-9]+|Warning count:.*[0-9]+.*total occurrences:.*[0-9]+" && \
2578 echo "Warning UDF Verifier reported errors see $seqres.checkfs." && return 1
2589 # no way to check consistency for nfs
2592 # no way to check consistency for cifs
2595 # no way to check consistency for 9p
2598 # no way to check consistency for CephFS
2601 # no way to check consistency for GlusterFS
2604 _check_overlay_test_fs
2609 # do nothing for now
2612 _check_btrfs_filesystem $TEST_DEV
2615 # no way to check consistency for tmpfs
2618 # there is no fsck program for ubifs yet
2621 _check_generic_filesystem $TEST_DEV
2628 local device=$SCRATCH_DEV
2629 [ $# -eq 1 ] && device=$1
2633 local scratch_log="none"
2634 local scratch_rt="none"
2635 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
2636 scratch_log="$SCRATCH_LOGDEV"
2638 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
2639 scratch_rt="$SCRATCH_RTDEV"
2641 _check_xfs_filesystem $device $scratch_log $scratch_rt
2644 _check_udf_filesystem $device $udf_fsize
2647 # Don't know how to check an NFS filesystem, yet.
2650 # Don't know how to check a CIFS filesystem, yet.
2653 # no way to check consistency for 9p
2656 # no way to check consistency for CephFS
2659 # no way to check consistency for GlusterFS
2662 _check_overlay_scratch_fs
2667 _check_btrfs_filesystem $device
2670 # no way to check consistency for tmpfs
2673 # there is no fsck program for ubifs yet
2676 _check_generic_filesystem $device
2681 _full_fstyp_details()
2683 [ -z "$FSTYP" ] && FSTYP=xfs
2684 if [ $FSTYP = xfs ]; then
2685 if [ -d /proc/fs/xfs ]; then
2686 if grep -q 'debug 0' /proc/fs/xfs/stat; then
2687 FSTYP="$FSTYP (non-debug)"
2688 elif grep -q 'debug 1' /proc/fs/xfs/stat; then
2689 FSTYP="$FSTYP (debug)"
2692 if uname -a | grep -qi 'debug'; then
2693 FSTYP="$FSTYP (debug)"
2695 FSTYP="$FSTYP (non-debug)"
2702 _full_platform_details()
2705 local host=`hostname -s`
2706 local kernel=`uname -r`
2707 local platform=`uname -m`
2708 echo "$os/$platform $host $kernel"
2713 if [ "`uname`" == "Linux" ]; then
2716 echo Unknown operating system: `uname`
2721 _link_out_file_named()
2724 local suffix=$(FEATURES="$features" perl -e '
2726 my $feature, $result, $suffix, $opts;
2728 foreach $feature (split(/,/, $ENV{"FEATURES"})) {
2729 $feathash{$feature} = 1;
2731 $result = "default";
2736 ($opts, $suffix) = split(/ *: */);
2737 foreach my $opt (split(/,/, $opts)) {
2738 if (!exists($feathash{$opt})) {
2751 ln -fs $(basename $1).$suffix $1
2758 if [ $# -eq 0 ]; then
2759 features="$(_get_os_name)"
2760 if [ -n "$MOUNT_OPTIONS" ]; then
2761 features=$features,${MOUNT_OPTIONS##"-o "}
2767 _link_out_file_named $seqfull.out "$features"
2776 # convert urandom incompressible data to compressible text data
2779 od /dev/urandom | dd iflag=fullblock ${*}
2782 #takes files, randomdata
2790 if [ $size -gt 0 ]; then
2791 if [ "$2" == "false" ]; then
2792 dd if=/dev/zero of=$file bs=1024 count=$size 2>&1 | _filter_dd
2793 elif [ "$2" == "comp" ]; then
2794 _ddt of=$file bs=1024 count=$size 2>&1 | _filter_dd
2796 dd if=/dev/urandom of=$file bs=1024 count=$size 2>&1 | _filter_dd
2803 # takes dirname, depth, randomdata
2806 local dirname=$1 depth=$2 randomdata=$3
2807 mkdir $dirname || die "mkdir $dirname failed"
2810 _nfiles $files $randomdata # files for this dir and data type
2812 [ $depth -eq 0 ] && return
2813 local deep=$(( depth - 1 )) # go 1 down
2815 [ $verbose = true ] && echo "descending, depth from leaves = $deep"
2818 while [ $d -lt $dirs ]
2820 _descend d$d $deep &
2826 # Populate a filesystem with inodes for performance experiments
2828 # usage: populate [-v] [-n ndirs] [-f nfiles] [-d depth] [-r root] [-s size] [-x]
2833 local dirs=5 # ndirs in each subdir till leaves
2834 local size=0 # sizeof files in K
2835 local files=100 # num files in _each_ subdir
2836 local depth=2 # depth of tree from root to leaves
2838 local root=root # path of initial root of directory tree
2839 local randomdata=false # -x data type urandom, zero or compressible
2843 while getopts "d:f:n:r:s:v:x:c" c
2852 x) randomdata=true;;
2853 c) randomdata=comp;;
2857 _descend $root $depth $randomdata
2862 [ $verbose = true ] && echo done
2865 # query whether the given file has the given inode flag set
2872 if $XFS_IO_PROG -r -c 'lsattr -v' "$file" | grep -q "$flag" ; then
2878 # query the given files extsize allocator hint in bytes (if any)
2885 blocks=`$XFS_IO_PROG -r -c 'stat' "$file" | \
2886 awk '/^xattr.extsize =/ { print $3 }'`
2887 [ -z "$blocks" ] && blocks="0"
2891 # scratch_dev_pool should contain the disks pool for the btrfs raid
2892 _require_scratch_dev_pool()
2897 if [ -z "$SCRATCH_DEV_POOL" ]; then
2898 _notrun "this test requires a valid \$SCRATCH_DEV_POOL"
2901 if [ -z "$1" ]; then
2907 # btrfs test case needs ndevs or more scratch_dev_pool; other FS not sure
2911 if [ "`echo $SCRATCH_DEV_POOL|wc -w`" -lt $ndevs ]; then
2912 _notrun "btrfs and this test needs $ndevs or more disks in SCRATCH_DEV_POOL"
2916 _notrun "dev_pool is not supported by fstype \"$FSTYP\""
2920 for i in $SCRATCH_DEV_POOL; do
2921 if [ "`_is_block_dev "$i"`" = "" ]; then
2922 _notrun "this test requires valid block disk $i"
2924 if [ "`_is_block_dev "$i"`" = "`_is_block_dev "$TEST_DEV"`" ]; then
2925 _notrun "$i is part of TEST_DEV, this test requires unique disks"
2927 if _mount | grep -q $i; then
2928 if ! $UMOUNT_PROG $i; then
2929 echo "failed to unmount $i - aborting"
2933 # to help better debug when something fails, we remove
2934 # traces of previous btrfs FS on the dev.
2935 dd if=/dev/zero of=$i bs=4096 count=100 > /dev/null 2>&1
2939 # ensure devices in SCRATCH_DEV_POOL are of the same size
2940 # must be called after _require_scratch_dev_pool
2941 _require_scratch_dev_pool_equal_size()
2947 # SCRATCH_DEV has been set to the first device in SCRATCH_DEV_POOL
2948 size=`_get_device_size $SCRATCH_DEV`
2949 for dev in $SCRATCH_DEV_POOL; do
2950 newsize=`_get_device_size $dev`
2951 if [ $size -ne $newsize ]; then
2952 _notrun "This test requires devices in SCRATCH_DEV_POOL have the same size"
2957 # We will check if the device is deletable
2958 _require_deletable_scratch_dev_pool()
2962 for i in $SCRATCH_DEV_POOL; do
2963 x=`echo $i | cut -d"/" -f 3`
2964 if [ ! -f /sys/class/block/${x}/device/delete ]; then
2965 _notrun "$i is a device which is not deletable"
2970 # Check that fio is present, and it is able to execute given jobfile
2975 _require_command "$FIO_PROG" fio
2976 if [ -z "$1" ]; then
2980 $FIO_PROG --warnings-fatal --showcmd $job >> $seqres.full 2>&1
2981 [ $? -eq 0 ] || _notrun "$FIO_PROG too old, see $seqres.full"
2984 # Does freeze work on this fs?
2987 xfs_freeze -f "$TEST_DIR" >/dev/null 2>&1
2989 xfs_freeze -u "$TEST_DIR" >/dev/null 2>&1
2990 [ $result -eq 0 ] || _notrun "$FSTYP does not support freezing"
2993 # Does NFS export work on this fs?
2996 _require_test_program "open_by_handle"
2997 mkdir -p "$TEST_DIR"/exportfs_test
2998 $here/src/open_by_handle -c "$TEST_DIR"/exportfs_test 2>&1 \
2999 || _notrun "$FSTYP does not support NFS export"
3003 # Does shutdown work on this fs?
3004 _require_scratch_shutdown()
3006 [ -x src/godown ] || _notrun "src/godown executable not found"
3008 _scratch_mkfs > /dev/null 2>&1 || _notrun "_scratch_mkfs failed on $SCRATCH_DEV"
3011 if [ $FSTYP = "overlay" ]; then
3012 if [ -z $OVL_BASE_SCRATCH_DEV ]; then
3013 # In lagacy overlay usage, it may specify directory as
3014 # SCRATCH_DEV, in this case OVL_BASE_SCRATCH_DEV
3015 # will be null, so check OVL_BASE_SCRATCH_DEV before
3016 # running shutdown to avoid shutting down base fs accidently.
3017 _notrun "$SCRATCH_DEV is not a block device"
3019 src/godown -f $OVL_BASE_SCRATCH_MNT 2>&1 \
3020 || _notrun "Underlying filesystem does not support shutdown"
3023 src/godown -f $SCRATCH_MNT 2>&1 \
3024 || _notrun "$FSTYP does not support shutdown"
3030 # Does dax mount option work on this dev/fs?
3031 _require_scratch_dax()
3034 _scratch_mkfs > /dev/null 2>&1
3035 _try_scratch_mount -o dax || \
3036 _notrun "mount $SCRATCH_DEV with dax failed"
3037 # Check options to be sure. XFS ignores dax option
3038 # and goes on if dev underneath does not support dax.
3039 _fs_options $SCRATCH_DEV | grep -qw "dax" || \
3040 _notrun "$SCRATCH_DEV $FSTYP does not support -o dax"
3044 # Does norecovery support by this fs?
3045 _require_norecovery()
3047 _try_scratch_mount -o ro,norecovery || \
3048 _notrun "$FSTYP does not support norecovery"
3052 # Does this filesystem support metadata journaling?
3053 # We exclude ones here that don't; otherwise we assume that it does, so the
3054 # test will run, fail, and motivate someone to update this test for a new
3057 # It's possible that TEST_DEV and SCRATCH_DEV have different features (it'd be
3058 # odd, but possible) so check $TEST_DEV by default, but we can optionall pass
3060 _require_metadata_journaling()
3069 ext2|vfat|msdos|udf)
3070 _notrun "$FSTYP does not support metadata journaling"
3073 # ext4 could be mkfs'd without a journal...
3075 $DUMPE2FS_PROG -h $dev 2>&1 | grep -q has_journal || \
3076 _notrun "$FSTYP on $dev not configured with metadata journaling"
3077 # ext4 might not load a journal
3078 _exclude_scratch_mount_option "noload"
3081 # metadata journaling check is based on base filesystem configurations
3082 # and because -overlay option saves those configurations to OVL_BASE_*,
3083 # adding restore/override the configurations before/after the check.
3084 if [ ! -z $OVL_BASE_FSTYP -a $OVL_BASE_FSTYP != "overlay" ]; then
3085 _overlay_config_restore
3086 _require_metadata_journaling
3087 _overlay_config_override
3089 _notrun "No metadata journaling support for legacy overlay setup"
3093 # by default we pass; if you need to, add your fs above!
3100 $XFS_IO_PROG -c "fiemap" $1 | tail -n +2 | grep -v hole | wc -l
3105 $XFS_IO_PROG -c "fiemap" $1 | tail -n +2 | grep hole | wc -l
3108 _count_attr_extents()
3110 $XFS_IO_PROG -c "fiemap -a" $1 | tail -n +2 | grep -v hole | wc -l
3113 # arg 1 is dev to remove and is output of the below eg.
3114 # ls -l /sys/class/block/sdd | rev | cut -d "/" -f 3 | rev
3120 echo 1 > /sys/class/scsi_device/${lun}/device/delete || _fail "Remove disk failed"
3122 stat $disk > /dev/null 2>&1
3123 while [ $? -eq 0 ]; do
3125 stat $disk > /dev/null 2>&1
3129 # arg 1 is dev to add and is output of the below eg.
3130 # ls -l /sys/class/block/sdd | rev | cut -d "/" -f 3 | rev
3135 # arg 1 will be in h:t:d:l format now in the h and "t d l" format
3136 h=`echo ${1} | cut -d":" -f 1`
3137 tdl=`echo ${1} | cut -d":" -f 2-|sed 's/:/ /g'`
3139 echo ${tdl} > /sys/class/scsi_host/host${h}/scan || _fail "Add disk failed"
3141 # ensure the device comes online
3142 local dev_back_oneline=0
3144 for i in `seq 1 10`; do
3145 if [ -d /sys/class/scsi_device/${1}/device/block ]; then
3146 local dev=`ls /sys/class/scsi_device/${1}/device/block`
3148 for j in `seq 1 10`;
3150 stat /dev/$dev > /dev/null 2>&1
3151 if [ $? -eq 0 ]; then
3162 if [ $dev_back_oneline -eq 0 ]; then
3163 echo "/dev/$dev online failed" >> $seqres.full
3165 echo "/dev/$dev is back online" >> $seqres.full
3171 if [ -z "$FSTRIM_PROG" ]; then
3172 _notrun "This test requires fstrim utility."
3176 _require_batched_discard()
3178 if [ $# -ne 1 ]; then
3179 echo "Usage: _require_batched_discard mnt_point" 1>&2
3183 $FSTRIM_PROG $1 > /dev/null 2>&1 || _notrun "FITRIM not supported on $1"
3188 if [ -z "$DUMPE2FS_PROG" ]; then
3189 _notrun "This test requires dumpe2fs utility."
3195 if [ ! -e /proc/self/uid_map ]; then
3196 _notrun "This test requires procfs uid_map support."
3198 if [ ! -e /proc/self/gid_map ]; then
3199 _notrun "This test requires procfs gid_map support."
3205 FSSUM_PROG=$here/src/fssum
3206 [ -x $FSSUM_PROG ] || _notrun "fssum not built"
3211 CLONER_PROG=$here/src/cloner
3212 [ -x $CLONER_PROG ] || \
3213 _notrun "cloner binary not present at $CLONER_PROG"
3216 # Normalize mount options from global $MOUNT_OPTIONS
3217 # Convert options like "-o opt1,opt2 -oopt3" to
3219 _normalize_mount_options()
3221 echo $MOUNT_OPTIONS | sed -n 's/-o\s*\(\S*\)/\1/gp'| sed 's/,/ /g'
3224 # skip test if MOUNT_OPTIONS contains the given strings
3225 _exclude_scratch_mount_option()
3227 local mnt_opts=$(_normalize_mount_options)
3229 while [ $# -gt 0 ]; do
3230 if echo $mnt_opts | grep -qw "$1"; then
3231 _notrun "mount option \"$1\" not allowed in this test"
3239 _exclude_scratch_mount_option "noatime"
3240 if [ "$FSTYP" == "nfs" ]; then
3241 _notrun "atime related mount options have no effect on NFS"
3247 _scratch_mkfs > /dev/null 2>&1
3248 _try_scratch_mount -o relatime || \
3249 _notrun "relatime not supported by the current kernel"
3255 [ -x src/nsexec ] || _notrun "src/nsexec executable not found"
3256 src/nsexec -U true 2>/dev/null || _notrun "userns not supported by this kernel"
3259 _create_loop_device()
3262 dev=`losetup -f --show $file` || _fail "Cannot assign $file to a loop device"
3266 _destroy_loop_device()
3269 losetup -d $dev || _fail "Cannot destroy loop device $dev"
3272 _scale_fsstress_args()
3275 while [ $# -gt 0 ]; do
3277 -n) args="$args $1 $(($2 * $TIME_FACTOR))"; shift ;;
3278 -p) args="$args $1 $(($2 * $LOAD_FACTOR))"; shift ;;
3279 *) args="$args $1" ;;
3287 # Return the logical block size if running on a block device,
3288 # else substitute the page size.
3290 _min_dio_alignment()
3294 if [ -b "$dev" ]; then
3295 blockdev --getss $dev
3297 $here/src/feature -s
3303 echo "# $@" >> $seqres.full 2>&1
3304 "$@" >> $seqres.full 2>&1 || _fail "failed: '$@'"
3307 _require_test_symlinks()
3309 local target=`mktemp -p $TEST_DIR`
3310 local link=`mktemp -p $TEST_DIR -u`
3311 ln -s `basename $target` $link
3312 if [ "$?" -ne 0 ]; then
3314 _notrun "Require symlinks support"
3319 _require_test_fcntl_advisory_locks()
3321 [ "$FSTYP" != "cifs" ] && return 0
3322 cat /proc/mounts | grep $TEST_DEV | grep cifs | grep -q "nobrl" && return 0
3323 cat /proc/mounts | grep $TEST_DEV | grep cifs | grep -qE "nounix|forcemand" && \
3324 _notrun "Require fcntl advisory locks support"
3327 _require_ofd_locks()
3329 # Give a test run by getlk wrlck on testfile.
3330 # If the running kernel does not support OFD locks,
3331 # EINVAL will be returned.
3332 _require_test_program "t_ofd_locks"
3333 touch $TEST_DIR/ofd_testfile
3334 src/t_ofd_locks -t $TEST_DIR/ofd_testfile > /dev/null 2>&1
3335 [ $? -eq 22 ] && _notrun "Require OFD locks support"
3338 _require_test_lsattr()
3340 local testio=$(lsattr -d $TEST_DIR 2>&1)
3341 echo $testio | grep -q "Operation not supported" && \
3342 _notrun "lsattr not supported by test filesystem type: $FSTYP"
3343 echo $testio | grep -q "Inappropriate ioctl for device" && \
3344 _notrun "lsattr not supported by test filesystem type: $FSTYP"
3349 if [ -z "$1" ]; then
3350 echo "Usage: _require_chattr <attr>"
3355 touch $TEST_DIR/syscalltest
3356 chattr "+$attribute" $TEST_DIR/syscalltest > $TEST_DIR/syscalltest.out 2>&1
3358 chattr "-$attribute" $TEST_DIR/syscalltest > $TEST_DIR/syscalltest.out 2>&1
3359 if [ "$ret" -ne 0 ]; then
3360 _notrun "file system doesn't support chattr +$attribute"
3362 cat $TEST_DIR/syscalltest.out >> $seqres.full
3363 rm -f $TEST_DIR/syscalltest.out
3368 if [ -z "$1" ]; then
3369 echo "Usage: _get_total_inode <mnt>"
3373 nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $3}'`
3379 if [ -z "$1" ]; then
3380 echo "Usage: _get_used_inode <mnt>"
3384 nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $4}'`
3388 _get_used_inode_percent()
3390 if [ -z "$1" ]; then
3391 echo "Usage: _get_used_inode_percent <mnt>"
3395 pct_inode=`$DF_PROG -i $1 | tail -1 | awk '{ print $6 }' | \
3402 if [ -z "$1" ]; then
3403 echo "Usage: _get_free_inode <mnt>"
3407 nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $5}'`
3411 # get the available space in bytes
3413 _get_available_space()
3415 if [ -z "$1" ]; then
3416 echo "Usage: _get_available_space <mnt>"
3420 avail_kb=`$DF_PROG $1 | tail -n1 | awk '{ print $5 }'`
3421 echo $((avail_kb * 1024))
3424 # return device size in kb
3427 grep `_short_dev $1` /proc/partitions | awk '{print $3}'
3430 # Make sure we actually have dmesg checking set up.
3431 _require_check_dmesg()
3433 test -w /dev/kmsg || \
3434 _notrun "Test requires writable /dev/kmsg."
3437 # Return the dmesg log since the start of this test. Caller must ensure that
3438 # /dev/kmsg was writable when the test was started so that we can find the
3439 # beginning of this test's log messages; _require_check_dmesg does this.
3440 _dmesg_since_test_start()
3442 # search the dmesg log of last run of $seqnum for possible failures
3443 # use sed \cregexpc address type, since $seqnum contains "/"
3444 dmesg | tac | sed -ne "0,\#run fstests $seqnum at $date_time#p" | \
3448 # check dmesg log for a specific string, subject to the same requirements as
3449 # _dmesg_since_test_start.
3452 _dmesg_since_test_start | egrep -q "$1"
3455 # check dmesg log for WARNING/Oops/etc.
3458 if [ ! -f ${RESULT_DIR}/check_dmesg ]; then
3461 rm -f ${RESULT_DIR}/check_dmesg
3463 # default filter is a simple cat command, caller could provide a
3464 # customized filter and pass the name through the first argument, to
3465 # filter out intentional WARNINGs or Oopses
3466 local filter=${1:-cat}
3468 _dmesg_since_test_start | $filter >$seqres.dmesg
3469 egrep -q -e "kernel BUG at" \
3473 -e "possible recursive locking detected" \
3474 -e "Internal error" \
3475 -e "(INFO|ERR): suspicious RCU usage" \
3476 -e "INFO: possible circular locking dependency detected" \
3477 -e "general protection fault:" \
3478 -e "BUG .* remaining" \
3481 if [ $? -eq 0 ]; then
3482 _dump_err "_check_dmesg: something found in dmesg (see $seqres.dmesg)"
3490 # capture the kmemleak report
3493 local kern_knob="${DEBUGFS_MNT}/kmemleak"
3494 local leak_file="$1"
3496 # Tell the kernel to scan for memory leaks. Apparently the write
3497 # returns before the scan is complete, so do it twice in the hopes
3498 # that twice is enough to capture all the leaks.
3499 echo "scan" > "$kern_knob"
3500 cat "$kern_knob" > /dev/null
3501 echo "scan" > "$kern_knob"
3502 cat "$kern_knob" > "$leak_file.tmp"
3503 if [ -s "$leak_file.tmp" ]; then
3504 cat > "$leak_file" << ENDL
3505 EXPERIMENTAL kmemleak reported some memory leaks! Due to the way kmemleak
3506 works, the leak might be from an earlier test, or something totally unrelated.
3508 cat "$leak_file.tmp" >> "$leak_file"
3510 rm -rf "$leak_file.tmp"
3511 echo "clear" > "$kern_knob"
3517 local kern_knob="${DEBUGFS_MNT}/kmemleak"
3519 if [ ! -w "$kern_knob" ]; then
3523 # Disable the automatic scan so that we can control it completely,
3524 # then dump all the leaks recorded so far.
3525 echo "scan=off" > "$kern_knob"
3526 _capture_kmemleak /dev/null
3529 # check kmemleak log
3532 local kern_knob="${DEBUGFS_MNT}/kmemleak"
3533 local leak_file="${seqres}.kmemleak"
3535 if [ ! -w "$kern_knob" ]; then
3539 # Capture and report any leaks
3540 _capture_kmemleak "$leak_file"
3541 if [ -s "$leak_file" ]; then
3542 _dump_err "_check_kmemleak: something found in kmemleak (see $leak_file)"
3550 # don't check dmesg log after test
3551 _disable_dmesg_check()
3553 rm -f ${RESULT_DIR}/check_dmesg
3558 # make some further configuration checks here
3559 if [ "$TEST_DEV" = "" ]
3561 echo "common/rc: Error: \$TEST_DEV is not set"
3565 # if $TEST_DEV is not mounted, mount it now as XFS
3566 if [ -z "`_fs_type $TEST_DEV`" ]
3568 # $TEST_DEV is not mounted
3571 echo "common/rc: retrying test device mount with external set"
3572 [ "$USE_EXTERNAL" != "yes" ] && export USE_EXTERNAL=yes
3575 echo "common/rc: could not mount $TEST_DEV on $TEST_DIR"
3581 # Sanity check that TEST partition is not mounted at another mount point
3582 # or as another fs type
3583 _check_mounted_on TEST_DEV $TEST_DEV TEST_DIR $TEST_DIR $FSTYP || exit 1
3584 if [ -n "$SCRATCH_DEV" ]; then
3585 # Sanity check that SCRATCH partition is not mounted at another
3586 # mount point, because it is about to be unmounted and formatted.
3587 # Another fs type for scratch is fine (bye bye old fs type).
3588 _check_mounted_on SCRATCH_DEV $SCRATCH_DEV SCRATCH_MNT $SCRATCH_MNT
3589 [ $? -le 1 ] || exit 1
3592 # Figure out if we need to add -F ("foreign", deprecated) option to xfs_io
3593 $XFS_IO_PROG -c stat $TEST_DIR 2>&1 | grep -q "is not on an XFS filesystem" && \
3594 export XFS_IO_PROG="$XFS_IO_PROG -F"
3596 # xfs_io -i option starts an idle thread for xfs_io.
3597 # With single threaded process, the file table is not shared
3598 # and file structs are not reference counted.
3599 # Spawning an idle thread can help detecting file struct
3600 # reference leaks, so we want to enable the option whenever
3602 $XFS_IO_PROG -i -c quit 2>/dev/null && \
3603 export XFS_IO_PROG="$XFS_IO_PROG -i"
3605 # xfs_copy on v5 filesystems do not require the "-d" option if xfs_db
3606 # can change the UUID on v5 filesystems
3607 if [ "$FSTYP" == "xfs" ]; then
3609 $MKFS_XFS_PROG -d file,name=/tmp/$$.img,size=512m >/dev/null 2>&1
3610 # xfs_db will return 0 even if it can't generate a new uuid, so
3611 # check the output to make sure if it can change UUID of V5 xfs
3612 $XFS_DB_PROG -x -c "uuid generate" /tmp/$$.img \
3613 | grep -q "invalid UUID\|supported on V5 fs" \
3614 && export XFS_COPY_PROG="$XFS_COPY_PROG -d"
3619 # get real device path name by following link
3623 if [ -b "$dev" ] && [ -L "$dev" ]; then
3624 dev=`readlink -f "$dev"`
3629 # basename of a device
3632 echo `basename $(_real_dev $1)`
3637 local dev=`_real_dev $1`
3638 local maj=$(stat -c%t $dev | tr [:lower:] [:upper:])
3639 local min=$(stat -c%T $dev | tr [:lower:] [:upper:])
3640 maj=$(echo "ibase=16; $maj" | bc)
3641 min=$(echo "ibase=16; $min" | bc)
3642 echo /sys/dev/block/$maj:$min
3645 # Get the minimum block size of a file. Usually this is the
3646 # minimum fs block size, but some filesystems (ocfs2) do block
3647 # mappings in larger units.
3648 _get_file_block_size()
3650 if [ -z $1 ] || [ ! -d $1 ]; then
3651 echo "Missing mount point argument for _get_file_block_size"
3654 if [ "$FSTYP" = "ocfs2" ]; then
3661 # Get the minimum block size of an fs.
3664 if [ -z $1 ] || [ ! -d $1 ]; then
3665 echo "Missing mount point argument for _get_block_size"
3673 echo $(getconf PAGE_SIZE)
3680 local args=`echo $@ | sed -e "s/ BSIZE / $bsize /g" -e "s/ PSIZE / $psize /g"`
3681 set -- $here/ltp/fsx $args $FSX_AVOID $TEST_DIR/junk
3682 echo "$@" >>$seqres.full
3683 rm -f $TEST_DIR/junk
3684 "$@" 2>&1 | tee -a $seqres.full >$tmp.fsx
3685 if [ ${PIPESTATUS[0]} -ne 0 ]; then
3693 # Test for the existence of a sysfs entry at /sys/fs/$FSTYP/DEV/$ATTR
3695 # Only one argument is needed:
3696 # - attr: path name under /sys/fs/$FSTYP/DEV
3699 # _require_fs_sysfs error/fail_at_unmount
3703 local dname=$(_short_dev $TEST_DEV)
3705 if [ -z "$attr" -o -z "$dname" ];then
3706 _fail "Usage: _require_fs_sysfs <sysfs_attr_path>"
3709 if [ ! -e /sys/fs/${FSTYP}/${dname}/${attr} ];then
3710 _notrun "This test requires /sys/fs/${FSTYP}/${dname}/${attr}"
3716 $here/src/stat_test --check-statx ||
3717 _notrun "This test requires the statx system call"
3720 # Write "content" into /sys/fs/$FSTYP/$DEV/$ATTR
3722 # All arguments are necessary, and in this order:
3723 # - dev: device name, e.g. $SCRATCH_DEV
3724 # - attr: path name under /sys/fs/$FSTYP/$dev
3725 # - content: the content of $attr
3728 # _set_fs_sysfs_attr /dev/mapper/scratch-dev error/fail_at_unmount 0
3729 _set_fs_sysfs_attr()
3737 if [ ! -b "$dev" -o -z "$attr" -o -z "$content" ];then
3738 _fail "Usage: _set_fs_sysfs_attr <mounted_device> <attr> <content>"
3741 local dname=$(_short_dev $dev)
3742 echo "$content" > /sys/fs/${FSTYP}/${dname}/${attr}
3745 # Print the content of /sys/fs/$FSTYP/$DEV/$ATTR
3747 # All arguments are necessary, and in this order:
3748 # - dev: device name, e.g. $SCRATCH_DEV
3749 # - attr: path name under /sys/fs/$FSTYP/$dev
3752 # _get_fs_sysfs_attr /dev/mapper/scratch-dev error/fail_at_unmount
3753 _get_fs_sysfs_attr()
3758 if [ ! -b "$dev" -o -z "$attr" ];then
3759 _fail "Usage: _get_fs_sysfs_attr <mounted_device> <attr>"
3762 local dname=$(_short_dev $dev)
3763 cat /sys/fs/${FSTYP}/${dname}/${attr}
3766 # Generic test for specific filesystem feature.
3767 # Currently only implemented to test overlayfs features.
3768 _require_scratch_feature()
3774 _require_scratch_overlay_features ${feature}
3777 _fail "Test for feature '${feature}' of ${FSTYP} is not implemented"
3782 # The maximum filesystem label length, /not/ including terminating NULL
3793 _notrun "$FSTYP does not define maximum label length"
3798 # Helper to check above early in a script
3799 _require_label_get_max()
3801 # Just call _label_get_max which will notrun if appropriate
3802 dummy=$(_label_get_max)
3807 ################################################################################
3808 # make sure this script returns success