Whamcloud - gitweb
LU-2663 tests: don't remove objects by debugfs
[fs/lustre-release.git] / lustre / tests / test-framework.sh
1 #!/bin/bash
2
3 trap 'print_summary && touch $TF_FAIL && \
4     echo "test-framework exiting on error"' ERR
5 set -e
6 #set -x
7
8 export EJOURNAL=${EJOURNAL:-""}
9 export REFORMAT=${REFORMAT:-""}
10 export WRITECONF=${WRITECONF:-""}
11 export VERBOSE=${VERBOSE:-false}
12 export CATASTROPHE=${CATASTROPHE:-/proc/sys/lnet/catastrophe}
13 export GSS=false
14 export GSS_KRB5=false
15 export GSS_PIPEFS=false
16 export IDENTITY_UPCALL=default
17 export QUOTA_AUTO=1
18 export JOBSTATS_AUTO=${JOBSTATS_AUTO:-1}
19 export JOBID_VAR=${JOBID_VAR:-"procname_uid"}
20
21 # LOAD_LLOOP: LU-409: only load llite_lloop module if kernel < 2.6.32 or
22 #             LOAD_LLOOP is true. LOAD_LLOOP is false by default.
23 export LOAD_LLOOP=${LOAD_LLOOP:-false}
24
25 #export PDSH="pdsh -S -Rssh -w"
26
27 # function used by scripts run on remote nodes
28 LUSTRE=${LUSTRE:-$(cd $(dirname $0)/..; echo $PWD)}
29 . $LUSTRE/tests/functions.sh
30 . $LUSTRE/tests/yaml.sh
31
32 export LD_LIBRARY_PATH=${LUSTRE}/utils:${LD_LIBRARY_PATH}
33
34 LUSTRE_TESTS_CFG_DIR=${LUSTRE_TESTS_CFG_DIR:-${LUSTRE}/tests/cfg}
35
36 EXCEPT_LIST_FILE=${EXCEPT_LIST_FILE:-${LUSTRE_TESTS_CFG_DIR}/tests-to-skip.sh}
37
38 if [ -f "$EXCEPT_LIST_FILE" ]; then
39     echo "Reading test skip list from $EXCEPT_LIST_FILE"
40     cat $EXCEPT_LIST_FILE
41     . $EXCEPT_LIST_FILE
42 fi
43
44 # check config files for options in decreasing order of preference
45 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/lustre.conf ] &&
46     MODPROBECONF=/etc/modprobe.d/lustre.conf
47 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/Lustre ] &&
48     MODPROBECONF=/etc/modprobe.d/Lustre
49 [ -z "$MODPROBECONF" -a -f /etc/modprobe.conf ] &&
50     MODPROBECONF=/etc/modprobe.conf
51
52 assert_DIR () {
53     local failed=""
54     [[ $DIR/ = $MOUNT/* ]] || \
55         { failed=1 && echo "DIR=$DIR not in $MOUNT. Aborting."; }
56     [[ $DIR1/ = $MOUNT1/* ]] || \
57         { failed=1 && echo "DIR1=$DIR1 not in $MOUNT1. Aborting."; }
58     [[ $DIR2/ = $MOUNT2/* ]] || \
59         { failed=1 && echo "DIR2=$DIR2 not in $MOUNT2. Aborting"; }
60
61     [ -n "$failed" ] && exit 99 || true
62 }
63
64 usage() {
65     echo "usage: $0 [-r] [-f cfgfile]"
66     echo "       -r: reformat"
67
68     exit
69 }
70
71 print_summary () {
72     trap 0
73     [ "$TESTSUITE" == "lfsck" ] && return 0
74     [ -n "$ONLY" ] && echo "WARNING: ONLY is set to $(echo $ONLY)"
75     local details
76     local form="%-13s %-17s %-9s %s %s\n"
77     printf "$form" "status" "script" "Total(sec)" "E(xcluded) S(low)"
78     echo "------------------------------------------------------------------------------------"
79     for O in $DEFAULT_SUITES; do
80         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
81         [ "${!O}" = "no" ] && continue || true
82         local o=$(echo $O  | tr "[:upper:]_" "[:lower:]-")
83         local log=${TMP}/${o}.log
84         if is_sanity_benchmark $o; then
85             log=${TMP}/sanity-benchmark.log
86         fi
87         local slow=
88         local skipped=
89         local total=
90         local status=Unfinished
91         if [ -f $log ]; then
92             skipped=$(grep excluded $log | awk '{ printf " %s", $3 }' | sed 's/test_//g')
93             slow=$(egrep "^PASS|^FAIL" $log | tr -d "("| sed s/s\)$//g | sort -nr -k 3  | head -5 |  awk '{ print $2":"$3"s" }')
94             total=$(grep duration $log | awk '{ print $2}')
95             if [ "${!O}" = "done" ]; then
96                 status=Done
97             fi
98             if $DDETAILS; then
99                 local durations=$(egrep "^PASS|^FAIL" $log |  tr -d "("| sed s/s\)$//g | awk '{ print $2":"$3"|" }')
100                 details=$(printf "%s\n%s %s %s\n" "$details" "DDETAILS" "$O" "$(echo $durations)")
101             fi
102         fi
103         printf "$form" $status "$O" "${total}" "E=$skipped"
104         printf "$form" "-" "-" "-" "S=$(echo $slow)"
105     done
106
107     for O in $DEFAULT_SUITES; do
108         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
109         if [ "${!O}" = "no" ]; then
110             printf "$form" "Skipped" "$O" ""
111         fi
112     done
113
114     # print the detailed tests durations if DDETAILS=true
115     if $DDETAILS; then
116         echo "$details"
117     fi
118 }
119
120 init_test_env() {
121     export LUSTRE=`absolute_path $LUSTRE`
122     export TESTSUITE=`basename $0 .sh`
123     export TEST_FAILED=false
124     export FAIL_ON_SKIP_ENV=${FAIL_ON_SKIP_ENV:-false}
125
126     export MKE2FS=$MKE2FS
127     if [ -z "$MKE2FS" ]; then
128         if which mkfs.ldiskfs >/dev/null 2>&1; then
129             export MKE2FS=mkfs.ldiskfs
130         else
131             export MKE2FS=mke2fs
132         fi
133     fi
134
135     export DEBUGFS=$DEBUGFS
136     if [ -z "$DEBUGFS" ]; then
137         if which debugfs.ldiskfs >/dev/null 2>&1; then
138             export DEBUGFS=debugfs.ldiskfs
139         else
140             export DEBUGFS=debugfs
141         fi
142     fi
143
144     export TUNE2FS=$TUNE2FS
145     if [ -z "$TUNE2FS" ]; then
146         if which tunefs.ldiskfs >/dev/null 2>&1; then
147             export TUNE2FS=tunefs.ldiskfs
148         else
149             export TUNE2FS=tune2fs
150         fi
151     fi
152
153     export E2LABEL=$E2LABEL
154     if [ -z "$E2LABEL" ]; then
155         if which label.ldiskfs >/dev/null 2>&1; then
156             export E2LABEL=label.ldiskfs
157         else
158             export E2LABEL=e2label
159         fi
160     fi
161
162     export DUMPE2FS=$DUMPE2FS
163     if [ -z "$DUMPE2FS" ]; then
164         if which dumpfs.ldiskfs >/dev/null 2>&1; then
165             export DUMPE2FS=dumpfs.ldiskfs
166         else
167             export DUMPE2FS=dumpe2fs
168         fi
169     fi
170
171     export E2FSCK=$E2FSCK
172     if [ -z "$E2FSCK" ]; then
173         if which fsck.ldiskfs >/dev/null 2>&1; then
174             export E2FSCK=fsck.ldiskfs
175         else
176             export E2FSCK=e2fsck
177         fi
178     fi
179
180     export LFSCK_BIN=${LFSCK_BIN:-lfsck}
181     export LFSCK_ALWAYS=${LFSCK_ALWAYS:-"no"} # check fs after each test suite
182     export FSCK_MAX_ERR=4   # File system errors left uncorrected
183
184         export ZFS=${ZFS:-zfs}
185         export ZPOOL=${ZPOOL:-zpool}
186         export ZDB=${ZDB:-zdb}
187
188     #[ -d /r ] && export ROOT=${ROOT:-/r}
189     export TMP=${TMP:-$ROOT/tmp}
190     export TESTSUITELOG=${TMP}/${TESTSUITE}.log
191     export LOGDIR=${LOGDIR:-${TMP}/test_logs/$(date +%s)}
192     export TESTLOG_PREFIX=$LOGDIR/$TESTSUITE
193
194     export HOSTNAME=${HOSTNAME:-$(hostname -s)}
195     if ! echo $PATH | grep -q $LUSTRE/utils; then
196         export PATH=$LUSTRE/utils:$PATH
197     fi
198     if ! echo $PATH | grep -q $LUSTRE/utils/gss; then
199         export PATH=$LUSTRE/utils/gss:$PATH
200     fi
201     if ! echo $PATH | grep -q $LUSTRE/tests; then
202         export PATH=$LUSTRE/tests:$PATH
203     fi
204     if ! echo $PATH | grep -q $LUSTRE/../lustre-iokit/sgpdd-survey; then
205         export PATH=$LUSTRE/../lustre-iokit/sgpdd-survey:$PATH
206     fi
207     export LST=${LST:-"$LUSTRE/../lnet/utils/lst"}
208     [ ! -f "$LST" ] && export LST=$(which lst)
209     export SGPDDSURVEY=${SGPDDSURVEY:-"$LUSTRE/../lustre-iokit/sgpdd-survey/sgpdd-survey")}
210     [ ! -f "$SGPDDSURVEY" ] && export SGPDDSURVEY=$(which sgpdd-survey)
211     # Ubuntu, at least, has a truncate command in /usr/bin
212     # so fully path our truncate command.
213     export TRUNCATE=${TRUNCATE:-$LUSTRE/tests/truncate}
214     export MDSRATE=${MDSRATE:-"$LUSTRE/tests/mpi/mdsrate"}
215     [ ! -f "$MDSRATE" ] && export MDSRATE=$(which mdsrate 2> /dev/null)
216     if ! echo $PATH | grep -q $LUSTRE/tests/racer; then
217         export PATH=$LUSTRE/tests/racer:$PATH:
218     fi
219     if ! echo $PATH | grep -q $LUSTRE/tests/mpi; then
220         export PATH=$LUSTRE/tests/mpi:$PATH
221     fi
222     export RSYNC_RSH=${RSYNC_RSH:-rsh}
223
224     export LCTL=${LCTL:-"$LUSTRE/utils/lctl"}
225     [ ! -f "$LCTL" ] && export LCTL=$(which lctl)
226     export LFS=${LFS:-"$LUSTRE/utils/lfs"}
227     [ ! -f "$LFS" ] && export LFS=$(which lfs)
228     SETSTRIPE=${SETSTRIPE:-"$LFS setstripe"}
229     GETSTRIPE=${GETSTRIPE:-"$LFS getstripe"}
230
231     export L_GETIDENTITY=${L_GETIDENTITY:-"$LUSTRE/utils/l_getidentity"}
232     if [ ! -f "$L_GETIDENTITY" ]; then
233         if `which l_getidentity > /dev/null 2>&1`; then
234             export L_GETIDENTITY=$(which l_getidentity)
235         else
236             export L_GETIDENTITY=NONE
237         fi
238     fi
239     export LL_DECODE_FILTER_FID=${LL_DECODE_FILTER_FID:-"$LUSTRE/utils/ll_decode_filter_fid"}
240     [ ! -f "$LL_DECODE_FILTER_FID" ] && export LL_DECODE_FILTER_FID="ll_decode_filter_fid"
241     export MKFS=${MKFS:-"$LUSTRE/utils/mkfs.lustre"}
242     [ ! -f "$MKFS" ] && export MKFS="mkfs.lustre"
243     export TUNEFS=${TUNEFS:-"$LUSTRE/utils/tunefs.lustre"}
244     [ ! -f "$TUNEFS" ] && export TUNEFS="tunefs.lustre"
245     export CHECKSTAT="${CHECKSTAT:-"checkstat -v"} "
246     export LUSTRE_RMMOD=${LUSTRE_RMMOD:-$LUSTRE/scripts/lustre_rmmod}
247     [ ! -f "$LUSTRE_RMMOD" ] &&
248         export LUSTRE_RMMOD=$(which lustre_rmmod 2> /dev/null)
249     export LFS_MIGRATE=${LFS_MIGRATE:-$LUSTRE/scripts/lfs_migrate}
250     [ ! -f "$LFS_MIGRATE" ] &&
251         export LFS_MIGRATE=$(which lfs_migrate 2> /dev/null)
252     export NAME=${NAME:-local}
253     export LGSSD=${LGSSD:-"$LUSTRE/utils/gss/lgssd"}
254     [ "$GSS_PIPEFS" = "true" ] && [ ! -f "$LGSSD" ] && \
255         export LGSSD=$(which lgssd)
256     export LSVCGSSD=${LSVCGSSD:-"$LUSTRE/utils/gss/lsvcgssd"}
257     [ ! -f "$LSVCGSSD" ] && export LSVCGSSD=$(which lsvcgssd 2> /dev/null)
258     export KRB5DIR=${KRB5DIR:-"/usr/kerberos"}
259     export DIR2
260     export SAVE_PWD=${SAVE_PWD:-$LUSTRE/tests}
261     export AT_MAX_PATH
262
263     if [ "$ACCEPTOR_PORT" ]; then
264         export PORT_OPT="--port $ACCEPTOR_PORT"
265     fi
266
267     case "x$SEC" in
268         xkrb5*)
269             echo "Using GSS/krb5 ptlrpc security flavor"
270             which lgss_keyring > /dev/null 2>&1 || \
271                 error_exit "built with gss disabled! SEC=$SEC"
272             GSS=true
273             GSS_KRB5=true
274             ;;
275     esac
276
277     case "x$IDUP" in
278         xtrue)
279             IDENTITY_UPCALL=true
280             ;;
281         xfalse)
282             IDENTITY_UPCALL=false
283             ;;
284     esac
285
286     export LOAD_MODULES_REMOTE=${LOAD_MODULES_REMOTE:-false}
287
288     # Paths on remote nodes, if different
289     export RLUSTRE=${RLUSTRE:-$LUSTRE}
290     export RPWD=${RPWD:-$PWD}
291     export I_MOUNTED=${I_MOUNTED:-"no"}
292     if [ ! -f /lib/modules/$(uname -r)/kernel/fs/lustre/mdt.ko -a \
293         ! -f /lib/modules/$(uname -r)/updates/kernel/fs/lustre/mdt.ko -a \
294         ! -f `dirname $0`/../mdt/mdt.ko ]; then
295         export CLIENTMODSONLY=yes
296     fi
297
298     export SHUTDOWN_ATTEMPTS=${SHUTDOWN_ATTEMPTS:-3}
299
300     # command line
301
302     while getopts "rvwf:" opt $*; do
303         case $opt in
304             f) CONFIG=$OPTARG;;
305             r) REFORMAT=--reformat;;
306             v) VERBOSE=true;;
307             w) WRITECONF=writeconf;;
308             \?) usage;;
309         esac
310     done
311
312     shift $((OPTIND - 1))
313     ONLY=${ONLY:-$*}
314
315     # print the durations of each test if "true"
316     DDETAILS=${DDETAILS:-false}
317     [ "$TESTSUITELOG" ] && rm -f $TESTSUITELOG || true
318     rm -f $TMP/*active
319 }
320
321 check_cpt_number() {
322         local facet=$1
323         local ncpts
324
325         ncpts=$(do_facet $facet "lctl get_param -n " \
326                 "cpu_partition_table 2>/dev/null| wc -l" || echo 1)
327
328         if [ $ncpts -eq 0 ]; then
329                 echo "1"
330         else
331                 echo $ncpts
332         fi
333 }
334
335 version_code() {
336     # split arguments like "1.8.6-wc3" into "1", "8", "6", "wc3"
337     eval set -- $(tr "[:punct:]" " " <<< $*)
338
339     echo -n "$((($1 << 16) | ($2 << 8) | $3))"
340 }
341
342 export LINUX_VERSION=$(uname -r | sed -e "s/[-.]/ /3" -e "s/ .*//")
343 export LINUX_VERSION_CODE=$(version_code ${LINUX_VERSION//\./ })
344
345 module_loaded () {
346    /sbin/lsmod | grep -q "^\<$1\>"
347 }
348
349 # Load a module on the system where this is running.
350 #
351 # Synopsis: load_module module_name [module arguments for insmod/modprobe]
352 #
353 # If module arguments are not given but MODOPTS_<MODULE> is set, then its value
354 # will be used as the arguments.  Otherwise arguments will be obtained from
355 # /etc/modprobe.conf, from /etc/modprobe.d/Lustre, or else none will be used.
356 #
357 load_module() {
358     local optvar
359     EXT=".ko"
360     module=$1
361     shift
362     BASE=`basename $module $EXT`
363
364     module_loaded ${BASE} && return
365
366     # If no module arguments were passed, get them from $MODOPTS_<MODULE>, else from
367     # modprobe.conf
368     if [ $# -eq 0 ]; then
369         # $MODOPTS_<MODULE>; we could use associative arrays, but that's not in
370         # Bash until 4.x, so we resort to eval.
371         optvar="MODOPTS_$(basename $module | tr a-z A-Z)"
372         eval set -- \$$optvar
373         if [ $# -eq 0 -a -n "$MODPROBECONF" ]; then
374                 # Nothing in $MODOPTS_<MODULE>; try modprobe.conf
375                 local opt
376                 opt=$(awk -v var="^options $BASE" '$0 ~ var \
377                         {gsub("'"options $BASE"'",""); print}' $MODPROBECONF)
378                 set -- $(echo -n $opt)
379
380                 # Ensure we have accept=all for lnet
381                 if [ $(basename $module) = lnet ]; then
382                         # OK, this is a bit wordy...
383                         local arg accept_all_present=false
384
385                         for arg in "$@"; do
386                                 [ "$arg" = accept=all ] && \
387                                         accept_all_present=true
388                         done
389                         $accept_all_present || set -- "$@" accept=all
390                 fi
391                 export $optvar="$*"
392         fi
393     fi
394
395     [ $# -gt 0 ] && echo "${module} options: '$*'"
396
397     # Note that insmod will ignore anything in modprobe.conf, which is why we're
398     # passing options on the command-line.
399     if [ "$BASE" == "lnet_selftest" ] && \
400             [ -f ${LUSTRE}/../lnet/selftest/${module}${EXT} ]; then
401         insmod ${LUSTRE}/../lnet/selftest/${module}${EXT}
402     elif [ -f ${LUSTRE}/${module}${EXT} ]; then
403         insmod ${LUSTRE}/${module}${EXT} "$@"
404     else
405         # must be testing a "make install" or "rpm" installation
406         # note failed to load ptlrpc_gss is considered not fatal
407         if [ "$BASE" == "ptlrpc_gss" ]; then
408             modprobe $BASE "$@" 2>/dev/null || echo "gss/krb5 is not supported"
409         else
410             modprobe $BASE "$@"
411         fi
412     fi
413 }
414
415 llite_lloop_enabled() {
416     local n1=$(uname -r | cut -d. -f1)
417     local n2=$(uname -r | cut -d. -f2)
418     local n3=$(uname -r | cut -d- -f1 | cut -d. -f3)
419
420     # load the llite_lloop module for < 2.6.32 kernels
421     if [[ $n1 -lt 2 ]] || [[ $n1 -eq 2 && $n2 -lt 6 ]] || \
422        [[ $n1 -eq 2 && $n2 -eq 6 && $n3 -lt 32 ]] || \
423         $LOAD_LLOOP; then
424         return 0
425     fi
426     return 1
427 }
428
429 load_modules_local() {
430         if [ -n "$MODPROBE" ]; then
431                 # use modprobe
432                 echo "Using modprobe to load modules"
433                 return 0
434         fi
435
436         echo Loading modules from $LUSTRE
437
438         local ncpus
439
440         if [ -f /sys/devices/system/cpu/online ]; then
441                 ncpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/online) + 1))
442                 echo "detected $ncpus online CPUs by sysfs"
443         else
444                 ncpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
445                 local rc=$?
446                 if [ $rc -eq 0 ]; then
447                         echo "detected $ncpus online CPUs by getconf"
448                 else
449                         echo "Can't detect number of CPUs"
450                         ncpus=1
451                 fi
452         fi
453
454         # if there is only one CPU core, libcfs can only create one partition
455         # if there is more than 4 CPU cores, libcfs should create multiple CPU
456         # partitions. So we just force libcfs to create 2 partitions for
457         # system with 2 or 4 cores
458         if [ $ncpus -le 4 ] && [ $ncpus -gt 1 ]; then
459                 # force to enable multiple CPU partitions
460                 echo "Force libcfs to create 2 CPU partitions"
461                 MODOPTS_LIBCFS="cpu_npartitions=2 $MODOPTS_LIBCFS"
462         else
463                 echo "libcfs will create CPU partition based on online CPUs"
464         fi
465
466         load_module ../libcfs/libcfs/libcfs
467
468     [ "$PTLDEBUG" ] && lctl set_param debug="$PTLDEBUG"
469     [ "$SUBSYSTEM" ] && lctl set_param subsystem_debug="${SUBSYSTEM# }"
470     load_module ../lnet/lnet/lnet
471     LNETLND=${LNETLND:-"socklnd/ksocklnd"}
472     load_module ../lnet/klnds/$LNETLND
473     load_module lvfs/lvfs
474     load_module obdclass/obdclass
475     load_module ptlrpc/ptlrpc
476     load_module ptlrpc/gss/ptlrpc_gss
477     load_module fld/fld
478     load_module fid/fid
479     load_module lmv/lmv
480     load_module mdc/mdc
481     load_module osc/osc
482     load_module lov/lov
483     load_module mgc/mgc
484     load_module obdecho/obdecho
485     if ! client_only; then
486         SYMLIST=/proc/kallsyms
487         grep -q crc16 $SYMLIST || { modprobe crc16 2>/dev/null || true; }
488         grep -q -w jbd $SYMLIST || { modprobe jbd 2>/dev/null || true; }
489         grep -q -w jbd2 $SYMLIST || { modprobe jbd2 2>/dev/null || true; }
490                 [ "$LQUOTA" != "no" ] && load_module quota/lquota $LQUOTAOPTS
491                 if [[ $(node_fstypes $HOSTNAME) == *zfs* ]]; then
492                         modprobe zfs
493                         load_module osd-zfs/osd_zfs
494                 fi
495                 load_module mgs/mgs
496                 load_module mdd/mdd
497                 if [[ $(node_fstypes $HOSTNAME) == *ldiskfs* ]]; then
498                         #
499                         # This block shall be moved up beside osd-zfs as soon
500                         # as osd-ldiskfs stops using mdd symbols.
501                         #
502                         grep -q exportfs_decode_fh $SYMLIST ||
503                                 { modprobe exportfs 2> /dev/null || true; }
504                         load_module ../ldiskfs/ldiskfs/ldiskfs
505                         load_module lvfs/fsfilt_ldiskfs
506                         load_module osd-ldiskfs/osd_ldiskfs
507                 fi
508                 load_module mdt/mdt
509                 load_module ost/ost
510                 load_module lod/lod
511                 load_module osp/osp
512                 load_module ofd/ofd
513                 load_module osp/osp
514     fi
515
516
517     load_module llite/lustre
518     llite_lloop_enabled && load_module llite/llite_lloop
519     [ -d /r ] && OGDB=${OGDB:-"/r/tmp"}
520     OGDB=${OGDB:-$TMP}
521     rm -f $OGDB/ogdb-$HOSTNAME
522     $LCTL modules > $OGDB/ogdb-$HOSTNAME
523
524     # 'mount' doesn't look in $PATH, just sbin
525     if [ -f $LUSTRE/utils/mount.lustre ] && \
526        ! grep -qe "/sbin/mount\.lustre " /proc/mounts; then
527         [ ! -f /sbin/mount.lustre ] && touch /sbin/mount.lustre
528         mount --bind $LUSTRE/utils/mount.lustre /sbin/mount.lustre || true
529     fi
530 }
531
532 load_modules () {
533         load_modules_local
534         # bug 19124
535         # load modules on remote nodes optionally
536         # lustre-tests have to be installed on these nodes
537         if $LOAD_MODULES_REMOTE; then
538                 local list=$(comma_list $(remote_nodes_list))
539                 if [ -n "$list" ]; then
540                         echo "loading modules on: '$list'"
541                         do_rpc_nodes "$list" load_modules_local
542                 fi
543         fi
544 }
545
546 check_mem_leak () {
547     LEAK_LUSTRE=$(dmesg | tail -n 30 | grep "obd_memory.*leaked" || true)
548     LEAK_PORTALS=$(dmesg | tail -n 20 | grep "Portals memory leaked" || true)
549     if [ "$LEAK_LUSTRE" -o "$LEAK_PORTALS" ]; then
550         echo "$LEAK_LUSTRE" 1>&2
551         echo "$LEAK_PORTALS" 1>&2
552         mv $TMP/debug $TMP/debug-leak.`date +%s` || true
553         echo "Memory leaks detected"
554         [ -n "$IGNORE_LEAK" ] && { echo "ignoring leaks" && return 0; } || true
555         return 1
556     fi
557 }
558
559 unload_modules() {
560         wait_exit_ST client # bug 12845
561
562         $LUSTRE_RMMOD ldiskfs || return 2
563
564         if $LOAD_MODULES_REMOTE; then
565                 local list=$(comma_list $(remote_nodes_list))
566                 if [ -n "$list" ]; then
567                         echo "unloading modules on: '$list'"
568                         do_rpc_nodes "$list" $LUSTRE_RMMOD ldiskfs
569                         do_rpc_nodes "$list" check_mem_leak
570                 fi
571         fi
572
573     if grep -qe "/sbin/mount\.lustre" /proc/mounts; then
574         umount /sbin/mount.lustre || true
575         [ -w /sbin/mount.lustre -a ! -s /sbin/mount.lustre ] && \
576             rm -f /sbin/mount.lustre || true
577     fi
578
579     check_mem_leak || return 254
580
581     echo "modules unloaded."
582     return 0
583 }
584
585 check_gss_daemon_nodes() {
586     local list=$1
587     dname=$2
588
589     do_nodesv $list "num=\\\$(ps -o cmd -C $dname | grep $dname | wc -l);
590 if [ \\\"\\\$num\\\" -ne 1 ]; then
591     echo \\\$num instance of $dname;
592     exit 1;
593 fi; "
594 }
595
596 check_gss_daemon_facet() {
597     facet=$1
598     dname=$2
599
600     num=`do_facet $facet ps -o cmd -C $dname | grep $dname | wc -l`
601     if [ $num -ne 1 ]; then
602         echo "$num instance of $dname on $facet"
603         return 1
604     fi
605     return 0
606 }
607
608 send_sigint() {
609     local list=$1
610     shift
611     echo Stopping $@ on $list
612     do_nodes $list "killall -2 $@ 2>/dev/null || true"
613 }
614
615 # start gss daemons on all nodes, or
616 # "daemon" on "list" if set
617 start_gss_daemons() {
618     local list=$1
619     local daemon=$2
620
621     if [ "$list" ] && [ "$daemon" ] ; then
622         echo "Starting gss daemon on nodes: $list"
623         do_nodes $list "$daemon" || return 8
624         return 0
625     fi
626
627     local list=$(comma_list $(mdts_nodes))
628
629     echo "Starting gss daemon on mds: $list"
630     do_nodes $list "$LSVCGSSD -v" || return 1
631     if $GSS_PIPEFS; then
632         do_nodes $list "$LGSSD -v" || return 2
633     fi
634
635     list=$(comma_list $(osts_nodes))
636     echo "Starting gss daemon on ost: $list"
637     do_nodes $list "$LSVCGSSD -v" || return 3
638     # starting on clients
639
640     local clients=${CLIENTS:-`hostname`}
641     if $GSS_PIPEFS; then
642         echo "Starting $LGSSD on clients $clients "
643         do_nodes $clients  "$LGSSD -v" || return 4
644     fi
645
646     # wait daemons entering "stable" status
647     sleep 5
648
649     #
650     # check daemons are running
651     #
652     list=$(comma_list $(mdts_nodes) $(osts_nodes))
653     check_gss_daemon_nodes $list lsvcgssd || return 5
654     if $GSS_PIPEFS; then
655         list=$(comma_list $(mdts_nodes))
656         check_gss_daemon_nodes $list lgssd || return 6
657     fi
658     if $GSS_PIPEFS; then
659         check_gss_daemon_nodes $clients lgssd || return 7
660     fi
661 }
662
663 stop_gss_daemons() {
664     local list=$(comma_list $(mdts_nodes))
665     
666     send_sigint $list lsvcgssd lgssd
667
668     list=$(comma_list $(osts_nodes))
669     send_sigint $list lsvcgssd
670
671     list=${CLIENTS:-`hostname`}
672     send_sigint $list lgssd
673 }
674
675 init_gss() {
676     if $GSS; then
677         if ! module_loaded ptlrpc_gss; then
678             load_module ptlrpc/gss/ptlrpc_gss
679             module_loaded ptlrpc_gss ||
680                 error_exit "init_gss : GSS=$GSS, but gss/krb5 is not supported!"
681         fi
682         start_gss_daemons || error_exit "start gss daemon failed! rc=$?"
683
684         if [ -n "$LGSS_KEYRING_DEBUG" ]; then
685             echo $LGSS_KEYRING_DEBUG > /proc/fs/lustre/sptlrpc/gss/lgss_keyring/debug_level
686         fi
687     fi
688 }
689
690 cleanup_gss() {
691     if $GSS; then
692         stop_gss_daemons
693         # maybe cleanup credential cache?
694     fi
695 }
696
697 facet_type() {
698         local facet=$1
699
700         echo -n $facet | sed -e 's/^fs[0-9]\+//' -e 's/[0-9_]\+//' |
701                 tr '[:lower:]' '[:upper:]'
702 }
703
704 facet_number() {
705         local facet=$1
706
707         if [ $facet == mgs ]; then
708                 return 1
709         fi
710
711         echo -n $facet | sed -e 's/^fs[0-9]\+//' | sed -e 's/^[a-z]\+//'
712 }
713
714 facet_fstype() {
715         local facet=$1
716         local var
717
718         var=${facet}_FSTYPE
719         if [ -n "${!var}" ]; then
720                 echo -n ${!var}
721                 return
722         fi
723
724         var=$(facet_type $facet)FSTYPE
725         if [ -n "${!var}" ]; then
726                 echo -n ${!var}
727                 return
728         fi
729
730         if [ -n "$FSTYPE" ]; then
731                 echo -n $FSTYPE
732                 return
733         fi
734
735         if [[ $facet == mgs ]] && combined_mgs_mds; then
736                 facet_fstype mds1
737                 return
738         fi
739
740         return 1
741 }
742
743 node_fstypes() {
744         local node=$1
745         local fstypes
746         local fstype
747         local facets=$(get_facets)
748         local facet
749
750         for facet in ${facets//,/ }; do
751                 if [ $node == $(facet_host $facet) ] ||
752                    [ $node == "$(facet_failover_host $facet)" ]; then
753                         fstype=$(facet_fstype $facet)
754                         if [[ $fstypes != *$fstype* ]]; then
755                                 fstypes+="${fstypes:+,}$fstype"
756                         fi
757                 fi
758         done
759         echo -n $fstypes
760 }
761
762 devicelabel() {
763         local facet=$1
764         local dev=$2
765         local label
766         local fstype=$(facet_fstype $facet)
767
768         case $fstype in
769         ldiskfs)
770                 label=$(do_facet ${facet} "$E2LABEL ${dev} 2>/dev/null");;
771         zfs)
772                 label=$(do_facet ${facet} "$ZFS get -H -o value lustre:svname \
773                                            ${dev} 2>/dev/null");;
774         *)
775                 error "unknown fstype!";;
776         esac
777
778         echo -n $label
779 }
780
781 mdsdevlabel() {
782         local num=$1
783         local device=$(mdsdevname $num)
784         local label=$(devicelabel mds$num ${device} | grep -v "CMD: ")
785         echo -n $label
786 }
787
788 ostdevlabel() {
789         local num=$1
790         local device=$(ostdevname $num)
791         local label=$(devicelabel ost$num ${device} | grep -v "CMD: ")
792         echo -n $label
793 }
794
795 #
796 # This and set_osd_param() shall be used to access OSD parameters
797 # once existed under "obdfilter":
798 #
799 #   mntdev
800 #   stats
801 #   read_cache_enable
802 #   writethrough_cache_enable
803 #
804 get_osd_param() {
805         local nodes=$1
806         local device=${2:-$FSNAME-OST*}
807         local name=$3
808
809         do_nodes $nodes "$LCTL get_param -n obdfilter.$device.$name \
810                 osd-*.$device.$name 2>&1" | grep -v 'Found no match'
811 }
812
813 set_osd_param() {
814         local nodes=$1
815         local device=${2:-$FSNAME-OST*}
816         local name=$3
817         local value=$4
818
819         do_nodes $nodes "$LCTL set_param -n obdfilter.$device.$name=$value \
820                 osd-*.$device.$name=$value 2>&1" | grep -v 'Found no match'
821 }
822
823 set_debug_size () {
824     local dz=${1:-$DEBUG_SIZE}
825
826     if [ -f /sys/devices/system/cpu/possible ]; then
827         local cpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/possible)+1))
828     else
829         local cpus=$(getconf _NPROCESSORS_CONF)
830     fi
831
832     # bug 19944, adjust size to be -gt num_possible_cpus()
833     # promise 2MB for every cpu at least
834     if [ -n "$cpus" ] && [ $((cpus * 2)) -gt $dz ]; then
835         dz=$((cpus * 2))
836     fi
837     lctl set_param debug_mb=$dz
838 }
839
840 set_default_debug () {
841     local debug=${1:-"$PTLDEBUG"}
842     local subsys=${2:-"$SUBSYSTEM"}
843     local debug_size=${3:-$DEBUG_SIZE}
844
845     [ -n "$debug" ] && lctl set_param debug="$debug" >/dev/null
846     [ -n "$subsys" ] && lctl set_param subsystem_debug="${subsys# }" >/dev/null
847
848     [ -n "$debug_size" ] && set_debug_size $debug_size > /dev/null
849 }
850
851 set_default_debug_nodes () {
852         local nodes="$1"
853
854         if [[ ,$nodes, = *,$HOSTNAME,* ]]; then
855                 nodes=$(exclude_items_from_list "$nodes" "$HOSTNAME")
856                 set_default_debug
857         fi
858
859         do_rpc_nodes "$nodes" set_default_debug \
860                 \\\"$PTLDEBUG\\\" \\\"$SUBSYSTEM\\\" $DEBUG_SIZE || true
861 }
862
863 set_default_debug_facet () {
864     local facet=$1
865     local node=$(facet_active_host $facet)
866     [ -z "$node" ] && echo "No host defined for facet $facet" && exit 1
867
868     set_default_debug_nodes $node
869 }
870
871 # Facet functions
872 mount_facets () {
873         local facets=${1:-$(get_facets)}
874         local facet
875
876         for facet in ${facets//,/ }; do
877                 mount_facet $facet
878                 local RC=$?
879                 [ $RC -eq 0 ] && continue
880
881                 if [ "$TESTSUITE.$TESTNAME" = "replay-dual.test_0a" ]; then
882                         skip "Restart of $facet failed!." && touch $LU482_FAILED
883                 else
884                         error "Restart of $facet failed!"
885                 fi
886                 return $RC
887         done
888 }
889
890 #
891 # Add argument "arg" (e.g., "loop") to the comma-separated list
892 # of arguments for option "opt" (e.g., "-o") on command
893 # line "opts" (e.g., "-o flock").
894 #
895 csa_add() {
896         local opts=$1
897         local opt=$2
898         local arg=$3
899         local opt_pattern="\([[:space:]]\+\|^\)$opt"
900
901         if echo "$opts" | grep -q $opt_pattern; then
902                 opts=$(echo "$opts" | sed -e \
903                         "s/$opt_pattern[[:space:]]*[^[:space:]]\+/&,$arg/")
904         else
905                 opts+="${opts:+ }$opt $arg"
906         fi
907         echo -n "$opts"
908 }
909
910 mount_facet() {
911         local facet=$1
912         shift
913         local dev=$(facet_active $facet)_dev
914         local opt=${facet}_opt
915         local mntpt=$(facet_mntpt $facet)
916         local opts="${!opt} $@"
917
918         if [ $(facet_fstype $facet) == ldiskfs ] &&
919            ! do_facet $facet test -b ${!dev}; then
920                 opts=$(csa_add "$opts" -o loop)
921         fi
922
923         echo "Starting ${facet}: $opts ${!dev} $mntpt"
924         # for testing LU-482 error handling in mount_facets() and test_0a()
925         if [ -f $TMP/test-lu482-trigger ]; then
926                 RC=2
927         else
928                 do_facet ${facet} "mkdir -p $mntpt; mount -t lustre $opts \
929                                    ${!dev} $mntpt"
930                 RC=${PIPESTATUS[0]}
931         fi
932         if [ $RC -ne 0 ]; then
933                 echo "Start of ${!dev} on ${facet} failed ${RC}"
934     else
935         set_default_debug_facet $facet
936
937                 label=$(devicelabel ${facet} ${!dev})
938         [ -z "$label" ] && echo no label for ${!dev} && exit 1
939         eval export ${facet}_svc=${label}
940         echo Started ${label}
941     fi
942     return $RC
943 }
944
945 # start facet device options
946 start() {
947     local facet=$1
948     shift
949     local device=$1
950     shift
951     eval export ${facet}_dev=${device}
952     eval export ${facet}_opt=\"$@\"
953
954     local varname=${facet}failover_dev
955     if [ -n "${!varname}" ] ; then
956         eval export ${facet}failover_dev=${!varname}
957     else
958         eval export ${facet}failover_dev=$device
959     fi
960
961     local mntpt=$(facet_mntpt $facet)
962     do_facet ${facet} mkdir -p $mntpt
963     eval export ${facet}_MOUNT=$mntpt
964     mount_facet ${facet}
965     RC=$?
966     return $RC
967 }
968
969 #
970 # When a ZFS OSD is made read-only by replay_barrier(), its pool is "freezed".
971 # Because stopping corresponding target may not clear this in-memory state, we
972 # need to zap the pool from memory by exporting and reimporting the pool.
973 #
974 # Although the uberblocks are not updated when a pool is freezed, transactions
975 # are still written to the disks.  Modified blocks may be cached in memory when
976 # tests try reading them back.  The export-and-reimport process also evicts any
977 # cached pool data from memory to provide the correct "data loss" semantics.
978 #
979 refresh_disk() {
980         local facet=$1
981         local fstype=$(facet_fstype $facet)
982         local _dev
983         local dev
984         local poolname
985
986         if [ "${fstype}" == "zfs" ]; then
987                 _dev=$(facet_active $facet)_dev
988                 dev=${!_dev} # expand _dev to its value, e.g. ${mds1_dev}
989                 poolname="${dev%%/*}" # poolname is string before "/"
990
991                 if [ "${poolname}" == "" ]; then
992                         echo "invalid dataset name: $dev"
993                         return
994                 fi
995                 do_facet $facet "cp /etc/zfs/zpool.cache /tmp/zpool.cache.back"
996                 do_facet $facet "$ZPOOL export ${poolname}"
997                 do_facet $facet "$ZPOOL import -f -c /tmp/zpool.cache.back \
998                                  ${poolname}"
999         fi
1000 }
1001
1002 stop() {
1003     local running
1004     local facet=$1
1005     shift
1006     local HOST=`facet_active_host $facet`
1007     [ -z $HOST ] && echo stop: no host for $facet && return 0
1008
1009     local mntpt=$(facet_mntpt $facet)
1010     running=$(do_facet ${facet} "grep -c $mntpt' ' /proc/mounts") || true
1011     if [ ${running} -ne 0 ]; then
1012         echo "Stopping $mntpt (opts:$@) on $HOST"
1013         do_facet ${facet} umount -d $@ $mntpt
1014     fi
1015
1016     # umount should block, but we should wait for unrelated obd's
1017     # like the MGS or MGC to also stop.
1018     wait_exit_ST ${facet}
1019 }
1020
1021 # save quota version (both administrative and operational quotas)
1022 # add an additional parameter if mountpoint is ever different from $MOUNT
1023 #
1024 # XXX This function is kept for interoperability with old server (< 2.3.50),
1025 #     it should be removed whenever we drop the interoperability for such
1026 #     server.
1027 quota_save_version() {
1028     local fsname=${2:-$FSNAME}
1029     local spec=$1
1030     local ver=$(tr -c -d "123" <<< $spec)
1031     local type=$(tr -c -d "ug" <<< $spec)
1032
1033     [ -n "$ver" -a "$ver" != "3" ] && error "wrong quota version specifier"
1034
1035     [ -n "$type" ] && { $LFS quotacheck -$type $MOUNT || error "quotacheck has failed"; }
1036
1037     do_facet mgs "lctl conf_param ${fsname}-MDT*.mdd.quota_type=$spec"
1038     local varsvc
1039     local osts=$(get_facets OST)
1040     for ost in ${osts//,/ }; do
1041         varsvc=${ost}_svc
1042         do_facet mgs "lctl conf_param ${!varsvc}.ost.quota_type=$spec"
1043     done
1044 }
1045
1046 # client could mount several lustre
1047 #
1048 # XXX This function is kept for interoperability with old server (< 2.3.50),
1049 #     it should be removed whenever we drop the interoperability for such
1050 #     server.
1051 quota_type() {
1052         local fsname=${1:-$FSNAME}
1053         local rc=0
1054         do_facet $SINGLEMDS lctl get_param mdd.${fsname}-MDT*.quota_type ||
1055                 rc=$?
1056         do_nodes $(comma_list $(osts_nodes)) \
1057                 lctl get_param obdfilter.${fsname}-OST*.quota_type || rc=$?
1058         return $rc 
1059 }
1060
1061 # XXX This function is kept for interoperability with old server (< 2.3.50),
1062 #     it should be removed whenever we drop the interoperability for such
1063 #     server.
1064 restore_quota_old() {
1065         local mntpt=${1:-$MOUNT}
1066         local quota_type=$(quota_type $FSNAME | grep MDT | cut -d "=" -f2)
1067         if [ ! "$old_QUOTA_TYPE" ] ||
1068                 [ "$quota_type" = "$old_QUOTA_TYPE" ]; then
1069                 return
1070         fi
1071         quota_save_version $old_QUOTA_TYPE
1072 }
1073
1074 # XXX This function is kept for interoperability with old server (< 2.3.50),
1075 #     it should be removed whenever we drop the interoperability for such
1076 #     server.
1077 setup_quota_old(){
1078         local mntpt=$1
1079
1080         # no quota enforcement for now and accounting works out of the box
1081         return
1082
1083     # We need save the original quota_type params, and restore them after testing
1084
1085     # Suppose that quota type the same on mds and ost
1086     local quota_type=$(quota_type | grep MDT | cut -d "=" -f2)
1087     [ ${PIPESTATUS[0]} -eq 0 ] || error "quota_type failed!"
1088     echo "[HOST:$HOSTNAME] [old_quota_type:$quota_type] [new_quota_type:$QUOTA_TYPE]"
1089     if [ "$quota_type" != "$QUOTA_TYPE" ]; then
1090         export old_QUOTA_TYPE=$quota_type
1091         quota_save_version $QUOTA_TYPE
1092     else
1093         qtype=$(tr -c -d "ug" <<< $QUOTA_TYPE)
1094         $LFS quotacheck -$qtype $mntpt || error "quotacheck has failed for $type"
1095     fi
1096
1097     local quota_usrs=$QUOTA_USERS
1098
1099     # get_filesystem_size
1100     local disksz=$(lfs_df $mntpt | grep "summary"  | awk '{print $2}')
1101     local blk_soft=$((disksz + 1024))
1102     local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
1103
1104     local Inodes=$(lfs_df -i $mntpt | grep "summary"  | awk '{print $2}')
1105     local i_soft=$Inodes
1106     local i_hard=$((i_soft + i_soft / 20))
1107
1108     echo "Total disk size: $disksz  block-softlimit: $blk_soft block-hardlimit:
1109         $blk_hard inode-softlimit: $i_soft inode-hardlimit: $i_hard"
1110
1111     local cmd
1112     for usr in $quota_usrs; do
1113         echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
1114         for type in u g; do
1115             cmd="$LFS setquota -$type $usr -b $blk_soft -B $blk_hard -i $i_soft -I $i_hard $mntpt"
1116             echo "+ $cmd"
1117             eval $cmd || error "$cmd FAILED!"
1118         done
1119         # display the quota status
1120         echo "Quota settings for $usr : "
1121         $LFS quota -v -u $usr $mntpt || true
1122     done
1123 }
1124
1125 # get mdt quota type
1126 mdt_quota_type() {
1127         local varsvc=${SINGLEMDS}_svc
1128         do_facet $SINGLEMDS $LCTL get_param -n \
1129                 osd-$(facet_fstype $SINGLEMDS).${!varsvc}.quota_slave.enabled
1130 }
1131
1132 # get ost quota type
1133 ost_quota_type() {
1134         # All OSTs should have same quota type
1135         local varsvc=ost1_svc
1136         do_facet ost1 $LCTL get_param -n \
1137                 osd-$(facet_fstype ost1).${!varsvc}.quota_slave.enabled
1138 }
1139
1140 # restore old quota type settings
1141 restore_quota() {
1142         if [ $(lustre_version_code $SINGLEMDS) -lt $(version_code 2.3.50) ]; then
1143                 restore_quota_old
1144                 return
1145         fi
1146
1147         if [ "$old_MDT_QUOTA_TYPE" ]; then
1148                 do_facet mgs $LCTL conf_param \
1149                         $FSNAME.quota.mdt=$old_MDT_QUOTA_TYPE
1150         fi
1151         if [ "$old_OST_QUOTA_TYPE" ]; then
1152                 do_facet mgs $LCTL conf_param \
1153                         $FSNAME.quota.ost=$old_OST_QUOTA_TYPE
1154         fi
1155 }
1156
1157 # Handle the case when there is a space in the lfs df
1158 # "filesystem summary" line the same as when there is no space.
1159 # This will allow fixing the "lfs df" summary line in the future.
1160 lfs_df() {
1161         $LFS df $* | sed -e 's/filesystem /filesystem_/'
1162 }
1163
1164 setup_quota(){
1165         if [ $(lustre_version_code $SINGLEMDS) -lt $(version_code 2.3.50) ]; then
1166                 setup_quota_old $1
1167                 return
1168         fi
1169
1170         local mntpt=$1
1171
1172         # save old quota type & set new quota type
1173         local mdt_qtype=$(mdt_quota_type)
1174         local ost_qtype=$(ost_quota_type)
1175
1176         echo "[HOST:$HOSTNAME] [old_mdt_qtype:$mdt_qtype]" \
1177                 "[old_ost_qtype:$ost_qtype] [new_qtype:$QUOTA_TYPE]"
1178
1179         export old_MDT_QUOTA_TYPE=$mdt_qtype
1180         export old_OST_QUOTA_TYPE=$ost_qtype
1181
1182         do_facet mgs $LCTL conf_param $FSNAME.quota.mdt=$QUOTA_TYPE ||
1183                 error "set mdt quota type failed"
1184         do_facet mgs $LCTL conf_param $FSNAME.quota.ost=$QUOTA_TYPE ||
1185                 error "set ost quota type failed"
1186
1187         local quota_usrs=$QUOTA_USERS
1188
1189         # get_filesystem_size
1190         local disksz=$(lfs_df $mntpt | grep "summary" | awk '{print $2}')
1191         local blk_soft=$((disksz + 1024))
1192         local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
1193
1194         local inodes=$(lfs_df -i $mntpt | grep "summary" | awk '{print $2}')
1195         local i_soft=$inodes
1196         local i_hard=$((i_soft + i_soft / 20))
1197
1198         echo "Total disk size: $disksz  block-softlimit: $blk_soft" \
1199                 "block-hardlimit: $blk_hard inode-softlimit: $i_soft" \
1200                 "inode-hardlimit: $i_hard"
1201
1202         local cmd
1203         for usr in $quota_usrs; do
1204                 echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
1205                 for type in u g; do
1206                         cmd="$LFS setquota -$type $usr -b $blk_soft"
1207                         cmd="$cmd -B $blk_hard -i $i_soft -I $i_hard $mntpt"
1208                         echo "+ $cmd"
1209                         eval $cmd || error "$cmd FAILED!"
1210                 done
1211                 # display the quota status
1212                 echo "Quota settings for $usr : "
1213                 $LFS quota -v -u $usr $mntpt || true
1214         done
1215 }
1216
1217 zconf_mount() {
1218     local client=$1
1219     local mnt=$2
1220     local OPTIONS=${3:-$MOUNTOPT}
1221
1222     local device=$MGSNID:/$FSNAME
1223     if [ -z "$mnt" -o -z "$FSNAME" ]; then
1224         echo Bad zconf mount command: opt=$OPTIONS dev=$device mnt=$mnt
1225         exit 1
1226     fi
1227
1228     echo "Starting client: $client: $OPTIONS $device $mnt"
1229     do_node $client mkdir -p $mnt
1230     do_node $client mount -t lustre $OPTIONS $device $mnt || return 1
1231
1232     set_default_debug_nodes $client
1233
1234     return 0
1235 }
1236
1237 zconf_umount() {
1238     local client=$1
1239     local mnt=$2
1240     local force
1241     local busy 
1242     local need_kill
1243
1244     [ "$3" ] && force=-f
1245     local running=$(do_node $client "grep -c $mnt' ' /proc/mounts") || true
1246     if [ $running -ne 0 ]; then
1247         echo "Stopping client $client $mnt (opts:$force)"
1248         do_node $client lsof -t $mnt || need_kill=no
1249         if [ "x$force" != "x" -a "x$need_kill" != "xno" ]; then
1250             pids=$(do_node $client lsof -t $mnt | sort -u);
1251             if [ -n $pids ]; then
1252                 do_node $client kill -9 $pids || true
1253             fi
1254         fi
1255
1256         busy=$(do_node $client "umount $force $mnt 2>&1" | grep -c "busy") || true
1257         if [ $busy -ne 0 ] ; then
1258             echo "$mnt is still busy, wait one second" && sleep 1
1259             do_node $client umount $force $mnt
1260         fi
1261     fi
1262 }
1263
1264 # nodes is comma list
1265 sanity_mount_check_nodes () {
1266     local nodes=$1
1267     shift
1268     local mnts="$@"
1269     local mnt
1270
1271     # FIXME: assume that all cluster nodes run the same os
1272     [ "$(uname)" = Linux ] || return 0
1273
1274     local rc=0
1275     for mnt in $mnts ; do
1276         do_nodes $nodes "running=\\\$(grep -c $mnt' ' /proc/mounts);
1277 mpts=\\\$(mount | grep -c $mnt' ');
1278 if [ \\\$running -ne \\\$mpts ]; then
1279     echo \\\$(hostname) env are INSANE!;
1280     exit 1;
1281 fi"
1282     [ $? -eq 0 ] || rc=1 
1283     done
1284     return $rc
1285 }
1286
1287 sanity_mount_check_servers () {
1288     [ "$CLIENTONLY" ] && 
1289         { echo "CLIENTONLY mode, skip mount_check_servers"; return 0; } || true
1290     echo Checking servers environments
1291
1292     # FIXME: modify get_facets to display all facets wo params
1293     local facets="$(get_facets OST),$(get_facets MDS),mgs"
1294     local node
1295     local mntpt
1296     local facet
1297     for facet in ${facets//,/ }; do
1298         node=$(facet_host ${facet})
1299         mntpt=$(facet_mntpt $facet)
1300         sanity_mount_check_nodes $node $mntpt ||
1301             { error "server $node environments are insane!"; return 1; }
1302     done
1303 }
1304
1305 sanity_mount_check_clients () {
1306     local clients=${1:-$CLIENTS}
1307     local mntpt=${2:-$MOUNT}
1308     local mntpt2=${3:-$MOUNT2}
1309
1310     [ -z $clients ] && clients=$(hostname)
1311     echo Checking clients $clients environments
1312
1313     sanity_mount_check_nodes $clients $mntpt $mntpt2 ||
1314        error "clients environments are insane!"
1315 }
1316
1317 sanity_mount_check () {
1318     sanity_mount_check_servers || return 1
1319     sanity_mount_check_clients || return 2
1320 }
1321
1322 # mount clients if not mouted
1323 zconf_mount_clients() {
1324     local clients=$1
1325     local mnt=$2
1326     local OPTIONS=${3:-$MOUNTOPT}
1327
1328     local device=$MGSNID:/$FSNAME
1329     if [ -z "$mnt" -o -z "$FSNAME" ]; then
1330         echo Bad zconf mount command: opt=$OPTIONS dev=$device mnt=$mnt
1331         exit 1
1332     fi
1333
1334     echo "Starting client $clients: $OPTIONS $device $mnt"
1335
1336     do_nodes $clients "
1337 running=\\\$(mount | grep -c $mnt' ');
1338 rc=0;
1339 if [ \\\$running -eq 0 ] ; then
1340     mkdir -p $mnt;
1341     mount -t lustre $OPTIONS $device $mnt;
1342     rc=\\\$?;
1343 fi;
1344 exit \\\$rc" || return ${PIPESTATUS[0]}
1345
1346     echo "Started clients $clients: "
1347     do_nodes $clients "mount | grep $mnt' '"
1348
1349     set_default_debug_nodes $clients
1350
1351     return 0
1352 }
1353
1354 zconf_umount_clients() {
1355     local clients=$1
1356     local mnt=$2
1357     local force
1358
1359     [ "$3" ] && force=-f
1360
1361     echo "Stopping clients: $clients $mnt (opts:$force)"
1362     do_nodes $clients "running=\\\$(grep -c $mnt' ' /proc/mounts);
1363 if [ \\\$running -ne 0 ] ; then
1364 echo Stopping client \\\$(hostname) $mnt opts:$force;
1365 lsof $mnt || need_kill=no;
1366 if [ "x$force" != "x" -a "x\\\$need_kill" != "xno" ]; then
1367     pids=\\\$(lsof -t $mnt | sort -u);
1368     if [ -n \\\"\\\$pids\\\" ]; then
1369              kill -9 \\\$pids;
1370     fi
1371 fi;
1372 while umount $force $mnt 2>&1 | grep -q "busy"; do
1373     echo "$mnt is still busy, wait one second" && sleep 1;
1374 done;
1375 fi"
1376 }
1377
1378 shutdown_node () {
1379     local node=$1
1380     echo + $POWER_DOWN $node
1381     $POWER_DOWN $node
1382 }
1383
1384 shutdown_node_hard () {
1385     local host=$1
1386     local attempts=$SHUTDOWN_ATTEMPTS
1387
1388     for i in $(seq $attempts) ; do
1389         shutdown_node $host
1390         sleep 1
1391         wait_for_function --quiet "! ping -w 3 -c 1 $host" 5 1 && return 0
1392         echo "waiting for $host to fail attempts=$attempts"
1393         [ $i -lt $attempts ] || \
1394             { echo "$host still pingable after power down! attempts=$attempts" && return 1; } 
1395     done
1396 }
1397
1398 shutdown_client() {
1399     local client=$1
1400     local mnt=${2:-$MOUNT}
1401     local attempts=3
1402
1403     if [ "$FAILURE_MODE" = HARD ]; then
1404         shutdown_node_hard $client
1405     else
1406        zconf_umount_clients $client $mnt -f
1407     fi
1408 }
1409
1410 facets_on_host () {
1411     local host=$1
1412     local facets="$(get_facets OST),$(get_facets MDS)"
1413     local affected
1414
1415     combined_mgs_mds || facets="$facets,mgs"
1416
1417     for facet in ${facets//,/ }; do
1418         if [ $(facet_active_host $facet) == $host ]; then
1419            affected="$affected $facet"
1420         fi
1421     done
1422
1423     echo $(comma_list $affected)
1424 }
1425
1426 facet_up() {
1427         local facet=$1
1428         local host=${2:-$(facet_host $facet)}
1429
1430         local label=$(convert_facet2label $facet)
1431         do_node $host $LCTL dl | awk '{print $4}' | grep -q -x $label
1432 }
1433
1434 facets_up_on_host () {
1435     local host=$1
1436     local facets=$(facets_on_host $host)
1437     local affected_up
1438
1439     for facet in ${facets//,/ }; do
1440         if $(facet_up $facet $host); then
1441             affected_up="$affected_up $facet"
1442         fi
1443     done
1444
1445     echo $(comma_list $affected_up)
1446 }
1447
1448 shutdown_facet() {
1449     local facet=$1
1450
1451     if [ "$FAILURE_MODE" = HARD ]; then
1452         shutdown_node_hard $(facet_active_host $facet)
1453     else
1454         stop $facet
1455     fi
1456 }
1457
1458 reboot_node() {
1459     local node=$1
1460     echo + $POWER_UP $node
1461     $POWER_UP $node
1462 }
1463
1464 remount_facet() {
1465     local facet=$1
1466
1467     stop $facet
1468     mount_facet $facet
1469 }
1470
1471 reboot_facet() {
1472         local facet=$1
1473         if [ "$FAILURE_MODE" = HARD ]; then
1474                 reboot_node $(facet_active_host $facet)
1475         else
1476                 refresh_disk ${facet}
1477                 sleep 10
1478         fi
1479 }
1480
1481 boot_node() {
1482     local node=$1
1483     if [ "$FAILURE_MODE" = HARD ]; then
1484        reboot_node $node
1485        wait_for_host $node
1486     fi
1487 }
1488
1489 facets_hosts () {
1490     local facets=$1
1491     local hosts
1492
1493     for facet in ${facets//,/ }; do
1494         hosts=$(expand_list $hosts $(facet_host $facet) )
1495     done
1496
1497     echo $hosts
1498 }
1499
1500 _check_progs_installed () {
1501     local progs=$@
1502     local rc=0
1503
1504     for prog in $progs; do
1505         if ! [ "$(which $prog)"  -o  "${!prog}" ]; then
1506            echo $prog missing on $(hostname)
1507            rc=1
1508         fi
1509     done
1510     return $rc
1511 }
1512
1513 check_progs_installed () {
1514         local nodes=$1
1515         shift
1516
1517         do_rpc_nodes "$nodes" _check_progs_installed $@
1518 }
1519
1520 # recovery-scale functions
1521 node_var_name() {
1522     echo __$(echo $1 | tr '-' '_' | tr '.' '_')
1523 }
1524
1525 start_client_load() {
1526     local client=$1
1527     local load=$2
1528     local var=$(node_var_name $client)_load
1529     eval export ${var}=$load
1530
1531     do_node $client "PATH=$PATH MOUNT=$MOUNT ERRORS_OK=$ERRORS_OK \
1532 BREAK_ON_ERROR=$BREAK_ON_ERROR \
1533 END_RUN_FILE=$END_RUN_FILE \
1534 LOAD_PID_FILE=$LOAD_PID_FILE \
1535 TESTLOG_PREFIX=$TESTLOG_PREFIX \
1536 TESTNAME=$TESTNAME \
1537 DBENCH_LIB=$DBENCH_LIB \
1538 DBENCH_SRC=$DBENCH_SRC \
1539 LFS=$LFS \
1540 run_${load}.sh" &
1541     local ppid=$!
1542     log "Started client load: ${load} on $client"
1543
1544     # get the children process IDs
1545     local pids=$(ps --ppid $ppid -o pid= | xargs)
1546     CLIENT_LOAD_PIDS="$CLIENT_LOAD_PIDS $ppid $pids"
1547     return 0
1548 }
1549
1550 start_client_loads () {
1551     local -a clients=(${1//,/ })
1552     local numloads=${#CLIENT_LOADS[@]}
1553     local testnum
1554
1555     for ((nodenum=0; nodenum < ${#clients[@]}; nodenum++ )); do
1556         testnum=$((nodenum % numloads))
1557         start_client_load ${clients[nodenum]} ${CLIENT_LOADS[testnum]}
1558     done
1559     # bug 22169: wait the background threads to start
1560     sleep 2
1561 }
1562
1563 # only for remote client
1564 check_client_load () {
1565     local client=$1
1566     local var=$(node_var_name $client)_load
1567     local TESTLOAD=run_${!var}.sh
1568
1569     ps auxww | grep -v grep | grep $client | grep -q "$TESTLOAD" || return 1
1570
1571     # bug 18914: try to connect several times not only when
1572     # check ps, but  while check_catastrophe also
1573     local tries=3
1574     local RC=254
1575     while [ $RC = 254 -a $tries -gt 0 ]; do
1576         let tries=$tries-1
1577         # assume success
1578         RC=0
1579         if ! check_catastrophe $client; then
1580             RC=${PIPESTATUS[0]}
1581             if [ $RC -eq 254 ]; then
1582                 # FIXME: not sure how long we shuold sleep here
1583                 sleep 10
1584                 continue
1585             fi
1586             echo "check catastrophe failed: RC=$RC "
1587             return $RC
1588         fi
1589     done
1590     # We can continue try to connect if RC=254
1591     # Just print the warning about this
1592     if [ $RC = 254 ]; then
1593         echo "got a return status of $RC from do_node while checking catastrophe on $client"
1594     fi
1595
1596     # see if the load is still on the client
1597     tries=3
1598     RC=254
1599     while [ $RC = 254 -a $tries -gt 0 ]; do
1600         let tries=$tries-1
1601         # assume success
1602         RC=0
1603         if ! do_node $client "ps auxwww | grep -v grep | grep -q $TESTLOAD"; then
1604             RC=${PIPESTATUS[0]}
1605             sleep 30
1606         fi
1607     done
1608     if [ $RC = 254 ]; then
1609         echo "got a return status of $RC from do_node while checking (catastrophe and 'ps') the client load on $client"
1610         # see if we can diagnose a bit why this is
1611     fi
1612
1613     return $RC
1614 }
1615 check_client_loads () {
1616    local clients=${1//,/ }
1617    local client=
1618    local rc=0
1619
1620    for client in $clients; do
1621       check_client_load $client
1622       rc=${PIPESTATUS[0]}
1623       if [ "$rc" != 0 ]; then
1624         log "Client load failed on node $client, rc=$rc"
1625         return $rc
1626       fi
1627    done
1628 }
1629
1630 restart_client_loads () {
1631     local clients=${1//,/ }
1632     local expectedfail=${2:-""}
1633     local client=
1634     local rc=0
1635
1636     for client in $clients; do
1637         check_client_load $client
1638         rc=${PIPESTATUS[0]}
1639         if [ "$rc" != 0 -a "$expectedfail" ]; then
1640             local var=$(node_var_name $client)_load
1641             start_client_load $client ${!var}
1642             echo "Restarted client load ${!var}: on $client. Checking ..."
1643             check_client_load $client
1644             rc=${PIPESTATUS[0]}
1645             if [ "$rc" != 0 ]; then
1646                 log "Client load failed to restart on node $client, rc=$rc"
1647                 # failure one client load means test fail
1648                 # we do not need to check other
1649                 return $rc
1650             fi
1651         else
1652             return $rc
1653         fi
1654     done
1655 }
1656
1657 # Start vmstat and save its process ID in a file.
1658 start_vmstat() {
1659     local nodes=$1
1660     local pid_file=$2
1661
1662     [ -z "$nodes" -o -z "$pid_file" ] && return 0
1663
1664     do_nodes $nodes \
1665         "vmstat 1 > $TESTLOG_PREFIX.$TESTNAME.vmstat.\\\$(hostname -s).log \
1666         2>/dev/null </dev/null & echo \\\$! > $pid_file"
1667 }
1668
1669 # Display the nodes on which client loads failed.
1670 print_end_run_file() {
1671     local file=$1
1672     local node
1673
1674     [ -s $file ] || return 0
1675
1676     echo "Found the END_RUN_FILE file: $file"
1677     cat $file
1678
1679     # A client load will stop if it finds the END_RUN_FILE file.
1680     # That does not mean the client load actually failed though.
1681     # The first node in END_RUN_FILE is the one we are interested in.
1682     read node < $file
1683
1684     if [ -n "$node" ]; then
1685         local var=$(node_var_name $node)_load
1686
1687         local prefix=$TESTLOG_PREFIX
1688         [ -n "$TESTNAME" ] && prefix=$prefix.$TESTNAME
1689         local stdout_log=$prefix.run_${!var}_stdout.$node.log
1690         local debug_log=$(echo $stdout_log | sed 's/\(.*\)stdout/\1debug/')
1691
1692         echo "Client load ${!var} failed on node $node:"
1693         echo "$stdout_log"
1694         echo "$debug_log"
1695     fi
1696 }
1697
1698 # Stop the process which had its PID saved in a file.
1699 stop_process() {
1700     local nodes=$1
1701     local pid_file=$2
1702
1703     [ -z "$nodes" -o -z "$pid_file" ] && return 0
1704
1705     do_nodes $nodes "test -f $pid_file &&
1706         { kill -s TERM \\\$(cat $pid_file); rm -f $pid_file; }" || true
1707 }
1708
1709 # Stop all client loads.
1710 stop_client_loads() {
1711     local nodes=${1:-$CLIENTS}
1712     local pid_file=$2
1713
1714     # stop the client loads
1715     stop_process $nodes $pid_file
1716
1717     # clean up the processes that started them
1718     [ -n "$CLIENT_LOAD_PIDS" ] && kill -9 $CLIENT_LOAD_PIDS 2>/dev/null || true
1719 }
1720 # End recovery-scale functions
1721
1722 # verify that lustre actually cleaned up properly
1723 cleanup_check() {
1724     [ -f $CATASTROPHE ] && [ `cat $CATASTROPHE` -ne 0 ] && \
1725         error "LBUG/LASSERT detected"
1726     BUSY=`dmesg | grep -i destruct || true`
1727     if [ "$BUSY" ]; then
1728         echo "$BUSY" 1>&2
1729         [ -e $TMP/debug ] && mv $TMP/debug $TMP/debug-busy.`date +%s`
1730         exit 205
1731     fi
1732
1733     check_mem_leak || exit 204
1734
1735         [ "`lctl dl 2> /dev/null | wc -l`" -gt 0 ] && lctl dl &&
1736                 echo "$TESTSUITE: lustre didn't clean up..." 1>&2 &&
1737                 return 202 || true
1738
1739         if module_loaded lnet || module_loaded libcfs; then
1740                 echo "$TESTSUITE: modules still loaded..." 1>&2
1741                 /sbin/lsmod 1>&2
1742                 return 203
1743         fi
1744         return 0
1745 }
1746
1747 wait_update () {
1748     local node=$1
1749     local TEST=$2
1750     local FINAL=$3
1751     local MAX=${4:-90}
1752
1753         local RESULT
1754         local WAIT=0
1755         local sleep=1
1756         local print=10
1757         while [ true ]; do
1758             RESULT=$(do_node $node "$TEST")
1759             if [ "$RESULT" == "$FINAL" ]; then
1760                 [ -z "$RESULT" -o $WAIT -le $sleep ] ||
1761                     echo "Updated after ${WAIT}s: wanted '$FINAL' got '$RESULT'"
1762                 return 0
1763             fi
1764             [ $WAIT -ge $MAX ] && break
1765             [ $((WAIT % print)) -eq 0 ] &&
1766                 echo "Waiting $((MAX - WAIT)) secs for update"
1767             WAIT=$((WAIT + sleep))
1768             sleep $sleep
1769         done
1770         echo "Update not seen after ${MAX}s: wanted '$FINAL' got '$RESULT'"
1771         return 3
1772 }
1773
1774 wait_update_facet() {
1775         local facet=$1
1776         shift
1777         wait_update $(facet_active_host $facet) "$@"
1778 }
1779
1780 sync_all_data() {
1781         do_node $(osts_nodes) "lctl set_param -n osd*.*OS*.force_sync 1" 2>&1 |
1782                 grep -v 'Found no match'
1783 }
1784
1785 wait_delete_completed_mds() {
1786         local MAX_WAIT=${1:-20}
1787         local mds2sync=""
1788         local stime=`date +%s`
1789         local etime
1790         local node
1791         local changes
1792
1793         # find MDS with pending deletions
1794         for node in $(mdts_nodes); do
1795                 changes=$(do_node $node "lctl get_param -n osc.*MDT*.sync_*" \
1796                         2>/dev/null | calc_sum)
1797                 if [ -z "$changes" ] || [ $changes -eq 0 ]; then
1798                         continue
1799                 fi
1800                 mds2sync="$mds2sync $node"
1801         done
1802         if [ "$mds2sync" == "" ]; then
1803                 return
1804         fi
1805         mds2sync=$(comma_list $mds2sync)
1806
1807         # sync MDS transactions
1808         do_nodes $mds2sync "lctl set_param -n osd*.*MD*.force_sync 1"
1809
1810         # wait till all changes are sent and commmitted by OSTs
1811         # for ldiskfs space is released upon execution, but DMU
1812         # do this upon commit
1813
1814         local WAIT=0
1815         while [ "$WAIT" -ne "$MAX_WAIT" ]; do
1816                 changes=$(do_nodes $mds2sync "lctl get_param -n osc.*MDT*.sync_*" \
1817                         | calc_sum)
1818                 #echo "$node: $changes changes on all"
1819                 if [ "$changes" -eq "0" ]; then
1820                         etime=`date +%s`
1821                         #echo "delete took $((etime - stime)) seconds"
1822                         return
1823                 fi
1824                 sleep 1
1825                 WAIT=$(( WAIT + 1))
1826         done
1827
1828         etime=`date +%s`
1829         echo "Delete is not completed in $((etime - stime)) seconds"
1830         do_nodes $mds2sync "lctl get_param osc.*MDT*.sync_*"
1831 }
1832
1833 wait_for_host() {
1834     local hostlist=$1
1835
1836     # we can use "for" here because we are waiting the slowest
1837     for host in ${hostlist//,/ }; do
1838         check_network "$host" 900
1839     done
1840     while ! do_nodes $hostlist hostname  > /dev/null; do sleep 5; done
1841 }
1842
1843 wait_for_facet() {
1844     local facetlist=$1
1845     local hostlist
1846
1847     for facet in ${facetlist//,/ }; do
1848         hostlist=$(expand_list $hostlist $(facet_active_host $facet))
1849     done
1850     wait_for_host $hostlist
1851 }
1852
1853 _wait_recovery_complete () {
1854     local param=$1
1855
1856     # Use default policy if $2 is not passed by caller.
1857     local MAX=${2:-$(max_recovery_time)}
1858
1859     local WAIT=0
1860     local STATUS=
1861
1862     while [ $WAIT -lt $MAX ]; do
1863         STATUS=$(lctl get_param -n $param | grep status)
1864         echo $param $STATUS
1865         [[ $STATUS = "status: COMPLETE" || $STATUS = "status: INACTIVE" ]] && return 0
1866         sleep 5
1867         WAIT=$((WAIT + 5))
1868         echo "Waiting $((MAX - WAIT)) secs for $param recovery done. $STATUS"
1869     done
1870     echo "$param recovery not done in $MAX sec. $STATUS"
1871     return 1
1872 }
1873
1874 wait_recovery_complete () {
1875     local facet=$1
1876
1877     # with an assumption that at_max is the same on all nodes
1878     local MAX=${2:-$(max_recovery_time)}
1879
1880     local facets=$facet
1881     if [ "$FAILURE_MODE" = HARD ]; then
1882         facets=$(facets_on_host $(facet_active_host $facet))
1883     fi
1884     echo affected facets: $facets
1885
1886         # we can use "for" here because we are waiting the slowest
1887         for facet in ${facets//,/ }; do
1888                 local var_svc=${facet}_svc
1889                 local param="*.${!var_svc}.recovery_status"
1890
1891                 local host=$(facet_active_host $facet)
1892                 do_rpc_nodes "$host" _wait_recovery_complete $param $MAX
1893         done
1894 }
1895
1896 wait_mds_ost_sync () {
1897     # just because recovery is done doesn't mean we've finished
1898     # orphan cleanup. Wait for llogs to get synchronized.
1899     echo "Waiting for orphan cleanup..."
1900     # MAX value includes time needed for MDS-OST reconnection
1901     local MAX=$(( TIMEOUT * 2 ))
1902     local WAIT=0
1903     while [ $WAIT -lt $MAX ]; do
1904         local -a sync=($(do_nodes $(comma_list $(mdts_nodes)) \
1905             "$LCTL get_param -n osp.*osc*.old_sync_processed"))
1906         local con=1
1907         local i
1908         for ((i=0; i<${#sync[@]}; i++)); do
1909             [ ${sync[$i]} -eq 1 ] && continue
1910             # there is a not finished MDS-OST synchronization
1911             con=0
1912             break;
1913         done
1914         sleep 2 # increase waiting time and cover statfs cache
1915         [ ${con} -eq 1 ] && return 0
1916         echo "Waiting $WAIT secs for $facet mds-ost sync done."
1917         WAIT=$((WAIT + 2))
1918     done
1919     echo "$facet recovery not done in $MAX sec. $STATUS"
1920     return 1
1921 }
1922
1923 wait_destroy_complete () {
1924         echo "Waiting for local destroys to complete"
1925         # MAX value shouldn't be big as this mean server responsiveness
1926         # never increase this just to make test pass but investigate
1927         # why it takes so long time
1928         local MAX=5
1929         local WAIT=0
1930         while [ $WAIT -lt $MAX ]; do
1931                 local -a RPCs=($($LCTL get_param -n osc.*.destroys_in_flight))
1932                 local con=1
1933                 local i
1934
1935                 for ((i=0; i<${#RPCs[@]}; i++)); do
1936                         [ ${RPCs[$i]} -eq 0 ] && continue
1937                         # there are still some destroy RPCs in flight
1938                         con=0
1939                         break;
1940                 done
1941                 sleep 1
1942                 [ ${con} -eq 1 ] && return 0 # done waiting
1943                 echo "Waiting ${WAIT}s for local destroys to complete"
1944                 WAIT=$((WAIT + 1))
1945         done
1946         echo "Local destroys weren't done in $MAX sec."
1947         return 1
1948 }
1949
1950 wait_delete_completed() {
1951         wait_delete_completed_mds $1 || return $?
1952         wait_destroy_complete
1953 }
1954
1955 wait_exit_ST () {
1956     local facet=$1
1957
1958     local WAIT=0
1959     local INTERVAL=1
1960     local running
1961     # conf-sanity 31 takes a long time cleanup
1962     while [ $WAIT -lt 300 ]; do
1963         running=$(do_facet ${facet} "lsmod | grep lnet > /dev/null && lctl dl | grep ' ST '") || true
1964         [ -z "${running}" ] && return 0
1965         echo "waited $WAIT for${running}"
1966         [ $INTERVAL -lt 64 ] && INTERVAL=$((INTERVAL + INTERVAL))
1967         sleep $INTERVAL
1968         WAIT=$((WAIT + INTERVAL))
1969     done
1970     echo "service didn't stop after $WAIT seconds.  Still running:"
1971     echo ${running}
1972     return 1
1973 }
1974
1975 wait_remote_prog () {
1976    local prog=$1
1977    local WAIT=0
1978    local INTERVAL=5
1979    local rc=0
1980
1981    [ "$PDSH" = "no_dsh" ] && return 0
1982
1983    while [ $WAIT -lt $2 ]; do
1984         running=$(ps uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep) || true
1985         [ -z "${running}" ] && return 0 || true
1986         echo "waited $WAIT for: "
1987         echo "$running"
1988         [ $INTERVAL -lt 60 ] && INTERVAL=$((INTERVAL + INTERVAL))
1989         sleep $INTERVAL
1990         WAIT=$((WAIT + INTERVAL))
1991     done
1992     local pids=$(ps  uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep | awk '{print $2}')
1993     [ -z "$pids" ] && return 0
1994     echo "$PDSH processes still exists after $WAIT seconds.  Still running: $pids"
1995     # FIXME: not portable
1996     for pid in $pids; do
1997         cat /proc/${pid}/status || true
1998         cat /proc/${pid}/wchan || true
1999         echo "Killing $pid"
2000         kill -9 $pid || true
2001         sleep 1
2002         ps -P $pid && rc=1
2003     done
2004
2005     return $rc
2006 }
2007
2008 clients_up() {
2009     # not every config has many clients
2010     sleep 1
2011     if [ ! -z "$CLIENTS" ]; then
2012         $PDSH $CLIENTS "stat -f $MOUNT" > /dev/null
2013     else
2014         stat -f $MOUNT > /dev/null
2015     fi
2016 }
2017
2018 client_up() {
2019     local client=$1
2020     # usually checked on particular client or locally
2021     sleep 1
2022     if [ ! -z "$client" ]; then
2023         $PDSH $client "stat -f $MOUNT" > /dev/null
2024     else
2025         stat -f $MOUNT > /dev/null
2026     fi
2027 }
2028
2029 client_evicted() {
2030     ! client_up $1
2031 }
2032
2033 client_reconnect() {
2034     uname -n >> $MOUNT/recon
2035     if [ -z "$CLIENTS" ]; then
2036         df $MOUNT; uname -n >> $MOUNT/recon
2037     else
2038         do_nodes $CLIENTS "df $MOUNT; uname -n >> $MOUNT/recon" > /dev/null
2039     fi
2040     echo Connected clients:
2041     cat $MOUNT/recon
2042     ls -l $MOUNT/recon > /dev/null
2043     rm $MOUNT/recon
2044 }
2045
2046 affected_facets () {
2047     local facet=$1
2048
2049     local host=$(facet_active_host $facet)
2050     local affected=$facet
2051
2052     if [ "$FAILURE_MODE" = HARD ]; then
2053         affected=$(facets_up_on_host $host)
2054     fi
2055     echo $affected
2056 }
2057
2058 facet_failover() {
2059         local facets=$1
2060         local sleep_time=$2
2061         local -a affecteds
2062         local facet
2063         local total=0
2064         local index=0
2065         local skip
2066
2067         #Because it will only get up facets, we need get affected
2068         #facets before shutdown
2069         #For HARD Failure mode, it needs make sure facets on the same
2070         #HOST will only be shutdown and reboot once
2071         for facet in ${facets//,/ }; do
2072                 local affected_facet
2073                 skip=0
2074                 #check whether facet has been included in other affected facets
2075                 for ((index=0; index<$total; index++)); do
2076                         [[ *,$facet,* == ,${affecteds[index]}, ]] && skip=1
2077                 done
2078
2079                 if [ $skip -eq 0 ]; then
2080                         affecteds[$total]=$(affected_facets $facet)
2081                         total=$((total+1))
2082                 fi
2083         done
2084
2085         for ((index=0; index<$total; index++)); do
2086                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
2087                 local host=$(facet_active_host $facet)
2088                 echo "Failing ${affecteds[index]} on $host"
2089                 shutdown_facet $facet
2090         done
2091
2092         for ((index=0; index<$total; index++)); do
2093                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
2094                 echo reboot facets: ${affecteds[index]}
2095
2096                 reboot_facet $facet
2097
2098                 change_active ${affecteds[index]}
2099
2100                 wait_for_facet ${affecteds[index]}
2101                 # start mgs first if it is affected
2102                 if ! combined_mgs_mds &&
2103                         list_member ${affecteds[index]} mgs; then
2104                         mount_facet mgs || error "Restart of mgs failed"
2105                 fi
2106                 # FIXME; has to be changed to mount all facets concurrently
2107                 affected=$(exclude_items_from_list ${affecteds[index]} mgs)
2108                 echo mount facets: ${affecteds[index]}
2109                 mount_facets ${affecteds[index]}
2110         done
2111 }
2112
2113 obd_name() {
2114     local facet=$1
2115 }
2116
2117 replay_barrier() {
2118         local facet=$1
2119         do_facet $facet "sync; sync; sync"
2120         df $MOUNT
2121
2122         # make sure there will be no seq change
2123         local clients=${CLIENTS:-$HOSTNAME}
2124         local f=fsa-\\\$\(hostname\)
2125         do_nodes $clients "mcreate $MOUNT/$f; rm $MOUNT/$f"
2126         do_nodes $clients "if [ -d $MOUNT2 ]; then mcreate $MOUNT2/$f; rm $MOUNT2/$f; fi"
2127
2128         local svc=${facet}_svc
2129         do_facet $facet $LCTL --device ${!svc} notransno
2130         do_facet $facet $LCTL --device ${!svc} readonly
2131         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2132         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2133 }
2134
2135 replay_barrier_nodf() {
2136         local facet=$1    echo running=${running}
2137         do_facet $facet "sync; sync; sync"
2138         local svc=${facet}_svc
2139         echo Replay barrier on ${!svc}
2140         do_facet $facet $LCTL --device ${!svc} notransno
2141         do_facet $facet $LCTL --device ${!svc} readonly
2142         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2143         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2144 }
2145
2146 replay_barrier_nosync() {
2147         local facet=$1    echo running=${running}
2148         local svc=${facet}_svc
2149         echo Replay barrier on ${!svc}
2150         do_facet $facet $LCTL --device ${!svc} notransno
2151         do_facet $facet $LCTL --device ${!svc} readonly
2152         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2153         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2154 }
2155
2156 mds_evict_client() {
2157     UUID=`lctl get_param -n mdc.${mds1_svc}-mdc-*.uuid`
2158     do_facet mds1 "lctl set_param -n mdt.${mds1_svc}.evict_client $UUID"
2159 }
2160
2161 ost_evict_client() {
2162     UUID=`lctl get_param -n devices| grep ${ost1_svc}-osc- | egrep -v 'MDT' | awk '{print $5}'`
2163     do_facet ost1 "lctl set_param -n obdfilter.${ost1_svc}.evict_client $UUID"
2164 }
2165
2166 fail() {
2167     facet_failover $* || error "failover: $?"
2168     clients_up || error "post-failover df: $?"
2169 }
2170
2171 fail_nodf() {
2172         local facet=$1
2173         facet_failover $facet
2174 }
2175
2176 fail_abort() {
2177         local facet=$1
2178         stop $facet
2179         refresh_disk ${facet}
2180         change_active $facet
2181         wait_for_facet $facet
2182         mount_facet $facet -o abort_recovery
2183         clients_up || echo "first df failed: $?"
2184         clients_up || error "post-failover df: $?"
2185 }
2186
2187 do_lmc() {
2188     echo There is no lmc.  This is mountconf, baby.
2189     exit 1
2190 }
2191
2192 host_nids_address() {
2193     local nodes=$1
2194     local kind=$2
2195
2196     if [ -n "$kind" ]; then
2197         nids=$(do_nodes $nodes "$LCTL list_nids | grep $kind | cut -f 1 -d '@'")
2198     else
2199         nids=$(do_nodes $nodes "$LCTL list_nids all | cut -f 1 -d '@'")
2200     fi
2201     echo $nids
2202 }
2203
2204 h2name_or_ip() {
2205     if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2206         echo $1"@$2"
2207     fi
2208 }
2209
2210 h2ptl() {
2211    if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2212        ID=`xtprocadmin -n $1 2>/dev/null | egrep -v 'NID' | awk '{print $1}'`
2213        if [ -z "$ID" ]; then
2214            echo "Could not get a ptl id for $1..."
2215            exit 1
2216        fi
2217        echo $ID"@ptl"
2218    fi
2219 }
2220 declare -fx h2ptl
2221
2222 h2tcp() {
2223     h2name_or_ip "$1" "tcp"
2224 }
2225 declare -fx h2tcp
2226
2227 h2elan() {
2228     if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2229         if type __h2elan >/dev/null 2>&1; then
2230             ID=$(__h2elan $1)
2231         else
2232             ID=`echo $1 | sed 's/[^0-9]*//g'`
2233         fi
2234         echo $ID"@elan"
2235     fi
2236 }
2237 declare -fx h2elan
2238
2239 h2o2ib() {
2240     h2name_or_ip "$1" "o2ib"
2241 }
2242 declare -fx h2o2ib
2243
2244 # This enables variables in cfg/"setup".sh files to support the pdsh HOSTLIST
2245 # expressions format. As a bonus we can then just pass in those variables
2246 # to pdsh. What this function does is take a HOSTLIST type string and
2247 # expand it into a space deliminated list for us.
2248 hostlist_expand() {
2249     local hostlist=$1
2250     local offset=$2
2251     local myList
2252     local item
2253     local list
2254
2255     [ -z "$hostlist" ] && return
2256
2257     # Translate the case of [..],..,[..] to [..] .. [..]
2258     list="${hostlist/],/] }"
2259     front=${list%%[*}
2260     [[ "$front" == *,* ]] && {
2261         new="${list%,*} "
2262         old="${list%,*},"
2263         list=${list/${old}/${new}}
2264     }
2265
2266     for item in $list; do
2267         # Test if we have any []'s at all
2268         if [ "$item" != "${item/\[/}" ]; then {
2269             # Expand the [*] into list
2270             name=${item%%[*}
2271             back=${item#*]}
2272
2273             if [ "$name" != "$item" ]; then
2274                 group=${item#$name[*}
2275                 group=${group%%]*}
2276
2277                 for range in ${group//,/ }; do
2278                     begin=${range%-*}
2279                     end=${range#*-}
2280
2281                     # Number of leading zeros
2282                     padlen=${#begin}
2283                     padlen2=${#end}
2284                     end=$(echo $end | sed 's/0*//')
2285                     [[ -z "$end" ]] && end=0
2286                     [[ $padlen2 -gt $padlen ]] && {
2287                         [[ $padlen2 -eq ${#end} ]] && padlen2=0
2288                         padlen=$padlen2
2289                     }
2290                     begin=$(echo $begin | sed 's/0*//')
2291                     [ -z $begin ] && begin=0
2292
2293                     for num in $(seq -f "%0${padlen}g" $begin $end); do
2294                         value="${name#*,}${num}${back}"
2295                         [ "$value" != "${value/\[/}" ] && {
2296                             value=$(hostlist_expand "$value")
2297                         }
2298                         myList="$myList $value"
2299                     done
2300                 done
2301             fi
2302         } else {
2303             myList="$myList $item"
2304         } fi
2305     done
2306     myList=${myList//,/ }
2307     myList=${myList:1} # Remove first character which is a space
2308
2309     # Filter any duplicates without sorting
2310     list="$myList "
2311     myList="${list%% *}"
2312
2313     while [[ "$list" != ${myList##* } ]]; do
2314         list=${list//${list%% *} /}
2315         myList="$myList ${list%% *}"
2316     done
2317     myList="${myList%* }";
2318
2319     # We can select an object at a offset in the list
2320     [ $# -eq 2 ] && {
2321         cnt=0
2322         for item in $myList; do
2323             let cnt=cnt+1
2324             [ $cnt -eq $offset ] && {
2325                 myList=$item
2326             }
2327         done
2328         [ $(get_node_count $myList) -ne 1 ] && myList=""
2329     }
2330     echo $myList
2331 }
2332
2333 facet_host() {
2334         local facet=$1
2335         local varname
2336
2337         [ "$facet" == client ] && echo -n $HOSTNAME && return
2338         varname=${facet}_HOST
2339         if [ -z "${!varname}" ]; then
2340                 if [ "${facet:0:3}" == "ost" ]; then
2341                         eval export ${facet}_HOST=${ost_HOST}
2342                 elif [ "${facet:0:3}" == "mdt" -o \
2343                         "${facet:0:3}" == "mds" -o \
2344                         "${facet:0:3}" == "mgs" ]; then
2345                         eval export ${facet}_HOST=${mds_HOST}
2346                 fi
2347         fi
2348         echo -n ${!varname}
2349 }
2350
2351 facet_failover_host() {
2352         local facet=$1
2353         local varname
2354
2355         var=${facet}failover_HOST
2356         if [ -n "${!var}" ]; then
2357                 echo ${!var}
2358                 return
2359         fi
2360
2361         if [ "${facet:0:3}" == "mdt" -o "${facet:0:3}" == "mds" -o \
2362              "${facet:0:3}" == "mgs" ]; then
2363
2364                 eval export ${facet}failover_host=${mds_HOST}
2365                 echo ${mds_HOST}
2366                 return
2367         fi
2368
2369         if [[ $facet == ost* ]]; then
2370                 eval export ${facet}failover_host=${ost_HOST}
2371                 echo ${ost_HOST}
2372                 return
2373         fi
2374 }
2375
2376 facet_active() {
2377     local facet=$1
2378     local activevar=${facet}active
2379
2380     if [ -f $TMP/${facet}active ] ; then
2381         source $TMP/${facet}active
2382     fi
2383
2384     active=${!activevar}
2385     if [ -z "$active" ] ; then
2386         echo -n ${facet}
2387     else
2388         echo -n ${active}
2389     fi
2390 }
2391
2392 facet_active_host() {
2393     local facet=$1
2394     local active=`facet_active $facet`
2395     if [ "$facet" == client ]; then
2396         echo $HOSTNAME
2397     else
2398         echo `facet_host $active`
2399     fi
2400 }
2401
2402 change_active() {
2403     local facetlist=$1
2404     local facet
2405
2406     facetlist=$(exclude_items_from_list $facetlist mgs)
2407
2408     for facet in ${facetlist//,/ }; do
2409     local failover=${facet}failover
2410     local host=`facet_host $failover`
2411     [ -z "$host" ] && return
2412
2413     local curactive=`facet_active $facet`
2414     if [ -z "${curactive}" -o "$curactive" == "$failover" ] ; then
2415         eval export ${facet}active=$facet
2416     else
2417         eval export ${facet}active=$failover
2418     fi
2419     # save the active host for this facet
2420     local activevar=${facet}active
2421     echo "$activevar=${!activevar}" > $TMP/$activevar
2422     [[ $facet = mds1 ]] && combined_mgs_mds && \
2423         echo "mgsactive=${!activevar}" > $TMP/mgsactive
2424     local TO=`facet_active_host $facet`
2425     echo "Failover $facet to $TO"
2426     done
2427 }
2428
2429 do_node() {
2430     local verbose=false
2431     # do not stripe off hostname if verbose, bug 19215
2432     if [ x$1 = x--verbose ]; then
2433         shift
2434         verbose=true
2435     fi
2436
2437     local HOST=$1
2438     shift
2439     local myPDSH=$PDSH
2440     if [ "$HOST" = "$HOSTNAME" ]; then
2441         myPDSH="no_dsh"
2442     elif [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" ]; then
2443         echo "cannot run remote command on $HOST with $myPDSH"
2444         return 128
2445     fi
2446     if $VERBOSE; then
2447         echo "CMD: $HOST $@" >&2
2448         $myPDSH $HOST "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
2449     fi
2450
2451     if [ "$myPDSH" = "rsh" ]; then
2452 # we need this because rsh does not return exit code of an executed command
2453         local command_status="$TMP/cs"
2454         rsh $HOST ":> $command_status"
2455         rsh $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin;
2456                     cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\") ||
2457                     echo command failed >$command_status"
2458         [ -n "$($myPDSH $HOST cat $command_status)" ] && return 1 || true
2459         return 0
2460     fi
2461
2462     if $verbose ; then
2463         # print HOSTNAME for myPDSH="no_dsh"
2464         if [[ $myPDSH = no_dsh ]]; then
2465             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed -e "s/^/${HOSTNAME}: /"
2466         else
2467             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")"
2468         fi
2469     else
2470         $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed "s/^${HOST}: //"
2471     fi
2472     return ${PIPESTATUS[0]}
2473 }
2474
2475 do_nodev() {
2476     do_node --verbose "$@"
2477 }
2478
2479 single_local_node () {
2480    [ "$1" = "$HOSTNAME" ]
2481 }
2482
2483 # Outputs environment variable assignments that should be passed to remote nodes
2484 get_env_vars() {
2485         local var
2486         local value
2487         local facets=$(get_facets)
2488         local facet
2489
2490         for var in ${!MODOPTS_*}; do
2491                 value=${!var}
2492                 echo -n " ${var}=\"$value\""
2493         done
2494
2495         for facet in ${facets//,/ }; do
2496                 var=${facet}_FSTYPE
2497                 if [ -n "${!var}" ]; then
2498                         echo -n " $var=${!var}"
2499                 fi
2500         done
2501
2502         for var in MGSFSTYPE MDSFSTYPE OSTFSTYPE; do
2503                 if [ -n "${!var}" ]; then
2504                         echo -n " $var=${!var}"
2505                 fi
2506         done
2507
2508         if [ -n "$FSTYPE" ]; then
2509                 echo -n " FSTYPE=$FSTYPE"
2510         fi
2511 }
2512
2513 do_nodes() {
2514     local verbose=false
2515     # do not stripe off hostname if verbose, bug 19215
2516     if [ x$1 = x--verbose ]; then
2517         shift
2518         verbose=true
2519     fi
2520
2521     local rnodes=$1
2522     shift
2523
2524     if single_local_node $rnodes; then
2525         if $verbose; then
2526            do_nodev $rnodes "$@"
2527         else
2528            do_node $rnodes "$@"
2529         fi
2530         return $?
2531     fi
2532
2533     # This is part from do_node
2534     local myPDSH=$PDSH
2535
2536     [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" -o "$myPDSH" = "rsh" ] && \
2537         echo "cannot run remote command on $rnodes with $myPDSH" && return 128
2538
2539     export FANOUT=$(get_node_count "${rnodes//,/ }")
2540     if $VERBOSE; then
2541         echo "CMD: $rnodes $@" >&2
2542         $myPDSH $rnodes "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
2543     fi
2544
2545     # do not replace anything from pdsh output if -N is used
2546     # -N     Disable hostname: prefix on lines of output.
2547     if $verbose || [[ $myPDSH = *-N* ]]; then
2548         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")"
2549     else
2550         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")" | sed -re "s/^[^:]*: //g"
2551     fi
2552     return ${PIPESTATUS[0]}
2553 }
2554
2555 do_facet() {
2556     local facet=$1
2557     shift
2558     local HOST=`facet_active_host $facet`
2559     [ -z $HOST ] && echo No host defined for facet ${facet} && exit 1
2560     do_node $HOST "$@"
2561 }
2562
2563 # Function: do_facet_random_file $FACET $FILE $SIZE
2564 # Creates FILE with random content on the given FACET of given SIZE
2565
2566 do_facet_random_file() {
2567         local facet="$1"
2568         local fpath="$2"
2569         local fsize="$3"
2570         local cmd="dd if=/dev/urandom of='$fpath' bs=$fsize count=1"
2571         do_facet $facet "$cmd 2>/dev/null"
2572 }
2573
2574 do_facet_create_file() {
2575         local facet="$1"
2576         local fpath="$2"
2577         local fsize="$3"
2578         local cmd="dd if=/dev/zero of='$fpath' bs=$fsize count=1"
2579         do_facet $facet "$cmd 2>/dev/null"
2580 }
2581
2582 do_nodesv() {
2583     do_nodes --verbose "$@"
2584 }
2585
2586 add() {
2587     local facet=$1
2588     shift
2589     # make sure its not already running
2590     stop ${facet} -f
2591     rm -f $TMP/${facet}active
2592     [[ $facet = mds1 ]] && combined_mgs_mds && rm -f $TMP/mgsactive
2593     do_facet ${facet} $MKFS $*
2594 }
2595
2596 ostdevname() {
2597     num=$1
2598     DEVNAME=OSTDEV$num
2599
2600         local fstype=$(facet_fstype ost$num)
2601
2602         case $fstype in
2603                 ldiskfs )
2604                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
2605                         eval DEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
2606                 zfs )
2607                         #dataset name is independent of vdev device names
2608                         eval DEVPTR=${FSNAME}-ost${num}/ost${num};;
2609                 * )
2610                         error "unknown fstype!";;
2611         esac
2612
2613     echo -n $DEVPTR
2614 }
2615
2616 ostvdevname() {
2617         num=$1
2618         DEVNAME=OSTDEV$num
2619
2620         local fstype=$(facet_fstype ost$num)
2621
2622         case $fstype in
2623                 ldiskfs )
2624                         # vdevs are not supported by ldiskfs
2625                         eval VDEVPTR="";;
2626                 zfs )
2627                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
2628                         eval VDEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
2629                 * )
2630                         error "unknown fstype!";;
2631         esac
2632
2633         echo -n $VDEVPTR
2634 }
2635
2636 mdsdevname() {
2637     num=$1
2638     DEVNAME=MDSDEV$num
2639
2640         local fstype=$(facet_fstype mds$num)
2641
2642         case $fstype in
2643                 ldiskfs )
2644                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE + num
2645                         eval DEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
2646                 zfs )
2647                         #dataset name is independent of vdev device names
2648                         eval DEVPTR=${FSNAME}-mdt${num}/mdt${num};;
2649                 * )
2650                         error "unknown fstype!";;
2651         esac
2652
2653         echo -n $DEVPTR
2654 }
2655
2656 mdsvdevname() {
2657         num=$1
2658         DEVNAME=MDSDEV$num
2659
2660         local fstype=$(facet_fstype mds$num)
2661
2662         case $fstype in
2663                 ldiskfs )
2664                         # vdevs are not supported by ldiskfs
2665                         eval VDEVPTR="";;
2666                 zfs )
2667                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE + num
2668                         eval VDEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
2669                 * )
2670                         error "unknown fstype!";;
2671         esac
2672
2673         echo -n $VDEVPTR
2674 }
2675
2676 mgsdevname() {
2677         local DEVPTR
2678         local fstype=$(facet_fstype mgs)
2679
2680         case $fstype in
2681         ldiskfs )
2682                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2683                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsdevname 1) ] ); then
2684                         DEVPTR=$(mdsdevname 1)
2685                 else
2686                         DEVPTR=$MGSDEV
2687                 fi;;
2688         zfs )
2689                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2690                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsvdevname 1) ] ); then
2691                         DEVPTR=$(mdsdevname 1)
2692                 else
2693                         DEVPTR=${FSNAME}-mgs/mgs
2694                 fi;;
2695         * )
2696                 error "unknown fstype!";;
2697         esac
2698
2699         echo -n $DEVPTR
2700 }
2701
2702 mgsvdevname() {
2703         local VDEVPTR
2704         DEVNAME=MGSDEV
2705
2706         local fstype=$(facet_fstype mgs)
2707
2708         case $fstype in
2709         ldiskfs )
2710                 # vdevs are not supported by ldiskfs
2711                 ;;
2712         zfs )
2713                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2714                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsvdevname 1) ] ); then
2715                         VDEVPTR=$(mdsvdevname 1)
2716                 else
2717                         VDEVPTR=$MGSDEV
2718                 fi;;
2719         * )
2720                 error "unknown fstype!";;
2721         esac
2722
2723         echo -n $VDEVPTR
2724 }
2725
2726 facet_mntpt () {
2727     local facet=$1
2728     [[ $facet = mgs ]] && combined_mgs_mds && facet="mds1"
2729
2730     local var=${facet}_MOUNT
2731     eval mntpt=${!var:-${MOUNT%/*}/$facet}
2732
2733     echo -n $mntpt
2734 }
2735
2736 ########
2737 ## MountConf setup
2738
2739 stopall() {
2740     # make sure we are using the primary server, so test-framework will
2741     # be able to clean up properly.
2742     activemds=`facet_active mds1`
2743     if [ $activemds != "mds1" ]; then
2744         fail mds1
2745     fi
2746
2747     local clients=$CLIENTS
2748     [ -z $clients ] && clients=$(hostname)
2749
2750     zconf_umount_clients $clients $MOUNT "$*" || true
2751     [ -n "$MOUNT2" ] && zconf_umount_clients $clients $MOUNT2 "$*" || true
2752
2753     [ "$CLIENTONLY" ] && return
2754     # The add fn does rm ${facet}active file, this would be enough
2755     # if we use do_facet <facet> only after the facet added, but
2756     # currently we use do_facet mds in local.sh
2757     for num in `seq $MDSCOUNT`; do
2758         stop mds$num -f
2759         rm -f ${TMP}/mds${num}active
2760     done
2761     combined_mgs_mds && rm -f $TMP/mgsactive
2762
2763     for num in `seq $OSTCOUNT`; do
2764         stop ost$num -f
2765         rm -f $TMP/ost${num}active
2766     done
2767
2768     if ! combined_mgs_mds ; then
2769         stop mgs
2770     fi
2771
2772     return 0
2773 }
2774
2775 cleanup_echo_devs () {
2776     local devs=$($LCTL dl | grep echo | awk '{print $4}')
2777
2778     for dev in $devs; do
2779         $LCTL --device $dev cleanup
2780         $LCTL --device $dev detach
2781     done
2782 }
2783
2784 cleanupall() {
2785     nfs_client_mode && return
2786
2787     stopall $*
2788     cleanup_echo_devs
2789
2790     unload_modules
2791     cleanup_gss
2792 }
2793
2794 combined_mgs_mds () {
2795         [[ "$(mdsdevname 1)" = "$(mgsdevname)" ]] &&
2796                 [[ "$(facet_host mds1)" = "$(facet_host mgs)" ]]
2797 }
2798
2799 lower() {
2800         echo -n "$1" | tr '[:upper:]' '[:lower:]'
2801 }
2802
2803 upper() {
2804         echo -n "$1" | tr '[:lower:]' '[:upper:]'
2805 }
2806
2807 mkfs_opts() {
2808         local facet=$1
2809         local dev=$2
2810         local fsname=${3:-"$FSNAME"}
2811         local type=$(facet_type $facet)
2812         local index=$(($(facet_number $facet) - 1))
2813         local fstype=$(facet_fstype $facet)
2814         local host=$(facet_host $facet)
2815         local opts
2816         local fs_mkfs_opts
2817         local var
2818
2819         if [ $type == MGS ] && combined_mgs_mds; then
2820                 return 1
2821         fi
2822
2823         if [ $type == MGS ] || ( [ $type == MDS ] &&
2824                                  [ "$dev" == $(mgsdevname) ] &&
2825                                  [ "$host" == "$(facet_host mgs)" ] ); then
2826                 opts="--mgs"
2827         else
2828                 opts="--mgsnode=$MGSNID"
2829         fi
2830
2831         if [ $type != MGS ]; then
2832                 opts+=" --fsname=$fsname --$(lower ${type/MDS/MDT}) \
2833                         --index=$index"
2834         fi
2835
2836         var=${facet}failover_HOST
2837         if [ -n "${!var}" ] && [ ${!var} != $(facet_host $facet) ]; then
2838                 opts+=" --failnode=$(h2$NETTYPE ${!var})"
2839         fi
2840
2841         opts+=${TIMEOUT:+" --param=sys.timeout=$TIMEOUT"}
2842         opts+=${LDLM_TIMEOUT:+" --param=sys.ldlm_timeout=$LDLM_TIMEOUT"}
2843
2844         if [ $type == MDS ]; then
2845                 opts+=${SECLEVEL:+" --param=mdt.sec_level"}
2846                 opts+=${MDSCAPA:+" --param-mdt.capa=$MDSCAPA"}
2847                 opts+=${STRIPE_BYTES:+" --param=lov.stripesize=$STRIPE_BYTES"}
2848                 opts+=${STRIPES_PER_OBJ:+" --param=lov.stripecount=$STRIPES_PER_OBJ"}
2849                 opts+=${L_GETIDENTITY:+" --param=mdt.identity_upcall=$L_GETIDENTITY"}
2850
2851                 if [ $fstype == ldiskfs ]; then
2852                         fs_mkfs_opts+=${MDSJOURNALSIZE:+" -J size=$MDSJOURNALSIZE"}
2853                         fs_mkfs_opts+=${MDSISIZE:+" -i $MDSISIZE"}
2854                 fi
2855         fi
2856
2857         if [ $type == OST ]; then
2858                 opts+=${SECLEVEL:+" --param=ost.sec_level"}
2859                 opts+=${OSSCAPA:+" --param=ost.capa=$OSSCAPA"}
2860
2861                 if [ $fstype == ldiskfs ]; then
2862                         fs_mkfs_opts+=${OSTJOURNALSIZE:+" -J size=$OSTJOURNALSIZE"}
2863                 fi
2864         fi
2865
2866         opts+=" --backfstype=$fstype"
2867
2868         var=${type}SIZE
2869         if [ -n "${!var}" ]; then
2870                 opts+=" --device-size=${!var}"
2871         fi
2872
2873         var=$(upper $fstype)_MKFS_OPTS
2874         fs_mkfs_opts+=${!var:+" ${!var}"}
2875
2876         var=${type}_FS_MKFS_OPTS
2877         fs_mkfs_opts+=${!var:+" ${!var}"}
2878
2879         if [ -n "${fs_mkfs_opts## }" ]; then
2880                 opts+=" --mkfsoptions=\\\"${fs_mkfs_opts## }\\\""
2881         fi
2882
2883         var=${type}OPT
2884         opts+=${!var:+" ${!var}"}
2885
2886         echo -n "$opts"
2887 }
2888
2889 formatall() {
2890         local quiet
2891
2892         if ! $VERBOSE; then
2893                 quiet=yes
2894         fi
2895
2896         stopall
2897         # We need ldiskfs here, may as well load them all
2898         load_modules
2899         [ "$CLIENTONLY" ] && return
2900         echo Formatting mgs, mds, osts
2901         if ! combined_mgs_mds ; then
2902                 echo "Format mgs: $(mgsdevname)"
2903                 add mgs $(mkfs_opts mgs $(mgsdevname)) --reformat \
2904                         $(mgsdevname) $(mgsvdevname) ${quiet:+>/dev/null} ||
2905                         exit 10
2906         fi
2907
2908         for num in $(seq $MDSCOUNT); do
2909                 echo "Format mds$num: $(mdsdevname $num)"
2910                 add mds$num $(mkfs_opts mds$num $(mdsdevname ${num})) \
2911                         --reformat $(mdsdevname $num) $(mdsvdevname $num) \
2912                         ${quiet:+>/dev/null} || exit 10
2913         done
2914
2915         for num in $(seq $OSTCOUNT); do
2916                 echo "Format ost$num: $(ostdevname $num)"
2917                 add ost$num $(mkfs_opts ost$num $(ostdevname ${num})) \
2918                         --reformat $(ostdevname $num) $(ostvdevname ${num}) \
2919                         ${quiet:+>/dev/null} || exit 10
2920         done
2921 }
2922
2923 mount_client() {
2924     grep " $1 " /proc/mounts || zconf_mount $HOSTNAME $*
2925 }
2926
2927 umount_client() {
2928     grep " $1 " /proc/mounts && zconf_umount `hostname` $*
2929 }
2930
2931 # return value:
2932 # 0: success, the old identity set already.
2933 # 1: success, the old identity does not set.
2934 # 2: fail.
2935 switch_identity() {
2936     local num=$1
2937     local switch=$2
2938     local j=`expr $num - 1`
2939     local MDT="`(do_facet mds$num lctl get_param -N mdt.*MDT*$j 2>/dev/null | cut -d"." -f2 2>/dev/null) || true`"
2940
2941     if [ -z "$MDT" ]; then
2942         return 2
2943     fi
2944
2945     local old="`do_facet mds$num "lctl get_param -n mdt.$MDT.identity_upcall"`"
2946
2947     if $switch; then
2948         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"$L_GETIDENTITY\""
2949     else
2950         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"NONE\""
2951     fi
2952
2953     do_facet mds$num "lctl set_param -n mdt/$MDT/identity_flush=-1"
2954
2955     if [ $old = "NONE" ]; then
2956         return 1
2957     else
2958         return 0
2959     fi
2960 }
2961
2962 remount_client()
2963 {
2964         zconf_umount `hostname` $1 || error "umount failed"
2965         zconf_mount `hostname` $1 || error "mount failed"
2966 }
2967
2968 writeconf_facet() {
2969         local facet=$1
2970         local dev=$2
2971
2972         stop ${facet} -f
2973         rm -f ${facet}active
2974         do_facet ${facet} "$TUNEFS --quiet --writeconf $dev" || return 1
2975         return 0
2976 }
2977
2978 writeconf_all () {
2979         local mdt_count=${1:-$MDSCOUNT}
2980         local ost_count=${2:-$OSTCOUNT}
2981         local rc=0
2982
2983         for num in $(seq $mdt_count); do
2984                 DEVNAME=$(mdsdevname $num)
2985                 writeconf_facet mds$num $DEVNAME || rc=$?
2986         done
2987
2988         for num in $(seq $ost_count); do
2989                 DEVNAME=$(ostdevname $num)
2990                 writeconf_facet ost$num $DEVNAME || rc=$?
2991         done
2992         return $rc
2993 }
2994
2995 setupall() {
2996     nfs_client_mode && return
2997
2998     sanity_mount_check ||
2999         error "environments are insane!"
3000
3001     load_modules
3002
3003     if [ -z "$CLIENTONLY" ]; then
3004         echo Setup mgs, mdt, osts
3005         echo $WRITECONF | grep -q "writeconf" && \
3006             writeconf_all
3007         if ! combined_mgs_mds ; then
3008                         start mgs $(mgsdevname) $MGS_MOUNT_OPTS
3009         fi
3010
3011         for num in `seq $MDSCOUNT`; do
3012             DEVNAME=$(mdsdevname $num)
3013             start mds$num $DEVNAME $MDS_MOUNT_OPTS
3014
3015             # We started mds, now we should set failover variables properly.
3016             # Set mds${num}failover_HOST if it is not set (the default failnode).
3017             local varname=mds${num}failover_HOST
3018             if [ -z "${!varname}" ]; then
3019                 eval mds${num}failover_HOST=$(facet_host mds$num)
3020             fi
3021
3022             if [ $IDENTITY_UPCALL != "default" ]; then
3023                 switch_identity $num $IDENTITY_UPCALL
3024             fi
3025         done
3026         for num in `seq $OSTCOUNT`; do
3027             DEVNAME=$(ostdevname $num)
3028             start ost$num $DEVNAME $OST_MOUNT_OPTS
3029
3030             # We started ost$num, now we should set ost${num}failover variable properly.
3031             # Set ost${num}failover_HOST if it is not set (the default failnode).
3032             varname=ost${num}failover_HOST
3033             if [ -z "${!varname}" ]; then
3034                 eval ost${num}failover_HOST=$(facet_host ost${num})
3035             fi
3036
3037         done
3038     fi
3039
3040     init_gss
3041
3042     # wait a while to allow sptlrpc configuration be propogated to targets,
3043     # only needed when mounting new target devices.
3044     if $GSS; then
3045         sleep 10
3046     fi
3047
3048     [ "$DAEMONFILE" ] && $LCTL debug_daemon start $DAEMONFILE $DAEMONSIZE
3049     mount_client $MOUNT
3050     [ -n "$CLIENTS" ] && zconf_mount_clients $CLIENTS $MOUNT
3051     clients_up
3052
3053     if [ "$MOUNT_2" ]; then
3054         mount_client $MOUNT2
3055         [ -n "$CLIENTS" ] && zconf_mount_clients $CLIENTS $MOUNT2
3056     fi
3057
3058     init_param_vars
3059
3060     # by remounting mdt before ost, initial connect from mdt to ost might
3061     # timeout because ost is not ready yet. wait some time to its fully
3062     # recovery. initial obd_connect timeout is 5s; in GSS case it's preceeded
3063     # by a context negotiation rpc with $TIMEOUT.
3064     # FIXME better by monitoring import status.
3065     if $GSS; then
3066         set_flavor_all $SEC
3067         sleep $((TIMEOUT + 5))
3068     else
3069         sleep 5
3070     fi
3071 }
3072
3073 mounted_lustre_filesystems() {
3074         awk '($3 ~ "lustre" && $1 ~ ":") { print $2 }' /proc/mounts
3075 }
3076
3077 init_facet_vars () {
3078         [ "$CLIENTONLY" ] && return 0
3079         local facet=$1
3080         shift
3081         local device=$1
3082
3083         shift
3084
3085         eval export ${facet}_dev=${device}
3086         eval export ${facet}_opt=\"$@\"
3087
3088         local dev=${facet}_dev
3089
3090         # We need to loop for the label
3091         # in case its not initialized yet.
3092         for wait_time in {0,1,3,5,10}; do
3093
3094                 if [ $wait_time -gt 0 ]; then
3095                         echo "${!dev} not yet initialized,"\
3096                                 "waiting ${wait_time} seconds."
3097                         sleep $wait_time
3098                 fi
3099
3100                 local label=$(devicelabel ${facet} ${!dev})
3101
3102                 # Check to make sure the label does
3103                 # not include ffff at the end of the label.
3104                 # This indicates it has not been initialized yet.
3105
3106                 if [[ $label =~ [f|F]{4}$ ]]; then
3107                         # label is not initialized, unset the result
3108                         # and either try again or fail
3109                         unset label
3110                 else
3111                         break
3112                 fi
3113         done
3114
3115         [ -z "$label" ] && echo no label for ${!dev} && exit 1
3116
3117         eval export ${facet}_svc=${label}
3118
3119         local varname=${facet}failover_HOST
3120         if [ -z "${!varname}" ]; then
3121                 eval export $varname=$(facet_host $facet)
3122         fi
3123
3124         varname=${facet}_HOST
3125         if [ -z "${!varname}" ]; then
3126                 eval export $varname=$(facet_host $facet)
3127         fi
3128
3129         # ${facet}failover_dev is set in cfg file
3130         varname=${facet}failover_dev
3131         if [ -n "${!varname}" ] ; then
3132                 eval export ${facet}failover_dev=${!varname}
3133         else
3134                 eval export ${facet}failover_dev=$device
3135         fi
3136
3137         # get mount point of already mounted device
3138         # is facet_dev is already mounted then use the real
3139         #  mount point of this facet; otherwise use $(facet_mntpt $facet)
3140         # i.e. ${facet}_MOUNT if specified by user or default
3141         local mntpt=$(do_facet ${facet} cat /proc/mounts | \
3142                         awk '"'${!dev}'" == $1 && $3 == "lustre" { print $2 }')
3143         if [ -z $mntpt ]; then
3144                 mntpt=$(facet_mntpt $facet)
3145         fi
3146         eval export ${facet}_MOUNT=$mntpt
3147 }
3148
3149 init_facets_vars () {
3150         local DEVNAME
3151
3152         if ! remote_mds_nodsh; then
3153                 for num in $(seq $MDSCOUNT); do
3154                         DEVNAME=`mdsdevname $num`
3155                         eval export MDSDEV${num}=$DEVNAME
3156                         init_facet_vars mds$num $DEVNAME $MDS_MOUNT_OPTS
3157                 done
3158         fi
3159
3160         eval export MGSDEV=$(mgsdevname)
3161         combined_mgs_mds || init_facet_vars mgs $(mgsdevname) $MGS_MOUNT_OPTS
3162
3163         if ! remote_ost_nodsh; then
3164                 for num in $(seq $OSTCOUNT); do
3165                         DEVNAME=$(ostdevname $num)
3166                         eval export OSTDEV${num}=$DEVNAME
3167                         init_facet_vars ost$num $DEVNAME $OST_MOUNT_OPTS
3168                 done
3169         fi
3170 }
3171
3172 osc_ensure_active () {
3173     local facet=$1
3174     local timeout=$2
3175     local period=0
3176
3177     while [ $period -lt $timeout ]; do
3178         count=$(do_facet $facet "lctl dl | grep ' IN osc ' 2>/dev/null | wc -l")
3179         if [ $count -eq 0 ]; then
3180             break
3181         fi
3182
3183         echo "There are $count OST are inactive, wait $period seconds, and try again"
3184         sleep 3
3185         period=$((period+3))
3186     done
3187
3188     [ $period -lt $timeout ] || log "$count OST are inactive after $timeout seconds, give up"
3189 }
3190
3191 set_conf_param_and_check() {
3192         local myfacet=$1
3193         local TEST=$2
3194         local PARAM=$3
3195         local ORIG=$(do_facet $myfacet "$TEST")
3196         if [ $# -gt 3 ]; then
3197                 local FINAL=$4
3198         else
3199                 local -i FINAL
3200                 FINAL=$((ORIG + 5))
3201         fi
3202         echo "Setting $PARAM from $ORIG to $FINAL"
3203         do_facet mgs "$LCTL conf_param $PARAM='$FINAL'" ||
3204                 error "conf_param $PARAM failed"
3205
3206         wait_update $(facet_host $myfacet) "$TEST" "$FINAL" ||
3207                 error "check $PARAM failed!"
3208 }
3209
3210 init_param_vars () {
3211         remote_mds_nodsh ||
3212                 TIMEOUT=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
3213
3214         log "Using TIMEOUT=$TIMEOUT"
3215
3216         osc_ensure_active $SINGLEMDS $TIMEOUT
3217         osc_ensure_active client $TIMEOUT
3218
3219         local jobid_var
3220         if [ -z "$(lctl get_param -n mdc.*.connect_flags | grep jobstats)" ]; then
3221                 jobid_var="none"
3222         elif [ $JOBSTATS_AUTO -ne 0 ]; then
3223                 echo "enable jobstats, set job scheduler as $JOBID_VAR"
3224                 jobid_var=$JOBID_VAR
3225         else
3226                 jobid_var=`$LCTL get_param -n jobid_var`
3227                 if [ $jobid_var != "disable" ]; then
3228                         echo "disable jobstats as required"
3229                         jobid_var="disable"
3230                 else
3231                         jobid_var="none"
3232                 fi
3233         fi
3234
3235         if [ $jobid_var == $JOBID_VAR -o $jobid_var == "disable" ]; then
3236                 do_facet mgs $LCTL conf_param $FSNAME.sys.jobid_var=$jobid_var
3237                 wait_update $HOSTNAME "$LCTL get_param -n jobid_var" \
3238                         $jobid_var || return 1
3239         fi
3240
3241         if [ $QUOTA_AUTO -ne 0 ]; then
3242                 if [ "$ENABLE_QUOTA" ]; then
3243                         echo "enable quota as required"
3244                         setup_quota $MOUNT || return 2
3245                 else
3246                         echo "disable quota as required"
3247                         # $LFS quotaoff -ug $MOUNT > /dev/null 2>&1
3248                 fi
3249         fi
3250         return 0
3251 }
3252
3253 nfs_client_mode () {
3254     if [ "$NFSCLIENT" ]; then
3255         echo "NFSCLIENT mode: setup, cleanup, check config skipped"
3256         local clients=$CLIENTS
3257         [ -z $clients ] && clients=$(hostname)
3258
3259         # FIXME: remove hostname when 19215 fixed
3260         do_nodes $clients "echo \\\$(hostname); grep ' '$MOUNT' ' /proc/mounts"
3261         declare -a nfsexport=(`grep ' '$MOUNT' ' /proc/mounts | awk '{print $1}' | awk -F: '{print $1 " "  $2}'`)
3262         if [[ ${#nfsexport[@]} -eq 0 ]]; then
3263                 error_exit NFSCLIENT=$NFSCLIENT mode, but no NFS export found!
3264         fi
3265         do_nodes ${nfsexport[0]} "echo \\\$(hostname); df -T  ${nfsexport[1]}"
3266         return
3267     fi
3268     return 1
3269 }
3270
3271 check_config_client () {
3272     local mntpt=$1
3273
3274     local mounted=$(mount | grep " $mntpt ")
3275     if [ "$CLIENTONLY" ]; then
3276         # bug 18021
3277         # CLIENTONLY should not depend on *_HOST settings
3278         local mgc=$($LCTL device_list | awk '/MGC/ {print $4}')
3279         # in theory someone could create a new,
3280         # client-only config file that assumed lustre was already
3281         # configured and didn't set the MGSNID. If MGSNID is not set,
3282         # then we should use the mgs nid currently being used 
3283         # as the default value. bug 18021
3284         [[ x$MGSNID = x ]] &&
3285             MGSNID=${mgc//MGC/}
3286
3287         if [[ x$mgc != xMGC$MGSNID ]]; then
3288             if [ "$mgs_HOST" ]; then
3289                 local mgc_ip=$(ping -q -c1 -w1 $mgs_HOST | grep PING | awk '{print $3}' | sed -e "s/(//g" -e "s/)//g")
3290 #                [[ x$mgc = xMGC$mgc_ip@$NETTYPE ]] ||
3291 #                    error_exit "MGSNID=$MGSNID, mounted: $mounted, MGC : $mgc"
3292             fi
3293         fi
3294         return 0
3295     fi
3296
3297     local myMGS_host=$mgs_HOST   
3298     if [ "$NETTYPE" = "ptl" ]; then
3299         myMGS_host=$(h2ptl $mgs_HOST | sed -e s/@ptl//) 
3300     fi
3301
3302     echo Checking config lustre mounted on $mntpt
3303     local mgshost=$(mount | grep " $mntpt " | awk -F@ '{print $1}')
3304     mgshost=$(echo $mgshost | awk -F: '{print $1}')
3305
3306 #    if [ "$mgshost" != "$myMGS_host" ]; then
3307 #            log "Bad config file: lustre is mounted with mgs $mgshost, but mgs_HOST=$mgs_HOST, NETTYPE=$NETTYPE
3308 #                   Please use correct config or set mds_HOST correctly!"
3309 #    fi
3310
3311 }
3312
3313 check_config_clients () {
3314         local clients=${CLIENTS:-$HOSTNAME}
3315         local mntpt=$1
3316
3317         nfs_client_mode && return
3318
3319         do_rpc_nodes "$clients" check_config_client $mntpt
3320
3321         sanity_mount_check || error "environments are insane!"
3322 }
3323
3324 check_timeout () {
3325     local mdstimeout=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
3326     local cltimeout=$(lctl get_param -n timeout)
3327     if [ $mdstimeout -ne $TIMEOUT ] || [ $mdstimeout -ne $cltimeout ]; then
3328         error "timeouts are wrong! mds: $mdstimeout, client: $cltimeout, TIMEOUT=$TIMEOUT"
3329         return 1
3330     fi
3331 }
3332
3333 is_mounted () {
3334     local mntpt=$1
3335     [ -z $mntpt ] && return 1
3336     local mounted=$(mounted_lustre_filesystems)
3337
3338     echo $mounted' ' | grep -w -q $mntpt' '
3339 }
3340
3341 is_empty_dir() {
3342     [ $(find $1 -maxdepth 1 -print | wc -l) = 1 ] && return 0
3343     return 1
3344 }
3345
3346 # empty lustre filesystem may have empty directories lost+found and .lustre
3347 is_empty_fs() {
3348     [ $(find $1 -maxdepth 1 -name lost+found -o -name .lustre -prune -o \
3349        -print | wc -l) = 1 ] || return 1
3350     [ ! -d $1/lost+found ] || is_empty_dir $1/lost+found && return 0
3351     [ ! -d $1/.lustre ] || is_empty_dir $1/.lustre && return 0
3352     return 1
3353 }
3354
3355 check_and_setup_lustre() {
3356     nfs_client_mode && return
3357
3358     local MOUNTED=$(mounted_lustre_filesystems)
3359
3360     local do_check=true
3361     # 1.
3362     # both MOUNT and MOUNT2 are not mounted
3363     if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
3364         [ "$REFORMAT" ] && formatall
3365         # setupall mounts both MOUNT and MOUNT2 (if MOUNT_2 is set)
3366         setupall
3367         is_mounted $MOUNT || error "NAME=$NAME not mounted"
3368         export I_MOUNTED=yes
3369         do_check=false
3370     # 2.
3371     # MOUNT2 is mounted
3372     elif is_mounted $MOUNT2; then
3373             # 3.
3374             # MOUNT2 is mounted, while MOUNT_2 is not set
3375             if ! [ "$MOUNT_2" ]; then
3376                 cleanup_mount $MOUNT2
3377                 export I_UMOUNTED2=yes
3378
3379             # 4.
3380             # MOUNT2 is mounted, MOUNT_2 is set
3381             else
3382                 # FIXME: what to do if check_config failed?
3383                 # i.e. if:
3384                 # 1) remote client has mounted other Lustre fs ?
3385                 # 2) it has insane env ?
3386                 # let's try umount MOUNT2 on all clients and mount it again:
3387                 if ! check_config_clients $MOUNT2; then
3388                     cleanup_mount $MOUNT2
3389                     restore_mount $MOUNT2
3390                     export I_MOUNTED2=yes
3391                 fi
3392             fi 
3393
3394     # 5.
3395     # MOUNT is mounted MOUNT2 is not mounted
3396     elif [ "$MOUNT_2" ]; then
3397         restore_mount $MOUNT2
3398         export I_MOUNTED2=yes
3399     fi
3400
3401     if $do_check; then
3402         # FIXME: what to do if check_config failed?
3403         # i.e. if:
3404         # 1) remote client has mounted other Lustre fs?
3405         # 2) lustre is mounted on remote_clients atall ?
3406         check_config_clients $MOUNT
3407         init_facets_vars
3408         init_param_vars
3409
3410         set_default_debug_nodes $(comma_list $(nodes_list))
3411     fi
3412
3413         init_gss
3414         if $GSS; then
3415                 set_flavor_all $SEC
3416         fi
3417
3418         if [ "$ONLY" == "setup" ]; then
3419                 exit 0
3420         fi
3421 }
3422
3423 restore_mount () {
3424    local clients=${CLIENTS:-$HOSTNAME}
3425    local mntpt=$1
3426
3427    zconf_mount_clients $clients $mntpt
3428 }
3429
3430 cleanup_mount () {
3431     local clients=${CLIENTS:-$HOSTNAME}
3432     local mntpt=$1
3433
3434     zconf_umount_clients $clients $mntpt    
3435 }
3436
3437 cleanup_and_setup_lustre() {
3438     if [ "$ONLY" == "cleanup" -o "`mount | grep $MOUNT`" ]; then
3439         lctl set_param debug=0 || true
3440         cleanupall
3441         if [ "$ONLY" == "cleanup" ]; then
3442             exit 0
3443         fi
3444     fi
3445     check_and_setup_lustre
3446 }
3447
3448 # Get all of the server target devices from a given server node and type.
3449 get_mnt_devs() {
3450         local node=$1
3451         local type=$2
3452         local devs
3453         local dev
3454
3455         if [ "$type" == ost ]; then
3456                 devs=$(get_osd_param $node "" mntdev)
3457         else
3458                 devs=$(do_node $node \
3459                        "lctl get_param -n osd-*.$FSNAME-M*.mntdev")
3460         fi
3461         for dev in $devs; do
3462                 case $dev in
3463                 *loop*) do_node $node "losetup $dev" | \
3464                                 sed -e "s/.*(//" -e "s/).*//" ;;
3465                 *) echo $dev ;;
3466                 esac
3467         done
3468 }
3469
3470 # Get all of the server target devices.
3471 get_svr_devs() {
3472     local i
3473
3474     # MDT device
3475     MDTDEV=$(get_mnt_devs $(mdts_nodes) mdt)
3476
3477     # OST devices
3478     i=0
3479     for node in $(osts_nodes); do
3480         OSTDEVS[i]=$(get_mnt_devs $node ost)
3481         i=$((i + 1))
3482     done
3483 }
3484
3485 # Run e2fsck on MDT or OST device.
3486 run_e2fsck() {
3487     local node=$1
3488     local target_dev=$2
3489     local extra_opts=$3
3490
3491     df > /dev/null      # update statfs data on disk
3492     local cmd="$E2FSCK -d -v -t -t -f $extra_opts $target_dev"
3493     echo $cmd
3494     local rc=0
3495     do_node $node $cmd || rc=$?
3496     [ $rc -le $FSCK_MAX_ERR ] || \
3497         error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
3498     return 0
3499 }
3500
3501 # verify a directory is shared among nodes.
3502 check_shared_dir() {
3503         local dir=$1
3504
3505         [ -z "$dir" ] && return 1
3506         do_rpc_nodes "$(comma_list $(nodes_list))" check_logdir $dir
3507         check_write_access $dir || return 1
3508         return 0
3509 }
3510
3511 # Run e2fsck on MDT and OST(s) to generate databases used for lfsck.
3512 generate_db() {
3513     local i
3514     local ostidx
3515     local dev
3516
3517         [[ $(lustre_version_code $SINGLEMDS) -ne $(version_code 2.2.0) ]] ||
3518                 { skip "Lustre 2.2.0 lacks the patch for LU-1255"; exit 0; }
3519
3520     check_shared_dir $SHARED_DIRECTORY ||
3521         error "$SHARED_DIRECTORY isn't a shared directory"
3522
3523     export MDSDB=$SHARED_DIRECTORY/mdsdb
3524     export OSTDB=$SHARED_DIRECTORY/ostdb
3525
3526     [ $MDSCOUNT -eq 1 ] || error "CMD is not supported"
3527
3528     run_e2fsck $(mdts_nodes) $MDTDEV "-n --mdsdb $MDSDB"
3529
3530     i=0
3531     ostidx=0
3532     OSTDB_LIST=""
3533     for node in $(osts_nodes); do
3534         for dev in ${OSTDEVS[i]}; do
3535             run_e2fsck $node $dev "-n --mdsdb $MDSDB --ostdb $OSTDB-$ostidx"
3536             OSTDB_LIST="$OSTDB_LIST $OSTDB-$ostidx"
3537             ostidx=$((ostidx + 1))
3538         done
3539         i=$((i + 1))
3540     done
3541 }
3542
3543 run_lfsck() {
3544     local cmd="$LFSCK_BIN -c -l --mdsdb $MDSDB --ostdb $OSTDB_LIST $MOUNT"
3545     echo $cmd
3546     local rc=0
3547     eval $cmd || rc=$?
3548     [ $rc -le $FSCK_MAX_ERR ] || \
3549         error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
3550     echo "lfsck finished with rc=$rc"
3551
3552     rm -rvf $MDSDB* $OSTDB* || true
3553     return 0
3554 }
3555
3556 check_and_cleanup_lustre() {
3557     if [ "$LFSCK_ALWAYS" = "yes" -a "$TESTSUITE" != "lfsck" ]; then
3558         get_svr_devs
3559         generate_db
3560         run_lfsck
3561     fi
3562
3563         if is_mounted $MOUNT; then
3564                 [ -n "$DIR" ] && rm -rf $DIR/[Rdfs][0-9]* ||
3565                         error "remove sub-test dirs failed"
3566                 [ "$ENABLE_QUOTA" ] && restore_quota || true
3567         fi
3568
3569     if [ "$I_UMOUNTED2" = "yes" ]; then
3570         restore_mount $MOUNT2 || error "restore $MOUNT2 failed"
3571     fi
3572
3573     if [ "$I_MOUNTED2" = "yes" ]; then
3574         cleanup_mount $MOUNT2
3575     fi
3576
3577     if [ "$I_MOUNTED" = "yes" ]; then
3578         cleanupall -f || error "cleanup failed"
3579         unset I_MOUNTED
3580     fi
3581 }
3582
3583 #######
3584 # General functions
3585
3586 wait_for_function () {
3587     local quiet=""
3588
3589     # suppress fn both stderr and stdout
3590     if [ "$1" = "--quiet" ]; then
3591         shift
3592         quiet=" > /dev/null 2>&1"
3593
3594     fi
3595
3596     local fn=$1
3597     local max=${2:-900}
3598     local sleep=${3:-5}
3599
3600     local wait=0
3601
3602     while true; do
3603
3604         eval $fn $quiet && return 0
3605
3606         wait=$((wait + sleep))
3607         [ $wait -lt $max ] || return 1
3608         echo waiting $fn, $((max - wait)) secs left ...
3609         sleep $sleep
3610     done
3611 }
3612
3613 check_network() {
3614     local host=$1
3615     local max=$2
3616     local sleep=${3:-5}
3617
3618     echo `date +"%H:%M:%S (%s)"` waiting for $host network $max secs ...
3619     if ! wait_for_function --quiet "ping -c 1 -w 3 $host" $max $sleep ; then
3620         echo "Network not available!"
3621         exit 1
3622     fi
3623
3624     echo `date +"%H:%M:%S (%s)"` network interface is UP
3625 }
3626
3627 no_dsh() {
3628     shift
3629     eval $@
3630 }
3631
3632 # Convert a space-delimited list to a comma-delimited list.  If the input is
3633 # only whitespace, ensure the output is empty (i.e. "") so [ -n $list ] works
3634 comma_list() {
3635         # echo is used to convert newlines to spaces, since it doesn't
3636         # introduce a trailing space as using "tr '\n' ' '" does
3637         echo $(tr -s " " "\n" <<< $* | sort -b -u) | tr ' ' ','
3638 }
3639
3640 list_member () {
3641     local list=$1
3642     local item=$2
3643     echo $list | grep -qw $item
3644 }
3645
3646 # list, excluded are the comma separated lists
3647 exclude_items_from_list () {
3648     local list=$1
3649     local excluded=$2
3650     local item
3651
3652     list=${list//,/ }
3653     for item in ${excluded//,/ }; do
3654         list=$(echo " $list " | sed -re "s/\s+$item\s+/ /g")
3655     done
3656     echo $(comma_list $list)
3657 }
3658
3659 # list, expand  are the comma separated lists
3660 expand_list () {
3661     local list=${1//,/ }
3662     local expand=${2//,/ }
3663     local expanded=
3664
3665     expanded=$(for i in $list $expand; do echo $i; done | sort -u)
3666     echo $(comma_list $expanded)
3667 }
3668
3669 testslist_filter () {
3670     local script=$LUSTRE/tests/${TESTSUITE}.sh
3671
3672     [ -f $script ] || return 0
3673
3674     local start_at=$START_AT
3675     local stop_at=$STOP_AT
3676
3677     local var=${TESTSUITE//-/_}_START_AT
3678     [ x"${!var}" != x ] && start_at=${!var}
3679     var=${TESTSUITE//-/_}_STOP_AT
3680     [ x"${!var}" != x ] && stop_at=${!var}
3681
3682     sed -n 's/^test_\([^ (]*\).*/\1/p' $script | \
3683         awk ' BEGIN { if ("'${start_at:-0}'" != 0) flag = 1 }
3684             /^'${start_at}'$/ {flag = 0}
3685             {if (flag == 1) print $0}
3686             /^'${stop_at}'$/ { flag = 1 }'
3687 }
3688
3689 absolute_path() {
3690     (cd `dirname $1`; echo $PWD/`basename $1`)
3691 }
3692
3693 get_facets () {
3694     local types=${1:-"OST MDS MGS"}
3695
3696     local list=""
3697
3698     for entry in $types; do
3699         local name=$(echo $entry | tr "[:upper:]" "[:lower:]")
3700         local type=$(echo $entry | tr "[:lower:]" "[:upper:]")
3701
3702         case $type in
3703                 MGS ) list="$list $name";;
3704             MDS|OST ) local count=${type}COUNT
3705                        for ((i=1; i<=${!count}; i++)) do
3706                           list="$list ${name}$i"
3707                       done;;
3708                   * ) error "Invalid facet type"
3709                  exit 1;;
3710         esac
3711     done
3712     echo $(comma_list $list)
3713 }
3714
3715 ##################################
3716 # Adaptive Timeouts funcs
3717
3718 at_is_enabled() {
3719     # only check mds, we assume at_max is the same on all nodes
3720     local at_max=$(do_facet $SINGLEMDS "lctl get_param -n at_max")
3721     if [ $at_max -eq 0 ]; then
3722         return 1
3723     else
3724         return 0
3725     fi
3726 }
3727
3728 at_get() {
3729     local facet=$1
3730     local at=$2
3731
3732     # suppose that all ost-s have the same $at value set
3733     [ $facet != "ost" ] || facet=ost1
3734
3735     do_facet $facet "lctl get_param -n $at"
3736 }
3737
3738 at_max_get() {
3739     at_get $1 at_max
3740 }
3741
3742 at_min_get() {
3743         at_get $1 at_min
3744 }
3745
3746 at_max_set() {
3747     local at_max=$1
3748     shift
3749
3750     local facet
3751     local hosts
3752     for facet in $@; do
3753         if [ $facet == "ost" ]; then
3754             facet=$(get_facets OST)
3755         elif [ $facet == "mds" ]; then
3756             facet=$(get_facets MDS)
3757         fi
3758         hosts=$(expand_list $hosts $(facets_hosts $facet))
3759     done
3760
3761     do_nodes $hosts lctl set_param at_max=$at_max
3762 }
3763
3764 ##################################
3765 # OBD_FAIL funcs
3766
3767 drop_request() {
3768 # OBD_FAIL_MDS_ALL_REQUEST_NET
3769     RC=0
3770     do_facet $SINGLEMDS lctl set_param fail_loc=0x123
3771     do_facet client "$1" || RC=$?
3772     do_facet $SINGLEMDS lctl set_param fail_loc=0
3773     return $RC
3774 }
3775
3776 drop_reply() {
3777 # OBD_FAIL_MDS_ALL_REPLY_NET
3778     RC=0
3779     do_facet $SINGLEMDS lctl set_param fail_loc=0x122
3780     do_facet client "$@" || RC=$?
3781     do_facet $SINGLEMDS lctl set_param fail_loc=0
3782     return $RC
3783 }
3784
3785 drop_reint_reply() {
3786 # OBD_FAIL_MDS_REINT_NET_REP
3787     RC=0
3788     do_facet $SINGLEMDS lctl set_param fail_loc=0x119
3789     do_facet client "$@" || RC=$?
3790     do_facet $SINGLEMDS lctl set_param fail_loc=0
3791     return $RC
3792 }
3793
3794 drop_update_reply() {
3795 # OBD_FAIL_MDS_OBJ_UPDATE_NET
3796         local index=$1
3797         shift 1
3798         RC=0
3799         do_facet mds${index} lctl set_param fail_loc=0x188
3800         do_facet client "$@" || RC=$?
3801         do_facet mds${index} lctl set_param fail_loc=0
3802         return $RC
3803 }
3804
3805 pause_bulk() {
3806 #define OBD_FAIL_OST_BRW_PAUSE_BULK      0x214
3807     RC=0
3808     do_facet ost1 lctl set_param fail_loc=0x214
3809     do_facet client "$1" || RC=$?
3810     do_facet client "sync"
3811     do_facet ost1 lctl set_param fail_loc=0
3812     return $RC
3813 }
3814
3815 drop_ldlm_cancel() {
3816 #define OBD_FAIL_LDLM_CANCEL_NET                        0x304
3817         local RC=0
3818         local list=$(comma_list $(mdts_nodes) $(osts_nodes))
3819         do_nodes $list lctl set_param fail_loc=0x304
3820
3821         do_facet client "$@" || RC=$?
3822
3823         do_nodes $list lctl set_param fail_loc=0
3824         return $RC
3825 }
3826
3827 drop_bl_callback() {
3828 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
3829         RC=0
3830         do_facet client lctl set_param fail_loc=0x80000305
3831         do_facet client "$@" || RC=$?
3832         do_facet client lctl set_param fail_loc=0
3833         return $RC
3834 }
3835
3836 drop_ldlm_reply() {
3837 #define OBD_FAIL_LDLM_REPLY              0x30c
3838     RC=0
3839     do_facet $SINGLEMDS lctl set_param fail_loc=0x30c
3840     do_facet client "$@" || RC=$?
3841     do_facet $SINGLEMDS lctl set_param fail_loc=0
3842     return $RC
3843 }
3844
3845 clear_failloc() {
3846     facet=$1
3847     pause=$2
3848     sleep $pause
3849     echo "clearing fail_loc on $facet"
3850     do_facet $facet "lctl set_param fail_loc=0 2>/dev/null || true"
3851 }
3852
3853 set_nodes_failloc () {
3854     do_nodes $(comma_list $1)  lctl set_param fail_loc=$2
3855 }
3856
3857 cancel_lru_locks() {
3858     $LCTL mark "cancel_lru_locks $1 start"
3859     for d in `lctl get_param -N ldlm.namespaces.*.lru_size | egrep -i $1`; do
3860         $LCTL set_param -n $d=clear
3861     done
3862     $LCTL get_param ldlm.namespaces.*.lock_unused_count | egrep -i $1 | grep -v '=0'
3863     $LCTL mark "cancel_lru_locks $1 stop"
3864 }
3865
3866 default_lru_size()
3867 {
3868         NR_CPU=$(grep -c "processor" /proc/cpuinfo)
3869         DEFAULT_LRU_SIZE=$((100 * NR_CPU))
3870         echo "$DEFAULT_LRU_SIZE"
3871 }
3872
3873 lru_resize_enable()
3874 {
3875     lctl set_param ldlm.namespaces.*$1*.lru_size=0
3876 }
3877
3878 lru_resize_disable()
3879 {
3880     lctl set_param ldlm.namespaces.*$1*.lru_size $(default_lru_size)
3881 }
3882
3883 pgcache_empty() {
3884     local FILE
3885     for FILE in `lctl get_param -N "llite.*.dump_page_cache"`; do
3886         if [ `lctl get_param -n $FILE | wc -l` -gt 1 ]; then
3887             echo there is still data in page cache $FILE ?
3888             lctl get_param -n $FILE
3889             return 1
3890         fi
3891     done
3892     return 0
3893 }
3894
3895 debugsave() {
3896     DEBUGSAVE="$(lctl get_param -n debug)"
3897 }
3898
3899 debugrestore() {
3900     [ -n "$DEBUGSAVE" ] && \
3901         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug=\\\"${DEBUGSAVE}\\\";"
3902     DEBUGSAVE=""
3903 }
3904
3905 debug_size_save() {
3906     DEBUG_SIZE_SAVED="$(lctl get_param -n debug_mb)"
3907 }
3908
3909 debug_size_restore() {
3910     [ -n "$DEBUG_SIZE_SAVED" ] && \
3911         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE_SAVED"
3912     DEBUG_SIZE_SAVED=""
3913 }
3914
3915 start_full_debug_logging() {
3916     debugsave
3917     debug_size_save
3918
3919     local FULLDEBUG=-1
3920     local DEBUG_SIZE=150
3921
3922     do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE"
3923     do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug=$FULLDEBUG;"
3924 }
3925
3926 stop_full_debug_logging() {
3927     debug_size_restore
3928     debugrestore
3929 }
3930
3931 # prints bash call stack
3932 log_trace_dump() {
3933         echo "  Trace dump:"
3934         for (( i=1; i < ${#BASH_LINENO[*]} ; i++ )) ; do
3935                 local s=${BASH_SOURCE[$i]}
3936                 local l=${BASH_LINENO[$i-1]}
3937                 local f=${FUNCNAME[$i]}
3938                 echo "  = $s:$l:$f()"
3939         done
3940 }
3941
3942 ##################################
3943 # Test interface
3944 ##################################
3945
3946 error_noexit() {
3947     local TYPE=${TYPE:-"FAIL"}
3948
3949     local dump=true
3950     # do not dump logs if $1=false
3951     if [ "x$1" = "xfalse" ]; then
3952         shift
3953         dump=false
3954     fi
3955
3956     log " ${TESTSUITE} ${TESTNAME}: @@@@@@ ${TYPE}: $@ "
3957     log_trace_dump
3958
3959     mkdir -p $LOGDIR
3960     # We need to dump the logs on all nodes
3961     if $dump; then
3962         gather_logs $(comma_list $(nodes_list))
3963     fi
3964
3965         debugrestore
3966         [ "$TESTSUITELOG" ] &&
3967                 echo "$TESTSUITE: $TYPE: $TESTNAME $@" >> $TESTSUITELOG
3968         echo "$@" > $LOGDIR/err
3969 }
3970
3971 exit_status () {
3972         local status=0
3973         local log=$TESTSUITELOG
3974
3975         [ -f "$log" ] && grep -q FAIL $log && status=1
3976         exit $status
3977 }
3978
3979 error() {
3980     error_noexit "$@"
3981     exit 1
3982 }
3983
3984 error_exit() {
3985     error "$@"
3986 }
3987
3988 # use only if we are ignoring failures for this test, bugno required.
3989 # (like ALWAYS_EXCEPT, but run the test and ignore the results.)
3990 # e.g. error_ignore 5494 "your message"
3991 error_ignore() {
3992     local TYPE="IGNORE (bz$1)"
3993     shift
3994     error_noexit "$@"
3995 }
3996
3997 error_and_remount() {
3998         error_noexit "$@"
3999         remount_client $MOUNT
4000         exit 1
4001 }
4002
4003 skip_env () {
4004     $FAIL_ON_SKIP_ENV && error false $@ || skip $@
4005 }
4006
4007 skip() {
4008         echo
4009         log " SKIP: $TESTSUITE $TESTNAME $@"
4010
4011         if [[ -n "$ALWAYS_SKIPPED" ]]; then
4012                 skip_logged $TESTNAME "$@"
4013         else
4014                 mkdir -p $LOGDIR
4015                 echo "$@" > $LOGDIR/skip
4016         fi
4017
4018         [[ -n "$TESTSUITELOG" ]] &&
4019                 echo "$TESTSUITE: SKIP: $TESTNAME $@" >> $TESTSUITELOG || true
4020 }
4021
4022 build_test_filter() {
4023     EXCEPT="$EXCEPT $(testslist_filter)"
4024
4025     [ "$ONLY" ] && log "only running test `echo $ONLY`"
4026     for O in $ONLY; do
4027         eval ONLY_${O}=true
4028     done
4029     [ "$EXCEPT$ALWAYS_EXCEPT" ] && \
4030         log "excepting tests: `echo $EXCEPT $ALWAYS_EXCEPT`"
4031     [ "$EXCEPT_SLOW" ] && \
4032         log "skipping tests SLOW=no: `echo $EXCEPT_SLOW`"
4033     for E in $EXCEPT; do
4034         eval EXCEPT_${E}=true
4035     done
4036     for E in $ALWAYS_EXCEPT; do
4037         eval EXCEPT_ALWAYS_${E}=true
4038     done
4039     for E in $EXCEPT_SLOW; do
4040         eval EXCEPT_SLOW_${E}=true
4041     done
4042     for G in $GRANT_CHECK_LIST; do
4043         eval GCHECK_ONLY_${G}=true
4044         done
4045 }
4046
4047 basetest() {
4048     if [[ $1 = [a-z]* ]]; then
4049         echo $1
4050     else
4051         echo ${1%%[a-z]*}
4052     fi
4053 }
4054
4055 # print a newline if the last test was skipped
4056 export LAST_SKIPPED=
4057 export ALWAYS_SKIPPED=
4058 #
4059 # Main entry into test-framework. This is called with the name and
4060 # description of a test. The name is used to find the function to run
4061 # the test using "test_$name".
4062 #
4063 # This supports a variety of methods of specifying specific test to
4064 # run or not run.  These need to be documented...
4065 #
4066 run_test() {
4067     assert_DIR
4068
4069     export base=`basetest $1`
4070     if [ ! -z "$ONLY" ]; then
4071         testname=ONLY_$1
4072         if [ ${!testname}x != x ]; then
4073             [ "$LAST_SKIPPED" ] && echo "" && LAST_SKIPPED=
4074             run_one_logged $1 "$2"
4075             return $?
4076         fi
4077         testname=ONLY_$base
4078         if [ ${!testname}x != x ]; then
4079             [ "$LAST_SKIPPED" ] && echo "" && LAST_SKIPPED=
4080             run_one_logged $1 "$2"
4081             return $?
4082         fi
4083         LAST_SKIPPED="y"
4084         echo -n "."
4085         return 0
4086     fi
4087
4088         LAST_SKIPPED="y"
4089         ALWAYS_SKIPPED="y"
4090     testname=EXCEPT_$1
4091     if [ ${!testname}x != x ]; then
4092         TESTNAME=test_$1 skip "skipping excluded test $1"
4093         return 0
4094     fi
4095     testname=EXCEPT_$base
4096     if [ ${!testname}x != x ]; then
4097         TESTNAME=test_$1 skip "skipping excluded test $1 (base $base)"
4098         return 0
4099     fi
4100     testname=EXCEPT_ALWAYS_$1
4101     if [ ${!testname}x != x ]; then
4102         TESTNAME=test_$1 skip "skipping ALWAYS excluded test $1"
4103         return 0
4104     fi
4105     testname=EXCEPT_ALWAYS_$base
4106     if [ ${!testname}x != x ]; then
4107         TESTNAME=test_$1 skip "skipping ALWAYS excluded test $1 (base $base)"
4108         return 0
4109     fi
4110     testname=EXCEPT_SLOW_$1
4111     if [ ${!testname}x != x ]; then
4112         TESTNAME=test_$1 skip "skipping SLOW test $1"
4113         return 0
4114     fi
4115     testname=EXCEPT_SLOW_$base
4116     if [ ${!testname}x != x ]; then
4117         TESTNAME=test_$1 skip "skipping SLOW test $1 (base $base)"
4118         return 0
4119     fi
4120
4121     LAST_SKIPPED=
4122     ALWAYS_SKIPPED=
4123     run_one_logged $1 "$2"
4124
4125     return $?
4126 }
4127
4128 log() {
4129     echo "$*"
4130     module_loaded lnet || load_modules
4131
4132     local MSG="$*"
4133     # Get rid of '
4134     MSG=${MSG//\'/\\\'}
4135     MSG=${MSG//\(/\\\(}
4136     MSG=${MSG//\)/\\\)}
4137     MSG=${MSG//\;/\\\;}
4138     MSG=${MSG//\|/\\\|}
4139     MSG=${MSG//\>/\\\>}
4140     MSG=${MSG//\</\\\<}
4141     MSG=${MSG//\//\\\/}
4142     do_nodes $(comma_list $(nodes_list)) $LCTL mark "$MSG" 2> /dev/null || true
4143 }
4144
4145 trace() {
4146         log "STARTING: $*"
4147         strace -o $TMP/$1.strace -ttt $*
4148         RC=$?
4149         log "FINISHED: $*: rc $RC"
4150         return 1
4151 }
4152
4153 complete () {
4154     local duration=$1
4155
4156     banner test complete, duration $duration sec
4157     [ -f "$TESTSUITELOG" ] && egrep .FAIL $TESTSUITELOG || true
4158     echo duration $duration >>$TESTSUITELOG
4159 }
4160
4161 pass() {
4162         # Set TEST_STATUS here. It will be used for logging the result.
4163         TEST_STATUS="PASS"
4164
4165         if [[ -f $LOGDIR/err ]]; then
4166                 TEST_STATUS="FAIL"
4167         elif [[ -f $LOGDIR/skip ]]; then
4168                 TEST_STATUS="SKIP"
4169         fi
4170         echo "$TEST_STATUS $@" 2>&1 | tee -a $TESTSUITELOG
4171 }
4172
4173 check_mds() {
4174     local FFREE=$(do_node $SINGLEMDS \
4175         lctl get_param -n osd*.*MDT*.filesfree | calc_sum)
4176     local FTOTAL=$(do_node $SINGLEMDS \
4177         lctl get_param -n osd*.*MDT*.filestotal | calc_sum)
4178
4179     [ $FFREE -ge $FTOTAL ] && error "files free $FFREE > total $FTOTAL" || true
4180 }
4181
4182 reset_fail_loc () {
4183     echo -n "Resetting fail_loc on all nodes..."
4184     do_nodes $(comma_list $(nodes_list)) "lctl set_param -n fail_loc=0 2>/dev/null || true"
4185     echo done.
4186 }
4187
4188
4189 #
4190 # Log a message (on all nodes) padded with "=" before and after. 
4191 # Also appends a timestamp and prepends the testsuite name.
4192
4193
4194 EQUALS="===================================================================================================="
4195 banner() {
4196     msg="== ${TESTSUITE} $*"
4197     last=${msg: -1:1}
4198     [[ $last != "=" && $last != " " ]] && msg="$msg "
4199     msg=$(printf '%s%.*s'  "$msg"  $((${#EQUALS} - ${#msg})) $EQUALS )
4200     # always include at least == after the message
4201     log "$msg== $(date +"%H:%M:%S (%s)")"
4202 }
4203
4204 #
4205 # Run a single test function and cleanup after it.  
4206 #
4207 # This function should be run in a subshell so the test func can
4208 # exit() without stopping the whole script.
4209 #
4210 run_one() {
4211     local testnum=$1
4212     local message=$2
4213     tfile=f.${TESTSUITE}.${testnum}
4214     export tdir=d0.${TESTSUITE}/d${base}
4215     export TESTNAME=test_$testnum
4216     local SAVE_UMASK=`umask`
4217     umask 0022
4218
4219     banner "test $testnum: $message"
4220     test_${testnum} || error "test_$testnum failed with $?"
4221     cd $SAVE_PWD
4222     reset_fail_loc
4223     check_grant ${testnum} || error "check_grant $testnum failed with $?"
4224     check_catastrophe || error "LBUG/LASSERT detected"
4225         if [ "$PARALLEL" != "yes" ]; then
4226                 ps auxww | grep -v grep | grep -q multiop &&
4227                                         error "multiop still running"
4228         fi
4229     unset TESTNAME
4230     unset tdir
4231     umask $SAVE_UMASK
4232     return 0
4233 }
4234
4235 #
4236 # Wrapper around run_one to ensure:
4237 #  - test runs in subshell
4238 #  - output of test is saved to separate log file for error reporting
4239 #  - test result is saved to data file
4240 #
4241 run_one_logged() {
4242         local BEFORE=`date +%s`
4243         local TEST_ERROR
4244         local name=${TESTSUITE}.test_${1}.test_log.$(hostname -s).log
4245         local test_log=$LOGDIR/$name
4246         rm -rf $LOGDIR/err
4247         rm -rf $LOGDIR/skip
4248         local SAVE_UMASK=`umask`
4249         umask 0022
4250
4251         echo
4252         log_sub_test_begin test_${1}
4253         (run_one $1 "$2") 2>&1 | tee -i $test_log
4254         local RC=${PIPESTATUS[0]}
4255
4256         [ $RC -ne 0 ] && [ ! -f $LOGDIR/err ] && \
4257                 echo "test_$1 returned $RC" | tee $LOGDIR/err
4258
4259         duration=$((`date +%s` - $BEFORE))
4260         pass "$1" "(${duration}s)"
4261
4262         if [[ -f $LOGDIR/err ]]; then
4263                 TEST_ERROR=$(cat $LOGDIR/err)
4264         elif [[ -f $LOGDIR/skip ]]; then
4265                 TEST_ERROR=$(cat $LOGDIR/skip)
4266         fi
4267         log_sub_test_end $TEST_STATUS $duration "$RC" "$TEST_ERROR"
4268
4269         if [ -f $LOGDIR/err ]; then
4270                 $FAIL_ON_ERROR && exit $RC
4271         fi
4272
4273         umask $SAVE_UMASK
4274
4275         return 0
4276 }
4277
4278 #
4279 # Print information of skipped tests to result.yml
4280 #
4281 skip_logged(){
4282         log_sub_test_begin $1
4283         shift
4284         log_sub_test_end "SKIP" "0" "0" "$@"
4285 }
4286
4287 canonical_path() {
4288     (cd `dirname $1`; echo $PWD/`basename $1`)
4289 }
4290
4291
4292 check_grant() {
4293     export base=`basetest $1`
4294     [ "$CHECK_GRANT" == "no" ] && return 0
4295
4296         testname=GCHECK_ONLY_${base}
4297         [ ${!testname}x == x ] && return 0
4298
4299     echo -n "checking grant......"
4300
4301         local clients=$CLIENTS
4302         [ -z $clients ] && clients=$(hostname)
4303
4304     # sync all the data and make sure no pending data on server
4305     do_nodes $clients sync
4306
4307     # get client grant
4308     client_grant=`do_nodes $clients \
4309                     "$LCTL get_param -n osc.${FSNAME}-*.cur_*grant_bytes" | \
4310                     awk '{total += $1} END{print total}'`
4311
4312     # get server grant
4313     server_grant=`do_nodes $(comma_list $(osts_nodes)) \
4314                     "$LCTL get_param -n obdfilter.${FSNAME}-OST*.tot_granted" |
4315                     awk '{total += $1} END{print total}'`
4316
4317     # check whether client grant == server grant
4318     if [ $client_grant -ne $server_grant ]; then
4319         echo "failed: client:${client_grant} server: ${server_grant}."
4320         do_nodes $(comma_list $(osts_nodes)) \
4321                    "$LCTL get_param obdfilter.${FSNAME}-OST*.tot*"
4322         do_nodes $clients "$LCTL get_param osc.${FSNAME}-*.cur_*_bytes"
4323         return 1
4324     else
4325         echo "pass: client:${client_grant} server: ${server_grant}"
4326     fi
4327
4328 }
4329
4330 ########################
4331 # helper functions
4332
4333 osc_to_ost()
4334 {
4335     osc=$1
4336     ost=`echo $1 | awk -F_ '{print $3}'`
4337     if [ -z $ost ]; then
4338         ost=`echo $1 | sed 's/-osc.*//'`
4339     fi
4340     echo $ost
4341 }
4342
4343 ostuuid_from_index()
4344 {
4345     $LFS osts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
4346 }
4347
4348 ostname_from_index() {
4349     local uuid=$(ostuuid_from_index $1)
4350     echo ${uuid/_UUID/}
4351 }
4352
4353 index_from_ostuuid()
4354 {
4355     $LFS osts $2 | sed -ne "/${1}/s/\(.*\): .* .*$/\1/p"
4356 }
4357
4358 mdtuuid_from_index()
4359 {
4360     $LFS mdts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
4361 }
4362
4363 # Description:
4364 #   Return unique identifier for given hostname
4365 host_id() {
4366         local host_name=$1
4367         echo $host_name | md5sum | cut -d' ' -f1
4368 }
4369
4370 # Description:
4371 #   Returns list of ip addresses for each interface
4372 local_addr_list() {
4373         ip addr | awk '/inet\ / {print $2}' | awk -F\/ '{print $1}'
4374 }
4375
4376 is_local_addr() {
4377         local addr=$1
4378         # Cache address list to avoid mutiple execution of local_addr_list
4379         LOCAL_ADDR_LIST=${LOCAL_ADDR_LIST:-$(local_addr_list)}
4380         local i
4381         for i in $LOCAL_ADDR_LIST ; do
4382                 [[ "$i" == "$addr" ]] && return 0
4383         done
4384         return 1
4385 }
4386
4387 local_node() {
4388         local host_name=$1
4389         local is_local="IS_LOCAL_$(host_id $host_name)"
4390         if [ -z "${!is_local-}" ] ; then
4391                 eval $is_local=0
4392                 local host_ip=$($LUSTRE/tests/resolveip $host_name)
4393                 is_local_addr "$host_ip" && eval $is_local=1
4394         fi
4395         [[ "${!is_local}" == "1" ]]
4396 }
4397
4398 remote_node () {
4399         local node=$1
4400         local_node $node && return 1
4401         return 0
4402 }
4403
4404 remote_mds ()
4405 {
4406     local node
4407     for node in $(mdts_nodes); do
4408         remote_node $node && return 0
4409     done
4410     return 1
4411 }
4412
4413 remote_mds_nodsh()
4414 {
4415     [ "$CLIENTONLY" ] && return 0 || true
4416     remote_mds && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$mds_HOST" ]
4417 }
4418
4419 require_dsh_mds()
4420 {
4421         remote_mds_nodsh && echo "SKIP: $TESTSUITE: remote MDS with nodsh" && \
4422             MSKIPPED=1 && return 1
4423         return 0
4424 }
4425
4426 remote_ost ()
4427 {
4428     local node
4429     for node in $(osts_nodes) ; do
4430         remote_node $node && return 0
4431     done
4432     return 1
4433 }
4434
4435 remote_ost_nodsh()
4436 {
4437     [ "$CLIENTONLY" ] && return 0 || true 
4438     remote_ost && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
4439 }
4440
4441 require_dsh_ost()
4442 {
4443         remote_ost_nodsh && echo "SKIP: $TESTSUITE: remote OST with nodsh" && \
4444             OSKIPPED=1 && return 1
4445         return 0
4446 }
4447
4448 remote_mgs_nodsh()
4449 {
4450     local MGS 
4451     MGS=$(facet_host mgs)
4452     remote_node $MGS && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
4453 }
4454
4455 local_mode ()
4456 {
4457     remote_mds_nodsh || remote_ost_nodsh || \
4458         $(single_local_node $(comma_list $(nodes_list)))
4459 }
4460
4461 mdts_nodes () {
4462     local MDSNODES
4463     local NODES_sort
4464     for num in `seq $MDSCOUNT`; do
4465         MDSNODES="$MDSNODES $(facet_host mds$num)"
4466     done
4467     NODES_sort=$(for i in $MDSNODES; do echo $i; done | sort -u)
4468
4469     echo $NODES_sort
4470 }
4471
4472 remote_servers () {
4473     remote_ost && remote_mds
4474 }
4475
4476 facets_nodes () {
4477     local facets=$1
4478     local nodes
4479     local NODES_sort
4480
4481     for facet in ${facets//,/ }; do
4482         if [ "$FAILURE_MODE" = HARD ]; then
4483             nodes="$nodes $(facet_active_host $facet)"
4484         else
4485             nodes="$nodes $(facet_host $facet)"
4486         fi
4487     done
4488     NODES_sort=$(for i in $nodes; do echo $i; done | sort -u)
4489
4490     echo $NODES_sort
4491 }
4492
4493 osts_nodes () {
4494     local facets=$(get_facets OST)
4495     local nodes=$(facets_nodes $facets)
4496
4497     echo $nodes
4498 }
4499
4500 nodes_list () {
4501     # FIXME. We need a list of clients
4502     local myNODES=$HOSTNAME
4503     local myNODES_sort
4504
4505     # CLIENTS (if specified) contains the local client
4506     [ -n "$CLIENTS" ] && myNODES=${CLIENTS//,/ }
4507
4508     if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
4509         myNODES="$myNODES $(facets_nodes $(get_facets))"
4510     fi
4511
4512     myNODES_sort=$(for i in $myNODES; do echo $i; done | sort -u)
4513
4514     echo $myNODES_sort
4515 }
4516
4517 remote_nodes_list () {
4518         echo $(nodes_list) | sed -re "s/\<$HOSTNAME\>//g"
4519 }
4520
4521 init_clients_lists () {
4522     # Sanity check: exclude the local client from RCLIENTS
4523     local clients=$(hostlist_expand "$RCLIENTS")
4524     local rclients=$(exclude_items_from_list "$clients" $HOSTNAME)
4525
4526     # Sanity check: exclude the dup entries
4527     RCLIENTS=$(for i in ${rclients//,/ }; do echo $i; done | sort -u)
4528
4529     clients="$SINGLECLIENT $HOSTNAME $RCLIENTS"
4530
4531     # Sanity check: exclude the dup entries from CLIENTS
4532     # for those configs which has SINGLCLIENT set to local client
4533     clients=$(for i in $clients; do echo $i; done | sort -u)
4534
4535     CLIENTS=$(comma_list $clients)
4536     local -a remoteclients=($RCLIENTS)
4537     for ((i=0; $i<${#remoteclients[@]}; i++)); do
4538             varname=CLIENT$((i + 2))
4539             eval $varname=${remoteclients[i]}
4540     done
4541
4542     CLIENTCOUNT=$((${#remoteclients[@]} + 1))
4543 }
4544
4545 get_random_entry () {
4546     local rnodes=$1
4547
4548     rnodes=${rnodes//,/ }
4549
4550     local -a nodes=($rnodes)
4551     local num=${#nodes[@]} 
4552     local i=$((RANDOM * num * 2 / 65536))
4553
4554     echo ${nodes[i]}
4555 }
4556
4557 client_only () {
4558     [ "$CLIENTONLY" ] || [ "$CLIENTMODSONLY" = yes ]
4559 }
4560
4561 is_patchless ()
4562 {
4563     lctl get_param version | grep -q patchless
4564 }
4565
4566 check_versions () {
4567     [ "$(lustre_version_code client)" = "$(lustre_version_code $SINGLEMDS)" -a \
4568       "$(lustre_version_code client)" = "$(lustre_version_code ost1)" ]
4569 }
4570
4571 get_node_count() {
4572     local nodes="$@"
4573     echo $nodes | wc -w || true
4574 }
4575
4576 mixed_ost_devs () {
4577     local nodes=$(osts_nodes)
4578     local osscount=$(get_node_count "$nodes")
4579     [ ! "$OSTCOUNT" = "$osscount" ]
4580 }
4581
4582 mixed_mdt_devs () {
4583     local nodes=$(mdts_nodes)
4584     local mdtcount=$(get_node_count "$nodes")
4585     [ ! "$MDSCOUNT" = "$mdtcount" ]
4586 }
4587
4588 generate_machine_file() {
4589     local nodes=${1//,/ }
4590     local machinefile=$2
4591     rm -f $machinefile
4592     for node in $nodes; do
4593         echo $node >>$machinefile || \
4594             { echo "can not generate machinefile $machinefile" && return 1; }
4595     done
4596 }
4597
4598 get_stripe () {
4599     local file=$1/stripe
4600     touch $file
4601     $LFS getstripe -v $file || error
4602     rm -f $file
4603 }
4604
4605 setstripe_nfsserver () {
4606     local dir=$1
4607
4608     local nfsserver=$(awk '"'$dir'" ~ $2 && $3 ~ "nfs" && $2 != "/" \
4609                 { print $1 }' /proc/mounts | cut -f 1 -d : | head -1)
4610
4611     [ -z $nfsserver ] && echo "$dir is not nfs mounted" && return 1
4612
4613     do_nodev $nfsserver lfs setstripe "$@"
4614 }
4615
4616 # Check and add a test group.
4617 add_group() {
4618         local group_id=$1
4619         local group_name=$2
4620         local rc=0
4621
4622         local gid=$(getent group $group_name | cut -d: -f3)
4623         if [[ -n "$gid" ]]; then
4624                 [[ "$gid" -eq "$group_id" ]] || {
4625                         error_noexit "inconsistent group ID:" \
4626                                      "new: $group_id, old: $gid"
4627                         rc=1
4628                 }
4629         else
4630                 groupadd -g $group_id $group_name
4631                 rc=${PIPESTATUS[0]}
4632         fi
4633
4634         return $rc
4635 }
4636
4637 # Check and add a test user.
4638 add_user() {
4639         local user_id=$1
4640         shift
4641         local user_name=$1
4642         shift
4643         local group_name=$1
4644         shift
4645         local home=$1
4646         shift
4647         local opts="$@"
4648         local rc=0
4649
4650         local uid=$(getent passwd $user_name | cut -d: -f3)
4651         if [[ -n "$uid" ]]; then
4652                 if [[ "$uid" -eq "$user_id" ]]; then
4653                         local dir=$(getent passwd $user_name | cut -d: -f6)
4654                         if [[ "$dir" != "$home" ]]; then
4655                                 mkdir -p $home
4656                                 usermod -d $home $user_name
4657                                 rc=${PIPESTATUS[0]}
4658                         fi
4659                 else
4660                         error_noexit "inconsistent user ID:" \
4661                                      "new: $user_id, old: $uid"
4662                         rc=1
4663                 fi
4664         else
4665                 mkdir -p $home
4666                 useradd -M -u $user_id -d $home -g $group_name $opts $user_name
4667                 rc=${PIPESTATUS[0]}
4668         fi
4669
4670         return $rc
4671 }
4672
4673 check_runas_id_ret() {
4674     local myRC=0
4675     local myRUNAS_UID=$1
4676     local myRUNAS_GID=$2
4677     shift 2
4678     local myRUNAS=$@
4679     if [ -z "$myRUNAS" ]; then
4680         error_exit "myRUNAS command must be specified for check_runas_id"
4681     fi
4682     if $GSS_KRB5; then
4683         $myRUNAS krb5_login.sh || \
4684             error "Failed to refresh Kerberos V5 TGT for UID $myRUNAS_ID."
4685     fi
4686     mkdir $DIR/d0_runas_test
4687     chmod 0755 $DIR
4688     chown $myRUNAS_UID:$myRUNAS_GID $DIR/d0_runas_test
4689     $myRUNAS touch $DIR/d0_runas_test/f$$ || myRC=$?
4690     rm -rf $DIR/d0_runas_test
4691     return $myRC
4692 }
4693
4694 check_runas_id() {
4695     local myRUNAS_UID=$1
4696     local myRUNAS_GID=$2
4697     shift 2
4698     local myRUNAS=$@
4699     check_runas_id_ret $myRUNAS_UID $myRUNAS_GID $myRUNAS || \
4700         error "unable to write to $DIR/d0_runas_test as UID $myRUNAS_UID.
4701         Please set RUNAS_ID to some UID which exists on MDS and client or
4702         add user $myRUNAS_UID:$myRUNAS_GID on these nodes."
4703 }
4704
4705 # obtain the UID/GID for MPI_USER
4706 get_mpiuser_id() {
4707     local mpi_user=$1
4708
4709     MPI_USER_UID=$(do_facet client "getent passwd $mpi_user | cut -d: -f3;
4710 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the UID for $mpi_user"
4711
4712     MPI_USER_GID=$(do_facet client "getent passwd $mpi_user | cut -d: -f4;
4713 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the GID for $mpi_user"
4714 }
4715
4716 # obtain and cache Kerberos ticket-granting ticket
4717 refresh_krb5_tgt() {
4718     local myRUNAS_UID=$1
4719     local myRUNAS_GID=$2
4720     shift 2
4721     local myRUNAS=$@
4722     if [ -z "$myRUNAS" ]; then
4723         error_exit "myRUNAS command must be specified for refresh_krb5_tgt"
4724     fi
4725
4726     CLIENTS=${CLIENTS:-$HOSTNAME}
4727     do_nodes $CLIENTS "set -x
4728 if ! $myRUNAS krb5_login.sh; then
4729     echo "Failed to refresh Krb5 TGT for UID/GID $myRUNAS_UID/$myRUNAS_GID."
4730     exit 1
4731 fi"
4732 }
4733
4734 # Run multiop in the background, but wait for it to print
4735 # "PAUSING" to its stdout before returning from this function.
4736 multiop_bg_pause() {
4737     MULTIOP_PROG=${MULTIOP_PROG:-$MULTIOP}
4738     FILE=$1
4739     ARGS=$2
4740
4741     TMPPIPE=/tmp/multiop_open_wait_pipe.$$
4742     mkfifo $TMPPIPE
4743
4744     echo "$MULTIOP_PROG $FILE v$ARGS"
4745     $MULTIOP_PROG $FILE v$ARGS > $TMPPIPE &
4746
4747     echo "TMPPIPE=${TMPPIPE}"
4748     read -t 60 multiop_output < $TMPPIPE
4749     if [ $? -ne 0 ]; then
4750         rm -f $TMPPIPE
4751         return 1
4752     fi
4753     rm -f $TMPPIPE
4754     if [ "$multiop_output" != "PAUSING" ]; then
4755         echo "Incorrect multiop output: $multiop_output"
4756         kill -9 $PID
4757         return 1
4758     fi
4759
4760     return 0
4761 }
4762
4763 do_and_time () {
4764     local cmd=$1
4765     local rc
4766
4767     SECONDS=0
4768     eval '$cmd'
4769     
4770     [ ${PIPESTATUS[0]} -eq 0 ] || rc=1
4771
4772     echo $SECONDS
4773     return $rc
4774 }
4775
4776 inodes_available () {
4777     local IFree=$($LFS df -i $MOUNT | grep ^$FSNAME | awk '{print $4}' | sort -un | head -1) || return 1
4778     echo $IFree
4779 }
4780
4781 mdsrate_inodes_available () {
4782     local min_inodes=$(inodes_available)
4783     echo $((min_inodes * 99 / 100))
4784 }
4785
4786 # reset llite stat counters
4787 clear_llite_stats(){
4788         lctl set_param -n llite.*.stats 0
4789 }
4790
4791 # sum llite stat items
4792 calc_llite_stats() {
4793         local res=$(lctl get_param -n llite.*.stats |
4794                     awk 'BEGIN {s = 0} END {print s} /^'"$1"'/ {s += $2}')
4795         echo $res
4796 }
4797
4798 # reset osc stat counters
4799 clear_osc_stats(){
4800         lctl set_param -n osc.*.osc_stats 0
4801 }
4802
4803 # sum osc stat items
4804 calc_osc_stats() {
4805         local res=$(lctl get_param -n osc.*.osc_stats |
4806                     awk 'BEGIN {s = 0} END {print s} /^'"$1"'/ {s += $2}')
4807         echo $res
4808 }
4809
4810 calc_sum () {
4811         awk 'BEGIN {s = 0}; {s += $1}; END {print s}'
4812 }
4813
4814 calc_osc_kbytes () {
4815         df $MOUNT > /dev/null
4816         $LCTL get_param -n osc.*[oO][sS][cC][-_][0-9a-f]*.$1 | calc_sum
4817 }
4818
4819 # save_lustre_params(node, parameter_mask)
4820 # generate a stream of formatted strings (<node> <param name>=<param value>)
4821 save_lustre_params() {
4822         local s
4823         do_nodesv $1 "lctl get_param $2 | while read s; do echo \\\$s; done"
4824 }
4825
4826 # restore lustre parameters from input stream, produces by save_lustre_params
4827 restore_lustre_params() {
4828         local node
4829         local name
4830         local val
4831         while IFS=" =" read node name val; do
4832                 do_node ${node//:/} "lctl set_param -n $name $val"
4833         done
4834 }
4835
4836 check_catastrophe() {
4837         local rnodes=${1:-$(comma_list $(remote_nodes_list))}
4838         local C=$CATASTROPHE
4839         [ -f $C ] && [ $(cat $C) -ne 0 ] && return 1
4840
4841         [ -z "$rnodes" ] && return 0
4842
4843         do_nodes "$rnodes" "rc=\\\$([ -f $C ] && echo \\\$(< $C) || echo 0);
4844                 if [ \\\$rc -ne 0 ]; then echo \\\$(hostname): \\\$rc; fi
4845                 exit \\\$rc;"
4846 }
4847
4848 # CMD: determine mds index where directory inode presents
4849 get_mds_dir () {
4850     local dir=$1
4851     local file=$dir/f0.get_mds_dir_tmpfile
4852
4853     mkdir -p $dir
4854     rm -f $file
4855     sleep 1
4856     local iused=$(lfs df -i $dir | grep MDT | awk '{print $3}')
4857     local -a oldused=($iused)
4858
4859     openfile -f O_CREAT:O_LOV_DELAY_CREATE -m 0644 $file > /dev/null
4860     sleep 1
4861     iused=$(lfs df -i $dir | grep MDT | awk '{print $3}')
4862     local -a newused=($iused)
4863
4864     local num=0
4865     for ((i=0; i<${#newused[@]}; i++)); do
4866          if [ ${oldused[$i]} -lt ${newused[$i]} ];  then
4867              echo $(( i + 1 ))
4868              rm -f $file
4869              return 0
4870          fi
4871     done
4872     error "mdt-s : inodes count OLD ${oldused[@]} NEW ${newused[@]}"
4873 }
4874
4875 mdsrate_cleanup () {
4876         if [ -d $4 ]; then
4877                 mpi_run -np $1 ${MACHINEFILE_OPTION} $2 ${MDSRATE} --unlink \
4878                         --nfiles $3 --dir $4 --filefmt $5 $6
4879                 rmdir $4
4880         fi
4881 }
4882
4883 delayed_recovery_enabled () {
4884     local var=${SINGLEMDS}_svc
4885     do_facet $SINGLEMDS lctl get_param -n mdd.${!var}.stale_export_age > /dev/null 2>&1
4886 }
4887
4888 ########################
4889
4890 convert_facet2label() { 
4891     local facet=$1
4892
4893     if [ x$facet = xost ]; then
4894        facet=ost1
4895     fi
4896
4897     local varsvc=${facet}_svc
4898
4899     if [ -n ${!varsvc} ]; then
4900         echo ${!varsvc}
4901     else  
4902         error "No lablel for $facet!"
4903     fi
4904 }
4905
4906 get_clientosc_proc_path() {
4907     echo "${1}-osc-[^M]*"
4908 }
4909
4910 get_lustre_version () {
4911     local facet=${1:-"$SINGLEMDS"}    
4912     do_facet $facet $LCTL get_param -n version | awk '/^lustre:/ {print $2}'
4913 }
4914
4915 lustre_version_code() {
4916     local facet=${1:-"$SINGLEMDS"}
4917     version_code $(get_lustre_version $1)
4918 }
4919
4920 # If the 2.0 MDS was mounted on 1.8 device, then the OSC and LOV names
4921 # used by MDT would not be changed.
4922 # mdt lov: fsname-mdtlov
4923 # mdt osc: fsname-OSTXXXX-osc
4924 mds_on_old_device() {
4925     local mds=${1:-"$SINGLEMDS"}
4926
4927     if [ $(lustre_version_code $mds) -gt $(version_code 1.9.0) ]; then
4928         do_facet $mds "lctl list_param osc.$FSNAME-OST*-osc \
4929             > /dev/null 2>&1" && return 0
4930     fi
4931     return 1
4932 }
4933
4934 get_mdtosc_proc_path() {
4935     local mds_facet=$1
4936     local ost_label=${2:-"*OST*"}
4937
4938     [ "$mds_facet" = "mds" ] && mds_facet=$SINGLEMDS
4939     local mdt_label=$(convert_facet2label $mds_facet)
4940     local mdt_index=$(echo $mdt_label | sed -e 's/^.*-//')
4941
4942     if [ $(lustre_version_code $mds_facet) -le $(version_code 1.8.0) ] ||
4943        mds_on_old_device $mds_facet; then
4944         echo "${ost_label}-osc"
4945     else
4946         echo "${ost_label}-osc-${mdt_index}"
4947     fi
4948 }
4949
4950 get_osc_import_name() {
4951     local facet=$1
4952     local ost=$2
4953     local label=$(convert_facet2label $ost)
4954
4955     if [ "${facet:0:3}" = "mds" ]; then
4956         get_mdtosc_proc_path $facet $label
4957         return 0
4958     fi
4959
4960     get_clientosc_proc_path $label
4961     return 0
4962 }
4963
4964 _wait_import_state () {
4965     local expected=$1
4966     local CONN_PROC=$2
4967     local maxtime=${3:-$(max_recovery_time)}
4968     local CONN_STATE
4969     local i=0
4970
4971     CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2)
4972     while [ "${CONN_STATE}" != "${expected}" ]; do
4973         if [ "${expected}" == "DISCONN" ]; then
4974             # for disconn we can check after proc entry is removed
4975             [ "x${CONN_STATE}" == "x" ] && return 0
4976             #  with AT enabled, we can have connect request timeout near of
4977             # reconnect timeout and test can't see real disconnect
4978             [ "${CONN_STATE}" == "CONNECTING" ] && return 0
4979         fi
4980         [ $i -ge $maxtime ] && \
4981             error "can't put import for $CONN_PROC into ${expected} state after $i sec, have ${CONN_STATE}" && \
4982             return 1
4983         sleep 1
4984         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2)
4985         i=$(($i + 1))
4986     done
4987
4988     log "$CONN_PROC in ${CONN_STATE} state after $i sec"
4989     return 0
4990 }
4991
4992 wait_import_state() {
4993     local state=$1
4994     local params=$2
4995     local maxtime=${3:-$(max_recovery_time)}
4996     local param
4997
4998     for param in ${params//,/ }; do
4999         _wait_import_state $state $param $maxtime || return
5000     done
5001 }
5002
5003 # One client request could be timed out because server was not ready
5004 # when request was sent by client.
5005 # The request timeout calculation details :
5006 # ptl_send_rpc ()
5007 #      /* We give the server rq_timeout secs to process the req, and
5008 #      add the network latency for our local timeout. */
5009 #      request->rq_deadline = request->rq_sent + request->rq_timeout +
5010 #           ptlrpc_at_get_net_latency(request) ;
5011 #
5012 # ptlrpc_connect_import ()
5013 #      request->rq_timeout = INITIAL_CONNECT_TIMEOUT
5014 #
5015 # init_imp_at () ->
5016 #   -> at_init(&at->iat_net_latency, 0, 0) -> iat_net_latency=0
5017 # ptlrpc_at_get_net_latency(request) ->
5018 #       at_get (max (iat_net_latency=0, at_min)) = at_min
5019 #
5020 # i.e.:
5021 # request->rq_timeout + ptlrpc_at_get_net_latency(request) =
5022 # INITIAL_CONNECT_TIMEOUT + at_min
5023 #
5024 # We will use obd_timeout instead of INITIAL_CONNECT_TIMEOUT
5025 # because we can not get this value in runtime,
5026 # the value depends on configure options, and it is not stored in /proc.
5027 # obd_support.h:
5028 # #define CONNECTION_SWITCH_MIN 5U
5029 # #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
5030
5031 request_timeout () {
5032     local facet=$1
5033
5034     # request->rq_timeout = INITIAL_CONNECT_TIMEOUT
5035     local init_connect_timeout=$TIMEOUT
5036     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
5037
5038     local at_min=$(at_get $facet at_min)
5039
5040     echo $(( init_connect_timeout + at_min ))
5041 }
5042
5043 wait_osc_import_state() {
5044     local facet=$1
5045     local ost_facet=$2
5046     local expected=$3
5047     local ost=$(get_osc_import_name $facet $ost_facet)
5048
5049     local param="osc.${ost}.ost_server_uuid"
5050
5051     # 1. wait the deadline of client 1st request (it could be skipped)
5052     # 2. wait the deadline of client 2nd request
5053     local maxtime=$(( 2 * $(request_timeout $facet)))
5054
5055         if ! do_rpc_nodes "$(facet_host $facet)" \
5056                         _wait_import_state $expected $param $maxtime; then
5057                 error "import is not in ${expected} state"
5058                 return 1
5059         fi
5060
5061         return 0
5062 }
5063
5064 get_clientmdc_proc_path() {
5065     echo "${1}-mdc-*"
5066 }
5067
5068 do_rpc_nodes () {
5069         local list=$1
5070         shift
5071
5072         [ -z "$list" ] && return 0
5073
5074         # Add paths to lustre tests for 32 and 64 bit systems.
5075         local RPATH="PATH=$RLUSTRE/tests:/usr/lib/lustre/tests:/usr/lib64/lustre/tests:$PATH"
5076         do_nodesv $list "${RPATH} NAME=${NAME} sh rpc.sh $@ "
5077 }
5078
5079 wait_clients_import_state () {
5080     local list=$1
5081     local facet=$2
5082     local expected=$3
5083
5084     local facets=$facet
5085
5086     if [ "$FAILURE_MODE" = HARD ]; then
5087         facets=$(facets_on_host $(facet_active_host $facet))
5088     fi
5089
5090     for facet in ${facets//,/ }; do
5091     local label=$(convert_facet2label $facet)
5092     local proc_path
5093     case $facet in
5094         ost* ) proc_path="osc.$(get_clientosc_proc_path $label).ost_server_uuid" ;;
5095         mds* ) proc_path="mdc.$(get_clientmdc_proc_path $label).mds_server_uuid" ;;
5096         *) error "unknown facet!" ;;
5097     esac
5098     local params=$(expand_list $params $proc_path)
5099     done
5100
5101         if ! do_rpc_nodes "$list" wait_import_state $expected $params; then
5102                 error "import is not in ${expected} state"
5103                 return 1
5104         fi
5105 }
5106
5107 oos_full() {
5108         local -a AVAILA
5109         local -a GRANTA
5110         local -a TOTALA
5111         local OSCFULL=1
5112         AVAILA=($(do_nodes $(comma_list $(osts_nodes)) \
5113                   $LCTL get_param obdfilter.*.kbytesavail))
5114         GRANTA=($(do_nodes $(comma_list $(osts_nodes)) \
5115                   $LCTL get_param -n obdfilter.*.tot_granted))
5116         TOTALA=($(do_nodes $(comma_list $(osts_nodes)) \
5117                   $LCTL get_param -n obdfilter.*.kbytestotal))
5118         for ((i=0; i<${#AVAILA[@]}; i++)); do
5119                 local -a AVAIL1=(${AVAILA[$i]//=/ })
5120                 local -a TOTAL=(${TOTALA[$i]//=/ })
5121                 GRANT=$((${GRANTA[$i]}/1024))
5122                 # allow 1% of total space in bavail because of delayed
5123                 # allocation with ZFS which might release some free space after
5124                 # txg commit.  For small devices, we set a mininum of 8MB
5125                 local LIMIT=$((${TOTAL} / 100 + 8000))
5126                 echo -n $(echo ${AVAIL1[0]} | cut -d"." -f2) avl=${AVAIL1[1]} \
5127                         grnt=$GRANT diff=$((AVAIL1[1] - GRANT)) limit=${LIMIT}
5128                 [ $((AVAIL1[1] - GRANT)) -lt $LIMIT ] && OSCFULL=0 && \
5129                         echo " FULL" || echo
5130         done
5131         return $OSCFULL
5132 }
5133
5134 pool_list () {
5135    do_facet mgs lctl pool_list $1
5136 }
5137
5138 create_pool() {
5139     local fsname=${1%%.*}
5140     local poolname=${1##$fsname.}
5141
5142     do_facet mgs lctl pool_new $1
5143     local RC=$?
5144     # get param should return err unless pool is created
5145     [[ $RC -ne 0 ]] && return $RC
5146
5147     wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
5148         2>/dev/null || echo foo" "" || RC=1
5149     if [[ $RC -eq 0 ]]; then
5150         add_pool_to_list $1
5151     else
5152         error "pool_new failed $1"
5153     fi
5154     return $RC
5155 }
5156
5157 add_pool_to_list () {
5158     local fsname=${1%%.*}
5159     local poolname=${1##$fsname.}
5160
5161     local listvar=${fsname}_CREATED_POOLS
5162     eval export ${listvar}=$(expand_list ${!listvar} $poolname)
5163 }
5164
5165 remove_pool_from_list () {
5166     local fsname=${1%%.*}
5167     local poolname=${1##$fsname.}
5168
5169     local listvar=${fsname}_CREATED_POOLS
5170     eval export ${listvar}=$(exclude_items_from_list ${!listvar} $poolname)
5171 }
5172
5173 destroy_pool_int() {
5174     local ost
5175     local OSTS=$(do_facet $SINGLEMDS lctl pool_list $1 | \
5176         awk '$1 !~ /^Pool:/ {print $1}')
5177     for ost in $OSTS; do
5178         do_facet mgs lctl pool_remove $1 $ost
5179     done
5180     do_facet mgs lctl pool_destroy $1
5181 }
5182
5183 # <fsname>.<poolname> or <poolname>
5184 destroy_pool() {
5185     local fsname=${1%%.*}
5186     local poolname=${1##$fsname.}
5187
5188     [[ x$fsname = x$poolname ]] && fsname=$FSNAME
5189
5190     local RC
5191
5192     pool_list $fsname.$poolname || return $?
5193
5194     destroy_pool_int $fsname.$poolname
5195     RC=$?
5196     [[ $RC -ne 0 ]] && return $RC
5197
5198     wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
5199       2>/dev/null || echo foo" "foo" || RC=1
5200
5201     if [[ $RC -eq 0 ]]; then
5202         remove_pool_from_list $fsname.$poolname
5203     else
5204         error "destroy pool failed $1"
5205     fi
5206     return $RC
5207 }
5208
5209 destroy_pools () {
5210     local fsname=${1:-$FSNAME}
5211     local poolname
5212     local listvar=${fsname}_CREATED_POOLS
5213
5214     pool_list $fsname
5215
5216     [ x${!listvar} = x ] && return 0
5217
5218     echo destroy the created pools: ${!listvar}
5219     for poolname in ${!listvar//,/ }; do
5220         destroy_pool $fsname.$poolname
5221     done
5222 }
5223
5224 cleanup_pools () {
5225     local fsname=${1:-$FSNAME}
5226     trap 0
5227     destroy_pools $fsname
5228 }
5229
5230 gather_logs () {
5231     local list=$1
5232
5233     local ts=$(date +%s)
5234     local docp=true
5235
5236     if [[ ! -f "$YAML_LOG" ]]; then
5237         # init_logging is not performed before gather_logs,
5238         # so the $LOGDIR needs to be checked here
5239         check_shared_dir $LOGDIR && touch $LOGDIR/shared
5240     fi
5241
5242     [ -f $LOGDIR/shared ] && docp=false
5243
5244     # dump lustre logs, dmesg
5245
5246     prefix="$TESTLOG_PREFIX.$TESTNAME"
5247     suffix="$ts.log"
5248     echo "Dumping lctl log to ${prefix}.*.${suffix}"
5249
5250     if [ "$CLIENTONLY" -o "$PDSH" == "no_dsh" ]; then
5251         echo "Dumping logs only on local client."
5252         $LCTL dk > ${prefix}.debug_log.$(hostname -s).${suffix}
5253         dmesg > ${prefix}.dmesg.$(hostname -s).${suffix}
5254         return
5255     fi
5256
5257     do_nodesv $list \
5258         "$LCTL dk > ${prefix}.debug_log.\\\$(hostname -s).${suffix};
5259          dmesg > ${prefix}.dmesg.\\\$(hostname -s).${suffix}"
5260     if [ ! -f $LOGDIR/shared ]; then
5261         do_nodes $list rsync -az "${prefix}.*.${suffix}" $HOSTNAME:$LOGDIR
5262     fi
5263 }
5264
5265 do_ls () {
5266     local mntpt_root=$1
5267     local num_mntpts=$2
5268     local dir=$3
5269     local i
5270     local cmd
5271     local pids
5272     local rc=0
5273
5274     for i in $(seq 0 $num_mntpts); do
5275         cmd="ls -laf ${mntpt_root}$i/$dir"
5276         echo + $cmd;
5277         $cmd > /dev/null &
5278         pids="$pids $!"
5279     done
5280     echo pids=$pids
5281     for pid in $pids; do
5282         wait $pid || rc=$?
5283     done
5284
5285     return $rc
5286 }
5287
5288 # target_start_and_reset_recovery_timer()
5289 #        service_time = at_est2timeout(service_time);
5290 #        service_time += 2 * (CONNECTION_SWITCH_MAX + CONNECTION_SWITCH_INC +
5291 #                             INITIAL_CONNECT_TIMEOUT);
5292 # CONNECTION_SWITCH_MAX : min(25U, max(CONNECTION_SWITCH_MIN,obd_timeout))
5293 #define CONNECTION_SWITCH_INC 1
5294 #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
5295 #define CONNECTION_SWITCH_MIN 5U
5296
5297 max_recovery_time () {
5298     local init_connect_timeout=$(( TIMEOUT / 20 ))
5299     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
5300
5301     local service_time=$(( $(at_max_get client) + $(( 2 * $(( 25 + 1  + init_connect_timeout)) )) ))
5302
5303     echo $service_time 
5304 }
5305
5306 get_clients_mount_count () {
5307     local clients=${CLIENTS:-`hostname`}
5308
5309     # we need to take into account the clients mounts and
5310     # exclude mds/ost mounts if any;
5311     do_nodes $clients cat /proc/mounts | grep lustre | grep $MOUNT | wc -l
5312 }
5313
5314 # gss functions
5315 PROC_CLI="srpc_info"
5316
5317 combination()
5318 {
5319     local M=$1
5320     local N=$2
5321     local R=1
5322
5323     if [ $M -lt $N ]; then
5324         R=0
5325     else
5326         N=$((N + 1))
5327         while [ $N -lt $M ]; do
5328             R=$((R * N))
5329             N=$((N + 1))
5330         done
5331     fi
5332
5333     echo $R
5334     return 0
5335 }
5336
5337 calc_connection_cnt() {
5338     local dir=$1
5339
5340     # MDT->MDT = 2 * C(M, 2)
5341     # MDT->OST = M * O
5342     # CLI->OST = C * O
5343     # CLI->MDT = C * M
5344     comb_m2=$(combination $MDSCOUNT 2)
5345
5346     local num_clients=$(get_clients_mount_count)
5347
5348     local cnt_mdt2mdt=$((comb_m2 * 2))
5349     local cnt_mdt2ost=$((MDSCOUNT * OSTCOUNT))
5350     local cnt_cli2ost=$((num_clients * OSTCOUNT))
5351     local cnt_cli2mdt=$((num_clients * MDSCOUNT))
5352     local cnt_all2ost=$((cnt_mdt2ost + cnt_cli2ost))
5353     local cnt_all2mdt=$((cnt_mdt2mdt + cnt_cli2mdt))
5354     local cnt_all2all=$((cnt_mdt2ost + cnt_mdt2mdt + cnt_cli2ost + cnt_cli2mdt))
5355
5356     local var=cnt_$dir
5357     local res=${!var}
5358
5359     echo $res
5360 }
5361
5362 set_rule()
5363 {
5364     local tgt=$1
5365     local net=$2
5366     local dir=$3
5367     local flavor=$4
5368     local cmd="$tgt.srpc.flavor"
5369
5370     if [ $net == "any" ]; then
5371         net="default"
5372     fi
5373     cmd="$cmd.$net"
5374
5375     if [ $dir != "any" ]; then
5376         cmd="$cmd.$dir"
5377     fi
5378
5379     cmd="$cmd=$flavor"
5380     log "Setting sptlrpc rule: $cmd"
5381     do_facet mgs "$LCTL conf_param $cmd"
5382 }
5383
5384 count_flvr()
5385 {
5386     local output=$1
5387     local flavor=$2
5388     local count=0
5389
5390     rpc_flvr=`echo $flavor | awk -F - '{ print $1 }'`
5391     bulkspec=`echo $flavor | awk -F - '{ print $2 }'`
5392
5393     count=`echo "$output" | grep "rpc flavor" | grep $rpc_flvr | wc -l`
5394
5395     if [ "x$bulkspec" != "x" ]; then
5396         algs=`echo $bulkspec | awk -F : '{ print $2 }'`
5397
5398         if [ "x$algs" != "x" ]; then
5399             bulk_count=`echo "$output" | grep "bulk flavor" | grep $algs | wc -l`
5400         else
5401             bulk=`echo $bulkspec | awk -F : '{ print $1 }'`
5402             if [ $bulk == "bulkn" ]; then
5403                 bulk_count=`echo "$output" | grep "bulk flavor" \
5404                             | grep "null/null" | wc -l`
5405             elif [ $bulk == "bulki" ]; then
5406                 bulk_count=`echo "$output" | grep "bulk flavor" \
5407                             | grep "/null" | grep -v "null/" | wc -l`
5408             else
5409                 bulk_count=`echo "$output" | grep "bulk flavor" \
5410                             | grep -v "/null" | grep -v "null/" | wc -l`
5411             fi
5412         fi
5413
5414         [ $bulk_count -lt $count ] && count=$bulk_count
5415     fi
5416
5417     echo $count
5418 }
5419
5420 flvr_cnt_cli2mdt()
5421 {
5422     local flavor=$1
5423     local cnt
5424
5425     local clients=${CLIENTS:-`hostname`}
5426
5427     for c in ${clients//,/ }; do
5428         output=`do_node $c lctl get_param -n mdc.*-MDT*-mdc-*.$PROC_CLI 2>/dev/null`
5429         tmpcnt=`count_flvr "$output" $flavor`
5430         cnt=$((cnt + tmpcnt))
5431     done
5432     echo $cnt
5433 }
5434
5435 flvr_cnt_cli2ost()
5436 {
5437     local flavor=$1
5438     local cnt
5439
5440     local clients=${CLIENTS:-`hostname`}
5441
5442     for c in ${clients//,/ }; do
5443         output=`do_node $c lctl get_param -n osc.*OST*-osc-[^M][^D][^T]*.$PROC_CLI 2>/dev/null`
5444         tmpcnt=`count_flvr "$output" $flavor`
5445         cnt=$((cnt + tmpcnt))
5446     done
5447     echo $cnt
5448 }
5449
5450 flvr_cnt_mdt2mdt()
5451 {
5452     local flavor=$1
5453     local cnt=0
5454
5455     if [ $MDSCOUNT -le 1 ]; then
5456         echo 0
5457         return
5458     fi
5459
5460     for num in `seq $MDSCOUNT`; do
5461         output=`do_facet mds$num lctl get_param -n mdc.*-MDT*-mdc[0-9]*.$PROC_CLI 2>/dev/null`
5462         tmpcnt=`count_flvr "$output" $flavor`
5463         cnt=$((cnt + tmpcnt))
5464     done
5465     echo $cnt;
5466 }
5467
5468 flvr_cnt_mdt2ost()
5469 {
5470     local flavor=$1
5471     local cnt=0
5472     local mdtosc
5473
5474     for num in `seq $MDSCOUNT`; do
5475         mdtosc=$(get_mdtosc_proc_path mds$num)
5476         mdtosc=${mdtosc/-MDT*/-MDT\*}
5477         output=$(do_facet mds$num lctl get_param -n \
5478             osc.$mdtosc.$PROC_CLI 2>/dev/null)
5479         tmpcnt=`count_flvr "$output" $flavor`
5480         cnt=$((cnt + tmpcnt))
5481     done
5482     echo $cnt;
5483 }
5484
5485 flvr_cnt_mgc2mgs()
5486 {
5487     local flavor=$1
5488
5489     output=`do_facet client lctl get_param -n mgc.*.$PROC_CLI 2>/dev/null`
5490     count_flvr "$output" $flavor
5491 }
5492
5493 do_check_flavor()
5494 {
5495     local dir=$1        # from to
5496     local flavor=$2     # flavor expected
5497     local res=0
5498
5499     if [ $dir == "cli2mdt" ]; then
5500         res=`flvr_cnt_cli2mdt $flavor`
5501     elif [ $dir == "cli2ost" ]; then
5502         res=`flvr_cnt_cli2ost $flavor`
5503     elif [ $dir == "mdt2mdt" ]; then
5504         res=`flvr_cnt_mdt2mdt $flavor`
5505     elif [ $dir == "mdt2ost" ]; then
5506         res=`flvr_cnt_mdt2ost $flavor`
5507     elif [ $dir == "all2ost" ]; then
5508         res1=`flvr_cnt_mdt2ost $flavor`
5509         res2=`flvr_cnt_cli2ost $flavor`
5510         res=$((res1 + res2))
5511     elif [ $dir == "all2mdt" ]; then
5512         res1=`flvr_cnt_mdt2mdt $flavor`
5513         res2=`flvr_cnt_cli2mdt $flavor`
5514         res=$((res1 + res2))
5515     elif [ $dir == "all2all" ]; then
5516         res1=`flvr_cnt_mdt2ost $flavor`
5517         res2=`flvr_cnt_cli2ost $flavor`
5518         res3=`flvr_cnt_mdt2mdt $flavor`
5519         res4=`flvr_cnt_cli2mdt $flavor`
5520         res=$((res1 + res2 + res3 + res4))
5521     fi
5522
5523     echo $res
5524 }
5525
5526 wait_flavor()
5527 {
5528     local dir=$1        # from to
5529     local flavor=$2     # flavor expected
5530     local expect=${3:-$(calc_connection_cnt $dir)}     # number expected
5531
5532     local res=0
5533
5534     for ((i=0;i<20;i++)); do
5535         echo -n "checking $dir..."
5536         res=$(do_check_flavor $dir $flavor)
5537         echo "found $res/$expect $flavor connections"
5538         [ $res -ge $expect ] && return 0
5539         sleep 4
5540     done
5541
5542     echo "Error checking $flavor of $dir: expect $expect, actual $res"
5543     return 1
5544 }
5545
5546 restore_to_default_flavor()
5547 {
5548     local proc="mgs.MGS.live.$FSNAME"
5549
5550     echo "restoring to default flavor..."
5551
5552     nrule=`do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor." | wc -l`
5553
5554     # remove all existing rules if any
5555     if [ $nrule -ne 0 ]; then
5556         echo "$nrule existing rules"
5557         for rule in `do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor."`; do
5558             echo "remove rule: $rule"
5559             spec=`echo $rule | awk -F = '{print $1}'`
5560             do_facet mgs "$LCTL conf_param -d $spec"
5561         done
5562     fi
5563
5564     # verify no rules left
5565     nrule=`do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor." | wc -l`
5566     [ $nrule -ne 0 ] && error "still $nrule rules left"
5567
5568     # wait for default flavor to be applied
5569     # currently default flavor for all connections are 'null'
5570     wait_flavor all2all null
5571     echo "now at default flavor settings"
5572 }
5573
5574 set_flavor_all()
5575 {
5576     local flavor=${1:-null}
5577
5578     echo "setting all flavor to $flavor"
5579
5580     # FIXME need parameter to this fn
5581     # and remove global vars
5582     local cnt_all2all=$(calc_connection_cnt all2all)
5583
5584     local res=$(do_check_flavor all2all $flavor)
5585     if [ $res -eq $cnt_all2all ]; then
5586         echo "already have total $res $flavor connections"
5587         return
5588     fi
5589
5590     echo "found $res $flavor out of total $cnt_all2all connections"
5591     restore_to_default_flavor
5592
5593     [[ $flavor = null ]] && return 0
5594
5595     set_rule $FSNAME any any $flavor
5596     wait_flavor all2all $flavor
5597 }
5598
5599
5600 check_logdir() {
5601     local dir=$1
5602     # Checking for shared logdir
5603     if [ ! -d $dir ]; then
5604         # Not found. Create local logdir
5605         mkdir -p $dir
5606     else
5607         touch $dir/check_file.$(hostname -s)
5608     fi
5609     return 0
5610 }
5611
5612 check_write_access() {
5613     local dir=$1
5614     local node
5615     local file
5616
5617     for node in $(nodes_list); do
5618         file=$dir/check_file.$(short_hostname $node)
5619         if [[ ! -f "$file" ]]; then
5620             # Logdir not accessible/writable from this node.
5621             return 1
5622         fi
5623         rm -f $file || return 1
5624     done
5625     return 0
5626 }
5627
5628 init_logging() {
5629     if [[ -n $YAML_LOG ]]; then
5630         return
5631     fi
5632     local SAVE_UMASK=`umask`
5633     umask 0000
5634
5635     export YAML_LOG=${LOGDIR}/results.yml
5636     mkdir -p $LOGDIR
5637     init_clients_lists
5638
5639     if [ ! -f $YAML_LOG ]; then       # If the yaml log already exists then we will just append to it
5640       if check_shared_dir $LOGDIR; then
5641           touch $LOGDIR/shared
5642           echo "Logging to shared log directory: $LOGDIR"
5643       else
5644           echo "Logging to local directory: $LOGDIR"
5645       fi
5646
5647       yml_nodes_file $LOGDIR >> $YAML_LOG
5648       yml_results_file >> $YAML_LOG
5649     fi
5650
5651     umask $SAVE_UMASK
5652 }
5653
5654 log_test() {
5655     yml_log_test $1 >> $YAML_LOG
5656 }
5657
5658 log_test_status() {
5659      yml_log_test_status $@ >> $YAML_LOG
5660 }
5661
5662 log_sub_test_begin() {
5663     yml_log_sub_test_begin "$@" >> $YAML_LOG
5664 }
5665
5666 log_sub_test_end() {
5667     yml_log_sub_test_end "$@" >> $YAML_LOG
5668 }
5669
5670 run_llverdev()
5671 {
5672         local dev=$1
5673         local llverdev_opts=$2
5674         local devname=$(basename $1)
5675         local size=$(grep "$devname"$ /proc/partitions | awk '{print $3}')
5676         # loop devices aren't in /proc/partitions
5677         [ "x$size" == "x" ] && local size=$(ls -l $dev | awk '{print $5}')
5678
5679         size=$(($size / 1024 / 1024)) # Gb
5680
5681         local partial_arg=""
5682         # Run in partial (fast) mode if the size
5683         # of a partition > 1 GB
5684         [ $size -gt 1 ] && partial_arg="-p"
5685
5686         llverdev --force $partial_arg $llverdev_opts $dev
5687 }
5688
5689 run_llverfs()
5690 {
5691         local dir=$1
5692         local llverfs_opts=$2
5693         local use_partial_arg=$3
5694         local partial_arg=""
5695         local size=$(df -B G $dir |tail -n 1 |awk '{print $2}' |sed 's/G//') #GB
5696
5697         # Run in partial (fast) mode if the size
5698         # of a partition > 1 GB
5699         [ "x$use_partial_arg" != "xno" ] && [ $size -gt 1 ] && partial_arg="-p"
5700
5701         llverfs $partial_arg $llverfs_opts $dir
5702 }
5703
5704 remove_mdt_files() {
5705         local facet=$1
5706         local mdtdev=$2
5707         shift 2
5708         local files="$@"
5709         local mntpt=$(facet_mntpt $facet)
5710         local opts=$MDS_MOUNT_OPTS
5711
5712         echo "removing files from $mdtdev on $facet: $files"
5713         if [ $(facet_fstype $facet) == ldiskfs ] &&
5714            ! do_facet $facet test -b $mdtdev; then
5715                 opts=$(csa_add "$opts" -o loop)
5716         fi
5717         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
5718                 return $?
5719         rc=0;
5720         for f in $files; do
5721                 rm $mntpt/ROOT/$f || { rc=$?; break; }
5722         done
5723         umount -f $mntpt || return $?
5724         return $rc
5725 }
5726
5727 duplicate_mdt_files() {
5728         local facet=$1
5729         local mdtdev=$2
5730         shift 2
5731         local files="$@"
5732         local mntpt=$(facet_mntpt $facet)
5733         local opts=$MDS_MOUNT_OPTS
5734
5735         echo "duplicating files on $mdtdev on $facet: $files"
5736         mkdir -p $mntpt || return $?
5737         if [ $(facet_fstype $facet) == ldiskfs ] &&
5738            ! do_facet $facet test -b $mdtdev; then
5739                 opts=$(csa_add "$opts" -o loop)
5740         fi
5741         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
5742                 return $?
5743
5744     do_umount() {
5745         trap 0
5746         popd > /dev/null
5747         rm $tmp
5748         umount -f $mntpt
5749     }
5750     trap do_umount EXIT
5751
5752     tmp=$(mktemp $TMP/setfattr.XXXXXXXXXX)
5753     pushd $mntpt/ROOT > /dev/null || return $?
5754     rc=0
5755     for f in $files; do
5756         touch $f.bad || return $?
5757         getfattr -n trusted.lov $f | sed "s#$f#&.bad#" > $tmp
5758         rc=${PIPESTATUS[0]}
5759         [ $rc -eq 0 ] || return $rc
5760         setfattr --restore $tmp || return $?
5761     done
5762     do_umount
5763 }
5764
5765 run_sgpdd () {
5766     local devs=${1//,/ }
5767     shift
5768     local params=$@
5769     local rslt=$TMP/sgpdd_survey
5770
5771     # sgpdd-survey cleanups ${rslt}.* files
5772
5773     local cmd="rslt=$rslt $params scsidevs=\"$devs\" $SGPDDSURVEY"
5774     echo + $cmd
5775     eval $cmd
5776     cat ${rslt}.detail
5777 }
5778
5779 # returns the canonical name for an ldiskfs device
5780 ldiskfs_canon() {
5781         local dev="$1"
5782         local facet="$2"
5783
5784         do_facet $facet "dv=\\\$(lctl get_param -n $dev);
5785 if foo=\\\$(lvdisplay -c \\\$dv 2>/dev/null); then
5786     echo dm-\\\${foo##*:};
5787 else
5788     echo \\\$(basename \\\$dv);
5789 fi;"
5790 }
5791
5792 is_sanity_benchmark() {
5793     local benchmarks="dbench bonnie iozone fsx"
5794     local suite=$1
5795     for b in $benchmarks; do
5796         if [ "$b" == "$suite" ]; then
5797             return 0
5798         fi
5799     done
5800     return 1
5801 }
5802
5803 min_ost_size () {
5804     $LCTL get_param -n osc.*.kbytesavail | sort -n | head -n1
5805 }
5806
5807 # Get the block size of the filesystem.
5808 get_block_size() {
5809     local facet=$1
5810     local device=$2
5811     local size
5812
5813     size=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
5814            awk '/^Block size:/ {print $3}')
5815     echo $size
5816 }
5817
5818 # Check whether the "large_xattr" feature is enabled or not.
5819 large_xattr_enabled() {
5820         [[ $(facet_fstype $SINGLEMDS) == zfs ]] && return 0
5821
5822         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
5823
5824         do_facet $SINGLEMDS "$DUMPE2FS -h $mds_dev 2>&1 | grep -q large_xattr"
5825         return ${PIPESTATUS[0]}
5826 }
5827
5828 # Get the maximum xattr size supported by the filesystem.
5829 max_xattr_size() {
5830     local size
5831
5832     if large_xattr_enabled; then
5833         # include/linux/limits.h: #define XATTR_SIZE_MAX 65536
5834         size=65536
5835     else
5836         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
5837         local block_size=$(get_block_size $SINGLEMDS $mds_dev)
5838
5839         # maximum xattr size = size of block - size of header -
5840         #                      size of 1 entry - 4 null bytes
5841         size=$((block_size - 32 - 32 - 4))
5842     fi
5843
5844     echo $size
5845 }
5846
5847 # Dump the value of the named xattr from a file.
5848 get_xattr_value() {
5849     local xattr_name=$1
5850     local file=$2
5851
5852     echo "$(getfattr -n $xattr_name --absolute-names --only-values $file)"
5853 }
5854
5855 # Generate a string with size of $size bytes.
5856 generate_string() {
5857     local size=${1:-1024} # in bytes
5858
5859     echo "$(head -c $size < /dev/zero | tr '\0' y)"
5860 }
5861
5862 reformat_external_journal() {
5863         if [ ! -z ${EJOURNAL} ]; then
5864                 local rcmd="do_facet ${SINGLEMDS}"
5865
5866                 echo "reformat external journal on ${SINGLEMDS}:${EJOURNAL}"
5867                 ${rcmd} mke2fs -O journal_dev ${EJOURNAL} || return 1
5868         fi
5869 }
5870
5871 # MDT file-level backup/restore
5872 mds_backup_restore() {
5873         local devname=$(mdsdevname ${SINGLEMDS//mds/})
5874         local mntpt=$(facet_mntpt brpt)
5875         local rcmd="do_facet ${SINGLEMDS}"
5876         local metaea=${TMP}/backup_restore.ea
5877         local metadata=${TMP}/backup_restore.tgz
5878         local opts=${MDS_MOUNT_OPTS}
5879         local svc=${SINGLEMDS}_svc
5880
5881         if ! ${rcmd} test -b ${devname}; then
5882                 opts=$(csa_add "$opts" -o loop)
5883         fi
5884
5885         echo "file-level backup/restore on ${SINGLEMDS}:${devname}"
5886
5887         # step 1: build mount point
5888         ${rcmd} mkdir -p $mntpt
5889         # step 2: cleanup old backup
5890         ${rcmd} rm -f $metaea $metadata
5891         # step 3: mount dev
5892         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
5893         # step 4: backup metaea
5894         echo "backup EA"
5895         ${rcmd} "cd $mntpt && getfattr -R -d -m '.*' -P . > $metaea && cd -" ||
5896                 return 2
5897         # step 5: backup metadata
5898         echo "backup data"
5899         ${rcmd} tar zcf $metadata -C $mntpt/ . > /dev/null 2>&1 || return 3
5900         # step 6: umount
5901         ${rcmd} umount -d $mntpt || return 4
5902         # step 7: reformat external journal if needed
5903         reformat_external_journal || return 5
5904         # step 8: reformat dev
5905         echo "reformat new device"
5906         add ${SINGLEMDS} $(mkfs_opts ${SINGLEMDS}) --backfstype ldiskfs \
5907                 --reformat $devname > /dev/null || return 6
5908         # step 9: mount dev
5909         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 7
5910         # step 10: restore metadata
5911         echo "restore data"
5912         ${rcmd} tar zxfp $metadata -C $mntpt > /dev/null 2>&1 || return 8
5913         # step 11: restore metaea
5914         echo "restore EA"
5915         ${rcmd} "cd $mntpt && setfattr --restore=$metaea && cd - " || return 9
5916         # step 12: remove recovery logs
5917         echo "remove recovery logs"
5918         ${rcmd} rm -fv $mntpt/OBJECTS/* $mntpt/CATALOGS
5919         # step 13: umount dev
5920         ${rcmd} umount -d $mntpt || return 10
5921         # step 14: cleanup tmp backup
5922         ${rcmd} rm -f $metaea $metadata
5923         # step 15: reset device label - it's not virgin on
5924         ${rcmd} e2label $devname ${!svc}
5925 }
5926
5927 # remove OI files
5928 mds_remove_ois() {
5929         local devname=$(mdsdevname ${SINGLEMDS//mds/})
5930         local mntpt=$(facet_mntpt brpt)
5931         local rcmd="do_facet ${SINGLEMDS}"
5932         local idx=$1
5933         local opts=${MDS_MOUNT_OPTS}
5934
5935         if ! ${rcmd} test -b ${devname}; then
5936                 opts=$(csa_add "$opts" -o loop)
5937         fi
5938
5939         echo "remove OI files: idx=${idx}"
5940
5941         # step 1: build mount point
5942         ${rcmd} mkdir -p $mntpt
5943         # step 2: mount dev
5944         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
5945         if [ -z $idx ]; then
5946                 # step 3: remove all OI files
5947                 ${rcmd} rm -fv $mntpt/oi.16*
5948         elif [ $idx -lt 2 ]; then
5949                 ${rcmd} rm -fv $mntpt/oi.16.${idx}
5950         else
5951                 local i
5952
5953                 # others, rm oi.16.[idx, idx * idx, idx ** ...]
5954                 for ((i=${idx}; i<64; i=$((i * idx)))); do
5955                         ${rcmd} rm -fv $mntpt/oi.16.${i}
5956                 done
5957         fi
5958         # step 4: umount
5959         ${rcmd} umount -d $mntpt || return 2
5960         # OI files will be recreated when mounted as lustre next time.
5961 }
5962
5963 # generate maloo upload-able log file name
5964 # \param logname specify unique part of file name
5965 generate_logname() {
5966         local logname=${1:-"default_logname"}
5967
5968         echo "$TESTLOG_PREFIX.$TESTNAME.$logname.$(hostname -s).log"
5969 }
5970
5971 # mkdir directory on different MDTs
5972 test_mkdir() {
5973         local option
5974         local parent
5975         local child
5976         local path
5977         local dir
5978         local rc=0
5979
5980         if [ $# -eq 2 ]; then
5981                 option=$1
5982                 path=$2
5983         else
5984                 path=$1
5985         fi
5986
5987         child=${path##*/}
5988         parent=${path%/*}
5989
5990         if [ "$parent" == "$child" ]; then
5991                 parent=$(pwd)
5992         fi
5993
5994         if [ "$option" == "-p" -a -d ${parent}/${child} ]; then
5995                 return $rc
5996         fi
5997
5998         # it needs to check whether there is further / in child
5999         dir=$(echo $child | awk -F '/' '{print $2}')
6000         if [ ! -z "$dir" ]; then
6001                 local subparent=$(echo $child | awk -F '/' '{ print $1 }')
6002                 parent=${parent}"/"${subparent}
6003                 child=$dir
6004         fi
6005
6006         if [ ! -d ${parent} ]; then
6007                 if [ "$option" == "-p" ]; then
6008                         mkdir -p ${parent}
6009                 else
6010                         return 1
6011                 fi
6012         fi
6013
6014         if [ $MDSCOUNT -le 1 ]; then
6015                 mkdir $option ${parent}/${child} || rc=$?
6016         else
6017                 local mdt_idx=$($LFS getstripe -M $parent)
6018
6019                 if [ "$mdt_idx" -ne 0 ]; then
6020                         mkdir $option ${parent}/${child} || rc=$?
6021                         return $rc
6022                 fi
6023
6024                 local test_num=$(echo $testnum | sed -e 's/[^0-9]*//g')
6025                 local mdt_idx=$((test_num % MDSCOUNT))
6026                 echo "mkdir $mdt_idx for ${parent}/${child}"
6027                 $LFS setdirstripe -i $mdt_idx ${parent}/${child} || rc=$?
6028         fi
6029         return $rc
6030 }