Whamcloud - gitweb
- More lctl-related common.sh fixes
[fs/lustre-release.git] / lustre / tests / common.sh
1 #!/bin/sh
2 export PATH=$PATH:/sbin:/usr/sbin
3
4 [ -d /r ] && R=/r
5
6 # check if running in source directory
7 # will probably need to create variable for each module.
8 if [ -f $SRCDIR/Makefile.am ]; then
9         USEDEV=yes
10         PORTALS=$SRCDIR/../../portals
11         LUSTRE=$SRCDIR/..
12
13         PTLCTL=$LUSTRE/utils/lctl
14         DBGCTL=$LUSTRE/utils/lctl
15         ACCEPTOR=$PORTALS/linux/utils/acceptor
16
17         OBDCTL=$LUSTRE/utils/lctl
18 else
19         USEDEV=no
20         # should have configure set the paths here
21         BINDIR=/usr/sbin
22         PORTALS=/lib/modules
23         LUSTRE=/lib/modules
24
25         PTLCTL=$BINDIR/lctl
26         DBGCTL=$BINDIR/lctl
27         ACCEPTOR=$BINDIR/acceptor
28         OBDCTL=$BINDIR/lctl
29 fi
30
31 LOOPNUM=0; export LOOPNUM
32 if [ -b /dev/loop0 ]; then
33         LOOP=/dev/loop
34 elif [ -b /dev/loop/0 ]; then
35         LOOP=/dev/loop/
36 else
37         echo "Cannot find /dev/loop0 or /dev/loop/0" 1>&2 && exit -1
38 fi
39
40 do_insmod() {
41         MODULE=$1
42         BASE=`echo $MODULE | sed -e "s^.*/^^" -e "s/\.o$//"`
43
44         lsmod | grep -q "\<$BASE\>" && return 0
45         [ "$MODULE" ] || fail "usage: $0 <module>"
46
47         if [ "$USEDEV" = "yes" ]; then
48                 [ -f $MODULE ] || echo "$0: module '$MODULE' not found" 1>&2
49                 insmod $MODULE
50         else
51                 modprobe $BASE
52         fi
53 }
54
55 do_rmmod() {
56         MODULE=$1
57         [ "$MODULE" ] || fail "usage: $0 <module>"
58         lsmod | grep -q $MODULE || return 0
59         rmmod $MODULE || lsmod | sed "s/^/$MODULE failed: /"
60 }
61
62 # Return the next unused loop device on stdout and in the $LOOPDEV
63 # environment variable.
64 next_loop_dev() {
65         NEXT=
66         while [ -b ${LOOP}${LOOPNUM} ]; do
67                 LOOPDEV=${LOOP}${LOOPNUM}
68                 losetup ${LOOPDEV} > /dev/null 2>&1 || NEXT=${LOOPDEV}
69                 LOOPNUM=`expr ${LOOPNUM} + 1`
70                 [ "$NEXT" ] && echo ${NEXT} && break
71         done
72 }
73
74 # Create a new filesystem.  If we are using a loopback device, we check
75 # for existing "template" filesystems instead of creating a new one,
76 # because it is _much_ faster to gunzip the empty filesystem instead of
77 # creating a new one from scratch.  Conversely, if we are creating a
78 # filesystem on a device we use mkfs, because that only writes sparsely
79 # to the device.  The empty filesystems are also highly compressed (1000:1)
80 # so they don't take too much space.
81 #
82 new_fs_usage() {
83         echo "new_fs <fstype> {device | file} [size]" 1>&2
84         exit -1
85 }
86 new_fs () {
87         EFILE="$1_$3.gz"
88         MKFS="mkfs.$1"
89         MKFSOPT="-b 4096"
90
91         [ "$1" = "ext3" ] && MKFS="mkfs.ext2 -j"
92         if [ "$1" = "extN" ]; then
93                 MKFS="mkfs.ext2 -j"
94                 EFILE="ext3_$3.gz"
95         fi
96
97         if [ -b "$2" ]; then
98                 [ $# -lt 2 -o $# -gt 3 ] && new_fs_usage
99
100                 PM="/proc/mounts"
101                 [ -r "$PM" ] || PM="/etc/mtab"
102
103                 grep "$2 " $PM 1>&2 && echo "$0: $2 is in $PM!" 1>&2 && exit -1
104
105                 $MKFS $MKFSOPT $2 $3 || exit -1
106                 LOOPDEV=$2      # Not really a loop device
107         else
108                 [ $# -ne 3 ] && new_fs_usage
109
110                 if [ -r "$EFILE" ]; then
111                         echo "using prepared filesystem $EFILE for $2"
112                         zcat "$EFILE" > $2 || exit -1
113                         sync
114                 else
115                         echo "creating new sparse filesystem on $2"
116                         dd if=/dev/zero of=$2 bs=1k seek=$3 count=1 1>&2 || exit -1
117                         $MKFS $MKFSOPT -F $2 1>&2 || exit -1
118                 fi
119                 LOOPDEV=`next_loop_dev`
120                 losetup ${LOOPDEV} $2 1>&2 || exit -1
121         fi
122
123         # Enable hash-indexed directories for extN filesystems
124         [ "$1" = "extN" ] && echo "feature FEATURE_C5" | debugfs -w $2
125 }
126
127 # Set up to use an existing filesystem.  We take the same parameters as
128 # new_fs, even though we only use the <fstype> and <file> parameters, to
129 # make it easy to convert between new_fs and old_fs in testing scripts.
130 old_fs () {
131         [ -e $2 ] || exit -1
132
133         if [ -b "$2" ]; then
134                 LOOPDEV=$2      # Not really a loop device
135         else
136                 LOOPDEV=`next_loop_dev`
137                 losetup ${LOOPDEV} $2 1>&2 || exit -1
138         fi
139 }
140
141 list_mods() {
142         $DBGCTL modules > $R/tmp/ogdb
143         echo "The GDB module script is in $R/tmp/ogdb"
144         [ "$DEBUG_WAIT" = "yes" ] && echo -n "Press ENTER to continue" && read < /dev/tty
145         return 0
146 }
147
148 # start acceptor for a given network and port.
149 # not all networks need an acceptor
150 start_acceptor() {
151         case $NETWORK in
152         elan)   [ "$PORT" ] && fail "$0: NETWORK is elan but PORT is set"
153                 ;;
154         tcp)    [ "$PORT" ] || fail "$0: NETWORK is tcp but PORT is not set"
155                 $ACCEPTOR $PORT
156                 ;;
157         *)      fail "$0: unknown NETWORK '$NETWORK'" ;;
158         esac
159
160 }
161
162 # We need at least one setup file to be given.  It can be passed on
163 # the command-line, or it can be found in the home directory, or it
164 # can even be sourced into the current shell environment.
165 setup_opts() {
166         DEF=/etc/lustre/lustre.cfg
167         if [ "$#" = 0 -a -r $DEF ]; then
168                 . $DEF && SETUP=y
169         fi
170
171         for CFG in "$@" ; do
172                 case $CFG  in
173                 *.cfg) [ -r "$CFG" ] && . $CFG && SETUP=y ;;
174                 *) echo "unknown option '$CFG'" 1>&2
175                 esac
176         done
177
178         if [ "$SETUP" != "y" ]; then
179                 echo "error: no config file on command-line and no $DEF" 1>&2
180                 exit -1
181         fi
182         
183         [ -z "$MDS_RSH" ] && MDS_RSH="eval"
184         [ -z "$OST_RSH" ] && OST_RSH="eval"
185         [ -z "$OSC_RSH" ] && OSC_RSH="eval"
186 }
187
188 setup_variables() {
189         [ -z "$OSTNODE" ] && OSTNODE=$SERVER
190         [ -z "$MDSNODE" ] && MDSNODE=$SERVER
191         [ -z "$DLM" ] && DLM=$SERVER
192 }
193
194 setup_portals() {
195         setup_variables
196
197         if egrep -q "ksocknal|kqswnal" /proc/modules; then
198                 echo "$0: portals already appears to be set up, skipping"
199                 return 0
200         fi
201
202         if [ -z "$NETWORK" -o -z "$LOCALHOST" ]; then
203                 echo "$0: NETWORK or LOCALHOST is not set" 1>&2
204                 exit -1
205         fi
206
207         if [ -z "$OSTNODE" -o -z "$MDSNODE" -o -z "$DLM" ]; then
208                 echo "$0: SERVER (or OSTNODE and MDSNODE and DLM) not set" 1>&2
209                 exit -1
210         fi
211
212         [ -c /dev/portals ] || mknod /dev/portals c 10 240
213
214         do_insmod $PORTALS/linux/oslib/portals.o || exit -1
215         #do_insmod $PORTALS/linux/router/kptlrouter.o || exit -1
216
217         case $NETWORK in
218         elan)  do_insmod $PORTALS/linux/rqswnal/kqswnal.o || exit -1
219                     ;;
220         tcp)   do_insmod $PORTALS/linux/socknal/ksocknal.o || exit -1
221                    ;;
222         *)      fail "$0: unknown NETWORK '$NETWORK'" ;;
223         esac
224
225         start_acceptor
226
227         $PTLCTL <<- EOF
228         network $NETWORK
229         mynid $LOCALHOST
230         connect $MDSNODE $PORT
231         add_uuid $MDSNODE $MDSNODE
232         connect $OSTNODE $PORT
233         add_uuid $OSTNODE $OSTNODE
234         connect $DLM $PORT
235         add_uuid $DLM $DLM
236         add_uuid self $LOCALHOST
237         quit
238 EOF
239 }
240
241 setup_lustre() {
242         [ -c /dev/obd ] || mknod /dev/obd c 10 241
243
244         do_insmod $LUSTRE/obdclass/obdclass.o || exit -1
245         do_insmod $LUSTRE/ptlrpc/ptlrpc.o || exit -1
246         do_insmod $LUSTRE/ldlm/ldlm.o || exit -1
247         do_insmod $LUSTRE/extN/extN.o || \
248                 echo "info: can't load extN.o module, not fatal if using ext3"
249         do_insmod $LUSTRE/mds/mds.o || exit -1
250         #do_insmod $LUSTRE/mds/mds_ext2.o || exit -1
251         #do_insmod $LUSTRE/mds/mds_ext3.o || exit -1
252         do_insmod $LUSTRE/mds/mds_extN.o || \
253                 echo "info: can't load mds_extN.o module, needs extN.o"
254         do_insmod $LUSTRE/obdecho/obdecho.o || exit -1
255         #do_insmod $LUSTRE/obdext2/obdext2.o || exit -1
256         do_insmod $LUSTRE/obdfilter/obdfilter.o || exit -1
257         do_insmod $LUSTRE/ost/ost.o || exit -1
258         do_insmod $LUSTRE/osc/osc.o || exit -1
259         do_insmod $LUSTRE/mdc/mdc.o || exit -1
260                 do_insmod $LUSTRE/lov/lov.o || exit -1
261         do_insmod $LUSTRE/llite/llite.o || exit -1
262
263         echo "$R/tmp/lustre-log" > /proc/sys/portals/debug_path
264
265         if $OBDCTL name2dev RPCDEV > /dev/null 2>&1; then
266                 echo "$0: RPCDEV is already configured, skipping"
267                 return 0
268         fi
269         list_mods
270
271         $OBDCTL <<- EOF || return $?
272         newdev
273         attach ptlrpc RPCDEV
274         setup
275         quit
276         EOF
277
278         [ -d /mnt/lustre ] || mkdir /mnt/lustre
279 }
280
281 setup_ldlm() {
282         [ "$SETUP_LDLM" = "y" ] || return 0
283
284         [ -c /dev/portals ] || mknod /dev/portals c 10 240
285
286         $OBDCTL <<- EOF || return $?
287         newdev
288         attach ldlm LDLMDEV
289         setup
290         quit
291         EOF
292 }
293
294 find_devno() {
295         if [ -z "$1" ]; then
296                 echo "usage: $0 <devname>" 1>&2
297                 return -1
298         fi
299
300         $OBDCTL name2dev $1
301 }
302
303 setup_mds() {
304         [ "$SETUP_MDS" = "y" ] || return 0
305
306         if [ -z "$MDSFS" -o -z "$MDSDEV" ]; then
307                 echo "error: setup_mds: MDSFS or MDSDEV unset" 1>&2
308                 return -1
309         fi
310
311         [ "$1" ] && DO_FS=$1
312         if [ "$DO_FS" != "new_fs" -a "$DO_FS" != "old_fs" ]; then
313                 echo "usage: setup_mds {new_fs|old_fs}" 1>&2
314                 return -1
315         fi
316
317         if $OBDCTL name2dev MDSDEV > /dev/null 2>&1; then
318                 echo "$0: MDSDEV is already configured"
319                 return 0
320         fi
321
322         $DO_FS ${MDSFS} ${MDSDEV} ${MDSSIZE}
323         MDS=${LOOPDEV}
324
325         $OBDCTL <<- EOF || return $?
326         newdev
327         attach mds MDSDEV MDSUUID  
328         setup ${MDS} ${MDSFS}
329         quit
330         EOF
331 }
332
333 setup_mds_lov() { 
334
335         [ "$SETUP_MDS" = "y" ] || return 0
336
337         if [ -z "$LOVUUID" ]; then
338                 echo "No LOV configured"
339                         return
340         fi
341
342         $OBDCTL <<- EOF || return $?
343         name2dev MDSDEV
344         connect 
345         lovconfig ${LOVUUID} 1 4096 0 OSCUUID
346         disconnect
347         quit
348         EOF
349 }
350
351
352 setup_ost() {
353         [ "$SETUP_OST" = "y" ] || return 0
354
355         if [ -z "$OSTTYPE" ]; then
356                 echo "error: setup_ost: OSTTYPE unset" 1>&2
357                 return -1
358         fi
359
360         case $OSTTYPE in
361         obdecho)        OBD=
362                         OBDARG=
363                         NEED_FS=n
364                 ;;
365         obdext2)        OBDARG=
366                         NEED_FS=y
367                 ;;
368         obdfilter)      OBDARG=$OSTFS
369                         NEED_FS=y
370                 ;;
371         *)      echo "error: setup_ost: unknown OSTTYPE '$OSTTYPE'" 1>&2
372                 return -1
373                 ;;
374         esac
375
376         if $OBDCTL name2dev OBDDEV > /dev/null 2>&1; then
377                 echo "$0: OBDDEV is already configured"
378                 return 0
379         fi
380
381         if [ "$NEED_FS" = "y" ]; then
382                 [ "$1" ] && DO_FS=$1
383                 if [ -z "$OSTFS" -o -z "$OSTDEV" ]; then
384                         echo "error: setup_ost: OSTFS or OSTDEV unset" 1>&2
385                         return -1
386                 fi
387
388                 if [ "$DO_FS" != "new_fs" -a "$DO_FS" != "old_fs" ]; then
389                         echo "usage: setup_ost {new_fs|old_fs}" 1>&2
390                         return -1
391                 fi
392
393                 $DO_FS ${OSTFS} ${OSTDEV} ${OSTSIZE}
394                 OBD=${LOOPDEV}
395         fi
396
397         $OBDCTL <<- EOF || return $?
398         newdev
399         attach ${OSTTYPE} OBDDEV OBDUUID
400         setup ${OBD} ${OBDARG}
401         quit
402         EOF
403
404         $OBDCTL <<- EOF || return $?
405         newdev
406         attach ost OSTDEV OSTUUID
407         setup OBDUUID
408         quit
409         EOF
410 }
411
412 setup_server() {
413         #setup_mds $1 && setup_mds_lov $1 && setup_ost $1
414         setup_mds $1 && setup_ost $1
415 }
416
417 setup_osc() {
418         set -vx
419         [ "$SETUP_OSC" != "y" ] && return 0
420         [ "$OSC_NAMES" ] || OSC_NAMES=OSCDEV
421
422         for THEOSC in $OSC_NAMES ; do 
423                 if $OBDCTL name2dev $THEOSC > /dev/null 2>&1; then
424                         echo "$0: OSCDEV is already configured"
425                         continue
426                 fi
427
428                 $OBDCTL <<- EOF || return $rc
429                 newdev
430                 attach osc $THEOSC ${THEOSC}-UUID
431                 setup OBDUUID $OSTNODE
432                 quit
433                 EOF
434         done
435 }
436
437 setup_mdc() {
438         set -vx
439         [ "$SETUP_MDC" != "y" ] && return 0
440         [ "$MDC_NAMES" ] || MDC_NAMES=MDCDEV
441
442         for THEMDC in $MDC_NAMES ; do 
443                 if $OBDCTL name2dev $THEMDC > /dev/null 2>&1; then
444                         echo "$0: MDCDEV is already configured"
445                         continue
446                 fi
447
448                 $OBDCTL <<- EOF || return $?
449                 newdev
450                 attach mdc $THEMDC ${THEMDC}-UUID
451                 setup MDSUUID $MDSNODE
452                 quit
453                 EOF
454         done
455 }
456
457 setup_lov () { 
458         [ "$SETUP_MDC" != "y" ] && return 0
459
460         if [ -z "$LOVUUID" ]; then
461                 echo "No LOV configured"
462                 return
463         fi
464
465         $OBDCTL <<- EOF || return $?
466         newdev
467         attach lov LOVNAME  ${LOVUUID}
468         setup MDCDEV-UUID
469         quit
470         EOF
471 }        
472
473
474 setup_mount() {
475         set -vx
476         [ "$SETUP_MOUNT" != "y" ] && return 0
477         [ "$MDC_NAMES" ] || MDC_NAMES=MDCDEV
478         [ "$OSC_NAMES" ] || OSC_NAMES=OSCDEV
479         [ -z "$MOUNT_LIST" -a "$OSCMT" ] && MOUNT_LIST="MT" && MT="$OSCMT OSCDEV MDCDEV"
480
481         [ "$MOUNT_LIST" ] || fail "error: $0: MOUNT_LIST unset"
482
483         for THEMOUNT in $MOUNT_LIST; do
484             eval "echo \$$THEMOUNT" | while read MTPT THEOSC THEMDC; do
485                 if mount | grep -q $MTPT; then
486                     echo "$0: $MTPT is already mounted"
487                     return 0
488                 fi
489
490                 [ ! -d $MTPT ] && mkdir $MTPT
491                 echo mount -t lustre_lite -o osc=${THEOSC}-UUID,mdc=${THEMDC}-UUID none $MTPT
492                 mount -t lustre_lite -o osc=${THEOSC}-UUID,mdc=${THEMDC}-UUID none $MTPT
493             done
494         done
495 }
496
497 setup_client() {
498         # setup_osc && setup_mdc && setup_lov  && setup_mount
499         setup_osc && setup_mdc && setup_mount
500 }
501
502 DEBUG_ON="echo 0xffffffff > /proc/sys/portals/debug"
503 DEBUG_OFF="echo 0 > /proc/sys/portals/debug"
504
505 debug_server_off() {
506         [ "$MDS_RSH" ] && echo "Turn OFF debug on MDS" && $MDS_RSH "$DEBUG_OFF"
507         [ "$OST_RSH" ] && echo "Turn OFF debug on OST" && $OST_RSH "$DEBUG_OFF"
508 }
509
510 debug_server_on() {
511         [ "$MDS_RSH" ] && echo "Turn ON debug on MDS" && $MDS_RSH "$DEBUG_ON"
512         [ "$OST_RSH" ] && echo "Turn ON debug on OST" && $OST_RSH "$DEBUG_ON"
513 }
514
515 debug_client_off() {
516         echo "Turning OFF debug on client" && $OSC_RSH "$DEBUG_OFF"
517 }
518
519 debug_client_on() {
520         echo "Turning ON debug on client" && $OSC_RSH "$DEBUG_ON"
521 }
522
523 cleanup_portals() {
524         [ -z "$NETWORK" ] && NETWORK=tcp
525
526         setup_variables
527
528         $PTLCTL <<- EOF
529         network $NETWORK
530         disconnect
531         del_uuid self
532         del_uuid $MDSNODE
533         del_uuid $OSTNODE
534         del_uuid $DLM
535         quit
536         EOF
537
538         do_rmmod ldlm
539         do_rmmod ptlrpc
540         do_rmmod obdclass
541
542         #do_rmmod kqswnal
543         do_rmmod ksocknal
544         do_rmmod kptlrouter
545
546         [ -z "$TIME" ] || $DBGCTL debug_kernel /tmp/debug.3.$TIME
547
548         do_rmmod portals
549 }
550
551 cleanup_lustre() {
552         killall acceptor
553
554         do_rmmod llite
555         do_rmmod lov
556         do_rmmod mdc
557         do_rmmod osc
558
559         do_rmmod mds_extN
560         do_rmmod mds_ext3
561         do_rmmod mds_ext2
562         do_rmmod mds
563         do_rmmod ost
564         do_rmmod obdecho
565         do_rmmod obdfilter
566         do_rmmod obdext2
567         do_rmmod extN
568
569         losetup -d ${LOOP}0
570         losetup -d ${LOOP}1
571         losetup -d ${LOOP}2
572 }
573
574 cleanup_ldlm() {
575         [ "$SETUP" -a -z "$SETUP_LDLM" ] && return 0
576
577         LDLMDEVNO=`find_devno LDLMDEV`
578         if [ "$LDLMDEVNO" ]; then
579                 $OBDCTL <<- EOF
580                 device $LDLMDEVNO
581                 cleanup
582                 detach
583                 quit
584                 EOF
585         fi
586 }
587
588 cleanup_mds() {
589         [ "$SETUP" -a -z "$SETUP_MDS" ] && return 0
590
591         MDSDEVNO=`find_devno MDSDEV`
592         if [ "$MDSDEVNO" ]; then
593                 $OBDCTL <<- EOF
594                 device $MDSDEVNO
595                 cleanup
596                 detach
597                 quit
598                 EOF
599         fi
600 }
601
602 cleanup_ost() {
603         [ "$SETUP" -a -z "$SETUP_OST" ] && return 0
604
605         OSTDEVNO=`find_devno OSTDEV`
606         if [ "$OSTDEVNO" ]; then
607                 $OBDCTL <<- EOF
608                 device $OSTDEVNO
609                 cleanup
610                 detach
611                 quit
612                 EOF
613         fi
614
615         OBDDEVNO=`find_devno OBDDEV`
616         if [ "$OBDDEVNO" ]; then
617                 $OBDCTL <<- EOF
618                 device $OBDDEVNO
619                 cleanup
620                 detach
621                 quit
622                 EOF
623         fi
624 }
625
626 cleanup_server() {
627         cleanup_ost && cleanup_mds
628 }
629
630 cleanup_mount() {
631         set -vx
632         [ "$SETUP_MOUNT" != "y" ] && return 0
633         [ "$MDC_NAMES" ] || MDC_NAMES=MDCDEV
634         [ "$OSC_NAMES" ] || OSC_NAMES=OSCDEV
635         [ -z "$MOUNT_LIST" -a "$OSCMT" ] && MOUNT_LIST="MT" && MT="$OSCMT OSCDEV MDCDEV"
636
637         [ "$MOUNT_LIST" ] || fail "error: $0: MOUNT_LIST unset"
638
639         for THEMOUNT in $MOUNT_LIST; do
640                 eval "echo \$$THEMOUNT" | while read MTPT THEOSC THEMDC; do
641                         if [ "`mount | grep $MTPT`" ]; then
642                                 umount $MTPT || fail "unable to unmount $MTPT"
643                         fi
644                 done
645         done
646 }
647
648 cleanup_osc() {
649         [ "$SETUP" -a -z "$SETUP_OSC" ] && return 0
650         [ "$OSC_NAMES" ] || OSC_NAMES=OSCDEV
651
652         for THEOSC in $OSC_NAMES ; do 
653                 OSCDEVNO=`find_devno $THEOSC`
654                 if [ "$OSCDEVNO" ]; then
655                         $OBDCTL <<- EOF
656                         device $OSCDEVNO
657                         cleanup
658                         detach
659                         quit
660                         EOF
661                 fi
662         done
663 }
664
665 cleanup_mdc() {
666         [ "$SETUP" -a -z "$SETUP_MDC" ] && return 0
667         [ "$MDC_NAMES" ] || MDC_NAMES=MDCDEV
668
669         for THEMDC in $MDC_NAMES ; do 
670                 MDCDEVNO=`find_devno $THEMDC`
671                 if [ "$MDCDEVNO" ]; then
672                         $OBDCTL <<- EOF
673                         device $MDCDEVNO
674                         cleanup
675                         detach
676                         quit
677                         EOF
678                 fi
679         done
680 }
681
682 cleanup_rpc() {
683         RPCDEVNO=`find_devno RPCDEV`
684         if [ "$RPCDEVNO" ]; then
685                 $OBDCTL <<- EOF
686                 device $RPCDEVNO
687                 cleanup
688                 detach
689                 quit
690                 EOF
691         fi
692 }
693
694 cleanup_client() {
695         cleanup_mount && cleanup_osc && cleanup_mdc && cleanup_rpc
696 }
697
698 fail() { 
699         echo "ERROR: $1" 1>&2
700         [ $2 ] && RC=$2 || RC=1
701         exit $RC
702 }