2 #-----------------------------------------------------------------------
3 # Copyright (c) 2000-2004 Silicon Graphics, Inc. All Rights Reserved.
4 # This program is free software; you can redistribute it and/or modify
5 # it under the terms of the GNU General Public License as published by
6 # the Free Software Foundation; either version 2 of the License, or
7 # (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19 # Contact information: Silicon Graphics, Inc., 1500 Crittenden Lane,
20 # Mountain View, CA 94043, USA, or: http://www.sgi.com
21 #-----------------------------------------------------------------------
27 export MOUNT_OPTIONS=$XFS_MOUNT_OPTIONS
30 export MOUNT_OPTIONS=$UDF_MOUNT_OPTIONS
33 export MOUNT_OPTIONS=$NFS_MOUNT_OPTIONS
44 export MKFS_OPTIONS=$XFS_MKFS_OPTIONS
47 [ ! -z "$udf_fsize" ] && \
48 UDF_MKFS_OPTIONS="$UDF_MKFS_OPTIONS -s $udf_fsize"
49 export MKFS_OPTIONS=$UDF_MKFS_OPTIONS
52 export MKFS_OPTIONS=$NFS_MKFS_OPTIONS
59 [ -z "$FSTYP" ] && FSTYP=xfs
60 [ -z "$MOUNT_OPTIONS" ] && _mount_opts
61 [ -z "$MKFS_OPTIONS" ] && _mkfs_opts
64 # we need common.config
65 if ! . ./common.config
67 echo "$iam: failed to source common.config"
71 # make sure we have a standard umask
84 if [ $FSTYP != "xfs" ]; then
90 [ "$HOSTOS" != "IRIX" ] && SCRATCH_OPTIONS="$SCRATCH_OPTIONS -f"
99 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
100 SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${rt_opt}rtdev=$SCRATCH_RTDEV"
101 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
102 SCRATCH_OPTIONS="$SCRATCH_OPTIONS ${log_opt}logdev=$SCRATCH_LOGDEV"
110 if [ $FSTYP != "xfs" ]; then
124 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_RTDEV" ] && \
125 TEST_OPTIONS="$TEST_OPTIONS ${rt_opt}rtdev=$TEST_RTDEV"
126 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_LOGDEV" ] && \
127 TEST_OPTIONS="$TEST_OPTIONS ${log_opt}logdev=$TEST_LOGDEV"
130 _scratch_mount_options()
132 _scratch_options mount
133 echo $SCRATCH_OPTIONS $MOUNT_OPTIONS $* $SCRATCH_DEV $SCRATCH_MNT
138 _mount -t $FSTYP `_scratch_mount_options $*`
144 _mount -t $FSTYP $TEST_OPTIONS $MOUNT_OPTIONS $* $TEST_DEV $TEST_DIR
147 _scratch_mkfs_options()
149 _scratch_options mkfs
150 echo $SCRATCH_OPTIONS $MKFS_OPTIONS $* $SCRATCH_DEV
155 _scratch_options mkfs
157 $MKFS_XFS_PROG $SCRATCH_OPTIONS $MKFS_OPTIONS $* $SCRATCH_DEV
160 if [ "$USE_BIG_LOOPFS" = yes ]; then
161 [ -z "$RETAIN_AG_BYTES" ] && RETAIN_AG_BYTES=0
162 ./tools/ag-wipe -q -r $RETAIN_AG_BYTES $SCRATCH_DEV
178 $MKFS_UDF_PROG $MKFS_OPTIONS $* $SCRATCH_DEV > /dev/null
181 /sbin/mkfs -t $FSTYP $MKFS_OPTIONS $* $SCRATCH_DEV > /dev/null
186 _scratch_xfs_db_options()
189 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
190 SCRATCH_OPTIONS="-l$SCRATCH_LOGDEV"
191 echo $SCRATCH_OPTIONS $* $SCRATCH_DEV
194 _scratch_xfs_logprint()
197 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
198 SCRATCH_OPTIONS="-l$SCRATCH_LOGDEV"
199 $XFS_LOGPRINT_PROG $SCRATCH_OPTIONS $* $SCRATCH_DEV
202 _scratch_xfs_repair()
205 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
206 SCRATCH_OPTIONS="-l$SCRATCH_LOGDEV"
207 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
208 SCRATCH_OPTIONS=$SCRATCH_OPTIONS" -r$SCRATCH_RTDEV"
209 [ "$USE_BIG_LOOPFS" = yes ] && SCRATCH_OPTIONS=$SCRATCH_OPTIONS" -t"
210 $XFS_REPAIR_PROG $SCRATCH_OPTIONS $* $SCRATCH_DEV
217 echo "Usage: _get_pids_by_name process-name" 1>&2
221 # Algorithm ... all ps(1) variants have a time of the form MM:SS or
222 # HH:MM:SS before the psargs field, use this as the search anchor.
224 # Matches with $1 (process-name) occur if the first psarg is $1
225 # or ends in /$1 ... the matching uses sed's regular expressions,
226 # so passing a regex into $1 will work.
234 -e "/[0-9]:[0-9][0-9] *[^ ]*\/$1 /s/ .*//p" \
235 -e "/[0-9]:[0-9][0-9] *$1 /s/ .*//p"
243 $NSLOOKUP_PROG $host | $AWK_PROG '{ if ($1 == "Name:") print $2 }'
246 # fix malloc libs output
250 # filter out the Electric Fence notice
253 if (defined $o && /^\s+Electric Fence/) {
259 print $o if (defined $o);
263 print $o if (defined $o);
267 # check if run as root
271 id=`id | $SED_PROG -e 's/(.*//' -e 's/.*=//'`
274 echo "Arrgh ... you need to be root (not uid=$id) to run this test"
281 # _df_device : get an IRIX style df line for a given device
283 # - returns "" if not mounted
284 # - returns fs type in field two (ala IRIX)
285 # - joins line together if split by fancy df formatting
286 # - strips header etc
293 echo "Usage: _df_device device" 1>&2
297 $DF_PROG 2>/dev/null | $AWK_PROG -v what=$1 '
298 match($1,what) && NF==1 {
312 # _df_dir : get an IRIX style df line for device where a directory resides
314 # - returns fs type in field two (ala IRIX)
315 # - joins line together if split by fancy df formatting
316 # - strips header etc
323 echo "Usage: _df_dir device" 1>&2
327 $DF_PROG $1 2>/dev/null | $AWK_PROG -v what=$1 '
343 # return percentage used disk space for mounted device
349 echo "Usage: _used device" 1>&2
353 _df_device $1 | $AWK_PROG '{ sub("%", "") ; print $6 }'
356 # return the FS type of a mounted device
362 echo "Usage: _fs_type device" 1>&2
366 _df_device $1 | $AWK_PROG '{ print $2 }'
369 # return the FS mount options of a mounted device
371 # should write a version which just parses the output of mount for IRIX
372 # compatibility, but since this isn't used at all, at the moment I'll leave
379 echo "Usage: _fs_options device" 1>&2
383 $AWK_PROG -v dev=$1 '
384 match($1,dev) { print $4 }
389 # returns device number if a file is a block device
395 echo "Usage: _is_block_dev dev" 1>&2
399 [ -b $1 ] && src/lstat64 $1 | $AWK_PROG '/Device type:/ { print $9 }'
402 # Do a command, log it to $seq.full, optionally test return status
403 # and die if command fails. If called with one argument _do executes the
404 # command, logs it, and returns its exit status. With two arguments _do
405 # first prints the message passed in the first argument, and then "done"
406 # or "fail" depending on the return status of the command passed in the
407 # second argument. If the command fails and the variable _do_die_on_error
408 # is set to "always" or the two argument form is used and _do_die_on_error
409 # is set to "message_only" _do will print an error message to
414 if [ $# -eq 1 ]; then
416 elif [ $# -eq 2 ]; then
421 echo "Usage: _do [note] cmd" 1>&2
425 (eval "echo '---' \"$_cmd\"") >>$here/$seq.full
426 (eval "$_cmd") >$tmp._out 2>&1; ret=$?
427 cat $tmp._out | _fix_malloc >>$here/$seq.full
428 if [ $# -eq 2 ]; then
429 if [ $ret -eq 0 ]; then
436 && [ "$_do_die_on_error" = "always" \
437 -o \( $# -eq 2 -a "$_do_die_on_error" = "message_only" \) ]
440 eval "echo \"$_cmd\" failed \(returned $ret\): see $seq.full"
447 # bail out, setting up .notrun file
451 echo "$*" >$seq.notrun
452 echo "$seq not run: $*"
457 # just plain bail out
461 echo "$*" | tee -a $here/$seq.full
462 echo "(see $seq.full for details)"
467 # tests whether $FSTYP is one of the supported filesystems for a test
473 if [ "$f" = "$FSTYP" ]
479 _notrun "not suitable for this filesystem type: $FSTYP"
482 # tests whether $FSTYP is one of the supported OSes for a test
488 if [ "$h" = "$HOSTOS" ]
494 _notrun "not suitable for this OS: $HOSTOS"
497 # this test needs a scratch partition - check we're ok & unmount it
503 if [ -z "$SCRATCH_DEV" -o "`_is_block_dev $SCRATCH_DEV`" = "" ]
505 _notrun "this test requires a valid \$SCRATCH_DEV"
508 if [ "`_is_block_dev $SCRATCH_DEV`" = "`_is_block_dev $TEST_DEV`" ]
510 _notrun "this test requires a valid \$SCRATCH_DEV"
513 nfs*|ext2|ext3|reiserfs)
514 echo $SCRATCH_DEV | grep -q ":" > /dev/null 2>&1
515 if [ ! -z "$SCRATCH_DEV" -a ! -b "$SCRATCH_DEV" -a "$?" != "0" ]
517 _notrun "this test requires a valid \$SCRATCH_DEV"
521 _notrun "\$FSTYP ($FSTYP) unknown or not specified"
527 if _mount | grep -q $SCRATCH_DEV
529 # if it's mounted, make sure its on $SCRATCH_MNT
530 if ! _mount | grep $SCRATCH_DEV | grep -q $SCRATCH_MNT
532 echo "\$SCRATCH_DEV is mounted but not on \$SCRATCH_MNT - aborting"
535 # and then unmount it
536 if ! $UMOUNT_PROG $SCRATCH_DEV
538 echo "failed to unmount $SCRATCH_DEV"
544 # this test needs a logdev
548 [ -z "$SCRATCH_LOGDEV" -o ! -b "$SCRATCH_LOGDEV" ] && \
549 _notrun "This test requires a valid \$SCRATCH_LOGDEV"
550 [ "$USE_EXTERNAL" != yes ] && \
551 _notrun "This test requires USE_EXTERNAL to be enabled"
553 # ensure its not mounted
554 $UMOUNT_PROG $SCRATCH_LOGDEV 2>/dev/null
557 # this test requires loopback device support
561 if [ "$HOSTOS" != "Linux" ]
563 _notrun "This test requires linux for loopback device support"
566 modprobe loop >/dev/null 2>&1
567 if grep loop /proc/devices >/dev/null 2>&1
571 _notrun "This test requires loopback device support"
575 # this test requires that (large) loopback device files are not in use
577 _require_nobigloopfs()
579 [ "$USE_BIG_LOOPFS" = yes ] && \
580 _notrun "Large filesystem testing in progress, skipped this test"
583 # this test requires that a realtime subvolume is in use, and
584 # that the kernel supports realtime as well.
588 [ "$USE_EXTERNAL" = yes ] || \
589 _notrun "External volumes not in use, skipped this test"
590 [ "$SCRATCH_RTDEV" = "" ] && \
591 _notrun "Realtime device required, skipped this test"
594 # this test requires that a specified command (executable) exists
598 [ -x "$1" ] || _notrun "$1 utility required, skipped this test"
601 # this test requires that external log/realtime devices are not in use
603 _require_nonexternal()
605 [ "$USE_EXTERNAL" = yes ] && \
606 _notrun "External device testing in progress, skipped this test"
609 # check that a FS is mounted as XFS. if so, return mount point
615 echo "Usage: _xfs_mounted device" 1>&2
621 if _mount | grep $device | $AWK_PROG '
622 /type xfs/ { print $3 ; exit 0 }
626 echo "_xfs_mounted: $device is not a mounted XFS FS"
632 # remount a FS to a new mode (ro or rw)
638 echo "Usage: _remount device ro/rw" 1>&2
644 if ! mount -o remount,$mode $device
646 echo "_remount: failed to remount filesystem on $device as $mode"
651 # run xfs_check and friends on a FS.
653 # if the filesystem is mounted, it's either remounted ro before being
654 # checked or it's unmounted and then remounted
659 _check_xfs_filesystem()
663 echo "Usage: _check_xfs_filesystem device <logdev>|none <rtdev>|none" 1>&2
668 if [ "$2" != "none" ]; then
669 extra_log_options="-l$2"
670 extra_mount_options="-ologdev=$2"
673 if [ "$3" != "none" ]; then
674 extra_rt_options="-r$3"
675 extra_mount_options=$extra_mount_options" -ortdev=$3"
678 [ "$FSTYP" != xfs ] && return 0
680 [ "$USE_BIG_LOOPFS" = yes ] && testoption=-t
682 type=`_fs_type $device`
685 if [ "$type" = "xfs" ]
689 if [ $USE_REMOUNT -eq 0 ]
691 mountpoint=`_xfs_mounted $device`
698 $XFS_LOGPRINT_PROG -t $extra_log_options $device 2>&1 \
699 | tee $tmp.logprint | grep -q "<CLEAN>"
700 if [ $? -ne 0 -a "$HOSTOS" = "Linux" ]
702 echo "_check_xfs_filesystem: filesystem on $device has dirty log (see $seq.full)"
704 echo "_check_xfs_filesystem: filesystem on $device has dirty log" >>$here/$seq.full
705 echo "*** xfs_logprint -t output ***" >>$here/$seq.full
706 cat $tmp.logprint >>$here/$seq.full
707 echo "*** end xfs_logprint output" >>$here/$seq.full
712 $XFS_CHECK_PROG $testoption $extra_log_options $device 2>&1 |\
713 _fix_malloc >$tmp.fs_check
714 if [ -s $tmp.fs_check ]
716 echo "_check_xfs_filesystem: filesystem on $device is inconsistent (c) (see $seq.full)"
718 echo "_check_xfs_filesystem: filesystem on $device is inconsistent" >>$here/$seq.full
719 echo "*** xfs_check output ***" >>$here/$seq.full
720 cat $tmp.fs_check >>$here/$seq.full
721 echo "*** end xfs_check output" >>$here/$seq.full
725 # repair doesn't scale massively at this stage, optionally skip it for now
726 [ "$USE_BIG_LOOPFS" = yes ] || \
727 $XFS_REPAIR_PROG -n $extra_log_options $extra_rt_options $device >$tmp.repair 2>&1
730 echo "_check_xfs_filesystem: filesystem on $device is inconsistent (r) (see $seq.full)"
732 echo "_check_xfs_filesystem: filesystem on $device is inconsistent" >>$here/$seq.full
733 echo "*** xfs_repair -n output ***" >>$here/$seq.full
734 cat $tmp.repair | _fix_malloc >>$here/$seq.full
735 echo "*** end xfs_repair output" >>$here/$seq.full
739 rm -f $tmp.fs_check $tmp.logprint $tmp.repair
743 echo "*** mount output ***" >>$here/$seq.full
744 _mount >>$here/$seq.full
745 echo "*** end mount output" >>$here/$seq.full
746 elif [ "$type" = "xfs" ]
749 if [ $USE_REMOUNT -eq 0 ]
751 if ! _mount -t xfs $extra_mount_options $device $mountpoint
753 echo "!!! failed to remount $device on $mountpoint"
761 [ $ok -eq 0 ] && exit 1
765 # Filter the knowen errors the UDF Verifier reports.
766 _udf_test_known_error_filter()
768 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."
772 _check_udf_filesystem()
774 [ "$DISABLE_UDF_TEST" == "1" ] && return
776 if [ $# -ne 1 -a $# -ne 2 ]
778 echo "Usage: _check_udf_filesystem device [last_block]" 1>&2
782 if [ ! -x $here/src/udf_test ]
784 echo "udf_test not installed, please download and build the Philips"
785 echo "UDF Verification Software from http://www.extra.research.philips.com/udf/."
786 echo "Then copy the udf_test binary to $here/src/."
787 echo "If you do not wish to run udf_test then set environment variable DISABLE_UDF_TEST"
795 LAST_BLOCK=`expr \( $2 - 1 \)`
796 OPT_ARG="-lastvalidblock $LAST_BLOCK"
800 sleep 1 # Due to a problem with time stamps in udf_test
801 $here/src/udf_test $OPT_ARG $device | tee $here/$seq.checkfs | egrep "Error|Warning" | \
802 _udf_test_known_error_filter | \
803 egrep -iv "Error count:.*[0-9]+.*total occurrences:.*[0-9]+|Warning count:.*[0-9]+.*total occurrences:.*[0-9]+" | \
804 sed "s/^.*$/Warning UDF Verifier reported errors see $seq.checkfs./g"
812 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_LOGDEV" ] && \
813 TEST_LOG="$TEST_LOGDEV"
815 [ "$USE_EXTERNAL" = yes -a ! -z "$TEST_RTDEV" ] && \
816 TEST_RT="$TEST_RTDEV"
818 _check_xfs_filesystem $TEST_DEV $TEST_LOG $TEST_RT
827 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_LOGDEV" ] && \
828 SCRATCH_LOG="$SCRATCH_LOGDEV"
830 [ "$USE_EXTERNAL" = yes -a ! -z "$SCRATCH_RTDEV" ] && \
831 SCRATCH_RT="$SCRATCH_RTDEV"
833 _check_xfs_filesystem $SCRATCH_DEV $SCRATCH_LOG $SCRATCH_RT
836 _check_udf_filesystem $SCRATCH_DEV $udf_fsize
839 # Don't know how to check an NFS filesystem, yet.
846 _full_fstyp_details()
848 [ -z "$FSTYP" ] && FSTYP=xfs
849 if [ $FSTYP = xfs ]; then
850 if [ -d /proc/fs/xfs ]; then
851 if grep -q 'debug 0' /proc/fs/xfs/stat; then
852 FSTYP="$FSTYP (non-debug)"
853 elif grep -q 'debug 1' /proc/fs/xfs/stat; then
854 FSTYP="$FSTYP (debug)"
857 if uname -a | grep -qi 'debug'; then
858 FSTYP="$FSTYP (debug)"
860 FSTYP="$FSTYP (non-debug)"
867 _full_platform_details()
873 echo "$os/$platform $host $kernel"
888 # Don't know how to check an NFS filesystem, yet.
898 [ "$FSTYP" != "xfs" ] \
899 && _fail "setup_xfs_testdir: \$FSTYP ($FSTYP) is not xfs"
904 _setup_udf_scratchdir()
906 [ "$FSTYP" != "udf" ] \
907 && _fail "setup_udf_testdir: \$FSTYP is not udf"
908 [ -z "$SCRATCH_DEV" -o ! -b "$SCRATCH_DEV" ] \
909 && _notrun "this test requires a valid \$SCRATCH_DEV"
910 [ -z "$SCRATCH_MNT" ] \
911 && _notrun "this test requires a valid \$SCRATCH_MNT"
914 if _mount | grep -q $SCRATCH_DEV
916 # if it's mounted, make sure its on $TEST_RW_DIR
917 if ! _mount | grep $SCRATCH_DEV | grep -q $SCRATCH_MNT
919 _fail "\$SCRATCH_DEV is mounted but not on \$SCRATCH_MNT - aborting"
921 $UMOUNT_PROG $SCRATCH_DEV
930 _setup_nfs_scratchdir()
932 [ "$FSTYP" != "nfs" ] \
933 && _fail "setup_nfs_testdir: \$FSTYP is not nfs"
934 [ -z "$SCRATCH_DEV" ] \
935 && _notrun "this test requires a valid host fs for \$SCRATCH_DEV"
936 [ -z "$SCRATCH_MNT" ] \
937 && _notrun "this test requires a valid \$SCRATCH_MNT"
940 if _mount | grep -q $SCRATCH_DEV
942 # if it's mounted, make sure its on $SCRATCH_MNT
943 if ! _mount | grep $SCRATCH_DEV | grep -q $SCRATCH_MNT
945 _fail "\$SCRATCH_DEV is mounted but not on \$SCRATCH_MNT - aborting"
947 $UMOUNT_PROG $SCRATCH_DEV
957 # Warning for UDF and NFS this function calls _setup_udf_scratchdir and
958 # _setup_udf_scratchdir. This is done because testdir is a persistent
959 # XFS only partition.
968 _setup_udf_scratchdir
971 _setup_nfs_scratchdir
974 _fail "\$FSTYP is not xfs, udf or nfs"
983 # do nothing, testdir is $TEST_DIR
987 # umount testdir as it is $SCRATCH_MNT which could be used by xfs next
988 [ -n "$testdir" ] && $UMOUNT_PROG $testdir
991 # umount testdir as it is $SCRATCH_MNT which could be used by xfs next
992 [ -n "$testdir" ] && $UMOUNT_PROG $testdir
995 _fail "\$FSTYP is not xfs, udf or nfs"
1000 ################################################################################
1002 if [ "$iam" != new -a "$iam" != bench ]
1004 # make some further configuration checks here
1006 if [ "$TEST_DEV" = "" ]
1008 echo "common.rc: Error: \$TEST_DEV is not set"
1012 # if $TEST_DEV is not mounted, mount it now as XFS
1013 if [ -z "`_fs_type $TEST_DEV`" ]
1015 # $TEST_DEV is not mounted
1018 echo "common.rc: retrying test device mount with external set"
1019 [ "$USE_EXTERNAL" != "yes" ] && export USE_EXTERNAL=yes
1022 echo "common.rc: could not mount $TEST_DEV on $TEST_DIR"
1028 if [ "`_fs_type $TEST_DEV`" != "xfs" ]
1030 echo "common.rc: Error: \$TEST_DEV ($TEST_DEV) is not a MOUNTED XFS filesystem"
1039 if [ -z "$1" ]; then
1040 echo Error must pass \$seq.
1044 if [ "`uname`" == "IRIX64" ] || [ "`uname`" == "IRIX" ]; then
1046 elif [ "`uname`" == "Linux" ]; then
1049 echo Error test $seq does not run on the operating system: `uname`
1054 # Populate a filesystem with inodes for performance experiments
1056 # usage: populate [-v] [-n ndirs] [-f nfiles] [-d depth] [-r root] [-s size]
1072 if [ $size -gt 0 ]; then
1073 dd if=/dev/zero of=$file bs=1024 count=$size
1079 # takes dirname, depth
1082 dirname=$1; depth=$2
1083 mkdir $dirname || die "mkdir $dirname failed"
1086 _nfiles $files # files for this dir
1088 [ $depth -eq 0 ] && return
1089 deep=`expr $depth - 1` # go 1 down
1091 [ $verbose = true ] && echo "descending, depth from leaves = $deep"
1094 while [ $d -lt $dirs ]
1096 _descend d$d $deep &
1107 dirs=5 # ndirs in each subdir till leaves
1108 size=0 # sizeof files in K
1109 files=100 # num files in _each_ subdir
1110 depth=2 # depth of tree from root to leaves
1112 root=root # path of initial root of directory tree
1114 while getopts "d:f:n:r:s:v" c
1127 _descend $root $depth
1132 [ $verbose = true ] && echo done
1136 # make sure this script returns success