lustre/tests/test-framework.sh

   1 #!/bin/bash
   2
   3 trap 'print_summary && print_stack_trace | tee $TF_FAIL && \
   4     echo "$TESTSUITE: FAIL: test-framework exiting on error"' ERR
   5 set -e
   6
   7 export LANG=en_US
   8 export REFORMAT=${REFORMAT:-""}
   9 export WRITECONF=${WRITECONF:-""}
  10 export VERBOSE=${VERBOSE:-false}
  11 export GSS=${GSS:-false}
  12 export GSS_SK=${GSS_SK:-false}
  13 export GSS_KRB5=false
  14 export GSS_PIPEFS=false
  15 export SHARED_KEY=${SHARED_KEY:-false}
  16 export SK_PATH=${SK_PATH:-/tmp/test-framework-keys}
  17 export SK_OM_PATH=$SK_PATH'/tmp-request-mount'
  18 export SK_MOUNTED=${SK_MOUNTED:-false}
  19 export SK_FLAVOR=${SK_FLAVOR:-ski}
  20 export SK_NO_KEY=${SK_NO_KEY:-true}
  21 export SK_UNIQUE_NM=${SK_UNIQUE_NM:-false}
  22 export SK_S2S=${SK_S2S:-false}
  23 export SK_S2SNM=${SK_S2SNM:-TestFrameNM}
  24 export SK_S2SNMCLI=${SK_S2SNMCLI:-TestFrameNMCli}
  25 export SK_SKIPFIRST=${SK_SKIPFIRST:-true}
  26 export IDENTITY_UPCALL=default
  27 export QUOTA_AUTO=1
  28 export FLAKEY=${FLAKEY:-true}
  29 # specify environment variable containing batch job name for server statistics
  30 export JOBID_VAR=${JOBID_VAR:-"procname_uid"}  # or "existing" or "disable"
  31
  32 #export PDSH="pdsh -S -Rssh -w"
  33 export MOUNT_CMD=${MOUNT_CMD:-"mount -t lustre"}
  34 export UMOUNT=${UMOUNT:-"umount -d"}
  35
  36 export LSNAPSHOT_CONF="/etc/ldev.conf"
  37 export LSNAPSHOT_LOG="/var/log/lsnapshot.log"
  38
  39 # sles12 umount has a issue with -d option
  40 [ -e /etc/SuSE-release ] && grep -w VERSION /etc/SuSE-release | grep -wq 12 && {
  41         export UMOUNT="umount"
  42 }
  43
  44 # function used by scripts run on remote nodes
  45 LUSTRE=${LUSTRE:-$(cd $(dirname $0)/..; echo $PWD)}
  46 . $LUSTRE/tests/functions.sh
  47 . $LUSTRE/tests/yaml.sh
  48
  49 export LD_LIBRARY_PATH=${LUSTRE}/utils/.libs:${LUSTRE}/utils:${LD_LIBRARY_PATH}
  50
  51 LUSTRE_TESTS_CFG_DIR=${LUSTRE_TESTS_CFG_DIR:-${LUSTRE}/tests/cfg}
  52
  53 EXCEPT_LIST_FILE=${EXCEPT_LIST_FILE:-${LUSTRE_TESTS_CFG_DIR}/tests-to-skip.sh}
  54
  55 if [ -f "$EXCEPT_LIST_FILE" ]; then
  56     echo "Reading test skip list from $EXCEPT_LIST_FILE"
  57     cat $EXCEPT_LIST_FILE
  58     . $EXCEPT_LIST_FILE
  59 fi
  60
  61 # check config files for options in decreasing order of preference
  62 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/lustre.conf ] &&
  63     MODPROBECONF=/etc/modprobe.d/lustre.conf
  64 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/Lustre ] &&
  65     MODPROBECONF=/etc/modprobe.d/Lustre
  66 [ -z "$MODPROBECONF" -a -f /etc/modprobe.conf ] &&
  67     MODPROBECONF=/etc/modprobe.conf
  68
  69 sanitize_parameters() {
  70         for i in DIR DIR1 DIR2 MOUNT MOUNT1 MOUNT2
  71         do
  72                 local path=${!i}
  73                 if [ -d "$path" ]; then
  74                         eval export $i=$(echo $path | sed -r 's/\/+$//g')
  75                 fi
  76         done
  77 }
  78 assert_DIR () {
  79         local failed=""
  80         [[ $DIR/ = $MOUNT/* ]] ||
  81                 { failed=1 && echo "DIR=$DIR not in $MOUNT. Aborting."; }
  82         [[ $DIR1/ = $MOUNT1/* ]] ||
  83                 { failed=1 && echo "DIR1=$DIR1 not in $MOUNT1. Aborting."; }
  84         [[ $DIR2/ = $MOUNT2/* ]] ||
  85                 { failed=1 && echo "DIR2=$DIR2 not in $MOUNT2. Aborting"; }
  86
  87         [ -n "$failed" ] && exit 99 || true
  88 }
  89
  90 usage() {
  91     echo "usage: $0 [-r] [-f cfgfile]"
  92     echo "       -r: reformat"
  93
  94     exit
  95 }
  96
  97 print_summary () {
  98         trap 0
  99         [ -z "$DEFAULT_SUITES" ] && return 0
 100         [ -n "$ONLY" ] && echo "WARNING: ONLY is set to $(echo $ONLY)"
 101         local details
 102         local form="%-13s %-17s %-9s %s %s\n"
 103
 104         printf "$form" "status" "script" "Total(sec)" "E(xcluded) S(low)"
 105         echo "---------------------------------------------------------------"
 106     for O in $DEFAULT_SUITES; do
 107         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
 108         [ "${!O}" = "no" ] && continue || true
 109         local o=$(echo $O  | tr "[:upper:]_" "[:lower:]-")
 110         local log=${TMP}/${o}.log
 111         if is_sanity_benchmark $o; then
 112             log=${TMP}/sanity-benchmark.log
 113         fi
 114         local slow=
 115         local skipped=
 116         local total=
 117         local status=Unfinished
 118         if [ -f $log ]; then
 119                 skipped=$(grep excluded $log | awk '{ printf " %s", $3 }' |
 120                         sed 's/test_//g')
 121                 slow=$(egrep "^PASS|^FAIL" $log | tr -d "("| sed s/s\)$//g |
 122                         sort -nr -k 3  | head -n5 |  awk '{ print $2":"$3"s" }')
 123                 total=$(grep duration $log | awk '{ print $2 }')
 124                 if [ "${!O}" = "done" ]; then
 125                         status=Done
 126                 fi
 127                 if $DDETAILS; then
 128                         local durations=$(egrep "^PASS|^FAIL" $log |
 129                                 tr -d "("| sed s/s\)$//g |
 130                                 awk '{ print $2":"$3"|" }')
 131                         details=$(printf "%s\n%s %s %s\n" "$details" \
 132                                 "DDETAILS" "$O" "$(echo $durations)")
 133                 fi
 134         fi
 135         printf "$form" $status "$O" "${total}" "E=$skipped"
 136         printf "$form" "-" "-" "-" "S=$(echo $slow)"
 137     done
 138
 139     for O in $DEFAULT_SUITES; do
 140         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
 141         if [ "${!O}" = "no" ]; then
 142             printf "$form" "Skipped" "$O" ""
 143         fi
 144     done
 145
 146     # print the detailed tests durations if DDETAILS=true
 147     if $DDETAILS; then
 148         echo "$details"
 149     fi
 150 }
 151
 152 # Get information about the Lustre environment. The information collected
 153 # will be used in Lustre tests.
 154 # usage: get_lustre_env
 155 # input: No required or optional arguments
 156 # output: No return values, environment variables are exported
 157
 158 get_lustre_env() {
 159
 160         export mds1_FSTYPE=${mds1_FSTYPE:-$(facet_fstype mds1)}
 161         export ost1_FSTYPE=${ost1_FSTYPE:-$(facet_fstype ost1)}
 162
 163         export MGS_VERSION=$(lustre_version_code mgs)
 164         export MDS1_VERSION=$(lustre_version_code mds1)
 165         export OST1_VERSION=$(lustre_version_code ost1)
 166         export CLIENT_VERSION=$(lustre_version_code client)
 167
 168         # Prefer using "mds1" directly instead of SINGLEMDS.
 169         # Keep this for compat until it is removed from scripts.
 170         export SINGLEMDS=${SINGLEMDS:-mds1}
 171 }
 172
 173 init_test_env() {
 174         export LUSTRE=$(absolute_path $LUSTRE)
 175         export TESTSUITE=$(basename $0 .sh)
 176         export TEST_FAILED=false
 177         export FAIL_ON_SKIP_ENV=${FAIL_ON_SKIP_ENV:-false}
 178         export RPC_MODE=${RPC_MODE:-false}
 179         export DO_CLEANUP=${DO_CLEANUP:-true}
 180         export KEEP_ZPOOL=${KEEP_ZPOOL:-false}
 181         export CLEANUP_DM_DEV=false
 182         export PAGE_SIZE=$(get_page_size client)
 183
 184         export MKE2FS=$MKE2FS
 185         if [ -z "$MKE2FS" ]; then
 186                 if which mkfs.ldiskfs >/dev/null 2>&1; then
 187                         export MKE2FS=mkfs.ldiskfs
 188                 else
 189                         export MKE2FS=mke2fs
 190                 fi
 191         fi
 192
 193         export DEBUGFS=$DEBUGFS
 194         if [ -z "$DEBUGFS" ]; then
 195                 if which debugfs.ldiskfs >/dev/null 2>&1; then
 196                         export DEBUGFS=debugfs.ldiskfs
 197                 else
 198                         export DEBUGFS=debugfs
 199                 fi
 200         fi
 201
 202         export TUNE2FS=$TUNE2FS
 203         if [ -z "$TUNE2FS" ]; then
 204                 if which tunefs.ldiskfs >/dev/null 2>&1; then
 205                         export TUNE2FS=tunefs.ldiskfs
 206                 else
 207                         export TUNE2FS=tune2fs
 208                 fi
 209         fi
 210
 211         export E2LABEL=$E2LABEL
 212         if [ -z "$E2LABEL" ]; then
 213                 if which label.ldiskfs >/dev/null 2>&1; then
 214                         export E2LABEL=label.ldiskfs
 215                 else
 216                         export E2LABEL=e2label
 217                 fi
 218         fi
 219
 220         export DUMPE2FS=$DUMPE2FS
 221         if [ -z "$DUMPE2FS" ]; then
 222                 if which dumpfs.ldiskfs >/dev/null 2>&1; then
 223                         export DUMPE2FS=dumpfs.ldiskfs
 224                 else
 225                         export DUMPE2FS=dumpe2fs
 226                 fi
 227         fi
 228
 229         export E2FSCK=$E2FSCK
 230         if [ -z "$E2FSCK" ]; then
 231                 if which fsck.ldiskfs >/dev/null 2>&1; then
 232                         export E2FSCK=fsck.ldiskfs
 233                 else
 234                          export E2FSCK=e2fsck
 235                 fi
 236         fi
 237
 238         export RESIZE2FS=$RESIZE2FS
 239         if [ -z "$RESIZE2FS" ]; then
 240                 if which resizefs.ldiskfs >/dev/null 2>&1; then
 241                         export RESIZE2FS=resizefs.ldiskfs
 242                 else
 243                         export RESIZE2FS=resize2fs
 244                 fi
 245         fi
 246
 247         export LFSCK_ALWAYS=${LFSCK_ALWAYS:-"no"} # check fs after test suite
 248         export FSCK_MAX_ERR=4   # File system errors left uncorrected
 249
 250         export ZFS=${ZFS:-zfs}
 251         export ZPOOL=${ZPOOL:-zpool}
 252         export ZDB=${ZDB:-zdb}
 253         export PARTPROBE=${PARTPROBE:-partprobe}
 254
 255         #[ -d /r ] && export ROOT=${ROOT:-/r}
 256         export TMP=${TMP:-$ROOT/tmp}
 257         export TESTSUITELOG=${TMP}/${TESTSUITE}.log
 258         export LOGDIR=${LOGDIR:-${TMP}/test_logs/$(date +%s)}
 259         export TESTLOG_PREFIX=$LOGDIR/$TESTSUITE
 260
 261         export HOSTNAME=${HOSTNAME:-$(hostname -s)}
 262         if ! echo $PATH | grep -q $LUSTRE/utils; then
 263                 export PATH=$LUSTRE/utils:$PATH
 264         fi
 265         if ! echo $PATH | grep -q $LUSTRE/utils/gss; then
 266                 export PATH=$LUSTRE/utils/gss:$PATH
 267         fi
 268         if ! echo $PATH | grep -q $LUSTRE/tests; then
 269                 export PATH=$LUSTRE/tests:$PATH
 270         fi
 271         if ! echo $PATH | grep -q $LUSTRE/../lustre-iokit/sgpdd-survey; then
 272                 export PATH=$LUSTRE/../lustre-iokit/sgpdd-survey:$PATH
 273         fi
 274         export LST=${LST:-"$LUSTRE/../lnet/utils/lst"}
 275         [ ! -f "$LST" ] && export LST=$(which lst)
 276         export SGPDDSURVEY=${SGPDDSURVEY:-"$LUSTRE/../lustre-iokit/sgpdd-survey/sgpdd-survey")}
 277         [ ! -f "$SGPDDSURVEY" ] && export SGPDDSURVEY=$(which sgpdd-survey)
 278         export MCREATE=${MCREATE:-mcreate}
 279         export MULTIOP=${MULTIOP:-multiop}
 280         # Ubuntu, at least, has a truncate command in /usr/bin
 281         # so fully path our truncate command.
 282         export TRUNCATE=${TRUNCATE:-$LUSTRE/tests/truncate}
 283         export FSX=${FSX:-$LUSTRE/tests/fsx}
 284         export MDSRATE=${MDSRATE:-"$LUSTRE/tests/mpi/mdsrate"}
 285         [ ! -f "$MDSRATE" ] && export MDSRATE=$(which mdsrate 2> /dev/null)
 286         if ! echo $PATH | grep -q $LUSTRE/tests/racer; then
 287                 export PATH=$LUSTRE/tests/racer:$PATH:
 288         fi
 289         if ! echo $PATH | grep -q $LUSTRE/tests/mpi; then
 290                 export PATH=$LUSTRE/tests/mpi:$PATH
 291         fi
 292         export RSYNC_RSH=${RSYNC_RSH:-rsh}
 293
 294         export LCTL=${LCTL:-"$LUSTRE/utils/lctl"}
 295         [ ! -f "$LCTL" ] && export LCTL=$(which lctl)
 296         export LFS=${LFS:-"$LUSTRE/utils/lfs"}
 297         [ ! -f "$LFS" ] && export LFS=$(which lfs)
 298
 299         export PERM_CMD=${PERM_CMD:-"$LCTL conf_param"}
 300
 301         export L_GETIDENTITY=${L_GETIDENTITY:-"$LUSTRE/utils/l_getidentity"}
 302         if [ ! -f "$L_GETIDENTITY" ]; then
 303                 if `which l_getidentity > /dev/null 2>&1`; then
 304                         export L_GETIDENTITY=$(which l_getidentity)
 305                 else
 306                         export L_GETIDENTITY=NONE
 307                 fi
 308         fi
 309         export LL_DECODE_FILTER_FID=${LL_DECODE_FILTER_FID:-"$LUSTRE/utils/ll_decode_filter_fid"}
 310         [ ! -f "$LL_DECODE_FILTER_FID" ] && export LL_DECODE_FILTER_FID="ll_decode_filter_fid"
 311         export LL_DECODE_LINKEA=${LL_DECODE_LINKEA:-"$LUSTRE/utils/ll_decode_linkea"}
 312         [ ! -f "$LL_DECODE_LINKEA" ] && export LL_DECODE_LINKEA="ll_decode_linkea"
 313         export MKFS=${MKFS:-"$LUSTRE/utils/mkfs.lustre"}
 314         [ ! -f "$MKFS" ] && export MKFS="mkfs.lustre"
 315         export TUNEFS=${TUNEFS:-"$LUSTRE/utils/tunefs.lustre"}
 316         [ ! -f "$TUNEFS" ] && export TUNEFS="tunefs.lustre"
 317         export CHECKSTAT="${CHECKSTAT:-"checkstat -v"} "
 318         export LUSTRE_RMMOD=${LUSTRE_RMMOD:-$LUSTRE/scripts/lustre_rmmod}
 319         [ ! -f "$LUSTRE_RMMOD" ] &&
 320                 export LUSTRE_RMMOD=$(which lustre_rmmod 2> /dev/null)
 321         export LUSTRE_ROUTES_CONVERSION=${LUSTRE_ROUTES_CONVERSION:-$LUSTRE/scripts/lustre_routes_conversion}
 322         [ ! -f "$LUSTRE_ROUTES_CONVERSION" ] &&
 323                 export LUSTRE_ROUTES_CONVERSION=$(which lustre_routes_conversion 2> /dev/null)
 324         export LFS_MIGRATE=${LFS_MIGRATE:-$LUSTRE/scripts/lfs_migrate}
 325         [ ! -f "$LFS_MIGRATE" ] &&
 326                 export LFS_MIGRATE=$(which lfs_migrate 2> /dev/null)
 327         export LR_READER=${LR_READER:-"$LUSTRE/utils/lr_reader"}
 328         [ ! -f "$LR_READER" ] &&
 329                 export LR_READER=$(which lr_reader 2> /dev/null)
 330         [ -z "$LR_READER" ] && export LR_READER="/usr/sbin/lr_reader"
 331         export LSOM_SYNC=${LSOM_SYNC:-"$LUSTRE/utils/llsom_sync"}
 332         [ ! -f "$LSOM_SYNC" ] &&
 333                 export LSOM_SYNC=$(which llsom_sync 2> /dev/null)
 334         [ -z "$LSOM_SYNC" ] && export LSOM_SYNC="/usr/sbin/llsom_sync"
 335         export NAME=${NAME:-local}
 336         export LGSSD=${LGSSD:-"$LUSTRE/utils/gss/lgssd"}
 337         [ "$GSS_PIPEFS" = "true" ] && [ ! -f "$LGSSD" ] &&
 338                 export LGSSD=$(which lgssd)
 339         export LSVCGSSD=${LSVCGSSD:-"$LUSTRE/utils/gss/lsvcgssd"}
 340         [ ! -f "$LSVCGSSD" ] && export LSVCGSSD=$(which lsvcgssd 2> /dev/null)
 341         export KRB5DIR=${KRB5DIR:-"/usr/kerberos"}
 342         export DIR2
 343         export SAVE_PWD=${SAVE_PWD:-$LUSTRE/tests}
 344         export AT_MAX_PATH
 345         export LDEV=${LDEV:-"$LUSTRE/scripts/ldev"}
 346         [ ! -f "$LDEV" ] && export LDEV=$(which ldev 2> /dev/null)
 347
 348         export DMSETUP=${DMSETUP:-dmsetup}
 349         export DM_DEV_PATH=${DM_DEV_PATH:-/dev/mapper}
 350         export LOSETUP=${LOSETUP:-losetup}
 351
 352         if [ "$ACCEPTOR_PORT" ]; then
 353                 export PORT_OPT="--port $ACCEPTOR_PORT"
 354         fi
 355
 356         if $SHARED_KEY; then
 357                 $RPC_MODE || echo "Using GSS shared-key feature"
 358                 which lgss_sk > /dev/null 2>&1 ||
 359                         error_exit "built with lgss_sk disabled! SEC=$SEC"
 360                 GSS=true
 361                 GSS_SK=true
 362                 SEC=$SK_FLAVOR
 363         fi
 364
 365         case "x$SEC" in
 366                 xkrb5*)
 367                 $RPC_MODE || echo "Using GSS/krb5 ptlrpc security flavor"
 368                 which lgss_keyring > /dev/null 2>&1 ||
 369                         error_exit "built with gss disabled! SEC=$SEC"
 370                 GSS=true
 371                 GSS_KRB5=true
 372                 ;;
 373         esac
 374
 375         case "x$IDUP" in
 376                 xtrue)
 377                         IDENTITY_UPCALL=true
 378                         ;;
 379                 xfalse)
 380                         IDENTITY_UPCALL=false
 381                         ;;
 382         esac
 383
 384         export LOAD_MODULES_REMOTE=${LOAD_MODULES_REMOTE:-false}
 385
 386         # Paths on remote nodes, if different
 387         export RLUSTRE=${RLUSTRE:-$LUSTRE}
 388         export RPWD=${RPWD:-$PWD}
 389         export I_MOUNTED=${I_MOUNTED:-"no"}
 390         export AUSTER_CLEANUP=${AUSTER_CLEANUP:-false}
 391         if [ ! -f /lib/modules/$(uname -r)/kernel/fs/lustre/mdt.ko -a \
 392              ! -f /lib/modules/$(uname -r)/updates/kernel/fs/lustre/mdt.ko -a \
 393              ! -f /lib/modules/$(uname -r)/extra/kernel/fs/lustre/mdt.ko -a \
 394              ! -f $LUSTRE/mdt/mdt.ko ]; then
 395             export CLIENTMODSONLY=yes
 396         fi
 397
 398         export SHUTDOWN_ATTEMPTS=${SHUTDOWN_ATTEMPTS:-3}
 399         export OSD_TRACK_DECLARES_LBUG=${OSD_TRACK_DECLARES_LBUG:-"yes"}
 400
 401         # command line
 402
 403         while getopts "rvwf:" opt $*; do
 404                 case $opt in
 405                         f) CONFIG=$OPTARG;;
 406                         r) REFORMAT=yes;;
 407                         v) VERBOSE=true;;
 408                         w) WRITECONF=writeconf;;
 409                         \?) usage;;
 410                 esac
 411         done
 412
 413         shift $((OPTIND - 1))
 414         ONLY=${ONLY:-$*}
 415
 416         # print the durations of each test if "true"
 417         DDETAILS=${DDETAILS:-false}
 418         [ "$TESTSUITELOG" ] && rm -f $TESTSUITELOG || true
 419         if ! $RPC_MODE; then
 420                 rm -f $TMP/*active
 421         fi
 422
 423         export TF_FAIL=${TF_FAIL:-$TMP/tf.fail}
 424
 425         # Constants used in more than one test script
 426         export LOV_MAX_STRIPE_COUNT=2000
 427
 428         export MACHINEFILE=${MACHINEFILE:-$TMP/$(basename $0 .sh).machines}
 429         . ${CONFIG:=$LUSTRE/tests/cfg/$NAME.sh}
 430         get_lustre_env
 431
 432 }
 433
 434 check_cpt_number() {
 435         local facet=$1
 436         local ncpts
 437
 438         ncpts=$(do_facet $facet "lctl get_param -n " \
 439                 "cpu_partition_table 2>/dev/null| wc -l" || echo 1)
 440
 441         if [ $ncpts -eq 0 ]; then
 442                 echo "1"
 443         else
 444                 echo $ncpts
 445         fi
 446 }
 447
 448 # Return a numeric version code based on a version string.  The version
 449 # code is useful for comparison two version strings to see which is newer.
 450 version_code() {
 451         # split arguments like "1.8.6-wc3" into "1", "8", "6", "wc3"
 452         eval set -- $(tr "[:punct:]" " " <<< $*)
 453
 454         echo -n "$(((${1:-0} << 16) | (${2:-0} << 8) | ${3:-0}))"
 455 }
 456
 457 export LINUX_VERSION=$(uname -r | sed -e "s/\([0-9]*\.[0-9]*\.[0-9]*\).*/\1/")
 458 export LINUX_VERSION_CODE=$(version_code ${LINUX_VERSION//\./ })
 459
 460 # Report the Lustre build version string (e.g. 1.8.7.3 or 2.4.1).
 461 #
 462 # usage: lustre_build_version
 463 #
 464 # All Lustre versions support "lctl get_param" to report the version of the
 465 # code running in the kernel (what our tests are interested in), but it
 466 # doesn't work without modules loaded.  After 2.9.53 and in upstream kernels
 467 # the "version" parameter doesn't include "lustre: " at the beginning.
 468 # If that fails, call "lctl lustre_build_version" which prints either (or both)
 469 # the userspace and kernel build versions, but until 2.8.55 required root
 470 # access to get the Lustre kernel version.  If that also fails, fall back to
 471 # using "lctl --version", which is easy to parse and works without the kernel
 472 # modules, but was only added in 2.6.50 and only prints the lctl tool version,
 473 # not the module version, though they are usually the same.
 474 #
 475 # Various commands and their output format for different Lustre versions:
 476 # lctl get_param version:       2.9.55
 477 # lctl get_param version:       lustre: 2.8.53
 478 # lctl get_param version:       lustre: 2.6.52
 479 #                               kernel: patchless_client
 480 #                               build: v2_6_92_0-2.6.32-431.el6_lustre.x86_64
 481 # lctl lustre_build_version:    Lustre version: 2.8.53_27_gae67fc01
 482 # lctl lustre_build_version:    error: lustre_build_version: Permission denied
 483 #       (as non-root user)      lctl   version: v2_6_92_0-2.6.32-431.el6.x86_64
 484 # lctl lustre_build_version:    Lustre version: 2.5.3-2.6.32.26-175.fc12.x86_64
 485 #                               lctl   version: 2.5.3-2.6.32..26-175fc12.x86_64
 486 # lctl --version:               lctl 2.6.50
 487 #
 488 # output: prints version string to stdout in (up to 4) dotted-decimal values
 489 lustre_build_version() {
 490         local facet=${1:-client}
 491         local ver=$(do_facet $facet "$LCTL get_param -n version 2>/dev/null ||
 492                                 $LCTL lustre_build_version 2>/dev/null ||
 493                                 $LCTL --version 2>/dev/null | cut -d' ' -f2")
 494         local lver=$(egrep -i "lustre: |version: " <<<"$ver" | head -n 1)
 495         [ -n "$lver" ] && ver="$lver"
 496
 497         sed -e 's/[^:]*: //' -e 's/^v//' -e 's/[ -].*//' -e 's/_/./g' <<<$ver |
 498                 cut -d. -f1-4
 499 }
 500
 501 # Report the Lustre numeric build version code for the supplied facet.
 502 lustre_version_code() {
 503         version_code $(lustre_build_version $1)
 504 }
 505
 506 module_loaded () {
 507         /sbin/lsmod | grep -q "^\<$1\>"
 508 }
 509
 510 PRLFS=false
 511 lustre_insmod() {
 512         local module=$1
 513         shift
 514         local args="$@"
 515         local msg
 516         local rc=0
 517
 518         if ! $PRLFS; then
 519                 msg="$(insmod $module $args 2>&1)" && return 0 || rc=$?
 520         fi
 521
 522         # parallels can't load modules directly from prlfs, use /tmp instead
 523         if $PRLFS || [[ "$(stat -f -c%t $module)" == "7c7c6673" ]]; then
 524                 local target="$(mktemp)"
 525
 526                 cp "$module" "$target"
 527                 insmod $target $args
 528                 rc=$?
 529                 [[ $rc == 0 ]] && PRLFS=true
 530                 rm -f $target
 531         else
 532                 echo "$msg"
 533         fi
 534         return $rc
 535 }
 536
 537 # Load a module on the system where this is running.
 538 #
 539 # usage: load_module module_name [module arguments for insmod/modprobe]
 540 #
 541 # If module arguments are not given but MODOPTS_<MODULE> is set, then its value
 542 # will be used as the arguments.  Otherwise arguments will be obtained from
 543 # /etc/modprobe.conf, from /etc/modprobe.d/Lustre, or else none will be used.
 544 #
 545 load_module() {
 546         local module=$1 # '../libcfs/libcfs/libcfs', 'obdclass/obdclass', ...
 547         shift
 548         local ext=".ko"
 549         local base=$(basename $module $ext)
 550         local path
 551         local -A module_is_loaded_aa
 552         local optvar
 553         local mod
 554
 555         for mod in $(lsmod | awk '{ print $1; }'); do
 556                 module_is_loaded_aa[${mod//-/_}]=true
 557         done
 558
 559         module_is_loaded() {
 560                 ${module_is_loaded_aa[${1//-/_}]:-false}
 561         }
 562
 563         if module_is_loaded $base; then
 564                 return
 565         fi
 566
 567         if [[ -f $LUSTRE/$module$ext ]]; then
 568                 path=$LUSTRE/$module$ext
 569         elif [[ "$base" == lnet_selftest ]] &&
 570              [[ -f $LUSTRE/../lnet/selftest/$base$ext ]]; then
 571                 path=$LUSTRE/../lnet/selftest/$base$ext
 572         else
 573                 path=''
 574         fi
 575
 576         if [[ -n "$path" ]]; then
 577                 # Try to load any non-Lustre modules that $module depends on.
 578                 for mod in $(modinfo --field=depends $path | tr ',' ' '); do
 579                         if ! module_is_loaded $mod; then
 580                                 modprobe $mod
 581                         fi
 582                 done
 583         fi
 584
 585         # If no module arguments were passed then get them from
 586         # $MODOPTS_<MODULE>, otherwise from modprobe.conf.
 587         if [ $# -eq 0 ]; then
 588                 # $MODOPTS_<MODULE>; we could use associative arrays, but that's
 589                 # not in Bash until 4.x, so we resort to eval.
 590                 optvar="MODOPTS_$(basename $module | tr a-z A-Z)"
 591                 eval set -- \$$optvar
 592                 if [ $# -eq 0 -a -n "$MODPROBECONF" ]; then
 593                         # Nothing in $MODOPTS_<MODULE>; try modprobe.conf
 594                         local opt
 595                         opt=$(awk -v var="^options $base" '$0 ~ var \
 596                               {gsub("'"options $base"'",""); print}' \
 597                                 $MODPROBECONF)
 598                         set -- $(echo -n $opt)
 599
 600                         # Ensure we have accept=all for lnet
 601                         if [[ "$base" == lnet ]]; then
 602                                 # OK, this is a bit wordy...
 603                                 local arg accept_all_present=false
 604
 605                                 for arg in "$@"; do
 606                                         [[ "$arg" == accept=all ]] &&
 607                                                 accept_all_present=true
 608                                 done
 609
 610                                 $accept_all_present || set -- "$@" accept=all
 611                         fi
 612
 613                         export $optvar="$*"
 614                 fi
 615         fi
 616
 617         [ $# -gt 0 ] && echo "${module} options: '$*'"
 618
 619         # Note that insmod will ignore anything in modprobe.conf, which is why
 620         # we're passing options on the command-line. If $path does not exist
 621         # then we must be testing a "make install" or"rpm" installation. Also
 622         # note that failing to load ptlrpc_gss is not considered fatal.
 623         if [[ -n "$path" ]]; then
 624                 lustre_insmod $path "$@"
 625         elif [[ "$base" == ptlrpc_gss ]]; then
 626                 if ! modprobe $base "$@" 2>/dev/null; then
 627                         echo "gss/krb5 is not supported"
 628                 fi
 629         else
 630                 modprobe $base "$@"
 631         fi
 632 }
 633
 634 load_modules_local() {
 635         if [ -n "$MODPROBE" ]; then
 636                 # use modprobe
 637                 echo "Using modprobe to load modules"
 638                 return 0
 639         fi
 640
 641         # Create special udev test rules on every node
 642         if [ -f $LUSTRE/lustre/conf/99-lustre.rules ]; then {
 643                 sed -e 's|/usr/sbin/lctl|$LCTL|g' $LUSTRE/lustre/conf/99-lustre.rules > /etc/udev/rules.d/99-lustre-test.rules
 644         } else {
 645                 echo "SUBSYSTEM==\"lustre\", ACTION==\"change\", ENV{PARAM}==\"?*\", RUN+=\"$LCTL set_param '\$env{PARAM}=\$env{SETTING}'\"" > /etc/udev/rules.d/99-lustre-test.rules
 646         } fi
 647         udevadm control --reload-rules
 648         udevadm trigger
 649
 650         # For kmemleak-enabled kernels we need clear all past state
 651         # that obviously has nothing to do with this Lustre run
 652         # Disable automatic memory scanning to avoid perf hit.
 653         if [ -f /sys/kernel/debug/kmemleak ] ; then
 654                 echo scan=off > /sys/kernel/debug/kmemleak
 655                 echo scan > /sys/kernel/debug/kmemleak
 656                 echo clear > /sys/kernel/debug/kmemleak
 657         fi
 658
 659         echo Loading modules from $LUSTRE
 660
 661         local ncpus
 662
 663         if [ -f /sys/devices/system/cpu/online ]; then
 664                 ncpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/online) + 1))
 665                 echo "detected $ncpus online CPUs by sysfs"
 666         else
 667                 ncpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
 668                 local rc=$?
 669                 if [ $rc -eq 0 ]; then
 670                         echo "detected $ncpus online CPUs by getconf"
 671                 else
 672                         echo "Can't detect number of CPUs"
 673                         ncpus=1
 674                 fi
 675         fi
 676
 677         # if there is only one CPU core, libcfs can only create one partition
 678         # if there is more than 4 CPU cores, libcfs should create multiple CPU
 679         # partitions. So we just force libcfs to create 2 partitions for
 680         # system with 2 or 4 cores
 681         if [ $ncpus -le 4 ] && [ $ncpus -gt 1 ]; then
 682                 # force to enable multiple CPU partitions
 683                 echo "Force libcfs to create 2 CPU partitions"
 684                 MODOPTS_LIBCFS="cpu_npartitions=2 $MODOPTS_LIBCFS"
 685         else
 686                 echo "libcfs will create CPU partition based on online CPUs"
 687         fi
 688
 689         load_module ../libcfs/libcfs/libcfs
 690         # Prevent local MODOPTS_LIBCFS being passed as part of environment
 691         # variable to remote nodes
 692         unset MODOPTS_LIBCFS
 693
 694         set_default_debug
 695         load_module ../lnet/lnet/lnet
 696
 697         LNDPATH=${LNDPATH:-"../lnet/klnds"}
 698         if [ -z "$LNETLND" ]; then
 699                 case $NETTYPE in
 700                 o2ib*)  LNETLND="o2iblnd/ko2iblnd" ;;
 701                 tcp*)   LNETLND="socklnd/ksocklnd" ;;
 702                 *)      local lnd="${NETTYPE%%[0-9]}lnd"
 703                         [ -f "$LNDPATH/$lnd/k$lnd.ko" ] &&
 704                                 LNETLND="$lnd/k$lnd" ||
 705                                 LNETLND="socklnd/ksocklnd"
 706                 esac
 707         fi
 708         load_module ../lnet/klnds/$LNETLND
 709         load_module obdclass/obdclass
 710         load_module ptlrpc/ptlrpc
 711         load_module ptlrpc/gss/ptlrpc_gss
 712         load_module fld/fld
 713         load_module fid/fid
 714         load_module lmv/lmv
 715         load_module osc/osc
 716         load_module mdc/mdc
 717         load_module lov/lov
 718         load_module mgc/mgc
 719         load_module obdecho/obdecho
 720         if ! client_only; then
 721                 load_module lfsck/lfsck
 722                 [ "$LQUOTA" != "no" ] &&
 723                         load_module quota/lquota $LQUOTAOPTS
 724                 if [[ $(node_fstypes $HOSTNAME) == *zfs* ]]; then
 725                         load_module osd-zfs/osd_zfs
 726                 elif [[ $(node_fstypes $HOSTNAME) == *ldiskfs* ]]; then
 727                         load_module ../ldiskfs/ldiskfs
 728                         load_module osd-ldiskfs/osd_ldiskfs
 729                 fi
 730                 load_module mgs/mgs
 731                 load_module mdd/mdd
 732                 load_module mdt/mdt
 733                 load_module ost/ost
 734                 load_module lod/lod
 735                 load_module osp/osp
 736                 load_module ofd/ofd
 737                 load_module osp/osp
 738         fi
 739
 740         load_module llite/lustre
 741         [ -d /r ] && OGDB=${OGDB:-"/r/tmp"}
 742         OGDB=${OGDB:-$TMP}
 743         rm -f $OGDB/ogdb-$HOSTNAME
 744         $LCTL modules > $OGDB/ogdb-$HOSTNAME
 745
 746         # 'mount' doesn't look in $PATH, just sbin
 747         local mount_lustre=$LUSTRE/utils/mount.lustre
 748         if [ -f $mount_lustre ]; then
 749                 local sbin_mount=$(readlink -f /sbin)/mount.lustre
 750                 if grep -qw "$sbin_mount" /proc/mounts; then
 751                         cmp -s $mount_lustre $sbin_mount || umount $sbin_mount
 752                 fi
 753                 if ! grep -qw "$sbin_mount" /proc/mounts; then
 754                         [ ! -f "$sbin_mount" ] && touch "$sbin_mount"
 755                         if [ ! -s "$sbin_mount" -a -w "$sbin_mount" ]; then
 756                                 cat <<- EOF > "$sbin_mount"
 757                                 #!/bin/sh
 758                                 #STUB MARK
 759                                 echo "This $sbin_mount just a mountpoint." 1>&2
 760                                 echo "It is never supposed to be run." 1>&2
 761                                 logger -p emerg -- "using stub $sbin_mount $@"
 762                                 exit 1
 763                                 EOF
 764                                 chmod a+x $sbin_mount
 765                         fi
 766                         mount --bind $mount_lustre $sbin_mount ||
 767                                 error "can't bind $mount_lustre to $sbin_mount"
 768                 fi
 769         fi
 770 }
 771
 772 load_modules () {
 773         load_modules_local
 774         # bug 19124
 775         # load modules on remote nodes optionally
 776         # lustre-tests have to be installed on these nodes
 777         if $LOAD_MODULES_REMOTE; then
 778                 local list=$(comma_list $(remote_nodes_list))
 779                 if [ -n "$list" ]; then
 780                         echo "loading modules on: '$list'"
 781                         do_rpc_nodes "$list" load_modules_local
 782                 fi
 783         fi
 784 }
 785
 786 check_mem_leak () {
 787     LEAK_LUSTRE=$(dmesg | tail -n 30 | grep "obd_memory.*leaked" || true)
 788     LEAK_PORTALS=$(dmesg | tail -n 20 | grep "Portals memory leaked" || true)
 789     if [ "$LEAK_LUSTRE" -o "$LEAK_PORTALS" ]; then
 790         echo "$LEAK_LUSTRE" 1>&2
 791         echo "$LEAK_PORTALS" 1>&2
 792         mv $TMP/debug $TMP/debug-leak.`date +%s` || true
 793         echo "Memory leaks detected"
 794         [ -n "$IGNORE_LEAK" ] && { echo "ignoring leaks" && return 0; } || true
 795         return 1
 796     fi
 797 }
 798
 799 unload_modules() {
 800         wait_exit_ST client # bug 12845
 801
 802         $LUSTRE_RMMOD ldiskfs || return 2
 803
 804         [ -f /etc/udev/rules.d/99-lustre-test.rules ] &&
 805                 rm /etc/udev/rules.d/99-lustre-test.rules
 806         udevadm control --reload-rules
 807         udevadm trigger
 808
 809         if $LOAD_MODULES_REMOTE; then
 810                 local list=$(comma_list $(remote_nodes_list))
 811                 if [ -n "$list" ]; then
 812                         echo "unloading modules on: '$list'"
 813                         do_rpc_nodes "$list" $LUSTRE_RMMOD ldiskfs
 814                         do_rpc_nodes "$list" check_mem_leak
 815                         do_rpc_nodes "$list" "rm -f /etc/udev/rules.d/99-lustre-test.rules"
 816                         do_rpc_nodes "$list" "udevadm control --reload-rules"
 817                         do_rpc_nodes "$list" "udevadm trigger"
 818                 fi
 819         fi
 820
 821         local sbin_mount=$(readlink -f /sbin)/mount.lustre
 822         if grep -qe "$sbin_mount " /proc/mounts; then
 823                 umount $sbin_mount || true
 824                 [ -s $sbin_mount ] && ! grep -q "STUB MARK" $sbin_mount ||
 825                         rm -f $sbin_mount
 826         fi
 827
 828         check_mem_leak || return 254
 829
 830         echo "modules unloaded."
 831         return 0
 832 }
 833
 834 fs_log_size() {
 835         local facet=${1:-$SINGLEMDS}
 836         local size=0
 837
 838         case $(facet_fstype $facet) in
 839                 ldiskfs) size=50;; # largest seen is 44, leave some headroom
 840                 # grant_block_size is in bytes, allow at least 2x max blocksize
 841                 zfs)     size=$(lctl get_param osc.$FSNAME*.import |
 842                                 awk '/grant_block_size:/ {print $2/512; exit;}')
 843                           ;;
 844         esac
 845
 846         echo -n $((size * MDSCOUNT))
 847 }
 848
 849 fs_inode_ksize() {
 850         local facet=${1:-$SINGLEMDS}
 851         local fstype=$(facet_fstype $facet)
 852         local size=0
 853         case $fstype in
 854                 ldiskfs) size=4;;  # ~4KB per inode
 855                 zfs)     size=11;; # 10 to 11KB per inode
 856         esac
 857
 858         echo -n $size
 859 }
 860
 861 check_gss_daemon_nodes() {
 862     local list=$1
 863     dname=$2
 864
 865     do_nodesv $list "num=\\\$(ps -o cmd -C $dname | grep $dname | wc -l);
 866 if [ \\\"\\\$num\\\" -ne 1 ]; then
 867     echo \\\$num instance of $dname;
 868     exit 1;
 869 fi; "
 870 }
 871
 872 check_gss_daemon_facet() {
 873     facet=$1
 874     dname=$2
 875
 876     num=`do_facet $facet ps -o cmd -C $dname | grep $dname | wc -l`
 877     if [ $num -ne 1 ]; then
 878         echo "$num instance of $dname on $facet"
 879         return 1
 880     fi
 881     return 0
 882 }
 883
 884 send_sigint() {
 885     local list=$1
 886     shift
 887     echo Stopping $@ on $list
 888     do_nodes $list "killall -2 $@ 2>/dev/null || true"
 889 }
 890
 891 # start gss daemons on all nodes, or "daemon" on "nodes" if set
 892 start_gss_daemons() {
 893         local nodes=$1
 894         local daemon=$2
 895
 896         if [ "$nodes" ] && [ "$daemon" ] ; then
 897                 echo "Starting gss daemon on nodes: $nodes"
 898                 do_nodes $nodes "$daemon" || return 8
 899                 return 0
 900         fi
 901
 902         nodes=$(comma_list $(mdts_nodes))
 903         echo "Starting gss daemon on mds: $nodes"
 904         if $GSS_SK; then
 905                 # Start all versions, in case of switching
 906                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 1
 907         else
 908                 do_nodes $nodes "$LSVCGSSD -v" || return 1
 909         fi
 910         if $GSS_PIPEFS; then
 911                 do_nodes $nodes "$LGSSD -v" || return 2
 912         fi
 913
 914         nodes=$(comma_list $(osts_nodes))
 915         echo "Starting gss daemon on ost: $nodes"
 916         if $GSS_SK; then
 917                 # Start all versions, in case of switching
 918                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 3
 919         else
 920                 do_nodes $nodes "$LSVCGSSD -v" || return 3
 921         fi
 922         # starting on clients
 923
 924         local clients=${CLIENTS:-$HOSTNAME}
 925         if $GSS_PIPEFS; then
 926                 echo "Starting $LGSSD on clients $clients "
 927                 do_nodes $clients  "$LGSSD -v" || return 4
 928         fi
 929
 930         # wait daemons entering "stable" status
 931         sleep 5
 932
 933         #
 934         # check daemons are running
 935         #
 936         nodes=$(comma_list $(mdts_nodes) $(osts_nodes))
 937         check_gss_daemon_nodes $nodes lsvcgssd || return 5
 938         if $GSS_PIPEFS; then
 939                 nodes=$(comma_list $(mdts_nodes))
 940                 check_gss_daemon_nodes $nodes lgssd || return 6
 941         fi
 942         if $GSS_PIPEFS; then
 943                 check_gss_daemon_nodes $clients lgssd || return 7
 944         fi
 945 }
 946
 947 stop_gss_daemons() {
 948         local nodes=$(comma_list $(mdts_nodes))
 949
 950         send_sigint $nodes lsvcgssd lgssd
 951
 952         nodes=$(comma_list $(osts_nodes))
 953         send_sigint $nodes lsvcgssd
 954
 955         nodes=${CLIENTS:-$HOSTNAME}
 956         send_sigint $nodes lgssd
 957 }
 958
 959 add_sk_mntflag() {
 960         # Add mount flags for shared key
 961         local mt_opts=$@
 962         if grep -q skpath <<< "$mt_opts" ; then
 963                 mt_opts=$(echo $mt_opts |
 964                         sed -e "s#skpath=[^ ,]*#skpath=$SK_PATH#")
 965         else
 966                 if [ -z "$mt_opts" ]; then
 967                         mt_opts="-o skpath=$SK_PATH"
 968                 else
 969                         mt_opts="$mt_opts,skpath=$SK_PATH"
 970                 fi
 971         fi
 972         echo -n $mt_opts
 973 }
 974
 975 from_build_tree() {
 976         local from_tree
 977
 978         case $LUSTRE in
 979         /usr/lib/lustre/* | /usr/lib64/lustre/* | /usr/lib/lustre | \
 980         /usr/lib64/lustre )
 981                 from_tree=false
 982                 ;;
 983         *)
 984                 from_tree=true
 985                 ;;
 986         esac
 987
 988         [ $from_tree = true ]
 989 }
 990
 991 init_gss() {
 992         if $SHARED_KEY; then
 993                 GSS=true
 994                 GSS_SK=true
 995         fi
 996
 997         if ! $GSS; then
 998                 return
 999         fi
1000
1001         if ! module_loaded ptlrpc_gss; then
1002                 load_module ptlrpc/gss/ptlrpc_gss
1003                 module_loaded ptlrpc_gss ||
1004                         error_exit "init_gss: GSS=$GSS, but gss/krb5 missing"
1005         fi
1006
1007         if $GSS_KRB5 || $GSS_SK; then
1008                 start_gss_daemons || error_exit "start gss daemon failed! rc=$?"
1009         fi
1010
1011         if $GSS_SK && $SK_NO_KEY; then
1012                 local numclients=${1:-$CLIENTCOUNT}
1013                 local clients=${CLIENTS:-$HOSTNAME}
1014
1015                 # security ctx config for keyring
1016                 SK_NO_KEY=false
1017                 local lgssc_conf_file="/etc/request-key.d/lgssc.conf"
1018
1019                 if from_build_tree; then
1020                         mkdir -p $SK_OM_PATH
1021                         if grep -q request-key /proc/mounts > /dev/null; then
1022                                 echo "SSK: Request key already mounted."
1023                         else
1024                                 mount -o bind $SK_OM_PATH /etc/request-key.d/
1025                         fi
1026                         local lgssc_conf_line='create lgssc * * '
1027                         lgssc_conf_line+=$(which lgss_keyring)
1028                         lgssc_conf_line+=' %o %k %t %d %c %u %g %T %P %S'
1029                         echo "$lgssc_conf_line" > $lgssc_conf_file
1030                 fi
1031
1032                 [ -e $lgssc_conf_file ] ||
1033                         error_exit "Could not find key options in $lgssc_conf_file"
1034                 echo "$lgssc_conf_file content is:"
1035                 cat $lgssc_conf_file
1036
1037                 if ! local_mode; then
1038                         if from_build_tree; then
1039                                 do_nodes $(comma_list $(all_nodes)) "mkdir -p \
1040                                         $SK_OM_PATH"
1041                                 do_nodes $(comma_list $(all_nodes)) "mount \
1042                                         -o bind $SK_OM_PATH \
1043                                         /etc/request-key.d/"
1044                                 do_nodes $(comma_list $(all_nodes)) "rsync \
1045                                         -aqv $HOSTNAME:$lgssc_conf_file \
1046                                         $lgssc_conf_file >/dev/null 2>&1"
1047                         else
1048                                 do_nodes $(comma_list $(all_nodes)) \
1049                                         "echo $lgssc_conf_file: ; \
1050                                         cat $lgssc_conf_file"
1051                         fi
1052                 fi
1053
1054                 # create shared key on all nodes
1055                 mkdir -p $SK_PATH/nodemap
1056                 rm -f $SK_PATH/$FSNAME.key $SK_PATH/nodemap/c*.key \
1057                         $SK_PATH/$FSNAME-*.key
1058                 # for nodemap testing each client may need own key,
1059                 # and S2S now requires keys as well, both for "client"
1060                 # and for "server"
1061                 if $SK_S2S; then
1062                         lgss_sk -t server -f$FSNAME -n $SK_S2SNMCLI \
1063                                 -w $SK_PATH/$FSNAME-nmclient.key \
1064                                 -d /dev/urandom >/dev/null 2>&1
1065                         lgss_sk -t mgs,server -f$FSNAME -n $SK_S2SNM \
1066                                 -w $SK_PATH/$FSNAME-s2s-server.key \
1067                                 -d /dev/urandom >/dev/null 2>&1
1068                 fi
1069                 # basic key create
1070                 lgss_sk -t server -f$FSNAME -w $SK_PATH/$FSNAME.key \
1071                         -d /dev/urandom >/dev/null 2>&1
1072                 # per-nodemap keys
1073                 for i in $(seq 0 $((numclients - 1))); do
1074                         lgss_sk -t server -f$FSNAME -n c$i \
1075                                 -w $SK_PATH/nodemap/c$i.key -d /dev/urandom \
1076                                 >/dev/null 2>&1
1077                 done
1078                 # Distribute keys
1079                 if ! local_mode; then
1080                         for lnode in $(all_nodes); do
1081                                 scp -r $SK_PATH ${lnode}:$(dirname $SK_PATH)/
1082                         done
1083                 fi
1084                 # Set client keys to client type to generate prime P
1085                 if local_mode; then
1086                         do_nodes $(all_nodes) "lgss_sk -t client,server -m \
1087                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1088                 else
1089                         do_nodes $clients "lgss_sk -t client -m \
1090                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1091                         do_nodes $clients "find $SK_PATH/nodemap -name \*.key | \
1092                                 xargs -IX lgss_sk -t client -m X >/dev/null 2>&1"
1093                 fi
1094                 # This is required for servers as well, if S2S in use
1095                 if $SK_S2S; then
1096                         do_nodes $(comma_list $(mdts_nodes)) \
1097                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1098                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1099                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1100                                 >/dev/null 2>&1"
1101                         do_nodes $(comma_list $(osts_nodes)) \
1102                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1103                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1104                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1105                                 >/dev/null 2>&1"
1106                         do_nodes $clients "lgss_sk -t client \
1107                                 -m $SK_PATH/$FSNAME-nmclient.key \
1108                                  >/dev/null 2>&1"
1109                 fi
1110         fi
1111         if $GSS_SK; then
1112                 # mount options for servers and clients
1113                 MGS_MOUNT_OPTS=$(add_sk_mntflag $MGS_MOUNT_OPTS)
1114                 MDS_MOUNT_OPTS=$(add_sk_mntflag $MDS_MOUNT_OPTS)
1115                 OST_MOUNT_OPTS=$(add_sk_mntflag $OST_MOUNT_OPTS)
1116                 MOUNT_OPTS=$(add_sk_mntflag $MOUNT_OPTS)
1117                 SEC=$SK_FLAVOR
1118                 if [ -z "$LGSS_KEYRING_DEBUG" ]; then
1119                         LGSS_KEYRING_DEBUG=4
1120                 fi
1121         fi
1122
1123         if [ -n "$LGSS_KEYRING_DEBUG" ] && \
1124                ( local_mode || from_build_tree ); then
1125                 lctl set_param -n \
1126                      sptlrpc.gss.lgss_keyring.debug_level=$LGSS_KEYRING_DEBUG
1127         elif [ -n "$LGSS_KEYRING_DEBUG" ]; then
1128                 do_nodes $(comma_list $(all_nodes)) "modprobe ptlrpc_gss && \
1129                 lctl set_param -n \
1130                    sptlrpc.gss.lgss_keyring.debug_level=$LGSS_KEYRING_DEBUG"
1131         fi
1132 }
1133
1134 cleanup_gss() {
1135         if $GSS; then
1136                 stop_gss_daemons
1137                 # maybe cleanup credential cache?
1138         fi
1139 }
1140
1141 cleanup_sk() {
1142         if $GSS_SK; then
1143                 if $SK_S2S; then
1144                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNM"
1145                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNMCLI"
1146                         $RPC_MODE || echo "Sleeping for 10 sec for Nodemap.."
1147                         sleep 10
1148                 fi
1149                 stop_gss_daemons
1150                 $RPC_MODE || echo "Cleaning up Shared Key.."
1151                 do_nodes $(comma_list $(all_nodes)) "rm -f \
1152                         $SK_PATH/$FSNAME*.key $SK_PATH/nodemap/$FSNAME*.key"
1153                 do_nodes $(comma_list $(all_nodes)) "keyctl show | \
1154                   awk '/lustre/ { print \\\$1 }' | xargs -IX keyctl unlink X"
1155                 if from_build_tree; then
1156                         # Remove the mount and clean up the files we added to
1157                         # SK_PATH
1158                         do_nodes $(comma_list $(all_nodes)) "while grep -q \
1159                                 request-key.d /proc/mounts; do umount \
1160                                 /etc/request-key.d/; done"
1161                         do_nodes $(comma_list $(all_nodes)) "rm -f \
1162                                 $SK_OM_PATH/lgssc.conf"
1163                         do_nodes $(comma_list $(all_nodes)) "rmdir $SK_OM_PATH"
1164                 fi
1165                 SK_NO_KEY=true
1166         fi
1167 }
1168
1169 facet_svc() {
1170         local facet=$1
1171         local var=${facet}_svc
1172
1173         echo -n ${!var}
1174 }
1175
1176 facet_type() {
1177         local facet=$1
1178
1179         echo -n $facet | sed -e 's/^fs[0-9]\+//' -e 's/[0-9_]\+//' |
1180                 tr '[:lower:]' '[:upper:]'
1181 }
1182
1183 facet_number() {
1184         local facet=$1
1185
1186         if [ $facet == mgs ] || [ $facet == client ]; then
1187                 return 1
1188         fi
1189
1190         echo -n $facet | sed -e 's/^fs[0-9]\+//' | sed -e 's/^[a-z]\+//'
1191 }
1192
1193 facet_fstype() {
1194         local facet=$1
1195         local var
1196
1197         var=${facet}_FSTYPE
1198         if [ -n "${!var}" ]; then
1199                 echo -n ${!var}
1200                 return
1201         fi
1202
1203         var=$(facet_type $facet)FSTYPE
1204         if [ -n "${!var}" ]; then
1205                 echo -n ${!var}
1206                 return
1207         fi
1208
1209         if [ -n "$FSTYPE" ]; then
1210                 echo -n $FSTYPE
1211                 return
1212         fi
1213
1214         if [[ $facet == mgs ]] && combined_mgs_mds; then
1215                 facet_fstype mds1
1216                 return
1217         fi
1218
1219         return 1
1220 }
1221
1222 node_fstypes() {
1223         local node=$1
1224         local fstypes
1225         local fstype
1226         local facets=$(get_facets)
1227         local facet
1228
1229         for facet in ${facets//,/ }; do
1230                 if [ $node == $(facet_host $facet) ] ||
1231                    [ $node == "$(facet_failover_host $facet)" ]; then
1232                         fstype=$(facet_fstype $facet)
1233                         if [[ $fstypes != *$fstype* ]]; then
1234                                 fstypes+="${fstypes:+,}$fstype"
1235                         fi
1236                 fi
1237         done
1238         echo -n $fstypes
1239 }
1240
1241 facet_index() {
1242         local facet=$1
1243         local num=$(facet_number $facet)
1244         local index
1245
1246         if [[ $(facet_type $facet) = OST ]]; then
1247                 index=OSTINDEX${num}
1248                 if [[ -n "${!index}" ]]; then
1249                         echo -n ${!index}
1250                         return
1251                 fi
1252
1253                 index=${OST_INDICES[num - 1]}
1254         fi
1255
1256         [[ -n "$index" ]] || index=$((num - 1))
1257         echo -n $index
1258 }
1259
1260 devicelabel() {
1261         local facet=$1
1262         local dev=$2
1263         local label
1264         local fstype=$(facet_fstype $facet)
1265
1266         case $fstype in
1267         ldiskfs)
1268                 label=$(do_facet ${facet} "$E2LABEL ${dev} 2>/dev/null");;
1269         zfs)
1270                 label=$(do_facet ${facet} "$ZFS get -H -o value lustre:svname \
1271                                            ${dev} 2>/dev/null");;
1272         *)
1273                 error "unknown fstype!";;
1274         esac
1275
1276         echo -n $label
1277 }
1278
1279 mdsdevlabel() {
1280         local num=$1
1281         local device=$(mdsdevname $num)
1282         local label=$(devicelabel mds$num ${device} | grep -v "CMD: ")
1283         echo -n $label
1284 }
1285
1286 ostdevlabel() {
1287         local num=$1
1288         local device=$(ostdevname $num)
1289         local label=$(devicelabel ost$num ${device} | grep -v "CMD: ")
1290         echo -n $label
1291 }
1292
1293 #
1294 # Get the device of a facet.
1295 #
1296 facet_device() {
1297         local facet=$1
1298         local device
1299
1300         case $facet in
1301                 mgs) device=$(mgsdevname) ;;
1302                 mds*) device=$(mdsdevname $(facet_number $facet)) ;;
1303                 ost*) device=$(ostdevname $(facet_number $facet)) ;;
1304                 fs2mds) device=$(mdsdevname 1_2) ;;
1305                 fs2ost) device=$(ostdevname 1_2) ;;
1306                 fs3ost) device=$(ostdevname 2_2) ;;
1307                 *) ;;
1308         esac
1309
1310         echo -n $device
1311 }
1312
1313 #
1314 # Get the virtual device of a facet.
1315 #
1316 facet_vdevice() {
1317         local facet=$1
1318         local device
1319
1320         case $facet in
1321                 mgs) device=$(mgsvdevname) ;;
1322                 mds*) device=$(mdsvdevname $(facet_number $facet)) ;;
1323                 ost*) device=$(ostvdevname $(facet_number $facet)) ;;
1324                 fs2mds) device=$(mdsvdevname 1_2) ;;
1325                 fs2ost) device=$(ostvdevname 1_2) ;;
1326                 fs3ost) device=$(ostvdevname 2_2) ;;
1327                 *) ;;
1328         esac
1329
1330         echo -n $device
1331 }
1332
1333 running_in_vm() {
1334         local virt=$(virt-what 2> /dev/null)
1335
1336         [ $? -eq 0 ] && [ -n "$virt" ] && { echo $virt; return; }
1337
1338         virt=$(dmidecode -s system-product-name | awk '{print $1}')
1339
1340         case $virt in
1341                 VMware|KVM|VirtualBox|Parallels|Bochs)
1342                         echo $virt | tr '[A-Z]' '[a-z]' ;;
1343                 *) ;;
1344         esac
1345 }
1346
1347 #
1348 # Re-read the partition table on failover partner host.
1349 # After a ZFS storage pool is created on a shared device, the partition table
1350 # on the device may change. However, the operating system on the failover
1351 # host may not notice the change automatically. Without the up-to-date partition
1352 # block devices, 'zpool import ..' cannot find the labels, whose positions are
1353 # relative to partition rather than disk beginnings.
1354 #
1355 # This function performs partprobe on the failover host to make it re-read the
1356 # partition table.
1357 #
1358 refresh_partition_table() {
1359         local facet=$1
1360         local device=$2
1361         local host
1362
1363         host=$(facet_passive_host $facet)
1364         if [[ -n "$host" ]]; then
1365                 do_node $host "$PARTPROBE $device"
1366         fi
1367 }
1368
1369 #
1370 # Get ZFS storage pool name.
1371 #
1372 zpool_name() {
1373         local facet=$1
1374         local device
1375         local poolname
1376
1377         device=$(facet_device $facet)
1378         # poolname is string before "/"
1379         poolname="${device%%/*}"
1380
1381         echo -n $poolname
1382 }
1383
1384 #
1385 #
1386 # Get ZFS local fsname.
1387 #
1388 zfs_local_fsname() {
1389         local facet=$1
1390         local lfsname=$(basename $(facet_device $facet))
1391
1392         echo -n $lfsname
1393 }
1394
1395 #
1396 # Create ZFS storage pool.
1397 #
1398 create_zpool() {
1399         local facet=$1
1400         local poolname=$2
1401         local vdev=$3
1402         shift 3
1403         local opts=${@:-"-o cachefile=none"}
1404
1405         do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1406                 $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1407                 $ZPOOL create -f $opts $poolname $vdev"
1408 }
1409
1410 #
1411 # Create ZFS file system.
1412 #
1413 create_zfs() {
1414         local facet=$1
1415         local dataset=$2
1416         shift 2
1417         local opts=${@:-"-o mountpoint=legacy"}
1418
1419         do_facet $facet "$ZFS list -H $dataset >/dev/null 2>&1 ||
1420                 $ZFS create $opts $dataset"
1421 }
1422
1423 #
1424 # Export ZFS storage pool.
1425 # Before exporting the pool, all datasets within the pool should be unmounted.
1426 #
1427 export_zpool() {
1428         local facet=$1
1429         shift
1430         local opts="$@"
1431         local poolname
1432
1433         poolname=$(zpool_name $facet)
1434
1435         if [[ -n "$poolname" ]]; then
1436                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1437                         grep -q ^$poolname/ /proc/mounts ||
1438                         $ZPOOL export $opts $poolname"
1439         fi
1440 }
1441
1442 #
1443 # Destroy ZFS storage pool.
1444 # Destroy the given pool and free up any devices for other use. This command
1445 # tries to unmount any active datasets before destroying the pool.
1446 # -f    Force any active datasets contained within the pool to be unmounted.
1447 #
1448 destroy_zpool() {
1449         local facet=$1
1450         local poolname=${2:-$(zpool_name $facet)}
1451
1452         if [[ -n "$poolname" ]]; then
1453                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1454                         $ZPOOL destroy -f $poolname"
1455         fi
1456 }
1457
1458 #
1459 # Import ZFS storage pool.
1460 # Force importing, even if the pool appears to be potentially active.
1461 #
1462 import_zpool() {
1463         local facet=$1
1464         shift
1465         local opts=${@:-"-o cachefile=none -o failmode=panic"}
1466         local poolname
1467
1468         poolname=$(zpool_name $facet)
1469
1470         if [[ -n "$poolname" ]]; then
1471                 opts+=" -d $(dirname $(facet_vdevice $facet))"
1472                 do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1473                         $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1474                         $ZPOOL import -f $opts $poolname"
1475         fi
1476 }
1477
1478 #
1479 # Reimport ZFS storage pool with new name
1480 #
1481 reimport_zpool() {
1482         local facet=$1
1483         local newpool=$2
1484         local opts="-o cachefile=none"
1485         local poolname=$(zpool_name $facet)
1486
1487         opts+=" -d $(dirname $(facet_vdevice $facet))"
1488         do_facet $facet "$ZPOOL export $poolname;
1489                          $ZPOOL import $opts $poolname $newpool"
1490 }
1491
1492 #
1493 # Set the "cachefile=none" property on ZFS storage pool so that the pool
1494 # is not automatically imported on system startup.
1495 #
1496 # In a failover environment, this will provide resource level fencing which
1497 # will ensure that the same ZFS storage pool will not be imported concurrently
1498 # on different nodes.
1499 #
1500 disable_zpool_cache() {
1501         local facet=$1
1502         local poolname
1503
1504         poolname=$(zpool_name $facet)
1505
1506         if [[ -n "$poolname" ]]; then
1507                 do_facet $facet "$ZPOOL set cachefile=none $poolname"
1508         fi
1509 }
1510
1511 #
1512 # This and set_osd_param() shall be used to access OSD parameters
1513 # once existed under "obdfilter":
1514 #
1515 #   mntdev
1516 #   stats
1517 #   read_cache_enable
1518 #   writethrough_cache_enable
1519 #
1520 get_osd_param() {
1521         local nodes=$1
1522         local device=${2:-$FSNAME-OST*}
1523         local name=$3
1524
1525         do_nodes $nodes "$LCTL get_param -n obdfilter.$device.$name \
1526                 osd-*.$device.$name 2>&1" | grep -v 'error:'
1527 }
1528
1529 set_osd_param() {
1530         local nodes=$1
1531         local device=${2:-$FSNAME-OST*}
1532         local name=$3
1533         local value=$4
1534
1535         do_nodes $nodes "$LCTL set_param -n obdfilter.$device.$name=$value \
1536                 osd-*.$device.$name=$value 2>&1" | grep -v 'error:'
1537 }
1538
1539 set_debug_size () {
1540     local dz=${1:-$DEBUG_SIZE}
1541
1542     if [ -f /sys/devices/system/cpu/possible ]; then
1543         local cpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/possible)+1))
1544     else
1545         local cpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
1546     fi
1547
1548     # bug 19944, adjust size to be -gt num_possible_cpus()
1549     # promise 2MB for every cpu at least
1550     if [ -n "$cpus" ] && [ $((cpus * 2)) -gt $dz ]; then
1551         dz=$((cpus * 2))
1552     fi
1553     lctl set_param debug_mb=$dz
1554 }
1555
1556 set_default_debug () {
1557         local debug=${1:-"$PTLDEBUG"}
1558         local subsys=${2:-"$SUBSYSTEM"}
1559         local debug_size=${3:-$DEBUG_SIZE}
1560
1561         [ -n "$debug" ] && lctl set_param debug="$debug" >/dev/null
1562         [ -n "$subsys" ] && lctl set_param subsystem_debug="${subsys# }" >/dev/null
1563
1564         [ -n "$debug_size" ] && set_debug_size $debug_size > /dev/null
1565 }
1566
1567 set_default_debug_nodes () {
1568         local nodes="$1"
1569         local debug="${2:-"$PTLDEBUG"}"
1570         local subsys="${3:-"$SUBSYSTEM"}"
1571         local debug_size="${4:-$DEBUG_SIZE}"
1572
1573         if [[ ,$nodes, = *,$HOSTNAME,* ]]; then
1574                 nodes=$(exclude_items_from_list "$nodes" "$HOSTNAME")
1575                 set_default_debug
1576         fi
1577
1578         [[ -z "$nodes" ]] ||
1579                 do_rpc_nodes "$nodes" set_default_debug \
1580                         \\\"$debug\\\" \\\"$subsys\\\" $debug_size || true
1581 }
1582
1583 set_default_debug_facet () {
1584         local facet=$1
1585         local debug="${2:-"$PTLDEBUG"}"
1586         local subsys="${3:-"$SUBSYSTEM"}"
1587         local debug_size="${4:-$DEBUG_SIZE}"
1588         local node=$(facet_active_host $facet)
1589
1590         [ -n "$node" ] || error "No host defined for facet $facet"
1591
1592         set_default_debug_nodes $node "$debug" "$subsys" $debug_size
1593 }
1594
1595 set_hostid () {
1596     local hostid=${1:-$(hostid)}
1597
1598     if [ ! -s /etc/hostid ]; then
1599         printf $(echo -n $hostid |
1600             sed 's/\(..\)\(..\)\(..\)\(..\)/\\x\4\\x\3\\x\2\\x\1/') >/etc/hostid
1601     fi
1602 }
1603
1604 # Facet functions
1605 mount_facets () {
1606         local facets=${1:-$(get_facets)}
1607         local facet
1608
1609         for facet in ${facets//,/ }; do
1610                 mount_facet $facet
1611                 local RC=$?
1612                 [ $RC -eq 0 ] && continue
1613
1614                 if [ "$TESTSUITE.$TESTNAME" = "replay-dual.test_0a" ]; then
1615                         skip_noexit "Restart of $facet failed!." &&
1616                                 touch $LU482_FAILED
1617                 else
1618                         error "Restart of $facet failed!"
1619                 fi
1620                 return $RC
1621         done
1622 }
1623
1624 #
1625 # Add argument "arg" (e.g., "loop") to the comma-separated list
1626 # of arguments for option "opt" (e.g., "-o") on command
1627 # line "opts" (e.g., "-o flock").
1628 #
1629 csa_add() {
1630         local opts=$1
1631         local opt=$2
1632         local arg=$3
1633         local opt_pattern="\([[:space:]]\+\|^\)$opt"
1634
1635         if echo "$opts" | grep -q $opt_pattern; then
1636                 opts=$(echo "$opts" | sed -e \
1637                         "s/$opt_pattern[[:space:]]*[^[:space:]]\+/&,$arg/")
1638         else
1639                 opts+="${opts:+ }$opt $arg"
1640         fi
1641         echo -n "$opts"
1642 }
1643
1644 #
1645 # Associate loop device with a given regular file.
1646 # Return the loop device.
1647 #
1648 setup_loop_device() {
1649         local facet=$1
1650         local file=$2
1651
1652         do_facet $facet "loop_dev=\\\$($LOSETUP -j $file | cut -d : -f 1);
1653                          if [[ -z \\\$loop_dev ]]; then
1654                                 loop_dev=\\\$($LOSETUP -f);
1655                                 $LOSETUP \\\$loop_dev $file || loop_dev=;
1656                          fi;
1657                          echo -n \\\$loop_dev"
1658 }
1659
1660 #
1661 # Detach a loop device.
1662 #
1663 cleanup_loop_device() {
1664         local facet=$1
1665         local loop_dev=$2
1666
1667         do_facet $facet "! $LOSETUP $loop_dev >/dev/null 2>&1 ||
1668                          $LOSETUP -d $loop_dev"
1669 }
1670
1671 #
1672 # Check if a given device is a block device.
1673 #
1674 is_blkdev() {
1675         local facet=$1
1676         local dev=$2
1677         local size=${3:-""}
1678
1679         [[ -n "$dev" ]] || return 1
1680         do_facet $facet "test -b $dev" || return 1
1681         if [[ -n "$size" ]]; then
1682                 local in=$(do_facet $facet "dd if=$dev of=/dev/null bs=1k \
1683                                             count=1 skip=$size 2>&1" |
1684                                             awk '($3 == "in") { print $1 }')
1685                 [[ "$in" = "1+0" ]] || return 1
1686         fi
1687 }
1688
1689 #
1690 # Check if a given device is a device-mapper device.
1691 #
1692 is_dm_dev() {
1693         local facet=$1
1694         local dev=$2
1695
1696         [[ -n "$dev" ]] || return 1
1697         do_facet $facet "$DMSETUP status $dev >/dev/null 2>&1"
1698 }
1699
1700 #
1701 # Check if a given device is a device-mapper flakey device.
1702 #
1703 is_dm_flakey_dev() {
1704         local facet=$1
1705         local dev=$2
1706         local type
1707
1708         [[ -n "$dev" ]] || return 1
1709
1710         type=$(do_facet $facet "$DMSETUP status $dev 2>&1" |
1711                awk '{print $3}')
1712         [[ $type = flakey ]] && return 0 || return 1
1713 }
1714
1715 #
1716 # Check if device-mapper flakey device is supported by the kernel
1717 # of $facet node or not.
1718 #
1719 dm_flakey_supported() {
1720         local facet=$1
1721
1722         $FLAKEY || return 1
1723         do_facet $facet "modprobe dm-flakey;
1724                          $DMSETUP targets | grep -q flakey" &> /dev/null
1725 }
1726
1727 #
1728 # Get the device-mapper flakey device name of a given facet.
1729 #
1730 dm_facet_devname() {
1731         local facet=$1
1732         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1733
1734         echo -n ${facet}_flakey
1735 }
1736
1737 #
1738 # Get the device-mapper flakey device of a given facet.
1739 # A device created by dmsetup will appear as /dev/mapper/<device-name>.
1740 #
1741 dm_facet_devpath() {
1742         local facet=$1
1743
1744         echo -n $DM_DEV_PATH/$(dm_facet_devname $facet)
1745 }
1746
1747 #
1748 # Set a device-mapper device with a new table.
1749 #
1750 # The table has the following format:
1751 # <logical_start_sector> <num_sectors> <target_type> <target_args>
1752 #
1753 # flakey <target_args> includes:
1754 # <destination_device> <offset> <up_interval> <down_interval> \
1755 # [<num_features> [<feature_arguments>]]
1756 #
1757 # linear <target_args> includes:
1758 # <destination_device> <start_sector>
1759 #
1760 dm_set_dev_table() {
1761         local facet=$1
1762         local dm_dev=$2
1763         local target_type=$3
1764         local num_sectors
1765         local real_dev
1766         local tmp
1767         local table
1768
1769         read tmp num_sectors tmp real_dev tmp \
1770                 <<< $(do_facet $facet "$DMSETUP table $dm_dev")
1771
1772         case $target_type in
1773         flakey)
1774                 table="0 $num_sectors flakey $real_dev 0 0 1800 1 drop_writes"
1775                 ;;
1776         linear)
1777                 table="0 $num_sectors linear $real_dev 0"
1778                 ;;
1779         *) error "invalid target type $target_type" ;;
1780         esac
1781
1782         do_facet $facet "$DMSETUP suspend --nolockfs --noflush $dm_dev" ||
1783                 error "failed to suspend $dm_dev"
1784         do_facet $facet "$DMSETUP load $dm_dev --table \\\"$table\\\"" ||
1785                 error "failed to load $target_type table into $dm_dev"
1786         do_facet $facet "$DMSETUP resume $dm_dev" ||
1787                 error "failed to resume $dm_dev"
1788 }
1789
1790 #
1791 # Set a device-mapper flakey device as "read-only" by using the "drop_writes"
1792 # feature parameter.
1793 #
1794 # drop_writes:
1795 #       All write I/O is silently ignored.
1796 #       Read I/O is handled correctly.
1797 #
1798 dm_set_dev_readonly() {
1799         local facet=$1
1800         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1801
1802         dm_set_dev_table $facet $dm_dev flakey
1803 }
1804
1805 #
1806 # Set a device-mapper device to traditional linear mapping mode.
1807 #
1808 dm_clear_dev_readonly() {
1809         local facet=$1
1810         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1811
1812         dm_set_dev_table $facet $dm_dev linear
1813 }
1814
1815 #
1816 # Set the device of a given facet as "read-only".
1817 #
1818 set_dev_readonly() {
1819         local facet=$1
1820         local svc=${facet}_svc
1821
1822         if [[ $(facet_fstype $facet) = zfs ]] ||
1823            ! dm_flakey_supported $facet; then
1824                 do_facet $facet $LCTL --device ${!svc} readonly
1825         else
1826                 dm_set_dev_readonly $facet
1827         fi
1828 }
1829
1830 #
1831 # Get size in 512-byte sectors (BLKGETSIZE64 / 512) of a given device.
1832 #
1833 get_num_sectors() {
1834         local facet=$1
1835         local dev=$2
1836         local num_sectors
1837
1838         num_sectors=$(do_facet $facet "blockdev --getsz $dev 2>/dev/null")
1839         [[ ${PIPESTATUS[0]} = 0 && -n "$num_sectors" ]] || num_sectors=0
1840         echo -n $num_sectors
1841 }
1842
1843 #
1844 # Create a device-mapper device with a given block device or regular file (will
1845 # be associated with loop device).
1846 # Return the full path of the device-mapper device.
1847 #
1848 dm_create_dev() {
1849         local facet=$1
1850         local real_dev=$2                                  # destination device
1851         local dm_dev_name=${3:-$(dm_facet_devname $facet)} # device name
1852         local dm_dev=$DM_DEV_PATH/$dm_dev_name            # device-mapper device
1853
1854         # check if the device-mapper device to be created already exists
1855         if is_dm_dev $facet $dm_dev; then
1856                 # if the existing device was set to "read-only", then clear it
1857                 ! is_dm_flakey_dev $facet $dm_dev ||
1858                         dm_clear_dev_readonly $facet $dm_dev
1859
1860                 echo -n $dm_dev
1861                 return 0
1862         fi
1863
1864         # check if the destination device is a block device, and if not,
1865         # associate it with a loop device
1866         is_blkdev $facet $real_dev ||
1867                 real_dev=$(setup_loop_device $facet $real_dev)
1868         [[ -n "$real_dev" ]] || { echo -n $real_dev; return 2; }
1869
1870         # now create the device-mapper device
1871         local num_sectors=$(get_num_sectors $facet $real_dev)
1872         local table="0 $num_sectors linear $real_dev 0"
1873         local rc=0
1874
1875         do_facet $facet "$DMSETUP create $dm_dev_name --table \\\"$table\\\"" ||
1876                 { rc=${PIPESTATUS[0]}; dm_dev=; }
1877         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1878
1879         echo -n $dm_dev
1880         return $rc
1881 }
1882
1883 #
1884 # Map the facet name to its device variable name.
1885 #
1886 facet_device_alias() {
1887         local facet=$1
1888         local dev_alias=$facet
1889
1890         case $facet in
1891                 fs2mds) dev_alias=mds1_2 ;;
1892                 fs2ost) dev_alias=ost1_2 ;;
1893                 fs3ost) dev_alias=ost2_2 ;;
1894                 *) ;;
1895         esac
1896
1897         echo -n $dev_alias
1898 }
1899
1900 #
1901 # Save the original value of the facet device and export the new value.
1902 #
1903 export_dm_dev() {
1904         local facet=$1
1905         local dm_dev=$2
1906
1907         local active_facet=$(facet_active $facet)
1908         local dev_alias=$(facet_device_alias $active_facet)
1909         local dev_name=${dev_alias}_dev
1910         local dev=${!dev_name}
1911
1912         if [[ $active_facet = $facet ]]; then
1913                 local failover_dev=${dev_alias}failover_dev
1914                 if [[ ${!failover_dev} = $dev ]]; then
1915                         eval export ${failover_dev}_saved=$dev
1916                         eval export ${failover_dev}=$dm_dev
1917                 fi
1918         else
1919                 dev_alias=$(facet_device_alias $facet)
1920                 local facet_dev=${dev_alias}_dev
1921                 if [[ ${!facet_dev} = $dev ]]; then
1922                         eval export ${facet_dev}_saved=$dev
1923                         eval export ${facet_dev}=$dm_dev
1924                 fi
1925         fi
1926
1927         eval export ${dev_name}_saved=$dev
1928         eval export ${dev_name}=$dm_dev
1929 }
1930
1931 #
1932 # Restore the saved value of the facet device.
1933 #
1934 unexport_dm_dev() {
1935         local facet=$1
1936
1937         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1938         local dev_alias=$(facet_device_alias $facet)
1939
1940         local saved_dev=${dev_alias}_dev_saved
1941         [[ -z ${!saved_dev} ]] ||
1942                 eval export ${dev_alias}_dev=${!saved_dev}
1943
1944         saved_dev=${dev_alias}failover_dev_saved
1945         [[ -z ${!saved_dev} ]] ||
1946                 eval export ${dev_alias}failover_dev=${!saved_dev}
1947 }
1948
1949 #
1950 # Remove a device-mapper device.
1951 # If the destination device is a loop device, then also detach it.
1952 #
1953 dm_cleanup_dev() {
1954         local facet=$1
1955         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1956         local major
1957         local minor
1958
1959         is_dm_dev $facet $dm_dev || return 0
1960
1961         read major minor <<< $(do_facet $facet "$DMSETUP table $dm_dev" |
1962                 awk '{ print $4 }' | awk -F: '{ print $1" "$2 }')
1963
1964         do_facet $facet "$DMSETUP remove $dm_dev"
1965         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1966
1967         unexport_dm_dev $facet
1968
1969         # detach a loop device
1970         [[ $major -ne 7 ]] || cleanup_loop_device $facet /dev/loop$minor
1971
1972         # unload dm-flakey module
1973         do_facet $facet "modprobe -r dm-flakey" || true
1974 }
1975
1976 mount_facet() {
1977         local facet=$1
1978         shift
1979         local active_facet=$(facet_active $facet)
1980         local dev_alias=$(facet_device_alias $active_facet)
1981         local dev=${dev_alias}_dev
1982         local opt=${facet}_opt
1983         local mntpt=$(facet_mntpt $facet)
1984         local opts="${!opt} $@"
1985         local fstype=$(facet_fstype $facet)
1986         local devicelabel
1987         local dm_dev=${!dev}
1988
1989         module_loaded lustre || load_modules
1990
1991         case $fstype in
1992         ldiskfs)
1993                 if dm_flakey_supported $facet; then
1994                         dm_dev=$(dm_create_dev $facet ${!dev})
1995                         [[ -n "$dm_dev" ]] || dm_dev=${!dev}
1996                 fi
1997
1998                 is_blkdev $facet $dm_dev || opts=$(csa_add "$opts" -o loop)
1999
2000                 devicelabel=$(do_facet ${facet} "$E2LABEL $dm_dev");;
2001         zfs)
2002                 # import ZFS storage pool
2003                 import_zpool $facet || return ${PIPESTATUS[0]}
2004
2005                 devicelabel=$(do_facet ${facet} "$ZFS get -H -o value \
2006                                                 lustre:svname $dm_dev");;
2007         *)
2008                 error "unknown fstype!";;
2009         esac
2010
2011         echo "Starting ${facet}: $opts $dm_dev $mntpt"
2012         # for testing LU-482 error handling in mount_facets() and test_0a()
2013         if [ -f $TMP/test-lu482-trigger ]; then
2014                 RC=2
2015         else
2016                 do_facet ${facet} \
2017                         "mkdir -p $mntpt; $MOUNT_CMD $opts $dm_dev $mntpt"
2018                 RC=${PIPESTATUS[0]}
2019         fi
2020
2021         if [ $RC -ne 0 ]; then
2022                 echo "Start of $dm_dev on ${facet} failed ${RC}"
2023                 return $RC
2024         fi
2025
2026         health=$(do_facet ${facet} "$LCTL get_param -n health_check")
2027         if [[ "$health" != "healthy" ]]; then
2028                 error "$facet is in a unhealthy state"
2029         fi
2030
2031         set_default_debug_facet $facet
2032
2033         if [[ $opts =~ .*nosvc.* ]]; then
2034                 echo "Start $dm_dev without service"
2035         else
2036
2037                 case $fstype in
2038                 ldiskfs)
2039                         wait_update_facet ${facet} "$E2LABEL $dm_dev \
2040                                 2>/dev/null | grep -E ':[a-zA-Z]{3}[0-9]{4}'" \
2041                                 "" || error "$dm_dev failed to initialize!";;
2042                 zfs)
2043                         wait_update_facet ${facet} "$ZFS get -H -o value \
2044                                 lustre:svname $dm_dev 2>/dev/null | \
2045                                 grep -E ':[a-zA-Z]{3}[0-9]{4}'" "" ||
2046                                 error "$dm_dev failed to initialize!";;
2047
2048                 *)
2049                         error "unknown fstype!";;
2050                 esac
2051         fi
2052
2053         # commit the device label change to disk
2054         if [[ $devicelabel =~ (:[a-zA-Z]{3}[0-9]{4}) ]]; then
2055                 echo "Commit the device label on ${!dev}"
2056                 do_facet $facet "sync; sleep 1; sync"
2057         fi
2058
2059
2060         label=$(devicelabel ${facet} $dm_dev)
2061         [ -z "$label" ] && echo no label for $dm_dev && exit 1
2062         eval export ${facet}_svc=${label}
2063         echo Started ${label}
2064
2065         export_dm_dev $facet $dm_dev
2066
2067         return $RC
2068 }
2069
2070 # start facet device options
2071 start() {
2072         local facet=$1
2073         shift
2074         local device=$1
2075         shift
2076         local dev_alias=$(facet_device_alias $facet)
2077
2078         eval export ${dev_alias}_dev=${device}
2079         eval export ${facet}_opt=\"$@\"
2080
2081         local varname=${dev_alias}failover_dev
2082         if [ -n "${!varname}" ] ; then
2083                 eval export ${dev_alias}failover_dev=${!varname}
2084         else
2085                 eval export ${dev_alias}failover_dev=$device
2086         fi
2087
2088         local mntpt=$(facet_mntpt $facet)
2089         do_facet ${facet} mkdir -p $mntpt
2090         eval export ${facet}_MOUNT=$mntpt
2091         mount_facet ${facet}
2092         RC=$?
2093
2094         return $RC
2095 }
2096
2097 stop() {
2098         local running
2099         local facet=$1
2100         shift
2101         local HOST=$(facet_active_host $facet)
2102         [[ -z $HOST ]] && echo stop: no host for $facet && return 0
2103
2104         local mntpt=$(facet_mntpt $facet)
2105         running=$(do_facet ${facet} "grep -c $mntpt' ' /proc/mounts || true")
2106         if [ ${running} -ne 0 ]; then
2107                 echo "Stopping $mntpt (opts:$@) on $HOST"
2108                 do_facet ${facet} $UMOUNT $@ $mntpt
2109         fi
2110
2111         # umount should block, but we should wait for unrelated obd's
2112         # like the MGS or MGC to also stop.
2113         wait_exit_ST ${facet} || return ${PIPESTATUS[0]}
2114
2115         if [[ $(facet_fstype $facet) == zfs ]]; then
2116                 # export ZFS storage pool
2117                 [ "$KEEP_ZPOOL" = "true" ] || export_zpool $facet
2118         elif dm_flakey_supported $facet; then
2119                 local host=${facet}_HOST
2120                 local failover_host=${facet}failover_HOST
2121                 if [[ -n ${!failover_host} && ${!failover_host} != ${!host} ]]||
2122                         $CLEANUP_DM_DEV || [[ $facet = fs* ]]; then
2123                         dm_cleanup_dev $facet
2124                 fi
2125         fi
2126 }
2127
2128 # get mdt quota type
2129 mdt_quota_type() {
2130         local varsvc=${SINGLEMDS}_svc
2131         do_facet $SINGLEMDS $LCTL get_param -n \
2132                 osd-$(facet_fstype $SINGLEMDS).${!varsvc}.quota_slave.enabled
2133 }
2134
2135 # get ost quota type
2136 ost_quota_type() {
2137         # All OSTs should have same quota type
2138         local varsvc=ost1_svc
2139         do_facet ost1 $LCTL get_param -n \
2140                 osd-$(facet_fstype ost1).${!varsvc}.quota_slave.enabled
2141 }
2142
2143 # restore old quota type settings
2144 restore_quota() {
2145         if [ "$old_MDT_QUOTA_TYPE" ]; then
2146                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2147                         do_facet mgs $PERM_CMD \
2148                                 osd-*.$FSNAME-MDT*.quota_slave.enable = \
2149                                 $old_MDT_QUOTA_TYPE
2150                 else
2151                         do_facet mgs $PERM_CMD \
2152                                 $FSNAME.quota.mdt=$old_MDT_QUOTA_TYPE
2153                 fi
2154         fi
2155         if [ "$old_OST_QUOTA_TYPE" ]; then
2156                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2157                         do_facet mgs $PERM_CMD \
2158                                 osd-*.$FSNAME-OST*.quota_slave.enable = \
2159                                 $old_OST_QUOTA_TYPE
2160                 else
2161                         do_facet mgs $LCTL conf_param \
2162                                 $FSNAME.quota.ost=$old_OST_QUOTA_TYPE
2163                 fi
2164         fi
2165 }
2166
2167 # Handle the case when there is a space in the lfs df
2168 # "filesystem summary" line the same as when there is no space.
2169 # This will allow fixing the "lfs df" summary line in the future.
2170 lfs_df() {
2171         $LFS df $* | sed -e 's/filesystem /filesystem_/'
2172 }
2173
2174 # Get free inodes on the MDT specified by mdt index, free indoes on
2175 # the whole filesystem will be returned when index == -1.
2176 mdt_free_inodes() {
2177         local index=$1
2178         local free_inodes
2179         local mdt_uuid
2180
2181         if [ $index -eq -1 ]; then
2182                 mdt_uuid="summary"
2183         else
2184                 mdt_uuid=$(mdtuuid_from_index $index)
2185         fi
2186
2187         free_inodes=$(lfs_df -i $MOUNT | grep $mdt_uuid | awk '{print $4}')
2188         echo $free_inodes
2189 }
2190
2191 #
2192 # Get the OST device status from 'lfs df' with a given OST index.
2193 #
2194 ost_dev_status() {
2195         local ost_idx=$1
2196         local mnt_pnt=${2:-$MOUNT}
2197         local ost_uuid
2198
2199         ost_uuid=$(ostuuid_from_index $ost_idx $mnt_pnt)
2200         lfs_df $mnt_pnt | awk '/'$ost_uuid'/ { print $7 }'
2201 }
2202
2203 setup_quota(){
2204         local mntpt=$1
2205
2206         # save old quota type & set new quota type
2207         local mdt_qtype=$(mdt_quota_type)
2208         local ost_qtype=$(ost_quota_type)
2209
2210         echo "[HOST:$HOSTNAME] [old_mdt_qtype:$mdt_qtype]" \
2211                 "[old_ost_qtype:$ost_qtype] [new_qtype:$QUOTA_TYPE]"
2212
2213         export old_MDT_QUOTA_TYPE=$mdt_qtype
2214         export old_OST_QUOTA_TYPE=$ost_qtype
2215
2216         if [[ $PERM_CMD == *"set_param -P"* ]]; then
2217                 do_facet mgs $PERM_CMD \
2218                         osd-*.$FSNAME-MDT*.quota_slave.enable=$QUOTA_TYPE
2219                 do_facet mgs $PERM_CMD \
2220                         osd-*.$FSNAME-OST*.quota_slave.enable=$QUOTA_TYPE
2221         else
2222                 do_facet mgs $PERM_CMD $FSNAME.quota.mdt=$QUOTA_TYPE ||
2223                         error "set mdt quota type failed"
2224                 do_facet mgs $PERM_CMD $FSNAME.quota.ost=$QUOTA_TYPE ||
2225                         error "set ost quota type failed"
2226         fi
2227
2228         local quota_usrs=$QUOTA_USERS
2229
2230         # get_filesystem_size
2231         local disksz=$(lfs_df $mntpt | grep "summary" | awk '{print $2}')
2232         local blk_soft=$((disksz + 1024))
2233         local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
2234
2235         local inodes=$(lfs_df -i $mntpt | grep "summary" | awk '{print $2}')
2236         local i_soft=$inodes
2237         local i_hard=$((i_soft + i_soft / 20))
2238
2239         echo "Total disk size: $disksz  block-softlimit: $blk_soft" \
2240                 "block-hardlimit: $blk_hard inode-softlimit: $i_soft" \
2241                 "inode-hardlimit: $i_hard"
2242
2243         local cmd
2244         for usr in $quota_usrs; do
2245                 echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
2246                 for type in u g; do
2247                         cmd="$LFS setquota -$type $usr -b $blk_soft"
2248                         cmd="$cmd -B $blk_hard -i $i_soft -I $i_hard $mntpt"
2249                         echo "+ $cmd"
2250                         eval $cmd || error "$cmd FAILED!"
2251                 done
2252                 # display the quota status
2253                 echo "Quota settings for $usr : "
2254                 $LFS quota -v -u $usr $mntpt || true
2255         done
2256 }
2257
2258 zconf_mount() {
2259         local client=$1
2260         local mnt=$2
2261         local opts=${3:-$MOUNT_OPTS}
2262         opts=${opts:+-o $opts}
2263         local flags=${4:-$MOUNT_FLAGS}
2264
2265         local device=$MGSNID:/$FSNAME$FILESET
2266         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2267                 echo "Bad mount command: opt=$flags $opts dev=$device " \
2268                      "mnt=$mnt"
2269                 exit 1
2270         fi
2271
2272         if $GSS_SK; then
2273                 # update mount option with skpath
2274                 opts=$(add_sk_mntflag $opts)
2275         fi
2276
2277         echo "Starting client: $client: $flags $opts $device $mnt"
2278         do_node $client mkdir -p $mnt
2279         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ];then
2280                 do_node $client $MOUNT_CMD $flags $opts $MGSNID:/$FSNAME \
2281                         $mnt || return 1
2282                 #disable FILESET if not supported
2283                 do_nodes $client lctl get_param -n \
2284                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2285                                 device=$MGSNID:/$FSNAME
2286                 do_node $client mkdir -p $mnt/$FILESET
2287                 do_node $client "! grep -q $mnt' ' /proc/mounts ||
2288                         umount $mnt"
2289         fi
2290         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2291                 # Mount using nodemap key
2292                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2293                 if $SK_UNIQUE_NM; then
2294                         mountkey=$SK_PATH/nodemap/c0.key
2295                 fi
2296                 local prunedopts=$(echo $opts |
2297                                 sed -e "s#skpath=[^,^ ]*#skpath=$mountkey#g")
2298                 do_node $client $MOUNT_CMD $flags $prunedopts $device $mnt ||
2299                                 return 1
2300         else
2301                 do_node $client $MOUNT_CMD $flags $opts $device $mnt ||
2302                                 return 1
2303         fi
2304
2305         set_default_debug_nodes $client
2306
2307         return 0
2308 }
2309
2310 zconf_umount() {
2311         local client=$1
2312         local mnt=$2
2313         local force
2314         local busy
2315         local need_kill
2316         local running=$(do_node $client "grep -c $mnt' ' /proc/mounts") || true
2317
2318         [ "$3" ] && force=-f
2319         [ $running -eq 0 ] && return 0
2320
2321         echo "Stopping client $client $mnt (opts:$force)"
2322         do_node $client lsof -t $mnt || need_kill=no
2323         if [ "x$force" != "x" ] && [ "x$need_kill" != "xno" ]; then
2324                 pids=$(do_node $client lsof -t $mnt | sort -u);
2325                 if [ -n "$pids" ]; then
2326                         do_node $client kill -9 $pids || true
2327                 fi
2328         fi
2329
2330         busy=$(do_node $client "umount $force $mnt 2>&1" | grep -c "busy") ||
2331                 true
2332         if [ $busy -ne 0 ] ; then
2333                 echo "$mnt is still busy, wait one second" && sleep 1
2334                 do_node $client umount $force $mnt
2335         fi
2336 }
2337
2338 # Mount the file system on the MDS
2339 mount_mds_client() {
2340         local mds_HOST=${SINGLEMDS}_HOST
2341         echo $mds_HOST
2342         do_facet $SINGLEMDS "mkdir -p $MOUNT2"
2343         zconf_mount $mds1_HOST $MOUNT2 $MOUNT_OPTS ||
2344                 error "unable to mount $MOUNT2 on MDS"
2345 }
2346
2347 # Unmount the file system on the MDS
2348 umount_mds_client() {
2349         local mds_HOST=${SINGLEMDS}_HOST
2350         zconf_umount $mds1_HOST $MOUNT2
2351         do_facet $SINGLEMDS "rm -rf $MOUNT2"
2352 }
2353
2354 # nodes is comma list
2355 sanity_mount_check_nodes () {
2356     local nodes=$1
2357     shift
2358     local mnts="$@"
2359     local mnt
2360
2361     # FIXME: assume that all cluster nodes run the same os
2362     [ "$(uname)" = Linux ] || return 0
2363
2364     local rc=0
2365     for mnt in $mnts ; do
2366         do_nodes $nodes "running=\\\$(grep -c $mnt' ' /proc/mounts);
2367 mpts=\\\$(mount | grep -c $mnt' ');
2368 if [ \\\$running -ne \\\$mpts ]; then
2369     echo \\\$(hostname) env are INSANE!;
2370     exit 1;
2371 fi"
2372     [ $? -eq 0 ] || rc=1
2373     done
2374     return $rc
2375 }
2376
2377 sanity_mount_check_servers () {
2378     [ -n "$CLIENTONLY" ] &&
2379         { echo "CLIENTONLY mode, skip mount_check_servers"; return 0; } || true
2380     echo Checking servers environments
2381
2382     # FIXME: modify get_facets to display all facets wo params
2383     local facets="$(get_facets OST),$(get_facets MDS),mgs"
2384     local node
2385     local mntpt
2386     local facet
2387     for facet in ${facets//,/ }; do
2388         node=$(facet_host ${facet})
2389         mntpt=$(facet_mntpt $facet)
2390         sanity_mount_check_nodes $node $mntpt ||
2391             { error "server $node environments are insane!"; return 1; }
2392     done
2393 }
2394
2395 sanity_mount_check_clients () {
2396     local clients=${1:-$CLIENTS}
2397     local mntpt=${2:-$MOUNT}
2398     local mntpt2=${3:-$MOUNT2}
2399
2400     [ -z $clients ] && clients=$(hostname)
2401     echo Checking clients $clients environments
2402
2403     sanity_mount_check_nodes $clients $mntpt $mntpt2 ||
2404        error "clients environments are insane!"
2405 }
2406
2407 sanity_mount_check () {
2408     sanity_mount_check_servers || return 1
2409     sanity_mount_check_clients || return 2
2410 }
2411
2412 # mount clients if not mouted
2413 zconf_mount_clients() {
2414         local clients=$1
2415         local mnt=$2
2416         local opts=${3:-$MOUNT_OPTS}
2417         opts=${opts:+-o $opts}
2418         local flags=${4:-$MOUNT_FLAGS}
2419         local device=$MGSNID:/$FSNAME$FILESET
2420         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2421                 echo "Bad conf mount command: opt=$flags $opts dev=$device " \
2422                      "mnt=$mnt"
2423                 exit 1
2424         fi
2425
2426         echo "Starting client $clients: $flags $opts $device $mnt"
2427         do_nodes $clients mkdir -p $mnt
2428         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ]; then
2429                 if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2430                         # Mount with own nodemap key
2431                         local i=0
2432                         # Mount all server nodes first with per-NM keys
2433                         for nmclient in ${clients//,/ }; do
2434 #                               do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key -n c$i"
2435                                 do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key"
2436                                 i=$((i + 1))
2437                         done
2438                         # set perms for per-nodemap keys else permission denied
2439                         do_nodes $(comma_list $(all_nodes)) \
2440                                 "keyctl show | grep lustre | cut -c1-11 |
2441                                 sed -e 's/ //g;' |
2442                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
2443                         local mountkey=$SK_PATH/$FSNAME-nmclient.key
2444                         i=0
2445                         for nmclient in ${clients//,/ }; do
2446                                 if $SK_UNIQUE_NM; then
2447                                         mountkey=$SK_PATH/nodemap/c$i.key
2448                                 fi
2449                                 do_node $nmclient "! grep -q $mnt' ' \
2450                                         /proc/mounts || umount $mnt"
2451                                 local prunedopts=$(add_sk_mntflag $prunedopts);
2452                                 prunedopts=$(echo $prunedopts | sed -e \
2453                                         "s#skpath=[^ ^,]*#skpath=$mountkey#g")
2454                                 set -x
2455                                 do_nodes $(comma_list $(all_server_nodes)) \
2456                                         "keyctl show"
2457                                 set +x
2458                                 do_node $nmclient $MOUNT_CMD $flags \
2459                                         $prunedopts $MGSNID:/$FSNAME $mnt ||
2460                                         return 1
2461                                 i=$((i + 1))
2462                         done
2463                 else
2464                         do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2465                                         umount $mnt"
2466                         do_nodes $clients $MOUNT_CMD $flags $opts \
2467                                         $MGSNID:/$FSNAME $mnt || return 1
2468                 fi
2469                 #disable FILESET if not supported
2470                 do_nodes $clients lctl get_param -n \
2471                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2472                                 device=$MGSNID:/$FSNAME
2473                 do_nodes $clients mkdir -p $mnt/$FILESET
2474                 do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2475                         umount $mnt"
2476         fi
2477
2478         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2479                 # Mount with nodemap key
2480                 local i=0
2481                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2482                 for nmclient in ${clients//,/ }; do
2483                         if $SK_UNIQUE_NM; then
2484                                 mountkey=$SK_PATH/nodemap/c$i.key
2485                         fi
2486                         local prunedopts=$(echo $opts | sed -e \
2487                                 "s#skpath=[^ ^,]*#skpath=$mountkey#g");
2488                         do_node $nmclient "! grep -q $mnt' ' /proc/mounts ||
2489                                 umount $mnt"
2490                         do_node $nmclient "
2491                 running=\\\$(mount | grep -c $mnt' ');
2492                 rc=0;
2493                 if [ \\\$running -eq 0 ] ; then
2494                         mkdir -p $mnt;
2495                         $MOUNT_CMD $flags $prunedopts $device $mnt;
2496                         rc=\\\$?;
2497                 else
2498                         lustre_mnt_count=\\\$(mount | grep $mnt' ' | \
2499                                 grep 'type lustre' | wc -l);
2500                         if [ \\\$running -ne \\\$lustre_mnt_count ] ; then
2501                                 echo zconf_mount_clients FAILED: \
2502                                         mount count \\\$running, not matching \
2503                                         with mount count of 'type lustre' \
2504                                         \\\$lustre_mnt_count;
2505                                 rc=1;
2506                         fi;
2507                 fi;
2508         exit \\\$rc" || return ${PIPESTATUS[0]}
2509
2510                         i=$((i + 1))
2511                 done
2512         else
2513
2514                 local tmpopts=$opts
2515                 if $SHARED_KEY; then
2516                         tmpopts=$(add_sk_mntflag $opts)
2517                 fi
2518                 do_nodes $clients "
2519 running=\\\$(mount | grep -c $mnt' ');
2520 rc=0;
2521 if [ \\\$running -eq 0 ] ; then
2522         mkdir -p $mnt;
2523         $MOUNT_CMD $flags $tmpopts $device $mnt;
2524         rc=\\\$?;
2525 fi;
2526 exit \\\$rc" || return ${PIPESTATUS[0]}
2527         fi
2528
2529         echo "Started clients $clients: "
2530         do_nodes $clients "mount | grep $mnt' '"
2531
2532         set_default_debug_nodes $clients
2533
2534         return 0
2535 }
2536
2537 zconf_umount_clients() {
2538     local clients=$1
2539     local mnt=$2
2540     local force
2541
2542     [ "$3" ] && force=-f
2543
2544     echo "Stopping clients: $clients $mnt (opts:$force)"
2545     do_nodes $clients "running=\\\$(grep -c $mnt' ' /proc/mounts);
2546 if [ \\\$running -ne 0 ] ; then
2547 echo Stopping client \\\$(hostname) $mnt opts:$force;
2548 lsof $mnt || need_kill=no;
2549 if [ "x$force" != "x" -a "x\\\$need_kill" != "xno" ]; then
2550     pids=\\\$(lsof -t $mnt | sort -u);
2551     if [ -n \\\"\\\$pids\\\" ]; then
2552              kill -9 \\\$pids;
2553     fi
2554 fi;
2555 while umount $force $mnt 2>&1 | grep -q "busy"; do
2556     echo "$mnt is still busy, wait one second" && sleep 1;
2557 done;
2558 fi"
2559 }
2560
2561 shutdown_node () {
2562     local node=$1
2563     echo + $POWER_DOWN $node
2564     $POWER_DOWN $node
2565 }
2566
2567 shutdown_node_hard () {
2568     local host=$1
2569     local attempts=$SHUTDOWN_ATTEMPTS
2570
2571     for i in $(seq $attempts) ; do
2572         shutdown_node $host
2573         sleep 1
2574         wait_for_function --quiet "! ping -w 3 -c 1 $host" 5 1 && return 0
2575         echo "waiting for $host to fail attempts=$attempts"
2576         [ $i -lt $attempts ] || \
2577             { echo "$host still pingable after power down! attempts=$attempts" && return 1; }
2578     done
2579 }
2580
2581 shutdown_client() {
2582     local client=$1
2583     local mnt=${2:-$MOUNT}
2584     local attempts=3
2585
2586     if [ "$FAILURE_MODE" = HARD ]; then
2587         shutdown_node_hard $client
2588     else
2589        zconf_umount_clients $client $mnt -f
2590     fi
2591 }
2592
2593 facets_on_host () {
2594     local host=$1
2595     local facets="$(get_facets OST),$(get_facets MDS)"
2596     local affected
2597
2598     combined_mgs_mds || facets="$facets,mgs"
2599
2600     for facet in ${facets//,/ }; do
2601         if [ $(facet_active_host $facet) == $host ]; then
2602            affected="$affected $facet"
2603         fi
2604     done
2605
2606     echo $(comma_list $affected)
2607 }
2608
2609 facet_up() {
2610         local facet=$1
2611         local host=${2:-$(facet_host $facet)}
2612
2613         local label=$(convert_facet2label $facet)
2614         do_node $host $LCTL dl | awk '{ print $4 }' | grep -q "^$label\$"
2615 }
2616
2617 facets_up_on_host () {
2618     local host=$1
2619     local facets=$(facets_on_host $host)
2620     local affected_up
2621
2622     for facet in ${facets//,/ }; do
2623         if $(facet_up $facet $host); then
2624             affected_up="$affected_up $facet"
2625         fi
2626     done
2627
2628     echo $(comma_list $affected_up)
2629 }
2630
2631 shutdown_facet() {
2632         local facet=$1
2633         local affected_facet
2634         local affected_facets
2635
2636         if [[ "$FAILURE_MODE" = HARD ]]; then
2637                 if [[ $(facet_fstype $facet) = ldiskfs ]] &&
2638                         dm_flakey_supported $facet; then
2639                         affected_facets=$(affected_facets $facet)
2640                         for affected_facet in ${affected_facets//,/ }; do
2641                                 unexport_dm_dev $affected_facet
2642                         done
2643                 fi
2644
2645                 shutdown_node_hard $(facet_active_host $facet)
2646         else
2647                 stop $facet
2648         fi
2649 }
2650
2651 reboot_node() {
2652     local node=$1
2653     echo + $POWER_UP $node
2654     $POWER_UP $node
2655 }
2656
2657 remount_facet() {
2658     local facet=$1
2659
2660     stop $facet
2661     mount_facet $facet
2662 }
2663
2664 reboot_facet() {
2665         local facet=$1
2666         if [ "$FAILURE_MODE" = HARD ]; then
2667                 reboot_node $(facet_active_host $facet)
2668         else
2669                 sleep 10
2670         fi
2671 }
2672
2673 boot_node() {
2674     local node=$1
2675     if [ "$FAILURE_MODE" = HARD ]; then
2676        reboot_node $node
2677        wait_for_host $node
2678     fi
2679 }
2680
2681 facets_hosts () {
2682     local facets=$1
2683     local hosts
2684
2685     for facet in ${facets//,/ }; do
2686         hosts=$(expand_list $hosts $(facet_host $facet) )
2687     done
2688
2689     echo $hosts
2690 }
2691
2692 _check_progs_installed () {
2693     local progs=$@
2694     local rc=0
2695
2696     for prog in $progs; do
2697         if ! [ "$(which $prog)"  -o  "${!prog}" ]; then
2698            echo $prog missing on $(hostname)
2699            rc=1
2700         fi
2701     done
2702     return $rc
2703 }
2704
2705 check_progs_installed () {
2706         local nodes=$1
2707         shift
2708
2709         do_rpc_nodes "$nodes" _check_progs_installed $@
2710 }
2711
2712 # recovery-scale functions
2713 node_var_name() {
2714     echo __$(echo $1 | tr '-' '_' | tr '.' '_')
2715 }
2716
2717 start_client_load() {
2718         local client=$1
2719         local load=$2
2720         local var=$(node_var_name $client)_load
2721         eval export ${var}=$load
2722
2723         do_node $client "PATH=$PATH MOUNT=$MOUNT ERRORS_OK=$ERRORS_OK \
2724                         BREAK_ON_ERROR=$BREAK_ON_ERROR \
2725                         END_RUN_FILE=$END_RUN_FILE \
2726                         LOAD_PID_FILE=$LOAD_PID_FILE \
2727                         TESTLOG_PREFIX=$TESTLOG_PREFIX \
2728                         TESTNAME=$TESTNAME \
2729                         DBENCH_LIB=$DBENCH_LIB \
2730                         DBENCH_SRC=$DBENCH_SRC \
2731                         CLIENT_COUNT=$((CLIENTCOUNT - 1)) \
2732                         LFS=$LFS \
2733                         LCTL=$LCTL \
2734                         FSNAME=$FSNAME \
2735                         MPIRUN=$MPIRUN \
2736                         MPIRUN_OPTIONS=\\\"$MPIRUN_OPTIONS\\\" \
2737                         MACHINEFILE_OPTION=\\\"$MACHINEFILE_OPTION\\\" \
2738                         num_clients=$(get_node_count ${CLIENTS//,/ }) \
2739                         ior_THREADS=$ior_THREADS ior_iteration=$ior_iteration \
2740                         ior_blockSize=$ior_blockSize \
2741                         ior_blockUnit=$ior_blockUnit \
2742                         ior_xferSize=$ior_xferSize ior_type=$ior_type \
2743                         ior_DURATION=$ior_DURATION \
2744                         ior_stripe_params=\\\"$ior_stripe_params\\\" \
2745                         ior_custom_params=\\\"$ior_custom_param\\\" \
2746                         mpi_ior_custom_threads=$mpi_ior_custom_threads \
2747                         run_${load}.sh" &
2748         local ppid=$!
2749         log "Started client load: ${load} on $client"
2750
2751         # get the children process IDs
2752         local pids=$(ps --ppid $ppid -o pid= | xargs)
2753         CLIENT_LOAD_PIDS="$CLIENT_LOAD_PIDS $ppid $pids"
2754         return 0
2755 }
2756
2757 start_client_loads () {
2758         local -a clients=(${1//,/ })
2759         local numloads=${#CLIENT_LOADS[@]}
2760
2761         for ((nodenum=0; nodenum < ${#clients[@]}; nodenum++ )); do
2762                 local load=$((nodenum % numloads))
2763                 start_client_load ${clients[nodenum]} ${CLIENT_LOADS[load]}
2764         done
2765         # bug 22169: wait the background threads to start
2766         sleep 2
2767 }
2768
2769 # only for remote client
2770 check_client_load () {
2771         local client=$1
2772         local var=$(node_var_name $client)_load
2773         local testload=run_${!var}.sh
2774
2775         ps auxww | grep -v grep | grep $client | grep -q $testload || return 1
2776
2777         # bug 18914: try to connect several times not only when
2778         # check ps, but  while check_node_health also
2779
2780         local tries=3
2781         local RC=254
2782         while [ $RC = 254 -a $tries -gt 0 ]; do
2783                 let tries=$tries-1
2784                 # assume success
2785                 RC=0
2786                 if ! check_node_health $client; then
2787                         RC=${PIPESTATUS[0]}
2788                         if [ $RC -eq 254 ]; then
2789                                 # FIXME: not sure how long we shuold sleep here
2790                                 sleep 10
2791                                 continue
2792                         fi
2793                         echo "check node health failed: RC=$RC "
2794                         return $RC
2795                 fi
2796         done
2797         # We can continue try to connect if RC=254
2798         # Just print the warning about this
2799         if [ $RC = 254 ]; then
2800                 echo "got a return status of $RC from do_node while checking " \
2801                 "node health on $client"
2802         fi
2803
2804         # see if the load is still on the client
2805         tries=3
2806         RC=254
2807         while [ $RC = 254 -a $tries -gt 0 ]; do
2808                 let tries=$tries-1
2809                 # assume success
2810                 RC=0
2811                 if ! do_node $client \
2812                         "ps auxwww | grep -v grep | grep -q $testload"; then
2813                         RC=${PIPESTATUS[0]}
2814                         sleep 30
2815                 fi
2816         done
2817         if [ $RC = 254 ]; then
2818                 echo "got a return status of $RC from do_node while checking " \
2819                 "(node health and 'ps') the client load on $client"
2820                 # see if we can diagnose a bit why this is
2821         fi
2822
2823         return $RC
2824 }
2825 check_client_loads () {
2826    local clients=${1//,/ }
2827    local client=
2828    local rc=0
2829
2830    for client in $clients; do
2831       check_client_load $client
2832       rc=${PIPESTATUS[0]}
2833       if [ "$rc" != 0 ]; then
2834         log "Client load failed on node $client, rc=$rc"
2835         return $rc
2836       fi
2837    done
2838 }
2839
2840 restart_client_loads () {
2841     local clients=${1//,/ }
2842     local expectedfail=${2:-""}
2843     local client=
2844     local rc=0
2845
2846     for client in $clients; do
2847         check_client_load $client
2848         rc=${PIPESTATUS[0]}
2849         if [ "$rc" != 0 -a "$expectedfail" ]; then
2850             local var=$(node_var_name $client)_load
2851             start_client_load $client ${!var}
2852             echo "Restarted client load ${!var}: on $client. Checking ..."
2853             check_client_load $client
2854             rc=${PIPESTATUS[0]}
2855             if [ "$rc" != 0 ]; then
2856                 log "Client load failed to restart on node $client, rc=$rc"
2857                 # failure one client load means test fail
2858                 # we do not need to check other
2859                 return $rc
2860             fi
2861         else
2862             return $rc
2863         fi
2864     done
2865 }
2866
2867 # Start vmstat and save its process ID in a file.
2868 start_vmstat() {
2869     local nodes=$1
2870     local pid_file=$2
2871
2872     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2873
2874     do_nodes $nodes \
2875         "vmstat 1 > $TESTLOG_PREFIX.$TESTNAME.vmstat.\\\$(hostname -s).log \
2876         2>/dev/null </dev/null & echo \\\$! > $pid_file"
2877 }
2878
2879 # Display the nodes on which client loads failed.
2880 print_end_run_file() {
2881     local file=$1
2882     local node
2883
2884     [ -s $file ] || return 0
2885
2886     echo "Found the END_RUN_FILE file: $file"
2887     cat $file
2888
2889     # A client load will stop if it finds the END_RUN_FILE file.
2890     # That does not mean the client load actually failed though.
2891     # The first node in END_RUN_FILE is the one we are interested in.
2892     read node < $file
2893
2894     if [ -n "$node" ]; then
2895         local var=$(node_var_name $node)_load
2896
2897         local prefix=$TESTLOG_PREFIX
2898         [ -n "$TESTNAME" ] && prefix=$prefix.$TESTNAME
2899         local stdout_log=$prefix.run_${!var}_stdout.$node.log
2900         local debug_log=$(echo $stdout_log | sed 's/\(.*\)stdout/\1debug/')
2901
2902         echo "Client load ${!var} failed on node $node:"
2903         echo "$stdout_log"
2904         echo "$debug_log"
2905     fi
2906 }
2907
2908 # Stop the process which had its PID saved in a file.
2909 stop_process() {
2910     local nodes=$1
2911     local pid_file=$2
2912
2913     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2914
2915     do_nodes $nodes "test -f $pid_file &&
2916         { kill -s TERM \\\$(cat $pid_file); rm -f $pid_file; }" || true
2917 }
2918
2919 # Stop all client loads.
2920 stop_client_loads() {
2921     local nodes=${1:-$CLIENTS}
2922     local pid_file=$2
2923
2924     # stop the client loads
2925     stop_process $nodes $pid_file
2926
2927     # clean up the processes that started them
2928     [ -n "$CLIENT_LOAD_PIDS" ] && kill -9 $CLIENT_LOAD_PIDS 2>/dev/null || true
2929 }
2930 # End recovery-scale functions
2931
2932 # verify that lustre actually cleaned up properly
2933 cleanup_check() {
2934         VAR=$(lctl get_param -n catastrophe 2>&1)
2935         if [ $? = 0 ] ; then
2936                 if [ $VAR != 0 ]; then
2937                         error "LBUG/LASSERT detected"
2938                 fi
2939         fi
2940         BUSY=$(dmesg | grep -i destruct || true)
2941         if [ -n "$BUSY" ]; then
2942                 echo "$BUSY" 1>&2
2943                 [ -e $TMP/debug ] && mv $TMP/debug $TMP/debug-busy.$(date +%s)
2944                 exit 205
2945         fi
2946
2947         check_mem_leak || exit 204
2948
2949         [[ $($LCTL dl 2>/dev/null | wc -l) -gt 0 ]] && $LCTL dl &&
2950                 echo "$TESTSUITE: lustre didn't clean up..." 1>&2 &&
2951                 return 202 || true
2952
2953         if module_loaded lnet || module_loaded libcfs; then
2954                 echo "$TESTSUITE: modules still loaded..." 1>&2
2955                 /sbin/lsmod 1>&2
2956                 return 203
2957         fi
2958         return 0
2959 }
2960
2961 wait_update () {
2962         local verbose=false
2963         if [[ "$1" == "--verbose" ]]; then
2964                 shift
2965                 verbose=true
2966         fi
2967
2968         local node=$1
2969         local TEST=$2
2970         local FINAL=$3
2971         local MAX=${4:-90}
2972         local RESULT
2973         local PREV_RESULT
2974         local WAIT=0
2975         local sleep=1
2976         local print=10
2977
2978         PREV_RESULT=$(do_node $node "$TEST")
2979         while [ true ]; do
2980                 RESULT=$(do_node $node "$TEST")
2981                 if [[ "$RESULT" == "$FINAL" ]]; then
2982                         [[ -z "$RESULT" || $WAIT -le $sleep ]] ||
2983                                 echo "Updated after ${WAIT}s: wanted '$FINAL'"\
2984                                      "got '$RESULT'"
2985                         return 0
2986                 fi
2987                 if [[ $verbose && "$RESULT" != "$PREV_RESULT" ]]; then
2988                         echo "Changed after ${WAIT}s: from '$PREV_RESULT'"\
2989                              "to '$RESULT'"
2990                         PREV_RESULT=$RESULT
2991                 fi
2992                 [[ $WAIT -ge $MAX ]] && break
2993                 [[ $((WAIT % print)) -eq 0 ]] &&
2994                         echo "Waiting $((MAX - WAIT)) secs for update"
2995                 WAIT=$((WAIT + sleep))
2996                 sleep $sleep
2997         done
2998         echo "Update not seen after ${MAX}s: wanted '$FINAL' got '$RESULT'"
2999         return 3
3000 }
3001
3002 wait_update_facet() {
3003         local verbose=
3004         [ "$1" = "--verbose" ] && verbose="$1" && shift
3005
3006         local facet=$1
3007         shift
3008         wait_update $verbose $(facet_active_host $facet) "$@"
3009 }
3010
3011 sync_all_data() {
3012         do_nodes $(comma_list $(mdts_nodes)) \
3013             "lctl set_param -n os[cd]*.*MDT*.force_sync=1"
3014         do_nodes $(comma_list $(osts_nodes)) \
3015             "lctl set_param -n osd*.*OS*.force_sync=1" 2>&1 |
3016                 grep -v 'Found no match'
3017 }
3018
3019 wait_zfs_commit() {
3020         local zfs_wait=${2:-5}
3021
3022         # the occupied disk space will be released
3023         # only after TXGs are committed
3024         if [[ $(facet_fstype $1) == zfs ]]; then
3025                 echo "sleep $zfs_wait for ZFS $(facet_fstype $1)"
3026                 sleep $zfs_wait
3027         fi
3028 }
3029
3030 fill_ost() {
3031         local filename=$1
3032         local ost_idx=$2
3033         local lwm=$3  #low watermark
3034         local size_mb #how many MB should we write to pass watermark
3035         local ost_name=$(ostname_from_index $ost_idx)
3036
3037         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3038         size_mb=0
3039         if (( $free_kb / 1024 > lwm )); then
3040                 size_mb=$((free_kb / 1024 - lwm))
3041         fi
3042         #If 10% of free space cross low watermark use it
3043         if (( $free_kb / 10240 > size_mb )); then
3044                 size_mb=$((free_kb / 10240))
3045         else
3046                 #At least we need to store 1.1 of difference between
3047                 #free space and low watermark
3048                 size_mb=$((size_mb + size_mb / 10))
3049         fi
3050         if (( lwm <= $free_kb / 1024 )) ||
3051            [ ! -f $DIR/${filename}.fill_ost$ost_idx ]; then
3052                 $LFS setstripe -i $ost_idx -c1 $DIR/${filename}.fill_ost$ost_idx
3053                 dd if=/dev/zero of=$DIR/${filename}.fill_ost$ost_idx bs=1M \
3054                         count=$size_mb oflag=append conv=notrunc
3055         fi
3056
3057         sleep_maxage
3058
3059         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3060         echo "OST still has $((free_kb / 1024)) MB free"
3061 }
3062
3063 # This checks only the primary MDS
3064 ost_watermarks_get() {
3065         local ost_idx=$1
3066         local ost_name=$(ostname_from_index $ost_idx)
3067         local mdtosc_proc=$(get_mdtosc_proc_path $SINGLEMDS $ost_name)
3068
3069         local hwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3070                         osp.$mdtosc_proc.reserved_mb_high)
3071         local lwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3072                         osp.$mdtosc_proc.reserved_mb_low)
3073
3074         echo "$lwm $hwm"
3075 }
3076
3077 # Note that we set watermarks on all MDSes (necessary for striped dirs)
3078 ost_watermarks_set() {
3079         local ost_idx=$1
3080         local lwm=$2
3081         local hwm=$3
3082         local ost_name=$(ostname_from_index $ost_idx)
3083         local facets=$(get_facets MDS)
3084
3085         do_nodes $(comma_list $(mdts_nodes)) $LCTL set_param -n \
3086                 osp.*$ost_name*.reserved_mb_low=$lwm \
3087                 osp.*$ost_name*.reserved_mb_high=$hwm > /dev/null
3088
3089         # sleep to ensure we see the change
3090         sleep_maxage
3091 }
3092
3093 ost_watermarks_set_low_space() {
3094         local ost_idx=$1
3095         local wms=$(ost_watermarks_get $ost_idx)
3096         local ost_name=$(ostname_from_index $ost_idx)
3097
3098         local old_lwm=$(echo $wms | awk '{ print $1 }')
3099         local old_hwm=$(echo $wms | awk '{ print $2 }')
3100
3101         local blocks=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3102         # minimal extension size is 64M
3103         local new_lwm=50
3104         if (( $blocks / 1024 > 50 )); then
3105                 new_lwm=$((blocks / 1024 - 50))
3106         fi
3107         local new_hwm=$((new_lwm + 5))
3108
3109         ost_watermarks_set $ost_idx $new_lwm $new_hwm
3110         echo "watermarks: $old_lwm $old_hwm $new_lwm $new_hwm"
3111 }
3112
3113 # Set watermarks to ~current available space & then write data to fill it
3114 # Note OST is not *actually* full after this, it just reports ENOSPC in the
3115 # internal statfs used by the stripe allocator
3116 #
3117 # first parameter is the filename-prefix, which must get under t-f cleanup
3118 # requirements (rm -rf $DIR/[Rdfs][0-9]*), i.e. $tfile work fine
3119 ost_watermarks_set_enospc() {
3120         local filename=$1
3121         local ost_idx=$2
3122         # on the mdt's osc
3123         local ost_name=$(ostname_from_index $ost_idx)
3124         local facets=$(get_facets MDS)
3125         local wms
3126         local MDS
3127
3128         for MDS in ${facets//,/ }; do
3129                 local mdtosc_proc=$(get_mdtosc_proc_path $MDS $ost_name)
3130
3131                 do_facet $MDS $LCTL get_param -n \
3132                         osp.$mdtosc_proc.reserved_mb_high ||
3133                         skip  "remote MDS does not support reserved_mb_high"
3134         done
3135
3136         wms=$(ost_watermarks_set_low_space $ost_idx)
3137         local new_lwm=$(echo $wms | awk '{ print $4 }')
3138         fill_ost $filename $ost_idx $new_lwm
3139         #First enospc could execute orphan deletion so repeat
3140         fill_ost $filename $ost_idx $new_lwm
3141         echo $wms
3142 }
3143
3144 ost_watermarks_enospc_delete_files() {
3145         local filename=$1
3146         local ost_idx=$2
3147
3148         rm -f $DIR/${filename}.fill_ost$ost_idx
3149
3150         wait_delete_completed
3151         wait_mds_ost_sync
3152 }
3153
3154 # clean up from "ost_watermarks_set_enospc"
3155 ost_watermarks_clear_enospc() {
3156         local filename=$1
3157         local ost_idx=$2
3158         local old_lwm=$4
3159         local old_hwm=$5
3160
3161         ost_watermarks_enospc_delete_files $filename $ost_idx
3162         ost_watermarks_set $ost_idx $old_lwm $old_hwm
3163         echo "set OST$ost_idx lwm back to $old_lwm, hwm back to $old_hwm"
3164 }
3165
3166 wait_delete_completed_mds() {
3167         local max_wait=${1:-20}
3168         local mds2sync=""
3169         local stime=$(date +%s)
3170         local etime
3171         local node
3172         local changes
3173
3174         # find MDS with pending deletions
3175         for node in $(mdts_nodes); do
3176                 changes=$(do_node $node "$LCTL get_param -n osc.*MDT*.sync_*" \
3177                         2>/dev/null | calc_sum)
3178                 if [[ $changes -eq 0 ]]; then
3179                         continue
3180                 fi
3181                 mds2sync="$mds2sync $node"
3182         done
3183         if [ -z "$mds2sync" ]; then
3184                 wait_zfs_commit $SINGLEMDS
3185                 return 0
3186         fi
3187         mds2sync=$(comma_list $mds2sync)
3188
3189         # sync MDS transactions
3190         do_nodes $mds2sync "$LCTL set_param -n os[cd]*.*MD*.force_sync 1"
3191
3192         # wait till all changes are sent and commmitted by OSTs
3193         # for ldiskfs space is released upon execution, but DMU
3194         # do this upon commit
3195
3196         local WAIT=0
3197         while [[ $WAIT -ne $max_wait ]]; do
3198                 changes=$(do_nodes $mds2sync \
3199                         "$LCTL get_param -n osc.*MDT*.sync_*" | calc_sum)
3200                 #echo "$node: $changes changes on all"
3201                 if [[ $changes -eq 0 ]]; then
3202                         wait_zfs_commit $SINGLEMDS
3203
3204                         # the occupied disk space will be released
3205                         # only after TXGs are committed
3206                         wait_zfs_commit ost1
3207                         return 0
3208                 fi
3209                 sleep 1
3210                 WAIT=$((WAIT + 1))
3211         done
3212
3213         etime=$(date +%s)
3214         echo "Delete is not completed in $((etime - stime)) seconds"
3215         do_nodes $mds2sync "$LCTL get_param osc.*MDT*.sync_*"
3216         return 1
3217 }
3218
3219 wait_for_host() {
3220     local hostlist=$1
3221
3222     # we can use "for" here because we are waiting the slowest
3223     for host in ${hostlist//,/ }; do
3224         check_network "$host" 900
3225     done
3226     while ! do_nodes $hostlist hostname  > /dev/null; do sleep 5; done
3227 }
3228
3229 wait_for_facet() {
3230     local facetlist=$1
3231     local hostlist
3232
3233     for facet in ${facetlist//,/ }; do
3234         hostlist=$(expand_list $hostlist $(facet_active_host $facet))
3235     done
3236     wait_for_host $hostlist
3237 }
3238
3239 _wait_recovery_complete () {
3240     local param=$1
3241
3242     # Use default policy if $2 is not passed by caller.
3243     local MAX=${2:-$(max_recovery_time)}
3244
3245     local WAIT=0
3246     local STATUS=
3247
3248     while [ $WAIT -lt $MAX ]; do
3249         STATUS=$(lctl get_param -n $param | grep status)
3250         echo $param $STATUS
3251         [[ $STATUS = "status: COMPLETE" || $STATUS = "status: INACTIVE" ]] && return 0
3252         sleep 5
3253         WAIT=$((WAIT + 5))
3254         echo "Waiting $((MAX - WAIT)) secs for $param recovery done. $STATUS"
3255     done
3256     echo "$param recovery not done in $MAX sec. $STATUS"
3257     return 1
3258 }
3259
3260 wait_recovery_complete () {
3261     local facet=$1
3262
3263     # with an assumption that at_max is the same on all nodes
3264     local MAX=${2:-$(max_recovery_time)}
3265
3266     local facets=$facet
3267     if [ "$FAILURE_MODE" = HARD ]; then
3268         facets=$(facets_on_host $(facet_active_host $facet))
3269     fi
3270     echo affected facets: $facets
3271
3272         # we can use "for" here because we are waiting the slowest
3273         for facet in ${facets//,/ }; do
3274                 local var_svc=${facet}_svc
3275                 local param="*.${!var_svc}.recovery_status"
3276
3277                 local host=$(facet_active_host $facet)
3278                 do_rpc_nodes "$host" _wait_recovery_complete $param $MAX
3279         done
3280 }
3281
3282 wait_mds_ost_sync () {
3283         # just because recovery is done doesn't mean we've finished
3284         # orphan cleanup. Wait for llogs to get synchronized.
3285         echo "Waiting for orphan cleanup..."
3286         # MAX value includes time needed for MDS-OST reconnection
3287         local MAX=$(( TIMEOUT * 2 ))
3288         local WAIT_TIMEOUT=${1:-$MAX}
3289         local WAIT=0
3290         local new_wait=true
3291         local list=$(comma_list $(mdts_nodes))
3292         local cmd="$LCTL get_param -n osp.*osc*.old_sync_processed"
3293         if ! do_facet $SINGLEMDS \
3294                 "$LCTL list_param osp.*osc*.old_sync_processed 2> /dev/null"
3295         then
3296                 # old way, use mds_sync
3297                 new_wait=false
3298                 list=$(comma_list $(osts_nodes))
3299                 cmd="$LCTL get_param -n obdfilter.*.mds_sync"
3300         fi
3301
3302         echo "wait $WAIT_TIMEOUT secs maximumly for $list mds-ost sync done."
3303         while [ $WAIT -lt $WAIT_TIMEOUT ]; do
3304                 local -a sync=($(do_nodes $list "$cmd"))
3305                 local con=1
3306                 local i
3307                 for ((i=0; i<${#sync[@]}; i++)); do
3308                         if $new_wait; then
3309                                 [ ${sync[$i]} -eq 1 ] && continue
3310                         else
3311                                 [ ${sync[$i]} -eq 0 ] && continue
3312                         fi
3313                         # there is a not finished MDS-OST synchronization
3314                         con=0
3315                         break;
3316                 done
3317                 sleep 2 # increase waiting time and cover statfs cache
3318                 [ ${con} -eq 1 ] && return 0
3319                 echo "Waiting $WAIT secs for $list $i mds-ost sync done."
3320                 WAIT=$((WAIT + 2))
3321         done
3322
3323         # show which nodes are not finished.
3324         cmd=$(echo $cmd | sed 's/-n//')
3325         do_nodes $list "$cmd"
3326         echo "$facet recovery node $i not done in $WAIT_TIMEOUT sec. $STATUS"
3327         return 1
3328 }
3329
3330 # Wait OSTs to be active on both client and MDT side.
3331 wait_osts_up() {
3332         local cmd="$LCTL get_param -n lov.$FSNAME-clilov-*.target_obd |
3333                 awk 'BEGIN {c = 0} /ACTIVE/{c += 1} END {printf \\\"%d\\\", c}'"
3334         wait_update $HOSTNAME "eval $cmd" $OSTCOUNT ||
3335                 error "wait_update OSTs up on client failed"
3336
3337         cmd="$LCTL get_param osp.$FSNAME-OST*-MDT0000.prealloc_last_id |
3338              awk '/=[1-9][0-9]/ { c += 1 } END { printf \\\"%d\\\", c }'"
3339         wait_update_facet $SINGLEMDS "eval $cmd" $OSTCOUNT ||
3340                 error "wait_update OSTs up on MDT0000 failed"
3341 }
3342
3343 wait_destroy_complete () {
3344         echo "Waiting for local destroys to complete"
3345         # MAX value shouldn't be big as this mean server responsiveness
3346         # never increase this just to make test pass but investigate
3347         # why it takes so long time
3348         local MAX=5
3349         local WAIT=0
3350         while [ $WAIT -lt $MAX ]; do
3351                 local -a RPCs=($($LCTL get_param -n osc.*.destroys_in_flight))
3352                 local con=1
3353                 local i
3354
3355                 for ((i=0; i<${#RPCs[@]}; i++)); do
3356                         [ ${RPCs[$i]} -eq 0 ] && continue
3357                         # there are still some destroy RPCs in flight
3358                         con=0
3359                         break;
3360                 done
3361                 sleep 1
3362                 [ ${con} -eq 1 ] && return 0 # done waiting
3363                 echo "Waiting ${WAIT}s for local destroys to complete"
3364                 WAIT=$((WAIT + 1))
3365         done
3366         echo "Local destroys weren't done in $MAX sec."
3367         return 1
3368 }
3369
3370 wait_delete_completed() {
3371         wait_delete_completed_mds $1 || return $?
3372         wait_destroy_complete || return $?
3373 }
3374
3375 wait_exit_ST () {
3376     local facet=$1
3377
3378     local WAIT=0
3379     local INTERVAL=1
3380     local running
3381     # conf-sanity 31 takes a long time cleanup
3382     while [ $WAIT -lt 300 ]; do
3383         running=$(do_facet ${facet} "lsmod | grep lnet > /dev/null &&
3384 lctl dl | grep ' ST ' || true")
3385         [ -z "${running}" ] && return 0
3386         echo "waited $WAIT for${running}"
3387         [ $INTERVAL -lt 64 ] && INTERVAL=$((INTERVAL + INTERVAL))
3388         sleep $INTERVAL
3389         WAIT=$((WAIT + INTERVAL))
3390     done
3391     echo "service didn't stop after $WAIT seconds.  Still running:"
3392     echo ${running}
3393     return 1
3394 }
3395
3396 wait_remote_prog () {
3397    local prog=$1
3398    local WAIT=0
3399    local INTERVAL=5
3400    local rc=0
3401
3402    [ "$PDSH" = "no_dsh" ] && return 0
3403
3404    while [ $WAIT -lt $2 ]; do
3405         running=$(ps uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep) || true
3406         [ -z "${running}" ] && return 0 || true
3407         echo "waited $WAIT for: "
3408         echo "$running"
3409         [ $INTERVAL -lt 60 ] && INTERVAL=$((INTERVAL + INTERVAL))
3410         sleep $INTERVAL
3411         WAIT=$((WAIT + INTERVAL))
3412     done
3413     local pids=$(ps  uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep | awk '{print $2}')
3414     [ -z "$pids" ] && return 0
3415     echo "$PDSH processes still exists after $WAIT seconds.  Still running: $pids"
3416     # FIXME: not portable
3417     for pid in $pids; do
3418         cat /proc/${pid}/status || true
3419         cat /proc/${pid}/wchan || true
3420         echo "Killing $pid"
3421         kill -9 $pid || true
3422         sleep 1
3423         ps -P $pid && rc=1
3424     done
3425
3426     return $rc
3427 }
3428
3429 lfs_df_check() {
3430         local clients=${1:-$CLIENTS}
3431
3432         if [ -z "$clients" ]; then
3433                 $LFS df $MOUNT
3434         else
3435                 $PDSH $clients "$LFS df $MOUNT" > /dev/null
3436         fi
3437 }
3438
3439 clients_up() {
3440         # not every config has many clients
3441         sleep 1
3442         lfs_df_check
3443 }
3444
3445 client_up() {
3446         # usually checked on particular client or locally
3447         sleep 1
3448         lfs_df_check $1
3449 }
3450
3451 client_evicted() {
3452     ! client_up $1
3453 }
3454
3455 client_reconnect_try() {
3456         local f=$MOUNT/recon
3457
3458         uname -n >> $f
3459         if [ -z "$CLIENTS" ]; then
3460                 $LFS df $MOUNT; uname -n >> $f
3461         else
3462                 do_nodes $CLIENTS "$LFS df $MOUNT; uname -n >> $f" > /dev/null
3463         fi
3464         echo "Connected clients: $(cat $f)"
3465         ls -l $f > /dev/null
3466         rm $f
3467 }
3468
3469 client_reconnect() {
3470         # one client_reconnect_try call does not always do the job...
3471         while true ; do
3472                 client_reconnect_try && break
3473                 sleep 1
3474         done
3475 }
3476
3477 affected_facets () {
3478     local facet=$1
3479
3480     local host=$(facet_active_host $facet)
3481     local affected=$facet
3482
3483     if [ "$FAILURE_MODE" = HARD ]; then
3484         affected=$(facets_up_on_host $host)
3485     fi
3486     echo $affected
3487 }
3488
3489 facet_failover() {
3490         local E2FSCK_ON_MDT0=false
3491         if [ "$1" == "--fsck" ]; then
3492                 shift
3493                 [ $(facet_fstype $SINGLEMDS) == ldiskfs ] &&
3494                         E2FSCK_ON_MDT0=true
3495         fi
3496
3497         local facets=$1
3498         local sleep_time=$2
3499         local -a affecteds
3500         local facet
3501         local total=0
3502         local index=0
3503         local skip
3504
3505         #Because it will only get up facets, we need get affected
3506         #facets before shutdown
3507         #For HARD Failure mode, it needs make sure facets on the same
3508         #HOST will only be shutdown and reboot once
3509         for facet in ${facets//,/ }; do
3510                 local affected_facet
3511                 skip=0
3512                 #check whether facet has been included in other affected facets
3513                 for ((index=0; index<$total; index++)); do
3514                         [[ *,$facet,* == ,${affecteds[index]}, ]] && skip=1
3515                 done
3516
3517                 if [ $skip -eq 0 ]; then
3518                         affecteds[$total]=$(affected_facets $facet)
3519                         total=$((total+1))
3520                 fi
3521         done
3522
3523         for ((index=0; index<$total; index++)); do
3524                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3525                 local host=$(facet_active_host $facet)
3526                 echo "Failing ${affecteds[index]} on $host"
3527                 shutdown_facet $facet
3528         done
3529
3530         $E2FSCK_ON_MDT0 && (run_e2fsck $(facet_active_host $SINGLEMDS) \
3531                 $(mdsdevname 1) "-n" || error "Running e2fsck")
3532
3533         for ((index=0; index<$total; index++)); do
3534                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3535                 echo reboot facets: ${affecteds[index]}
3536
3537                 reboot_facet $facet
3538
3539                 change_active ${affecteds[index]}
3540
3541                 wait_for_facet ${affecteds[index]}
3542                 if $GSS_SK; then
3543                         init_gss
3544                         init_facets_vars_simple
3545                 fi
3546                 # start mgs first if it is affected
3547                 if ! combined_mgs_mds &&
3548                         list_member ${affecteds[index]} mgs; then
3549                         mount_facet mgs || error "Restart of mgs failed"
3550                 fi
3551                 # FIXME; has to be changed to mount all facets concurrently
3552                 affected=$(exclude_items_from_list ${affecteds[index]} mgs)
3553                 echo mount facets: ${affecteds[index]}
3554                 mount_facets ${affecteds[index]}
3555                 if $GSS_SK; then
3556                         do_nodes $(comma_list $(all_nodes)) \
3557                                 "keyctl show | grep lustre | cut -c1-11 |
3558                                 sed -e 's/ //g;' |
3559                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
3560                 fi
3561         done
3562 }
3563
3564 obd_name() {
3565     local facet=$1
3566 }
3567
3568 replay_barrier() {
3569         local facet=$1
3570         do_facet $facet "sync; sync; sync"
3571         $LFS df $MOUNT
3572
3573         # make sure there will be no seq change
3574         local clients=${CLIENTS:-$HOSTNAME}
3575         local f=fsa-\\\$\(hostname\)
3576         do_nodes $clients "mcreate $MOUNT/$f; rm $MOUNT/$f"
3577         do_nodes $clients "if [ -d $MOUNT2 ]; then mcreate $MOUNT2/$f; rm $MOUNT2/$f; fi"
3578
3579         local svc=${facet}_svc
3580         do_facet $facet $LCTL --device ${!svc} notransno
3581         #
3582         # If a ZFS OSD is made read-only here, its pool is "freezed". This
3583         # in-memory state has to be cleared by either rebooting the host or
3584         # exporting and reimporting the pool.
3585         #
3586         # Although the uberblocks are not updated when a pool is freezed,
3587         # transactions are still written to the disks. Modified blocks may be
3588         # cached in memory when tests try reading them back. The
3589         # export-and-reimport process also evicts any cached pool data from
3590         # memory to provide the correct "data loss" semantics.
3591         #
3592         # In the test framework, the exporting and importing operations are
3593         # handled by stop() and mount_facet() separately, which are used
3594         # inside fail() and fail_abort().
3595         #
3596         set_dev_readonly $facet
3597         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3598         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3599 }
3600
3601 replay_barrier_nodf() {
3602         local facet=$1    echo running=${running}
3603         do_facet $facet "sync; sync; sync"
3604         local svc=${facet}_svc
3605         echo Replay barrier on ${!svc}
3606         do_facet $facet $LCTL --device ${!svc} notransno
3607         set_dev_readonly $facet
3608         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3609         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3610 }
3611
3612 replay_barrier_nosync() {
3613         local facet=$1    echo running=${running}
3614         local svc=${facet}_svc
3615         echo Replay barrier on ${!svc}
3616         do_facet $facet $LCTL --device ${!svc} notransno
3617         set_dev_readonly $facet
3618         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3619         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3620 }
3621
3622 #
3623 # Get Lustre client uuid for a given Lustre mount point.
3624 #
3625 get_client_uuid() {
3626         local mntpnt=${1:-$MOUNT}
3627
3628         local name=$($LFS getname $mntpnt | cut -d' ' -f1)
3629         local uuid=$($LCTL get_param -n llite.$name.uuid)
3630
3631         echo -n $uuid
3632 }
3633
3634 mds_evict_client() {
3635         local mntpnt=${1:-$MOUNT}
3636         local uuid=$(get_client_uuid $mntpnt)
3637
3638         do_facet $SINGLEMDS \
3639                 "$LCTL set_param -n mdt.${mds1_svc}.evict_client $uuid"
3640 }
3641
3642 ost_evict_client() {
3643         local mntpnt=${1:-$MOUNT}
3644         local uuid=$(get_client_uuid $mntpnt)
3645
3646         do_facet ost1 \
3647                 "$LCTL set_param -n obdfilter.${ost1_svc}.evict_client $uuid"
3648 }
3649
3650 fail() {
3651         local facets=$1
3652         local clients=${CLIENTS:-$HOSTNAME}
3653
3654         SK_NO_KEY_save=$SK_NO_KEY
3655         if $GSS_SK; then
3656                 export SK_NO_KEY=false
3657         fi
3658         facet_failover $* || error "failover: $?"
3659         export SK_NO_KEY=$SK_NO_KEY_save
3660         # to initiate all OSC idling connections
3661         clients_up
3662         wait_clients_import_state "$clients" "$facets" "\(FULL\|IDLE\)"
3663         clients_up || error "post-failover stat: $?"
3664 }
3665
3666 fail_nodf() {
3667         local facet=$1
3668         facet_failover $facet
3669 }
3670
3671 fail_abort() {
3672         local facet=$1
3673         stop $facet
3674         change_active $facet
3675         wait_for_facet $facet
3676         mount_facet $facet -o abort_recovery
3677         clients_up || echo "first stat failed: $?"
3678         clients_up || error "post-failover stat: $?"
3679 }
3680
3681 host_nids_address() {
3682         local nodes=$1
3683         local net=${2:-"."}
3684
3685         do_nodes $nodes "$LCTL list_nids | grep $net | cut -f 1 -d @"
3686 }
3687
3688 h2name_or_ip() {
3689         if [ "$1" = "'*'" ]; then echo \'*\'; else
3690                 echo $1"@$2"
3691         fi
3692 }
3693
3694 h2nettype() {
3695         if [[ -n "$NETTYPE" ]]; then
3696                 h2name_or_ip "$1" "$NETTYPE"
3697         else
3698                 h2name_or_ip "$1" "$2"
3699         fi
3700 }
3701 declare -fx h2nettype
3702
3703 # Wrapper function to print the deprecation warning
3704 h2tcp() {
3705         echo "h2tcp: deprecated, use h2nettype instead" 1>&2
3706         if [[ -n "$NETTYPE" ]]; then
3707                 h2nettype "$@"
3708         else
3709                 h2nettype "$1" "tcp"
3710         fi
3711 }
3712
3713 # Wrapper function to print the deprecation warning
3714 h2o2ib() {
3715         echo "h2o2ib: deprecated, use h2nettype instead" 1>&2
3716         if [[ -n "$NETTYPE" ]]; then
3717                 h2nettype "$@"
3718         else
3719                 h2nettype "$1" "o2ib"
3720         fi
3721 }
3722
3723 # This enables variables in cfg/"setup".sh files to support the pdsh HOSTLIST
3724 # expressions format. As a bonus we can then just pass in those variables
3725 # to pdsh. What this function does is take a HOSTLIST type string and
3726 # expand it into a space deliminated list for us.
3727 hostlist_expand() {
3728     local hostlist=$1
3729     local offset=$2
3730     local myList
3731     local item
3732     local list
3733
3734     [ -z "$hostlist" ] && return
3735
3736     # Translate the case of [..],..,[..] to [..] .. [..]
3737     list="${hostlist/],/] }"
3738     front=${list%%[*}
3739     [[ "$front" == *,* ]] && {
3740         new="${list%,*} "
3741         old="${list%,*},"
3742         list=${list/${old}/${new}}
3743     }
3744
3745     for item in $list; do
3746         # Test if we have any []'s at all
3747         if [ "$item" != "${item/\[/}" ]; then {
3748             # Expand the [*] into list
3749             name=${item%%[*}
3750             back=${item#*]}
3751
3752             if [ "$name" != "$item" ]; then
3753                 group=${item#$name[*}
3754                 group=${group%%]*}
3755
3756                 for range in ${group//,/ }; do
3757                     local order
3758
3759                     begin=${range%-*}
3760                     end=${range#*-}
3761
3762                     # Number of leading zeros
3763                     padlen=${#begin}
3764                     padlen2=${#end}
3765                     end=$(echo $end | sed 's/0*//')
3766                     [[ -z "$end" ]] && end=0
3767                     [[ $padlen2 -gt $padlen ]] && {
3768                         [[ $padlen2 -eq ${#end} ]] && padlen2=0
3769                         padlen=$padlen2
3770                     }
3771                     begin=$(echo $begin | sed 's/0*//')
3772                     [ -z $begin ] && begin=0
3773
3774                     if [ ! -z "${begin##[!0-9]*}" ]; then
3775                         order=$(seq -f "%0${padlen}g" $begin $end)
3776                     else
3777                         order=$(eval echo {$begin..$end});
3778                     fi
3779
3780                     for num in $order; do
3781                         value="${name#*,}${num}${back}"
3782                         [ "$value" != "${value/\[/}" ] && {
3783                             value=$(hostlist_expand "$value")
3784                         }
3785                         myList="$myList $value"
3786                     done
3787                 done
3788             fi
3789         } else {
3790             myList="$myList $item"
3791         } fi
3792     done
3793     myList=${myList//,/ }
3794     myList=${myList:1} # Remove first character which is a space
3795
3796     # Filter any duplicates without sorting
3797     list="$myList "
3798     myList="${list%% *}"
3799
3800     while [[ "$list" != ${myList##* } ]]; do
3801         local tlist=" $list"
3802         list=${tlist// ${list%% *} / }
3803         list=${list:1}
3804         myList="$myList ${list%% *}"
3805     done
3806     myList="${myList%* }";
3807
3808     # We can select an object at an offset in the list
3809     [ $# -eq 2 ] && {
3810         cnt=0
3811         for item in $myList; do
3812             let cnt=cnt+1
3813             [ $cnt -eq $offset ] && {
3814                 myList=$item
3815             }
3816         done
3817         [ $(get_node_count $myList) -ne 1 ] && myList=""
3818     }
3819     echo $myList
3820 }
3821
3822 facet_host() {
3823         local facet=$1
3824         local varname
3825
3826         [ "$facet" == client ] && echo -n $HOSTNAME && return
3827         varname=${facet}_HOST
3828         if [ -z "${!varname}" ]; then
3829                 if [ "${facet:0:3}" == "ost" ]; then
3830                         local fh=${facet%failover}_HOST
3831                         eval export ${facet}_HOST=${!fh}
3832                         if [ -z "${!varname}" ]; then
3833                                 eval export ${facet}_HOST=${ost_HOST}
3834                         fi
3835                 elif [ "${facet:0:3}" == "mdt" -o \
3836                         "${facet:0:3}" == "mds" -o \
3837                         "${facet:0:3}" == "mgs" ]; then
3838                         eval export ${facet}_HOST=${mds_HOST}
3839                 fi
3840         fi
3841         echo -n ${!varname}
3842 }
3843
3844 facet_failover_host() {
3845         local facet=$1
3846         local varname
3847
3848         var=${facet}failover_HOST
3849         if [ -n "${!var}" ]; then
3850                 echo ${!var}
3851                 return
3852         fi
3853
3854         if [ "${facet:0:3}" == "mdt" -o "${facet:0:3}" == "mds" -o \
3855              "${facet:0:3}" == "mgs" ]; then
3856
3857                 eval export ${facet}failover_host=${mds_HOST}
3858                 echo ${mds_HOST}
3859                 return
3860         fi
3861
3862         if [[ $facet == ost* ]]; then
3863                 eval export ${facet}failover_host=${ost_HOST}
3864                 echo ${ost_HOST}
3865                 return
3866         fi
3867 }
3868
3869 facet_active() {
3870     local facet=$1
3871     local activevar=${facet}active
3872
3873     if [ -f $TMP/${facet}active ] ; then
3874         source $TMP/${facet}active
3875     fi
3876
3877     active=${!activevar}
3878     if [ -z "$active" ] ; then
3879         echo -n ${facet}
3880     else
3881         echo -n ${active}
3882     fi
3883 }
3884
3885 facet_active_host() {
3886         facet_host $(facet_active $1)
3887 }
3888
3889 # Get the passive failover partner host of facet.
3890 facet_passive_host() {
3891         local facet=$1
3892         [[ $facet = client ]] && return
3893
3894         local host=${facet}_HOST
3895         local failover_host=${facet}failover_HOST
3896         local active_host=$(facet_active_host $facet)
3897
3898         [[ -z ${!failover_host} || ${!failover_host} = ${!host} ]] && return
3899
3900         if [[ $active_host = ${!host} ]]; then
3901                 echo -n ${!failover_host}
3902         else
3903                 echo -n ${!host}
3904         fi
3905 }
3906
3907 change_active() {
3908     local facetlist=$1
3909     local facet
3910
3911     facetlist=$(exclude_items_from_list $facetlist mgs)
3912
3913     for facet in ${facetlist//,/ }; do
3914     local failover=${facet}failover
3915     local host=`facet_host $failover`
3916     [ -z "$host" ] && return
3917
3918     local curactive=`facet_active $facet`
3919     if [ -z "${curactive}" -o "$curactive" == "$failover" ] ; then
3920         eval export ${facet}active=$facet
3921     else
3922         eval export ${facet}active=$failover
3923     fi
3924     # save the active host for this facet
3925     local activevar=${facet}active
3926     echo "$activevar=${!activevar}" > $TMP/$activevar
3927     [[ $facet = mds1 ]] && combined_mgs_mds && \
3928         echo "mgsactive=${!activevar}" > $TMP/mgsactive
3929     local TO=`facet_active_host $facet`
3930     echo "Failover $facet to $TO"
3931     done
3932 }
3933
3934 do_node() {
3935     local verbose=false
3936     # do not stripe off hostname if verbose, bug 19215
3937     if [ x$1 = x--verbose ]; then
3938         shift
3939         verbose=true
3940     fi
3941
3942     local HOST=$1
3943     shift
3944     local myPDSH=$PDSH
3945     if [ "$HOST" = "$HOSTNAME" ]; then
3946         myPDSH="no_dsh"
3947     elif [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" ]; then
3948         echo "cannot run remote command on $HOST with $myPDSH"
3949         return 128
3950     fi
3951     if $VERBOSE; then
3952         echo "CMD: $HOST $@" >&2
3953         $myPDSH $HOST "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
3954     fi
3955
3956         if [[ "$myPDSH" == "rsh" ]] ||
3957            [[ "$myPDSH" == *pdsh* && "$myPDSH" != *-S* ]]; then
3958                 # we need this because rsh and pdsh do not return
3959                 # exit code of an executed command
3960                 local command_status="$TMP/cs"
3961                 eval $myPDSH $HOST ":> $command_status"
3962                 eval $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests;
3963                                      PATH=\$PATH:/sbin:/usr/sbin;
3964                                      cd $RPWD;
3965                                      LUSTRE=\"$RLUSTRE\" sh -c \"$@\") ||
3966                                      echo command failed >$command_status"
3967                 [[ -n "$($myPDSH $HOST cat $command_status)" ]] && return 1 ||
3968                         return 0
3969         fi
3970
3971     if $verbose ; then
3972         # print HOSTNAME for myPDSH="no_dsh"
3973         if [[ $myPDSH = no_dsh ]]; then
3974             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed -e "s/^/${HOSTNAME}: /"
3975         else
3976             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")"
3977         fi
3978     else
3979         $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed "s/^${HOST}: //"
3980     fi
3981     return ${PIPESTATUS[0]}
3982 }
3983
3984 do_nodev() {
3985     do_node --verbose "$@"
3986 }
3987
3988 single_local_node () {
3989    [ "$1" = "$HOSTNAME" ]
3990 }
3991
3992 # Outputs environment variable assignments that should be passed to remote nodes
3993 get_env_vars() {
3994         local var
3995         local value
3996         local facets=$(get_facets)
3997         local facet
3998
3999         for var in ${!MODOPTS_*}; do
4000                 value=${!var//\"/\\\"}
4001                 echo -n " ${var}=\"$value\""
4002         done
4003
4004         for facet in ${facets//,/ }; do
4005                 var=${facet}_FSTYPE
4006                 if [ -n "${!var}" ]; then
4007                         echo -n " $var=${!var}"
4008                 fi
4009         done
4010
4011         for var in MGSFSTYPE MDSFSTYPE OSTFSTYPE; do
4012                 if [ -n "${!var}" ]; then
4013                         echo -n " $var=${!var}"
4014                 fi
4015         done
4016
4017         for var in VERBOSE; do
4018                 if [ -n "${!var}" ]; then
4019                         echo -n " $var=${!var}"
4020                 fi
4021         done
4022
4023         if [ -n "$FSTYPE" ]; then
4024                 echo -n " FSTYPE=$FSTYPE"
4025         fi
4026
4027         for var in LNETLND NETTYPE; do
4028                 if [ -n "${!var}" ]; then
4029                         echo -n " $var=${!var}"
4030                 fi
4031         done
4032 }
4033
4034 do_nodes() {
4035     local verbose=false
4036     # do not stripe off hostname if verbose, bug 19215
4037     if [ x$1 = x--verbose ]; then
4038         shift
4039         verbose=true
4040     fi
4041
4042     local rnodes=$1
4043     shift
4044
4045     if single_local_node $rnodes; then
4046         if $verbose; then
4047            do_nodev $rnodes "$@"
4048         else
4049            do_node $rnodes "$@"
4050         fi
4051         return $?
4052     fi
4053
4054     # This is part from do_node
4055     local myPDSH=$PDSH
4056
4057     [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" -o "$myPDSH" = "rsh" ] && \
4058         echo "cannot run remote command on $rnodes with $myPDSH" && return 128
4059
4060     export FANOUT=$(get_node_count "${rnodes//,/ }")
4061     if $VERBOSE; then
4062         echo "CMD: $rnodes $@" >&2
4063         $myPDSH $rnodes "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
4064     fi
4065
4066     # do not replace anything from pdsh output if -N is used
4067     # -N     Disable hostname: prefix on lines of output.
4068     if $verbose || [[ $myPDSH = *-N* ]]; then
4069         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")"
4070     else
4071         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")" | sed -re "s/^[^:]*: //g"
4072     fi
4073     return ${PIPESTATUS[0]}
4074 }
4075
4076 ##
4077 # Execute commands on a single service's host
4078 #
4079 # The \a facet (service) may be on a local or remote node, which is
4080 # determined at the time the command is run.
4081 #
4082 # usage: do_facet $facet command [arg ...]
4083 do_facet() {
4084         local facet=$1
4085         shift
4086         local HOST=$(facet_active_host $facet)
4087         [ -z $HOST ] && echo "No host defined for facet ${facet}" && exit 1
4088         do_node $HOST "$@"
4089 }
4090
4091 # Function: do_facet_random_file $FACET $FILE $SIZE
4092 # Creates FILE with random content on the given FACET of given SIZE
4093
4094 do_facet_random_file() {
4095         local facet="$1"
4096         local fpath="$2"
4097         local fsize="$3"
4098         local cmd="dd if=/dev/urandom of='$fpath' bs=$fsize count=1"
4099         do_facet $facet "$cmd 2>/dev/null"
4100 }
4101
4102 do_facet_create_file() {
4103         local facet="$1"
4104         local fpath="$2"
4105         local fsize="$3"
4106         local cmd="dd if=/dev/zero of='$fpath' bs=$fsize count=1"
4107         do_facet $facet "$cmd 2>/dev/null"
4108 }
4109
4110 do_nodesv() {
4111     do_nodes --verbose "$@"
4112 }
4113
4114 add() {
4115         local facet=$1
4116         shift
4117         # make sure its not already running
4118         stop ${facet} -f
4119         rm -f $TMP/${facet}active
4120         [[ $facet = mds1 ]] && combined_mgs_mds && rm -f $TMP/mgsactive
4121         do_facet ${facet} $MKFS $* || return ${PIPESTATUS[0]}
4122
4123         if [[ $(facet_fstype $facet) == zfs ]]; then
4124                 #
4125                 # After formatting a ZFS target, "cachefile=none" property will
4126                 # be set on the ZFS storage pool so that the pool is not
4127                 # automatically imported on system startup. And then the pool
4128                 # will be exported so as to leave the importing and exporting
4129                 # operations handled by mount_facet() and stop() separately.
4130                 #
4131                 refresh_partition_table $facet $(facet_vdevice $facet)
4132                 disable_zpool_cache $facet
4133                 export_zpool $facet
4134         fi
4135 }
4136
4137 # Device formatted as ost
4138 ostdevname() {
4139         local num=$1
4140         local DEVNAME=OSTDEV$num
4141
4142         local fstype=$(facet_fstype ost$num)
4143
4144         case $fstype in
4145                 ldiskfs )
4146                         local dev=ost${num}_dev
4147                         [[ -n ${!dev} ]] && eval DEVPTR=${!dev} ||
4148                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
4149                         eval DEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
4150                 zfs )
4151                         #try $OSTZFSDEVn - independent of vdev
4152                         DEVNAME=OSTZFSDEV$num
4153                         eval DEVPTR=${!DEVNAME:=${FSNAME}-ost${num}/ost${num}};;
4154                 * )
4155                         error "unknown fstype!";;
4156         esac
4157
4158     echo -n $DEVPTR
4159 }
4160
4161 # Physical device location of data
4162 ostvdevname() {
4163         local num=$1
4164         local DEVNAME
4165         local VDEVPTR
4166
4167         local fstype=$(facet_fstype ost$num)
4168
4169         case $fstype in
4170                 ldiskfs )
4171                         # vdevs are not supported by ldiskfs
4172                         eval VDEVPTR="";;
4173                 zfs )
4174                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE{n}
4175                         # Device formatted by zfs
4176                         DEVNAME=OSTDEV$num
4177                         eval VDEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
4178                 * )
4179                         error "unknown fstype!";;
4180         esac
4181
4182         echo -n $VDEVPTR
4183 }
4184
4185 # Logical device formatted for lustre
4186 mdsdevname() {
4187         local num=$1
4188         local DEVNAME=MDSDEV$num
4189
4190         local fstype=$(facet_fstype mds$num)
4191
4192         case $fstype in
4193                 ldiskfs )
4194                         local dev=mds${num}_dev
4195                         [[ -n ${!dev} ]] && eval DEVPTR=${!dev} ||
4196                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE{n}
4197                         eval DEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
4198                 zfs )
4199                         # try $MDSZFSDEVn - independent of vdev
4200                         DEVNAME=MDSZFSDEV$num
4201                         eval DEVPTR=${!DEVNAME:=${FSNAME}-mdt${num}/mdt${num}};;
4202                 * )
4203                         error "unknown fstype!";;
4204         esac
4205
4206         echo -n $DEVPTR
4207 }
4208
4209 # Physical location of data
4210 mdsvdevname() {
4211         local VDEVPTR=""
4212         local num=$1
4213         local fstype=$(facet_fstype mds$num)
4214
4215         case $fstype in
4216                 ldiskfs )
4217                         # vdevs are not supported by ldiskfs
4218                         eval VDEVPTR="";;
4219                 zfs )
4220                         # if $MDSDEVn isn't defined, default is $MDSDEVBASE{n}
4221                         # Device formatted by ZFS
4222                         local DEVNAME=MDSDEV$num
4223                         eval VDEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
4224                 * )
4225                         error "unknown fstype!";;
4226         esac
4227
4228         echo -n $VDEVPTR
4229 }
4230
4231 mgsdevname() {
4232         local DEVPTR
4233         local fstype=$(facet_fstype mgs)
4234
4235         case $fstype in
4236         ldiskfs )
4237                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4238                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $MDSDEV1 ] ); then
4239                         DEVPTR=$(mdsdevname 1)
4240                 else
4241                         [[ -n $mgs_dev ]] && DEVPTR=$mgs_dev ||
4242                         DEVPTR=$MGSDEV
4243                 fi;;
4244         zfs )
4245                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4246                     ( [ -z "$MGSZFSDEV" ] &&
4247                         [ -z "$MGSDEV" -o "$MGSDEV" = $(mdsvdevname 1) ] ); then
4248                         DEVPTR=$(mdsdevname 1)
4249                 else
4250                         DEVPTR=${MGSZFSDEV:-${FSNAME}-mgs/mgs}
4251                 fi;;
4252         * )
4253                 error "unknown fstype!";;
4254         esac
4255
4256         echo -n $DEVPTR
4257 }
4258
4259 mgsvdevname() {
4260         local VDEVPTR=""
4261
4262         local fstype=$(facet_fstype mgs)
4263
4264         case $fstype in
4265         ldiskfs )
4266                 # vdevs are not supported by ldiskfs
4267                 ;;
4268         zfs )
4269                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4270                    ( [ -z "$MGSDEV" ] &&
4271                        [ -z "$MGSZFSDEV" -o "$MGSZFSDEV" = $(mdsdevname 1) ]); then
4272                         VDEVPTR=$(mdsvdevname 1)
4273                 elif [ -n "$MGSDEV" ]; then
4274                         VDEVPTR=$MGSDEV
4275                 fi;;
4276         * )
4277                 error "unknown fstype!";;
4278         esac
4279
4280         echo -n $VDEVPTR
4281 }
4282
4283 facet_mntpt () {
4284     local facet=$1
4285     [[ $facet = mgs ]] && combined_mgs_mds && facet="mds1"
4286
4287     local var=${facet}_MOUNT
4288     eval mntpt=${!var:-${MOUNT}-$facet}
4289
4290     echo -n $mntpt
4291 }
4292
4293 mount_ldiskfs() {
4294         local facet=$1
4295         local dev=$(facet_device $facet)
4296         local mnt=${2:-$(facet_mntpt $facet)}
4297         local opts
4298         local dm_dev=$dev
4299
4300         if dm_flakey_supported $facet; then
4301                 dm_dev=$(dm_create_dev $facet $dev)
4302                 [[ -n "$dm_dev" ]] || dm_dev=$dev
4303         fi
4304         is_blkdev $facet $dm_dev || opts=$(csa_add "$opts" -o loop)
4305         export_dm_dev $facet $dm_dev
4306
4307         do_facet $facet mount -t ldiskfs $opts $dm_dev $mnt
4308 }
4309
4310 unmount_ldiskfs() {
4311         local facet=$1
4312         local dev=$(facet_device $facet)
4313         local mnt=${2:-$(facet_mntpt $facet)}
4314
4315         do_facet $facet $UMOUNT $mnt
4316 }
4317
4318 var_name() {
4319         echo -n "$1" | tr -c '[:alnum:]\n' '_'
4320 }
4321
4322 mount_zfs() {
4323         local facet=$1
4324         local ds=$(facet_device $facet)
4325         local mnt=${2:-$(facet_mntpt $facet)}
4326         local canmnt
4327         local mntpt
4328
4329         import_zpool $facet
4330         canmnt=$(do_facet $facet $ZFS get -H -o value canmount $ds)
4331         mntpt=$(do_facet $facet $ZFS get -H -o value mountpoint $ds)
4332         do_facet $facet $ZFS set canmount=noauto $ds
4333         #
4334         # The "legacy" mount method is used here because "zfs unmount $mnt"
4335         # calls stat(2) on $mnt/../*, which may include $MOUNT.  If certain
4336         # targets are not available at the time, the stat(2) on $MOUNT will
4337         # hang.
4338         #
4339         do_facet $facet $ZFS set mountpoint=legacy $ds
4340         do_facet $facet mount -t zfs $ds $mnt
4341         eval export mz_$(var_name ${facet}_$ds)_canmount=$canmnt
4342         eval export mz_$(var_name ${facet}_$ds)_mountpoint=$mntpt
4343 }
4344
4345 unmount_zfs() {
4346         local facet=$1
4347         local ds=$(facet_device $facet)
4348         local mnt=${2:-$(facet_mntpt $facet)}
4349         local var_mntpt=mz_$(var_name ${facet}_$ds)_mountpoint
4350         local var_canmnt=mz_$(var_name ${facet}_$ds)_canmount
4351         local mntpt=${!var_mntpt}
4352         local canmnt=${!var_canmnt}
4353
4354         unset $var_mntpt
4355         unset $var_canmnt
4356         do_facet $facet umount $mnt
4357         do_facet $facet $ZFS set mountpoint=$mntpt $ds
4358         do_facet $facet $ZFS set canmount=$canmnt $ds
4359         export_zpool $facet
4360 }
4361
4362 mount_fstype() {
4363         local facet=$1
4364         local mnt=$2
4365         local fstype=$(facet_fstype $facet)
4366
4367         mount_$fstype $facet $mnt
4368 }
4369
4370 unmount_fstype() {
4371         local facet=$1
4372         local mnt=$2
4373         local fstype=$(facet_fstype $facet)
4374
4375         unmount_$fstype $facet $mnt
4376 }
4377
4378 ########
4379 ## MountConf setup
4380
4381 stopall() {
4382         # make sure we are using the primary server, so test-framework will
4383         # be able to clean up properly.
4384         activemds=`facet_active mds1`
4385         if [ $activemds != "mds1" ]; then
4386                 fail mds1
4387         fi
4388
4389         local clients=$CLIENTS
4390         [ -z $clients ] && clients=$(hostname)
4391
4392         zconf_umount_clients $clients $MOUNT "$*" || true
4393         [ -n "$MOUNT2" ] && zconf_umount_clients $clients $MOUNT2 "$*" || true
4394
4395         [ -n "$CLIENTONLY" ] && return
4396
4397         # The add fn does rm ${facet}active file, this would be enough
4398         # if we use do_facet <facet> only after the facet added, but
4399         # currently we use do_facet mds in local.sh
4400         for num in `seq $MDSCOUNT`; do
4401                 stop mds$num -f
4402                 rm -f ${TMP}/mds${num}active
4403         done
4404         combined_mgs_mds && rm -f $TMP/mgsactive
4405
4406         for num in `seq $OSTCOUNT`; do
4407                 stop ost$num -f
4408                 rm -f $TMP/ost${num}active
4409         done
4410
4411         if ! combined_mgs_mds ; then
4412                 stop mgs
4413         fi
4414
4415         if $SHARED_KEY; then
4416                 export SK_MOUNTED=false
4417         fi
4418
4419         return 0
4420 }
4421
4422 cleanup_echo_devs () {
4423         trap 0
4424         local dev
4425         local devs=$($LCTL dl | grep echo | awk '{print $4}')
4426
4427         for dev in $devs; do
4428                 $LCTL --device $dev cleanup
4429                 $LCTL --device $dev detach
4430         done
4431 }
4432
4433 cleanupall() {
4434         nfs_client_mode && return
4435         cifs_client_mode && return
4436
4437         cleanup_echo_devs
4438         CLEANUP_DM_DEV=true stopall $*
4439
4440         unload_modules
4441         cleanup_sk
4442         cleanup_gss
4443 }
4444
4445 combined_mgs_mds () {
4446         [[ "$(mdsdevname 1)" = "$(mgsdevname)" ]] &&
4447                 [[ "$(facet_host mds1)" = "$(facet_host mgs)" ]]
4448 }
4449
4450 lower() {
4451         echo -n "$1" | tr '[:upper:]' '[:lower:]'
4452 }
4453
4454 upper() {
4455         echo -n "$1" | tr '[:lower:]' '[:upper:]'
4456 }
4457
4458 squash_opt() {
4459         local var="$*"
4460         local other=""
4461         local opt_o=""
4462         local opt_e=""
4463         local first_e=0
4464         local first_o=0
4465         local take=""
4466
4467         var=$(echo "$var" | sed -e 's/,\( \)*/,/g')
4468         for i in $(echo "$var"); do
4469                 if [ "$i" == "-O" ]; then
4470                         take="o";
4471                         first_o=$(($first_o + 1))
4472                         continue;
4473                 fi
4474                 if [ "$i" == "-E" ]; then
4475                         take="e";
4476                         first_e=$(($first_e + 1 ))
4477                         continue;
4478                 fi
4479                 case $take in
4480                         "o")
4481                                 [ $first_o -gt 1 ] && opt_o+=",";
4482                                 opt_o+="$i";
4483                                 ;;
4484                         "e")
4485                                 [ $first_e -gt 1 ] && opt_e+=",";
4486                                 opt_e+="$i";
4487                                 ;;
4488                         *)
4489                                 other+=" $i";
4490                                 ;;
4491                 esac
4492                 take=""
4493         done
4494
4495         echo -n "$other"
4496         [ -n "$opt_o" ] && echo " -O $opt_o"
4497         [ -n "$opt_e" ] && echo " -E $opt_e"
4498 }
4499
4500 mkfs_opts() {
4501         local facet=$1
4502         local dev=$2
4503         local fsname=${3:-"$FSNAME"}
4504         local type=$(facet_type $facet)
4505         local index=$(facet_index $facet)
4506         local fstype=$(facet_fstype $facet)
4507         local host=$(facet_host $facet)
4508         local opts
4509         local fs_mkfs_opts
4510         local var
4511
4512         if [ $type == MGS ] || ( [ $type == MDS ] &&
4513                                  [ "$dev" == $(mgsdevname) ] &&
4514                                  [ "$host" == "$(facet_host mgs)" ] ); then
4515                 opts="--mgs"
4516         else
4517                 opts="--mgsnode=$MGSNID"
4518         fi
4519
4520         if [ $type != MGS ]; then
4521                 opts+=" --fsname=$fsname --$(lower ${type/MDS/MDT}) \
4522                         --index=$index"
4523         fi
4524
4525         var=${facet}failover_HOST
4526         if [ -n "${!var}" ] && [ ${!var} != $(facet_host $facet) ]; then
4527                 opts+=" --failnode=$(h2nettype ${!var})"
4528         fi
4529
4530         opts+=${TIMEOUT:+" --param=sys.timeout=$TIMEOUT"}
4531         opts+=${LDLM_TIMEOUT:+" --param=sys.ldlm_timeout=$LDLM_TIMEOUT"}
4532
4533         if [ $type == MDS ]; then
4534                 opts+=${MDSCAPA:+" --param-mdt.capa=$MDSCAPA"}
4535                 opts+=${DEF_STRIPE_SIZE:+" --param=lov.stripesize=$DEF_STRIPE_SIZE"}
4536                 opts+=${DEF_STRIPE_COUNT:+" --param=lov.stripecount=$DEF_STRIPE_COUNT"}
4537                 opts+=${L_GETIDENTITY:+" --param=mdt.identity_upcall=$L_GETIDENTITY"}
4538
4539                 if [ $fstype == ldiskfs ]; then
4540                         fs_mkfs_opts+="-O ea_inode,large_dir"
4541
4542                         var=${facet}_JRN
4543                         if [ -n "${!var}" ]; then
4544                                 fs_mkfs_opts+=" -J device=${!var}"
4545                         else
4546                                 fs_mkfs_opts+=${MDSJOURNALSIZE:+" -J size=$MDSJOURNALSIZE"}
4547                         fi
4548                         fs_mkfs_opts+=${MDSISIZE:+" -i $MDSISIZE"}
4549                 fi
4550         fi
4551
4552         if [ $type == OST ]; then
4553                 opts+=${OSSCAPA:+" --param=ost.capa=$OSSCAPA"}
4554
4555                 if [ $fstype == ldiskfs ]; then
4556                         var=${facet}_JRN
4557                         if [ -n "${!var}" ]; then
4558                                 fs_mkfs_opts+=" -J device=${!var}"
4559                         else
4560                                 fs_mkfs_opts+=${OSTJOURNALSIZE:+" -J size=$OSTJOURNALSIZE"}
4561                         fi
4562                 fi
4563         fi
4564
4565         opts+=" --backfstype=$fstype"
4566
4567         var=${type}SIZE
4568         if [ -n "${!var}" ]; then
4569                 opts+=" --device-size=${!var}"
4570         fi
4571
4572         var=$(upper $fstype)_MKFS_OPTS
4573         fs_mkfs_opts+=${!var:+" ${!var}"}
4574
4575         var=${type}_FS_MKFS_OPTS
4576         fs_mkfs_opts+=${!var:+" ${!var}"}
4577
4578         [ $fstype == ldiskfs ] && fs_mkfs_opts=$(squash_opt $fs_mkfs_opts)
4579
4580         if [ -n "${fs_mkfs_opts## }" ]; then
4581                 opts+=" --mkfsoptions=\\\"${fs_mkfs_opts## }\\\""
4582         fi
4583
4584         var=${type}OPT
4585         opts+=${!var:+" ${!var}"}
4586
4587         echo -n "$opts"
4588 }
4589
4590 mountfs_opts() {
4591         local facet=$1
4592         local type=$(facet_type $facet)
4593         local var=${type}_MOUNT_FS_OPTS
4594         local opts=""
4595         if [ -n "${!var}" ]; then
4596                 opts+=" --mountfsoptions=${!var}"
4597         fi
4598         echo -n "$opts"
4599 }
4600
4601 check_ost_indices() {
4602         local index_count=${#OST_INDICES[@]}
4603         [[ $index_count -eq 0 || $OSTCOUNT -le $index_count ]] && return 0
4604
4605         # OST count is greater than the index count in $OST_INDEX_LIST.
4606         # We need check whether there are duplicate indices.
4607         local i
4608         local j
4609         local index
4610         for i in $(seq $((index_count + 1)) $OSTCOUNT); do
4611                 index=$(facet_index ost$i)
4612                 for j in $(seq 0 $((index_count - 1))); do
4613                         [[ $index -ne ${OST_INDICES[j]} ]] ||
4614                         error "ost$i has the same index $index as ost$((j+1))"
4615                 done
4616         done
4617 }
4618
4619 __touch_device()
4620 {
4621         local facet_type=$1 # mgs || mds || ost
4622         local facet_num=$2
4623         local facet=${1}${2}
4624         local device
4625
4626         case "$(facet_fstype $facet)" in
4627         ldiskfs)
4628                 device=$(${facet_type}devname $facet_num)
4629                 ;;
4630         zfs)
4631                 device=$(${facet_type}vdevname $facet_num)
4632                 ;;
4633         *)
4634                 error "Unhandled filesystem type"
4635                 ;;
4636         esac
4637
4638         do_facet $facet "[ -e \"$device\" ]" && return
4639
4640         # Note: the following check only works with absolute paths
4641         [[ ! "$device" =~ ^/dev/ ]] || [[ "$device" =~ ^/dev/shm/ ]] ||
4642                 error "$facet: device '$device' does not exist"
4643
4644         # zpool create doesn't like empty files
4645         [[ $(facet_fstype $facet) == zfs ]] && return 0
4646
4647         do_facet $facet "touch \"${device}\""
4648 }
4649
4650 format_mgs() {
4651         local quiet
4652
4653         if ! $VERBOSE; then
4654                 quiet=yes
4655         fi
4656         echo "Format mgs: $(mgsdevname)"
4657         reformat_external_journal mgs
4658
4659         # touch "device" in case it is a loopback file for testing and needs to
4660         # be created. mkfs.lustre doesn't do this to avoid accidentally writing
4661         # to non-existent files in /dev if the admin made a typo during setup
4662         __touch_device mgs
4663
4664         add mgs $(mkfs_opts mgs $(mgsdevname)) $(mountfs_opts mgs) --reformat \
4665                 $(mgsdevname) $(mgsvdevname) ${quiet:+>/dev/null} || exit 10
4666 }
4667
4668 format_mdt() {
4669         local num=$1
4670         local quiet
4671
4672         if ! $VERBOSE; then
4673                 quiet=yes
4674         fi
4675         echo "Format mds$num: $(mdsdevname $num)"
4676         reformat_external_journal mds$num
4677
4678         __touch_device mds $num
4679
4680         add mds$num $(mkfs_opts mds$num $(mdsdevname ${num})) \
4681                 $(mountfs_opts mds$num) --reformat $(mdsdevname $num) \
4682                 $(mdsvdevname $num) ${quiet:+>/dev/null} || exit 10
4683 }
4684
4685 format_ost() {
4686         local num=$1
4687
4688         if ! $VERBOSE; then
4689                 quiet=yes
4690         fi
4691         echo "Format ost$num: $(ostdevname $num)"
4692         reformat_external_journal ost$num
4693
4694         __touch_device ost $num
4695
4696         add ost$num $(mkfs_opts ost$num $(ostdevname ${num})) \
4697                 $(mountfs_opts ost$num) --reformat $(ostdevname $num) \
4698                 $(ostvdevname ${num}) ${quiet:+>/dev/null} || exit 10
4699 }
4700
4701 formatall() {
4702         stopall -f
4703         # Set hostid for ZFS/SPL zpool import protection
4704         # (Assumes MDS version is also OSS version)
4705         if [ $(lustre_version_code $SINGLEMDS) -ge $(version_code 2.8.54) ];
4706         then
4707                 do_rpc_nodes "$(comma_list $(all_server_nodes))" set_hostid
4708         fi
4709
4710         # We need ldiskfs here, may as well load them all
4711         load_modules
4712         [ -n "$CLIENTONLY" ] && return
4713         echo Formatting mgs, mds, osts
4714         if ! combined_mgs_mds ; then
4715                 format_mgs
4716         fi
4717
4718         for num in $(seq $MDSCOUNT); do
4719                 format_mdt $num
4720         done
4721
4722         export OST_INDICES=($(hostlist_expand "$OST_INDEX_LIST"))
4723         check_ost_indices
4724         for num in $(seq $OSTCOUNT); do
4725                 format_ost $num
4726         done
4727 }
4728
4729 mount_client() {
4730         grep " $1 " /proc/mounts || zconf_mount $HOSTNAME $*
4731 }
4732
4733 umount_client() {
4734         grep " $1 " /proc/mounts && zconf_umount $HOSTNAME $*
4735 }
4736
4737 # return value:
4738 # 0: success, the old identity set already.
4739 # 1: success, the old identity does not set.
4740 # 2: fail.
4741 switch_identity() {
4742     local num=$1
4743     local switch=$2
4744     local j=`expr $num - 1`
4745     local MDT="`(do_facet mds$num lctl get_param -N mdt.*MDT*$j 2>/dev/null | cut -d"." -f2 2>/dev/null) || true`"
4746
4747     if [ -z "$MDT" ]; then
4748         return 2
4749     fi
4750
4751     local old="`do_facet mds$num "lctl get_param -n mdt.$MDT.identity_upcall"`"
4752
4753     if $switch; then
4754         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"$L_GETIDENTITY\""
4755     else
4756         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"NONE\""
4757     fi
4758
4759     do_facet mds$num "lctl set_param -n mdt/$MDT/identity_flush=-1"
4760
4761     if [ $old = "NONE" ]; then
4762         return 1
4763     else
4764         return 0
4765     fi
4766 }
4767
4768 remount_client()
4769 {
4770         zconf_umount $HOSTNAME $1 || error "umount failed"
4771         zconf_mount $HOSTNAME $1 || error "mount failed"
4772 }
4773
4774 writeconf_facet() {
4775         local facet=$1
4776         local dev=$2
4777
4778         stop ${facet} -f
4779         rm -f $TMP/${facet}active
4780         do_facet ${facet} "$TUNEFS --quiet --writeconf $dev" || return 1
4781         return 0
4782 }
4783
4784 writeconf_all () {
4785         local mdt_count=${1:-$MDSCOUNT}
4786         local ost_count=${2:-$OSTCOUNT}
4787         local rc=0
4788
4789         for num in $(seq $mdt_count); do
4790                 DEVNAME=$(mdsdevname $num)
4791                 writeconf_facet mds$num $DEVNAME || rc=$?
4792         done
4793
4794         for num in $(seq $ost_count); do
4795                 DEVNAME=$(ostdevname $num)
4796                 writeconf_facet ost$num $DEVNAME || rc=$?
4797         done
4798         return $rc
4799 }
4800
4801 mountmgs() {
4802         if ! combined_mgs_mds ; then
4803                 start mgs $(mgsdevname) $MGS_MOUNT_OPTS
4804         fi
4805 }
4806
4807 mountmds() {
4808         local num
4809         local devname
4810         local host
4811         local varname
4812         for num in $(seq $MDSCOUNT); do
4813                 devname=$(mdsdevname $num)
4814                 start mds$num $devname $MDS_MOUNT_OPTS
4815
4816                 # We started mds$num, now we should set mds${num}_HOST
4817                 # and mds${num}failover_HOST variables properly if they
4818                 # are not set.
4819                 host=$(facet_host mds$num)
4820                 for varname in mds${num}_HOST mds${num}failover_HOST; do
4821                         if [[ -z "${!varname}" ]]; then
4822                                 eval $varname=$host
4823                         fi
4824                 done
4825                 if [ $IDENTITY_UPCALL != "default" ]; then
4826                         switch_identity $num $IDENTITY_UPCALL
4827                 fi
4828         done
4829 }
4830
4831 mountoss() {
4832         local num
4833         local devname
4834         local host
4835         local varname
4836         for num in $(seq $OSTCOUNT); do
4837                 devname=$(ostdevname $num)
4838                 start ost$num $devname $OST_MOUNT_OPTS
4839
4840                 # We started ost$num, now we should set ost${num}_HOST
4841                 # and ost${num}failover_HOST variables properly if they
4842                 # are not set.
4843                 host=$(facet_host ost$num)
4844                 for varname in ost${num}_HOST ost${num}failover_HOST; do
4845                         if [[ -z "${!varname}" ]]; then
4846                                 eval $varname=$host
4847                         fi
4848                 done
4849         done
4850 }
4851
4852 mountcli() {
4853         [ "$DAEMONFILE" ] && $LCTL debug_daemon start $DAEMONFILE $DAEMONSIZE
4854         if [ ! -z $arg1 ]; then
4855                 [ "$arg1" = "server_only" ] && return
4856         fi
4857         mount_client $MOUNT
4858         if [ -n "$CLIENTS" ]; then
4859                 zconf_mount_clients $CLIENTS $MOUNT
4860         fi
4861         clients_up
4862
4863         if [ "$MOUNT_2" ]; then
4864                 mount_client $MOUNT2
4865                 if [ -n "$CLIENTS" ]; then
4866                         zconf_mount_clients $CLIENTS $MOUNT2
4867                 fi
4868         fi
4869 }
4870
4871 sk_nodemap_setup() {
4872         local sk_map_name=${1:-$SK_S2SNM}
4873         local sk_map_nodes=${2:-$HOSTNAME}
4874         do_node $(mgs_node) "$LCTL nodemap_add $sk_map_name"
4875         for servernode in $sk_map_nodes; do
4876                 local nids=$(do_nodes $servernode "$LCTL list_nids")
4877                 for nid in $nids; do
4878                         do_node $(mgs_node) "$LCTL nodemap_add_range --name \
4879                                 $sk_map_name --range $nid"
4880                 done
4881         done
4882 }
4883
4884 setupall() {
4885         local arg1=$1
4886
4887         nfs_client_mode && return
4888         cifs_client_mode && return
4889
4890         sanity_mount_check || error "environments are insane!"
4891
4892         load_modules
4893
4894         init_gss
4895
4896         if [ -z "$CLIENTONLY" ]; then
4897                 echo Setup mgs, mdt, osts
4898                 echo $WRITECONF | grep -q "writeconf" && writeconf_all
4899
4900                 if $SK_MOUNTED; then
4901                         echo "Shared Key file system already mounted"
4902                 else
4903                         mountmgs
4904                         mountmds
4905                         mountoss
4906                         if $SHARED_KEY; then
4907                                 export SK_MOUNTED=true
4908                         fi
4909                 fi
4910                 if $GSS_SK; then
4911                         echo "GSS_SK: setting kernel keyring perms"
4912                         do_nodes $(comma_list $(all_nodes)) \
4913                                 "keyctl show | grep lustre | cut -c1-11 |
4914                                 sed -e 's/ //g;' |
4915                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
4916
4917                         if $SK_S2S; then
4918                                 # Need to start one nodemap for servers,
4919                                 # and one for clients.
4920                                 sk_nodemap_setup $SK_S2SNM \
4921                                         $(comma_list $(all_server_nodes))
4922                                 mountcli
4923                                 sk_nodemap_setup $SK_S2SNMCLI \
4924                                         ${CLIENTS:-$HOSTNAME}
4925                                 echo "Nodemap set up for SK S2S, remounting."
4926                                 stopall
4927                                 mountmgs
4928                                 mountmds
4929                                 mountoss
4930                         fi
4931                 fi
4932         fi
4933
4934         # wait a while to allow sptlrpc configuration be propogated to targets,
4935         # only needed when mounting new target devices.
4936         if $GSS; then
4937                 sleep 10
4938         fi
4939
4940         mountcli
4941         init_param_vars
4942
4943         # by remounting mdt before ost, initial connect from mdt to ost might
4944         # timeout because ost is not ready yet. wait some time to its fully
4945         # recovery. initial obd_connect timeout is 5s; in GSS case it's
4946         # preceeded by a context negotiation rpc with $TIMEOUT.
4947         # FIXME better by monitoring import status.
4948         if $GSS; then
4949                 if $GSS_SK; then
4950                         set_rule $FSNAME any cli2mdt $SK_FLAVOR
4951                         set_rule $FSNAME any cli2ost $SK_FLAVOR
4952                         if $SK_SKIPFIRST; then
4953                                 export SK_SKIPFIRST=false
4954
4955                                 sleep 30
4956                                 do_nodes $CLIENTS \
4957                                          "lctl set_param osc.*.idle_connect=1"
4958                                 return
4959                         else
4960                                 wait_flavor cli2mdt $SK_FLAVOR
4961                                 wait_flavor cli2ost $SK_FLAVOR
4962                         fi
4963                 else
4964                         set_flavor_all $SEC
4965                 fi
4966                 sleep $((TIMEOUT + 5))
4967         else
4968                 sleep 5
4969         fi
4970 }
4971
4972 mounted_lustre_filesystems() {
4973         awk '($3 ~ "lustre" && $1 ~ ":") { print $2 }' /proc/mounts
4974 }
4975
4976 init_facet_vars () {
4977         [ -n "$CLIENTONLY" ] && return 0
4978         local facet=$1
4979         shift
4980         local device=$1
4981
4982         shift
4983
4984         eval export ${facet}_dev=${device}
4985         eval export ${facet}_opt=\"$@\"
4986
4987         local dev=${facet}_dev
4988
4989         # We need to loop for the label
4990         # in case its not initialized yet.
4991         for wait_time in {0,1,3,5,10}; do
4992
4993                 if [ $wait_time -gt 0 ]; then
4994                         echo "${!dev} not yet initialized,"\
4995                                 "waiting ${wait_time} seconds."
4996                         sleep $wait_time
4997                 fi
4998
4999                 local label=$(devicelabel ${facet} ${!dev})
5000
5001                 # Check to make sure the label does
5002                 # not include ffff at the end of the label.
5003                 # This indicates it has not been initialized yet.
5004
5005                 if [[ $label =~ [f|F]{4}$ ]]; then
5006                         # label is not initialized, unset the result
5007                         # and either try again or fail
5008                         unset label
5009                 else
5010                         break
5011                 fi
5012         done
5013
5014         [ -z "$label" ] && echo no label for ${!dev} && exit 1
5015
5016         eval export ${facet}_svc=${label}
5017
5018         local varname=${facet}failover_HOST
5019         if [ -z "${!varname}" ]; then
5020                 eval export $varname=$(facet_host $facet)
5021         fi
5022
5023         varname=${facet}_HOST
5024         if [ -z "${!varname}" ]; then
5025                 eval export $varname=$(facet_host $facet)
5026         fi
5027
5028         # ${facet}failover_dev is set in cfg file
5029         varname=${facet}failover_dev
5030         if [ -n "${!varname}" ] ; then
5031                 eval export ${facet}failover_dev=${!varname}
5032         else
5033                 eval export ${facet}failover_dev=$device
5034         fi
5035
5036         # get mount point of already mounted device
5037         # is facet_dev is already mounted then use the real
5038         #  mount point of this facet; otherwise use $(facet_mntpt $facet)
5039         # i.e. ${facet}_MOUNT if specified by user or default
5040         local mntpt=$(do_facet ${facet} cat /proc/mounts | \
5041                         awk '"'${!dev}'" == $1 && $3 == "lustre" { print $2 }')
5042         if [ -z $mntpt ]; then
5043                 mntpt=$(facet_mntpt $facet)
5044         fi
5045         eval export ${facet}_MOUNT=$mntpt
5046 }
5047
5048 init_facets_vars () {
5049         local DEVNAME
5050
5051         if ! remote_mds_nodsh; then
5052                 for num in $(seq $MDSCOUNT); do
5053                         DEVNAME=`mdsdevname $num`
5054                         init_facet_vars mds$num $DEVNAME $MDS_MOUNT_OPTS
5055                 done
5056         fi
5057
5058         combined_mgs_mds || init_facet_vars mgs $(mgsdevname) $MGS_MOUNT_OPTS
5059
5060         if ! remote_ost_nodsh; then
5061                 for num in $(seq $OSTCOUNT); do
5062                         DEVNAME=$(ostdevname $num)
5063                         init_facet_vars ost$num $DEVNAME $OST_MOUNT_OPTS
5064                 done
5065         fi
5066 }
5067
5068 init_facets_vars_simple () {
5069         local devname
5070
5071         if ! remote_mds_nodsh; then
5072                 for num in $(seq $MDSCOUNT); do
5073                         devname=$(mdsdevname $num)
5074                         eval export mds${num}_dev=${devname}
5075                         eval export mds${num}_opt=\"${MDS_MOUNT_OPTS}\"
5076                 done
5077         fi
5078
5079         if ! combined_mgs_mds ; then
5080                 eval export mgs_dev=$(mgsdevname)
5081                 eval export mgs_opt=\"${MGS_MOUNT_OPTS}\"
5082         fi
5083
5084         if ! remote_ost_nodsh; then
5085                 for num in $(seq $OSTCOUNT); do
5086                         devname=$(ostdevname $num)
5087                         eval export ost${num}_dev=${devname}
5088                         eval export ost${num}_opt=\"${OST_MOUNT_OPTS}\"
5089                 done
5090         fi
5091 }
5092
5093 osc_ensure_active () {
5094     local facet=$1
5095     local timeout=$2
5096     local period=0
5097
5098     while [ $period -lt $timeout ]; do
5099         count=$(do_facet $facet "lctl dl | grep ' IN osc ' 2>/dev/null | wc -l")
5100         if [ $count -eq 0 ]; then
5101             break
5102         fi
5103
5104         echo "There are $count OST are inactive, wait $period seconds, and try again"
5105         sleep 3
5106         period=$((period+3))
5107     done
5108
5109     [ $period -lt $timeout ] || log "$count OST are inactive after $timeout seconds, give up"
5110 }
5111
5112 set_conf_param_and_check() {
5113         local myfacet=$1
5114         local TEST=$2
5115         local PARAM=$3
5116         local ORIG=$(do_facet $myfacet "$TEST")
5117         if [ $# -gt 3 ]; then
5118                 local FINAL=$4
5119         else
5120                 local -i FINAL
5121                 FINAL=$((ORIG + 5))
5122         fi
5123         echo "Setting $PARAM from $ORIG to $FINAL"
5124         do_facet mgs "$LCTL conf_param $PARAM='$FINAL'" ||
5125                 error "conf_param $PARAM failed"
5126
5127         wait_update_facet $myfacet "$TEST" "$FINAL" ||
5128                 error "check $PARAM failed!"
5129 }
5130
5131 set_persistent_param() {
5132         local myfacet=$1
5133         local test_param=$2
5134         local param=$3
5135         local orig=$(do_facet $myfacet "$LCTL get_param -n $test_param")
5136
5137         if [ $# -gt 3 ]; then
5138                 local final=$4
5139         else
5140                 local -i final
5141                 final=$((orig + 5))
5142         fi
5143
5144         if [[ $PERM_CMD == *"set_param -P"* ]]; then
5145                 echo "Setting $test_param from $orig to $final"
5146                 do_facet mgs "$PERM_CMD $test_param='$final'" ||
5147                         error "$PERM_CMD $test_param failed"
5148         else
5149                 echo "Setting $param from $orig to $final"
5150                 do_facet mgs "$PERM_CMD $param='$final'" ||
5151                         error "$PERM_CMD $param failed"
5152         fi
5153 }
5154
5155 set_persistent_param_and_check() {
5156         local myfacet=$1
5157         local test_param=$2
5158         local param=$3
5159         local orig=$(do_facet $myfacet "$LCTL get_param -n $test_param")
5160
5161         if [ $# -gt 3 ]; then
5162                 local final=$4
5163         else
5164                 local -i final
5165                 final=$((orig + 5))
5166         fi
5167
5168         set_persistent_param $myfacet $test_param $param "$final"
5169
5170         wait_update_facet $myfacet "$LCTL get_param -n $test_param" "$final" ||
5171                 error "check $param failed!"
5172 }
5173
5174 init_param_vars () {
5175         TIMEOUT=$(lctl get_param -n timeout)
5176         TIMEOUT=${TIMEOUT:-20}
5177
5178         if [ -n "$arg1" ]; then
5179                 [ "$arg1" = "server_only" ] && return
5180         fi
5181
5182         remote_mds_nodsh && log "Using TIMEOUT=$TIMEOUT" && return 0
5183
5184         TIMEOUT=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
5185         log "Using TIMEOUT=$TIMEOUT"
5186
5187         osc_ensure_active $SINGLEMDS $TIMEOUT
5188         osc_ensure_active client $TIMEOUT
5189         $LCTL set_param osc.*.idle_timeout=debug
5190
5191         if [ -n "$(lctl get_param -n mdc.*.connect_flags|grep jobstats)" ]; then
5192                 local current_jobid_var=$($LCTL get_param -n jobid_var)
5193
5194                 if [ $JOBID_VAR = "existing" ]; then
5195                         echo "keeping jobstats as $current_jobid_var"
5196                 elif [ $current_jobid_var != $JOBID_VAR ]; then
5197                         echo "setting jobstats to $JOBID_VAR"
5198
5199                         set_persistent_param_and_check client \
5200                                 "jobid_var" "$FSNAME.sys.jobid_var" $JOBID_VAR
5201                 fi
5202         else
5203                 echo "jobstats not supported by server"
5204         fi
5205
5206         if [ $QUOTA_AUTO -ne 0 ]; then
5207                 if [ "$ENABLE_QUOTA" ]; then
5208                         echo "enable quota as required"
5209                         setup_quota $MOUNT || return 2
5210                 else
5211                         echo "disable quota as required"
5212                         # $LFS quotaoff -ug $MOUNT > /dev/null 2>&1
5213                 fi
5214         fi
5215
5216         do_nodes $(comma_list $(mdts_nodes)) \
5217                 "$LCTL set_param lod.*.mdt_hash=crush"
5218         return 0
5219 }
5220
5221 nfs_client_mode () {
5222     if [ "$NFSCLIENT" ]; then
5223         echo "NFSCLIENT mode: setup, cleanup, check config skipped"
5224         local clients=$CLIENTS
5225         [ -z $clients ] && clients=$(hostname)
5226
5227         # FIXME: remove hostname when 19215 fixed
5228         do_nodes $clients "echo \\\$(hostname); grep ' '$MOUNT' ' /proc/mounts"
5229         declare -a nfsexport=(`grep ' '$MOUNT' ' /proc/mounts | awk '{print $1}' | awk -F: '{print $1 " "  $2}'`)
5230         if [[ ${#nfsexport[@]} -eq 0 ]]; then
5231                 error_exit NFSCLIENT=$NFSCLIENT mode, but no NFS export found!
5232         fi
5233         do_nodes ${nfsexport[0]} "echo \\\$(hostname); df -T  ${nfsexport[1]}"
5234         return
5235     fi
5236     return 1
5237 }
5238
5239 cifs_client_mode () {
5240         [ x$CIFSCLIENT = xyes ] &&
5241                 echo "CIFSCLIENT=$CIFSCLIENT mode: setup, cleanup, check config skipped"
5242 }
5243
5244 check_config_client () {
5245     local mntpt=$1
5246
5247     local mounted=$(mount | grep " $mntpt ")
5248     if [ -n "$CLIENTONLY" ]; then
5249         # bug 18021
5250         # CLIENTONLY should not depend on *_HOST settings
5251         local mgc=$($LCTL device_list | awk '/MGC/ {print $4}')
5252         # in theory someone could create a new,
5253         # client-only config file that assumed lustre was already
5254         # configured and didn't set the MGSNID. If MGSNID is not set,
5255         # then we should use the mgs nid currently being used
5256         # as the default value. bug 18021
5257         [[ x$MGSNID = x ]] &&
5258             MGSNID=${mgc//MGC/}
5259
5260         if [[ x$mgc != xMGC$MGSNID ]]; then
5261             if [ "$mgs_HOST" ]; then
5262                 local mgc_ip=$(ping -q -c1 -w1 $mgs_HOST | grep PING | awk '{print $3}' | sed -e "s/(//g" -e "s/)//g")
5263 #                [[ x$mgc = xMGC$mgc_ip@$NETTYPE ]] ||
5264 #                    error_exit "MGSNID=$MGSNID, mounted: $mounted, MGC : $mgc"
5265             fi
5266         fi
5267         return 0
5268     fi
5269
5270     echo Checking config lustre mounted on $mntpt
5271     local mgshost=$(mount | grep " $mntpt " | awk -F@ '{print $1}')
5272     mgshost=$(echo $mgshost | awk -F: '{print $1}')
5273
5274 }
5275
5276 check_config_clients () {
5277         local clients=${CLIENTS:-$HOSTNAME}
5278         local mntpt=$1
5279
5280         nfs_client_mode && return
5281         cifs_client_mode && return
5282
5283         do_rpc_nodes "$clients" check_config_client $mntpt
5284
5285         sanity_mount_check || error "environments are insane!"
5286 }
5287
5288 check_timeout () {
5289     local mdstimeout=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
5290     local cltimeout=$(lctl get_param -n timeout)
5291     if [ $mdstimeout -ne $TIMEOUT ] || [ $mdstimeout -ne $cltimeout ]; then
5292         error "timeouts are wrong! mds: $mdstimeout, client: $cltimeout, TIMEOUT=$TIMEOUT"
5293         return 1
5294     fi
5295 }
5296
5297 is_mounted () {
5298         local mntpt=$1
5299         [ -z $mntpt ] && return 1
5300         local mounted=$(mounted_lustre_filesystems)
5301
5302         echo $mounted' ' | grep -w -q $mntpt' '
5303 }
5304
5305 is_empty_dir() {
5306         [ $(find $1 -maxdepth 1 -print | wc -l) = 1 ] && return 0
5307         return 1
5308 }
5309
5310 # empty lustre filesystem may have empty directories lost+found and .lustre
5311 is_empty_fs() {
5312         # exclude .lustre & lost+found
5313         [ $(find $1 -maxdepth 1 -name lost+found -o -name .lustre -prune -o \
5314                 -print | wc -l) = 1 ] || return 1
5315         [ ! -d $1/lost+found ] || is_empty_dir $1/lost+found || return 1
5316         if [ $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.4.0) ]; then
5317                 # exclude .lustre/fid (LU-2780)
5318                 [ $(find $1/.lustre -maxdepth 1 -name fid -prune -o \
5319                         -print | wc -l) = 1 ] || return 1
5320         else
5321                 [ ! -d $1/.lustre ] || is_empty_dir $1/.lustre || return 1
5322         fi
5323         return 0
5324 }
5325
5326 check_and_setup_lustre() {
5327         sanitize_parameters
5328         nfs_client_mode && return
5329         cifs_client_mode && return
5330
5331         local MOUNTED=$(mounted_lustre_filesystems)
5332
5333         local do_check=true
5334         # 1.
5335         # both MOUNT and MOUNT2 are not mounted
5336         if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
5337                 [ "$REFORMAT" = "yes" ] && CLEANUP_DM_DEV=true formatall
5338                 # setupall mounts both MOUNT and MOUNT2 (if MOUNT_2 is set)
5339                 setupall
5340                 is_mounted $MOUNT || error "NAME=$NAME not mounted"
5341                 export I_MOUNTED=yes
5342                 do_check=false
5343     # 2.
5344     # MOUNT2 is mounted
5345     elif is_mounted $MOUNT2; then
5346             # 3.
5347             # MOUNT2 is mounted, while MOUNT_2 is not set
5348             if ! [ "$MOUNT_2" ]; then
5349                 cleanup_mount $MOUNT2
5350                 export I_UMOUNTED2=yes
5351
5352             # 4.
5353             # MOUNT2 is mounted, MOUNT_2 is set
5354             else
5355                 # FIXME: what to do if check_config failed?
5356                 # i.e. if:
5357                 # 1) remote client has mounted other Lustre fs ?
5358                 # 2) it has insane env ?
5359                 # let's try umount MOUNT2 on all clients and mount it again:
5360                 if ! check_config_clients $MOUNT2; then
5361                     cleanup_mount $MOUNT2
5362                     restore_mount $MOUNT2
5363                     export I_MOUNTED2=yes
5364                 fi
5365             fi
5366
5367     # 5.
5368     # MOUNT is mounted MOUNT2 is not mounted
5369     elif [ "$MOUNT_2" ]; then
5370         restore_mount $MOUNT2
5371         export I_MOUNTED2=yes
5372     fi
5373
5374     if $do_check; then
5375         # FIXME: what to do if check_config failed?
5376         # i.e. if:
5377         # 1) remote client has mounted other Lustre fs?
5378         # 2) lustre is mounted on remote_clients atall ?
5379         check_config_clients $MOUNT
5380         init_facets_vars
5381         init_param_vars
5382
5383         set_default_debug_nodes $(comma_list $(nodes_list))
5384     fi
5385
5386         if [ -z "$CLIENTONLY" -a $(lower $OSD_TRACK_DECLARES_LBUG) == 'yes' ]; then
5387                 local facets=""
5388                 [ "$(facet_fstype ost1)" = "ldiskfs" ] &&
5389                         facets="$(get_facets OST)"
5390                 [ "$(facet_fstype mds1)" = "ldiskfs" ] &&
5391                         facets="$facets,$(get_facets MDS)"
5392                 [ "$(facet_fstype mgs)" = "ldiskfs" ] &&
5393                         facets="$facets,mgs"
5394                 local nodes="$(facets_hosts ${facets})"
5395                 if [ -n "$nodes" ] ; then
5396                         do_nodes $nodes "$LCTL set_param \
5397                                  osd-ldiskfs.track_declares_assert=1 || true"
5398                 fi
5399         fi
5400
5401         if [ -n "$fs_STRIPEPARAMS" ]; then
5402                 setstripe_getstripe $MOUNT $fs_STRIPEPARAMS
5403         fi
5404         if $GSS_SK; then
5405                 set_flavor_all null
5406         elif $GSS; then
5407                 set_flavor_all $SEC
5408         fi
5409
5410         if [ "$ONLY" == "setup" ]; then
5411                 exit 0
5412         fi
5413 }
5414
5415 restore_mount () {
5416    local clients=${CLIENTS:-$HOSTNAME}
5417    local mntpt=$1
5418
5419    zconf_mount_clients $clients $mntpt
5420 }
5421
5422 cleanup_mount () {
5423         local clients=${CLIENTS:-$HOSTNAME}
5424         local mntpt=$1
5425
5426         zconf_umount_clients $clients $mntpt
5427 }
5428
5429 cleanup_and_setup_lustre() {
5430     if [ "$ONLY" == "cleanup" -o "`mount | grep $MOUNT`" ]; then
5431         lctl set_param debug=0 || true
5432         cleanupall
5433         if [ "$ONLY" == "cleanup" ]; then
5434             exit 0
5435         fi
5436     fi
5437     check_and_setup_lustre
5438 }
5439
5440 # Get all of the server target devices from a given server node and type.
5441 get_mnt_devs() {
5442         local node=$1
5443         local type=$2
5444         local devs
5445         local dev
5446
5447         if [ "$type" == ost ]; then
5448                 devs=$(get_osd_param $node "" mntdev)
5449         else
5450                 devs=$(do_node $node $LCTL get_param -n osd-*.$FSNAME-M*.mntdev)
5451         fi
5452         for dev in $devs; do
5453                 case $dev in
5454                 *loop*) do_node $node "losetup $dev" | \
5455                                 sed -e "s/.*(//" -e "s/).*//" ;;
5456                 *) echo $dev ;;
5457                 esac
5458         done
5459 }
5460
5461 # Get all of the server target devices.
5462 get_svr_devs() {
5463         local node
5464         local i
5465
5466         # Master MDS parameters used by lfsck
5467         MDTNODE=$(facet_active_host $SINGLEMDS)
5468         MDTDEV=$(echo $(get_mnt_devs $MDTNODE mdt) | awk '{print $1}')
5469
5470         # MDT devices
5471         i=0
5472         for node in $(mdts_nodes); do
5473                 MDTDEVS[i]=$(get_mnt_devs $node mdt)
5474                 i=$((i + 1))
5475         done
5476
5477         # OST devices
5478         i=0
5479         for node in $(osts_nodes); do
5480                 OSTDEVS[i]=$(get_mnt_devs $node ost)
5481                 i=$((i + 1))
5482         done
5483 }
5484
5485 # Run e2fsck on MDT or OST device.
5486 run_e2fsck() {
5487         local node=$1
5488         local target_dev=$2
5489         local extra_opts=$3
5490         local cmd="$E2FSCK -d -v -t -t -f $extra_opts $target_dev"
5491         local log=$TMP/e2fsck.log
5492         local rc=0
5493
5494         echo $cmd
5495         do_node $node $cmd 2>&1 | tee $log
5496         rc=${PIPESTATUS[0]}
5497         if [ -n "$(grep "DNE mode isn't supported" $log)" ]; then
5498                 rm -f $log
5499                 if [ $MDSCOUNT -gt 1 ]; then
5500                         skip_noexit "DNE mode isn't supported!"
5501                         cleanupall
5502                         exit_status
5503                 else
5504                         error "It's not DNE mode."
5505                 fi
5506         fi
5507         rm -f $log
5508
5509         [ $rc -le $FSCK_MAX_ERR ] ||
5510                 error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
5511
5512         return 0
5513 }
5514
5515 #
5516 # Run resize2fs on MDT or OST device.
5517 #
5518 run_resize2fs() {
5519         local facet=$1
5520         local device=$2
5521         local size=$3
5522         shift 3
5523         local opts="$@"
5524
5525         do_facet $facet "$RESIZE2FS $opts $device $size"
5526 }
5527
5528 # verify a directory is shared among nodes.
5529 check_shared_dir() {
5530         local dir=$1
5531         local list=${2:-$(comma_list $(nodes_list))}
5532
5533         [ -z "$dir" ] && return 1
5534         do_rpc_nodes "$list" check_logdir $dir
5535         check_write_access $dir "$list" || return 1
5536         return 0
5537 }
5538
5539 run_lfsck() {
5540         do_nodes $(comma_list $(mdts_nodes) $(osts_nodes)) \
5541                 $LCTL set_param printk=+lfsck
5542         do_facet $SINGLEMDS "$LCTL lfsck_start -M $FSNAME-MDT0000 -r -A -t all"
5543
5544         for k in $(seq $MDSCOUNT); do
5545                 # wait up to 10+1 minutes for LFSCK to complete
5546                 wait_update_facet --verbose mds${k} "$LCTL get_param -n \
5547                         mdd.$(facet_svc mds${k}).lfsck_layout |
5548                         awk '/^status/ { print \\\$2 }'" "completed" 600 ||
5549                         error "MDS${k} layout isn't the expected 'completed'"
5550                 wait_update_facet --verbose mds${k} "$LCTL get_param -n \
5551                         mdd.$(facet_svc mds${k}).lfsck_namespace |
5552                         awk '/^status/ { print \\\$2 }'" "completed" 60 ||
5553                         error "MDS${k} namespace isn't the expected 'completed'"
5554         done
5555         local rep_mdt=$(do_nodes $(comma_list $(mdts_nodes)) \
5556                         $LCTL get_param -n mdd.$FSNAME-*.lfsck_* |
5557                         awk '/repaired/ { print $2 }' | calc_sum)
5558         local rep_ost=$(do_nodes $(comma_list $(osts_nodes)) \
5559                         $LCTL get_param -n obdfilter.$FSNAME-*.lfsck_* |
5560                         awk '/repaired/ { print $2 }' | calc_sum)
5561         local repaired=$((rep_mdt + rep_ost))
5562         [ $repaired -eq 0 ] ||
5563                 error "lfsck repaired $rep_mdt MDT and $rep_ost OST errors"
5564 }
5565
5566 dump_file_contents() {
5567         local nodes=$1
5568         local dir=$2
5569         local logname=$3
5570         local node
5571
5572         if [ -z "$nodes" -o -z "$dir" -o -z "$logname" ]; then
5573                 error_noexit false \
5574                         "Invalid parameters for dump_file_contents()"
5575                 return 1
5576         fi
5577         for node in ${nodes}; do
5578                 do_node $node "for i in \\\$(find $dir -type f); do
5579                                 echo ====\\\${i}=======================;
5580                                 cat \\\${i};
5581                                 done" >> ${logname}.${node}.log
5582         done
5583 }
5584
5585 dump_command_output() {
5586         local nodes=$1
5587         local cmd=$2
5588         local logname=$3
5589         local node
5590
5591         if [ -z "$nodes" -o -z "$cmd" -o -z "$logname" ]; then
5592                 error_noexit false \
5593                         "Invalid parameters for dump_command_output()"
5594                 return 1
5595         fi
5596
5597         for node in ${nodes}; do
5598                 do_node $node "echo ====${cmd}=======================;
5599                                 $cmd" >> ${logname}.${node}.log
5600         done
5601 }
5602
5603 log_zfs_info() {
5604         local logname=$1
5605
5606         # dump file contents from /proc/spl in case of zfs test
5607         if [ "$(facet_fstype ost1)" = "zfs" ]; then
5608                 dump_file_contents "$(osts_nodes)" "/proc/spl" "${logname}"
5609                 dump_command_output \
5610                         "$(osts_nodes)" "zpool events -v" "${logname}"
5611         fi
5612
5613         if [ "$(facet_fstype $SINGLEMDS)" = "zfs" ]; then
5614                 dump_file_contents "$(mdts_nodes)" "/proc/spl" "${logname}"
5615                 dump_command_output \
5616                         "$(mdts_nodes)" "zpool events -v" "${logname}"
5617         fi
5618 }
5619
5620 check_and_cleanup_lustre() {
5621         if [ "$LFSCK_ALWAYS" = "yes" -a "$TESTSUITE" != "sanity-lfsck" -a \
5622              "$TESTSUITE" != "sanity-scrub" ]; then
5623                 run_lfsck
5624         fi
5625
5626         if is_mounted $MOUNT; then
5627                 if $DO_CLEANUP; then
5628                         [ -n "$DIR" ] && rm -rf $DIR/[Rdfs][0-9]* ||
5629                                 error "remove sub-test dirs failed"
5630                 else
5631                         echo "skip cleanup"
5632                 fi
5633                 [ "$ENABLE_QUOTA" ] && restore_quota || true
5634         fi
5635
5636         if [ "$I_UMOUNTED2" = "yes" ]; then
5637                 restore_mount $MOUNT2 || error "restore $MOUNT2 failed"
5638         fi
5639
5640         if [ "$I_MOUNTED2" = "yes" ]; then
5641                 cleanup_mount $MOUNT2
5642         fi
5643
5644         if [[ "$I_MOUNTED" = "yes" ]] && ! $AUSTER_CLEANUP; then
5645                 cleanupall -f || error "cleanup failed"
5646                 unset I_MOUNTED
5647         fi
5648 }
5649
5650 #######
5651 # General functions
5652
5653 wait_for_function () {
5654     local quiet=""
5655
5656     # suppress fn both stderr and stdout
5657     if [ "$1" = "--quiet" ]; then
5658         shift
5659         quiet=" > /dev/null 2>&1"
5660
5661     fi
5662
5663     local fn=$1
5664     local max=${2:-900}
5665     local sleep=${3:-5}
5666
5667     local wait=0
5668
5669     while true; do
5670
5671         eval $fn $quiet && return 0
5672
5673         wait=$((wait + sleep))
5674         [ $wait -lt $max ] || return 1
5675         echo waiting $fn, $((max - wait)) secs left ...
5676         sleep $sleep
5677     done
5678 }
5679
5680 check_network() {
5681         local host=$1
5682         local max=$2
5683         local sleep=${3:-5}
5684
5685         [ "$host" = "$HOSTNAME" ] && return 0
5686
5687         echo "$(date +'%H:%M:%S (%s)') waiting for $host network $max secs ..."
5688         if ! wait_for_function --quiet "ping -c 1 -w 3 $host" $max $sleep ; then
5689                 echo "Network not available!"
5690                 exit 1
5691         fi
5692
5693         echo "$(date +'%H:%M:%S (%s)') network interface is UP"
5694 }
5695
5696 no_dsh() {
5697     shift
5698     eval $@
5699 }
5700
5701 # Convert a space-delimited list to a comma-delimited list.  If the input is
5702 # only whitespace, ensure the output is empty (i.e. "") so [ -n $list ] works
5703 comma_list() {
5704         # echo is used to convert newlines to spaces, since it doesn't
5705         # introduce a trailing space as using "tr '\n' ' '" does
5706         echo $(tr -s " " "\n" <<< $* | sort -b -u) | tr ' ' ','
5707 }
5708
5709 list_member () {
5710     local list=$1
5711     local item=$2
5712     echo $list | grep -qw $item
5713 }
5714
5715 # list, excluded are the comma separated lists
5716 exclude_items_from_list () {
5717     local list=$1
5718     local excluded=$2
5719     local item
5720
5721     list=${list//,/ }
5722     for item in ${excluded//,/ }; do
5723         list=$(echo " $list " | sed -re "s/\s+$item\s+/ /g")
5724     done
5725     echo $(comma_list $list)
5726 }
5727
5728 # list, expand  are the comma separated lists
5729 expand_list () {
5730     local list=${1//,/ }
5731     local expand=${2//,/ }
5732     local expanded=
5733
5734     expanded=$(for i in $list $expand; do echo $i; done | sort -u)
5735     echo $(comma_list $expanded)
5736 }
5737
5738 testslist_filter () {
5739     local script=$LUSTRE/tests/${TESTSUITE}.sh
5740
5741     [ -f $script ] || return 0
5742
5743     local start_at=$START_AT
5744     local stop_at=$STOP_AT
5745
5746     local var=${TESTSUITE//-/_}_START_AT
5747     [ x"${!var}" != x ] && start_at=${!var}
5748     var=${TESTSUITE//-/_}_STOP_AT
5749     [ x"${!var}" != x ] && stop_at=${!var}
5750
5751     sed -n 's/^test_\([^ (]*\).*/\1/p' $script | \
5752         awk ' BEGIN { if ("'${start_at:-0}'" != 0) flag = 1 }
5753             /^'${start_at}'$/ {flag = 0}
5754             {if (flag == 1) print $0}
5755             /^'${stop_at}'$/ { flag = 1 }'
5756 }
5757
5758 absolute_path() {
5759     (cd `dirname $1`; echo $PWD/`basename $1`)
5760 }
5761
5762 get_facets () {
5763     local types=${1:-"OST MDS MGS"}
5764
5765     local list=""
5766
5767     for entry in $types; do
5768         local name=$(echo $entry | tr "[:upper:]" "[:lower:]")
5769         local type=$(echo $entry | tr "[:lower:]" "[:upper:]")
5770
5771         case $type in
5772                 MGS ) list="$list $name";;
5773             MDS|OST|AGT ) local count=${type}COUNT
5774                        for ((i=1; i<=${!count}; i++)) do
5775                           list="$list ${name}$i"
5776                       done;;
5777                   * ) error "Invalid facet type"
5778                  exit 1;;
5779         esac
5780     done
5781     echo $(comma_list $list)
5782 }
5783
5784 ##################################
5785 # Adaptive Timeouts funcs
5786
5787 at_is_enabled() {
5788     # only check mds, we assume at_max is the same on all nodes
5789     local at_max=$(do_facet $SINGLEMDS "lctl get_param -n at_max")
5790     if [ $at_max -eq 0 ]; then
5791         return 1
5792     else
5793         return 0
5794     fi
5795 }
5796
5797 at_get() {
5798     local facet=$1
5799     local at=$2
5800
5801     # suppose that all ost-s have the same $at value set
5802     [ $facet != "ost" ] || facet=ost1
5803
5804     do_facet $facet "lctl get_param -n $at"
5805 }
5806
5807 at_max_get() {
5808     at_get $1 at_max
5809 }
5810
5811 at_min_get() {
5812         at_get $1 at_min
5813 }
5814
5815 at_max_set() {
5816     local at_max=$1
5817     shift
5818
5819     local facet
5820     local hosts
5821     for facet in $@; do
5822         if [ $facet == "ost" ]; then
5823             facet=$(get_facets OST)
5824         elif [ $facet == "mds" ]; then
5825             facet=$(get_facets MDS)
5826         fi
5827         hosts=$(expand_list $hosts $(facets_hosts $facet))
5828     done
5829
5830     do_nodes $hosts lctl set_param at_max=$at_max
5831 }
5832
5833 ##################################
5834 # OBD_FAIL funcs
5835
5836 drop_request() {
5837 # OBD_FAIL_MDS_ALL_REQUEST_NET
5838     RC=0
5839     do_facet $SINGLEMDS lctl set_param fail_val=0 fail_loc=0x123
5840     do_facet client "$1" || RC=$?
5841     do_facet $SINGLEMDS lctl set_param fail_loc=0
5842     return $RC
5843 }
5844
5845 drop_reply() {
5846 # OBD_FAIL_MDS_ALL_REPLY_NET
5847         RC=0
5848         do_facet $SINGLEMDS $LCTL set_param fail_loc=0x122
5849         eval "$@" || RC=$?
5850         do_facet $SINGLEMDS $LCTL set_param fail_loc=0
5851         return $RC
5852 }
5853
5854 drop_reint_reply() {
5855 # OBD_FAIL_MDS_REINT_NET_REP
5856         RC=0
5857         do_facet $SINGLEMDS $LCTL set_param fail_loc=0x119
5858         eval "$@" || RC=$?
5859         do_facet $SINGLEMDS $LCTL set_param fail_loc=0
5860         return $RC
5861 }
5862
5863 drop_update_reply() {
5864 # OBD_FAIL_OUT_UPDATE_NET_REP
5865         local index=$1
5866         shift 1
5867         RC=0
5868         do_facet mds${index} lctl set_param fail_loc=0x1701
5869         do_facet client "$@" || RC=$?
5870         do_facet mds${index} lctl set_param fail_loc=0
5871         return $RC
5872 }
5873
5874 pause_bulk() {
5875 #define OBD_FAIL_OST_BRW_PAUSE_BULK      0x214
5876         RC=0
5877
5878         local timeout=${2:-0}
5879         # default is (obd_timeout / 4) if unspecified
5880         echo "timeout is $timeout/$2"
5881         do_facet ost1 lctl set_param fail_val=$timeout fail_loc=0x80000214
5882         do_facet client "$1" || RC=$?
5883         do_facet client "sync"
5884         do_facet ost1 lctl set_param fail_loc=0
5885         return $RC
5886 }
5887
5888 drop_ldlm_cancel() {
5889 #define OBD_FAIL_LDLM_CANCEL_NET                        0x304
5890         local RC=0
5891         local list=$(comma_list $(mdts_nodes) $(osts_nodes))
5892         do_nodes $list lctl set_param fail_loc=0x304
5893
5894         do_facet client "$@" || RC=$?
5895
5896         do_nodes $list lctl set_param fail_loc=0
5897         return $RC
5898 }
5899
5900 drop_bl_callback_once() {
5901         local rc=0
5902         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=0
5903 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
5904         do_facet client lctl set_param fail_loc=0x80000305
5905         do_facet client "$@" || rc=$?
5906         do_facet client lctl set_param fail_loc=0
5907         do_facet client lctl set_param fail_val=0
5908         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=1
5909         return $rc
5910 }
5911
5912 drop_bl_callback() {
5913         rc=0
5914         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=0
5915 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
5916         do_facet client lctl set_param fail_loc=0x305
5917         do_facet client "$@" || rc=$?
5918         do_facet client lctl set_param fail_loc=0
5919         do_facet client lctl set_param fail_val=0
5920         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=1
5921         return $rc
5922 }
5923
5924 drop_mdt_ldlm_reply() {
5925 #define OBD_FAIL_MDS_LDLM_REPLY_NET     0x157
5926     RC=0
5927     local list=$(comma_list $(mdts_nodes))
5928     do_nodes $list lctl set_param fail_loc=0x157
5929
5930     do_facet client "$@" || RC=$?
5931
5932     do_nodes $list lctl set_param fail_loc=0
5933     return $RC
5934 }
5935
5936 drop_mdt_ldlm_reply_once() {
5937 #define OBD_FAIL_MDS_LDLM_REPLY_NET     0x157
5938     RC=0
5939     local list=$(comma_list $(mdts_nodes))
5940     do_nodes $list lctl set_param fail_loc=0x80000157
5941
5942     do_facet client "$@" || RC=$?
5943
5944     do_nodes $list lctl set_param fail_loc=0
5945     return $RC
5946 }
5947
5948 clear_failloc() {
5949     facet=$1
5950     pause=$2
5951     sleep $pause
5952     echo "clearing fail_loc on $facet"
5953     do_facet $facet "lctl set_param fail_loc=0 2>/dev/null || true"
5954 }
5955
5956 set_nodes_failloc () {
5957         local fv=${3:-0}
5958         do_nodes $(comma_list $1)  lctl set_param fail_val=$fv fail_loc=$2
5959 }
5960
5961 cancel_lru_locks() {
5962         #$LCTL mark "cancel_lru_locks $1 start"
5963         $LCTL set_param -n ldlm.namespaces.*$1*.lru_size=clear
5964         $LCTL get_param ldlm.namespaces.*$1*.lock_unused_count | grep -v '=0'
5965         #$LCTL mark "cancel_lru_locks $1 stop"
5966 }
5967
5968 default_lru_size()
5969 {
5970         NR_CPU=$(grep -c "processor" /proc/cpuinfo)
5971         DEFAULT_LRU_SIZE=$((100 * NR_CPU))
5972         echo "$DEFAULT_LRU_SIZE"
5973 }
5974
5975 lru_resize_enable()
5976 {
5977     lctl set_param ldlm.namespaces.*$1*.lru_size=0
5978 }
5979
5980 lru_resize_disable()
5981 {
5982     lctl set_param ldlm.namespaces.*$1*.lru_size $(default_lru_size)
5983 }
5984
5985 flock_is_enabled()
5986 {
5987         local mountpath=${1:-$MOUNT}
5988         local RC=0
5989
5990         [ -z "$(mount | grep "$mountpath .*flock" | grep -v noflock)" ] && RC=1
5991         return $RC
5992 }
5993
5994 pgcache_empty() {
5995     local FILE
5996     for FILE in `lctl get_param -N "llite.*.dump_page_cache"`; do
5997         if [ `lctl get_param -n $FILE | wc -l` -gt 1 ]; then
5998             echo there is still data in page cache $FILE ?
5999             lctl get_param -n $FILE
6000             return 1
6001         fi
6002     done
6003     return 0
6004 }
6005
6006 debugsave() {
6007         DEBUGSAVE="$(lctl get_param -n debug)"
6008         DEBUGSAVE_SERVER=$(do_facet $SINGLEMDS "$LCTL get_param -n debug")
6009 }
6010
6011 debugrestore() {
6012         [ -n "$DEBUGSAVE" ] &&
6013                 do_nodes $CLIENTS "$LCTL set_param debug=\\\"${DEBUGSAVE}\\\""||
6014                 true
6015         DEBUGSAVE=""
6016
6017         [ -n "$DEBUGSAVE_SERVER" ] &&
6018                 do_nodes $(comma_list $(all_server_nodes)) \
6019                          "$LCTL set_param debug=\\\"${DEBUGSAVE_SERVER}\\\"" ||
6020                          true
6021         DEBUGSAVE_SERVER=""
6022 }
6023
6024 debug_size_save() {
6025     DEBUG_SIZE_SAVED="$(lctl get_param -n debug_mb)"
6026 }
6027
6028 debug_size_restore() {
6029     [ -n "$DEBUG_SIZE_SAVED" ] && \
6030         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE_SAVED"
6031     DEBUG_SIZE_SAVED=""
6032 }
6033
6034 start_full_debug_logging() {
6035         debugsave
6036         debug_size_save
6037
6038         local fulldebug=-1
6039         local debug_size=150
6040         local nodes=$(comma_list $(nodes_list))
6041
6042         do_nodes $nodes "$LCTL set_param debug=$fulldebug debug_mb=$debug_size"
6043 }
6044
6045 stop_full_debug_logging() {
6046         debug_size_restore
6047         debugrestore
6048 }
6049
6050 # prints bash call stack
6051 print_stack_trace() {
6052         local skip=${1:-1}
6053         echo "  Trace dump:"
6054         for (( i=$skip; i < ${#BASH_LINENO[*]} ; i++ )) ; do
6055                 local src=${BASH_SOURCE[$i]}
6056                 local lineno=${BASH_LINENO[$i-1]}
6057                 local funcname=${FUNCNAME[$i]}
6058                 echo "  = $src:$lineno:$funcname()"
6059         done
6060 }
6061
6062 report_error() {
6063         local TYPE=${TYPE:-"FAIL"}
6064
6065         local dump=true
6066         # do not dump logs if $1=false
6067         if [ "x$1" = "xfalse" ]; then
6068                 shift
6069                 dump=false
6070         fi
6071
6072         log " ${TESTSUITE} ${TESTNAME}: @@@@@@ ${TYPE}: $@ "
6073         (print_stack_trace 2) >&2
6074         mkdir -p $LOGDIR
6075         # We need to dump the logs on all nodes
6076         if $dump; then
6077                 gather_logs $(comma_list $(nodes_list))
6078         fi
6079
6080         debugrestore
6081         [ "$TESTSUITELOG" ] &&
6082                 echo "$TESTSUITE: $TYPE: $TESTNAME $@" >> $TESTSUITELOG
6083         if [ -z "$*" ]; then
6084                 echo "error() without useful message, please fix" > $LOGDIR/err
6085         else
6086                 if [[ `echo $TYPE | grep ^IGNORE` ]]; then
6087                         echo "$@" > $LOGDIR/ignore
6088                 else
6089                         echo "$@" > $LOGDIR/err
6090                 fi
6091         fi
6092
6093         # cleanup the env for failed tests
6094         reset_fail_loc
6095 }
6096
6097 ##################################
6098 # Test interface
6099 ##################################
6100
6101 # usage: stack_trap arg sigspec
6102 #
6103 # stack_trap() behaves like bash's built-in trap, except that it "stacks" the
6104 # command "arg" on top of previously defined commands for "sigspec" instead
6105 # of overwriting them.
6106 # stacked traps are executed in reverse order of their registration
6107 #
6108 # arg and sigspec have the same meaning as in man (1) trap
6109 stack_trap()
6110 {
6111         local arg="$1"
6112         local sigspec="${2:-EXIT}"
6113
6114         # Use "trap -p" to get the quoting right
6115         local old_trap="$(trap -p "$sigspec")"
6116         # Append ";" and remove the leading "trap -- '" added by "trap -p"
6117         old_trap="${old_trap:+"; ${old_trap#trap -- \'}"}"
6118
6119         # Once again, use "trap -p" to get the quoting right
6120         local new_trap="$(trap -- "$arg" "$sigspec"
6121                           trap -p "$sigspec"
6122                           trap -- '' "$sigspec")"
6123
6124         # Remove the trailing "' $sigspec" part added by "trap -p" and merge
6125         #
6126         # The resulting string should be safe to "eval" as it is (supposedly
6127         # correctly) quoted by "trap -p"
6128         eval "${new_trap%\' $sigspec}${old_trap:-"' $sigspec"}"
6129 }
6130
6131 error_noexit() {
6132         report_error "$@"
6133 }
6134
6135 exit_status () {
6136         local status=0
6137         local log=$TESTSUITELOG
6138
6139         [ -f "$log" ] && grep -qw FAIL $log && status=1
6140         exit $status
6141 }
6142
6143 error() {
6144         report_error "$@"
6145         exit 1
6146 }
6147
6148 error_exit() {
6149         report_error "$@"
6150         exit 1
6151 }
6152
6153 # use only if we are ignoring failures for this test, bugno required.
6154 # (like ALWAYS_EXCEPT, but run the test and ignore the results.)
6155 # e.g. error_ignore bz5494 "your message" or
6156 # error_ignore LU-5494 "your message"
6157 error_ignore() {
6158         local TYPE="IGNORE ($1)"
6159         shift
6160         report_error "$@"
6161 }
6162
6163 error_and_remount() {
6164         report_error "$@"
6165         remount_client $MOUNT
6166         exit 1
6167 }
6168
6169 # Throw an error if it's not running in vm - usually for performance
6170 # verification
6171 error_not_in_vm() {
6172         local virt=$(running_in_vm)
6173         if [[ -n "$virt" ]]; then
6174                 echo "running in VM '$virt', ignore error"
6175                 error_ignore env=$virt "$@"
6176         else
6177                 error "$@"
6178         fi
6179 }
6180
6181 #
6182 # Function: skip_env()
6183 # Purpose:  to skip a test during developer testing because some tool
6184 #           is missing, but fail the test in release testing because the test
6185 #           environment is not configured properly".
6186 #
6187 skip_env () {
6188         $FAIL_ON_SKIP_ENV && error false $@ || skip $@
6189 }
6190
6191 skip_noexit() {
6192         echo
6193         log " SKIP: $TESTSUITE $TESTNAME $@"
6194
6195         if [[ -n "$ALWAYS_SKIPPED" ]]; then
6196                 skip_logged $TESTNAME "$@"
6197         else
6198                 mkdir -p $LOGDIR
6199                 echo "$@" > $LOGDIR/skip
6200         fi
6201
6202         [[ -n "$TESTSUITELOG" ]] &&
6203                 echo "$TESTSUITE: SKIP: $TESTNAME $@" >> $TESTSUITELOG || true
6204         unset TESTNAME
6205 }
6206
6207 skip() {
6208         skip_noexit $@
6209         exit 0
6210 }
6211
6212 build_test_filter() {
6213         EXCEPT="$EXCEPT $(testslist_filter)"
6214
6215         for O in $ONLY; do
6216                 if [[ $O = [0-9]*-[0-9]* ]]; then
6217                         for num in $(seq $(echo $O | tr '-' ' ')); do
6218                                 eval ONLY_$num=true
6219                         done
6220                 else
6221                         eval ONLY_${O}=true
6222                 fi
6223         done
6224
6225         [ "$EXCEPT$ALWAYS_EXCEPT" ] &&
6226                 log "excepting tests: `echo $EXCEPT $ALWAYS_EXCEPT`"
6227         [ "$EXCEPT_SLOW" ] &&
6228                 log "skipping tests SLOW=no: `echo $EXCEPT_SLOW`"
6229         for E in $EXCEPT; do
6230                 eval EXCEPT_${E}=true
6231         done
6232         for E in $ALWAYS_EXCEPT; do
6233                 eval EXCEPT_ALWAYS_${E}=true
6234         done
6235         for E in $EXCEPT_SLOW; do
6236                 eval EXCEPT_SLOW_${E}=true
6237         done
6238         for G in $GRANT_CHECK_LIST; do
6239                 eval GCHECK_ONLY_${G}=true
6240         done
6241 }
6242
6243 basetest() {
6244     if [[ $1 = [a-z]* ]]; then
6245         echo $1
6246     else
6247         echo ${1%%[a-zA-Z]*}
6248     fi
6249 }
6250
6251 # print a newline if the last test was skipped
6252 export LAST_SKIPPED=
6253 export ALWAYS_SKIPPED=
6254 #
6255 # Main entry into test-framework. This is called with the number and
6256 # description of a test. The number is used to find the function to run
6257 # the test using "test_$name".
6258 #
6259 # This supports a variety of methods of specifying specific test to
6260 # run or not run:
6261 # - ONLY= env variable with space-separated list of test numbers to run
6262 # - EXCEPT= env variable with space-separated list of test numbers to exclude
6263 #
6264 run_test() {
6265         assert_DIR
6266         local testnum=$1
6267         local testmsg=$2
6268         export base=$(basetest $testnum)
6269         export TESTNAME=test_$testnum
6270         LAST_SKIPPED=
6271         ALWAYS_SKIPPED=
6272
6273         # Check the EXCEPT, ALWAYS_EXCEPT and SLOW lists to see if we
6274         # need to skip the current test. If so, set the ALWAYS_SKIPPED flag.
6275         local isexcept=EXCEPT_$testnum
6276         local isexcept_base=EXCEPT_$base
6277         if [ ${!isexcept}x != x ]; then
6278                 ALWAYS_SKIPPED="y"
6279                 skip_message="skipping excluded test $testnum"
6280         elif [ ${!isexcept_base}x != x ]; then
6281                 ALWAYS_SKIPPED="y"
6282                 skip_message="skipping excluded test $testnum (base $base)"
6283         fi
6284
6285         isexcept=EXCEPT_ALWAYS_$testnum
6286         isexcept_base=EXCEPT_ALWAYS_$base
6287         if [ ${!isexcept}x != x ]; then
6288                 ALWAYS_SKIPPED="y"
6289                 skip_message="skipping ALWAYS excluded test $testnum"
6290         elif [ ${!isexcept_base}x != x ]; then
6291                 ALWAYS_SKIPPED="y"
6292                 skip_message="skipping ALWAYS excluded test $testnum (base $base)"
6293         fi
6294
6295         isexcept=EXCEPT_SLOW_$testnum
6296         isexcept_base=EXCEPT_SLOW_$base
6297         if [ ${!isexcept}x != x ]; then
6298                 ALWAYS_SKIPPED="y"
6299                 skip_message="skipping SLOW test $testnum"
6300         elif [ ${!isexcept_base}x != x ]; then
6301                 ALWAYS_SKIPPED="y"
6302                 skip_message="skipping SLOW test $testnum (base $base)"
6303         fi
6304
6305         # If there are tests on the ONLY list, check if the current test
6306         # is on that list and, if so, check if the test is to be skipped
6307         # and if we are supposed to honor the skip lists.
6308         if [ -n "$ONLY" ]; then
6309                 local isonly=ONLY_$testnum
6310                 local isonly_base=ONLY_$base
6311                 if [[ ${!isonly}x != x || ${!isonly_base}x != x ]]; then
6312
6313                         if [[ -n "$ALWAYS_SKIPPED" && -n "$HONOR_EXCEPT" ]]; then
6314                                 LAST_SKIPPED="y"
6315                                 skip_noexit "$skip_message"
6316                                 return 0
6317                         else
6318                                 [ -n "$LAST_SKIPPED" ] &&
6319                                         echo "" && LAST_SKIPPED=
6320                                 ALWAYS_SKIPPED=
6321                                 run_one_logged $testnum "$testmsg"
6322                                 return $?
6323                         fi
6324
6325                 else
6326                         LAST_SKIPPED="y"
6327                         return 0
6328                 fi
6329         fi
6330
6331         if [ -n "$ALWAYS_SKIPPED" ]; then
6332                 LAST_SKIPPED="y"
6333                 skip_noexit "$skip_message"
6334                 return 0
6335         else
6336                 run_one_logged $testnum "$testmsg"
6337                 return $?
6338         fi
6339 }
6340
6341 log() {
6342         echo "$*" >&2
6343         load_module ../libcfs/libcfs/libcfs
6344
6345     local MSG="$*"
6346     # Get rid of '
6347     MSG=${MSG//\'/\\\'}
6348     MSG=${MSG//\(/\\\(}
6349     MSG=${MSG//\)/\\\)}
6350     MSG=${MSG//\;/\\\;}
6351     MSG=${MSG//\|/\\\|}
6352     MSG=${MSG//\>/\\\>}
6353     MSG=${MSG//\</\\\<}
6354     MSG=${MSG//\//\\\/}
6355     do_nodes $(comma_list $(nodes_list)) $LCTL mark "$MSG" 2> /dev/null || true
6356 }
6357
6358 trace() {
6359         log "STARTING: $*"
6360         strace -o $TMP/$1.strace -ttt $*
6361         RC=$?
6362         log "FINISHED: $*: rc $RC"
6363         return 1
6364 }
6365
6366 complete () {
6367     local duration=$1
6368
6369     banner test complete, duration $duration sec
6370     [ -f "$TESTSUITELOG" ] && egrep .FAIL $TESTSUITELOG || true
6371     echo duration $duration >>$TESTSUITELOG
6372 }
6373
6374 pass() {
6375         # Set TEST_STATUS here. It will be used for logging the result.
6376         TEST_STATUS="PASS"
6377
6378         if [[ -f $LOGDIR/err ]]; then
6379                 TEST_STATUS="FAIL"
6380         elif [[ -f $LOGDIR/skip ]]; then
6381                 TEST_STATUS="SKIP"
6382         fi
6383         echo "$TEST_STATUS $@" 2>&1 | tee -a $TESTSUITELOG
6384 }
6385
6386 check_mds() {
6387     local FFREE=$(do_node $SINGLEMDS \
6388         lctl get_param -n osd*.*MDT*.filesfree | calc_sum)
6389     local FTOTAL=$(do_node $SINGLEMDS \
6390         lctl get_param -n osd*.*MDT*.filestotal | calc_sum)
6391
6392     [ $FFREE -ge $FTOTAL ] && error "files free $FFREE > total $FTOTAL" || true
6393 }
6394
6395 reset_fail_loc () {
6396         echo -n "Resetting fail_loc on all nodes..."
6397         do_nodes $(comma_list $(nodes_list)) "lctl set_param -n fail_loc=0 \
6398             fail_val=0 2>/dev/null" || true
6399         echo done.
6400 }
6401
6402
6403 #
6404 # Log a message (on all nodes) padded with "=" before and after.
6405 # Also appends a timestamp and prepends the testsuite name.
6406 #
6407
6408 EQUALS="===================================================================================================="
6409 banner() {
6410     msg="== ${TESTSUITE} $*"
6411     last=${msg: -1:1}
6412     [[ $last != "=" && $last != " " ]] && msg="$msg "
6413     msg=$(printf '%s%.*s'  "$msg"  $((${#EQUALS} - ${#msg})) $EQUALS )
6414     # always include at least == after the message
6415     log "$msg== $(date +"%H:%M:%S (%s)")"
6416 }
6417
6418 check_dmesg_for_errors() {
6419         local res
6420         local errors="VFS: Busy inodes after unmount of\|\
6421 ldiskfs_check_descriptors: Checksum for group 0 failed\|\
6422 group descriptors corrupted"
6423
6424         res=$(do_nodes $(comma_list $(nodes_list)) "dmesg" | grep "$errors")
6425         [ -z "$res" ] && return 0
6426         echo "Kernel error detected: $res"
6427         return 1
6428 }
6429
6430 #
6431 # Run a single test function and cleanup after it.
6432 #
6433 # This function should be run in a subshell so the test func can
6434 # exit() without stopping the whole script.
6435 #
6436 run_one() {
6437         local testnum=$1
6438         local testmsg="$2"
6439         local SAVE_UMASK=`umask`
6440         umask 0022
6441
6442         if ! grep -q $DIR /proc/mounts; then
6443                 $SETUP
6444         fi
6445
6446         banner "test $testnum: $testmsg"
6447         test_${testnum} || error "test_$testnum failed with $?"
6448         cd $SAVE_PWD
6449         reset_fail_loc
6450         check_grant ${testnum} || error "check_grant $testnum failed with $?"
6451         check_node_health
6452         check_dmesg_for_errors || error "Error in dmesg detected"
6453         if [ "$PARALLEL" != "yes" ]; then
6454                 ps auxww | grep -v grep | grep -q "multiop " &&
6455                                         error "multiop still running"
6456         fi
6457         umask $SAVE_UMASK
6458         $CLEANUP
6459         return 0
6460 }
6461
6462 #
6463 # Wrapper around run_one to ensure:
6464 #  - test runs in subshell
6465 #  - output of test is saved to separate log file for error reporting
6466 #  - test result is saved to data file
6467 #
6468 run_one_logged() {
6469         local before=$SECONDS
6470         local testnum=$1
6471         local testmsg=$2
6472         export tfile=f${testnum}.${TESTSUITE}
6473         export tdir=d${testnum}.${TESTSUITE}
6474         local name=$TESTSUITE.$TESTNAME.test_log.$(hostname -s).log
6475         local test_log=$LOGDIR/$name
6476         local zfs_log_name=$TESTSUITE.$TESTNAME.zfs_log
6477         local zfs_debug_log=$LOGDIR/$zfs_log_name
6478         local SAVE_UMASK=$(umask)
6479         local rc=0
6480         umask 0022
6481
6482         rm -f $LOGDIR/err $LOGDIR/ignore $LOGDIR/skip
6483         echo
6484         # if ${ONLY_$testnum} set, repeat $ONLY_REPEAT times, otherwise once
6485         local isonly=ONLY_$testnum
6486         local repeat=${!isonly:+$ONLY_REPEAT}
6487
6488         for testiter in $(seq ${repeat:-1}); do
6489                 local before_sub=$SECONDS
6490                 log_sub_test_begin $TESTNAME
6491
6492                 # remove temp files between repetitions to avoid test failures
6493                 [ -n "$append" -a -n "$DIR" -a -n "$tdir" -a -n "$tfile" ] &&
6494                         rm -rf $DIR/$tdir* $DIR/$tfile*
6495                 # loop around subshell so stack_trap EXIT triggers each time
6496                 (run_one $testnum "$testmsg") 2>&1 | tee -i $append $test_log
6497                 rc=${PIPESTATUS[0]}
6498                 local append=-a
6499                 local duration_sub=$((SECONDS - before_sub))
6500                 local test_error
6501
6502                 [[ $rc != 0 && ! -f $LOGDIR/err ]] &&
6503                         echo "$TESTNAME returned $rc" | tee $LOGDIR/err
6504
6505                 if [[ -f $LOGDIR/err ]]; then
6506                         test_error=$(cat $LOGDIR/err)
6507                         TEST_STATUS="FAIL"
6508                 elif [[ -f $LOGDIR/ignore ]]; then
6509                         test_error=$(cat $LOGDIR/ignore)
6510                 elif [[ -f $LOGDIR/skip ]]; then
6511                         test_error=$(cat $LOGDIR/skip)
6512                         TEST_STATUS="SKIP"
6513                 else
6514                         TEST_STATUS="PASS"
6515                 fi
6516
6517                 pass "$testnum" "($((SECONDS - before))s)"
6518                 log_sub_test_end $TEST_STATUS $duration_sub "$rc" "$test_error"
6519                 [[ $rc != 0 ]] && break
6520         done
6521
6522         if [[ "$TEST_STATUS" != "SKIP" && -f $TF_SKIP ]]; then
6523                 rm -f $TF_SKIP
6524         fi
6525
6526         if [ -f $LOGDIR/err ]; then
6527                 log_zfs_info "$zfs_debug_log"
6528                 $FAIL_ON_ERROR && exit $rc
6529         fi
6530
6531         umask $SAVE_UMASK
6532
6533         unset TESTNAME
6534         unset tdir
6535         unset tfile
6536
6537         return 0
6538 }
6539
6540 #
6541 # Print information of skipped tests to result.yml
6542 #
6543 skip_logged(){
6544         log_sub_test_begin $1
6545         shift
6546         log_sub_test_end "SKIP" "0" "0" "$@"
6547 }
6548
6549 canonical_path() {
6550         (cd $(dirname $1); echo $PWD/$(basename $1))
6551 }
6552
6553 grant_from_clients() {
6554         local nodes="$1"
6555
6556         # get client grant
6557         do_nodes $nodes "$LCTL get_param -n osc.${FSNAME}-*.cur_*grant_bytes" |
6558                 calc_sum
6559 }
6560
6561 grant_from_servers() {
6562         local nodes="$1"
6563
6564         # get server grant
6565         # which is tot_granted less grant_precreate
6566         do_nodes $nodes "$LCTL get_param obdfilter.${FSNAME}-OST*.tot_granted" \
6567                 " obdfilter.${FSNAME}-OST*.tot_pending" \
6568                 " obdfilter.${FSNAME}-OST*.grant_precreate" |
6569                 tr '=' ' ' | awk '/tot_granted/{ total += $2 };
6570                                   /tot_pending/{ total -= $2 };
6571                                   /grant_precreate/{ total -= $2 };
6572                                   END { printf("%0.0f", total) }'
6573 }
6574
6575 check_grant() {
6576         export base=$(basetest $1)
6577         [ "$CHECK_GRANT" == "no" ] && return 0
6578
6579         local isonly_base=GCHECK_ONLY_${base}
6580         local isonly=GCHECK_ONLY_$1
6581         [ ${!isonly_base}x == x -a ${!isonly}x == x ] && return 0
6582
6583         echo -n "checking grant......"
6584
6585         local osts=$(comma_list $(osts_nodes))
6586         local clients=$CLIENTS
6587         [ -z "$clients" ] && clients=$(hostname)
6588
6589         # sync all the data and make sure no pending data on server
6590         do_nodes $clients sync
6591         clients_up # initiate all idling connections
6592
6593         # get client grant
6594         cli_grant=$(grant_from_clients $clients)
6595
6596         # get server grant
6597         # which is tot_granted less grant_precreate
6598         srv_grant=$(grant_from_servers $osts)
6599
6600         count=0
6601         # check whether client grant == server grant
6602         while [[ $cli_grant != $srv_grant && count++ -lt 30 ]]; do
6603                 echo "wait for client:$cli_grant == server:$srv_grant"
6604                 sleep 1
6605                 cli_grant=$(grant_from_clients $clients)
6606                 srv_grant=$(grant_from_servers $osts)
6607         done
6608         if [[ $cli_grant -ne $srv_grant ]]; then
6609                 do_nodes $(comma_list $(osts_nodes)) \
6610                         "$LCTL get_param obdfilter.${FSNAME}-OST*.tot*" \
6611                         "obdfilter.${FSNAME}-OST*.grant_*"
6612                 do_nodes $clients "$LCTL get_param osc.${FSNAME}-*.cur_*_bytes"
6613                 error "failed grant check: client:$cli_grant server:$srv_grant"
6614         else
6615                 echo "pass grant check: client:$cli_grant server:$srv_grant"
6616         fi
6617 }
6618
6619 ########################
6620 # helper functions
6621
6622 osc_to_ost()
6623 {
6624     osc=$1
6625     ost=`echo $1 | awk -F_ '{print $3}'`
6626     if [ -z $ost ]; then
6627         ost=`echo $1 | sed 's/-osc.*//'`
6628     fi
6629     echo $ost
6630 }
6631
6632 ostuuid_from_index()
6633 {
6634     $LFS osts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
6635 }
6636
6637 ostname_from_index() {
6638     local uuid=$(ostuuid_from_index $1)
6639     echo ${uuid/_UUID/}
6640 }
6641
6642 mdtname_from_index() {
6643         local uuid=$(mdtuuid_from_index $1)
6644         echo ${uuid/_UUID/}
6645 }
6646
6647 mdssize_from_index () {
6648         local mdt=$(mdtname_from_index $2)
6649         $LFS df $1 | grep $mdt | awk '{ print $2 }'
6650 }
6651
6652 index_from_ostuuid()
6653 {
6654     $LFS osts $2 | sed -ne "/${1}/s/\(.*\): .* .*$/\1/p"
6655 }
6656
6657 mdtuuid_from_index()
6658 {
6659     $LFS mdts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
6660 }
6661
6662 # Description:
6663 #   Return unique identifier for given hostname
6664 host_id() {
6665         local host_name=$1
6666         echo $host_name | md5sum | cut -d' ' -f1
6667 }
6668
6669 # Description:
6670 #   Returns list of ip addresses for each interface
6671 local_addr_list() {
6672         ip addr | awk '/inet\ / {print $2}' | awk -F\/ '{print $1}'
6673 }
6674
6675 is_local_addr() {
6676         local addr=$1
6677         # Cache address list to avoid mutiple execution of local_addr_list
6678         LOCAL_ADDR_LIST=${LOCAL_ADDR_LIST:-$(local_addr_list)}
6679         local i
6680         for i in $LOCAL_ADDR_LIST ; do
6681                 [[ "$i" == "$addr" ]] && return 0
6682         done
6683         return 1
6684 }
6685
6686 local_node() {
6687         local host_name=$1
6688         local is_local="IS_LOCAL_$(host_id $host_name)"
6689         if [ -z "${!is_local-}" ] ; then
6690                 eval $is_local=0
6691                 local host_ip=$($LUSTRE/tests/resolveip $host_name)
6692                 is_local_addr "$host_ip" && eval $is_local=1
6693         fi
6694         [[ "${!is_local}" == "1" ]]
6695 }
6696
6697 remote_node () {
6698         local node=$1
6699         local_node $node && return 1
6700         return 0
6701 }
6702
6703 remote_mds ()
6704 {
6705     local node
6706     for node in $(mdts_nodes); do
6707         remote_node $node && return 0
6708     done
6709     return 1
6710 }
6711
6712 remote_mds_nodsh()
6713 {
6714         [ -n "$CLIENTONLY" ] && return 0 || true
6715         remote_mds && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$mds_HOST" ]
6716 }
6717
6718 require_dsh_mds()
6719 {
6720         remote_mds_nodsh && echo "SKIP: $TESTSUITE: remote MDS with nodsh" &&
6721                 MSKIPPED=1 && return 1
6722         return 0
6723 }
6724
6725 remote_ost ()
6726 {
6727     local node
6728     for node in $(osts_nodes) ; do
6729         remote_node $node && return 0
6730     done
6731     return 1
6732 }
6733
6734 remote_ost_nodsh()
6735 {
6736         [ -n "$CLIENTONLY" ] && return 0 || true
6737         remote_ost && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
6738 }
6739
6740 require_dsh_ost()
6741 {
6742         remote_ost_nodsh && echo "SKIP: $TESTSUITE: remote OST with nodsh" && \
6743             OSKIPPED=1 && return 1
6744         return 0
6745 }
6746
6747 remote_mgs_nodsh()
6748 {
6749         [ -n "$CLIENTONLY" ] && return 0 || true
6750         local MGS
6751         MGS=$(facet_host mgs)
6752         remote_node $MGS && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
6753 }
6754
6755 local_mode ()
6756 {
6757     remote_mds_nodsh || remote_ost_nodsh || \
6758         $(single_local_node $(comma_list $(nodes_list)))
6759 }
6760
6761 remote_servers () {
6762     remote_ost && remote_mds
6763 }
6764
6765 # Get the active nodes for facets.
6766 facets_nodes () {
6767         local facets=$1
6768         local facet
6769         local nodes
6770         local nodes_sort
6771         local i
6772
6773         for facet in ${facets//,/ }; do
6774                 nodes="$nodes $(facet_active_host $facet)"
6775         done
6776
6777         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6778         echo -n $nodes_sort
6779 }
6780
6781 # Get name of the active MGS node.
6782 mgs_node () {
6783         echo -n $(facets_nodes $(get_facets MGS))
6784 }
6785
6786 # Get all of the active MDS nodes.
6787 mdts_nodes () {
6788         echo -n $(facets_nodes $(get_facets MDS))
6789 }
6790
6791 # Get all of the active OSS nodes.
6792 osts_nodes () {
6793         echo -n $(facets_nodes $(get_facets OST))
6794 }
6795
6796 # Get all of the active AGT (HSM agent) nodes.
6797 agts_nodes () {
6798         echo -n $(facets_nodes $(get_facets AGT))
6799 }
6800
6801 # Get all of the client nodes and active server nodes.
6802 nodes_list () {
6803         local nodes=$HOSTNAME
6804         local nodes_sort
6805         local i
6806
6807         # CLIENTS (if specified) contains the local client
6808         [ -n "$CLIENTS" ] && nodes=${CLIENTS//,/ }
6809
6810         if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
6811                 nodes="$nodes $(facets_nodes $(get_facets))"
6812         fi
6813
6814         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6815         echo -n $nodes_sort
6816 }
6817
6818 # Get all of the remote client nodes and remote active server nodes.
6819 remote_nodes_list () {
6820         echo -n $(nodes_list) | sed -re "s/\<$HOSTNAME\>//g"
6821 }
6822
6823 # Get all of the MDS nodes, including active and passive nodes.
6824 all_mdts_nodes () {
6825         local host
6826         local failover_host
6827         local nodes
6828         local nodes_sort
6829         local i
6830
6831         for i in $(seq $MDSCOUNT); do
6832                 host=mds${i}_HOST
6833                 failover_host=mds${i}failover_HOST
6834                 nodes="$nodes ${!host} ${!failover_host}"
6835         done
6836
6837         [ -n "$nodes" ] || nodes="${mds_HOST} ${mdsfailover_HOST}"
6838         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6839         echo -n $nodes_sort
6840 }
6841
6842 # Get all of the OSS nodes, including active and passive nodes.
6843 all_osts_nodes () {
6844         local host
6845         local failover_host
6846         local nodes=
6847         local nodes_sort
6848         local i
6849
6850         for i in $(seq $OSTCOUNT); do
6851                 host=ost${i}_HOST
6852                 failover_host=ost${i}failover_HOST
6853                 nodes="$nodes ${!host} ${!failover_host}"
6854         done
6855
6856         [ -n "$nodes" ] || nodes="${ost_HOST} ${ostfailover_HOST}"
6857         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6858         echo -n $nodes_sort
6859 }
6860
6861 # Get all of the server nodes, including active and passive nodes.
6862 all_server_nodes () {
6863         local nodes
6864         local nodes_sort
6865         local i
6866
6867         nodes="$mgs_HOST $mgsfailover_HOST $(all_mdts_nodes) $(all_osts_nodes)"
6868
6869         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6870         echo -n $nodes_sort
6871 }
6872
6873 # Get all of the client and server nodes, including active and passive nodes.
6874 all_nodes () {
6875         local nodes=$HOSTNAME
6876         local nodes_sort
6877         local i
6878
6879         # CLIENTS (if specified) contains the local client
6880         [ -n "$CLIENTS" ] && nodes=${CLIENTS//,/ }
6881
6882         if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
6883                 nodes="$nodes $(all_server_nodes)"
6884         fi
6885
6886         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6887         echo -n $nodes_sort
6888 }
6889
6890 init_clients_lists () {
6891     # Sanity check: exclude the local client from RCLIENTS
6892     local clients=$(hostlist_expand "$RCLIENTS")
6893     local rclients=$(exclude_items_from_list "$clients" $HOSTNAME)
6894
6895     # Sanity check: exclude the dup entries
6896     RCLIENTS=$(for i in ${rclients//,/ }; do echo $i; done | sort -u)
6897
6898     clients="$SINGLECLIENT $HOSTNAME $RCLIENTS"
6899
6900     # Sanity check: exclude the dup entries from CLIENTS
6901     # for those configs which has SINGLCLIENT set to local client
6902     clients=$(for i in $clients; do echo $i; done | sort -u)
6903
6904     CLIENTS=$(comma_list $clients)
6905     local -a remoteclients=($RCLIENTS)
6906     for ((i=0; $i<${#remoteclients[@]}; i++)); do
6907             varname=CLIENT$((i + 2))
6908             eval $varname=${remoteclients[i]}
6909     done
6910
6911     CLIENTCOUNT=$((${#remoteclients[@]} + 1))
6912 }
6913
6914 get_random_entry () {
6915     local rnodes=$1
6916
6917     rnodes=${rnodes//,/ }
6918
6919     local -a nodes=($rnodes)
6920     local num=${#nodes[@]}
6921     local i=$((RANDOM * num * 2 / 65536))
6922
6923     echo ${nodes[i]}
6924 }
6925
6926 client_only () {
6927         [ -n "$CLIENTONLY" ] || [ "x$CLIENTMODSONLY" = "xyes" ]
6928 }
6929
6930 check_versions () {
6931     [ "$(lustre_version_code client)" = "$(lustre_version_code $SINGLEMDS)" -a \
6932       "$(lustre_version_code client)" = "$(lustre_version_code ost1)" ]
6933 }
6934
6935 get_node_count() {
6936     local nodes="$@"
6937     echo $nodes | wc -w || true
6938 }
6939
6940 mixed_ost_devs () {
6941     local nodes=$(osts_nodes)
6942     local osscount=$(get_node_count "$nodes")
6943     [ ! "$OSTCOUNT" = "$osscount" ]
6944 }
6945
6946 mixed_mdt_devs () {
6947     local nodes=$(mdts_nodes)
6948     local mdtcount=$(get_node_count "$nodes")
6949     [ ! "$MDSCOUNT" = "$mdtcount" ]
6950 }
6951
6952 generate_machine_file() {
6953     local nodes=${1//,/ }
6954     local machinefile=$2
6955     rm -f $machinefile
6956     for node in $nodes; do
6957         echo $node >>$machinefile || \
6958             { echo "can not generate machinefile $machinefile" && return 1; }
6959     done
6960 }
6961
6962 get_stripe () {
6963         local file=$1/stripe
6964
6965         touch $file
6966         $LFS getstripe -v $file || error "getstripe $file failed"
6967         rm -f $file
6968 }
6969
6970 setstripe_nfsserver () {
6971         local dir=$1
6972         local nfsexportdir=$2
6973         shift
6974         shift
6975
6976         local -a nfsexport=($(awk '"'$dir'" ~ $2 && $3 ~ "nfs" && $2 != "/" \
6977                 { print $1 }' /proc/mounts | cut -f 1 -d :))
6978
6979         # check that only one nfs mounted
6980         [[ -z $nfsexport ]] && echo "$dir is not nfs mounted" && return 1
6981         (( ${#nfsexport[@]} == 1 )) ||
6982                 error "several nfs mounts found for $dir: ${nfsexport[@]} !"
6983
6984         do_nodev ${nfsexport[0]} lfs setstripe $nfsexportdir "$@"
6985 }
6986
6987 # Check and add a test group.
6988 add_group() {
6989         local group_id=$1
6990         local group_name=$2
6991         local rc=0
6992
6993         local gid=$(getent group $group_name | cut -d: -f3)
6994         if [[ -n "$gid" ]]; then
6995                 [[ "$gid" -eq "$group_id" ]] || {
6996                         error_noexit "inconsistent group ID:" \
6997                                      "new: $group_id, old: $gid"
6998                         rc=1
6999                 }
7000         else
7001                 groupadd -g $group_id $group_name
7002                 rc=${PIPESTATUS[0]}
7003         fi
7004
7005         return $rc
7006 }
7007
7008 # Check and add a test user.
7009 add_user() {
7010         local user_id=$1
7011         shift
7012         local user_name=$1
7013         shift
7014         local group_name=$1
7015         shift
7016         local home=$1
7017         shift
7018         local opts="$@"
7019         local rc=0
7020
7021         local uid=$(getent passwd $user_name | cut -d: -f3)
7022         if [[ -n "$uid" ]]; then
7023                 if [[ "$uid" -eq "$user_id" ]]; then
7024                         local dir=$(getent passwd $user_name | cut -d: -f6)
7025                         if [[ "$dir" != "$home" ]]; then
7026                                 mkdir -p $home
7027                                 usermod -d $home $user_name
7028                                 rc=${PIPESTATUS[0]}
7029                         fi
7030                 else
7031                         error_noexit "inconsistent user ID:" \
7032                                      "new: $user_id, old: $uid"
7033                         rc=1
7034                 fi
7035         else
7036                 mkdir -p $home
7037                 useradd -M -u $user_id -d $home -g $group_name $opts $user_name
7038                 rc=${PIPESTATUS[0]}
7039         fi
7040
7041         return $rc
7042 }
7043
7044 check_runas_id_ret() {
7045     local myRC=0
7046     local myRUNAS_UID=$1
7047     local myRUNAS_GID=$2
7048     shift 2
7049     local myRUNAS=$@
7050     if [ -z "$myRUNAS" ]; then
7051         error_exit "myRUNAS command must be specified for check_runas_id"
7052     fi
7053     if $GSS_KRB5; then
7054         $myRUNAS krb5_login.sh || \
7055             error "Failed to refresh Kerberos V5 TGT for UID $myRUNAS_ID."
7056     fi
7057     mkdir $DIR/d0_runas_test
7058     chmod 0755 $DIR
7059     chown $myRUNAS_UID:$myRUNAS_GID $DIR/d0_runas_test
7060     $myRUNAS touch $DIR/d0_runas_test/f$$ || myRC=$?
7061     rm -rf $DIR/d0_runas_test
7062     return $myRC
7063 }
7064
7065 check_runas_id() {
7066     local myRUNAS_UID=$1
7067     local myRUNAS_GID=$2
7068     shift 2
7069     local myRUNAS=$@
7070     check_runas_id_ret $myRUNAS_UID $myRUNAS_GID $myRUNAS || \
7071         error "unable to write to $DIR/d0_runas_test as UID $myRUNAS_UID.
7072         Please set RUNAS_ID to some UID which exists on MDS and client or
7073         add user $myRUNAS_UID:$myRUNAS_GID on these nodes."
7074 }
7075
7076 # obtain the UID/GID for MPI_USER
7077 get_mpiuser_id() {
7078     local mpi_user=$1
7079
7080     MPI_USER_UID=$(do_facet client "getent passwd $mpi_user | cut -d: -f3;
7081 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the UID for $mpi_user"
7082
7083     MPI_USER_GID=$(do_facet client "getent passwd $mpi_user | cut -d: -f4;
7084 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the GID for $mpi_user"
7085 }
7086
7087 # obtain and cache Kerberos ticket-granting ticket
7088 refresh_krb5_tgt() {
7089     local myRUNAS_UID=$1
7090     local myRUNAS_GID=$2
7091     shift 2
7092     local myRUNAS=$@
7093     if [ -z "$myRUNAS" ]; then
7094         error_exit "myRUNAS command must be specified for refresh_krb5_tgt"
7095     fi
7096
7097     CLIENTS=${CLIENTS:-$HOSTNAME}
7098     do_nodes $CLIENTS "set -x
7099 if ! $myRUNAS krb5_login.sh; then
7100     echo "Failed to refresh Krb5 TGT for UID/GID $myRUNAS_UID/$myRUNAS_GID."
7101     exit 1
7102 fi"
7103 }
7104
7105 # Run multiop in the background, but wait for it to print
7106 # "PAUSING" to its stdout before returning from this function.
7107 multiop_bg_pause() {
7108     MULTIOP_PROG=${MULTIOP_PROG:-$MULTIOP}
7109     FILE=$1
7110     ARGS=$2
7111
7112     TMPPIPE=/tmp/multiop_open_wait_pipe.$$
7113     mkfifo $TMPPIPE
7114
7115     echo "$MULTIOP_PROG $FILE v$ARGS"
7116     $MULTIOP_PROG $FILE v$ARGS > $TMPPIPE &
7117
7118     echo "TMPPIPE=${TMPPIPE}"
7119     read -t 60 multiop_output < $TMPPIPE
7120     if [ $? -ne 0 ]; then
7121         rm -f $TMPPIPE
7122         return 1
7123     fi
7124     rm -f $TMPPIPE
7125     if [ "$multiop_output" != "PAUSING" ]; then
7126         echo "Incorrect multiop output: $multiop_output"
7127         kill -9 $PID
7128         return 1
7129     fi
7130
7131     return 0
7132 }
7133
7134 do_and_time () {
7135     local cmd=$1
7136     local rc
7137
7138     SECONDS=0
7139     eval '$cmd'
7140
7141     [ ${PIPESTATUS[0]} -eq 0 ] || rc=1
7142
7143     echo $SECONDS
7144     return $rc
7145 }
7146
7147 inodes_available () {
7148         local IFree=$($LFS df -i $MOUNT | grep ^$FSNAME | awk '{ print $4 }' |
7149                 sort -un | head -n1) || return 1
7150         echo $((IFree))
7151 }
7152
7153 mdsrate_inodes_available () {
7154         local min_inodes=$(inodes_available)
7155         echo $((min_inodes * 99 / 100))
7156 }
7157
7158 # reset stat counters
7159 clear_stats() {
7160         local paramfile="$1"
7161         lctl set_param -n $paramfile=0
7162 }
7163
7164 # sum stat items
7165 calc_stats() {
7166         local paramfile="$1"
7167         local stat="$2"
7168         lctl get_param -n $paramfile |
7169                 awk '/^'$stat'/ { sum += $2 } END { printf("%0.0f", sum) }'
7170 }
7171
7172 calc_sum () {
7173         awk '{sum += $1} END { printf("%0.0f", sum) }'
7174 }
7175
7176 calc_osc_kbytes () {
7177         $LFS df $MOUNT > /dev/null
7178         $LCTL get_param -n osc.*[oO][sS][cC][-_][0-9a-f]*.$1 | calc_sum
7179 }
7180
7181 # save_lustre_params(comma separated facet list, parameter_mask)
7182 # generate a stream of formatted strings (<facet> <param name>=<param value>)
7183 save_lustre_params() {
7184         local facets=$1
7185         local facet
7186         local facet_svc
7187
7188         for facet in ${facets//,/ }; do
7189                 facet_svc=$(facet_svc $facet)
7190                 do_facet $facet \
7191                         "params=\\\$($LCTL get_param $2);
7192                          [[ -z \\\"$facet_svc\\\" ]] && param= ||
7193                          param=\\\$(grep $facet_svc <<< \\\"\\\$params\\\");
7194                          [[ -z \\\$param ]] && param=\\\"\\\$params\\\";
7195                          while read s; do echo $facet \\\$s;
7196                          done <<< \\\"\\\$param\\\""
7197         done
7198 }
7199
7200 # restore lustre parameters from input stream, produces by save_lustre_params
7201 restore_lustre_params() {
7202         local facet
7203         local name
7204         local val
7205
7206         while IFS=" =" read facet name val; do
7207                 do_facet $facet "$LCTL set_param -n $name=$val"
7208         done
7209 }
7210
7211 check_node_health() {
7212         local nodes=${1:-$(comma_list $(nodes_list))}
7213
7214         for node in ${nodes//,/ }; do
7215                 check_network "$node" 5
7216                 if [ $? -eq 0 ]; then
7217                         do_node $node "rc=0;
7218                         val=\\\$($LCTL get_param -n catastrophe 2>&1);
7219                         if [[ \\\$? -eq 0 && \\\$val -ne 0 ]]; then
7220                                 echo \\\$(hostname -s): \\\$val;
7221                                 rc=\\\$val;
7222                         fi;
7223                         exit \\\$rc" || error "$node:LBUG/LASSERT detected"
7224                 fi
7225         done
7226 }
7227
7228 mdsrate_cleanup () {
7229         if [ -d $4 ]; then
7230                 mpi_run ${MACHINEFILE_OPTION} $2 -np $1 ${MDSRATE} --unlink \
7231                         --nfiles $3 --dir $4 --filefmt $5 $6
7232                 rmdir $4
7233         fi
7234 }
7235
7236 delayed_recovery_enabled () {
7237     local var=${SINGLEMDS}_svc
7238     do_facet $SINGLEMDS lctl get_param -n mdd.${!var}.stale_export_age > /dev/null 2>&1
7239 }
7240
7241 ########################
7242
7243 convert_facet2label() {
7244         local facet=$1
7245
7246         if [ x$facet = xost ]; then
7247                 facet=ost1
7248         elif [ x$facet = xmgs ] && combined_mgs_mds ; then
7249                 facet=mds1
7250         fi
7251
7252         local varsvc=${facet}_svc
7253
7254         if [ -n ${!varsvc} ]; then
7255                 echo ${!varsvc}
7256         else
7257                 error "No label for $facet!"
7258         fi
7259 }
7260
7261 get_clientosc_proc_path() {
7262         echo "${1}-osc-[-0-9a-f]*"
7263 }
7264
7265 # If the 2.0 MDS was mounted on 1.8 device, then the OSC and LOV names
7266 # used by MDT would not be changed.
7267 # mdt lov: fsname-mdtlov
7268 # mdt osc: fsname-OSTXXXX-osc
7269 mds_on_old_device() {
7270     local mds=${1:-"$SINGLEMDS"}
7271
7272     if [ $(lustre_version_code $mds) -gt $(version_code 1.9.0) ]; then
7273         do_facet $mds "lctl list_param osc.$FSNAME-OST*-osc \
7274             > /dev/null 2>&1" && return 0
7275     fi
7276     return 1
7277 }
7278
7279 get_mdtosc_proc_path() {
7280         local mds_facet=$1
7281         local ost_label=${2:-"*OST*"}
7282
7283         [ "$mds_facet" = "mds" ] && mds_facet=$SINGLEMDS
7284         local mdt_label=$(convert_facet2label $mds_facet)
7285         local mdt_index=$(echo $mdt_label | sed -e 's/^.*-//')
7286
7287         if [[ $ost_label = *OST* ]]; then
7288                 echo "${ost_label}-osc-${mdt_index}"
7289         else
7290                 echo "${ost_label}-osp-${mdt_index}"
7291         fi
7292 }
7293
7294 get_osc_import_name() {
7295     local facet=$1
7296     local ost=$2
7297     local label=$(convert_facet2label $ost)
7298
7299     if [ "${facet:0:3}" = "mds" ]; then
7300         get_mdtosc_proc_path $facet $label
7301         return 0
7302     fi
7303
7304     get_clientosc_proc_path $label
7305     return 0
7306 }
7307
7308 _wait_import_state () {
7309     local expected=$1
7310     local CONN_PROC=$2
7311     local maxtime=${3:-$(max_recovery_time)}
7312     local error_on_failure=${4:-1}
7313     local CONN_STATE
7314     local i=0
7315
7316         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
7317     while ! echo "${CONN_STATE}" | egrep -q "^${expected}\$" ; do
7318         if [ "${expected}" == "DISCONN" ]; then
7319             # for disconn we can check after proc entry is removed
7320             [ "x${CONN_STATE}" == "x" ] && return 0
7321             #  with AT enabled, we can have connect request timeout near of
7322             # reconnect timeout and test can't see real disconnect
7323             [ "${CONN_STATE}" == "CONNECTING" ] && return 0
7324         fi
7325         if [ $i -ge $maxtime ]; then
7326             [ $error_on_failure -ne 0 ] && \
7327                 error "can't put import for $CONN_PROC into ${expected}" \
7328                       "state after $i sec, have ${CONN_STATE}"
7329             return 1
7330         fi
7331         sleep 1
7332         # Add uniq for multi-mount case
7333         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
7334         i=$(($i + 1))
7335     done
7336
7337     log "$CONN_PROC in ${CONN_STATE} state after $i sec"
7338     return 0
7339 }
7340
7341 wait_import_state() {
7342     local state=$1
7343     local params=$2
7344     local maxtime=${3:-$(max_recovery_time)}
7345     local error_on_failure=${4:-1}
7346     local param
7347
7348     for param in ${params//,/ }; do
7349         _wait_import_state $state $param $maxtime $error_on_failure || return
7350     done
7351 }
7352
7353 wait_import_state_mount() {
7354         if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
7355                 return 0
7356         fi
7357
7358         wait_import_state $*
7359 }
7360
7361 # One client request could be timed out because server was not ready
7362 # when request was sent by client.
7363 # The request timeout calculation details :
7364 # ptl_send_rpc ()
7365 #      /* We give the server rq_timeout secs to process the req, and
7366 #      add the network latency for our local timeout. */
7367 #      request->rq_deadline = request->rq_sent + request->rq_timeout +
7368 #           ptlrpc_at_get_net_latency(request) ;
7369 #
7370 # ptlrpc_connect_import ()
7371 #      request->rq_timeout = INITIAL_CONNECT_TIMEOUT
7372 #
7373 # init_imp_at () ->
7374 #   -> at_init(&at->iat_net_latency, 0, 0) -> iat_net_latency=0
7375 # ptlrpc_at_get_net_latency(request) ->
7376 #       at_get (max (iat_net_latency=0, at_min)) = at_min
7377 #
7378 # i.e.:
7379 # request->rq_timeout + ptlrpc_at_get_net_latency(request) =
7380 # INITIAL_CONNECT_TIMEOUT + at_min
7381 #
7382 # We will use obd_timeout instead of INITIAL_CONNECT_TIMEOUT
7383 # because we can not get this value in runtime,
7384 # the value depends on configure options, and it is not stored in /proc.
7385 # obd_support.h:
7386 # #define CONNECTION_SWITCH_MIN 5U
7387 # #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
7388
7389 request_timeout () {
7390     local facet=$1
7391
7392     # request->rq_timeout = INITIAL_CONNECT_TIMEOUT
7393     local init_connect_timeout=$TIMEOUT
7394     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
7395
7396     local at_min=$(at_get $facet at_min)
7397
7398     echo $(( init_connect_timeout + at_min ))
7399 }
7400
7401 _wait_osc_import_state() {
7402         local facet=$1
7403         local ost_facet=$2
7404         local expected=$3
7405         local target=$(get_osc_import_name $facet $ost_facet)
7406         local param="os[cp].${target}.ost_server_uuid"
7407         local params=$param
7408         local i=0
7409
7410         # 1. wait the deadline of client 1st request (it could be skipped)
7411         # 2. wait the deadline of client 2nd request
7412         local maxtime=$(( 2 * $(request_timeout $facet)))
7413
7414         if [[ $facet == client* ]]; then
7415                 # During setup time, the osc might not be setup, it need wait
7416                 # until list_param can return valid value.
7417                 params=$($LCTL list_param $param 2>/dev/null || true)
7418                 while [ -z "$params" ]; do
7419                         if [ $i -ge $maxtime ]; then
7420                                 echo "can't get $param in $maxtime secs"
7421                                 return 1
7422                         fi
7423                         sleep 1
7424                         i=$((i + 1))
7425                         params=$($LCTL list_param $param 2>/dev/null || true)
7426                 done
7427         fi
7428
7429         if [[ $ost_facet = mds* ]]; then
7430                 # no OSP connection to itself
7431                 if [[ $facet = $ost_facet ]]; then
7432                         return 0
7433                 fi
7434                 param="osp.${target}.mdt_server_uuid"
7435                 params=$param
7436         fi
7437
7438         if ! do_rpc_nodes "$(facet_active_host $facet)" \
7439                         wait_import_state $expected "$params" $maxtime; then
7440                 error "$facet: import is not in $expected state after $maxtime"
7441                 return 1
7442         fi
7443
7444         return 0
7445 }
7446
7447 wait_osc_import_state() {
7448         local facet=$1
7449         local ost_facet=$2
7450         local expected=$3
7451         local num
7452
7453         if [[ $facet = mds ]]; then
7454                 for num in $(seq $MDSCOUNT); do
7455                         _wait_osc_import_state mds$num "$ost_facet" "$expected"
7456                 done
7457         else
7458                 _wait_osc_import_state "$facet" "$ost_facet" "$expected"
7459         fi
7460 }
7461
7462 wait_osc_import_ready() {
7463         wait_osc_import_state $1 $2 "\(FULL\|IDLE\)"
7464 }
7465
7466 _wait_mgc_import_state() {
7467         local facet=$1
7468         local expected=$2
7469         local error_on_failure=${3:-1}
7470         local param="mgc.*.mgs_server_uuid"
7471         local params=$param
7472         local i=0
7473
7474         # 1. wait the deadline of client 1st request (it could be skipped)
7475         # 2. wait the deadline of client 2nd request
7476         local maxtime=$(( 2 * $(request_timeout $facet)))
7477
7478         if [[ $facet == client* ]]; then
7479                 # During setup time, the osc might not be setup, it need wait
7480                 # until list_param can return valid value. And also if there
7481                 # are mulitple osc entries we should list all of them before
7482                 # go to wait.
7483                 params=$($LCTL list_param $param 2>/dev/null || true)
7484                 while [ -z "$params" ]; do
7485                         if [ $i -ge $maxtime ]; then
7486                                 echo "can't get $param in $maxtime secs"
7487                                 return 1
7488                         fi
7489                         sleep 1
7490                         i=$((i + 1))
7491                         params=$($LCTL list_param $param 2>/dev/null || true)
7492                 done
7493         fi
7494         if ! do_rpc_nodes "$(facet_active_host $facet)" \
7495                         wait_import_state $expected "$params" $maxtime \
7496                                           $error_on_failure; then
7497                 if [ $error_on_failure -ne 0 ]; then
7498                     error "import is not in ${expected} state"
7499                 fi
7500                 return 1
7501         fi
7502
7503         return 0
7504 }
7505
7506 wait_mgc_import_state() {
7507         local facet=$1
7508         local expected=$2
7509         local error_on_failure=${3:-1}
7510         local num
7511
7512         if [[ $facet = mds ]]; then
7513                 for num in $(seq $MDSCOUNT); do
7514                         _wait_mgc_import_state mds$num "$expected" \
7515                                                $error_on_failure || return
7516                 done
7517         else
7518                 _wait_mgc_import_state "$facet" "$expected"
7519                                        $error_on_failure || return
7520         fi
7521 }
7522
7523 wait_dne_interconnect() {
7524         local num
7525
7526         if [ $MDSCOUNT -gt 1 ]; then
7527                 for num in $(seq $MDSCOUNT); do
7528                         wait_osc_import_ready mds mds$num
7529                 done
7530         fi
7531 }
7532
7533 get_clientmdc_proc_path() {
7534     echo "${1}-mdc-*"
7535 }
7536
7537 get_clientmgc_proc_path() {
7538     echo "*"
7539 }
7540
7541 do_rpc_nodes () {
7542         local list=$1
7543         shift
7544
7545         [ -z "$list" ] && return 0
7546
7547         # Add paths to lustre tests for 32 and 64 bit systems.
7548         local LIBPATH="/usr/lib/lustre/tests:/usr/lib64/lustre/tests:"
7549         local TESTPATH="$RLUSTRE/tests:"
7550         local RPATH="PATH=${TESTPATH}${LIBPATH}${PATH}:/sbin:/bin:/usr/sbin:"
7551         do_nodesv $list "${RPATH} NAME=${NAME} bash rpc.sh $@ "
7552 }
7553
7554 wait_clients_import_state () {
7555         local list=$1
7556         local facet=$2
7557         local expected=$3
7558
7559         local facets=$facet
7560
7561         if [ "$FAILURE_MODE" = HARD ]; then
7562                 facets=$(facets_on_host $(facet_active_host $facet))
7563         fi
7564
7565         for facet in ${facets//,/ }; do
7566                 local label=$(convert_facet2label $facet)
7567                 local proc_path
7568                 case $facet in
7569                 ost* ) proc_path="osc.$(get_clientosc_proc_path \
7570                                   $label).ost_server_uuid" ;;
7571                 mds* ) proc_path="mdc.$(get_clientmdc_proc_path \
7572                                   $label).mds_server_uuid" ;;
7573                 mgs* ) proc_path="mgc.$(get_clientmgc_proc_path \
7574                                   $label).mgs_server_uuid" ;;
7575                 *) error "unknown facet!" ;;
7576                 esac
7577
7578                 local params=$(expand_list $params $proc_path)
7579         done
7580
7581         if ! do_rpc_nodes "$list" wait_import_state_mount "$expected" $params;
7582         then
7583                 error "import is not in ${expected} state"
7584                 return 1
7585         fi
7586 }
7587
7588 wait_osp_active() {
7589         local facet=$1
7590         local tgt_name=$2
7591         local tgt_idx=$3
7592         local expected=$4
7593         local num
7594
7595         # wait until all MDTs are in the expected state
7596         for ((num = 1; num <= $MDSCOUNT; num++)); do
7597                 local mdtosp=$(get_mdtosc_proc_path mds${num} ${tgt_name})
7598                 local wait=0
7599                 local mproc
7600
7601                 if [ $facet = "mds" ]; then
7602                         mproc="osp.$mdtosp.active"
7603                         [ $num -eq $((tgt_idx + 1)) ] && continue
7604                 else
7605                         mproc="osc.$mdtosp.active"
7606                 fi
7607
7608                 echo "check $mproc"
7609                 while [ 1 ]; do
7610                         sleep 5
7611                         local result=$(do_facet mds${num} "$LCTL get_param -n $mproc")
7612                         local max=30
7613
7614                         [ ${PIPESTATUS[0]} = 0 ] || error "Can't read $mproc"
7615                         if [ $result -eq $expected ]; then
7616                                 echo -n "target updated after "
7617                                 echo "$wait sec (got $result)"
7618                                 break
7619                         fi
7620                         wait=$((wait + 5))
7621                         if [ $wait -eq $max ]; then
7622                                 error "$tgt_name: wanted $expected got $result"
7623                         fi
7624                         echo "Waiting $((max - wait)) secs for $tgt_name"
7625                 done
7626         done
7627 }
7628
7629 oos_full() {
7630         local -a AVAILA
7631         local -a GRANTA
7632         local -a TOTALA
7633         local OSCFULL=1
7634         AVAILA=($(do_nodes $(comma_list $(osts_nodes)) \
7635                   $LCTL get_param obdfilter.*.kbytesavail))
7636         GRANTA=($(do_nodes $(comma_list $(osts_nodes)) \
7637                   $LCTL get_param -n obdfilter.*.tot_granted))
7638         TOTALA=($(do_nodes $(comma_list $(osts_nodes)) \
7639                   $LCTL get_param -n obdfilter.*.kbytestotal))
7640         for ((i=0; i<${#AVAILA[@]}; i++)); do
7641                 local -a AVAIL1=(${AVAILA[$i]//=/ })
7642                 local -a TOTAL=(${TOTALA[$i]//=/ })
7643                 GRANT=$((${GRANTA[$i]}/1024))
7644                 # allow 1% of total space in bavail because of delayed
7645                 # allocation with ZFS which might release some free space after
7646                 # txg commit.  For small devices, we set a mininum of 8MB
7647                 local LIMIT=$((${TOTAL} / 100 + 8000))
7648                 echo -n $(echo ${AVAIL1[0]} | cut -d"." -f2) avl=${AVAIL1[1]} \
7649                         grnt=$GRANT diff=$((AVAIL1[1] - GRANT)) limit=${LIMIT}
7650                 [ $((AVAIL1[1] - GRANT)) -lt $LIMIT ] && OSCFULL=0 && \
7651                         echo " FULL" || echo
7652         done
7653         return $OSCFULL
7654 }
7655
7656 list_pool() {
7657         echo -e "$(do_facet $SINGLEMDS $LCTL pool_list $1 | sed '1d')"
7658 }
7659
7660 check_pool_not_exist() {
7661         local fsname=${1%%.*}
7662         local poolname=${1##$fsname.}
7663         [[ $# -ne 1 ]] && return 0
7664         [[ x$poolname = x ]] &&  return 0
7665         list_pool $fsname | grep -w $1 && return 1
7666         return 0
7667 }
7668
7669 create_pool() {
7670         local fsname=${1%%.*}
7671         local poolname=${1##$fsname.}
7672
7673         stack_trap "destroy_test_pools $fsname" EXIT
7674         do_facet mgs lctl pool_new $1
7675         local RC=$?
7676         # get param should return err unless pool is created
7677         [[ $RC -ne 0 ]] && return $RC
7678
7679         for mds_id in $(seq $MDSCOUNT); do
7680                 local mdt_id=$((mds_id-1))
7681                 local lodname=$fsname-MDT$(printf "%04x" $mdt_id)-mdtlov
7682                 wait_update_facet mds$mds_id \
7683                         "lctl get_param -n lod.$lodname.pools.$poolname \
7684                                 2>/dev/null || echo foo" "" ||
7685                         error "mds$mds_id: pool_new failed $1"
7686         done
7687         wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
7688                 2>/dev/null || echo foo" "" || error "pool_new failed $1"
7689
7690         add_pool_to_list $1
7691         return $RC
7692 }
7693
7694 add_pool_to_list () {
7695         local fsname=${1%%.*}
7696         local poolname=${1##$fsname.}
7697
7698         local listvar=${fsname}_CREATED_POOLS
7699         local temp=${listvar}=$(expand_list ${!listvar} $poolname)
7700         eval export $temp
7701 }
7702
7703 remove_pool_from_list () {
7704         local fsname=${1%%.*}
7705         local poolname=${1##$fsname.}
7706
7707         local listvar=${fsname}_CREATED_POOLS
7708         local temp=${listvar}=$(exclude_items_from_list ${!listvar} $poolname)
7709         eval export $temp
7710 }
7711
7712 destroy_pool_int() {
7713         local ost
7714         local OSTS=$(list_pool $1)
7715         for ost in $OSTS; do
7716                 do_facet mgs lctl pool_remove $1 $ost
7717         done
7718         wait_update_facet $SINGLEMDS "lctl pool_list $1 | wc -l" "1" ||
7719                 error "MDS: pool_list $1 failed"
7720         do_facet mgs lctl pool_destroy $1
7721 }
7722
7723 # <fsname>.<poolname> or <poolname>
7724 destroy_pool() {
7725         local fsname=${1%%.*}
7726         local poolname=${1##$fsname.}
7727
7728         [[ x$fsname = x$poolname ]] && fsname=$FSNAME
7729
7730         local RC
7731
7732         check_pool_not_exist $fsname.$poolname
7733         [[ $? -eq 0 ]] && return 0
7734
7735         destroy_pool_int $fsname.$poolname
7736         RC=$?
7737         [[ $RC -ne 0 ]] && return $RC
7738         for mds_id in $(seq $MDSCOUNT); do
7739                 local mdt_id=$((mds_id-1))
7740                 local lodname=$fsname-MDT$(printf "%04x" $mdt_id)-mdtlov
7741                 wait_update_facet mds$mds_id \
7742                         "lctl get_param -n lod.$lodname.pools.$poolname \
7743                                 2>/dev/null || echo foo" "foo" ||
7744                         error "mds$mds_id: destroy pool failed $1"
7745         done
7746         wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
7747                 2>/dev/null || echo foo" "foo" || error "destroy pool failed $1"
7748
7749         remove_pool_from_list $fsname.$poolname
7750
7751         return $RC
7752 }
7753
7754 destroy_pools () {
7755         local fsname=${1:-$FSNAME}
7756         local poolname
7757         local listvar=${fsname}_CREATED_POOLS
7758
7759         [ x${!listvar} = x ] && return 0
7760
7761         echo "Destroy the created pools: ${!listvar}"
7762         for poolname in ${!listvar//,/ }; do
7763                 destroy_pool $fsname.$poolname
7764         done
7765 }
7766
7767 destroy_test_pools () {
7768         trap 0
7769         local fsname=${1:-$FSNAME}
7770         destroy_pools $fsname || true
7771 }
7772
7773 gather_logs () {
7774         local list=$1
7775
7776         local ts=$(date +%s)
7777         local docp=true
7778
7779         if [[ ! -f "$YAML_LOG" ]]; then
7780                 # init_logging is not performed before gather_logs,
7781                 # so the $LOGDIR needs to be checked here
7782                 check_shared_dir $LOGDIR && touch $LOGDIR/shared
7783         fi
7784
7785         [ -f $LOGDIR/shared ] && docp=false
7786
7787         # dump lustre logs, dmesg, and journal if GSS_SK=true
7788
7789         prefix="$TESTLOG_PREFIX.$TESTNAME"
7790         suffix="$ts.log"
7791         echo "Dumping lctl log to ${prefix}.*.${suffix}"
7792
7793         if [ -n "$CLIENTONLY" -o "$PDSH" == "no_dsh" ]; then
7794                 echo "Dumping logs only on local client."
7795                 $LCTL dk > ${prefix}.debug_log.$(hostname -s).${suffix}
7796                 dmesg > ${prefix}.dmesg.$(hostname -s).${suffix}
7797                 [ "$SHARED_KEY" = true ] && find $SK_PATH -name '*.key' -exec \
7798                         lgss_sk -r {} \; &> \
7799                         ${prefix}.ssk_keys.$(hostname -s).${suffix}
7800                 [ "$SHARED_KEY" = true ] && lctl get_param 'nodemap.*.*' > \
7801                         ${prefix}.nodemaps.$(hostname -s).${suffix}
7802                 [ "$GSS_SK" = true ] && keyctl show > \
7803                         ${prefix}.keyring.$(hostname -s).${suffix}
7804                 [ "$GSS_SK" = true ] && journalctl -a > \
7805                         ${prefix}.journal.$(hostname -s).${suffix}
7806                 return
7807         fi
7808
7809         do_nodesv $list \
7810                 "$LCTL dk > ${prefix}.debug_log.\\\$(hostname -s).${suffix};
7811                 dmesg > ${prefix}.dmesg.\\\$(hostname -s).${suffix}"
7812         if [ "$SHARED_KEY" = true ]; then
7813                 do_nodesv $list "find $SK_PATH -name '*.key' -exec \
7814                         lgss_sk -r {} \; &> \
7815                         ${prefix}.ssk_keys.\\\$(hostname -s).${suffix}"
7816                 do_facet mds1 "lctl get_param 'nodemap.*.*' > \
7817                         ${prefix}.nodemaps.\\\$(hostname -s).${suffix}"
7818         fi
7819         if [ "$GSS_SK" = true ]; then
7820                 do_nodesv $list "keyctl show > \
7821                         ${prefix}.keyring.\\\$(hostname -s).${suffix}"
7822                 do_nodesv $list "journalctl -a > \
7823                         ${prefix}.journal.\\\$(hostname -s).${suffix}"
7824         fi
7825
7826         if [ ! -f $LOGDIR/shared ]; then
7827                 do_nodes $list rsync -az "${prefix}.*.${suffix}" \
7828                          $HOSTNAME:$LOGDIR
7829         fi
7830 }
7831
7832 do_ls () {
7833     local mntpt_root=$1
7834     local num_mntpts=$2
7835     local dir=$3
7836     local i
7837     local cmd
7838     local pids
7839     local rc=0
7840
7841     for i in $(seq 0 $num_mntpts); do
7842         cmd="ls -laf ${mntpt_root}$i/$dir"
7843         echo + $cmd;
7844         $cmd > /dev/null &
7845         pids="$pids $!"
7846     done
7847     echo pids=$pids
7848     for pid in $pids; do
7849         wait $pid || rc=$?
7850     done
7851
7852     return $rc
7853 }
7854
7855 # check_and_start_recovery_timer()
7856 #       service_time = at_est2timeout(service_time);
7857 #       service_time += 2 * INITIAL_CONNECT_TIMEOUT;
7858 #       service_time += 2 * (CONNECTION_SWITCH_MAX + CONNECTION_SWITCH_INC);
7859
7860 #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN, obd_timeout/20)
7861 #define CONNECTION_SWITCH_MAX min(50, max(CONNECTION_SWITCH_MIN, obd_timeout))
7862 #define CONNECTION_SWITCH_MIN 5
7863 #define CONNECTION_SWITCH_INC 5
7864 max_recovery_time() {
7865         local init_connect_timeout=$((TIMEOUT / 20))
7866         ((init_connect_timeout >= 5)) || init_connect_timeout=5
7867
7868         local service_time=$(($(at_max_get client) * 9 / 4 + 5))
7869         service_time=$((service_time + 2 * (init_connect_timeout + 50 + 5)))
7870
7871         echo -n $service_time
7872 }
7873
7874 recovery_time_min() {
7875         local connection_switch_min=5
7876         local connection_switch_inc=5
7877         local connection_switch_max
7878         local reconnect_delay_max
7879         local initial_connect_timeout
7880         local max
7881         local timout_20
7882
7883         #connection_switch_max=min(50, max($connection_switch_min,$TIMEOUT)
7884         (($connection_switch_min > $TIMEOUT)) &&
7885                 max=$connection_switch_min || max=$TIMEOUT
7886         (($max < 50)) && connection_switch_max=$max || connection_switch_max=50
7887
7888         #initial_connect_timeout = max(connection_switch_min, obd_timeout/20)
7889         timeout_20=$((TIMEOUT/20))
7890         (($connection_switch_min > $timeout_20)) &&
7891                 initial_connect_timeout=$connection_switch_min ||
7892                 initial_connect_timeout=$timeout_20
7893
7894         reconnect_delay_max=$((connection_switch_max + connection_switch_inc + \
7895                                initial_connect_timeout))
7896         echo $((2 * reconnect_delay_max))
7897 }
7898
7899 get_clients_mount_count () {
7900         local clients=${CLIENTS:-$HOSTNAME}
7901
7902         # we need to take into account the clients mounts and
7903         # exclude mds/ost mounts if any;
7904         do_nodes $clients cat /proc/mounts | grep lustre |
7905                 grep -w $MOUNT | wc -l
7906 }
7907
7908 # gss functions
7909 PROC_CLI="srpc_info"
7910 PROC_CON="srpc_contexts"
7911
7912 combination()
7913 {
7914     local M=$1
7915     local N=$2
7916     local R=1
7917
7918     if [ $M -lt $N ]; then
7919         R=0
7920     else
7921         N=$((N + 1))
7922         while [ $N -lt $M ]; do
7923             R=$((R * N))
7924             N=$((N + 1))
7925         done
7926     fi
7927
7928     echo $R
7929     return 0
7930 }
7931
7932 calc_connection_cnt() {
7933         local dir=$1
7934
7935         # MDT->MDT = 2 * C(M, 2)
7936         # MDT->OST = M * O
7937         # CLI->OST = C * O
7938         # CLI->MDT = C * M
7939         comb_m2=$(combination $MDSCOUNT 2)
7940
7941         local num_clients=$(get_clients_mount_count)
7942
7943         local cnt_mdt2mdt=$((comb_m2 * 2))
7944         local cnt_mdt2ost=$((MDSCOUNT * OSTCOUNT))
7945         local cnt_cli2ost=$((num_clients * OSTCOUNT))
7946         local cnt_cli2mdt=$((num_clients * MDSCOUNT))
7947         if is_mounted $MOUNT2; then
7948                 cnt_cli2mdt=$((cnt_cli2mdt * 2))
7949                 cnt_cli2ost=$((cnt_cli2ost * 2))
7950         fi
7951         if local_mode; then
7952                 cnt_mdt2mdt=0
7953                 cnt_mdt2ost=0
7954                 cnt_cli2ost=2
7955                 cnt_cli2mdt=1
7956         fi
7957         local cnt_all2ost=$((cnt_mdt2ost + cnt_cli2ost))
7958         local cnt_all2mdt=$((cnt_mdt2mdt + cnt_cli2mdt))
7959         local cnt_all2all=$((cnt_mdt2ost + cnt_mdt2mdt \
7960                 + cnt_cli2ost + cnt_cli2mdt))
7961
7962         local var=cnt_$dir
7963         local res=${!var}
7964
7965         echo $res
7966 }
7967
7968 set_rule()
7969 {
7970     local tgt=$1
7971     local net=$2
7972     local dir=$3
7973     local flavor=$4
7974     local cmd="$tgt.srpc.flavor"
7975
7976     if [ $net == "any" ]; then
7977         net="default"
7978     fi
7979     cmd="$cmd.$net"
7980
7981     if [ $dir != "any" ]; then
7982         cmd="$cmd.$dir"
7983     fi
7984
7985     cmd="$cmd=$flavor"
7986     log "Setting sptlrpc rule: $cmd"
7987     do_facet mgs "$LCTL conf_param $cmd"
7988 }
7989
7990 count_contexts()
7991 {
7992         local output=$1
7993         local total_ctx=$(echo "$output" | grep -c "expire.*key.*hdl")
7994         echo $total_ctx
7995 }
7996
7997 count_flvr()
7998 {
7999     local output=$1
8000     local flavor=$2
8001     local count=0
8002
8003     rpc_flvr=`echo $flavor | awk -F - '{ print $1 }'`
8004     bulkspec=`echo $flavor | awk -F - '{ print $2 }'`
8005
8006     count=`echo "$output" | grep "rpc flavor" | grep $rpc_flvr | wc -l`
8007
8008     if [ "x$bulkspec" != "x" ]; then
8009         algs=`echo $bulkspec | awk -F : '{ print $2 }'`
8010
8011         if [ "x$algs" != "x" ]; then
8012             bulk_count=`echo "$output" | grep "bulk flavor" | grep $algs | wc -l`
8013         else
8014             bulk=`echo $bulkspec | awk -F : '{ print $1 }'`
8015             if [ $bulk == "bulkn" ]; then
8016                 bulk_count=`echo "$output" | grep "bulk flavor" \
8017                             | grep "null/null" | wc -l`
8018             elif [ $bulk == "bulki" ]; then
8019                 bulk_count=`echo "$output" | grep "bulk flavor" \
8020                             | grep "/null" | grep -v "null/" | wc -l`
8021             else
8022                 bulk_count=`echo "$output" | grep "bulk flavor" \
8023                             | grep -v "/null" | grep -v "null/" | wc -l`
8024             fi
8025         fi
8026
8027         [ $bulk_count -lt $count ] && count=$bulk_count
8028     fi
8029
8030     echo $count
8031 }
8032
8033 flvr_cnt_cli2mdt()
8034 {
8035     local flavor=$1
8036     local cnt
8037
8038     local clients=${CLIENTS:-$HOSTNAME}
8039
8040     for c in ${clients//,/ }; do
8041         local output=$(do_node $c lctl get_param -n \
8042                  mdc.*-*-mdc-*.$PROC_CLI 2>/dev/null)
8043         local tmpcnt=$(count_flvr "$output" $flavor)
8044         if $GSS_SK && [ $flavor != "null" ]; then
8045                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8046                 output=$(do_node $c lctl get_param -n \
8047                          mdc.*-MDT*-mdc-*.$PROC_CON 2>/dev/null)
8048                 local outcon=$(count_contexts "$output")
8049                 if [ "$outcon" -lt "$tmpcnt" ]; then
8050                         tmpcnt=$outcon
8051                 fi
8052         fi
8053         cnt=$((cnt + tmpcnt))
8054     done
8055     echo $cnt
8056 }
8057
8058 flvr_cnt_cli2ost()
8059 {
8060     local flavor=$1
8061     local cnt
8062
8063     local clients=${CLIENTS:-$HOSTNAME}
8064
8065     for c in ${clients//,/ }; do
8066         # reconnect if idle
8067         do_node $c lctl set_param osc.*.idle_connect=1 >/dev/null 2>&1
8068         local output=$(do_node $c lctl get_param -n \
8069                  osc.*OST*-osc-[^M][^D][^T]*.$PROC_CLI 2>/dev/null)
8070         local tmpcnt=$(count_flvr "$output" $flavor)
8071         if $GSS_SK && [ $flavor != "null" ]; then
8072                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8073                 output=$(do_node $c lctl get_param -n \
8074                          osc.*OST*-osc-[^M][^D][^T]*.$PROC_CON 2>/dev/null)
8075                 local outcon=$(count_contexts "$output")
8076                 if [ "$outcon" -lt "$tmpcnt" ]; then
8077                         tmpcnt=$outcon
8078                 fi
8079         fi
8080         cnt=$((cnt + tmpcnt))
8081     done
8082     echo $cnt
8083 }
8084
8085 flvr_cnt_mdt2mdt()
8086 {
8087     local flavor=$1
8088     local cnt=0
8089
8090     if [ $MDSCOUNT -le 1 ]; then
8091         echo 0
8092         return
8093     fi
8094
8095     for num in `seq $MDSCOUNT`; do
8096         local output=$(do_facet mds$num lctl get_param -n \
8097                 osp.*-MDT*osp-MDT*.$PROC_CLI 2>/dev/null)
8098         local tmpcnt=$(count_flvr "$output" $flavor)
8099         if $GSS_SK && [ $flavor != "null" ]; then
8100                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8101                 output=$(do_facet mds$num lctl get_param -n \
8102                         osp.*-MDT*osp-MDT*.$PROC_CON 2>/dev/null)
8103                 local outcon=$(count_contexts "$output")
8104                 if [ "$outcon" -lt "$tmpcnt" ]; then
8105                         tmpcnt=$outcon
8106                 fi
8107         fi
8108         cnt=$((cnt + tmpcnt))
8109     done
8110     echo $cnt;
8111 }
8112
8113 flvr_cnt_mdt2ost()
8114 {
8115     local flavor=$1
8116     local cnt=0
8117     local mdtosc
8118
8119     for num in `seq $MDSCOUNT`; do
8120         mdtosc=$(get_mdtosc_proc_path mds$num)
8121         mdtosc=${mdtosc/-MDT*/-MDT\*}
8122         local output=$(do_facet mds$num lctl get_param -n \
8123                        os[cp].$mdtosc.$PROC_CLI 2>/dev/null)
8124         local tmpcnt=$(count_flvr "$output" $flavor)
8125         if $GSS_SK && [ $flavor != "null" ]; then
8126                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8127                 output=$(do_facet mds$num lctl get_param -n \
8128                          os[cp].$mdtosc.$PROC_CON 2>/dev/null)
8129                 local outcon=$(count_contexts "$output")
8130                 if [ "$outcon" -lt "$tmpcnt" ]; then
8131                         tmpcnt=$outcon
8132                 fi
8133         fi
8134         cnt=$((cnt + tmpcnt))
8135     done
8136     echo $cnt;
8137 }
8138
8139 flvr_cnt_mgc2mgs()
8140 {
8141     local flavor=$1
8142
8143     local output=$(do_facet client lctl get_param -n mgc.*.$PROC_CLI \
8144                         2>/dev/null)
8145     count_flvr "$output" $flavor
8146 }
8147
8148 do_check_flavor()
8149 {
8150     local dir=$1        # from to
8151     local flavor=$2     # flavor expected
8152     local res=0
8153
8154     if [ $dir == "cli2mdt" ]; then
8155         res=`flvr_cnt_cli2mdt $flavor`
8156     elif [ $dir == "cli2ost" ]; then
8157         res=`flvr_cnt_cli2ost $flavor`
8158     elif [ $dir == "mdt2mdt" ]; then
8159         res=`flvr_cnt_mdt2mdt $flavor`
8160     elif [ $dir == "mdt2ost" ]; then
8161         res=`flvr_cnt_mdt2ost $flavor`
8162     elif [ $dir == "all2ost" ]; then
8163         res1=`flvr_cnt_mdt2ost $flavor`
8164         res2=`flvr_cnt_cli2ost $flavor`
8165         res=$((res1 + res2))
8166     elif [ $dir == "all2mdt" ]; then
8167         res1=`flvr_cnt_mdt2mdt $flavor`
8168         res2=`flvr_cnt_cli2mdt $flavor`
8169         res=$((res1 + res2))
8170     elif [ $dir == "all2all" ]; then
8171         res1=`flvr_cnt_mdt2ost $flavor`
8172         res2=`flvr_cnt_cli2ost $flavor`
8173         res3=`flvr_cnt_mdt2mdt $flavor`
8174         res4=`flvr_cnt_cli2mdt $flavor`
8175         res=$((res1 + res2 + res3 + res4))
8176     fi
8177
8178     echo $res
8179 }
8180
8181 wait_flavor()
8182 {
8183         local dir=$1        # from to
8184         local flavor=$2     # flavor expected
8185         local expect=${3:-$(calc_connection_cnt $dir)} # number expected
8186         local WAITFLAVOR_MAX=20 # how many retries before abort?
8187
8188         local res=0
8189         for ((i = 0; i < $WAITFLAVOR_MAX; i++)); do
8190                 echo -n "checking $dir..."
8191                 res=$(do_check_flavor $dir $flavor)
8192                 echo "found $res/$expect $flavor connections"
8193                 [ $res -ge $expect ] && return 0
8194                 sleep 4
8195         done
8196
8197         echo "Error checking $flavor of $dir: expect $expect, actual $res"
8198 #       echo "Dumping additional logs for SK debug.."
8199         do_nodes $(comma_list $(all_server_nodes)) "keyctl show"
8200         if $dump; then
8201                 gather_logs $(comma_list $(nodes_list))
8202         fi
8203         return 1
8204 }
8205
8206 restore_to_default_flavor()
8207 {
8208         local proc="mgs.MGS.live.$FSNAME"
8209
8210         echo "restoring to default flavor..."
8211
8212         local nrule=$(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8213                 grep ".srpc.flavor" | wc -l)
8214
8215         # remove all existing rules if any
8216         if [ $nrule -ne 0 ]; then
8217                 echo "$nrule existing rules"
8218                 for rule in $(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8219                     grep ".srpc.flavor."); do
8220                         echo "remove rule: $rule"
8221                         spec=`echo $rule | awk -F = '{print $1}'`
8222                         do_facet mgs "$LCTL conf_param -d $spec"
8223                 done
8224         fi
8225
8226         # verify no rules left
8227         nrule=$(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8228                 grep ".srpc.flavor." | wc -l)
8229         [ $nrule -ne 0 ] && error "still $nrule rules left"
8230
8231         # wait for default flavor to be applied
8232         if $GSS_SK; then
8233                 if $SK_S2S; then
8234                         set_rule $FSNAME any any $SK_FLAVOR
8235                         wait_flavor all2all $SK_FLAVOR
8236                 else
8237                         set_rule $FSNAME any cli2mdt $SK_FLAVOR
8238                         set_rule $FSNAME any cli2ost $SK_FLAVOR
8239                         wait_flavor cli2mdt $SK_FLAVOR
8240                         wait_flavor cli2ost $SK_FLAVOR
8241                 fi
8242                 echo "GSS_SK now at default flavor: $SK_FLAVOR"
8243         else
8244                 wait_flavor all2all null
8245         fi
8246 }
8247
8248 set_flavor_all()
8249 {
8250         local flavor=${1:-null}
8251
8252         echo "setting all flavor to $flavor"
8253
8254         # FIXME need parameter to this fn
8255         # and remove global vars
8256         local cnt_all2all=$(calc_connection_cnt all2all)
8257
8258         local res=$(do_check_flavor all2all $flavor)
8259         if [ $res -eq $cnt_all2all ]; then
8260                 echo "already have total $res $flavor connections"
8261                 return
8262         fi
8263
8264         echo "found $res $flavor out of total $cnt_all2all connections"
8265         restore_to_default_flavor
8266
8267         [[ $flavor = null ]] && return 0
8268
8269         if $GSS_SK && [ $flavor != "null" ]; then
8270                 if $SK_S2S; then
8271                         set_rule $FSNAME any any $flavor
8272                         wait_flavor all2all $flavor
8273                 else
8274                         set_rule $FSNAME any cli2mdt $flavor
8275                         set_rule $FSNAME any cli2ost $flavor
8276                         set_rule $FSNAME any mdt2ost null
8277                         set_rule $FSNAME any mdt2mdt null
8278                         wait_flavor cli2mdt $flavor
8279                         wait_flavor cli2ost $flavor
8280                 fi
8281                 echo "GSS_SK now at flavor: $flavor"
8282         else
8283                 set_rule $FSNAME any any $flavor
8284                 wait_flavor all2all $flavor
8285         fi
8286 }
8287
8288
8289 check_logdir() {
8290     local dir=$1
8291     # Checking for shared logdir
8292     if [ ! -d $dir ]; then
8293         # Not found. Create local logdir
8294         mkdir -p $dir
8295     else
8296         touch $dir/check_file.$(hostname -s)
8297     fi
8298     return 0
8299 }
8300
8301 check_write_access() {
8302         local dir=$1
8303         local list=${2:-$(comma_list $(nodes_list))}
8304         local node
8305         local file
8306
8307         for node in ${list//,/ }; do
8308                 file=$dir/check_file.$(short_nodename $node)
8309                 if [[ ! -f "$file" ]]; then
8310                         # Logdir not accessible/writable from this node.
8311                         return 1
8312                 fi
8313                 rm -f $file || return 1
8314         done
8315         return 0
8316 }
8317
8318 init_logging() {
8319         [[ -n $YAML_LOG ]] && return
8320         local save_umask=$(umask)
8321         umask 0000
8322
8323         export YAML_LOG=${LOGDIR}/results.yml
8324         mkdir -p $LOGDIR
8325         init_clients_lists
8326
8327         # If the yaml log already exists then we will just append to it
8328         if [ ! -f $YAML_LOG ]; then
8329                 if check_shared_dir $LOGDIR; then
8330                         touch $LOGDIR/shared
8331                         echo "Logging to shared log directory: $LOGDIR"
8332                 else
8333                         echo "Logging to local directory: $LOGDIR"
8334                 fi
8335
8336                 yml_nodes_file $LOGDIR >> $YAML_LOG
8337                 yml_results_file >> $YAML_LOG
8338         fi
8339
8340         umask $save_umask
8341
8342         # If modules are not yet loaded then older "lctl lustre_build_version"
8343         # will fail.  Use lctl build version instead.
8344         log "Client: $($LCTL lustre_build_version)"
8345         log "MDS: $(do_facet $SINGLEMDS $LCTL lustre_build_version 2>/dev/null||
8346                     do_facet $SINGLEMDS $LCTL --version)"
8347         log "OSS: $(do_facet ost1 $LCTL lustre_build_version 2> /dev/null ||
8348                     do_facet ost1 $LCTL --version)"
8349 }
8350
8351 log_test() {
8352     yml_log_test $1 >> $YAML_LOG
8353 }
8354
8355 log_test_status() {
8356      yml_log_test_status $@ >> $YAML_LOG
8357 }
8358
8359 log_sub_test_begin() {
8360     yml_log_sub_test_begin "$@" >> $YAML_LOG
8361 }
8362
8363 log_sub_test_end() {
8364     yml_log_sub_test_end "$@" >> $YAML_LOG
8365 }
8366
8367 run_llverdev()
8368 {
8369         local dev=$1
8370         local llverdev_opts=$2
8371         local devname=$(basename $1)
8372         local size=$(grep "$devname"$ /proc/partitions | awk '{print $3}')
8373         # loop devices aren't in /proc/partitions
8374         [ "x$size" == "x" ] && local size=$(ls -l $dev | awk '{print $5}')
8375
8376         size=$(($size / 1024 / 1024)) # Gb
8377
8378         local partial_arg=""
8379         # Run in partial (fast) mode if the size
8380         # of a partition > 1 GB
8381         [ $size -gt 1 ] && partial_arg="-p"
8382
8383         llverdev --force $partial_arg $llverdev_opts $dev
8384 }
8385
8386 run_llverfs()
8387 {
8388         local dir=$1
8389         local llverfs_opts=$2
8390         local use_partial_arg=$3
8391         local partial_arg=""
8392         local size=$(df -B G $dir |tail -n 1 |awk '{print $2}' |sed 's/G//') #GB
8393
8394         # Run in partial (fast) mode if the size
8395         # of a partition > 1 GB
8396         [ "x$use_partial_arg" != "xno" ] && [ $size -gt 1 ] && partial_arg="-p"
8397
8398         llverfs $partial_arg $llverfs_opts $dir
8399 }
8400
8401 #Remove objects from OST
8402 remove_ost_objects() {
8403         local facet=$1
8404         local ostdev=$2
8405         local group=$3
8406         shift 3
8407         local objids="$@"
8408         local mntpt=$(facet_mntpt $facet)
8409         local opts=$OST_MOUNT_OPTS
8410         local i
8411         local rc
8412
8413         echo "removing objects from $ostdev on $facet: $objids"
8414         if ! test -b $ostdev; then
8415                 opts=$(csa_add "$opts" -o loop)
8416         fi
8417         mount -t $(facet_fstype $facet) $opts $ostdev $mntpt ||
8418                 return $?
8419         rc=0
8420         for i in $objids; do
8421                 rm $mntpt/O/$group/d$((i % 32))/$i || { rc=$?; break; }
8422         done
8423         umount -f $mntpt || return $?
8424         return $rc
8425 }
8426
8427 #Remove files from MDT
8428 remove_mdt_files() {
8429         local facet=$1
8430         local mdtdev=$2
8431         shift 2
8432         local files="$@"
8433         local mntpt=$(facet_mntpt $facet)
8434         local opts=$MDS_MOUNT_OPTS
8435
8436         echo "removing files from $mdtdev on $facet: $files"
8437         if [ $(facet_fstype $facet) == ldiskfs ] &&
8438            ! do_facet $facet test -b $mdtdev; then
8439                 opts=$(csa_add "$opts" -o loop)
8440         fi
8441         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
8442                 return $?
8443         rc=0
8444         for f in $files; do
8445                 rm $mntpt/ROOT/$f || { rc=$?; break; }
8446         done
8447         umount -f $mntpt || return $?
8448         return $rc
8449 }
8450
8451 duplicate_mdt_files() {
8452         local facet=$1
8453         local mdtdev=$2
8454         shift 2
8455         local files="$@"
8456         local mntpt=$(facet_mntpt $facet)
8457         local opts=$MDS_MOUNT_OPTS
8458
8459         echo "duplicating files on $mdtdev on $facet: $files"
8460         mkdir -p $mntpt || return $?
8461         if [ $(facet_fstype $facet) == ldiskfs ] &&
8462            ! do_facet $facet test -b $mdtdev; then
8463                 opts=$(csa_add "$opts" -o loop)
8464         fi
8465         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
8466                 return $?
8467
8468     do_umount() {
8469         trap 0
8470         popd > /dev/null
8471         rm $tmp
8472         umount -f $mntpt
8473     }
8474     trap do_umount EXIT
8475
8476     tmp=$(mktemp $TMP/setfattr.XXXXXXXXXX)
8477     pushd $mntpt/ROOT > /dev/null || return $?
8478     rc=0
8479     for f in $files; do
8480         touch $f.bad || return $?
8481         getfattr -n trusted.lov $f | sed "s#$f#&.bad#" > $tmp
8482         rc=${PIPESTATUS[0]}
8483         [ $rc -eq 0 ] || return $rc
8484         setfattr --restore $tmp || return $?
8485     done
8486     do_umount
8487 }
8488
8489 run_sgpdd () {
8490     local devs=${1//,/ }
8491     shift
8492     local params=$@
8493     local rslt=$TMP/sgpdd_survey
8494
8495     # sgpdd-survey cleanups ${rslt}.* files
8496
8497     local cmd="rslt=$rslt $params scsidevs=\"$devs\" $SGPDDSURVEY"
8498     echo + $cmd
8499     eval $cmd
8500     cat ${rslt}.detail
8501 }
8502
8503 # returns the canonical name for an ldiskfs device
8504 ldiskfs_canon() {
8505         local dev="$1"
8506         local facet="$2"
8507
8508         do_facet $facet "dv=\\\$($LCTL get_param -n $dev);
8509                          if foo=\\\$(lvdisplay -c \\\$dv 2>/dev/null); then
8510                                 echo dm-\\\${foo##*:};
8511                          else
8512                                 name=\\\$(basename \\\$dv);
8513                                 if [[ \\\$name = *flakey* ]]; then
8514                                         name=\\\$(lsblk -o NAME,KNAME |
8515                                                 awk /\\\$name/'{print \\\$NF}');
8516                                 fi;
8517                                 echo \\\$name;
8518                          fi;"
8519 }
8520
8521 is_sanity_benchmark() {
8522     local benchmarks="dbench bonnie iozone fsx"
8523     local suite=$1
8524     for b in $benchmarks; do
8525         if [ "$b" == "$suite" ]; then
8526             return 0
8527         fi
8528     done
8529     return 1
8530 }
8531
8532 min_ost_size () {
8533         $LFS df | grep OST | awk '{print $4}' | sort -un | head -1
8534 }
8535
8536 #
8537 # Get the available size (KB) of a given obd target.
8538 #
8539 get_obd_size() {
8540         local facet=$1
8541         local obd=$2
8542         local size
8543
8544         [[ $facet != client ]] || return 0
8545
8546         size=$(do_facet $facet $LCTL get_param -n *.$obd.kbytesavail | head -n1)
8547         echo -n $size
8548 }
8549
8550 #
8551 # Get the page size (bytes) on a given facet node.
8552 # The local client page_size is directly available in PAGE_SIZE.
8553 #
8554 get_page_size() {
8555         local facet=$1
8556         local page_size=$(getconf PAGE_SIZE 2>/dev/null)
8557
8558         [ -z "$CLIENTONLY" -a "$facet" != "client" ] &&
8559                 page_size=$(do_facet $facet getconf PAGE_SIZE)
8560         echo -n ${page_size:-4096}
8561 }
8562
8563 #
8564 # Get the block count of the filesystem.
8565 #
8566 get_block_count() {
8567         local facet=$1
8568         local device=$2
8569         local count
8570
8571         [ -z "$CLIENTONLY" ] && count=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
8572                 awk '/^Block count:/ {print $3}')
8573         echo -n ${count:-0}
8574 }
8575
8576 # Get the block size of the filesystem.
8577 get_block_size() {
8578         local facet=$1
8579         local device=$2
8580         local size
8581
8582         [ -z "$CLIENTONLY" ] && size=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
8583                 awk '/^Block size:/ {print $3}')
8584         echo -n ${size:-0}
8585 }
8586
8587 # Check whether the "ea_inode" feature is enabled or not, to allow
8588 # ldiskfs xattrs over one block in size.  Allow both the historical
8589 # Lustre feature name (large_xattr) and the upstream name (ea_inode).
8590 large_xattr_enabled() {
8591         [[ $(facet_fstype $SINGLEMDS) == zfs ]] && return 1
8592
8593         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
8594
8595         do_facet $SINGLEMDS "$DUMPE2FS -h $mds_dev 2>&1 |
8596                 grep -E -q '(ea_inode|large_xattr)'"
8597         return ${PIPESTATUS[0]}
8598 }
8599
8600 # Get the maximum xattr size supported by the filesystem.
8601 max_xattr_size() {
8602         $LCTL get_param -n llite.*.max_easize
8603 }
8604
8605 # Dump the value of the named xattr from a file.
8606 get_xattr_value() {
8607     local xattr_name=$1
8608     local file=$2
8609
8610     echo "$(getfattr -n $xattr_name --absolute-names --only-values $file)"
8611 }
8612
8613 # Generate a string with size of $size bytes.
8614 generate_string() {
8615     local size=${1:-1024} # in bytes
8616
8617     echo "$(head -c $size < /dev/zero | tr '\0' y)"
8618 }
8619
8620 reformat_external_journal() {
8621         local facet=$1
8622         local var
8623
8624         var=${facet}_JRN
8625         if [ -n "${!var}" ]; then
8626                 local rcmd="do_facet $facet"
8627
8628                 echo "reformat external journal on $facet:${!var}"
8629                 ${rcmd} mke2fs -O journal_dev ${!var} || return 1
8630         fi
8631 }
8632
8633 # MDT file-level backup/restore
8634 mds_backup_restore() {
8635         local facet=$1
8636         local igif=$2
8637         local devname=$(mdsdevname $(facet_number $facet))
8638         local mntpt=$(facet_mntpt brpt)
8639         local rcmd="do_facet $facet"
8640         local metaea=${TMP}/backup_restore.ea
8641         local metadata=${TMP}/backup_restore.tgz
8642         local opts=${MDS_MOUNT_FS_OPTS}
8643         local svc=${facet}_svc
8644
8645         if ! ${rcmd} test -b ${devname}; then
8646                 opts=$(csa_add "$opts" -o loop)
8647         fi
8648
8649         echo "file-level backup/restore on $facet:${devname}"
8650
8651         # step 1: build mount point
8652         ${rcmd} mkdir -p $mntpt
8653         # step 2: cleanup old backup
8654         ${rcmd} rm -f $metaea $metadata
8655         # step 3: mount dev
8656         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
8657         if [ ! -z $igif ]; then
8658                 # step 3.5: rm .lustre
8659                 ${rcmd} rm -rf $mntpt/ROOT/.lustre || return 1
8660         fi
8661         # step 4: backup metaea
8662         echo "backup EA"
8663         ${rcmd} "cd $mntpt && getfattr -R -d -m '.*' -P . > $metaea && cd -" ||
8664                 return 2
8665         # step 5: backup metadata
8666         echo "backup data"
8667         ${rcmd} tar zcf $metadata -C $mntpt/ . > /dev/null 2>&1 || return 3
8668         # step 6: umount
8669         ${rcmd} $UMOUNT $mntpt || return 4
8670         # step 8: reformat dev
8671         echo "reformat new device"
8672         format_mdt $(facet_number $facet)
8673         # step 9: mount dev
8674         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 7
8675         # step 10: restore metadata
8676         echo "restore data"
8677         ${rcmd} tar zxfp $metadata -C $mntpt > /dev/null 2>&1 || return 8
8678         # step 11: restore metaea
8679         echo "restore EA"
8680         ${rcmd} "cd $mntpt && setfattr --restore=$metaea && cd - " || return 9
8681         # step 12: remove recovery logs
8682         echo "remove recovery logs"
8683         ${rcmd} rm -fv $mntpt/OBJECTS/* $mntpt/CATALOGS
8684         # step 13: umount dev
8685         ${rcmd} $UMOUNT $mntpt || return 10
8686         # step 14: cleanup tmp backup
8687         ${rcmd} rm -f $metaea $metadata
8688         # step 15: reset device label - it's not virgin on
8689         ${rcmd} e2label $devname ${!svc}
8690 }
8691
8692 # remove OI files
8693 mds_remove_ois() {
8694         local facet=$1
8695         local idx=$2
8696         local devname=$(mdsdevname $(facet_number $facet))
8697         local mntpt=$(facet_mntpt brpt)
8698         local rcmd="do_facet $facet"
8699         local opts=${MDS_MOUNT_FS_OPTS}
8700
8701         if ! ${rcmd} test -b ${devname}; then
8702                 opts=$(csa_add "$opts" -o loop)
8703         fi
8704
8705         echo "removing OI files on $facet: idx=${idx}"
8706
8707         # step 1: build mount point
8708         ${rcmd} mkdir -p $mntpt
8709         # step 2: mount dev
8710         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
8711         if [ -z $idx ]; then
8712                 # step 3: remove all OI files
8713                 ${rcmd} rm -fv $mntpt/oi.16*
8714         elif [ $idx -lt 2 ]; then
8715                 ${rcmd} rm -fv $mntpt/oi.16.${idx}
8716         else
8717                 local i
8718
8719                 # others, rm oi.16.[idx, idx * idx, idx ** ...]
8720                 for ((i=${idx}; i<64; i=$((i * idx)))); do
8721                         ${rcmd} rm -fv $mntpt/oi.16.${i}
8722                 done
8723         fi
8724         # step 4: umount
8725         ${rcmd} $UMOUNT $mntpt || return 2
8726         # OI files will be recreated when mounted as lustre next time.
8727 }
8728
8729 # generate maloo upload-able log file name
8730 # \param logname specify unique part of file name
8731 generate_logname() {
8732         local logname=${1:-"default_logname"}
8733
8734         echo "$TESTLOG_PREFIX.$TESTNAME.$logname.$(hostname -s).log"
8735 }
8736
8737 # make directory on different MDTs
8738 test_mkdir() {
8739         local path
8740         local p_option
8741         local hash_type
8742         local hash_name=("all_char" "fnv_1a_64" "crush")
8743         local dirstripe_count=${DIRSTRIPE_COUNT:-"2"}
8744         local dirstripe_index=${DIRSTRIPE_INDEX:-$((base % $MDSCOUNT))}
8745         local OPTIND=1
8746
8747         while getopts "c:H:i:p" opt; do
8748                 case $opt in
8749                         c) dirstripe_count=$OPTARG;;
8750                         H) hash_type=$OPTARG;;
8751                         i) dirstripe_index=$OPTARG;;
8752                         p) p_option="-p";;
8753                         \?) error "only support -c -H -i -p";;
8754                 esac
8755         done
8756
8757         shift $((OPTIND - 1))
8758         [ $# -eq 1 ] || error "Only creating single directory is supported"
8759         path="$*"
8760
8761         if [ "$p_option" == "-p" ]; then
8762                 local parent=$(dirname $path)
8763
8764                 [ -d $path ] && return 0
8765                 if [ ! -d ${parent} ]; then
8766                         mkdir -p ${parent} ||
8767                                 error "mkdir parent '$parent' failed"
8768                 fi
8769         fi
8770
8771         if [ $MDSCOUNT -le 1 ]; then
8772                 mkdir $path || error "mkdir '$path' failed"
8773         else
8774                 local mdt_index
8775
8776                 if [ $dirstripe_index -eq -1 ]; then
8777                         mdt_index=$((base % MDSCOUNT))
8778                 else
8779                         mdt_index=$dirstripe_index
8780                 fi
8781
8782                 # randomly choose hash type
8783                 [ -z "$hash_type" ] &&
8784                         hash_type=${hash_name[$((RANDOM % ${#hash_name[@]}))]}
8785
8786                 if (($MDS1_VERSION >= $(version_code 2.8.0))); then
8787                         if [ $dirstripe_count -eq -1 ]; then
8788                                 dirstripe_count=$((RANDOM % MDSCOUNT + 1))
8789                         fi
8790                 else
8791                         dirstripe_count=1
8792                 fi
8793
8794                 echo "striped dir -i$mdt_index -c$dirstripe_count -H $hash_type $path"
8795                 $LFS mkdir -i$mdt_index -c$dirstripe_count -H $hash_type $path ||
8796                         error "mkdir -i $mdt_index -c$dirstripe_count -H $hash_type $path failed"
8797         fi
8798 }
8799
8800 # free_fd: find the smallest and not in use file descriptor [above @last_fd]
8801 #
8802 # If called many times, passing @last_fd will avoid repeated searching
8803 # already-open FDs repeatedly if we know they are still in use.
8804 #
8805 # usage: free_fd [last_fd]
8806 free_fd()
8807 {
8808         local max_fd=$(ulimit -n)
8809         local fd=$((${1:-2} + 1))
8810
8811         while [[ $fd -le $max_fd && -e /proc/self/fd/$fd ]]; do
8812                 ((++fd))
8813         done
8814         [ $fd -lt $max_fd ] || error "finding free file descriptor failed"
8815         echo $fd
8816 }
8817
8818 check_mount_and_prep()
8819 {
8820         is_mounted $MOUNT || setupall
8821
8822         rm -rf $DIR/[df][0-9]* || error "Fail to cleanup the env!"
8823         mkdir $DIR/$tdir || error "Fail to mkdir $DIR/$tdir."
8824         for idx in $(seq $MDSCOUNT); do
8825                 local name="MDT$(printf '%04x' $((idx - 1)))"
8826                 rm -rf $MOUNT/.lustre/lost+found/$name/*
8827         done
8828 }
8829
8830 # calcule how many ost-objects to be created.
8831 precreated_ost_obj_count()
8832 {
8833         local mdt_idx=$1
8834         local ost_idx=$2
8835         local mdt_name="MDT$(printf '%04x' $mdt_idx)"
8836         local ost_name="OST$(printf '%04x' $ost_idx)"
8837         local proc_path="${FSNAME}-${ost_name}-osc-${mdt_name}"
8838         local last_id=$(do_facet mds$((mdt_idx + 1)) lctl get_param -n \
8839                         osp.$proc_path.prealloc_last_id)
8840         local next_id=$(do_facet mds$((mdt_idx + 1)) lctl get_param -n \
8841                         osp.$proc_path.prealloc_next_id)
8842         echo $((last_id - next_id + 1))
8843 }
8844
8845 check_file_in_pool()
8846 {
8847         local file=$1
8848         local pool=$2
8849         local tlist="$3"
8850         local res=$($LFS getstripe $file | grep 0x | cut -f2)
8851         for i in $res
8852         do
8853                 for t in $tlist ; do
8854                         [ "$i" -eq "$t" ] && continue 2
8855                 done
8856
8857                 echo "pool list: $tlist"
8858                 echo "striping: $res"
8859                 error_noexit "$file not allocated in $pool"
8860                 return 1
8861         done
8862         return 0
8863 }
8864
8865 pool_add() {
8866         echo "Creating new pool"
8867         local pool=$1
8868
8869         create_pool $FSNAME.$pool ||
8870                 { error_noexit "No pool created, result code $?"; return 1; }
8871         [ $($LFS pool_list $FSNAME | grep -c "$FSNAME.${pool}\$") -eq 1 ] ||
8872                 { error_noexit "$pool not in lfs pool_list"; return 2; }
8873 }
8874
8875 pool_add_targets() {
8876         echo "Adding targets to pool"
8877         local pool=$1
8878         local first=$2
8879         local last=$3
8880         local step=${4:-1}
8881
8882         if [ -z $last ]; then
8883                 local list=$first
8884         else
8885                 local list=$(seq $first $step $last)
8886         fi
8887
8888         local t=$(for i in $list; do printf "$FSNAME-OST%04x_UUID " $i; done)
8889         do_facet mgs $LCTL pool_add \
8890                         $FSNAME.$pool $FSNAME-OST[$first-$last/$step]
8891
8892         # wait for OSTs to be added to the pool
8893         for mds_id in $(seq $MDSCOUNT); do
8894                 local mdt_id=$((mds_id-1))
8895                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
8896                 wait_update_facet mds$mds_id \
8897                         "lctl get_param -n lod.$lodname.pools.$pool |
8898                                 sort -u | tr '\n' ' ' " "$t" || {
8899                         error_noexit "mds$mds_id: Add to pool failed"
8900                         return 3
8901                 }
8902         done
8903         wait_update $HOSTNAME "lctl get_param -n lov.$FSNAME-*.pools.$pool \
8904                         | sort -u | tr '\n' ' ' " "$t" || {
8905                 error_noexit "Add to pool failed"
8906                 return 1
8907         }
8908         local lfscount=$($LFS pool_list $FSNAME.$pool | grep -c "\-OST")
8909         local addcount=$(((last - first) / step + 1))
8910         [ $lfscount -eq $addcount ] || {
8911                 error_noexit "lfs pool_list bad ost count" \
8912                                                 "$lfscount != $addcount"
8913                 return 2
8914         }
8915 }
8916
8917 pool_set_dir() {
8918         local pool=$1
8919         local tdir=$2
8920         echo "Setting pool on directory $tdir"
8921
8922         $LFS setstripe -c 2 -p $pool $tdir && return 0
8923
8924         error_noexit "Cannot set pool $pool to $tdir"
8925         return 1
8926 }
8927
8928 pool_check_dir() {
8929         local pool=$1
8930         local tdir=$2
8931         echo "Checking pool on directory $tdir"
8932
8933         local res=$($LFS getstripe --pool $tdir | sed "s/\s*$//")
8934         [ "$res" = "$pool" ] && return 0
8935
8936         error_noexit "Pool on '$tdir' is '$res', not '$pool'"
8937         return 1
8938 }
8939
8940 pool_dir_rel_path() {
8941         echo "Testing relative path works well"
8942         local pool=$1
8943         local tdir=$2
8944         local root=$3
8945
8946         mkdir -p $root/$tdir/$tdir
8947         cd $root/$tdir
8948         pool_set_dir $pool $tdir          || return 1
8949         pool_set_dir $pool ./$tdir        || return 2
8950         pool_set_dir $pool ../$tdir       || return 3
8951         pool_set_dir $pool ../$tdir/$tdir || return 4
8952         rm -rf $tdir; cd - > /dev/null
8953 }
8954
8955 pool_alloc_files() {
8956         echo "Checking files allocation from directory pool"
8957         local pool=$1
8958         local tdir=$2
8959         local count=$3
8960         local tlist="$4"
8961
8962         local failed=0
8963         for i in $(seq -w 1 $count)
8964         do
8965                 local file=$tdir/file-$i
8966                 touch $file
8967                 check_file_in_pool $file $pool "$tlist" || \
8968                         failed=$((failed + 1))
8969         done
8970         [ "$failed" = 0 ] && return 0
8971
8972         error_noexit "$failed files not allocated in $pool"
8973         return 1
8974 }
8975
8976 pool_create_files() {
8977         echo "Creating files in pool"
8978         local pool=$1
8979         local tdir=$2
8980         local count=$3
8981         local tlist="$4"
8982
8983         mkdir -p $tdir
8984         local failed=0
8985         for i in $(seq -w 1 $count)
8986         do
8987                 local file=$tdir/spoo-$i
8988                 $LFS setstripe -p $pool $file
8989                 check_file_in_pool $file $pool "$tlist" || \
8990                         failed=$((failed + 1))
8991         done
8992         [ "$failed" = 0 ] && return 0
8993
8994         error_noexit "$failed files not allocated in $pool"
8995         return 1
8996 }
8997
8998 pool_lfs_df() {
8999         echo "Checking 'lfs df' output"
9000         local pool=$1
9001
9002         local t=$($LCTL get_param -n lov.$FSNAME-clilov-*.pools.$pool |
9003                         tr '\n' ' ')
9004         local res=$($LFS df --pool $FSNAME.$pool |
9005                         awk '{print $1}' |
9006                         grep "$FSNAME-OST" |
9007                         tr '\n' ' ')
9008         [ "$res" = "$t" ] && return 0
9009
9010         error_noexit "Pools OSTs '$t' is not '$res' that lfs df reports"
9011         return 1
9012 }
9013
9014 pool_file_rel_path() {
9015         echo "Creating files in a pool with relative pathname"
9016         local pool=$1
9017         local tdir=$2
9018
9019         mkdir -p $tdir ||
9020                 { error_noexit "unable to create $tdir"; return 1 ; }
9021         local file="/..$tdir/$tfile-1"
9022         $LFS setstripe -p $pool $file ||
9023                 { error_noexit "unable to create $file" ; return 2 ; }
9024
9025         cd $tdir
9026         $LFS setstripe -p $pool $tfile-2 || {
9027                 error_noexit "unable to create $tfile-2 in $tdir"
9028                 return 3
9029         }
9030 }
9031
9032 pool_remove_first_target() {
9033         echo "Removing first target from a pool"
9034         local pool=$1
9035
9036         local pname="lov.$FSNAME-*.pools.$pool"
9037         local t=$($LCTL get_param -n $pname | head -1)
9038         do_facet mgs $LCTL pool_remove $FSNAME.$pool $t
9039         for mds_id in $(seq $MDSCOUNT); do
9040                 local mdt_id=$((mds_id-1))
9041                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
9042                 wait_update_facet mds$mds_id \
9043                         "lctl get_param -n lod.$lodname.pools.$pool |
9044                                 grep $t" "" || {
9045                         error_noexit "mds$mds_id: $t not removed from" \
9046                         "$FSNAME.$pool"
9047                         return 2
9048                 }
9049         done
9050         wait_update $HOSTNAME "lctl get_param -n $pname | grep $t" "" || {
9051                 error_noexit "$t not removed from $FSNAME.$pool"
9052                 return 1
9053         }
9054 }
9055
9056 pool_remove_all_targets() {
9057         echo "Removing all targets from pool"
9058         local pool=$1
9059         local file=$2
9060         local pname="lov.$FSNAME-*.pools.$pool"
9061         for t in $($LCTL get_param -n $pname | sort -u)
9062         do
9063                 do_facet mgs $LCTL pool_remove $FSNAME.$pool $t
9064         done
9065         for mds_id in $(seq $MDSCOUNT); do
9066                 local mdt_id=$((mds_id-1))
9067                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
9068                 wait_update_facet mds$mds_id "lctl get_param -n \
9069                         lod.$lodname.pools.$pool" "" || {
9070                         error_noexit "mds$mds_id: Pool $pool not drained"
9071                         return 4
9072                 }
9073         done
9074         wait_update $HOSTNAME "lctl get_param -n $pname" "" || {
9075                 error_noexit "Pool $FSNAME.$pool cannot be drained"
9076                 return 1
9077         }
9078         # striping on an empty/nonexistant pool should fall back
9079         # to "pool of everything"
9080         touch $file || {
9081                 error_noexit "failed to use fallback striping for empty pool"
9082                 return 2
9083         }
9084         # setstripe on an empty pool should fail
9085         $LFS setstripe -p $pool $file 2>/dev/null && {
9086                 error_noexit "expected failure when creating file" \
9087                                                         "with empty pool"
9088                 return 3
9089         }
9090         return 0
9091 }
9092
9093 pool_remove() {
9094         echo "Destroying pool"
9095         local pool=$1
9096         local file=$2
9097
9098         do_facet mgs $LCTL pool_destroy $FSNAME.$pool
9099
9100         sleep 2
9101         # striping on an empty/nonexistant pool should fall back
9102         # to "pool of everything"
9103         touch $file || {
9104                 error_noexit "failed to use fallback striping for missing pool"
9105                 return 1
9106         }
9107         # setstripe on an empty pool should fail
9108         $LFS setstripe -p $pool $file 2>/dev/null && {
9109                 error_noexit "expected failure when creating file" \
9110                                                         "with missing pool"
9111                 return 2
9112         }
9113
9114         # get param should return err once pool is gone
9115         if wait_update $HOSTNAME "lctl get_param -n \
9116                 lov.$FSNAME-*.pools.$pool 2>/dev/null || echo foo" "foo"
9117         then
9118                 remove_pool_from_list $FSNAME.$pool
9119                 return 0
9120         fi
9121         error_noexit "Pool $FSNAME.$pool is not destroyed"
9122         return 3
9123 }
9124
9125 # Get and check the actual stripe count of one file.
9126 # Usage: check_stripe_count <file> <expected_stripe_count>
9127 check_stripe_count() {
9128         local file=$1
9129         local expected=$2
9130         local actual
9131
9132         [[ -z "$file" || -z "$expected" ]] &&
9133                 error "check_stripe_count: invalid argument"
9134
9135         local cmd="$LFS getstripe -c $file"
9136         actual=$($cmd) || error "$cmd failed"
9137         actual=${actual%% *}
9138
9139         if [[ $actual -ne $expected ]]; then
9140                 [[ $expected -eq -1 ]] || { $LFS getstripe $file;
9141                         error "$cmd not expected ($expected): found $actual"; }
9142                 [[ $actual -eq $OSTCOUNT ]] || { $LFS getstripe $file;
9143                         error "$cmd not OST count ($OSTCOUNT): found $actual"; }
9144         fi
9145 }
9146
9147 # Get and check the actual list of OST indices on one file.
9148 # Usage: check_obdidx <file> <expected_comma_separated_list_of_ost_indices>
9149 check_obdidx() {
9150         local file=$1
9151         local expected=$2
9152         local obdidx
9153
9154         [[ -z "$file" || -z "$expected" ]] &&
9155                 error "check_obdidx: invalid argument!"
9156
9157         obdidx=$(comma_list $($LFS getstripe $file | grep -A $OSTCOUNT obdidx |
9158                               grep -v obdidx | awk '{print $1}' | xargs))
9159
9160         [[ $obdidx = $expected ]] ||
9161                 error "list of OST indices on $file is $obdidx," \
9162                       "should be $expected"
9163 }
9164
9165 # Get and check the actual OST index of the first stripe on one file.
9166 # Usage: check_start_ost_idx <file> <expected_start_ost_idx>
9167 check_start_ost_idx() {
9168         local file=$1
9169         local expected=$2
9170         local start_ost_idx
9171
9172         [[ -z "$file" || -z "$expected" ]] &&
9173                 error "check_start_ost_idx: invalid argument!"
9174
9175         start_ost_idx=$($LFS getstripe $file | grep -A 1 obdidx |
9176                          grep -v obdidx | awk '{print $1}')
9177
9178         [[ $start_ost_idx = $expected ]] ||
9179                 error "OST index of the first stripe on $file is" \
9180                       "$start_ost_idx, should be $expected"
9181 }
9182
9183 killall_process () {
9184         local clients=${1:-$(hostname)}
9185         local name=$2
9186         local signal=$3
9187         local rc=0
9188
9189         do_nodes $clients "killall $signal $name"
9190 }
9191
9192 lsnapshot_create()
9193 {
9194         do_facet mgs "$LCTL snapshot_create -F $FSNAME $*"
9195 }
9196
9197 lsnapshot_destroy()
9198 {
9199         do_facet mgs "$LCTL snapshot_destroy -F $FSNAME $*"
9200 }
9201
9202 lsnapshot_modify()
9203 {
9204         do_facet mgs "$LCTL snapshot_modify -F $FSNAME $*"
9205 }
9206
9207 lsnapshot_list()
9208 {
9209         do_facet mgs "$LCTL snapshot_list -F $FSNAME $*"
9210 }
9211
9212 lsnapshot_mount()
9213 {
9214         do_facet mgs "$LCTL snapshot_mount -F $FSNAME $*"
9215 }
9216
9217 lsnapshot_umount()
9218 {
9219         do_facet mgs "$LCTL snapshot_umount -F $FSNAME $*"
9220 }
9221
9222 lss_err()
9223 {
9224         local msg=$1
9225
9226         do_facet mgs "cat $LSNAPSHOT_LOG"
9227         error $msg
9228 }
9229
9230 lss_cleanup()
9231 {
9232         echo "Cleaning test environment ..."
9233
9234         # Every lsnapshot command takes exclusive lock with others,
9235         # so can NOT destroy the snapshot during list with 'xargs'.
9236         while true; do
9237                 local ssname=$(lsnapshot_list | grep snapshot_name |
9238                         grep lss_ | awk '{ print $2 }' | head -n 1)
9239                 [ -z "$ssname" ] && break
9240
9241                 lsnapshot_destroy -n $ssname -f ||
9242                         lss_err "Fail to destroy $ssname by force"
9243         done
9244 }
9245
9246 lss_gen_conf_one()
9247 {
9248         local facet=$1
9249         local role=$2
9250         local idx=$3
9251
9252         local host=$(facet_active_host $facet)
9253         local dir=$(dirname $(facet_vdevice $facet))
9254         local pool=$(zpool_name $facet)
9255         local lfsname=$(zfs_local_fsname $facet)
9256         local label=${FSNAME}-${role}$(printf '%04x' $idx)
9257
9258         do_facet mgs \
9259                 "echo '$host - $label zfs:${dir}/${pool}/${lfsname} - -' >> \
9260                 $LSNAPSHOT_CONF"
9261 }
9262
9263 lss_gen_conf()
9264 {
9265         do_facet mgs "rm -f $LSNAPSHOT_CONF"
9266         echo "Generating $LSNAPSHOT_CONF on MGS ..."
9267
9268         if ! combined_mgs_mds ; then
9269                 [ $(facet_fstype mgs) != zfs ] &&
9270                         skip "Lustre snapshot 1 only works for ZFS backend"
9271
9272                 local host=$(facet_active_host mgs)
9273                 local dir=$(dirname $(facet_vdevice mgs))
9274                 local pool=$(zpool_name mgs)
9275                 local lfsname=$(zfs_local_fsname mgs)
9276
9277                 do_facet mgs \
9278                         "echo '$host - MGS zfs:${dir}/${pool}/${lfsname} - -' \
9279                         >> $LSNAPSHOT_CONF" || lss_err "generate lss conf (mgs)"
9280         fi
9281
9282         for num in `seq $MDSCOUNT`; do
9283                 [ $(facet_fstype mds$num) != zfs ] &&
9284                         skip "Lustre snapshot 1 only works for ZFS backend"
9285
9286                 lss_gen_conf_one mds$num MDT $((num - 1)) ||
9287                         lss_err "generate lss conf (mds$num)"
9288         done
9289
9290         for num in `seq $OSTCOUNT`; do
9291                 [ $(facet_fstype ost$num) != zfs ] &&
9292                         skip "Lustre snapshot 1 only works for ZFS backend"
9293
9294                 lss_gen_conf_one ost$num OST $((num - 1)) ||
9295                         lss_err "generate lss conf (ost$num)"
9296         done
9297
9298         do_facet mgs "cat $LSNAPSHOT_CONF"
9299 }
9300
9301 # Parse 'lfs getstripe -d <path_with_dir_name>' for non-composite dir
9302 parse_plain_dir_param()
9303 {
9304         local invalues=($1)
9305         local param=""
9306
9307         if [[ ${invalues[0]} =~ "stripe_count:" ]]; then
9308                 param="-c ${invalues[1]}"
9309         fi
9310         if [[ ${invalues[2]} =~ "stripe_size:" ]]; then
9311                 param="$param -S ${invalues[3]}"
9312         fi
9313         if [[ ${invalues[4]} =~ "pattern:" ]]; then
9314                 if [[ ${invalues[5]} =~ "stripe_offset:" ]]; then
9315                         param="$param -i ${invalues[6]}"
9316                 else
9317                         param="$param -L ${invalues[5]} -i ${invalues[7]}"
9318                 fi
9319         elif [[ ${invalues[4]} =~ "stripe_offset:" ]]; then
9320                 param="$param -i ${invalues[5]}"
9321         fi
9322         echo "$param"
9323 }
9324
9325 parse_plain_param()
9326 {
9327         local line=$1
9328         local val=$(awk '{print $2}' <<< $line)
9329
9330         if [[ $line =~ ^"lmm_stripe_count:" ]]; then
9331                 echo "-c $val"
9332         elif [[ $line =~ ^"lmm_stripe_size:" ]]; then
9333                 echo "-S $val"
9334         elif [[ $line =~ ^"lmm_stripe_offset:" ]]; then
9335                 echo "-i $val"
9336         elif [[ $line =~ ^"lmm_pattern:" ]]; then
9337                 echo "-L $val"
9338         fi
9339 }
9340
9341 parse_layout_param()
9342 {
9343         local mode=""
9344         local val=""
9345         local param=""
9346
9347         while read line; do
9348                 if [[ ! -z $line ]]; then
9349                         if [[ -z $mode ]]; then
9350                                 if [[ $line =~ ^"stripe_count:" ]]; then
9351                                         mode="plain_dir"
9352                                 elif [[ $line =~ ^"lmm_stripe_count:" ]]; then
9353                                         mode="plain_file"
9354                                 elif [[ $line =~ ^"lcm_layout_gen:" ]]; then
9355                                         mode="pfl"
9356                                 fi
9357                         fi
9358
9359                         if [[ $mode = "plain_dir" ]]; then
9360                                 param=$(parse_plain_dir_param "$line")
9361                         elif [[ $mode = "plain_file" ]]; then
9362                                 val=$(parse_plain_param "$line")
9363                                 [[ ! -z $val ]] && param="$param $val"
9364                         elif [[ $mode = "pfl" ]]; then
9365                                 val=$(echo $line | awk '{print $2}')
9366                                 if [[ $line =~ ^"lcme_extent.e_end:" ]]; then
9367                                         if [[ $val = "EOF" ]]; then
9368                                                 param="$param -E -1"
9369                                         else
9370                                                 param="$param -E $val"
9371                                         fi
9372                                 elif [[ $line =~ ^"stripe_count:" ]]; then
9373                                         # pfl dir
9374                                         val=$(parse_plain_dir_param "$line")
9375                                         param="$param $val"
9376                                 else
9377                                         #pfl file
9378                                         val=$(parse_plain_param "$line")
9379                                         [[ ! -z $val ]] && param="$param $val"
9380                                 fi
9381                         fi
9382                 fi
9383         done
9384         echo "$param"
9385 }
9386
9387 get_layout_param()
9388 {
9389         local param=$($LFS getstripe -d $1 | parse_layout_param)
9390         echo "$param"
9391 }
9392
9393 lfsck_verify_pfid()
9394 {
9395         local f
9396         local rc=0
9397
9398         # Cancel locks before setting lfsck_verify_pfid so that errors are more
9399         # controllable
9400         cancel_lru_locks mdc
9401         cancel_lru_locks osc
9402
9403         # make sure PFID is set correctly for files
9404         do_nodes $(comma_list $(osts_nodes)) \
9405                "$LCTL set_param -n obdfilter.${FSNAME}-OST*.lfsck_verify_pfid=1"
9406
9407         for f in "$@"; do
9408                 cat $f &> /dev/nullA ||
9409                         { rc=$?; echo "verify $f failed"; break; }
9410         done
9411
9412         do_nodes $(comma_list $(osts_nodes)) \
9413                "$LCTL set_param -n obdfilter.${FSNAME}-OST*.lfsck_verify_pfid=0"
9414         return $rc
9415 }
9416
9417 # check that clients "oscs" was evicted after "before"
9418 check_clients_evicted() {
9419         local before=$1
9420         shift
9421         local oscs=${@}
9422         local osc
9423         local rc=0
9424
9425         for osc in $oscs; do
9426                 ((rc++))
9427                 echo "Check state for $osc"
9428                 local evicted=$(do_facet client $LCTL get_param osc.$osc.state |
9429                         tail -n 3 | awk -F"[ [,]" \
9430                         '/EVICTED ]$/ { if (mx<$5) {mx=$5;} } END { print mx }')
9431                 if (($? == 0)) && (($evicted > $before)); then
9432                         echo "$osc is evicted at $evicted"
9433                         ((rc--))
9434                 fi
9435         done
9436
9437         [ $rc -eq 0 ] || error "client not evicted from OST"
9438 }
9439
9440 # check that clients OSCS current_state is FULL
9441 check_clients_full() {
9442         local timeout=$1
9443         shift
9444         local oscs=${@}
9445
9446         for osc in $oscs; do
9447                 wait_update_facet client \
9448                         "lctl get_param -n osc.$osc.state |
9449                         grep 'current_state: FULL'" \
9450                         "current_state: FULL" $timeout
9451                 [ $? -eq 0 ] || error "$osc state is not FULL"
9452         done
9453 }
9454
9455 #Changelogs
9456 __changelog_deregister() {
9457         local facet=$1
9458         local mdt="$(facet_svc $facet)"
9459         local cl_user=$2
9460         local rc=0
9461
9462         # skip cleanup if no user registered for this MDT
9463         [ -z "$cl_user" ] && echo "$mdt: no changelog user" && return 0
9464         # user is no longer registered, skip cleanup
9465         changelog_users "$facet" | grep -q "$cl_user" ||
9466                 { echo "$mdt: changelog user '$cl_user' not found"; return 0; }
9467
9468         # From this point, if any operation fails, it is an error
9469         __changelog_clear $facet $cl_user 0 ||
9470                 error_noexit "$mdt: changelog_clear $cl_user 0 fail: $rc"
9471         do_facet $facet $LCTL --device $mdt changelog_deregister $cl_user ||
9472                 error_noexit "$mdt: changelog_deregister '$cl_user' fail: $rc"
9473 }
9474
9475 declare -Ax CL_USERS
9476 changelog_register() {
9477         for M in $(seq $MDSCOUNT); do
9478                 local facet=mds$M
9479                 local mdt="$(facet_svc $facet)"
9480                 local cl_mask
9481
9482                 cl_mask=$(do_facet $facet $LCTL get_param \
9483                              mdd.${mdt}.changelog_mask -n)
9484                 stack_trap "do_facet $facet $LCTL \
9485                         set_param mdd.$mdt.changelog_mask=\'$cl_mask\' -n" EXIT
9486                 do_facet $facet $LCTL set_param mdd.$mdt.changelog_mask=+hsm ||
9487                         error "$mdt: changelog_mask=+hsm failed: $?"
9488
9489                 local cl_user
9490                 cl_user=$(do_facet $facet \
9491                                   $LCTL --device $mdt changelog_register -n) ||
9492                         error "$mdt: register changelog user failed: $?"
9493                 stack_trap "__changelog_deregister $facet $cl_user" EXIT
9494
9495                 stack_trap "CL_USERS[$facet]='${CL_USERS[$facet]}'" EXIT
9496                 # Bash does not support nested arrays, but the format of a
9497                 # cl_user is constrained enough to use whitespaces as separators
9498                 CL_USERS[$facet]+="$cl_user "
9499         done
9500         echo "Registered $MDSCOUNT changelog users: '${CL_USERS[@]% }'"
9501 }
9502
9503 changelog_deregister() {
9504         local cl_user
9505         # bash assoc arrays do not guarantee to list keys in created order
9506         # so reorder to get same order than in changelog_register()
9507         local cl_facets=$(echo "${!CL_USERS[@]}" | tr " " "\n" | sort |
9508                           tr "\n" " ")
9509
9510         for facet in $cl_facets; do
9511                 for cl_user in ${CL_USERS[$facet]}; do
9512                         __changelog_deregister $facet $cl_user || return $?
9513                 done
9514                 unset CL_USERS[$facet]
9515         done
9516 }
9517
9518 changelog_users() {
9519         local facet=$1
9520         local service=$(facet_svc $facet)
9521
9522         do_facet $facet $LCTL get_param -n mdd.$service.changelog_users
9523 }
9524
9525 changelog_user_rec() {
9526         local facet=$1
9527         local cl_user=$2
9528         local service=$(facet_svc $facet)
9529
9530         changelog_users $facet | awk '$1 == "'$cl_user'" { print $2 }'
9531 }
9532
9533 changelog_chmask() {
9534         local mask=$1
9535
9536         do_nodes $(comma_list $(mdts_nodes)) \
9537                 $LCTL set_param mdd.*.changelog_mask="$mask"
9538 }
9539
9540 # usage: __changelog_clear FACET CL_USER [+]INDEX
9541 __changelog_clear()
9542 {
9543         local facet=$1
9544         local mdt="$(facet_svc $facet)"
9545         local cl_user=$2
9546         local -i rec
9547
9548         case "$3" in
9549         +*)
9550                 # Remove the leading '+'
9551                 rec=${3:1}
9552                 rec+=$(changelog_user_rec $facet $cl_user)
9553                 ;;
9554         *)
9555                 rec=$3
9556                 ;;
9557         esac
9558
9559         if [ $rec -eq 0 ]; then
9560                 echo "$mdt: clear the changelog for $cl_user of all records"
9561         else
9562                 echo "$mdt: clear the changelog for $cl_user to record #$rec"
9563         fi
9564         $LFS changelog_clear $mdt $cl_user $rec
9565 }
9566
9567 # usage: changelog_clear [+]INDEX
9568 #
9569 # If INDEX is prefixed with '+', increment every changelog user's record index
9570 # by INDEX. Otherwise, clear the changelog up to INDEX for every changelog
9571 # users.
9572 changelog_clear() {
9573         local rc
9574         # bash assoc arrays do not guarantee to list keys in created order
9575         # so reorder to get same order than in changelog_register()
9576         local cl_facets=$(echo "${!CL_USERS[@]}" | tr " " "\n" | sort |
9577                           tr "\n" " ")
9578
9579         for facet in $cl_facets; do
9580                 for cl_user in ${CL_USERS[$facet]}; do
9581                         __changelog_clear $facet $cl_user $1 || rc=${rc:-$?}
9582                 done
9583         done
9584
9585         return ${rc:-0}
9586 }
9587
9588 changelog_dump() {
9589         for M in $(seq $MDSCOUNT); do
9590                 local facet=mds$M
9591                 local mdt="$(facet_svc $facet)"
9592
9593                 $LFS changelog $mdt | sed -e 's/^/'$mdt'./'
9594         done
9595 }
9596
9597 changelog_extract_field() {
9598         local cltype=$1
9599         local file=$2
9600         local identifier=$3
9601
9602         changelog_dump | gawk "/$cltype.*$file$/ {
9603                 print gensub(/^.* "$identifier'(\[[^\]]*\]).*$/,"\\1",1)}' |
9604                 tail -1
9605 }
9606
9607 # Prints a changelog record produced by "lfs changelog" as an associative array
9608 #
9609 # Example:
9610 # $> changelog2array 16 01CREAT 10:28:46.968438800 2018.03.09 0x0 \
9611 #                    t=[0x200000401:0x10:0x0] j=touch.501 ef=0xf u=501:501 \
9612 #                    nid=0@lo p=[0x200000007:0x1:0x0] blob
9613 # ([index]='16' [type]='CREAT' [time]='10:28:46.968438800'
9614 #  [date]='2018.03.09' [flags]=0x0 ['target-fid']='[0x200000401:0x10:0x0]'
9615 #  ['jobid']='touch.501' ['extra-flags']='0x0f' [uid]='0' ['gid']='0'
9616 #  ['nid']='0@lo' ['parent-fid']='[0x200000007:0x1:0x0]')
9617 #
9618 # Note that the changelog record is not quoted
9619 # Also note that the line breaks in the output were only added for readability
9620 #
9621 # Typically, you want to eval the output of the command to fill an actual
9622 # associative array, like this:
9623 # $> eval declare -A changelog=$(changelog2array $entry)
9624 #
9625 # It can then be accessed like any bash associative array:
9626 # $> echo "${changelog[index]}" "${changelog[type]}" "${changelog[flags]}"
9627 # 16 CREAT 0x0
9628 # $> echo "${changelog[uid]}":"${changelog[gid]}"
9629 # 501:501
9630 #
9631 changelog2array()
9632 {
9633         # Start the array
9634         printf '('
9635
9636         # A changelog, as printed by "lfs changelog" typically looks like this:
9637         # <index> <type> <time> <date> <flags> <key1=value1> <key2=value2> ...
9638
9639         # Parse the positional part of the changelog
9640
9641         # changelog_dump() prefixes records with their mdt's name
9642         local index="${1##*.}"
9643
9644         printf "[index]='%s' [type]='%s' [time]='%s' [date]='%s' [flags]='%s'" \
9645                "$index" "${2:2}" "$3" "$4" "$5"
9646
9647         # Parse the key/value part of the changelog
9648         for arg in "${@:5}"; do
9649                 # Check it matches a key=value syntax
9650                 [[ "$arg" =~ ^[[:alpha:]]+= ]] || continue
9651
9652                 local key="${arg%%=*}"
9653                 local value="${arg#*=}"
9654
9655                 case "$key" in
9656                 u)
9657                         # u is actually for uid AND gid: u=UID:GID
9658                         printf " [uid]='%s'" "${value%:*}"
9659                         key=gid
9660                         value="${value#*:}"
9661                         ;;
9662                 t)
9663                         key=target-fid
9664                         value="${value#[}"
9665                         value="${value%]}"
9666                         ;;
9667                 j)
9668                         key=jobid
9669                         ;;
9670                 p)
9671                         key=parent-fid
9672                         value="${value#[}"
9673                         value="${value%]}"
9674                         ;;
9675                 ef)
9676                         key=extra-flags
9677                         ;;
9678                 m)
9679                         key=mode
9680                         ;;
9681                 x)
9682                         key=xattr
9683                         ;;
9684                 *)
9685                         ;;
9686                 esac
9687
9688                 printf " ['%s']='%s'" "$key" "$value"
9689         done
9690
9691         # end the array
9692         printf ')'
9693 }
9694
9695 # Format and print a changelog record
9696 #
9697 # Interpreted sequences are:
9698 #       %%      a single %
9699 #       %f      the "flags" attribute of a changelog record
9700 __changelog_printf()
9701 {
9702         local format="$1"
9703
9704         local -i i
9705         for ((i = 0; i < ${#format}; i++)); do
9706                 local char="${format:$i:1}"
9707                 if [ "$char" != % ]; then
9708                         printf '%c' "$char"
9709                         continue
9710                 fi
9711
9712                 i+=1
9713                 char="${format:$i:1}"
9714                 case "$char" in
9715                 f)
9716                         printf '%s' "${changelog[flags]}"
9717                         ;;
9718                 %)
9719                         printf '%'
9720                         ;;
9721                 esac
9722         done
9723         printf '\n'
9724 }
9725
9726 # Filter changelog records
9727 changelog_find()
9728 {
9729         local -A filter
9730         local action='print'
9731         local format
9732
9733         while [ $# -gt 0 ]; do
9734                 case "$1" in
9735                 -print)
9736                         action='print'
9737                         ;;
9738                 -printf)
9739                         action='printf'
9740                         format="$2"
9741                         shift
9742                         ;;
9743                 -*)
9744                         filter[${1#-}]="$2"
9745                         shift
9746                         ;;
9747                 esac
9748                 shift
9749         done
9750
9751         local found=false
9752         local record
9753         changelog_dump | { while read -r record; do
9754                 eval local -A changelog=$(changelog2array $record)
9755                 for key in "${!filter[@]}"; do
9756                         case "$key" in
9757                         *)
9758                                 [ "${changelog[$key]}" == "${filter[$key]}" ]
9759                                 ;;
9760                         esac || continue 2
9761                 done
9762
9763                 found=true
9764
9765                 case "${action:-print}" in
9766                 print)
9767                         printf '%s\n' "$record"
9768                         ;;
9769                 printf)
9770                         __changelog_printf "$format"
9771                         ;;
9772                 esac
9773         done; $found; }
9774 }
9775
9776 restore_layout() {
9777         local dir=$1
9778         local layout=$2
9779
9780         [ ! -d "$dir" ] && return
9781
9782         [ -z "$layout" ] && {
9783                 $LFS setstripe -d $dir || error "error deleting stripe '$dir'"
9784                 return
9785         }
9786
9787         setfattr -n trusted.lov -v $layout $dir ||
9788                 error "error restoring layout '$layout' to '$dir'"
9789 }
9790
9791 # save the layout of a directory, the returned string will be used by
9792 # restore_layout() to restore the layout
9793 save_layout() {
9794         local dir=$1
9795         local str=$(getfattr -n trusted.lov --absolute-names -e hex $dir \
9796                     2> /dev/null | awk -F'=' '/trusted.lov/{ print $2 }')
9797         echo "$str"
9798 }
9799
9800 # save layout of a directory and restore it at exit
9801 save_layout_restore_at_exit() {
9802         local dir=$1
9803         local layout=$(save_layout $dir)
9804
9805         stack_trap "restore_layout $dir $layout" EXIT
9806 }
9807
9808 verify_yaml_layout() {
9809         local src=$1
9810         local dst=$2
9811         local temp=$3
9812         local msg_prefix=$4
9813
9814         echo "getstripe --yaml $src"
9815         $LFS getstripe --yaml $src > $temp || error "getstripe $src failed"
9816         echo "setstripe --yaml=$temp $dst"
9817         $LFS setstripe --yaml=$temp $dst|| error "setstripe $dst failed"
9818
9819         echo "compare"
9820         local layout1=$(get_layout_param $src)
9821         local layout2=$(get_layout_param $dst)
9822         # compare their layout info
9823         [ "$layout1" == "$layout2" ] ||
9824                 error "$msg_prefix $src/$dst layouts are not equal"
9825 }
9826
9827 is_project_quota_supported() {
9828         $ENABLE_PROJECT_QUOTAS || return 1
9829
9830         [[ "$(facet_fstype $SINGLEMDS)" == "ldiskfs" &&
9831            $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.9.55) ]] &&
9832                 do_facet mds1 lfs --help |& grep -q project && return 0
9833
9834         [[ "$(facet_fstype $SINGLEMDS)" == "zfs" &&
9835            $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.10.53) ]] &&
9836                 do_facet mds1 $ZPOOL get all | grep -q project_quota && return 0
9837
9838         return 1
9839 }
9840
9841 # ZFS project quota enable/disable:
9842 #   This  feature  will  become  active as soon as it is enabled and will never
9843 #   return to being disabled. Each filesystem will be upgraded automatically
9844 #   when remounted or when [a] new file is created under that filesystem. The
9845 #   upgrade can also be triggered on filesystems via `zfs set version=current
9846 #   <pool/fs>`. The upgrade process runs in the background and may take a
9847 #   while to complete for the filesystems containing a large number of files.
9848 enable_project_quota() {
9849         is_project_quota_supported || return 0
9850         local zkeeper=${KEEP_ZPOOL}
9851         stack_trap "KEEP_ZPOOL=$zkeeper" EXIT
9852         KEEP_ZPOOL="true"
9853         stopall || error "failed to stopall (1)"
9854
9855         local zfeat_en="feature@project_quota=enabled"
9856         for facet in $(seq -f mds%g $MDSCOUNT) $(seq -f ost%g $OSTCOUNT); do
9857                 local facet_fstype=${facet:0:3}1_FSTYPE
9858                 local devname
9859
9860                 if [ "${!facet_fstype}" = "zfs" ]; then
9861                         devname=$(zpool_name ${facet})
9862                         do_facet ${facet} $ZPOOL set "$zfeat_en" $devname ||
9863                                 error "$ZPOOL set $zfeat_en $devname"
9864                 else
9865                         [ ${facet:0:3} == "mds" ] &&
9866                                 devname=$(mdsdevname ${facet:3}) ||
9867                                 devname=$(ostdevname ${facet:3})
9868                         do_facet ${facet} $TUNE2FS -O project $devname ||
9869                                 error "tune2fs $devname failed"
9870                 fi
9871         done
9872
9873         KEEP_ZPOOL="${zkeeper}"
9874         mount
9875         setupall
9876 }
9877
9878 disable_project_quota() {
9879         is_project_quota_supported || return 0
9880         [ "$mds1_FSTYPE" != "ldiskfs" ] && return 0
9881         stopall || error "failed to stopall (1)"
9882
9883         for num in $(seq $MDSCOUNT); do
9884                 do_facet mds$num $TUNE2FS -Q ^prj $(mdsdevname $num) ||
9885                         error "tune2fs $(mdsdevname $num) failed"
9886         done
9887
9888         for num in $(seq $OSTCOUNT); do
9889                 do_facet ost$num $TUNE2FS -Q ^prj $(ostdevname $num) ||
9890                         error "tune2fs $(ostdevname $num) failed"
9891         done
9892
9893         mount
9894         setupall
9895 }
9896
9897 #
9898 # In order to test multiple remote HSM agents, a new facet type named "AGT" and
9899 # the following associated variables are added:
9900 #
9901 # AGTCOUNT: number of agents
9902 # AGTDEV{N}: target HSM mount point (root path of the backend)
9903 # agt{N}_HOST: hostname of the agent agt{N}
9904 # SINGLEAGT: facet of the single agent
9905 #
9906 # The number of agents is initialized as the number of remote client nodes.
9907 # By default, only single copytool is started on a remote client/agent. If there
9908 # was no remote client, then the copytool will be started on the local client.
9909 #
9910 init_agt_vars() {
9911         local n
9912         local agent
9913
9914         export AGTCOUNT=${AGTCOUNT:-$((CLIENTCOUNT - 1))}
9915         [[ $AGTCOUNT -gt 0 ]] || AGTCOUNT=1
9916
9917         export SHARED_DIRECTORY=${SHARED_DIRECTORY:-$TMP}
9918         if [[ $CLIENTCOUNT -gt 1 ]] &&
9919                 ! check_shared_dir $SHARED_DIRECTORY $CLIENTS; then
9920                 skip_env "SHARED_DIRECTORY should be accessible"\
9921                          "on all client nodes"
9922                 exit 0
9923         fi
9924
9925         # We used to put the HSM archive in $SHARED_DIRECTORY but that
9926         # meant NFS issues could hose sanity-hsm sessions. So now we
9927         # use $TMP instead.
9928         for n in $(seq $AGTCOUNT); do
9929                 eval export AGTDEV$n=\$\{AGTDEV$n:-"$TMP/arc$n"\}
9930                 agent=CLIENT$((n + 1))
9931                 if [[ -z "${!agent}" ]]; then
9932                         [[ $CLIENTCOUNT -eq 1 ]] && agent=CLIENT1 ||
9933                                 agent=CLIENT2
9934                 fi
9935                 eval export agt${n}_HOST=\$\{agt${n}_HOST:-${!agent}\}
9936                 local var=agt${n}_HOST
9937                 [[ ! -z "${!var}" ]] || error "agt${n}_HOST is empty!"
9938         done
9939
9940         export SINGLEAGT=${SINGLEAGT:-agt1}
9941
9942         export HSMTOOL=${HSMTOOL:-"lhsmtool_posix"}
9943         export HSMTOOL_VERBOSE=${HSMTOOL_VERBOSE:-""}
9944         export HSMTOOL_UPDATE_INTERVAL=${HSMTOOL_UPDATE_INTERVAL:=""}
9945         export HSMTOOL_EVENT_FIFO=${HSMTOOL_EVENT_FIFO:=""}
9946         export HSMTOOL_TESTDIR
9947         export HSMTOOL_BASE=$(basename "$HSMTOOL" | cut -f1 -d" ")
9948
9949         HSM_ARCHIVE_NUMBER=2
9950
9951         # The test only support up to 10 MDTs
9952         MDT_PREFIX="mdt.$FSNAME-MDT000"
9953         HSM_PARAM="${MDT_PREFIX}0.hsm"
9954
9955         # archive is purged at copytool setup
9956         HSM_ARCHIVE_PURGE=true
9957
9958         # Don't allow copytool error upon start/setup
9959         HSMTOOL_NOERROR=false
9960 }
9961
9962 # Get the backend root path for the given agent facet.
9963 copytool_device() {
9964         local facet=$1
9965         local dev=AGTDEV$(facet_number $facet)
9966
9967         echo -n ${!dev}
9968 }
9969
9970 get_mdt_devices() {
9971         local mdtno
9972         # get MDT device for each mdc
9973         for mdtno in $(seq 1 $MDSCOUNT); do
9974                 local idx=$(($mdtno - 1))
9975                 MDT[$idx]=$($LCTL get_param -n \
9976                         mdc.$FSNAME-MDT000${idx}-mdc-*.mds_server_uuid |
9977                         awk '{gsub(/_UUID/,""); print $1}' | head -n1)
9978         done
9979 }
9980
9981 search_copytools() {
9982         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
9983         do_nodesv $hosts "pgrep -x $HSMTOOL_BASE"
9984 }
9985
9986 kill_copytools() {
9987         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
9988
9989         echo "Killing existing copytools on $hosts"
9990         do_nodesv $hosts "killall -q $HSMTOOL_BASE" || true
9991 }
9992
9993 wait_copytools() {
9994         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
9995         local wait_timeout=200
9996         local wait_start=$SECONDS
9997         local wait_end=$((wait_start + wait_timeout))
9998         local sleep_time=100000 # 0.1 second
9999
10000         while ((SECONDS < wait_end)); do
10001                 if ! search_copytools $hosts; then
10002                         echo "copytools stopped in $((SECONDS - wait_start))s"
10003                         return 0
10004                 fi
10005
10006                 echo "copytools still running on $hosts"
10007                 usleep $sleep_time
10008                 [ $sleep_time -lt 32000000 ] && # 3.2 seconds
10009                         sleep_time=$(bc <<< "$sleep_time * 2")
10010         done
10011
10012         # try to dump Copytool's stack
10013         do_nodesv $hosts "echo 1 >/proc/sys/kernel/sysrq ; " \
10014                          "echo t >/proc/sysrq-trigger"
10015
10016         echo "copytools failed to stop in ${wait_timeout}s"
10017
10018         return 1
10019 }
10020
10021 copytool_monitor_cleanup() {
10022         local facet=${1:-$SINGLEAGT}
10023         local agent=$(facet_active_host $facet)
10024
10025         if [ -n "$HSMTOOL_MONITOR_DIR" ]; then
10026                 # Should die when the copytool dies, but just in case.
10027                 local cmd="kill \\\$(cat $HSMTOOL_MONITOR_DIR/monitor_pid)"
10028                 cmd+=" 2>/dev/null || true"
10029                 do_node $agent "$cmd"
10030                 do_node $agent "rm -fr $HSMTOOL_MONITOR_DIR"
10031                 export HSMTOOL_MONITOR_DIR=
10032         fi
10033
10034         # The pdsh should die on its own when the monitor dies. Just
10035         # in case, though, try to clean up to avoid any cruft.
10036         if [ -n "$HSMTOOL_MONITOR_PDSH" ]; then
10037                 kill $HSMTOOL_MONITOR_PDSH 2>/dev/null || true
10038                 export HSMTOOL_MONITOR_PDSH=
10039         fi
10040 }
10041
10042 copytool_logfile()
10043 {
10044         local host="$(facet_host "$1")"
10045         local prefix=$TESTLOG_PREFIX
10046         [ -n "$TESTNAME" ] && prefix+=.$TESTNAME
10047
10048         printf "${prefix}.copytool${archive_id}_log.${host}.log"
10049 }
10050
10051 __lhsmtool_rebind()
10052 {
10053         do_facet $facet $HSMTOOL -p "$hsm_root" --rebind "$@" "$mountpoint"
10054 }
10055
10056 __lhsmtool_import()
10057 {
10058         mkdir -p "$(dirname "$2")" ||
10059                 error "cannot create directory '$(dirname "$2")'"
10060         do_facet $facet $HSMTOOL -p "$hsm_root" --import "$@" "$mountpoint"
10061 }
10062
10063 __lhsmtool_setup()
10064 {
10065         local cmd="$HSMTOOL $HSMTOOL_VERBOSE --daemon --hsm-root \"$hsm_root\""
10066         [ -n "$bandwidth" ] && cmd+=" --bandwidth $bandwidth"
10067         [ -n "$archive_id" ] && cmd+=" --archive $archive_id"
10068         [ ${#misc_options[@]} -gt 0 ] &&
10069                 cmd+=" $(IFS=" " echo "$@")"
10070         cmd+=" \"$mountpoint\""
10071
10072         echo "Starting copytool $facet on $(facet_host $facet)"
10073         stack_trap "do_facet $facet libtool execute pkill -x '$HSMTOOL' || true" EXIT
10074         do_facet $facet "$cmd < /dev/null > \"$(copytool_logfile $facet)\" 2>&1"
10075 }
10076
10077 hsm_root() {
10078         local facet="${1:-$SINGLEAGT}"
10079
10080         printf "$(copytool_device "$facet")/${TESTSUITE}.${TESTNAME}/"
10081 }
10082
10083 # Main entry point to perform copytool related operations
10084 #
10085 # Sub-commands:
10086 #
10087 #       setup   setup a copytool to run in the background, that copytool will be
10088 #               killed on EXIT
10089 #       import  import a file from an HSM backend
10090 #       rebind  rebind an archived file to a new fid
10091 #
10092 # Although the semantics might suggest otherwise, one does not need to 'setup'
10093 # a copytool before a call to 'copytool import' or 'copytool rebind'.
10094 #
10095 copytool()
10096 {
10097         local action=$1
10098         shift
10099
10100         # Use default values
10101         local facet=$SINGLEAGT
10102         local mountpoint="${MOUNT2:-$MOUNT}"
10103         local hsm_root="${hsm_root:-$(hsm_root "$facet")}"
10104
10105         # Parse arguments
10106         local fail_on_error=true
10107         local -a misc_options
10108         while [ $# -gt 0 ]; do
10109                 case "$1" in
10110                 -f|--facet)
10111                         shift
10112                         facet="$1"
10113                         ;;
10114                 -m|--mountpoint)
10115                         shift
10116                         mountpoint="$1"
10117                         ;;
10118                 -a|--archive-id)
10119                         shift
10120                         local archive_id="$1"
10121                         ;;
10122                 -h|--hsm-root)
10123                         shift
10124                         hsm_root="$1"
10125                         ;;
10126                 -b|--bwlimit)
10127                         shift
10128                         local bandwidth="$1" # in MB/s
10129                         ;;
10130                 -n|--no-fail)
10131                         local fail_on_error=false
10132                         ;;
10133                 *)
10134                         # Uncommon(/copytool dependent) option
10135                         misc_options+=("$1")
10136                         ;;
10137                 esac
10138                 shift
10139         done
10140
10141         stack_trap "do_facet $facet rm -rf '$hsm_root'" EXIT
10142         do_facet $facet mkdir -p "$hsm_root" ||
10143                 error "mkdir '$hsm_root' failed"
10144
10145         case "$HSMTOOL" in
10146         lhsmtool_posix)
10147                 local copytool=lhsmtool
10148                 ;;
10149         esac
10150
10151         __${copytool}_${action} "${misc_options[@]}"
10152         if [ $? -ne 0 ]; then
10153                 local error_msg
10154
10155                 case $action in
10156                 setup)
10157                         local host="$(facet_host $facet)"
10158                         error_msg="Failed to start copytool $facet on '$host'"
10159                         ;;
10160                 import)
10161                         local src="${misc_options[0]}"
10162                         local dest="${misc_options[1]}"
10163                         error_msg="Failed to import '$src' to '$dest'"
10164                         ;;
10165                 rebind)
10166                         error_msg="could not rebind file"
10167                         ;;
10168                 esac
10169
10170                 $fail_on_error && error "$error_msg" || echo "$error_msg"
10171         fi
10172 }
10173
10174 needclients() {
10175         local client_count=$1
10176         if [[ $CLIENTCOUNT -lt $client_count ]]; then
10177                 skip "Need $client_count or more clients, have $CLIENTCOUNT"
10178                 return 1
10179         fi
10180         return 0
10181 }
10182
10183 path2fid() {
10184         $LFS path2fid $1 | tr -d '[]'
10185         return ${PIPESTATUS[0]}
10186 }
10187
10188 get_hsm_flags() {
10189         local f=$1
10190         local u=$2
10191         local st
10192
10193         if [[ $u == "user" ]]; then
10194                 st=$($RUNAS $LFS hsm_state $f)
10195         else
10196                 u=root
10197                 st=$($LFS hsm_state $f)
10198         fi
10199
10200         [[ $? == 0 ]] || error "$LFS hsm_state $f failed (run as $u)"
10201
10202         st=$(echo $st | cut -f 2 -d" " | tr -d "()," )
10203         echo $st
10204 }
10205
10206 check_hsm_flags() {
10207         local f=$1
10208         local fl=$2
10209
10210         local st=$(get_hsm_flags $f)
10211         [[ $st == $fl ]] || error "hsm flags on $f are $st != $fl"
10212 }
10213
10214 mdts_set_param() {
10215         local arg=$1
10216         local key=$2
10217         local value=$3
10218         local mdtno
10219         local rc=0
10220         if [[ "$value" != "" ]]; then
10221                 value="=$value"
10222         fi
10223         for mdtno in $(seq 1 $MDSCOUNT); do
10224                 local idx=$(($mdtno - 1))
10225                 local facet=mds${mdtno}
10226                 # if $arg include -P option, run 1 set_param per MDT on the MGS
10227                 # else, run set_param on each MDT
10228                 [[ $arg = *"-P"* ]] && facet=mgs
10229                 do_facet $facet $LCTL set_param $arg mdt.${MDT[$idx]}.$key$value
10230                 [[ $? != 0 ]] && rc=1
10231         done
10232         return $rc
10233 }
10234
10235 wait_result() {
10236         local facet=$1
10237         shift
10238         wait_update --verbose $(facet_active_host $facet) "$@"
10239 }
10240
10241 mdts_check_param() {
10242         local key="$1"
10243         local target="$2"
10244         local timeout="$3"
10245         local mdtno
10246         for mdtno in $(seq 1 $MDSCOUNT); do
10247                 local idx=$(($mdtno - 1))
10248                 wait_result mds${mdtno} \
10249                         "$LCTL get_param -n $MDT_PREFIX${idx}.$key" "$target" \
10250                         $timeout ||
10251                         error "$key state is not '$target' on mds${mdtno}"
10252         done
10253 }
10254
10255 cdt_set_mount_state() {
10256         mdts_set_param "-P" hsm_control "$1"
10257         # set_param -P is asynchronous operation and could race with set_param.
10258         # In such case configs could be retrieved and applied at mgc after
10259         # set_param -P completion. Sleep here to avoid race with set_param.
10260         # We need at least 20 seconds. 10 for mgc_requeue_thread to wake up
10261         # MGC_TIMEOUT_MIN_SECONDS + MGC_TIMEOUT_RAND_CENTISEC(5 + 5)
10262         # and 10 seconds to retrieve config from server.
10263         sleep 20
10264 }
10265
10266 cdt_check_state() {
10267         mdts_check_param hsm_control "$1" 20
10268 }
10269
10270 cdt_set_sanity_policy() {
10271         if [[ "$CDT_POLICY_HAD_CHANGED" ]]
10272         then
10273                 # clear all
10274                 mdts_set_param "" hsm.policy "+NRA"
10275                 mdts_set_param "" hsm.policy "-NBR"
10276                 CDT_POLICY_HAD_CHANGED=
10277         fi
10278 }
10279
10280 set_hsm_param() {
10281         local param=$1
10282         local value=$2
10283         local opt=$3
10284         mdts_set_param "$opt -n" "hsm.$param" "$value"
10285         return $?
10286 }
10287
10288 wait_request_state() {
10289         local fid=$1
10290         local request=$2
10291         local state=$3
10292         # 4th arg (mdt index) is optional
10293         local mdtidx=${4:-0}
10294         local mds=mds$(($mdtidx + 1))
10295
10296         local cmd="$LCTL get_param -n ${MDT_PREFIX}${mdtidx}.hsm.actions"
10297         cmd+=" | awk '/'$fid'.*action='$request'/ {print \\\$13}' | cut -f2 -d="
10298
10299         wait_result $mds "$cmd" "$state" 200 ||
10300                 error "request on $fid is not $state on $mds"
10301 }
10302
10303
10304 rmultiop_start() {
10305         local client=$1
10306         local file=$2
10307         local cmds=$3
10308         local WAIT_MAX=${4:-60}
10309         local wait_time=0
10310
10311         # We need to run do_node in bg, because pdsh does not exit
10312         # if child process of run script exists.
10313         # I.e. pdsh does not exit when runmultiop_bg_pause exited,
10314         # because of multiop_bg_pause -> $MULTIOP_PROG &
10315         # By the same reason we need sleep a bit after do_nodes starts
10316         # to let runmultiop_bg_pause start muliop and
10317         # update /tmp/multiop_bg.pid ;
10318         # The rm /tmp/multiop_bg.pid guarantees here that
10319         # we have the updated by runmultiop_bg_pause
10320         # /tmp/multiop_bg.pid file
10321
10322         local pid_file=$TMP/multiop_bg.pid.$$
10323
10324         do_node $client "MULTIOP_PID_FILE=$pid_file LUSTRE= \
10325                         runmultiop_bg_pause $file $cmds" &
10326         local pid=$!
10327         local multiop_pid
10328
10329         while [[ $wait_time -lt $WAIT_MAX ]]; do
10330                 sleep 3
10331                 wait_time=$((wait_time + 3))
10332                 multiop_pid=$(do_node $client cat $pid_file)
10333                 if [ -n "$multiop_pid" ]; then
10334                         break
10335                 fi
10336         done
10337
10338         [ -n "$multiop_pid" ] ||
10339                 error "$client : Can not get multiop_pid from $pid_file "
10340
10341         eval export $(node_var_name $client)_multiop_pid=$multiop_pid
10342         eval export $(node_var_name $client)_do_node_pid=$pid
10343         local var=$(node_var_name $client)_multiop_pid
10344         echo client $client multiop_bg started multiop_pid=${!var}
10345         return $?
10346 }
10347
10348 rmultiop_stop() {
10349         local client=$1
10350         local multiop_pid=$(node_var_name $client)_multiop_pid
10351         local do_node_pid=$(node_var_name $client)_do_node_pid
10352
10353         echo "Stopping multiop_pid=${!multiop_pid} (kill ${!multiop_pid} on $client)"
10354         do_node $client kill -USR1 ${!multiop_pid}
10355
10356         wait ${!do_node_pid}
10357 }
10358
10359 sleep_maxage() {
10360         local delay=$(do_facet $SINGLEMDS lctl get_param -n lo[vd].*.qos_maxage |
10361                       awk '{ print $1 * 2; exit; }')
10362         sleep $delay
10363 }
10364
10365 check_component_count() {
10366         local comp_cnt=$($LFS getstripe --component-count $1)
10367         [ $comp_cnt -eq $2 ] || error "$1, component count $comp_cnt != $2"
10368 }
10369
10370 # Verify there are no init components with "extension" flag
10371 verify_no_init_extension() {
10372         local flg_opts="--component-flags init,extension"
10373         local found=$($LFS find $flg_opts $1 | wc -l)
10374         [ $found -eq 0 ] || error "$1 has component with initialized extension"
10375 }
10376
10377 # Verify there is at least one component starting at 0
10378 verify_comp_at_zero() {
10379         flg_opts="--component-flags init"
10380         found=$($LFS find --component-start 0M $flg_opts $1 | wc -l)
10381         [ $found -eq 1 ] ||
10382                 error "No component starting at zero(!)"
10383 }
10384
10385 # version after which Self-Extending Layouts are available
10386 SEL_VER="2.12.55"
10387
10388 sel_layout_sanity() {
10389         local file=$1
10390         local comp_cnt=$2
10391
10392         verify_no_init_extension $file
10393         verify_comp_at_zero $file
10394         check_component_count $file $comp_cnt
10395 }
10396