common/rc

   1 ##/bin/bash
   2 # SPDX-License-Identifier: GPL-2.0+
   3 # Copyright (c) 2000-2006 Silicon Graphics, Inc.  All Rights Reserved.
   4
   5 . common/config
   6
   7 BC=$(which bc 2> /dev/null) || BC=
   8
   9 # Some tests are not relevant or functional when testing XFS realtime
  10 # subvolumes along with the rtinherit=1 mkfs option.  In these cases,
  11 # this test will opt-out of the test.
  12 _require_no_rtinherit()
  13 {
  14         [ "$FSTYP" = "xfs" ] && echo "$MKFS_OPTIONS" |
  15                 egrep -q "rtinherit([^=]|=1|$)" && \
  16                 _notrun "rtinherit mkfs option is not supported by this test."
  17 }
  18
  19 _require_math()
  20 {
  21         if [ -z "$BC" ]; then
  22                 _notrun "this test requires 'bc' tool for doing math operations"
  23         fi
  24 }
  25
  26 _math()
  27 {
  28         [ $# -le 0 ] && return
  29         LANG=C echo "scale=0; $@" | "$BC" -q 2> /dev/null
  30 }
  31
  32 dd()
  33 {
  34    if [ "$HOSTOS" == "Linux" ]
  35    then
  36         command dd --help 2>&1 | grep noxfer >/dev/null
  37
  38         if [ "$?" -eq 0 ]
  39             then
  40                 command dd status=noxfer $@
  41             else
  42                 command dd $@
  43         fi
  44    else
  45         command dd $@
  46    fi
  47 }
  48
  49 # Prints the md5 checksum of a given file
  50 _md5_checksum()
  51 {
  52         md5sum $1 | cut -d ' ' -f1
  53 }
  54
  55 # Write a byte into a range of a file
  56 _pwrite_byte() {
  57         local pattern="$1"
  58         local offset="$2"
  59         local len="$3"
  60         local file="$4"
  61         local xfs_io_args="$5"
  62
  63         $XFS_IO_PROG $xfs_io_args -f -c "pwrite -S $pattern $offset $len" "$file"
  64 }
  65
  66 # mmap-write a byte into a range of a file
  67 _mwrite_byte() {
  68         local pattern="$1"
  69         local offset="$2"
  70         local len="$3"
  71         local mmap_len="$4"
  72         local file="$5"
  73
  74         $XFS_IO_PROG -f -c "mmap -rw 0 $mmap_len" -c "mwrite -S $pattern $offset $len" "$file"
  75 }
  76
  77 # ls -l w/ selinux sometimes puts a dot at the end:
  78 # -rwxrw-r--. id1 id2 file1
  79 # Also filter out lost+found directory on extN file system if present
  80
  81 _ls_l()
  82 {
  83         ls -l $* | sed "s/\(^[-rwxdlbcpsStT]*\)\. /\1 /" | grep -v 'lost+found'
  84 }
  85
  86 _dump_err()
  87 {
  88     _err_msg="$*"
  89     echo "$_err_msg"
  90 }
  91
  92 _dump_err_cont()
  93 {
  94     _err_msg="$*"
  95     echo -n "$_err_msg"
  96 }
  97
  98 _dump_err2()
  99 {
 100     _err_msg="$*"
 101     >&2 echo "$_err_msg"
 102 }
 103
 104 _log_err()
 105 {
 106     _err_msg="$*"
 107     echo "$_err_msg" | tee -a $seqres.full
 108     echo "(see $seqres.full for details)"
 109 }
 110
 111 # make sure we have a standard umask
 112 umask 022
 113
 114 # check for correct setup and source the $FSTYP specific functions now
 115 case "$FSTYP" in
 116     xfs)
 117          [ "$XFS_LOGPRINT_PROG" = "" ] && _fatal "xfs_logprint not found"
 118          [ "$XFS_REPAIR_PROG" = "" ] && _fatal "xfs_repair not found"
 119          [ "$XFS_DB_PROG" = "" ] && _fatal "xfs_db not found"
 120          [ "$MKFS_XFS_PROG" = "" ] && _fatal "mkfs_xfs not found"
 121          [ "$XFS_INFO_PROG" = "" ] && _fatal "xfs_info not found"
 122
 123          . ./common/xfs
 124          ;;
 125     udf)
 126          [ "$MKFS_UDF_PROG" = "" ] && _fatal "mkfs_udf/mkudffs not found"
 127          ;;
 128     btrfs)
 129          [ "$MKFS_BTRFS_PROG" = "" ] && _fatal "mkfs.btrfs not found"
 130
 131          . ./common/btrfs
 132          ;;
 133     ext4)
 134          [ "$MKFS_EXT4_PROG" = "" ] && _fatal "mkfs.ext4 not found"
 135          ;;
 136     f2fs)
 137          [ "$MKFS_F2FS_PROG" = "" ] && _fatal "mkfs.f2fs not found"
 138          ;;
 139     nfs)
 140          . ./common/nfs
 141          ;;
 142     cifs)
 143          ;;
 144     9p)
 145          ;;
 146     ceph)
 147          ;;
 148     glusterfs)
 149          ;;
 150     overlay)
 151          . ./common/overlay
 152          ;;
 153     reiser4)
 154          [ "$MKFS_REISER4_PROG" = "" ] && _fatal "mkfs.reiser4 not found"
 155          ;;
 156     pvfs2)
 157         ;;
 158     ubifs)
 159         [ "$UBIUPDATEVOL_PROG" = "" ] && _fatal "ubiupdatevol not found"
 160         ;;
 161 esac
 162
 163 if [ ! -z "$REPORT_LIST" ]; then
 164         . ./common/report
 165         _assert_report_list
 166 fi
 167
 168 _mount()
 169 {
 170     $MOUNT_PROG `_mount_ops_filter $*`
 171 }
 172
 173 # Call _mount to do mount operation but also save mountpoint to
 174 # MOUNTED_POINT_STACK. Note that the mount point must be the last parameter
 175 _get_mount()
 176 {
 177         local mnt_point=${!#}
 178         local mnt_dev=${@:(-2):1}
 179         local scratch_opts=""
 180         if [ "$mnt_dev" = "$SCRATCH_DEV" ]; then
 181                 _scratch_options mount
 182                 scratch_opts="$SCRATCH_OPTIONS"
 183         fi
 184
 185         _mount $scratch_opts $*
 186         if [ $? -eq 0 ]; then
 187                 MOUNTED_POINT_STACK="$mnt_point $MOUNTED_POINT_STACK"
 188         else
 189                 return 1
 190         fi
 191 }
 192
 193 # Unmount the last mounted mountpoint in MOUNTED_POINT_STACK
 194 # and return it to caller
 195 _put_mount()
 196 {
 197         local last_mnt=`echo $MOUNTED_POINT_STACK | awk '{print $1}'`
 198
 199         if [ -n "$last_mnt" ]; then
 200                 $UMOUNT_PROG $last_mnt
 201         fi
 202         MOUNTED_POINT_STACK=`echo $MOUNTED_POINT_STACK | cut -d\  -f2-`
 203 }
 204
 205 # Unmount all mountpoints in MOUNTED_POINT_STACK and clear the stack
 206 _clear_mount_stack()
 207 {
 208         if [ -n "$MOUNTED_POINT_STACK" ]; then
 209                 $UMOUNT_PROG $MOUNTED_POINT_STACK
 210         fi
 211         MOUNTED_POINT_STACK=""
 212 }
 213
 214 _scratch_options()
 215 {
 216     local type=$1
 217     local rt_opt=""
 218     local log_opt=""
 219     SCRATCH_OPTIONS=""
 220
 221     if [ "$FSTYP" != "xfs" ]; then
 222         return
 223     fi
 224
 225     case $type in
 226     mkfs)
 227         SCRATCH_OPTIONS="$SCRATCH_OPTIONS -f"
 228         rt_opt="-r"
 229         log_opt="-l"
 230         ;;
 231     mount)
 232         rt_opt="-o"
 233         log_opt="-o"
 234         ;;
 235     esac
 236     [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
 237         SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${rt_opt}rtdev=$SCRATCH_RTDEV"
 238     [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
 239         SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${log_opt}logdev=$SCRATCH_LOGDEV"
 240 }
 241
 242 _test_options()
 243 {
 244     local type=$1
 245     local rt_opt=""
 246     local log_opt=""
 247     TEST_OPTIONS=""
 248
 249     if [ "$FSTYP" != "xfs" ]; then
 250         return
 251     fi
 252
 253     case $type in
 254     mkfs)
 255         rt_opt="-r"
 256         log_opt="-l"
 257         ;;
 258     mount)
 259         rt_opt="-o"
 260         log_opt="-o"
 261         ;;
 262     esac
 263     [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_RTDEV" ] && \
 264         TEST_OPTIONS="$TEST_OPTIONS ${rt_opt}rtdev=$TEST_RTDEV"
 265     [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_LOGDEV" ] && \
 266         TEST_OPTIONS="$TEST_OPTIONS ${log_opt}logdev=$TEST_LOGDEV"
 267 }
 268
 269 _mount_ops_filter()
 270 {
 271     local params="$*"
 272     local last_index=$(( $# - 1 ))
 273
 274     #get mount point to handle dmapi mtpt option correctly
 275     [ $last_index -gt 0 ] && shift $last_index
 276     local fs_escaped=$1
 277
 278     echo $params | sed -e 's/dmapi/dmi/' \
 279         | $PERL_PROG -ne "s#mtpt=[^,|^\n|^\s]*#mtpt=$fs_escaped\1\2#; print;"
 280
 281 }
 282
 283 # Used for mounting non-scratch devices (e.g. loop, dm constructs)
 284 # with the safe set of scratch mount options (e.g. loop image may be
 285 # hosted on $SCRATCH_DEV, so can't use external scratch devices).
 286 _common_dev_mount_options()
 287 {
 288         echo $MOUNT_OPTIONS $SELINUX_MOUNT_OPTIONS $*
 289 }
 290
 291 _scratch_mount_options()
 292 {
 293         _scratch_options mount
 294
 295         echo `_common_dev_mount_options $*` $SCRATCH_OPTIONS \
 296                                         $SCRATCH_DEV $SCRATCH_MNT
 297 }
 298
 299 _supports_filetype()
 300 {
 301         local dir=$1
 302
 303         local fstyp=`$DF_PROG $dir | tail -1 | $AWK_PROG '{print $2}'`
 304         case "$fstyp" in
 305         xfs)
 306                 $XFS_INFO_PROG $dir | grep -q "ftype=1"
 307                 ;;
 308         ext2|ext3|ext4)
 309                 local dev=`$DF_PROG $dir | tail -1 | $AWK_PROG '{print $1}'`
 310                 tune2fs -l $dev | grep -q filetype
 311                 ;;
 312         *)
 313                 local testfile=$dir/$$.ftype
 314                 touch $testfile
 315                 # look for DT_UNKNOWN files
 316                 local unknowns=$(src/t_dir_type $dir u | wc -l)
 317                 rm $testfile
 318                 # 0 unknowns is success
 319                 return $unknowns
 320                 ;;
 321         esac
 322 }
 323
 324 # mount scratch device with given options but don't check mount status
 325 _try_scratch_mount()
 326 {
 327         if [ "$FSTYP" == "overlay" ]; then
 328                 _overlay_scratch_mount $*
 329                 return $?
 330         fi
 331         _mount -t $FSTYP `_scratch_mount_options $*`
 332 }
 333
 334 # mount scratch device with given options and _fail if mount fails
 335 _scratch_mount()
 336 {
 337         _try_scratch_mount $* || _fail "mount failed"
 338 }
 339
 340 _scratch_unmount()
 341 {
 342         case "$FSTYP" in
 343         overlay)
 344                 _overlay_scratch_unmount
 345                 ;;
 346         btrfs)
 347                 $UMOUNT_PROG $SCRATCH_MNT
 348                 ;;
 349         *)
 350                 $UMOUNT_PROG $SCRATCH_DEV
 351                 ;;
 352         esac
 353 }
 354
 355 _scratch_remount()
 356 {
 357     local opts="$1"
 358
 359     if test -n "$opts"; then
 360         _try_scratch_mount "-o remount,$opts"
 361     fi
 362 }
 363
 364 _scratch_cycle_mount()
 365 {
 366     local opts="$1"
 367
 368     if [ "$FSTYP" = tmpfs ]; then
 369         _scratch_remount "$opts"
 370         return
 371     fi
 372     if test -n "$opts"; then
 373         opts="-o $opts"
 374     fi
 375     _scratch_unmount
 376     _try_scratch_mount "$opts" || _fail "cycle mount failed"
 377 }
 378
 379 _scratch_shutdown()
 380 {
 381         if [ $FSTYP = "overlay" ]; then
 382                 # In lagacy overlay usage, it may specify directory as
 383                 # SCRATCH_DEV, in this case OVL_BASE_SCRATCH_DEV
 384                 # will be null, so check OVL_BASE_SCRATCH_DEV before
 385                 # running shutdown to avoid shutting down base fs accidently.
 386                 if [ -z $OVL_BASE_SCRATCH_DEV ]; then
 387                         _fail "_scratch_shutdown: call _require_scratch_shutdown first in test"
 388                 else
 389                         src/godown $* $OVL_BASE_SCRATCH_MNT
 390                 fi
 391         else
 392                 src/godown $* $SCRATCH_MNT
 393         fi
 394 }
 395
 396 # Return a file path that can be used to shut down the scratch filesystem.
 397 # Caller should _require_scratch_shutdown before using this.
 398 _scratch_shutdown_handle()
 399 {
 400         if [ $FSTYP = "overlay" ]; then
 401                 echo $OVL_BASE_SCRATCH_MNT
 402         else
 403                 echo $SCRATCH_MNT
 404         fi
 405 }
 406
 407 _test_mount()
 408 {
 409     if [ "$FSTYP" == "overlay" ]; then
 410         _overlay_test_mount $*
 411         return $?
 412     fi
 413     _test_options mount
 414     _mount -t $FSTYP $TEST_OPTIONS $TEST_FS_MOUNT_OPTS $SELINUX_MOUNT_OPTIONS $* $TEST_DEV $TEST_DIR
 415 }
 416
 417 _test_unmount()
 418 {
 419         if [ "$FSTYP" == "overlay" ]; then
 420                 _overlay_test_unmount
 421         else
 422                 $UMOUNT_PROG $TEST_DEV
 423         fi
 424 }
 425
 426 _test_cycle_mount()
 427 {
 428     if [ "$FSTYP" = tmpfs ]; then
 429         return
 430     fi
 431     _test_unmount
 432     _test_mount
 433 }
 434
 435 _scratch_mkfs_options()
 436 {
 437     _scratch_options mkfs
 438     echo $SCRATCH_OPTIONS $MKFS_OPTIONS $* $SCRATCH_DEV
 439 }
 440
 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.
 444 #
 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.
 448 _scratch_do_mkfs()
 449 {
 450         local mkfs_cmd=$1
 451         local mkfs_filter=$2
 452         shift 2
 453         local extra_mkfs_options=$*
 454         local mkfs_status
 455         local tmp=`mktemp -u`
 456
 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
 461         mkfs_status=$?
 462
 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
 466                 (
 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 **"
 471                 ) >> $seqres.full
 472
 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
 476                 mkfs_status=$?
 477         fi
 478
 479         # output stored mkfs output, filtering unnecessary output from stderr
 480         cat $tmp.mkfsstd
 481         eval "cat $tmp.mkfserr | $mkfs_filter" >&2
 482
 483         rm -f $tmp.mkfserr $tmp.mkfsstd
 484         return $mkfs_status
 485 }
 486
 487 _scratch_metadump()
 488 {
 489         local dumpfile=$1
 490         shift
 491         local options=
 492
 493         [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
 494                 options="-l $SCRATCH_LOGDEV"
 495
 496         xfs_metadump $options "$@" $SCRATCH_DEV $dumpfile
 497 }
 498
 499 _setup_large_ext4_fs()
 500 {
 501         local fs_size=$1
 502         local tmp_dir=/tmp/
 503
 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
 507
 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))
 511
 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
 515         local status=$?
 516         if [ $status -ne 0 ]; then
 517                 echo "mount failed"
 518                 cat $tmp_dir/mnt.err >&2
 519                 rm -f $tmp_dir/mnt.err
 520                 return $status
 521         fi
 522         rm -f $tmp_dir/mnt.err
 523
 524         local file_size=$((16*1024*1024*1024*1024 - 4096))
 525         local nfiles=0
 526         while [ $space_to_consume -gt $file_size ]; do
 527
 528                 xfs_io -F -f \
 529                         -c "truncate $file_size" \
 530                         -c "falloc -k 0 $file_size" \
 531                         $SCRATCH_MNT/.use_space.$nfiles 2>&1
 532                 status=$?
 533                 if [ $status -ne 0 ]; then
 534                         break;
 535                 fi
 536
 537                 space_to_consume=$(( $space_to_consume - $file_size ))
 538                 nfiles=$(($nfiles + 1))
 539         done
 540
 541         # consume the remaining space.
 542         if [ $space_to_consume -gt 0 ]; then
 543                 xfs_io -F -f \
 544                         -c "truncate $space_to_consume" \
 545                         -c "falloc -k 0 $space_to_consume" \
 546                         $SCRATCH_MNT/.use_space.$nfiles 2>&1
 547                 status=$?
 548         fi
 549         export NUM_SPACE_FILES=$nfiles
 550
 551         _scratch_unmount
 552         if [ $status -ne 0 ]; then
 553                 echo "large file prealloc failed"
 554                 cat $tmp_dir/mnt.err >&2
 555                 return $status
 556         fi
 557         return 0
 558 }
 559
 560 _scratch_mkfs_ext4()
 561 {
 562         local mkfs_cmd="$MKFS_EXT4_PROG -F"
 563         local mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
 564         local tmp=`mktemp -u`
 565         local mkfs_status
 566
 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"
 570
 571         _scratch_do_mkfs "$mkfs_cmd" "$mkfs_filter" $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
 572         mkfs_status=$?
 573
 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 }'`
 581
 582                 _setup_large_ext4_fs $fs_size
 583                 mkfs_status=$?
 584         fi
 585
 586         # output mkfs stdout and stderr
 587         cat $tmp.mkfsstd
 588         cat $tmp.mkfserr >&2
 589         rm -f $tmp.mkfserr $tmp.mkfsstd
 590
 591         return $mkfs_status
 592 }
 593
 594 _test_mkfs()
 595 {
 596     case $FSTYP in
 597     nfs*)
 598         # do nothing for nfs
 599         ;;
 600     cifs)
 601         # do nothing for cifs
 602         ;;
 603     9p)
 604         # do nothing for 9p
 605         ;;
 606     virtiofs)
 607         # do nothing for virtiofs
 608         ;;
 609     ceph)
 610         # do nothing for ceph
 611         ;;
 612     glusterfs)
 613         # do nothing for glusterfs
 614         ;;
 615     overlay)
 616         # do nothing for overlay
 617         ;;
 618     pvfs2)
 619         # do nothing for pvfs2
 620         ;;
 621     udf)
 622         $MKFS_UDF_PROG $MKFS_OPTIONS $* $TEST_DEV > /dev/null
 623         ;;
 624     btrfs)
 625         $MKFS_BTRFS_PROG $MKFS_OPTIONS $* $TEST_DEV > /dev/null
 626         ;;
 627     ext2|ext3|ext4)
 628         $MKFS_PROG -t $FSTYP -- -F $MKFS_OPTIONS $* $TEST_DEV
 629         ;;
 630     *)
 631         yes | $MKFS_PROG -t $FSTYP -- $MKFS_OPTIONS $* $TEST_DEV
 632         ;;
 633     esac
 634 }
 635
 636 _mkfs_dev()
 637 {
 638     local tmp=`mktemp -u`
 639     case $FSTYP in
 640     nfs*)
 641         # do nothing for nfs
 642         ;;
 643     9p)
 644         # do nothing for 9p
 645         ;;
 646     virtiofs)
 647         # do nothing for virtiofs
 648         ;;
 649     overlay)
 650         # do nothing for overlay
 651         ;;
 652     pvfs2)
 653         # do nothing for pvfs2
 654         ;;
 655     udf)
 656         $MKFS_UDF_PROG $MKFS_OPTIONS $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
 657         ;;
 658     btrfs)
 659         $MKFS_BTRFS_PROG $MKFS_OPTIONS $* 2>$tmp.mkfserr 1>$tmp.mkfsstd
 660         ;;
 661     ext2|ext3|ext4)
 662         $MKFS_PROG -t $FSTYP -- -F $MKFS_OPTIONS $* \
 663                 2>$tmp.mkfserr 1>$tmp.mkfsstd
 664         ;;
 665     xfs)
 666         $MKFS_PROG -t $FSTYP -- -f $MKFS_OPTIONS $* \
 667                 2>$tmp.mkfserr 1>$tmp.mkfsstd
 668         ;;
 669     *)
 670         yes | $MKFS_PROG -t $FSTYP -- $MKFS_OPTIONS $* \
 671                 2>$tmp.mkfserr 1>$tmp.mkfsstd
 672         ;;
 673     esac
 674
 675     if [ $? -ne 0 ]; then
 676         # output stored mkfs output
 677         cat $tmp.mkfserr >&2
 678         cat $tmp.mkfsstd
 679         status=1
 680         exit 1
 681     fi
 682     rm -f $tmp.mkfserr $tmp.mkfsstd
 683 }
 684
 685 # remove all files in $SCRATCH_MNT, useful when testing on NFS/CIFS
 686 _scratch_cleanup_files()
 687 {
 688         case $FSTYP in
 689         overlay)
 690                 # Avoid rm -rf /* if we messed up
 691                 [ -n "$OVL_BASE_SCRATCH_MNT" ] || return 1
 692                 _overlay_base_scratch_mount || return 1
 693                 rm -rf $OVL_BASE_SCRATCH_MNT/* || return 1
 694                 _overlay_mkdirs $OVL_BASE_SCRATCH_MNT
 695                 # leave base fs mouted so tests can setup lower/upper dir files
 696                 ;;
 697         *)
 698                 [ -n "$SCRATCH_MNT" ] || return 1
 699                 _scratch_mount
 700                 rm -rf $SCRATCH_MNT/*
 701                 _scratch_unmount
 702                 ;;
 703         esac
 704 }
 705
 706 _scratch_mkfs()
 707 {
 708         local mkfs_cmd=""
 709         local mkfs_filter=""
 710         local mkfs_status
 711
 712         case $FSTYP in
 713         nfs*|cifs|ceph|overlay|glusterfs|pvfs2|9p|virtiofs)
 714                 # unable to re-create this fstyp, just remove all files in
 715                 # $SCRATCH_MNT to avoid EEXIST caused by the leftover files
 716                 # created in previous runs
 717                 _scratch_cleanup_files
 718                 return $?
 719                 ;;
 720         tmpfs)
 721                 # do nothing for tmpfs
 722                 return 0
 723                 ;;
 724         ubifs)
 725                 # erase the UBI volume; reformated automatically on next mount
 726                 $UBIUPDATEVOL_PROG ${SCRATCH_DEV} -t
 727                 return 0
 728                 ;;
 729         ext4)
 730                 _scratch_mkfs_ext4 $*
 731                 return $?
 732                 ;;
 733         xfs)
 734                 _scratch_mkfs_xfs $*
 735                 return $?
 736                 ;;
 737         udf)
 738                 mkfs_cmd="$MKFS_UDF_PROG"
 739                 mkfs_filter="cat"
 740                 ;;
 741         btrfs)
 742                 mkfs_cmd="$MKFS_BTRFS_PROG"
 743                 mkfs_filter="cat"
 744                 ;;
 745         ext3)
 746                 mkfs_cmd="$MKFS_PROG -t $FSTYP -- -F"
 747                 mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
 748
 749                 # put journal on separate device?
 750                 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
 751                 $mkfs_cmd -O journal_dev $MKFS_OPTIONS $SCRATCH_LOGDEV && \
 752                 mkfs_cmd="$mkfs_cmd -J device=$SCRATCH_LOGDEV"
 753                 ;;
 754         ext2)
 755                 mkfs_cmd="$MKFS_PROG -t $FSTYP -- -F"
 756                 mkfs_filter="grep -v -e ^Warning: -e \"^mke2fs \""
 757                 ;;
 758         f2fs)
 759                 mkfs_cmd="$MKFS_F2FS_PROG"
 760                 mkfs_filter="cat"
 761                 ;;
 762         ocfs2)
 763                 mkfs_cmd="yes | $MKFS_PROG -t $FSTYP --"
 764                 mkfs_filter="grep -v -e ^mkfs\.ocfs2"
 765                 ;;
 766         *)
 767                 mkfs_cmd="yes | $MKFS_PROG -t $FSTYP --"
 768                 mkfs_filter="cat"
 769                 ;;
 770         esac
 771
 772         _scratch_do_mkfs "$mkfs_cmd" "$mkfs_filter" $*
 773         return $?
 774 }
 775
 776 # Helper function to get a spare or replace-target device from
 777 # configured SCRATCH_DEV_POLL, must call _scratch_dev_pool_get()
 778 # before _spare_dev_get(). Replace-target-device/Spare-device will
 779 # be assigned to SPARE_DEV.
 780 # As of now only one replace-target-device/spare-device can be
 781 # assigned.
 782 #
 783 # Usage:
 784 #  _scratch_dev_pool_get() <ndevs>
 785 #     _spare_dev_get()
 786 #     :: do stuff
 787 #     _spare_dev_put()
 788 #  _scratch_dev_pool_put()
 789 #
 790 _spare_dev_get()
 791 {
 792         typeset -p SCRATCH_DEV_POOL_SAVED >/dev/null 2>&1
 793         if [ $? -ne 0 ]; then
 794                 _fail "Bug: unset val, must call _scratch_dev_pool_get before _spare_dev_get"
 795         fi
 796
 797         if [ -z "$SCRATCH_DEV_POOL_SAVED" ]; then
 798                 _fail "Bug: str empty, must call _scratch_dev_pool_get before _spare_dev_get"
 799         fi
 800
 801         # Check if the spare is already assigned
 802         typeset -p SPARE_DEV >/dev/null 2>&1
 803         if [ $? -eq 0 ]; then
 804                 if [ ! -z "$SPARE_DEV" ]; then
 805                         _fail "Bug: SPARE_DEV = $SPARE_DEV already assigned"
 806                 fi
 807         fi
 808
 809         local ndevs=`echo $SCRATCH_DEV_POOL| wc -w`
 810         local config_ndevs=`echo $SCRATCH_DEV_POOL_SAVED| wc -w`
 811
 812         if [ $ndevs -eq $config_ndevs ]; then
 813                 _notrun "All devs used no spare"
 814         fi
 815         # Get a dev that is not used
 816         local -a devs="( $SCRATCH_DEV_POOL_SAVED )"
 817         SPARE_DEV=${devs[@]:$ndevs:1}
 818         export SPARE_DEV
 819 }
 820
 821 _spare_dev_put()
 822 {
 823         typeset -p SPARE_DEV >/dev/null 2>&1
 824         if [ $? -ne 0 ]; then
 825                 _fail "Bug: unset val, must call _spare_dev_get before its put"
 826         fi
 827
 828         if [ -z "$SPARE_DEV" ]; then
 829                 _fail "Bug: str empty, must call _spare_dev_get before its put"
 830         fi
 831
 832         export SPARE_DEV=""
 833 }
 834
 835 #
 836 # Generally test cases will have..
 837 #   _require_scratch_dev_pool X
 838 # to make sure it has the enough scratch devices including
 839 # replace-target and spare device. Now arg1 here is the
 840 # required number of scratch devices by a-test-case excluding
 841 # the replace-target and spare device. So this function will
 842 # set SCRATCH_DEV_POOL to the specified number of devices.
 843 #
 844 # Usage:
 845 #  _scratch_dev_pool_get() <ndevs>
 846 #     :: do stuff
 847 #
 848 #  _scratch_dev_pool_put()
 849 #
 850 _scratch_dev_pool_get()
 851 {
 852         if [ $# -ne 1 ]; then
 853                 _fail "Usage: _scratch_dev_pool_get ndevs"
 854         fi
 855
 856         local test_ndevs=$1
 857         local config_ndevs=`echo $SCRATCH_DEV_POOL| wc -w`
 858         local -a devs="( $SCRATCH_DEV_POOL )"
 859
 860         typeset -p config_ndevs >/dev/null 2>&1
 861         if [ $? -ne 0 ]; then
 862                 _fail "Bug: cant find SCRATCH_DEV_POOL ndevs"
 863         fi
 864
 865         if [ $config_ndevs -lt $test_ndevs ]; then
 866                 _notrun "Need at least test requested number of ndevs $test_ndevs"
 867         fi
 868
 869         SCRATCH_DEV_POOL_SAVED=${SCRATCH_DEV_POOL}
 870         export SCRATCH_DEV_POOL_SAVED
 871         SCRATCH_DEV_POOL=${devs[@]:0:$test_ndevs}
 872         export SCRATCH_DEV_POOL
 873 }
 874
 875 _scratch_dev_pool_put()
 876 {
 877         typeset -p SCRATCH_DEV_POOL_SAVED >/dev/null 2>&1
 878         if [ $? -ne 0 ]; then
 879                 _fail "Bug: unset val, must call _scratch_dev_pool_get before _scratch_dev_pool_put"
 880         fi
 881
 882         if [ -z "$SCRATCH_DEV_POOL_SAVED" ]; then
 883                 _fail "Bug: str empty, must call _scratch_dev_pool_get before _scratch_dev_pool_put"
 884         fi
 885
 886         export SCRATCH_DEV_POOL=$SCRATCH_DEV_POOL_SAVED
 887         export SCRATCH_DEV_POOL_SAVED=""
 888 }
 889
 890 _scratch_pool_mkfs()
 891 {
 892     case $FSTYP in
 893     btrfs)
 894         $MKFS_BTRFS_PROG $MKFS_OPTIONS $* $SCRATCH_DEV_POOL > /dev/null
 895         ;;
 896     *)
 897         echo "_scratch_pool_mkfs is not implemented for $FSTYP" 1>&2
 898         ;;
 899     esac
 900 }
 901
 902 # Return the amount of free memory available on the system
 903 _free_memory_bytes()
 904 {
 905     free -b | grep ^Mem | awk '{print $4}'
 906 }
 907
 908 # Create fs of certain size on scratch device
 909 # _scratch_mkfs_sized <size in bytes> [optional blocksize]
 910 _scratch_mkfs_sized()
 911 {
 912     local fssize=$1
 913     local blocksize=$2
 914     local def_blksz
 915
 916     case $FSTYP in
 917     xfs)
 918         def_blksz=`echo $MKFS_OPTIONS|sed -rn 's/.*-b ?size= ?+([0-9]+).*/\1/p'`
 919         ;;
 920     ext2|ext3|ext4|ext4dev|udf|btrfs|reiser4|ocfs2|reiserfs)
 921         def_blksz=`echo $MKFS_OPTIONS| sed -rn 's/.*-b ?+([0-9]+).*/\1/p'`
 922         ;;
 923     jfs)
 924         def_blksz=4096
 925         ;;
 926     esac
 927
 928     [ -n "$def_blksz" ] && blocksize=$def_blksz
 929     [ -z "$blocksize" ] && blocksize=4096
 930
 931
 932     local re='^[0-9]+$'
 933     if ! [[ $fssize =~ $re ]] ; then
 934         _notrun "error: _scratch_mkfs_sized: fs size \"$fssize\" not an integer."
 935     fi
 936     if ! [[ $blocksize =~ $re ]] ; then
 937         _notrun "error: _scratch_mkfs_sized: block size \"$blocksize\" not an integer."
 938     fi
 939
 940     local blocks=`expr $fssize / $blocksize`
 941
 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"
 945     fi
 946
 947     case $FSTYP in
 948     xfs)
 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
 953         else
 954                 _scratch_mkfs_xfs -d size=$fssize -b size=$blocksize
 955         fi
 956         ;;
 957     ext2|ext3|ext4|ext4dev)
 958         ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
 959         ;;
 960     gfs2)
 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"
 972         fi
 973         ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -O -b $blocksize $SCRATCH_DEV $blocks
 974         ;;
 975     ocfs2)
 976         yes | ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
 977         ;;
 978     udf)
 979         $MKFS_UDF_PROG $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
 980         ;;
 981     btrfs)
 982         local mixed_opt=
 983         # minimum size that's needed without the mixed option.
 984         # Ref: btrfs-prog: btrfs_min_dev_size()
 985         # Non mixed mode is also the default option.
 986         (( fssize < $((256 * 1024 *1024)) )) && mixed_opt='--mixed'
 987         $MKFS_BTRFS_PROG $MKFS_OPTIONS $mixed_opt -b $fssize $SCRATCH_DEV
 988         ;;
 989     jfs)
 990         ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS $SCRATCH_DEV $blocks
 991         ;;
 992     reiserfs)
 993         ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV $blocks
 994         ;;
 995     reiser4)
 996         # mkfs.resier4 requires size in KB as input for creating filesystem
 997         $MKFS_REISER4_PROG $MKFS_OPTIONS -y -b $blocksize $SCRATCH_DEV \
 998                            `expr $fssize / 1024`
 999         ;;
1000     f2fs)
1001         # mkfs.f2fs requires # of sectors as an input for the size
1002         local sector_size=`blockdev --getss $SCRATCH_DEV`
1003         $MKFS_F2FS_PROG $MKFS_OPTIONS $SCRATCH_DEV `expr $fssize / $sector_size`
1004         ;;
1005     tmpfs)
1006         local free_mem=`_free_memory_bytes`
1007         if [ "$free_mem" -lt "$fssize" ] ; then
1008            _notrun "Not enough memory ($free_mem) for tmpfs with $fssize bytes"
1009         fi
1010         export MOUNT_OPTIONS="-o size=$fssize $TMPFS_MOUNT_OPTIONS"
1011         ;;
1012     *)
1013         _notrun "Filesystem $FSTYP not supported in _scratch_mkfs_sized"
1014         ;;
1015     esac
1016 }
1017
1018 # Emulate an N-data-disk stripe w/ various stripe units
1019 # _scratch_mkfs_geom <sunit bytes> <swidth multiplier> [optional blocksize]
1020 _scratch_mkfs_geom()
1021 {
1022     local sunit_bytes=$1
1023     local swidth_mult=$2
1024     local blocksize=$3
1025     [ -z "$blocksize" ] && blocksize=4096
1026
1027     local sunit_blocks=$(( sunit_bytes / blocksize ))
1028     local swidth_blocks=$(( sunit_blocks * swidth_mult ))
1029
1030     case $FSTYP in
1031     xfs)
1032         MKFS_OPTIONS+=" -b size=$blocksize, -d su=$sunit_bytes,sw=$swidth_mult"
1033         ;;
1034     ext4|ext4dev)
1035         MKFS_OPTIONS+=" -b $blocksize -E stride=$sunit_blocks,stripe_width=$swidth_blocks"
1036         ;;
1037     *)
1038         _notrun "can't mkfs $FSTYP with geometry"
1039         ;;
1040     esac
1041     _scratch_mkfs
1042 }
1043
1044 # Create fs of certain blocksize on scratch device
1045 # _scratch_mkfs_blocksized blocksize
1046 _scratch_mkfs_blocksized()
1047 {
1048     local blocksize=$1
1049
1050     local re='^[0-9]+$'
1051     if ! [[ $blocksize =~ $re ]] ; then
1052         _notrun "error: _scratch_mkfs_sized: block size \"$blocksize\" not an integer."
1053     fi
1054
1055     case $FSTYP in
1056     xfs)
1057         _scratch_mkfs_xfs $MKFS_OPTIONS -b size=$blocksize
1058         ;;
1059     ext2|ext3|ext4)
1060         ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize $SCRATCH_DEV
1061         ;;
1062     gfs2)
1063         ${MKFS_PROG}.$FSTYP $MKFS_OPTIONS -O -b $blocksize $SCRATCH_DEV
1064         ;;
1065     ocfs2)
1066         yes | ${MKFS_PROG}.$FSTYP -F $MKFS_OPTIONS -b $blocksize -C $blocksize $SCRATCH_DEV
1067         ;;
1068     *)
1069         _notrun "Filesystem $FSTYP not supported in _scratch_mkfs_blocksized"
1070         ;;
1071     esac
1072 }
1073
1074 _scratch_resvblks()
1075 {
1076         case $FSTYP in
1077         xfs)
1078                 xfs_io -x -c "resblks $1" $SCRATCH_MNT
1079                 ;;
1080         *)
1081                 ;;
1082         esac
1083 }
1084
1085
1086 # Repair scratch filesystem.  Returns 0 if the FS is good to go (either no
1087 # errors found or errors were fixed) and nonzero otherwise; also spits out
1088 # a complaint on stderr if fsck didn't tell us that the FS is good to go.
1089 _repair_scratch_fs()
1090 {
1091     case $FSTYP in
1092     xfs)
1093         _scratch_xfs_repair "$@" 2>&1
1094         local res=$?
1095         if [ "$res" -ne 0 ]; then
1096                 echo "xfs_repair returns $res; replay log?"
1097                 _try_scratch_mount
1098                 res=$?
1099                 if [ "$res" -gt 0 ]; then
1100                         echo "mount returns $res; zap log?"
1101                         _scratch_xfs_repair -L 2>&1
1102                         echo "log zap returns $?"
1103                 else
1104                         umount "$SCRATCH_MNT"
1105                 fi
1106                 _scratch_xfs_repair "$@" 2>&1
1107                 res=$?
1108         fi
1109         if [ $res -ne 0 ]; then
1110                 _dump_err2 "xfs_repair failed, err=$res"
1111         fi
1112         return $res
1113         ;;
1114     *)
1115         local dev=$SCRATCH_DEV
1116         local fstyp=$FSTYP
1117         if [ $FSTYP = "overlay" -a -n "$OVL_BASE_SCRATCH_DEV" ]; then
1118                 _repair_overlay_scratch_fs
1119                 # Fall through to repair base fs
1120                 dev=$OVL_BASE_SCRATCH_DEV
1121                 fstyp=$OVL_BASE_FSTYP
1122                 $UMOUNT_PROG $OVL_BASE_SCRATCH_MNT
1123         fi
1124         # Let's hope fsck -y suffices...
1125         fsck -t $fstyp -y $dev 2>&1
1126         local res=$?
1127         case $res in
1128         $FSCK_OK|$FSCK_NONDESTRUCT|$FSCK_REBOOT)
1129                 res=0
1130                 ;;
1131         *)
1132                 _dump_err2 "fsck.$FSTYP failed, err=$res"
1133                 ;;
1134         esac
1135         return $res
1136         ;;
1137     esac
1138 }
1139
1140 _get_pids_by_name()
1141 {
1142     if [ $# -ne 1 ]
1143     then
1144         echo "Usage: _get_pids_by_name process-name" 1>&2
1145         exit 1
1146     fi
1147
1148     # Algorithm ... all ps(1) variants have a time of the form MM:SS or
1149     # HH:MM:SS before the psargs field, use this as the search anchor.
1150     #
1151     # Matches with $1 (process-name) occur if the first psarg is $1
1152     # or ends in /$1 ... the matching uses sed's regular expressions,
1153     # so passing a regex into $1 will work.
1154
1155     ps $PS_ALL_FLAGS \
1156     | sed -n \
1157         -e 's/$/ /' \
1158         -e 's/[         ][      ]*/ /g' \
1159         -e 's/^ //' \
1160         -e 's/^[^ ]* //' \
1161         -e "/[0-9]:[0-9][0-9]  *[^ ]*\/$1 /s/ .*//p" \
1162         -e "/[0-9]:[0-9][0-9]  *$1 /s/ .*//p"
1163 }
1164
1165 #
1166 # _df_device : get an IRIX style df line for a given device
1167 #
1168 #       - returns "" if not mounted
1169 #       - returns fs type in field two (ala IRIX)
1170 #       - joins line together if split by fancy df formatting
1171 #       - strips header etc
1172 #
1173
1174 _df_device()
1175 {
1176     if [ $# -ne 1 ]
1177     then
1178         echo "Usage: _df_device device" 1>&2
1179         exit 1
1180     fi
1181
1182     # Note that we use "==" here so awk doesn't try to interpret an NFS over
1183     # IPv6 server as a regular expression.
1184     $DF_PROG 2>/dev/null | $AWK_PROG -v what=$1 '
1185         ($1==what) && (NF==1) {
1186             v=$1
1187             getline
1188             print v, $0
1189             exit
1190         }
1191         ($1==what) {
1192             print
1193             exit
1194         }
1195     '
1196 }
1197
1198 #
1199 # _df_dir : get an IRIX style df line for device where a directory resides
1200 #
1201 #       - returns fs type in field two (ala IRIX)
1202 #       - joins line together if split by fancy df formatting
1203 #       - strips header etc
1204 #
1205
1206 _df_dir()
1207 {
1208     if [ $# -ne 1 ]
1209     then
1210         echo "Usage: _df_dir device" 1>&2
1211         exit 1
1212     fi
1213
1214     $DF_PROG $1 2>/dev/null | $AWK_PROG -v what=$1 '
1215         NR == 2 && NF==1 {
1216             v=$1
1217             getline
1218             print v, $0;
1219             exit 0
1220         }
1221         NR == 2 {
1222             print;
1223             exit 0
1224         }
1225         {}
1226     '
1227     # otherwise, nada
1228 }
1229
1230 # return percentage used disk space for mounted device
1231
1232 _used()
1233 {
1234     if [ $# -ne 1 ]
1235     then
1236         echo "Usage: _used device" 1>&2
1237         exit 1
1238     fi
1239
1240     _df_device $1 | $AWK_PROG '{ sub("%", "") ; print $6 }'
1241 }
1242
1243 # return the FS type of a mounted device
1244 #
1245 _fs_type()
1246 {
1247     if [ $# -ne 1 ]
1248     then
1249         echo "Usage: _fs_type device" 1>&2
1250         exit 1
1251     fi
1252
1253     #
1254     # The Linux kernel shows NFSv4 filesystems in df output as
1255     # filesystem type nfs4, although we mounted it as nfs earlier.
1256     # Fix the filesystem type up here so that the callers don't
1257     # have to bother with this quirk.
1258     #
1259     _df_device $1 | $AWK_PROG '{ print $2 }' | \
1260         sed -e 's/nfs4/nfs/' -e 's/fuse.glusterfs/glusterfs/'
1261 }
1262
1263 # return the FS mount options of a mounted device
1264 #
1265 # should write a version which just parses the output of mount for IRIX
1266 # compatibility, but since this isn't used at all, at the moment I'll leave
1267 # this for now
1268 #
1269 _fs_options()
1270 {
1271     if [ $# -ne 1 ]
1272     then
1273         echo "Usage: _fs_options device" 1>&2
1274         exit 1
1275     fi
1276
1277     $AWK_PROG -v dev=$1 '
1278         match($1,dev) { print $4 }
1279     ' </proc/mounts
1280 }
1281
1282 # returns device number if a file is a block device
1283 #
1284 _is_block_dev()
1285 {
1286     if [ $# -ne 1 ]
1287     then
1288         echo "Usage: _is_block_dev dev" 1>&2
1289         exit 1
1290     fi
1291
1292     local dev=$1
1293     if [ -L "$dev" ]; then
1294         dev=`readlink -f "$dev"`
1295     fi
1296
1297     if [ -b "$dev" ]; then
1298         src/lstat64 "$dev" | $AWK_PROG '/Device type:/ { print $9 }'
1299     fi
1300 }
1301
1302 # returns device number if a file is a character device
1303 #
1304 _is_char_dev()
1305 {
1306         if [ $# -ne 1 ]; then
1307                 echo "Usage: _is_char_dev dev" 1>&2
1308                 exit 1
1309         fi
1310
1311         local dev=$1
1312         if [ -L "$dev" ]; then
1313                 dev=`readlink -f "$dev"`
1314         fi
1315
1316         if [ -c "$dev" ]; then
1317                 src/lstat64 "$dev" | $AWK_PROG '/Device type:/ { print $9 }'
1318         fi
1319 }
1320
1321 # Do a command, log it to $seqres.full, optionally test return status
1322 # and die if command fails. If called with one argument _do executes the
1323 # command, logs it, and returns its exit status. With two arguments _do
1324 # first prints the message passed in the first argument, and then "done"
1325 # or "fail" depending on the return status of the command passed in the
1326 # second argument. If the command fails and the variable _do_die_on_error
1327 # is set to "always" or the two argument form is used and _do_die_on_error
1328 # is set to "message_only" _do will print an error message to
1329 # $seqres.out and exit.
1330
1331 _do()
1332 {
1333     if [ $# -eq 1 ]; then
1334         local cmd=$1
1335     elif [ $# -eq 2 ]; then
1336         local note=$1
1337         local cmd=$2
1338         echo -n "$note... "
1339     else
1340         echo "Usage: _do [note] cmd" 1>&2
1341         status=1; exit
1342     fi
1343
1344     (eval "echo '---' \"$cmd\"") >>$seqres.full
1345     (eval "$cmd") >$tmp._out 2>&1
1346     local ret=$?
1347     cat $tmp._out >>$seqres.full
1348     rm -f $tmp._out
1349     if [ $# -eq 2 ]; then
1350         if [ $ret -eq 0 ]; then
1351             echo "done"
1352         else
1353             echo "fail"
1354         fi
1355     fi
1356     if [ $ret -ne 0  ] \
1357         && [ "$_do_die_on_error" = "always" \
1358             -o \( $# -eq 2 -a "$_do_die_on_error" = "message_only" \) ]
1359     then
1360         [ $# -ne 2 ] && echo
1361         eval "echo \"$cmd\" failed \(returned $ret\): see $seqres.full"
1362         status=1; exit
1363     fi
1364
1365     return $ret
1366 }
1367
1368 # bail out, setting up .notrun file. Need to kill the filesystem check files
1369 # here, otherwise they are set incorrectly for the next test.
1370 #
1371 _notrun()
1372 {
1373     echo "$*" > $seqres.notrun
1374     echo "$seq not run: $*"
1375     rm -f ${RESULT_DIR}/require_test*
1376     rm -f ${RESULT_DIR}/require_scratch*
1377
1378     status=0
1379     exit
1380 }
1381
1382 # just plain bail out
1383 #
1384 _fail()
1385 {
1386     echo "$*" | tee -a $seqres.full
1387     echo "(see $seqres.full for details)"
1388     status=1
1389     exit 1
1390 }
1391
1392 # tests whether $FSTYP is one of the supported filesystems for a test
1393 #
1394 _supported_fs()
1395 {
1396     local f
1397
1398     for f
1399     do
1400         if [ "$f" = "$FSTYP" -o "$f" = "generic" ]
1401         then
1402             return
1403         fi
1404     done
1405
1406     _notrun "not suitable for this filesystem type: $FSTYP"
1407 }
1408
1409
1410 # tests whether $FSTYP is one of the supported OSes for a test
1411 #
1412 _supported_os()
1413 {
1414     local h
1415
1416     for h
1417     do
1418         if [ "$h" = "$HOSTOS" ]
1419         then
1420             return
1421         fi
1422     done
1423
1424     _notrun "not suitable for this OS: $HOSTOS"
1425 }
1426
1427 # check if a FS on a device is mounted
1428 # if so, verify that it is mounted on mount point
1429 # if fstype is given as argument, verify that it is also
1430 # mounted with correct fs type
1431 #
1432 _check_mounted_on()
1433 {
1434         local devname=$1
1435         local dev=$2
1436         local mntname=$3
1437         local mnt=$4
1438         local type=$5
1439
1440         # find $dev as the source, and print result in "$dev $mnt" format
1441         local mount_rec=`findmnt -rncv -S $dev -o SOURCE,TARGET`
1442         [ -n "$mount_rec" ] || return 1 # 1 = not mounted
1443
1444         # if it's mounted, make sure its on $mnt
1445         if [ "$mount_rec" != "$dev $mnt" ]; then
1446                 echo "$devname=$dev is mounted but not on $mntname=$mnt - aborting"
1447                 echo "Already mounted result:"
1448                 echo $mount_rec
1449                 return 2 # 2 = mounted on wrong mnt
1450         fi
1451
1452         if [ -n "$type" -a "`_fs_type $dev`" != "$type" ]; then
1453                 echo "$devname=$dev is mounted but not a type $type filesystem"
1454                 # raw $DF_PROG cannot handle NFS/CIFS/overlay correctly
1455                 _df_device $dev
1456                 return 3 # 3 = mounted as wrong type
1457         fi
1458         return 0 # 0 = mounted as expected
1459 }
1460
1461 # this test needs a scratch partition - check we're ok & unmount it
1462 # No post-test check of the device is required. e.g. the test intentionally
1463 # finishes the test with the filesystem in a corrupt state
1464 _require_scratch_nocheck()
1465 {
1466     case "$FSTYP" in
1467         glusterfs)
1468                 echo $SCRATCH_DEV | egrep -q ":/?" > /dev/null 2>&1
1469                 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1470                         _notrun "this test requires a valid \$SCRATCH_DEV"
1471                 fi
1472                 if [ ! -d "$SCRATCH_MNT" ]; then
1473                         _notrun "this test requires a valid \$SCRATCH_MNT"
1474                 fi
1475                 ;;
1476         9p|virtiofs)
1477                 if [ -z "$SCRATCH_DEV" ]; then
1478                         _notrun "this test requires a valid \$SCRATCH_DEV"
1479                 fi
1480                 if [ ! -d "$SCRATCH_MNT" ]; then
1481                         _notrun "this test requires a valid \$SCRATCH_MNT"
1482                 fi
1483                 ;;
1484         nfs*|ceph)
1485                 echo $SCRATCH_DEV | grep -q ":/" > /dev/null 2>&1
1486                 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1487                         _notrun "this test requires a valid \$SCRATCH_DEV"
1488                 fi
1489                 if [ ! -d "$SCRATCH_MNT" ]; then
1490                         _notrun "this test requires a valid \$SCRATCH_MNT"
1491                 fi
1492                 ;;
1493         pvfs2)
1494                 echo $SCRATCH_DEV | grep -q "://" > /dev/null 2>&1
1495                 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1496                         _notrun "this test requires a valid \$SCRATCH_DEV"
1497                 fi
1498                 if [ ! -d "$SCRATCH_MNT" ]; then
1499                         _notrun "this test requires a valid \$SCRATCH_MNT"
1500                 fi
1501                 ;;
1502         cifs)
1503                 echo $SCRATCH_DEV | grep -q "//" > /dev/null 2>&1
1504                 if [ -z "$SCRATCH_DEV" -o "$?" != "0" ]; then
1505                         _notrun "this test requires a valid \$SCRATCH_DEV"
1506                 fi
1507                 if [ ! -d "$SCRATCH_MNT" ]; then
1508                      _notrun "this test requires a valid \$SCRATCH_MNT"
1509                 fi
1510                 ;;
1511         overlay)
1512                 if [ -z "$OVL_BASE_SCRATCH_MNT" -o ! -d "$OVL_BASE_SCRATCH_MNT" ]; then
1513                         _notrun "this test requires a valid \$OVL_BASE_SCRATCH_MNT as ovl base dir"
1514                 fi
1515                 # if $SCRATCH_MNT is derived from $OVL_BASE_SCRATCH_MNT then
1516                 # don't check $SCRATCH_MNT dir here because base fs may not be mounted
1517                 # and we will create the mount point anyway on _overlay_mount
1518                 if [ "$SCRATCH_MNT" != "$OVL_BASE_SCRATCH_MNT/$OVL_MNT" -a ! -d "$SCRATCH_MNT" ]; then
1519                         _notrun "this test requires a valid \$SCRATCH_MNT"
1520                 fi
1521                 ;;
1522         tmpfs)
1523                 if [ -z "$SCRATCH_DEV" -o ! -d "$SCRATCH_MNT" ];
1524                 then
1525                     _notrun "this test requires a valid \$SCRATCH_MNT and unique $SCRATCH_DEV"
1526                 fi
1527                 ;;
1528         ubifs)
1529                 # ubifs needs an UBI volume. This will be a char device, not a block device.
1530                 if [ ! -c "$SCRATCH_DEV" ]; then
1531                         _notrun "this test requires a valid UBI volume for \$SCRATCH_DEV"
1532                 fi
1533                 if [ ! -d "$SCRATCH_MNT" ]; then
1534                         _notrun "this test requires a valid \$SCRATCH_MNT"
1535                 fi
1536                 ;;
1537         *)
1538                  if [ -z "$SCRATCH_DEV" -o "`_is_block_dev "$SCRATCH_DEV"`" = "" ]
1539                  then
1540                      _notrun "this test requires a valid \$SCRATCH_DEV"
1541                  fi
1542                  if [ "`_is_block_dev "$SCRATCH_DEV"`" = "`_is_block_dev "$TEST_DEV"`" ]
1543                  then
1544                      _notrun "this test requires a valid \$SCRATCH_DEV"
1545                  fi
1546                 if [ ! -d "$SCRATCH_MNT" ]
1547                 then
1548                      _notrun "this test requires a valid \$SCRATCH_MNT"
1549                 fi
1550                  ;;
1551     esac
1552
1553     _check_mounted_on SCRATCH_DEV $SCRATCH_DEV SCRATCH_MNT $SCRATCH_MNT
1554     local err=$?
1555     [ $err -le 1 ] || exit 1
1556     if [ $err -eq 0 ]
1557     then
1558         # if it's mounted, unmount it
1559         if ! _scratch_unmount
1560         then
1561             echo "failed to unmount $SCRATCH_DEV"
1562             exit 1
1563         fi
1564     fi
1565     rm -f ${RESULT_DIR}/require_scratch
1566 }
1567
1568 # we need the scratch device and it should be checked post test.
1569 _require_scratch()
1570 {
1571         _require_scratch_nocheck
1572         touch ${RESULT_DIR}/require_scratch
1573 }
1574
1575 # require a scratch dev of a minimum size (in kb)
1576 _require_scratch_size()
1577 {
1578         [ $# -eq 1 ] || _fail "_require_scratch_size: expected size param"
1579
1580         _require_scratch
1581         local devsize=`_get_device_size $SCRATCH_DEV`
1582         [ $devsize -lt $1 ] && _notrun "scratch dev too small"
1583 }
1584
1585
1586 # this test needs a test partition - check we're ok & mount it
1587 #
1588 _require_test()
1589 {
1590     case "$FSTYP" in
1591         glusterfs)
1592                 echo $TEST_DEV | egrep -q ":/?" > /dev/null 2>&1
1593                 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1594                         _notrun "this test requires a valid \$TEST_DEV"
1595                 fi
1596                 if [ ! -d "$TEST_DIR" ]; then
1597                         _notrun "this test requires a valid \$TEST_DIR"
1598                 fi
1599                 ;;
1600         9p|virtiofs)
1601                 if [ -z "$TEST_DEV" ]; then
1602                         _notrun "this test requires a valid \$TEST_DEV"
1603                 fi
1604                 if [ ! -d "$TEST_DIR" ]; then
1605                         _notrun "this test requires a valid \$TEST_DIR"
1606                 fi
1607                 ;;
1608         nfs*|ceph)
1609                 echo $TEST_DEV | grep -q ":/" > /dev/null 2>&1
1610                 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1611                         _notrun "this test requires a valid \$TEST_DEV"
1612                 fi
1613                 if [ ! -d "$TEST_DIR" ]; then
1614                         _notrun "this test requires a valid \$TEST_DIR"
1615                 fi
1616                 ;;
1617         cifs)
1618                 echo $TEST_DEV | grep -q "//" > /dev/null 2>&1
1619                 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1620                         _notrun "this test requires a valid \$TEST_DEV"
1621                 fi
1622                 if [ ! -d "$TEST_DIR" ]; then
1623                      _notrun "this test requires a valid \$TEST_DIR"
1624                 fi
1625                 ;;
1626         pvfs2)
1627                 echo $TEST_DEV | grep -q "://" > /dev/null 2>&1
1628                 if [ -z "$TEST_DEV" -o "$?" != "0" ]; then
1629                         _notrun "this test requires a valid \$TEST_DIR"
1630                 fi
1631                 if [ ! -d "$TEST_DIR" ]; then
1632                         _notrun "this test requires a valid \$TEST_DIR"
1633                 fi
1634                 ;;
1635         overlay)
1636                 if [ -z "$OVL_BASE_TEST_DIR" -o ! -d "$OVL_BASE_TEST_DIR" ]; then
1637                         _notrun "this test requires a valid \$TEST_DIR as ovl base dir"
1638                 fi
1639                 if [ ! -d "$TEST_DIR" ]; then
1640                         _notrun "this test requires a valid \$TEST_DIR"
1641                 fi
1642                 ;;
1643         tmpfs)
1644                 if [ -z "$TEST_DEV" -o ! -d "$TEST_DIR" ];
1645                 then
1646                     _notrun "this test requires a valid \$TEST_DIR and unique $TEST_DEV"
1647                 fi
1648                 ;;
1649         ubifs)
1650                 # ubifs needs an UBI volume. This will be a char device, not a block device.
1651                 if [ ! -c "$TEST_DEV" ]; then
1652                         _notrun "this test requires a valid UBI volume for \$TEST_DEV"
1653                 fi
1654                 if [ ! -d "$TEST_DIR" ]; then
1655                         _notrun "this test requires a valid \$TEST_DIR"
1656                 fi
1657                 ;;
1658         *)
1659                  if [ -z "$TEST_DEV" ] || [ "`_is_block_dev "$TEST_DEV"`" = "" ]
1660                  then
1661                      _notrun "this test requires a valid \$TEST_DEV"
1662                  fi
1663                  if [ "`_is_block_dev "$SCRATCH_DEV"`" = "`_is_block_dev "$TEST_DEV"`" ]
1664                  then
1665                      _notrun "this test requires a valid \$TEST_DEV"
1666                  fi
1667                 if [ ! -d "$TEST_DIR" ]
1668                 then
1669                      _notrun "this test requires a valid \$TEST_DIR"
1670                 fi
1671                  ;;
1672     esac
1673
1674     _check_mounted_on TEST_DEV $TEST_DEV TEST_DIR $TEST_DIR
1675     local err=$?
1676     [ $err -le 1 ] || exit 1
1677     if [ $err -ne 0 ]
1678     then
1679         if ! _test_mount
1680         then
1681                 echo "!!! failed to mount $TEST_DEV on $TEST_DIR"
1682                 exit 1
1683         fi
1684     fi
1685     touch ${RESULT_DIR}/require_test
1686 }
1687
1688 _has_logdev()
1689 {
1690         local ret=0
1691         [ -z "$SCRATCH_LOGDEV" -o ! -b "$SCRATCH_LOGDEV" ] && ret=1
1692         [ "$USE_EXTERNAL" != yes ] && ret=1
1693
1694         return $ret
1695 }
1696
1697 # this test needs a logdev
1698 #
1699 _require_logdev()
1700 {
1701     [ -z "$SCRATCH_LOGDEV" -o ! -b "$SCRATCH_LOGDEV" ] && \
1702         _notrun "This test requires a valid \$SCRATCH_LOGDEV"
1703     [ "$USE_EXTERNAL" != yes ] && \
1704         _notrun "This test requires USE_EXTERNAL to be enabled"
1705
1706     # ensure its not mounted
1707     $UMOUNT_PROG $SCRATCH_LOGDEV 2>/dev/null
1708 }
1709
1710 # this test requires loopback device support
1711 #
1712 _require_loop()
1713 {
1714     if [ "$HOSTOS" != "Linux" ]
1715     then
1716         _notrun "This test requires linux for loopback device support"
1717     fi
1718
1719     modprobe loop >/dev/null 2>&1
1720     if grep loop /proc/devices >/dev/null 2>&1
1721     then
1722         :
1723     else
1724         _notrun "This test requires loopback device support"
1725     fi
1726 }
1727
1728 # this test requires ext2 filesystem support
1729 #
1730 _require_ext2()
1731 {
1732     if [ "$HOSTOS" != "Linux" ]
1733     then
1734         _notrun "This test requires linux for ext2 filesystem support"
1735     fi
1736
1737     modprobe ext2 >/dev/null 2>&1
1738     if grep ext2 /proc/filesystems >/dev/null 2>&1
1739     then
1740         :
1741     else
1742         _notrun "This test requires ext2 filesystem support"
1743     fi
1744 }
1745
1746 # this test requires tmpfs filesystem support
1747 #
1748 _require_tmpfs()
1749 {
1750         modprobe tmpfs >/dev/null 2>&1
1751         grep -q tmpfs /proc/filesystems ||
1752                 _notrun "this test requires tmpfs support"
1753 }
1754
1755 # this test requires that (large) loopback device files are not in use
1756 #
1757 _require_no_large_scratch_dev()
1758 {
1759     [ "$LARGE_SCRATCH_DEV" = yes ] && \
1760         _notrun "Large filesystem testing in progress, skipped this test"
1761 }
1762
1763 # this test requires that a realtime subvolume is in use, and
1764 # that the kernel supports realtime as well.
1765 #
1766 _require_realtime()
1767 {
1768     [ "$USE_EXTERNAL" = yes ] || \
1769         _notrun "External volumes not in use, skipped this test"
1770     [ "$SCRATCH_RTDEV" = "" ] && \
1771         _notrun "Realtime device required, skipped this test"
1772 }
1773
1774 # This test requires that a realtime subvolume is not in use
1775 #
1776 _require_no_realtime()
1777 {
1778         [ "$USE_EXTERNAL" = "yes" ] && [ -n "$SCRATCH_RTDEV" ] && \
1779                 _notrun "Test not compatible with realtime subvolumes, skipped this test"
1780 }
1781
1782 # this test requires that a specified command (executable) exists
1783 # $1 - command, $2 - name for error message
1784 #
1785 # Note: the command string might have parameters, so strip them before checking
1786 # whether it is executable.
1787 _require_command()
1788 {
1789         if [ $# -eq 2 ]; then
1790                 local name="$2"
1791         elif [ $# -eq 1 ]; then
1792                 local name="$1"
1793         else
1794                 _fail "usage: _require_command <command> [<name>]"
1795         fi
1796
1797         local command=`echo "$1" | awk '{ print $1 }'`
1798         if [ ! -x "$command" ]; then
1799                 _notrun "$name utility required, skipped this test"
1800         fi
1801 }
1802
1803 # this test requires the device to be valid block device
1804 # $1 - device
1805 _require_block_device()
1806 {
1807         if [ -z "$1" ]; then
1808                 echo "Usage: _require_block_device <dev>" 1>&2
1809                 exit 1
1810         fi
1811         if [ "`_is_block_dev "$1"`" == "" ]; then
1812                 _notrun "require $1 to be valid block disk"
1813         fi
1814 }
1815
1816 # this test requires a path to refere to a local block or character device
1817 # $1 - device
1818 _require_local_device()
1819 {
1820         if [ -z "$1" ]; then
1821                 echo "Usage: _require_local_device <dev>" 1>&2
1822                 exit 1
1823         fi
1824         if [ "`_is_block_dev "$1"`" != "" ]; then
1825                 return 0
1826         fi
1827         if [ "`_is_char_dev "$1"`" != "" ]; then
1828                 return 0
1829         fi
1830         _notrun "require $1 to be local device"
1831 }
1832
1833 # brd based ram disks erase the device when they receive a flush command when no
1834 # active references are present. This causes problems for DM devices sitting on
1835 # top of brd devices as DM doesn't hold active references to the brd device.
1836 _require_sane_bdev_flush()
1837 {
1838         echo $1 | grep -q "^/dev/ram[0-9]\+$"
1839         if [ $? -eq 0 ]; then
1840                 _notrun "This test requires a sane block device flush"
1841         fi
1842 }
1843
1844 # this test requires a specific device mapper target
1845 _require_dm_target()
1846 {
1847         local target=$1
1848
1849         # require SCRATCH_DEV to be a valid block device with sane BLKFLSBUF
1850         # behaviour
1851         _require_block_device $SCRATCH_DEV
1852         _require_sane_bdev_flush $SCRATCH_DEV
1853         _require_command "$DMSETUP_PROG" dmsetup
1854
1855         modprobe dm-$target >/dev/null 2>&1
1856
1857         $DMSETUP_PROG targets 2>&1 | grep -q ^$target
1858         if [ $? -ne 0 ]; then
1859                 _notrun "This test requires dm $target support"
1860         fi
1861 }
1862
1863 # this test requires the ext4 kernel support crc feature on scratch device
1864 #
1865 _require_scratch_ext4_crc()
1866 {
1867         _scratch_mkfs_ext4 >/dev/null 2>&1
1868         dumpe2fs -h $SCRATCH_DEV 2> /dev/null | grep -q metadata_csum || _notrun "metadata_csum not supported by this filesystem"
1869         _try_scratch_mount >/dev/null 2>&1 \
1870            || _notrun "Kernel doesn't support metadata_csum feature"
1871         _scratch_unmount
1872 }
1873
1874 # Check whether the specified feature whether it is supported by
1875 # mkfs.ext4 and the kernel.
1876 _require_scratch_ext4_feature()
1877 {
1878     if [ -z "$1" ]; then
1879         echo "Usage: _require_scratch_ext4_feature feature"
1880         exit 1
1881     fi
1882     $MKFS_EXT4_PROG -F $MKFS_OPTIONS -O "$1" \
1883                     $SCRATCH_DEV 512m >/dev/null 2>&1 \
1884         || _notrun "mkfs.ext4 doesn't support $1 feature"
1885     _try_scratch_mount >/dev/null 2>&1 \
1886         || _notrun "Kernel doesn't support the ext4 feature(s): $1"
1887     _scratch_unmount
1888 }
1889
1890 # this test requires that external log/realtime devices are not in use
1891 #
1892 _require_nonexternal()
1893 {
1894     [ "$USE_EXTERNAL" = yes ] && \
1895         _notrun "External device testing in progress, skipped this test"
1896 }
1897
1898 # this test requires that the kernel supports asynchronous I/O
1899 _require_aio()
1900 {
1901         $here/src/feature -A
1902         case $? in
1903         0)
1904                 ;;
1905         1)
1906                 _notrun "kernel does not support asynchronous I/O"
1907                 ;;
1908         *)
1909                 _fail "unexpected error testing for asynchronous I/O support"
1910                 ;;
1911         esac
1912 }
1913
1914 # this test requires that a (specified) aio-dio executable exists
1915 # and that the kernel supports asynchronous I/O.
1916 # $1 - command (optional)
1917 #
1918 _require_aiodio()
1919 {
1920     if [ -z "$1" ]
1921     then
1922         AIO_TEST=src/aio-dio-regress/aiodio_sparse2
1923         [ -x $AIO_TEST ] || _notrun "aio-dio utilities required"
1924     else
1925         AIO_TEST=src/aio-dio-regress/$1
1926         [ -x $AIO_TEST ] || _notrun "$AIO_TEST not built"
1927     fi
1928     _require_aio
1929     _require_odirect
1930 }
1931
1932 # this test requires that a test program exists under src/
1933 # $1 - command (require)
1934 #
1935 _require_test_program()
1936 {
1937     local prog=src/$1
1938     [ -x $prog ] || _notrun "$prog not built"
1939 }
1940
1941 # run an aio-dio program
1942 # $1 - command
1943 _run_aiodio()
1944 {
1945     if [ -z "$1" ]
1946     then
1947         echo "usage: _run_aiodio command_name" 2>&1
1948         status=1; exit 1
1949     fi
1950
1951     _require_aiodio $1
1952
1953     local testtemp=$TEST_DIR/aio-testfile
1954     rm -f $testtemp
1955     $AIO_TEST $testtemp 2>&1
1956     status=$?
1957     rm -f $testtemp
1958
1959     return $status
1960 }
1961
1962 # this test requires y2038 sysfs switch and filesystem
1963 # timestamp ranges support.
1964 _require_y2038()
1965 {
1966         local device=${1:-$TEST_DEV}
1967         local sysfsdir=/proc/sys/fs/fs-timestamp-check-on
1968
1969         if [ ! -e $sysfsdir ]; then
1970                 _notrun "no kernel support for y2038 sysfs switch"
1971         fi
1972
1973         local tsmin tsmax
1974         read tsmin tsmax <<<$(_filesystem_timestamp_range $device)
1975         if [ $tsmin -eq -1 -a $tsmax -eq -1 ]; then
1976                 _notrun "filesystem $FSTYP timestamp bounds are unknown"
1977         fi
1978 }
1979
1980 _filesystem_timestamp_range()
1981 {
1982         local device=${1:-$TEST_DEV}
1983         case $FSTYP in
1984         ext4)
1985                 if [ $(dumpe2fs -h $device 2>/dev/null | grep "Inode size:" | cut -d: -f2) -gt 128 ]; then
1986                         echo "-2147483648 15032385535"
1987                 else
1988                         echo "-2147483648 2147483647"
1989                 fi
1990                 ;;
1991
1992         xfs)
1993                 echo "-2147483648 2147483647"
1994                 ;;
1995         jfs)
1996                 echo "0 4294967295"
1997                 ;;
1998         f2fs)
1999                 echo "-2147483648 2147483647"
2000                 ;;
2001         *)
2002                 echo "-1 -1"
2003                 ;;
2004         esac
2005 }
2006
2007 # indicate whether YP/NIS is active or not
2008 #
2009 _yp_active()
2010 {
2011         local dn
2012         dn=$(domainname 2>/dev/null)
2013         local ypcat=$(type -P ypcat)
2014         local rpcinfo=$(type -P rpcinfo)
2015         test -n "${dn}" -a "${dn}" != "(none)" -a "${dn}" != "localdomain" -a -n "${ypcat}" -a -n "${rpcinfo}" && \
2016                 "${rpcinfo}" -p localhost 2>/dev/null | grep -q ypbind
2017         echo $?
2018 }
2019
2020 # cat the password file
2021 #
2022 _cat_passwd()
2023 {
2024         [ $(_yp_active) -eq 0 ] && ypcat passwd
2025         cat /etc/passwd
2026 }
2027
2028 # cat the group file
2029 #
2030 _cat_group()
2031 {
2032         [ $(_yp_active) -eq 0 ] && ypcat group
2033         cat /etc/group
2034 }
2035
2036 # check for a user on the machine, fsgqa as default
2037 #
2038 _require_user()
2039 {
2040     qa_user=fsgqa
2041     if [ -n "$1" ];then
2042         qa_user=$1
2043     fi
2044     _cat_passwd | grep -q $qa_user
2045     [ "$?" == "0" ] || _notrun "$qa_user user not defined."
2046     echo /bin/true | su $qa_user
2047     [ "$?" == "0" ] || _notrun "$qa_user cannot execute commands."
2048 }
2049
2050 # check for a group on the machine, fsgqa as default
2051 #
2052 _require_group()
2053 {
2054     qa_group=fsgqa
2055     if [ -n "$1" ];then
2056         qa_group=$1
2057     fi
2058     _cat_group | grep -q $qa_group
2059     [ "$?" == "0" ] || _notrun "$qa_group group not defined."
2060 }
2061
2062 _filter_user_do()
2063 {
2064         perl -ne "
2065 s,.*Permission\sdenied.*,Permission denied,;
2066 s,.*no\saccess\sto\stty.*,,;
2067 s,.*no\sjob\scontrol\sin\sthis\sshell.*,,;
2068 s,^\s*$,,;
2069         print;"
2070 }
2071
2072 _user_do()
2073 {
2074         echo $1 | su -s /bin/bash $qa_user 2>&1 | _filter_user_do
2075 }
2076
2077 _require_xfs_io_command()
2078 {
2079         if [ -z "$1" ]
2080         then
2081                 echo "Usage: _require_xfs_io_command command [switch]" 1>&2
2082                 exit 1
2083         fi
2084         local command=$1
2085         shift
2086         local param="$*"
2087         local param_checked=""
2088         local opts=""
2089
2090         local testfile=$TEST_DIR/$$.xfs_io
2091         local testio
2092         case $command in
2093         "chattr")
2094                 if [ -z "$param" ]; then
2095                         param=s
2096                 fi
2097                 # Test xfs_io chattr support AND
2098                 # filesystem FS_IOC_FSSETXATTR support
2099                 testio=`$XFS_IO_PROG -F -f -c "chattr +$param" $testfile 2>&1`
2100                 $XFS_IO_PROG -F -f -r -c "chattr -$param" $testfile 2>&1
2101                 param_checked="+$param"
2102                 ;;
2103         "chproj")
2104                 testio=`$XFS_IO_PROG -F -f -c "chproj 0" $testfile 2>&1`
2105                 ;;
2106         "copy_range")
2107                 local testcopy=$TEST_DIR/$$.copy.xfs_io
2108                 local copy_opts=$testfile
2109                 if [ "$param" == "-f" ]; then
2110                         # source file is the open destination file
2111                         testcopy=$testfile
2112                         copy_opts="0 -d 4k -l 4k"
2113                 fi
2114                 $XFS_IO_PROG -F -f -c "pwrite 0 4k" $testfile > /dev/null 2>&1
2115                 testio=`$XFS_IO_PROG -F -f -c "copy_range $param $copy_opts" $testcopy 2>&1`
2116                 rm -f $testcopy > /dev/null 2>&1
2117                 param_checked="$param"
2118                 ;;
2119         "falloc" )
2120                 testio=`$XFS_IO_PROG -F -f -c "falloc $param 0 1m" $testfile 2>&1`
2121                 param_checked="$param"
2122                 ;;
2123         "fpunch" | "fcollapse" | "zero" | "fzero" | "finsert" | "funshare")
2124                 local blocksize=$(_get_block_size $TEST_DIR)
2125                 testio=`$XFS_IO_PROG -F -f -c "pwrite 0 $((5 * $blocksize))" \
2126                         -c "fsync" -c "$command $blocksize $((2 * $blocksize))" \
2127                         $testfile 2>&1`
2128                 ;;
2129         "fiemap")
2130                 # If 'ranged' is passed as argument then we check to see if fiemap supports
2131                 # ranged query params
2132                 if echo "$param" | grep -q "ranged"; then
2133                         param=$(echo "$param" | sed "s/ranged//")
2134                         $XFS_IO_PROG -c "help fiemap" | grep -q "\[offset \[len\]\]"
2135                         [ $? -eq 0 ] || _notrun "xfs_io $command ranged support is missing"
2136                 fi
2137                 testio=`$XFS_IO_PROG -F -f -c "pwrite 0 20k" -c "fsync" \
2138                         -c "fiemap -v $param" $testfile 2>&1`
2139                 param_checked="$param"
2140                 ;;
2141         "flink")
2142                 local testlink=$TEST_DIR/$$.link.xfs_io
2143                 testio=`$XFS_IO_PROG -F -f -c "flink $testlink" $testfile 2>&1`
2144                 rm -f $testlink > /dev/null 2>&1
2145                 ;;
2146         "-T")
2147                 # Check O_TMPFILE support in xfs_io, kernel and fs
2148                 testio=`$XFS_IO_PROG -T -c quit $TEST_DIR 2>&1`
2149                 echo $testio | egrep -q "invalid option|Is a directory" && \
2150                         _notrun "xfs_io $command support is missing"
2151                 echo $testio | grep -q "Operation not supported" && \
2152                         _notrun "O_TMPFILE is not supported"
2153                 ;;
2154         "fsmap")
2155                 testio=`$XFS_IO_PROG -f -c "fsmap" $testfile 2>&1`
2156                 echo $testio | grep -q "Inappropriate ioctl" && \
2157                         _notrun "xfs_io $command support is missing"
2158                 ;;
2159         "label")
2160                 testio=`$XFS_IO_PROG -c "label" $TEST_DIR 2>&1`
2161                 ;;
2162         "open")
2163                 # -c "open $f" is broken in xfs_io <= 4.8. Along with the fix,
2164                 # a new -C flag was introduced to execute one shot commands.
2165                 # Check for -C flag support as an indication for the bug fix.
2166                 testio=`$XFS_IO_PROG -F -f -C "open $testfile" $testfile 2>&1`
2167                 echo $testio | grep -q "invalid option" && \
2168                         _notrun "xfs_io $command support is missing"
2169                 ;;
2170         "pwrite")
2171                 # -N (RWF_NOWAIT) only works with direct vectored I/O writes
2172                 local pwrite_opts=" "
2173                 if [ "$param" == "-N" ]; then
2174                         opts+=" -d"
2175                         pwrite_opts+="-V 1 -b 4k"
2176                 fi
2177                 testio=`$XFS_IO_PROG -f $opts -c \
2178                         "pwrite $pwrite_opts $param 0 4k" $testfile 2>&1`
2179                 param_checked="$pwrite_opts $param"
2180                 ;;
2181         "scrub"|"repair")
2182                 testio=`$XFS_IO_PROG -x -c "$command probe" $TEST_DIR 2>&1`
2183                 echo $testio | grep -q "Inappropriate ioctl" && \
2184                         _notrun "xfs_io $command support is missing"
2185                 ;;
2186         "utimes" )
2187                 testio=`$XFS_IO_PROG -f -c "utimes" 0 0 0 0 $testfile 2>&1`
2188                 ;;
2189         "syncfs")
2190                 touch $testfile
2191                 testio=`$XFS_IO_PROG -c "syncfs" $testfile 2>&1`
2192                 ;;
2193         *)
2194                 testio=`$XFS_IO_PROG -c "help $command" 2>&1`
2195         esac
2196
2197         rm -f $testfile 2>&1 > /dev/null
2198         echo $testio | grep -q "not found" && \
2199                 _notrun "xfs_io $command $param_checked support is missing"
2200         echo $testio | grep -q "Operation not supported\|Inappropriate ioctl" && \
2201                 _notrun "xfs_io $command $param_checked failed (old kernel/wrong fs?)"
2202         echo $testio | grep -q "Invalid" && \
2203                 _notrun "xfs_io $command $param_checked failed (old kernel/wrong fs/bad args?)"
2204         echo $testio | grep -q "foreign file active" && \
2205                 _notrun "xfs_io $command $param_checked not supported on $FSTYP"
2206         echo $testio | grep -q "Function not implemented" && \
2207                 _notrun "xfs_io $command $param_checked support is missing (missing syscall?)"
2208
2209         [ -n "$param" ] || return
2210
2211         if [ -z "$param_checked" ]; then
2212                 $XFS_IO_PROG -c "help $command" | grep -q "^ $param --" || \
2213                         _notrun "xfs_io $command doesn't support $param"
2214         else
2215                 # xfs_io could result in "command %c not supported" if it was
2216                 # built on kernels not supporting pwritev2() calls
2217                 echo $testio | grep -q "\(invalid option\|not supported\)" && \
2218                         _notrun "xfs_io $command doesn't support $param"
2219         fi
2220 }
2221
2222 # check that kernel and filesystem support direct I/O
2223 _require_odirect()
2224 {
2225         if [ $FSTYP = "ext4" ] ; then
2226                 if echo "$MOUNT_OPTIONS" | grep -q "test_dummy_encryption"; then
2227                         _notrun "ext4 encryption doesn't support O_DIRECT"
2228                 elif echo "$MOUNT_OPTIONS" | grep -q "data=journal"; then
2229                         _notrun "ext4 data journaling doesn't support O_DIRECT"
2230                 fi
2231         fi
2232         local testfile=$TEST_DIR/$$.direct
2233         $XFS_IO_PROG -F -f -d -c "pwrite 0 20k" $testfile > /dev/null 2>&1
2234         if [ $? -ne 0 ]; then
2235                 _notrun "O_DIRECT is not supported"
2236         fi
2237         rm -f $testfile 2>&1 > /dev/null
2238 }
2239
2240 _format_swapfile() {
2241         local fname="$1"
2242         local sz="$2"
2243
2244         rm -f "$fname"
2245         touch "$fname"
2246         chmod 0600 "$fname"
2247         # Swap files must be nocow on Btrfs.
2248         $CHATTR_PROG +C "$fname" > /dev/null 2>&1
2249         _pwrite_byte 0x61 0 "$sz" "$fname" >> $seqres.full
2250         $MKSWAP_PROG "$fname" >> $seqres.full
2251 }
2252
2253 # Check that the filesystem supports swapfiles
2254 _require_scratch_swapfile()
2255 {
2256         _require_scratch
2257         _require_command "$MKSWAP_PROG" "mkswap"
2258
2259         _scratch_mkfs >/dev/null
2260
2261         # With mounting SELinux context(e.g. system_u:object_r:root_t:s0),
2262         # standard mkswap tried to reset the type of default context to
2263         # swapfile_t if it's not swapfile_t, and then it failed and returned
2264         # ENOTSUP expectedly as we don't want to create any SELinux attr on
2265         # purpose.  standard mkswap ignored this relabel error by commit
2266         # d97dc0e of util-linux, but it still reported the error before
2267         # commit d97dc0e.  We mount swapfile context directly to skip the
2268         # reset step.
2269         [ -n "$SELINUX_MOUNT_OPTIONS" ] && export \
2270                 SELINUX_MOUNT_OPTIONS="-o context=system_u:object_r:swapfile_t:s0"
2271
2272         _scratch_mount
2273
2274         # Minimum size for mkswap is 10 pages
2275         _format_swapfile "$SCRATCH_MNT/swap" $(($(get_page_size) * 10))
2276
2277         if ! swapon "$SCRATCH_MNT/swap" >/dev/null 2>&1; then
2278                 _scratch_unmount
2279                 _notrun "swapfiles are not supported"
2280         fi
2281
2282         swapoff "$SCRATCH_MNT/swap" >/dev/null 2>&1
2283         _scratch_unmount
2284 }
2285
2286 # Check that a fs has enough free space (in 1024b blocks)
2287 #
2288 _require_fs_space()
2289 {
2290         local mnt=$1
2291         local blocks=$2 # in units of 1024
2292         local gb=$(( blocks / 1024 / 1024 ))
2293
2294         local free_blocks=`df -kP $mnt | grep -v Filesystem | awk '{print $4}'`
2295         [ $free_blocks -lt $blocks ] && \
2296                 _notrun "This test requires at least ${gb}GB free on $mnt to run"
2297 }
2298
2299 #
2300 # Check if the filesystem supports sparse files.
2301 #
2302 # Unfortunately there is no better way to do this than a manual black list.
2303 #
2304 _require_sparse_files()
2305 {
2306     case $FSTYP in
2307     hfsplus)
2308         _notrun "Sparse files not supported by this filesystem type: $FSTYP"
2309         ;;
2310     *)
2311         ;;
2312     esac
2313 }
2314
2315 _require_debugfs()
2316 {
2317     #boot_params always present in debugfs
2318     [ -d "$DEBUGFS_MNT/boot_params" ] || _notrun "Debugfs not mounted"
2319 }
2320
2321 _require_fail_make_request()
2322 {
2323     [ -f "$DEBUGFS_MNT/fail_make_request/probability" ] \
2324         || _notrun "$DEBUGFS_MNT/fail_make_request \
2325  not found. Seems that CONFIG_FAIL_MAKE_REQUEST kernel config option not enabled"
2326 }
2327
2328 # Disable extent zeroing for ext4 on the given device
2329 _ext4_disable_extent_zeroout()
2330 {
2331         local dev=${1:-$TEST_DEV}
2332         local sdev=`_short_dev $dev`
2333
2334         [ -f /sys/fs/ext4/$sdev/extent_max_zeroout_kb ] && \
2335                 echo 0 >/sys/fs/ext4/$sdev/extent_max_zeroout_kb
2336 }
2337
2338 # The default behavior of SEEK_HOLE is to always return EOF.
2339 # Filesystems that implement non-default behavior return the offset
2340 # of holes with SEEK_HOLE. There is no way to query the filesystem
2341 # of which behavior it is implementing.
2342 # We use this whitelist FSTYP, to set expectation and avoid silent
2343 # regression of filesystem seek hole behavior.
2344 #
2345 # Return 0 for true
2346 _fstyp_has_non_default_seek_data_hole()
2347 {
2348         if [ -z $1 ]; then
2349                 local fstyp=$FSTYP
2350         else
2351                 local fstyp=$1
2352         fi
2353
2354         case "$fstyp" in
2355         btrfs|ext4|xfs|cifs|f2fs|gfs2|ocfs2|tmpfs)
2356                 return 0
2357                 ;;
2358         nfs*)
2359                 # NFSv2 and NFSv3 only support default behavior of SEEK_HOLE,
2360                 # while NFSv4 supports non-default behavior
2361                 local nfsvers=`_df_device $TEST_DEV | $AWK_PROG '{ print $2 }'`
2362                 [ "$nfsvers" = "nfs4" ]
2363                 return $?
2364                 ;;
2365         overlay)
2366                 if [ ! -z $OVL_BASE_FSTYP -a $OVL_BASE_FSTYP != "overlay" ]; then
2367                         _fstyp_has_non_default_seek_data_hole $OVL_BASE_FSTYP
2368                         return $?
2369                 else
2370                         # Assume that base fs has default behavior
2371                         return 1
2372                 fi
2373                 ;;
2374         *)
2375                 # by default fstyp has default SEEK_HOLE behavior;
2376                 # if your fs has non-default behavior, add it to whitelist above!
2377                 return 1
2378                 ;;
2379         esac
2380 }
2381
2382 # Run seek sanity test with predefined expectation for SEEK_DATA/HOLE behavior
2383 _run_seek_sanity_test()
2384 {
2385         local testseekargs
2386         if _fstyp_has_non_default_seek_data_hole; then
2387                 testseekargs+="-f"
2388         fi
2389         $here/src/seek_sanity_test $testseekargs $*
2390 }
2391
2392 # Check if the file system supports seek_data/hole
2393 _require_seek_data_hole()
2394 {
2395         local dev=${1:-$TEST_DEV}
2396         local testfile=$TEST_DIR/$$.seek
2397         local testseek=`$here/src/seek_sanity_test -t $testfile 2>&1`
2398
2399         rm -f $testfile &>/dev/null
2400         echo $testseek | grep -q "Kernel does not support" && \
2401                 _notrun "File system does not support llseek(2) SEEK_DATA/HOLE"
2402         # Disable extent zeroing for ext4 as that change where holes are
2403         # created
2404         if [ "$FSTYP" = "ext4" ]; then
2405                 _ext4_disable_extent_zeroout $dev
2406         fi
2407 }
2408
2409 _require_runas()
2410 {
2411         _require_test_program "runas"
2412 }
2413
2414 _runas()
2415 {
2416         "$here/src/runas" "$@"
2417 }
2418
2419 _require_richacl_prog()
2420 {
2421         _require_command "$GETRICHACL_PROG" getrichacl
2422         _require_command "$SETRICHACL_PROG" setrichacl
2423 }
2424
2425 _require_scratch_richacl_xfs()
2426 {
2427         _scratch_mkfs_xfs_supported -m richacl=1 >/dev/null 2>&1 \
2428                 || _notrun "mkfs.xfs doesn't have richacl feature"
2429         _scratch_mkfs_xfs -m richacl=1 >/dev/null 2>&1
2430         _try_scratch_mount >/dev/null 2>&1 \
2431                 || _notrun "kernel doesn't support richacl feature on $FSTYP"
2432         _scratch_unmount
2433 }
2434
2435 _require_scratch_richacl_ext4()
2436 {
2437         _scratch_mkfs -O richacl >/dev/null 2>&1 \
2438                 || _notrun "can't mkfs $FSTYP with option -O richacl"
2439         _try_scratch_mount >/dev/null 2>&1 \
2440                 || _notrun "kernel doesn't support richacl feature on $FSTYP"
2441         _scratch_unmount
2442 }
2443
2444 _require_scratch_richacl_support()
2445 {
2446         _scratch_mount
2447         $GETFATTR_PROG -n system.richacl >/dev/null 2>&1 \
2448                 || _notrun "this test requires richacl support on \$SCRATCH_DEV"
2449         _scratch_unmount
2450 }
2451
2452 _require_scratch_richacl()
2453 {
2454         case "$FSTYP" in
2455         xfs)    _require_scratch_richacl_xfs
2456                 ;;
2457         ext4)   _require_scratch_richacl_ext4
2458                 ;;
2459         nfs*|cifs|overlay)
2460                 _require_scratch_richacl_support
2461                 ;;
2462         *)      _notrun "this test requires richacl support on \$SCRATCH_DEV"
2463                 ;;
2464         esac
2465 }
2466
2467 _scratch_mkfs_richacl()
2468 {
2469         case "$FSTYP" in
2470         xfs)    _scratch_mkfs_xfs -m richacl=1
2471                 ;;
2472         ext4)   _scratch_mkfs -O richacl
2473                 ;;
2474         nfs*|cifs|overlay)
2475                 _scratch_mkfs
2476                 ;;
2477         esac
2478 }
2479
2480 # check if the given device is mounted, if so, return mount point
2481 _is_dev_mounted()
2482 {
2483         local dev=$1
2484         local fstype=${2:-$FSTYP}
2485
2486         if [ $# -lt 1 ]; then
2487                 echo "Usage: _is_dev_mounted <device> [fstype]" 1>&2
2488                 exit 1
2489         fi
2490
2491         findmnt -rncv -S $dev -t $fstype -o TARGET | head -1
2492 }
2493
2494 # check if the given dir is a mount point, if so, return mount point
2495 _is_dir_mountpoint()
2496 {
2497         local dir=$1
2498         local fstype=${2:-$FSTYP}
2499
2500         if [ $# -lt 1 ]; then
2501                 echo "Uasge: _is_dir_mountpoint <dir> [fstype]" 1>&2
2502                 exit 1
2503         fi
2504
2505         findmnt -rncv -t $fstype -o TARGET $dir | head -1
2506 }
2507
2508 # remount a FS to a new mode (ro or rw)
2509 #
2510 _remount()
2511 {
2512     if [ $# -ne 2 ]
2513     then
2514         echo "Usage: _remount device ro/rw" 1>&2
2515         exit 1
2516     fi
2517     local device=$1
2518     local mode=$2
2519
2520     if ! mount -o remount,$mode $device
2521     then
2522         echo "_remount: failed to remount filesystem on $device as $mode"
2523         exit 1
2524     fi
2525 }
2526
2527 # Run the appropriate repair/check on a filesystem
2528 #
2529 # if the filesystem is mounted, it's either remounted ro before being
2530 # checked or it's unmounted and then remounted
2531 #
2532
2533 # If set, we remount ro instead of unmounting for fsck
2534 USE_REMOUNT=0
2535
2536 _umount_or_remount_ro()
2537 {
2538     if [ $# -ne 1 ]
2539     then
2540         echo "Usage: _umount_or_remount_ro <device>" 1>&2
2541         exit 1
2542     fi
2543
2544     local device=$1
2545     local mountpoint=`_is_dev_mounted $device`
2546
2547     if [ $USE_REMOUNT -eq 0 ]; then
2548         $UMOUNT_PROG $device
2549     else
2550         _remount $device ro
2551     fi
2552     echo "$mountpoint"
2553 }
2554
2555 _mount_or_remount_rw()
2556 {
2557         if [ $# -ne 3 ]; then
2558                 echo "Usage: _mount_or_remount_rw <opts> <dev> <mnt>" 1>&2
2559                 exit 1
2560         fi
2561         local mount_opts=$1
2562         local device=$2
2563         local mountpoint=$3
2564
2565         if [ $USE_REMOUNT -eq 0 ]; then
2566                 if [ "$FSTYP" != "overlay" ]; then
2567                         _mount -t $FSTYP $mount_opts $device $mountpoint
2568                 else
2569                         _overlay_mount $device $mountpoint
2570                 fi
2571                 if [ $? -ne 0 ]; then
2572                         _dump_err "!!! failed to remount $device on $mountpoint"
2573                         return 0 # ok=0
2574                 fi
2575         else
2576                 _remount $device rw
2577         fi
2578
2579         return 1 # ok=1
2580 }
2581
2582 # Check a generic filesystem in no-op mode; this assumes that the
2583 # underlying fsck program accepts "-n" for a no-op (check-only) run,
2584 # and that it will still return an errno for corruption in this mode.
2585 #
2586 # Filesystems which don't support this will need to define their
2587 # own check routine.
2588 #
2589 _check_generic_filesystem()
2590 {
2591     local device=$1
2592
2593     # If type is set, we're mounted
2594     local type=`_fs_type $device`
2595     local ok=1
2596
2597     if [ "$type" = "$FSTYP" ]
2598     then
2599         # mounted ...
2600         local mountpoint=`_umount_or_remount_ro $device`
2601     fi
2602
2603     fsck -t $FSTYP $FSCK_OPTIONS $device >$tmp.fsck 2>&1
2604     if [ $? -ne 0 ]
2605     then
2606         _log_err "_check_generic_filesystem: filesystem on $device is inconsistent"
2607         echo "*** fsck.$FSTYP output ***"       >>$seqres.full
2608         cat $tmp.fsck                           >>$seqres.full
2609         echo "*** end fsck.$FSTYP output"       >>$seqres.full
2610
2611         ok=0
2612     fi
2613     rm -f $tmp.fsck
2614
2615     if [ $ok -eq 0 ]
2616     then
2617         echo "*** mount output ***"             >>$seqres.full
2618         _mount                                  >>$seqres.full
2619         echo "*** end mount output"             >>$seqres.full
2620     elif [ "$type" = "$FSTYP" ]
2621     then
2622         # was mounted ...
2623         _mount_or_remount_rw "$MOUNT_OPTIONS" $device $mountpoint
2624         ok=$?
2625     fi
2626
2627     if [ $ok -eq 0 ]; then
2628         status=1
2629         if [ "$iam" != "check" ]; then
2630                 exit 1
2631         fi
2632         return 1
2633     fi
2634
2635     return 0
2636 }
2637
2638 # Filter the knowen errors the UDF Verifier reports.
2639 _udf_test_known_error_filter()
2640 {
2641         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."
2642
2643 }
2644
2645 _check_udf_filesystem()
2646 {
2647     [ "$DISABLE_UDF_TEST" == "1" ] && return
2648
2649     if [ $# -ne 1 -a $# -ne 2 ]
2650     then
2651         echo "Usage: _check_udf_filesystem device [last_block]" 1>&2
2652         exit 1
2653     fi
2654
2655     if [ ! -x $here/src/udf_test ]
2656     then
2657         echo "udf_test not installed, please download and build the Philips"
2658         echo "UDF Verification Software from http://www.extra.research.philips.com/udf/."
2659         echo "Then copy the udf_test binary to $here/src/."
2660         echo "If you do not wish to run udf_test then set environment variable DISABLE_UDF_TEST"
2661         echo "to 1."
2662         return
2663     fi
2664
2665     local device=$1
2666     local opt_arg=""
2667     if [ $# -eq 2 ]; then
2668         opt_arg="-lastvalidblock $(( $2 - 1 ))"
2669     fi
2670
2671     rm -f $seqres.checkfs
2672     sleep 1 # Due to a problem with time stamps in udf_test
2673     $here/src/udf_test $opt_arg $device | tee $seqres.checkfs | egrep "Error|Warning" | \
2674         _udf_test_known_error_filter | \
2675         egrep -iv "Error count:.*[0-9]+.*total occurrences:.*[0-9]+|Warning count:.*[0-9]+.*total occurrences:.*[0-9]+" && \
2676         echo "Warning UDF Verifier reported errors see $seqres.checkfs." && return 1
2677     return 0
2678 }
2679
2680 _check_test_fs()
2681 {
2682     case $FSTYP in
2683     xfs)
2684         _check_xfs_test_fs
2685         ;;
2686     nfs)
2687         # no way to check consistency for nfs
2688         ;;
2689     cifs)
2690         # no way to check consistency for cifs
2691         ;;
2692     9p)
2693         # no way to check consistency for 9p
2694         ;;
2695     virtiofs)
2696         # no way to check consistency for virtiofs
2697         ;;
2698     ceph)
2699         # no way to check consistency for CephFS
2700         ;;
2701     glusterfs)
2702         # no way to check consistency for GlusterFS
2703         ;;
2704     overlay)
2705         _check_overlay_test_fs
2706         ;;
2707     pvfs2)
2708         ;;
2709     udf)
2710         # do nothing for now
2711         ;;
2712     btrfs)
2713         _check_btrfs_filesystem $TEST_DEV
2714         ;;
2715     tmpfs)
2716         # no way to check consistency for tmpfs
2717         ;;
2718     ubifs)
2719         # there is no fsck program for ubifs yet
2720         ;;
2721     *)
2722         _check_generic_filesystem $TEST_DEV
2723         ;;
2724     esac
2725 }
2726
2727 _check_scratch_fs()
2728 {
2729     local device=$SCRATCH_DEV
2730     [ $# -eq 1 ] && device=$1
2731
2732     case $FSTYP in
2733     xfs)
2734         local scratch_log="none"
2735         local scratch_rt="none"
2736         [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
2737             scratch_log="$SCRATCH_LOGDEV"
2738
2739         [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
2740             scratch_rt="$SCRATCH_RTDEV"
2741
2742         _check_xfs_filesystem $device $scratch_log $scratch_rt
2743         ;;
2744     udf)
2745         _check_udf_filesystem $device $udf_fsize
2746         ;;
2747     nfs*)
2748         # Don't know how to check an NFS filesystem, yet.
2749         ;;
2750     cifs)
2751         # Don't know how to check a CIFS filesystem, yet.
2752         ;;
2753     9p)
2754         # no way to check consistency for 9p
2755         ;;
2756     virtiofs)
2757         # no way to check consistency for virtiofs
2758         ;;
2759     ceph)
2760         # no way to check consistency for CephFS
2761         ;;
2762     glusterfs)
2763         # no way to check consistency for GlusterFS
2764         ;;
2765     overlay)
2766         _check_overlay_scratch_fs
2767         ;;
2768     pvfs2)
2769         ;;
2770     btrfs)
2771         _check_btrfs_filesystem $device
2772         ;;
2773     tmpfs)
2774         # no way to check consistency for tmpfs
2775         ;;
2776     ubifs)
2777         # there is no fsck program for ubifs yet
2778         ;;
2779     *)
2780         _check_generic_filesystem $device
2781         ;;
2782     esac
2783 }
2784
2785 _full_fstyp_details()
2786 {
2787      [ -z "$FSTYP" ] && FSTYP=xfs
2788      if [ $FSTYP = xfs ]; then
2789         if [ -d /proc/fs/xfs ]; then
2790             if grep -q 'debug 0' /proc/fs/xfs/stat; then
2791                 FSTYP="$FSTYP (non-debug)"
2792             elif grep -q 'debug 1' /proc/fs/xfs/stat; then
2793                 FSTYP="$FSTYP (debug)"
2794             fi
2795         else
2796             if uname -a | grep -qi 'debug'; then
2797                 FSTYP="$FSTYP (debug)"
2798             else
2799                 FSTYP="$FSTYP (non-debug)"
2800             fi
2801         fi
2802      fi
2803      echo $FSTYP
2804 }
2805
2806 _full_platform_details()
2807 {
2808      local os=`uname -s`
2809      local host=`hostname -s`
2810      local kernel=`uname -rv`
2811      local platform=`uname -m`
2812      echo "$os/$platform $host $kernel"
2813 }
2814
2815 _get_os_name()
2816 {
2817         if [ "`uname`" == "Linux" ]; then
2818                 echo 'linux'
2819         else
2820                 echo Unknown operating system: `uname`
2821                 exit
2822         fi
2823 }
2824
2825 _link_out_file_named()
2826 {
2827         local features=$2
2828         local suffix=$(FEATURES="$features" perl -e '
2829                 my %feathash;
2830                 my $feature, $result, $suffix, $opts;
2831
2832                 foreach $feature (split(/,/, $ENV{"FEATURES"})) {
2833                         $feathash{$feature} = 1;
2834                 }
2835                 $result = "default";
2836                 while (<>) {
2837                         my $found = 1;
2838
2839                         chomp;
2840                         ($opts, $suffix) = split(/ *: */);
2841                         foreach my $opt (split(/,/, $opts)) {
2842                                 if (!exists($feathash{$opt})) {
2843                                         $found = 0;
2844                                         last;
2845                                 }
2846                         }
2847                         if ($found == 1) {
2848                                 $result = $suffix;
2849                                 last;
2850                         }
2851                 }
2852                 print $result
2853                 ' <$seqfull.cfg)
2854         rm -f $1
2855         ln -fs $(basename $1).$suffix $1
2856 }
2857
2858 _link_out_file()
2859 {
2860         local features
2861
2862         if [ $# -eq 0 ]; then
2863                 features="$(_get_os_name),$FSTYP"
2864                 if [ -n "$MOUNT_OPTIONS" ]; then
2865                         features=$features,${MOUNT_OPTIONS##"-o "}
2866                 fi
2867         else
2868                 features=$1
2869         fi
2870
2871         _link_out_file_named $seqfull.out "$features"
2872 }
2873
2874 _die()
2875 {
2876         echo $@
2877         exit 1
2878 }
2879
2880 # convert urandom incompressible data to compressible text data
2881 _ddt()
2882 {
2883         od /dev/urandom | dd iflag=fullblock ${*}
2884 }
2885
2886 #takes files, randomdata
2887 _nfiles()
2888 {
2889         local f=0
2890         while [ $f -lt $1 ]
2891         do
2892                 local file=f$f
2893                 echo > $file
2894                 if [ $size -gt 0 ]; then
2895                     if [ "$2" == "false" ]; then
2896                         dd if=/dev/zero of=$file bs=1024 count=$size 2>&1 | _filter_dd
2897                     elif [ "$2" == "comp" ]; then
2898                         _ddt of=$file bs=1024 count=$size 2>&1 | _filter_dd
2899                     else
2900                         dd if=/dev/urandom of=$file bs=1024 count=$size 2>&1 | _filter_dd
2901                     fi
2902                 fi
2903                 let f=$f+1
2904         done
2905 }
2906
2907 # takes dirname, depth, randomdata
2908 _descend()
2909 {
2910         local dirname=$1 depth=$2 randomdata=$3
2911         mkdir $dirname  || die "mkdir $dirname failed"
2912         cd $dirname
2913
2914         _nfiles $files $randomdata          # files for this dir and data type
2915
2916         [ $depth -eq 0 ] && return
2917         local deep=$(( depth - 1 )) # go 1 down
2918
2919         [ $verbose = true ] && echo "descending, depth from leaves = $deep"
2920
2921         local d=0
2922         while [ $d -lt $dirs ]
2923         do
2924                 _descend d$d $deep &
2925                 let d=$d+1
2926                 wait
2927         done
2928 }
2929
2930 # Populate a filesystem with inodes for performance experiments
2931 #
2932 # usage: populate [-v] [-n ndirs] [-f nfiles] [-d depth] [-r root] [-s size] [-x]
2933 #
2934 _populate_fs()
2935 {
2936     local here=`pwd`
2937     local dirs=5          # ndirs in each subdir till leaves
2938     local size=0          # sizeof files in K
2939     local files=100       # num files in _each_ subdir
2940     local depth=2         # depth of tree from root to leaves
2941     local verbose=false
2942     local root=root       # path of initial root of directory tree
2943     local randomdata=false # -x data type urandom, zero or compressible
2944     local c
2945
2946     OPTIND=1
2947     while getopts "d:f:n:r:s:v:x:c" c
2948     do
2949         case $c in
2950         d)      depth=$OPTARG;;
2951         n)      dirs=$OPTARG;;
2952         f)      files=$OPTARG;;
2953         s)      size=$OPTARG;;
2954         v)      verbose=true;;
2955         r)      root=$OPTARG;;
2956         x)      randomdata=true;;
2957         c)      randomdata=comp;;
2958         esac
2959     done
2960
2961     _descend $root $depth $randomdata
2962     wait
2963
2964     cd $here
2965
2966     [ $verbose = true ] && echo done
2967 }
2968
2969 # query whether the given file has the given inode flag set
2970 #
2971 _test_inode_flag()
2972 {
2973         local flag=$1
2974         local file=$2
2975
2976         if $XFS_IO_PROG -r -c 'lsattr -v' "$file" | grep -q "$flag" ; then
2977                 return 0
2978         fi
2979         return 1
2980 }
2981
2982 # query the given files extsize allocator hint in bytes (if any)
2983 #
2984 _test_inode_extsz()
2985 {
2986         local file=$1
2987         local blocks=""
2988
2989         blocks=`$XFS_IO_PROG -r -c 'stat' "$file" | \
2990                 awk '/^xattr.extsize =/ { print $3 }'`
2991         [ -z "$blocks" ] && blocks="0"
2992         echo $blocks
2993 }
2994
2995 # scratch_dev_pool should contain the disks pool for the btrfs raid
2996 _require_scratch_dev_pool()
2997 {
2998         local i
2999         local ndevs
3000
3001         if [ -z "$SCRATCH_DEV_POOL" ]; then
3002                 _notrun "this test requires a valid \$SCRATCH_DEV_POOL"
3003         fi
3004
3005         if [ -z "$1" ]; then
3006                 ndevs=2
3007         else
3008                 ndevs=$1
3009         fi
3010
3011         # btrfs test case needs ndevs or more scratch_dev_pool; other FS not sure
3012         # so fail it
3013         case $FSTYP in
3014         btrfs)
3015                 if [ "`echo $SCRATCH_DEV_POOL|wc -w`" -lt $ndevs ]; then
3016                         _notrun "btrfs and this test needs $ndevs or more disks in SCRATCH_DEV_POOL"
3017                 fi
3018         ;;
3019         *)
3020                 _notrun "dev_pool is not supported by fstype \"$FSTYP\""
3021         ;;
3022         esac
3023
3024         for i in $SCRATCH_DEV_POOL; do
3025                 if [ "`_is_block_dev "$i"`" = "" ]; then
3026                         _notrun "this test requires valid block disk $i"
3027                 fi
3028                 if [ "`_is_block_dev "$i"`" = "`_is_block_dev "$TEST_DEV"`" ]; then
3029                         _notrun "$i is part of TEST_DEV, this test requires unique disks"
3030                 fi
3031                 if _mount | grep -q $i; then
3032                         if ! $UMOUNT_PROG $i; then
3033                             echo "failed to unmount $i - aborting"
3034                             exit 1
3035                         fi
3036                 fi
3037                 # to help better debug when something fails, we remove
3038                 # traces of previous btrfs FS on the dev.
3039                 dd if=/dev/zero of=$i bs=4096 count=100 > /dev/null 2>&1
3040         done
3041 }
3042
3043 # ensure devices in SCRATCH_DEV_POOL are of the same size
3044 # must be called after _require_scratch_dev_pool
3045 _require_scratch_dev_pool_equal_size()
3046 {
3047         local size
3048         local newsize
3049         local dev
3050
3051         # SCRATCH_DEV has been set to the first device in SCRATCH_DEV_POOL
3052         size=`_get_device_size $SCRATCH_DEV`
3053         for dev in $SCRATCH_DEV_POOL; do
3054                 newsize=`_get_device_size $dev`
3055                 if [ $size -ne $newsize ]; then
3056                         _notrun "This test requires devices in SCRATCH_DEV_POOL have the same size"
3057                 fi
3058         done
3059 }
3060
3061
3062 # Check that fio is present, and it is able to execute given jobfile
3063 _require_fio()
3064 {
3065         local job=$1
3066
3067         _require_command "$FIO_PROG" fio
3068         if [ -z "$1" ]; then
3069                 return 1;
3070         fi
3071
3072         $FIO_PROG --warnings-fatal --showcmd $job >> $seqres.full 2>&1
3073         [ $? -eq 0 ] || _notrun "$FIO_PROG too old, see $seqres.full"
3074 }
3075
3076 # Does freeze work on this fs?
3077 _require_freeze()
3078 {
3079         xfs_freeze -f "$TEST_DIR" >/dev/null 2>&1
3080         local result=$?
3081         xfs_freeze -u "$TEST_DIR" >/dev/null 2>&1
3082         [ $result -eq 0 ] || _notrun "$FSTYP does not support freezing"
3083 }
3084
3085 # Does NFS export work on this fs?
3086 _require_exportfs()
3087 {
3088         _require_test_program "open_by_handle"
3089         mkdir -p "$TEST_DIR"/exportfs_test
3090         $here/src/open_by_handle -c "$TEST_DIR"/exportfs_test 2>&1 \
3091                 || _notrun "$FSTYP does not support NFS export"
3092 }
3093
3094
3095 # Does shutdown work on this fs?
3096 _require_scratch_shutdown()
3097 {
3098         [ -x src/godown ] || _notrun "src/godown executable not found"
3099
3100         _scratch_mkfs > /dev/null 2>&1 || _notrun "_scratch_mkfs failed on $SCRATCH_DEV"
3101         _scratch_mount
3102
3103         if [ $FSTYP = "overlay" ]; then
3104                 if [ -z $OVL_BASE_SCRATCH_DEV ]; then
3105                         # In lagacy overlay usage, it may specify directory as
3106                         # SCRATCH_DEV, in this case OVL_BASE_SCRATCH_DEV
3107                         # will be null, so check OVL_BASE_SCRATCH_DEV before
3108                         # running shutdown to avoid shutting down base fs accidently.
3109                         _notrun "This test requires a valid $OVL_BASE_SCRATCH_DEV as ovl base fs"
3110                 else
3111                         src/godown -f $OVL_BASE_SCRATCH_MNT 2>&1 \
3112                         || _notrun "Underlying filesystem does not support shutdown"
3113                 fi
3114         else
3115                 src/godown -f $SCRATCH_MNT 2>&1 \
3116                         || _notrun "$FSTYP does not support shutdown"
3117         fi
3118
3119         _scratch_unmount
3120 }
3121
3122 # Does dax mount option work on this dev/fs?
3123 _require_scratch_dax()
3124 {
3125         _require_scratch
3126         _scratch_mkfs > /dev/null 2>&1
3127         _try_scratch_mount -o dax || \
3128                 _notrun "mount $SCRATCH_DEV with dax failed"
3129         # Check options to be sure. XFS ignores dax option
3130         # and goes on if dev underneath does not support dax.
3131         _fs_options $SCRATCH_DEV | grep -qw "dax" || \
3132                 _notrun "$SCRATCH_DEV $FSTYP does not support -o dax"
3133         _scratch_unmount
3134 }
3135
3136 # Does norecovery support by this fs?
3137 _require_norecovery()
3138 {
3139         _try_scratch_mount -o ro,norecovery || \
3140                 _notrun "$FSTYP does not support norecovery"
3141         _scratch_unmount
3142 }
3143
3144 # Does this filesystem support metadata journaling?
3145 # We exclude ones here that don't; otherwise we assume that it does, so the
3146 # test will run, fail, and motivate someone to update this test for a new
3147 # filesystem.
3148 #
3149 # It's possible that TEST_DEV and SCRATCH_DEV have different features (it'd be
3150 # odd, but possible) so check $TEST_DEV by default, but we can optionall pass
3151 # any dev we want.
3152 _require_metadata_journaling()
3153 {
3154         if [ -z $1 ]; then
3155                 local dev=$TEST_DEV
3156         else
3157                 local dev=$1
3158         fi
3159
3160         case "$FSTYP" in
3161         ext2|vfat|msdos|udf)
3162                 _notrun "$FSTYP does not support metadata journaling"
3163                 ;;
3164         ext4)
3165                 # ext4 could be mkfs'd without a journal...
3166                 _require_dumpe2fs
3167                 $DUMPE2FS_PROG -h $dev 2>&1 | grep -q has_journal || \
3168                         _notrun "$FSTYP on $dev not configured with metadata journaling"
3169                 # ext4 might not load a journal
3170                 _exclude_scratch_mount_option "noload"
3171                 ;;
3172         overlay)
3173                 # metadata journaling check is based on base filesystem configurations
3174                 # and  because -overlay option saves those configurations to OVL_BASE_*,
3175                 # adding restore/override the configurations before/after the check.
3176                 if [ ! -z $OVL_BASE_FSTYP -a $OVL_BASE_FSTYP != "overlay" ]; then
3177                         _overlay_config_restore
3178                         _require_metadata_journaling
3179                         _overlay_config_override
3180                 else
3181                         _notrun "No metadata journaling support for legacy overlay setup"
3182                 fi
3183                 ;;
3184         *)
3185                 # by default we pass; if you need to, add your fs above!
3186                 ;;
3187         esac
3188 }
3189
3190 _count_extents()
3191 {
3192         $XFS_IO_PROG -c "fiemap" $1 | tail -n +2 | grep -v hole | wc -l
3193 }
3194
3195 _count_holes()
3196 {
3197         $XFS_IO_PROG -c "fiemap" $1 | tail -n +2 | grep hole | wc -l
3198 }
3199
3200 _count_attr_extents()
3201 {
3202         $XFS_IO_PROG -c "fiemap -a" $1 | tail -n +2 | grep -v hole | wc -l
3203 }
3204
3205 # arg 1 is dev to remove and is output of the below eg.
3206 # ls -l /sys/class/block/sdd | rev | cut -d "/" -f 3 | rev
3207 _devmgt_remove()
3208 {
3209         local lun=$1
3210         local disk=$2
3211
3212         echo 1 > /sys/class/scsi_device/${lun}/device/delete || _fail "Remove disk failed"
3213
3214         stat $disk > /dev/null 2>&1
3215         while [ $? -eq 0 ]; do
3216                 sleep 1
3217                 stat $disk > /dev/null 2>&1
3218         done
3219 }
3220
3221 # arg 1 is dev to add and is output of the below eg.
3222 # ls -l /sys/class/block/sdd | rev | cut -d "/" -f 3 | rev
3223 _devmgt_add()
3224 {
3225         local h
3226         local tdl
3227         # arg 1 will be in h:t:d:l format now in the h and "t d l" format
3228         h=`echo ${1} | cut -d":" -f 1`
3229         tdl=`echo ${1} | cut -d":" -f 2-|sed 's/:/ /g'`
3230
3231         echo ${tdl} >  /sys/class/scsi_host/host${h}/scan || _fail "Add disk failed"
3232
3233         # ensure the device comes online
3234         local dev_back_oneline=0
3235         local i
3236         for i in `seq 1 10`; do
3237                 if [ -d /sys/class/scsi_device/${1}/device/block ]; then
3238                         local dev=`ls /sys/class/scsi_device/${1}/device/block`
3239                         local j
3240                         for j in `seq 1 10`;
3241                         do
3242                                 stat /dev/$dev > /dev/null 2>&1
3243                                 if [ $? -eq 0 ]; then
3244                                         dev_back_oneline=1
3245                                         break
3246                                 fi
3247                                 sleep 1
3248                         done
3249                         break
3250                 else
3251                         sleep 1
3252                 fi
3253         done
3254         if [ $dev_back_oneline -eq 0 ]; then
3255                 echo "/dev/$dev online failed" >> $seqres.full
3256         else
3257                 echo "/dev/$dev is back online" >> $seqres.full
3258         fi
3259 }
3260
3261 _require_fstrim()
3262 {
3263         if [ -z "$FSTRIM_PROG" ]; then
3264                 _notrun "This test requires fstrim utility."
3265         fi
3266 }
3267
3268 _require_batched_discard()
3269 {
3270         if [ $# -ne 1 ]; then
3271                 echo "Usage: _require_batched_discard mnt_point" 1>&2
3272                 exit 1
3273         fi
3274         _require_fstrim
3275         $FSTRIM_PROG $1 > /dev/null 2>&1 || _notrun "FITRIM not supported on $1"
3276 }
3277
3278 _require_dumpe2fs()
3279 {
3280         if [ -z "$DUMPE2FS_PROG" ]; then
3281                 _notrun "This test requires dumpe2fs utility."
3282         fi
3283 }
3284
3285 _require_ugid_map()
3286 {
3287         if [ ! -e /proc/self/uid_map ]; then
3288                 _notrun "This test requires procfs uid_map support."
3289         fi
3290         if [ ! -e /proc/self/gid_map ]; then
3291                 _notrun "This test requires procfs gid_map support."
3292         fi
3293 }
3294
3295 _require_fssum()
3296 {
3297         FSSUM_PROG=$here/src/fssum
3298         [ -x $FSSUM_PROG ] || _notrun "fssum not built"
3299 }
3300
3301 _require_cloner()
3302 {
3303         CLONER_PROG=$here/src/cloner
3304         [ -x $CLONER_PROG ] || \
3305                 _notrun "cloner binary not present at $CLONER_PROG"
3306 }
3307
3308 # Normalize mount options from global $MOUNT_OPTIONS
3309 # Convert options like "-o opt1,opt2 -oopt3" to
3310 # "opt1 opt2 opt3"
3311 _normalize_mount_options()
3312 {
3313         echo $MOUNT_OPTIONS | sed -n 's/-o\s*\(\S*\)/\1/gp'| sed 's/,/ /g'
3314 }
3315
3316 # skip test if MOUNT_OPTIONS contains the given strings
3317 _exclude_scratch_mount_option()
3318 {
3319         local mnt_opts=$(_normalize_mount_options)
3320
3321         while [ $# -gt 0 ]; do
3322                 if echo $mnt_opts | grep -qw "$1"; then
3323                         _notrun "mount option \"$1\" not allowed in this test"
3324                 fi
3325                 shift
3326         done
3327 }
3328
3329 _require_atime()
3330 {
3331         _exclude_scratch_mount_option "noatime"
3332         case $FSTYP in
3333         nfs|cifs)
3334                 _notrun "atime related mount options have no effect on $FSTYP"
3335                 ;;
3336         esac
3337
3338 }
3339
3340 _require_relatime()
3341 {
3342         _scratch_mkfs > /dev/null 2>&1
3343         _try_scratch_mount -o relatime || \
3344                 _notrun "relatime not supported by the current kernel"
3345         _scratch_unmount
3346 }
3347
3348 _require_userns()
3349 {
3350         [ -x src/nsexec ] || _notrun "src/nsexec executable not found"
3351         src/nsexec -U true 2>/dev/null || _notrun "userns not supported by this kernel"
3352 }
3353
3354 _create_loop_device()
3355 {
3356         local file=$1 dev
3357         dev=`losetup -f --show $file` || _fail "Cannot assign $file to a loop device"
3358         echo $dev
3359 }
3360
3361 _destroy_loop_device()
3362 {
3363         local dev=$1
3364         losetup -d $dev || _fail "Cannot destroy loop device $dev"
3365 }
3366
3367 _scale_fsstress_args()
3368 {
3369     local args=""
3370     while [ $# -gt 0 ]; do
3371         case "$1" in
3372             -n) args="$args $1 $(($2 * $TIME_FACTOR))"; shift ;;
3373             -p) args="$args $1 $(($2 * $LOAD_FACTOR))"; shift ;;
3374             *) args="$args $1" ;;
3375         esac
3376         shift
3377     done
3378     echo $args
3379 }
3380
3381 #
3382 # Return the logical block size if running on a block device,
3383 # else substitute the page size.
3384 #
3385 _min_dio_alignment()
3386 {
3387     local dev=$1
3388
3389     if [ -b "$dev" ]; then
3390         blockdev --getss $dev
3391     else
3392         $here/src/feature -s
3393     fi
3394 }
3395
3396 run_check()
3397 {
3398         echo "# $@" >> $seqres.full 2>&1
3399         "$@" >> $seqres.full 2>&1 || _fail "failed: '$@'"
3400 }
3401
3402 _require_test_symlinks()
3403 {
3404         local target=`mktemp -p $TEST_DIR`
3405         local link=`mktemp -p $TEST_DIR -u`
3406         ln -s `basename $target` $link
3407         if [ "$?" -ne 0 ]; then
3408                 rm -f $target
3409                 _notrun "Require symlinks support"
3410         fi
3411         rm -f $target $link
3412 }
3413
3414 _require_test_fcntl_advisory_locks()
3415 {
3416         [ "$FSTYP" != "cifs" ] && return 0
3417         cat /proc/mounts | grep $TEST_DEV | grep cifs | grep -q "nobrl" && return 0
3418         cat /proc/mounts | grep $TEST_DEV | grep cifs | grep -qE "nounix|forcemand" && \
3419                 _notrun "Require fcntl advisory locks support"
3420 }
3421
3422 _require_ofd_locks()
3423 {
3424         # Give a test run by getlk wrlck on testfile.
3425         # If the running kernel does not support OFD locks,
3426         # EINVAL will be returned.
3427         _require_test_program "t_ofd_locks"
3428         touch $TEST_DIR/ofd_testfile
3429         src/t_ofd_locks -t $TEST_DIR/ofd_testfile > /dev/null 2>&1
3430         [ $? -eq 22 ] && _notrun "Require OFD locks support"
3431 }
3432
3433 _require_test_lsattr()
3434 {
3435         local testio=$(lsattr -d $TEST_DIR 2>&1)
3436         echo $testio | grep -q "Operation not supported" && \
3437                 _notrun "lsattr not supported by test filesystem type: $FSTYP"
3438         echo $testio | grep -q "Inappropriate ioctl for device" && \
3439                 _notrun "lsattr not supported by test filesystem type: $FSTYP"
3440 }
3441
3442 _require_chattr()
3443 {
3444         if [ -z "$1" ]; then
3445                 echo "Usage: _require_chattr <attr>"
3446                 exit 1
3447         fi
3448         local attribute=$1
3449
3450         touch $TEST_DIR/syscalltest
3451         chattr "+$attribute" $TEST_DIR/syscalltest > $TEST_DIR/syscalltest.out 2>&1
3452         local ret=$?
3453         chattr "-$attribute" $TEST_DIR/syscalltest > $TEST_DIR/syscalltest.out 2>&1
3454         if [ "$ret" -ne 0 ]; then
3455                 _notrun "file system doesn't support chattr +$attribute"
3456         fi
3457         cat $TEST_DIR/syscalltest.out >> $seqres.full
3458         rm -f $TEST_DIR/syscalltest.out
3459 }
3460
3461 _get_total_inode()
3462 {
3463         if [ -z "$1" ]; then
3464                 echo "Usage: _get_total_inode <mnt>"
3465                 exit 1
3466         fi
3467         local nr_inode;
3468         nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $3}'`
3469         echo $nr_inode
3470 }
3471
3472 _get_used_inode()
3473 {
3474         if [ -z "$1" ]; then
3475                 echo "Usage: _get_used_inode <mnt>"
3476                 exit 1
3477         fi
3478         local nr_inode;
3479         nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $4}'`
3480         echo $nr_inode
3481 }
3482
3483 _get_used_inode_percent()
3484 {
3485         if [ -z "$1" ]; then
3486                 echo "Usage: _get_used_inode_percent <mnt>"
3487                 exit 1
3488         fi
3489         local pct_inode;
3490         pct_inode=`$DF_PROG -i $1 | tail -1 | awk '{ print $6 }' | \
3491                    sed -e 's/%//'`
3492         echo $pct_inode
3493 }
3494
3495 _get_free_inode()
3496 {
3497         if [ -z "$1" ]; then
3498                 echo "Usage: _get_free_inode <mnt>"
3499                 exit 1
3500         fi
3501         local nr_inode;
3502         nr_inode=`$DF_PROG -i $1 | tail -1 | awk '{print $5}'`
3503         echo $nr_inode
3504 }
3505
3506 # get the available space in bytes
3507 #
3508 _get_available_space()
3509 {
3510         if [ -z "$1" ]; then
3511                 echo "Usage: _get_available_space <mnt>"
3512                 exit 1
3513         fi
3514         local avail_kb;
3515         avail_kb=`$DF_PROG $1 | tail -n1 | awk '{ print $5 }'`
3516         echo $((avail_kb * 1024))
3517 }
3518
3519 # return device size in kb
3520 _get_device_size()
3521 {
3522         grep `_short_dev $1` /proc/partitions | awk '{print $3}'
3523 }
3524
3525 # Make sure we actually have dmesg checking set up.
3526 _require_check_dmesg()
3527 {
3528         test -w /dev/kmsg || \
3529                 _notrun "Test requires writable /dev/kmsg."
3530 }
3531
3532 # Return the dmesg log since the start of this test.  Caller must ensure that
3533 # /dev/kmsg was writable when the test was started so that we can find the
3534 # beginning of this test's log messages; _require_check_dmesg does this.
3535 _dmesg_since_test_start()
3536 {
3537         # search the dmesg log of last run of $seqnum for possible failures
3538         # use sed \cregexpc address type, since $seqnum contains "/"
3539         dmesg | tac | sed -ne "0,\#run fstests $seqnum at $date_time#p" | \
3540                 tac
3541 }
3542
3543 # check dmesg log for a specific string, subject to the same requirements as
3544 # _dmesg_since_test_start.
3545 _check_dmesg_for()
3546 {
3547         _dmesg_since_test_start | egrep -q "$1"
3548 }
3549
3550 # Default filter for dmesg scanning.
3551 # Ignore lockdep complaining about its own bugginess when scanning dmesg
3552 # output, because we shouldn't be failing filesystem tests on account of
3553 # lockdep.
3554 _check_dmesg_filter()
3555 {
3556         egrep -v -e "BUG: MAX_LOCKDEP_CHAIN_HLOCKS too low" \
3557                 -e "BUG: MAX_STACK_TRACE_ENTRIES too low"
3558 }
3559
3560 # check dmesg log for WARNING/Oops/etc.
3561 _check_dmesg()
3562 {
3563         if [ ! -f ${RESULT_DIR}/check_dmesg ]; then
3564                 return 0
3565         fi
3566         rm -f ${RESULT_DIR}/check_dmesg
3567
3568         # default filter is a simple cat command, caller could provide a
3569         # customized filter and pass the name through the first argument, to
3570         # filter out intentional WARNINGs or Oopses
3571         local filter=${1:-_check_dmesg_filter}
3572
3573         _dmesg_since_test_start | $filter >$seqres.dmesg
3574         egrep -q -e "kernel BUG at" \
3575              -e "WARNING:" \
3576              -e "\bBUG:" \
3577              -e "Oops:" \
3578              -e "possible recursive locking detected" \
3579              -e "Internal error" \
3580              -e "(INFO|ERR): suspicious RCU usage" \
3581              -e "INFO: possible circular locking dependency detected" \
3582              -e "general protection fault:" \
3583              -e "BUG .* remaining" \
3584              -e "UBSAN:" \
3585              $seqres.dmesg
3586         if [ $? -eq 0 ]; then
3587                 _dump_err "_check_dmesg: something found in dmesg (see $seqres.dmesg)"
3588                 return 1
3589         else
3590                 rm -f $seqres.dmesg
3591                 return 0
3592         fi
3593 }
3594
3595 # capture the kmemleak report
3596 _capture_kmemleak()
3597 {
3598         local kern_knob="$DEBUGFS_MNT/kmemleak"
3599         local leak_file="$1"
3600
3601         # Tell the kernel to scan for memory leaks.  Apparently the write
3602         # returns before the scan is complete, so do it twice in the hopes
3603         # that twice is enough to capture all the leaks.
3604         echo "scan" > "$kern_knob"
3605         cat "$kern_knob" > /dev/null
3606         echo "scan" > "$kern_knob"
3607         cat "$kern_knob" > "$leak_file.tmp"
3608         if [ -s "$leak_file.tmp" ]; then
3609                 cat > "$leak_file" << ENDL
3610 EXPERIMENTAL kmemleak reported some memory leaks!  Due to the way kmemleak
3611 works, the leak might be from an earlier test, or something totally unrelated.
3612 ENDL
3613                 cat "$leak_file.tmp" >> "$leak_file"
3614         fi
3615         rm -rf "$leak_file.tmp"
3616         echo "clear" > "$kern_knob"
3617 }
3618
3619 # Figure out if the running kernel supports kmemleak; if it does, clear out
3620 # anything that leaked before we even started testing.  The leak checker only
3621 # needs to be primed like this once per ./check invocation.
3622 _detect_kmemleak()
3623 {
3624         local kern_knob="$DEBUGFS_MNT/kmemleak"
3625         KMEMLEAK_CHECK_FILE="/tmp/check_kmemleak"
3626
3627         # Since kernel v4.19-rc3, the kmemleak knob exists even if kmemleak is
3628         # disabled, but returns EBUSY on write. So instead of relying on
3629         # existance of writable knob file, we use a test file to indicate that
3630         # _check_kmemleak() is enabled only if we actually managed to write to
3631         # the knob file.
3632         rm -f "$KMEMLEAK_CHECK_FILE"
3633
3634         if [ ! -w "$kern_knob" ]; then
3635                 return 0
3636         fi
3637
3638         # Disable the automatic scan so that we can control it completely,
3639         # then dump all the leaks recorded so far.
3640         if echo "scan=off" > "$kern_knob" 2>/dev/null; then
3641                 _capture_kmemleak /dev/null
3642                 touch "$KMEMLEAK_CHECK_FILE"
3643         fi
3644 }
3645
3646 # Kick the kmemleak checker to scan for leaks.  Background leak scan mode is
3647 # not enabled, so we must call the kernel to ask for a scan and deal with the
3648 # results appropriately.  This we do after every test completes, whether or not
3649 # it was successful.
3650 _check_kmemleak()
3651 {
3652         local kern_knob="$DEBUGFS_MNT/kmemleak"
3653         local leak_file="$seqres.kmemleak"
3654
3655         if [ ! -f "$KMEMLEAK_CHECK_FILE" ]; then
3656                 return 0
3657         fi
3658
3659         # Not enabled, so discard any report of leaks found.
3660         if [ "$USE_KMEMLEAK" != "yes" ]; then
3661                 _capture_kmemleak /dev/null
3662                 return 0
3663         fi
3664
3665         # Capture and report any leaks
3666         _capture_kmemleak "$leak_file"
3667         if [ -s "$leak_file" ]; then
3668                 _dump_err "_check_kmemleak: something found in kmemleak (see $leak_file)"
3669                 return 1
3670         else
3671                 rm -f "$leak_file"
3672                 return 0
3673         fi
3674 }
3675
3676 # don't check dmesg log after test
3677 _disable_dmesg_check()
3678 {
3679         rm -f ${RESULT_DIR}/check_dmesg
3680 }
3681
3682 init_rc()
3683 {
3684         # make some further configuration checks here
3685         if [ "$TEST_DEV" = ""  ]
3686         then
3687                 echo "common/rc: Error: \$TEST_DEV is not set"
3688                 exit 1
3689         fi
3690
3691         # if $TEST_DEV is not mounted, mount it now as XFS
3692         if [ -z "`_fs_type $TEST_DEV`" ]
3693         then
3694                 # $TEST_DEV is not mounted
3695                 if ! _test_mount
3696                 then
3697                         echo "common/rc: retrying test device mount with external set"
3698                         [ "$USE_EXTERNAL" != "yes" ] && export USE_EXTERNAL=yes
3699                         if ! _test_mount
3700                         then
3701                                 echo "common/rc: could not mount $TEST_DEV on $TEST_DIR"
3702                                 exit 1
3703                         fi
3704                 fi
3705         fi
3706
3707         # Sanity check that TEST partition is not mounted at another mount point
3708         # or as another fs type
3709         _check_mounted_on TEST_DEV $TEST_DEV TEST_DIR $TEST_DIR $FSTYP || exit 1
3710         if [ -n "$SCRATCH_DEV" ]; then
3711                 # Sanity check that SCRATCH partition is not mounted at another
3712                 # mount point, because it is about to be unmounted and formatted.
3713                 # Another fs type for scratch is fine (bye bye old fs type).
3714                 _check_mounted_on SCRATCH_DEV $SCRATCH_DEV SCRATCH_MNT $SCRATCH_MNT
3715                 [ $? -le 1 ] || exit 1
3716         fi
3717
3718         # Figure out if we need to add -F ("foreign", deprecated) option to xfs_io
3719         $XFS_IO_PROG -c stat $TEST_DIR 2>&1 | grep -q "is not on an XFS filesystem" && \
3720                 export XFS_IO_PROG="$XFS_IO_PROG -F"
3721
3722         # xfs_io -i option starts an idle thread for xfs_io.
3723         # With single threaded process, the file table is not shared
3724         # and file structs are not reference counted.
3725         # Spawning an idle thread can help detecting file struct
3726         # reference leaks, so we want to enable the option whenever
3727         # it is supported.
3728         $XFS_IO_PROG -i -c quit 2>/dev/null && \
3729                 export XFS_IO_PROG="$XFS_IO_PROG -i"
3730
3731         # xfs_copy on v5 filesystems do not require the "-d" option if xfs_db
3732         # can change the UUID on v5 filesystems
3733         if [ "$FSTYP" == "xfs" ]; then
3734                 touch /tmp/$$.img
3735                 $MKFS_XFS_PROG -d file,name=/tmp/$$.img,size=512m >/dev/null 2>&1
3736                 # xfs_db will return 0 even if it can't generate a new uuid, so
3737                 # check the output to make sure if it can change UUID of V5 xfs
3738                 $XFS_DB_PROG -x -c "uuid generate" /tmp/$$.img \
3739                         | grep -q "invalid UUID\|supported on V5 fs" \
3740                         && export XFS_COPY_PROG="$XFS_COPY_PROG -d"
3741                 rm -f /tmp/$$.img
3742         fi
3743 }
3744
3745 # get real device path name by following link
3746 _real_dev()
3747 {
3748         local dev=$1
3749         if [ -b "$dev" ] && [ -L "$dev" ]; then
3750                 dev=`readlink -f "$dev"`
3751         fi
3752         echo $dev
3753 }
3754
3755 # basename of a device
3756 _short_dev()
3757 {
3758         echo `basename $(_real_dev $1)`
3759 }
3760
3761 _sysfs_dev()
3762 {
3763         local dev=`_real_dev $1`
3764         local maj=$(stat -c%t $dev | tr [:lower:] [:upper:])
3765         local min=$(stat -c%T $dev | tr [:lower:] [:upper:])
3766         maj=$(echo "ibase=16; $maj" | bc)
3767         min=$(echo "ibase=16; $min" | bc)
3768         echo /sys/dev/block/$maj:$min
3769 }
3770
3771 # Get the minimum block size of a file.  Usually this is the
3772 # minimum fs block size, but some filesystems (ocfs2) do block
3773 # mappings in larger units.
3774 _get_file_block_size()
3775 {
3776         if [ -z $1 ] || [ ! -d $1 ]; then
3777                 echo "Missing mount point argument for _get_file_block_size"
3778                 exit 1
3779         fi
3780         if [ "$FSTYP" = "ocfs2" ]; then
3781                 stat -c '%o' $1
3782         else
3783                 _get_block_size $1
3784         fi
3785 }
3786
3787 # Get the minimum block size of an fs.
3788 _get_block_size()
3789 {
3790         if [ -z $1 ] || [ ! -d $1 ]; then
3791                 echo "Missing mount point argument for _get_block_size"
3792                 exit 1
3793         fi
3794         stat -f -c %S $1
3795 }
3796
3797 get_page_size()
3798 {
3799         echo $(getconf PAGE_SIZE)
3800 }
3801
3802
3803 run_fsx()
3804 {
3805         echo fsx $@
3806         local args=`echo $@ | sed -e "s/ BSIZE / $bsize /g" -e "s/ PSIZE / $psize /g"`
3807         set -- $here/ltp/fsx $args $FSX_AVOID $TEST_DIR/junk
3808         echo "$@" >>$seqres.full
3809         rm -f $TEST_DIR/junk
3810         "$@" 2>&1 | tee -a $seqres.full >$tmp.fsx
3811         if [ ${PIPESTATUS[0]} -ne 0 ]; then
3812                 cat $tmp.fsx
3813                 rm -f $tmp.fsx
3814                 exit 1
3815         fi
3816         rm -f $tmp.fsx
3817 }
3818
3819 # Test for the existence of a sysfs entry at /sys/fs/$FSTYP/DEV/$ATTR
3820 #
3821 # Only one argument is needed:
3822 #  - attr: path name under /sys/fs/$FSTYP/DEV
3823 #
3824 # Usage example:
3825 #   _require_fs_sysfs error/fail_at_unmount
3826 _require_fs_sysfs()
3827 {
3828         local attr=$1
3829         local dname=$(_short_dev $TEST_DEV)
3830
3831         if [ -z "$attr" -o -z "$dname" ];then
3832                 _fail "Usage: _require_fs_sysfs <sysfs_attr_path>"
3833         fi
3834
3835         if [ ! -e /sys/fs/${FSTYP}/${dname}/${attr} ];then
3836                 _notrun "This test requires /sys/fs/${FSTYP}/${dname}/${attr}"
3837         fi
3838 }
3839
3840 _require_statx()
3841 {
3842         $here/src/stat_test --check-statx ||
3843         _notrun "This test requires the statx system call"
3844 }
3845
3846 # Write "content" into /sys/fs/$FSTYP/$DEV/$ATTR
3847 #
3848 # All arguments are necessary, and in this order:
3849 #  - dev: device name, e.g. $SCRATCH_DEV
3850 #  - attr: path name under /sys/fs/$FSTYP/$dev
3851 #  - content: the content of $attr
3852 #
3853 # Usage example:
3854 #   _set_fs_sysfs_attr /dev/mapper/scratch-dev error/fail_at_unmount 0
3855 _set_fs_sysfs_attr()
3856 {
3857         local dev=$1
3858         shift
3859         local attr=$1
3860         shift
3861         local content="$*"
3862
3863         if [ ! -b "$dev" -o -z "$attr" -o -z "$content" ];then
3864                 _fail "Usage: _set_fs_sysfs_attr <mounted_device> <attr> <content>"
3865         fi
3866
3867         local dname=$(_short_dev $dev)
3868         echo "$content" > /sys/fs/${FSTYP}/${dname}/${attr}
3869 }
3870
3871 # Print the content of /sys/fs/$FSTYP/$DEV/$ATTR
3872 #
3873 # All arguments are necessary, and in this order:
3874 #  - dev: device name, e.g. $SCRATCH_DEV
3875 #  - attr: path name under /sys/fs/$FSTYP/$dev
3876 #
3877 # Usage example:
3878 #   _get_fs_sysfs_attr /dev/mapper/scratch-dev error/fail_at_unmount
3879 _get_fs_sysfs_attr()
3880 {
3881         local dev=$1
3882         local attr=$2
3883
3884         if [ ! -b "$dev" -o -z "$attr" ];then
3885                 _fail "Usage: _get_fs_sysfs_attr <mounted_device> <attr>"
3886         fi
3887
3888         local dname=$(_short_dev $dev)
3889         cat /sys/fs/${FSTYP}/${dname}/${attr}
3890 }
3891
3892 # Generic test for specific filesystem feature.
3893 # Currently only implemented to test overlayfs features.
3894 _require_scratch_feature()
3895 {
3896         local feature=$1
3897
3898         case "$FSTYP" in
3899         overlay)
3900                 _require_scratch_overlay_features ${feature}
3901                 ;;
3902         *)
3903                 _fail "Test for feature '${feature}' of ${FSTYP} is not implemented"
3904                 ;;
3905         esac
3906 }
3907
3908 # Get the maximum size of a file in $TEST_DIR (s_maxbytes).  On ext4 this will
3909 # be UINT32_MAX * block_size, but other filesystems may allow up to LLONG_MAX.
3910 _get_max_file_size()
3911 {
3912         local testfile=$TEST_DIR/maxfilesize.$seq
3913         local l=0
3914         local r=9223372036854775807 # LLONG_MAX
3915
3916         rm -f $testfile
3917         while (( l < r )); do
3918                 # Use _math() to avoid signed integer overflow.
3919                 local m=$(_math "($l + $r + 1) / 2")
3920                 if $XFS_IO_PROG -f -c "truncate $m" $testfile \
3921                         |& grep -q 'File too large'
3922                 then
3923                         r=$(( m - 1 ))
3924                 else
3925                         l=$m
3926                 fi
3927         done
3928         echo $l
3929 }
3930
3931 # get MAX_LFS_FILESIZE
3932 _get_max_lfs_filesize()
3933 {
3934         case "$(getconf LONG_BIT)" in
3935         "32")
3936                 echo $(( ($(getconf PAGE_SIZE) << ($(getconf LONG_BIT) - 1) ) - 1))
3937                 ;;
3938         "64")
3939                 echo 9223372036854775807
3940                 ;;
3941         *)
3942                 _fail "sizeof(long) == $(getconf LONG_BIT)?"
3943                 ;;
3944         esac
3945 }
3946
3947 # The maximum filesystem label length, /not/ including terminating NULL
3948 _label_get_max()
3949 {
3950         case $FSTYP in
3951         xfs)
3952                 echo 12
3953                 ;;
3954         btrfs)
3955                 echo 255
3956                 ;;
3957         f2fs)
3958                 echo 255
3959                 ;;
3960         *)
3961                 _notrun "$FSTYP does not define maximum label length"
3962                 ;;
3963         esac
3964 }
3965
3966 # Helper to check above early in a script
3967 _require_label_get_max()
3968 {
3969         # Just call _label_get_max which will notrun if appropriate
3970         dummy=$(_label_get_max)
3971 }
3972
3973 _dmsetup_remove()
3974 {
3975         $UDEV_SETTLE_PROG >/dev/null 2>&1
3976         $DMSETUP_PROG remove "$@" >>$seqres.full 2>&1
3977         $DMSETUP_PROG mknodes >/dev/null 2>&1
3978 }
3979
3980 _dmsetup_create()
3981 {
3982         $DMSETUP_PROG create "$@" >>$seqres.full 2>&1 || return 1
3983         $DMSETUP_PROG mknodes >/dev/null 2>&1
3984         $UDEV_SETTLE_PROG >/dev/null 2>&1
3985 }
3986
3987 _require_btime()
3988 {
3989         # Note: filesystems are not required to report btime (creation time)
3990         # if the caller doesn't ask for it, so we define STATX_BTIME here and
3991         # pass it in to the statx command.
3992         export STATX_BTIME=0x800
3993         $XFS_IO_PROG -f $TEST_DIR/test_creation_time -c "statx -m $STATX_BTIME -v" \
3994                 | grep btime >>$seqres.full 2>&1 || \
3995                 _notrun "inode creation time not supported by this filesystem"
3996         rm -f $TEST_DIR/test_creation_time
3997 }
3998
3999 _require_scratch_btime()
4000 {
4001         _require_scratch
4002         _scratch_mkfs > /dev/null 2>&1
4003         _scratch_mount
4004
4005         # Note: filesystems are not required to report btime (creation time)
4006         # if the caller doesn't ask for it, so we define STATX_BTIME here and
4007         # pass it in to the statx command.
4008         export STATX_BTIME=0x800
4009         $XFS_IO_PROG -f $SCRATCH_MNT/test_creation_time -c "statx -m $STATX_BTIME -v" \
4010                 | grep btime >>$seqres.full 2>&1 || \
4011                 _notrun "inode creation time not supported by this filesystem"
4012
4013         _scratch_unmount
4014 }
4015
4016 _require_inode_limits()
4017 {
4018         if [ $(_get_free_inode $TEST_DIR) -eq 0 ]; then
4019                 _notrun "$FSTYP does not have a fixed number of inodes available"
4020         fi
4021 }
4022
4023 _require_filefrag_options()
4024 {
4025         _require_command "$FILEFRAG_PROG" filefrag
4026
4027         local options=$1
4028         local file="$TEST_DIR/options_testfile"
4029
4030         echo "XX" > $file
4031         ${FILEFRAG_PROG} -$options $file 2>&1 | grep -q "invalid option" && \
4032                 _notrun "filefrag doesn't support $options option"
4033         rm -f $file
4034 }
4035
4036 _require_fibmap()
4037 {
4038         _require_filefrag_options "B"
4039
4040         local file="$TEST_DIR/fibmap_testfile"
4041
4042         echo "XX" > $file
4043         ${FILEFRAG_PROG} -B $file 2>&1 | grep -q "FIBMAP[[:space:]]*unsupported"
4044         if [ $? -eq 0 ]; then
4045                 _notrun "FIBMAP not supported by this filesystem"
4046         fi
4047         rm -f $file
4048 }
4049
4050 _try_wipe_scratch_devs()
4051 {
4052         test -x "$WIPEFS_PROG" || return 0
4053
4054         # Do specified filesystem wipe at first
4055         case "$FSTYP" in
4056         "xfs")
4057                 _try_wipe_scratch_xfs
4058                 ;;
4059         esac
4060
4061         # Then do wipefs on all scratch devices
4062         for dev in $SCRATCH_DEV_POOL $SCRATCH_DEV $SCRATCH_LOGDEV $SCRATCH_RTDEV; do
4063                 test -b $dev && $WIPEFS_PROG -a $dev
4064         done
4065 }
4066
4067 # Only run this on xfs if xfs_scrub is available and has the unicode checker
4068 _check_xfs_scrub_does_unicode() {
4069         [ "${FSTYP}" == "xfs" ] || return 1
4070
4071         local mount="$1"
4072         local dev="$2"
4073
4074         _supports_xfs_scrub "${mount}" "${dev}" || return 1
4075
4076         # We only care if xfs_scrub has unicode string support...
4077         if ! type ldd > /dev/null 2>&1 || \
4078            ! ldd "${XFS_SCRUB_PROG}" | grep -q libicui18n; then
4079                 return 1
4080         fi
4081
4082         return 0
4083 }
4084
4085 init_rc
4086
4087 ################################################################################
4088 # make sure this script returns success
4089 /bin/true