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