use $(LIBENSCVECTOR) instead of libensc_vector.a
[util-vserver.git] / util-vserver / scripts / functions
1 # $Id$  --*- sh -*--
2
3 # Copyright (C) 2003 Enrico Scholz <enrico.scholz@informatik.tu-chemnitz.de>
4 #  
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; version 2 of the License.
8 #  
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 # GNU General Public License for more details.
13 #  
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17
18 _VS_LOGFILE=
19 _VS_ERRFILE=
20
21 _VS_NEWLINE='
22 '
23 declare -r _VS_NEWLINE=${_VS_NEWLINE:0-1}
24
25 function findObject
26 {
27     local _fo_mod=$1
28     local _fo_var=$2
29     local _fo_file=
30     local _fo_i=X
31     shift 2
32     
33     for _fo_i; do
34         test -n "$_fo_i"         || continue
35         test ! $_fo_mod "$_fo_i" || { _fo_file=$_fo_i; break; }
36     done
37
38     test -z "$_fo_i" -o -n "$_fo_file" || {
39         echo "Can not find file for '$_fo_var'; aborting"
40         exit 1
41     } >&2
42
43     eval "$_fo_var=\"$_fo_file\""
44 }
45
46 function findFile
47 {
48     findObject -f "$@"
49 }
50
51 function findDir
52 {
53     findObject -d "$@"
54 }
55
56 function findAndCopy
57 {
58     local dst=$1
59     test ! -s "$dst"         || return 0
60     
61     local tmp
62     shift
63     findFile tmp "$@"
64
65     test -n "$tmp" -a -s "$tmp" || return 0
66     $_CP -af "$tmp" "$dst"
67 }
68
69 function getPhysicalDir
70 {
71     ( set -P && cd "$1" && pwd )
72 }
73
74 ## Usage: logging <message>
75 function logging
76 {
77     if test -n "$_VS_LOGFILE"; then
78         echo "$@" >>"$_VS_LOGFILE"
79     else
80         echo "$@"
81     fi
82 }
83
84 ## Usage: warning <message>
85 function warning
86 {
87     if test -n "$_VS_ERRFILE"; then
88         echo "$@" >>"$_VS_ERRFILE"
89     else
90         echo "$@" >&2
91     fi
92 }
93
94 ## Usage: panic <message>
95 function panic
96 {
97     if test -n "$_VS_ERRFILE"; then
98         echo "$@" >>"$_VS_ERRFILE"
99     else
100         echo "$@" >&2
101     fi
102
103     exit 1
104 }
105
106 ## Usage: execute <message>
107 function execute
108 {
109     test -z "${DEBUG_EXEC:-}"       || echo "$@"
110     test "${DEBUG_EXEC:-}" = noexec || exec "$@"
111     exit 0
112 }
113
114 ## Usage: isNumber <arg>
115 function isNumber
116 {
117     local tmp
118     let tmp=$1+0 2>/dev/null || test -z "${1//0/}" -a -n "$1" || return 1
119     return 0
120 }
121
122 ## Usage: colorize <style> <command>
123 function colorize
124 {
125     local       style=$1
126     shift
127     
128     if ! $_TTY -s; then
129         "$@"
130     else
131         local   cfile
132         findFile cfile "$__CONFDIR"/.defaults/styles/"$style" ''
133         if test -n "$cfile"; then
134           $_CAT "$cfile"
135         else
136           case "$style" in
137             (bold)      echo -ne "\e[1m";;
138             (emph)      echo -ne "\e[34m";;
139             (info)      echo -ne "\e[0;34m";;
140             (warn*)     echo -ne "\e[1;31m";;
141             (error)     echo -ne "\e[1;33;41m";;
142             (*)         ;;
143           esac
144         fi
145             
146         "$@"
147         echo -ne "\e[m"
148     fi
149 }
150
151 ## Usage: xtermTitle <title>
152 function xtermTitle
153 {
154     $_TTY -s || return 0
155     echo -ne "\e]0;$@\007"
156 }
157
158 _VS_LOCKS=''
159 ## Usage: lock <lockfile> [<timeout>]
160 function lock
161 {
162     local tmp=$($_MKTEMP /tmp/vserver-lock.XXXXXX)
163     $_RM -f $tmp
164     $_MKFIFO -m600 $tmp
165
166     $_LOCKFILE "$1" $tmp $2 &
167     $_GREP -q true $tmp 2>/dev/null || return 1
168     
169     _VS_LOCKS="$! $_VS_LOCKS"
170 }
171
172 ## Usage: unlock [<num>]
173 function unlock
174 {
175     local num=$1
176     local i
177
178     set -- $_VS_LOCKS
179     while test "$#" -gt 0; do
180         kill -HUP "$1" >/dev/null || :
181         shift
182         test "$num" != 1 || break
183         test -z "$num"   || let --num
184     done
185     _VS_LOCKS="$@"
186 }
187
188 function _pkgMountBindDir()
189 {
190     test "$1" != "$2" || return 0
191
192     $_MOUNT -n --bind "$1" "$2"
193 }
194
195 function _pkgSetVarsBase
196 {
197     case "$vserver" in
198         ./*|/*)
199             if test -d "$vserver/vdir"; then
200                 BASEDIR=$vserver
201                 VDIR=$(getPhysicalDir "$vserver/vdir")
202                 
203                 PKGDIR=$BASEDIR/apps/pkgmgmt
204                 test -d "$PKGDIR" || {
205                     echo "Can not find configuration-directory for package-managment tools"
206                     exit 1
207                 } >&2
208                 findDir EXECDIR      $PKGDIR/execdir     /
209             else
210                 VDIR=$(getPhysicalDir "$vserver")
211                 PKGDIR=
212             fi
213             ;;
214         *)
215             BASEDIR=$__CONFDIR/$vserver
216             test -d "$BASEDIR" || {
217                 echo "Can not find configuration-directory"
218                 exit 1
219             } >&2
220             
221             VDIR=$BASEDIR/vdir
222             test -d "$VDIR"   || VDIR=$__DEFAULT_VSERVERDIR/$vserver
223             VDIR=$(getPhysicalDir "$VDIR")
224             
225             PKGDIR=$BASEDIR/apps/pkgmgmt
226             test -d "$PKGDIR" || {
227                 echo "Can not find configuration-directory for package-managment tools"
228                 exit 1
229             } >&2
230
231             findDir EXECDIR      $PKGDIR/execdir     /
232
233             ;;
234     esac
235
236     if test -z "$WORKAROUND_106057"; then
237         _rpmdb_mntpoint=/dev
238     else
239         _rpmdb_mntpoint=/.rpmdb
240     fi
241 }
242
243 function _pkgSetVarsRPM
244 {
245     if test -n "$PKGDIR"; then
246         findDir RPMETCDIR    $PKGDIR/rpmetc      $PKGDIR/base/rpm/etc       /etc/rpm
247         findDir RPMSTATEDIR  $PKGDIR/rpmstate    $PKGDIR/base/rpm/state
248
249         findDir RPMLIBDIR    $PKGDIR/rpmlib      /
250
251     else
252         findDir RPMETCDIR    "$VDIR"/etc/rpm     /etc/rpm
253         findDir RPMSTATEDIR  "$VDIR"/var/lib/rpm
254         RPMLIBDIR=/
255     fi
256     
257     RPMSTATEDIR=$(getPhysicalDir "$RPMSTATEDIR")
258     RPMETCDIR=$(getPhysicalDir "$RPMETCDIR")
259 }
260
261 function _pkgSetVarsApt
262 {
263     if test -n "$PKGDIR"; then
264         findDir APTETCDIR    $PKGDIR/aptetc      $PKGDIR/base/apt/etc       /etc/apt
265         findDir APTSTATEDIR  $PKGDIR/aptstate    $PKGDIR/base/apt/state
266         findDir APTCACHEDIR  $PKGDIR/aptcache    $PKGDIR/base/apt/cache
267         findDir APTARCHIVDIR $PKGDIR/aptarchives $PKGDIR/base/apt/archives  /var/cache/apt/archives
268     else
269         findDir APTETCDIR    "$VDIR"/etc/apt            /etc/apt
270         findDir APTSTATEDIR  "$VDIR"/var/state/apt
271         findDir APTCACHEDIR  "$VDIR"/var/cache/apt
272         findDir APTARCHIVDIR "$VDIR"/var/cache/apt/archives /var/cache/apt/archives
273     fi
274
275     findFile APT_CONFIG "$APTETCDIR"/apt.conf ""
276     test -z "$APT_CONFIG" || export APT_CONFIG
277 }
278
279 function _pkgSetVarsYum
280 {
281     if test -n "$PKGDIR"; then
282         findDir YUMETCDIR    $PKGDIR/yumetc      $PKGDIR/base/yum/etc       /etc
283         findDir YUMCACHEDIR  $PKGDIR/yumcache    $PKGDIR/base/yum/cache
284     else
285         findDir YUMETCDIR    "$VDIR"/etc         /etc
286         findDir YUMCACHEDIR  "$VDIR"/var/cache/yum
287     fi
288 }
289
290
291 function _pkgMountBase
292 {
293     :
294 }
295
296 function _pkgMountApt
297 {
298     :
299 }
300
301 function _pkgMountYum
302 {
303     :
304 }
305
306 function _pkgMountRPM
307 {
308     _pkgMountBindDir "$RPMETCDIR" /etc/rpm
309     test "$RPMLIBDIR" = "/" || _pkgMountBindDir "$RPMLIBDIR" /usr/lib/rpm
310
311     pushd "$VDIR" >/dev/null
312
313     $_SECURE_MOUNT --chroot -n --bind "$RPMSTATEDIR" "$_rpmdb_mntpoint"
314     test -z "$WORKAROUND_106057" || mount -n --bind "$RPMSTATEDIR" "$_rpmdb_mntpoint"
315
316     test -e "$VDIR"/proc/self/status || \
317         $_SECURE_MOUNT --chroot -n -t proc none /proc
318
319     popd >/dev/null
320 }
321
322 function _pkgSetEnvBase
323 {
324     test "$EXECDIR" = "/" || {
325         PATH=$EXECDIR:$PATH
326         LD_LIBRARY_PATH=$EXECDIR${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
327     }
328
329     export PATH LD_LIBRARY_PATH
330 }
331
332 function _pkgSetEnvApt
333 {
334     :
335 }
336
337 function _pkgSetEnvYum
338 {
339     :
340 }
341
342 function _pkgSetEnvRPM
343 {
344     CUR_VSERVER=$vserver
345     RPM_FAKE_NAMESPACE_MOUNTS=$_rpmdb_mntpoint
346     RPM_BINARY=$_VRPM_PRELOAD
347
348     export CUR_VSERVER RPM_FAKE_NAMESPACE_MOUNTS RPM_BINARY
349 }
350
351 function pkgInit
352 {
353     local i
354     local vserver=$1
355     shift
356     
357     _pkgSetVarsBase
358     for i; do
359         case "$i" in
360             rpm)        _pkgSetVarsRPM;;
361             apt)        _pkgSetVarsApt;;
362             yum)        _pkgSetVarsYum;;
363             *)          echo "Unknown packaging flavor" >&2; exit 1;;
364         esac
365     done
366
367     _pkgMountBase
368     for i; do
369         case "$i" in
370             rpm)        _pkgMountRPM;;
371             apt)        _pkgMountApt;;
372             yum)        _pkgMountYum;;
373         esac
374     done
375
376     _pkgSetEnvBase
377     for i; do
378         case "$i" in
379             rpm)        _pkgSetEnvRPM;;
380             apt)        _pkgSetEnvApt;;
381             yum)        _pkgSetEnvYum;;
382         esac
383     done
384
385     _PKG_FLAVORS="$@"
386     _PKG_VSERVER=$vserver
387 }
388
389 function isAvoidNamespace
390 {
391     local cfgdir
392
393     $_VSERVER_INFO - FEATURE namespace   || return 0
394     cfgdir=$($_VSERVER_INFO "$1" CFGDIR) || return 0
395     test ! -e "$cfgdir"/namespace        || return 1
396     test -e "$__CONFDIR"/.defaults/nonamespace -o \
397          -e "$cfgdir"/nonamespace
398 }
399
400 function getAllVservers
401 {
402     local _ga_i
403     declare -a _ga_tmp=()
404
405     for _ga_i in $__CONFDIR/*; do
406         test   -d "$_ga_i"          || continue
407         test ! -e "$_ga_i"/disabled || continue
408         test   -d "$_ga_i"/vdir     || continue
409         case "$_ga_i" in
410             *.~*~) continue;;
411         esac
412
413         _ga_tmp=( "${_ga_tmp[@]}" "${_ga_i##$__CONFDIR/}")
414     done
415
416     eval $1='( "${_ga_tmp[@]}" )'
417 }
418
419 ## Usage: _getProcNumberCount <ctx> <var>
420 function _getProcNumberCount
421 {
422     local _gp_var=$2
423     local _gp_procnr_cnt=0
424
425     # Use /proc/virtual from kernel 2.6 when possible
426     if test -d "/proc/virtual"; then
427         set -- $($_GREP '^PROC:' "/proc/virtual/$1/limit" 2>/dev/null)
428         _gp_procnr_cnt=$2
429     else
430         _gp_procnr_cnt=$($_VPS ax | $_AWK '{print $2}' | $_GREP -x "$1" | $_WC -l )
431     fi
432
433     let _gp_procnr_cnt=_gp_procnr_cnt+0
434     eval $_gp_var=\$_gp_procnr_cnt
435 }
436
437 ## Usage: getVserverCtx <vdir> <result-varname> [<procnumber-varname> [<do-cleanup>]]
438 ## Returns: 0 iff vserver is running
439 function getVserverStatus
440 {
441     test -r "$1"/run || return 1
442
443     local _gvs_ctx
444     read _gvs_ctx <"$1"/run
445     eval "$2"=\$_gvs_ctx
446
447     test -n "$3"     || return 0
448     local _gvs_tmp
449     _getProcNumberCount "$_gvs_ctx" _gvs_tmp
450     eval "$3"=\$_gvs_tmp
451
452     if test "$_gvs_tmp" = 0; then
453         local runfile=$($_READLINK "$1/run")
454         test -z "$4" || $_RM -f "$runfile"
455         return 1
456     fi
457
458     return 0
459 }
460
461 ## Usage: isCtxRunning <ctx>
462 function isCtxRunning
463 {
464     local _tmp
465     _getProcNumberCount "$1" _tmp
466     test $_tmp -gt 0
467 }
468
469 ## Usage: isVserverRunning <vdir> [<ctx-varname>]
470 function isVserverRunning
471 {
472     local _ivr_ctx _ivr_procnum
473
474     getVserverStatus "$1" _ivr_ctx _ivr_procnum 1 || return 1
475     test "$_ivr_procnum" != 0                     || return 1
476     test -z "$2" || eval "$2"=\$_ivr_ctx
477     return 0
478 }
479
480 ## Called as 'getFileValue <varname> <filename>+'
481 function getFileValue
482 {
483     local _gfv_var=$1
484     local _gfv_file
485     shift
486
487     findFile _gfv_file "$@" ''
488     test -n "$_gfv_file" -a -r "$_gfv_file" || return 0
489     eval read "$_gfv_var" <"$_gfv_file"
490 }
491
492 ## Called as 'getFileArray <varname> <filename>'
493 function getFileArray
494 {
495     test -r "$2" || return 1
496     
497     local IFS=$_VS_NEWLINE
498     eval "$1"='( $(< "$2") )'
499 }
500
501 function checkComponents
502 {
503     local       i
504     local       msg=$1
505     local       x_failed=
506
507     shift
508     
509     for i; do
510         local failed=
511         case "$i" in
512             (core)      test -x "$_CHBIND"           || failed=1;;
513             (build)     test -x "$_VSERVER_BUILD"    || failed=1;;
514             (sysv)      test -x "$__INITRDDIR/vserver"    || failed=1;;
515             (devel)     test -d "$__INCLUDEDIR/vserver.h" || failed=1;;
516             (*)         echo "Unknown component '$i'" >&2
517                         return false
518                         ;;
519         esac
520
521         test -z "$failed" || {
522             echo "$msg: $i"
523             x_failed=1
524         } >&2
525     done
526
527     test -z "$x_failed"
528 }
529
530 ## Usage: isKernelAPI <ver> [<cmp-modifier>]
531 function isKernelAPI
532 {
533     local api
534     api=$($_VSERVER_INFO - APIVER) || api=0
535     test $[ $api ] -${2:-ge} $[ $1 ]
536 }
537
538 ## Usage: callInNamespace <vserver> <command> <args>*
539 function callInNamespace
540 {
541     local ctx=
542     
543     isAvoidNamespace "$1" || \
544     ctx=$( $_VSERVER_INFO "$1" CONTEXT f ) || ctx=
545
546     shift
547     if test -n "$ctx"; then
548         $_VNAMESPACE --enter "$ctx" -- "$@"
549     else
550         "$@"
551     fi
552 }
553
554 ## Usage: setDefaultTTY <vdir> [<fallback-tty>]
555 function setDefaultTTY
556 {
557     local cfgdir ttyname
558
559     cfgdir=$($_VSERVER_INFO "$1" APPDIR init) || cfgdir=
560     findObject -e ttyname \
561         ${cfgdir:+"$cfgdir"/tty} \
562         "$__CONFDIR/.defaults/apps/init/tty" \
563         $2 /dev/null
564
565     exec   <$ttyname
566     exec  &>$ttyname
567 }
568
569 ## Usage: pkgmgmt.guessStyle <vserver> <resultvar>
570 function pkgmgmt.guessStyle()
571 {
572     local _pgs_vdir
573     _pgs_vdir=$($_VSERVER_INFO "$1" VDIR) || {
574         echo $"Can not determine vserver-root" >&2
575         return 1
576     }
577     local _pgs_cfgdir=$($_VSERVER_INFO "$1" APPDIR pkgmgmt) || :
578
579     if test -n "$_pgs_cfgdir" -a -e "$_pgs_cfgdir"/style; then
580         read style <"$_pgs_cfgdir"/style
581     elif test -e "$_pgs_vdir"/etc/redhat-release -o -e "$_pgs_vdir"/etc/fedora-release; then
582         style=redhat
583     elif test -e "$_pgs_vdir"/etc/mandrake-release; then
584         style=mandrake
585     elif test -e "$_pgs_vdir"/etc/debian_version; then
586         style=debian
587     elif test -e "$_pgs_vdir"/etc/SuSE-release; then
588         style=suse
589     else
590         echo $"Can not determine packagemanagement style" >&2
591         return 1
592     fi
593
594     eval $2=\$style
595     return 0
596 }
597
598 ## Usage: pkgmgmt.isInternal <vserver>
599 ## returns true iff <vserver> is configured for internal packagemanagement
600 ## A typical application is
601 ## | is_external=
602 ## | pkgmgmt.isInternal "$vserver" || is_external=1
603 function pkgmgmt.isInternal
604 {
605     local cfgdir=$($_VSERVER_INFO "$1" APPDIR pkgmgmt) || :
606
607     test -z "$cfgdir" -o ! -d "$cfgdir" -o -e "$cfgdir"/internal
608 }
609
610 ## Usage: pkgmgmt.isAptAvailable <cfgdir> <vdir> [<is-internal>]
611 function pkgmgmt.isAptAvailable
612 {
613     local cfgdir="$1"
614     local vdir="$2"
615     local is_internal="$3"
616     
617     local have_apt i
618     if test -n "$is_internal"; then
619         have_apt=1
620         test -d "$cfgdir"/base/apt -o -d "$cfgdir"/aptetc || have_apt=
621     else
622         have_apt=
623         for i in /bin /usr/bin /usr/local/bin; do
624             test ! -x "$vdir$i"/apt-get || { have_apt=1; break; }
625         done
626     fi
627
628     test -n "$have_apt" && return 0 || return 1
629 }
630
631 ## Usage: pkgmgmt.isYumAvailable <cfgdir> <vdir> [<is-internal>]
632 function pkgmgmt.isYumAvailable
633 {
634     local cfgdir="$1"
635     local vdir="$2"
636     local is_internal="$3"
637     
638     local have_yum i
639     if test -n "$is_internal"; then
640         have_yum=1
641         test -d "$cfgdir"/base/yum -o -d "$cfgdir"/yumetc || have_yum=
642     else
643         have_yum=
644         for i in /bin /usr/bin /usr/local/bin; do
645             test ! -x "$vdir$i"/yum || { have_yum=1; break; }
646         done
647     fi
648
649     test -n "$have_yum" && return 0 || return 1
650 }
651
652
653 function vshelper.doSanityCheck
654 {
655     local vshelper this_xid i
656     declare -a warnings=()
657     local solution_disable=
658     local solution_sysctl=
659
660     vshelper.isEnabled && vshelper.isEnabled warning || return 0
661     
662     this_xid=$($_VSERVER_INFO - XID) ||
663         panic $"Failed to determine current context; aborting..."
664
665     ## Do nothing in other xid's; the helper will be executed in xid 0 only
666     test "$this_xid" = 0 || return 0
667
668     local proc_file=/proc/sys/kernel/vshelper
669
670     if ! test -r "$proc_file"; then
671         vshelper=
672         warnings=( "${warnings[@]}"
673                    $"File '$proc_file' does not exist but is required for vshelper setup" )
674         solution_disable=1
675     else
676         vshelper=$(cat "$proc_file")
677
678         $_CMP -s "$vshelper" "$_VSHELPER" || {
679             warnings=( "${warnings[@]}"
680                        $"The configured vshelper '$vshelper' does not match the 'vshelper'
681   script of the util-vserver package"
682                      )
683             solution_disable=1
684             solution_sysctl=1
685         }
686     fi
687
688     test -d "$__VSHELPERSTATEDIR" || {
689         warnings=( "${warnings[@]}"
690                    $"\
691 The vshelper state-directory '$__VSHELPERSTATEDIR' does not exist; since
692 it is created by 'make install', this indicates a serious problem with
693 your util-vserver installation" )
694         solution_disable=1
695     }
696
697     test "${#warnings[@]}" -eq 0 || {
698         warning $"\
699 The following problem(s) were encountered while verifying vshelper
700 functionality:"
701
702         for i in "${warnings[@]}"; do
703             warning "* $i"
704         done
705
706         warning $"\
707         
708 To fix this, you can:"
709
710         test -z "$solution_disable" || warning $"\
711 * disable vshelper entirely by executing
712   | touch \"$__CONFDIR/.defaults/apps/vshelper/disabled\"
713 * disable only this message by executing
714   | touch \"$__CONFDIR/.defaults/apps/vshelper/warning-disabled\""
715
716         test -x "$solution_sysctl" || warning $"\
717 * configure the util-vserver vshelper script, e.g. by adding
718   | kernel.vshelper = \"$_VSHELPER\"
719   to /etc/sysctl.conf and rebooting the machine, or by executing
720   | echo \"$_VSHELPER\" >$proc_file"
721
722         warning ""
723
724         return 1
725     }
726
727     return 0
728 }
729
730 ## Usage: vshelper.isEnabled [<style>] [<vserver>]
731 function vshelper.isEnabled
732 {
733     local f=${1:+$1-}disabled
734     test ! -e "$__CONFDIR"/.defaults/apps/vshelper/"$f"       || return 1
735     $_VSERVER_INFO - FEATURE vshelper                       || return 1
736     if test -n "$2"; then
737         local appdir
738         appdir=$($_VSERVER_INFO "$2" APPDIR vshelper)       || return 0
739         test -z "$2" -o ! -e "$appdir/$f"                   || return 1
740     fi
741
742     return 0
743 }
744
745 ## Usage: vshelper.isDebug [<vserver>]
746 function vshelper.isDebug
747 {
748     test ! -e "$__CONFDIR"/.defaults/apps/vshelper/debug            || return 1
749     $_VSERVER_INFO - FEATURE vshelper                       || return 1
750     if test -n "$1"; then
751         local appdir
752         appdir=$($_VSERVER_INFO "$1" APPDIR vshelper)       || return 1
753         test -z "$1" -o ! -e "$appdir/debug"                || return 1
754     fi
755
756     return 0
757 }
758
759 function vshelper._getHandlerInternal
760 {
761     local _vghi_var=$1
762     local _vghi_tmp
763     shift
764     shift       ## HACK: see below the note about the 'set -u' mode
765     
766     while test "$#" -ge 2; do
767         local _vghi_mod=$1
768         local _vghi_obj=$2
769         shift 2
770
771         test "$_vghi_mod" "$_vghi_obj" || continue
772         case "$_vghi_mod" in
773             (-x)
774                 eval $_vghi_var=\$_vghi_obj
775                 ;;
776             (-e)
777                 read _vghi_tmp <"$_vghi_obj"
778                 eval $_vghi_var=:\$_vghi_tmp
779                 ;;
780             (*) panic $"Internal error, unexpected modifier '$_vghi_mod'"
781         esac
782         return 0
783     done
784     
785     return 1
786 }
787
788 ## Usage: vshelper.getHandler <result-var> <vserver> <action>
789 function vshelper.getHandler
790 {
791     local _vgh_appdir
792     _vgh_appdir=$($_VSERVER_INFO "$2" APPDIR vshelper) || _vgh_appdir=
793
794     declare -a _vgh_search_list=( X )
795     ## HACK: when we are in 'set -u' mode, empty lists are causing errors
796
797     test -z "$_vgh_appdir" || _vgh_search_list=( "${_vgh_search_list[@]}" -x "$_vgh_appdir/$3" )
798     test -z "$_vgh_appdir" || _vgh_search_list=( "${_vgh_search_list[@]}" -e "$_vgh_appdir/action" )
799     _vgh_search_list=( "${_vgh_search_list[@]}" -x "$__CONFDIR"/.defaults/apps/vshelper/"$3" )
800     _vgh_search_list=( "${_vgh_search_list[@]}" -e "$__CONFDIR"/.defaults/apps/vshelper/action )
801
802     ! vshelper._getHandlerInternal "$1" "${_vgh_search_list[@]}" || return 0
803     eval $1=':restart'
804 }
805
806 ## Usage: vshelper.init <vserver> [<method> <args>*]
807 function vshelper.doInit
808 {
809     vshelper.isEnabled || return 0
810     
811     local xid
812     xid=$($_VSERVER_INFO "$1" CONTEXT false) && test -n "$xid" || {
813         warning $"vshelper.init: can not determine xid of vserver '$vserver'; returned value was '$xid'"
814         return 1
815     }
816
817     local f="$__VSHELPERSTATEDIR/$xid"
818     
819     set -C
820     $_RM -f "$f"
821     echo "$1" >"$f"
822     set +C
823     
824     if test -n "$2"; then
825         shift 1
826         local i
827         for i; do
828             echo "$i" 
829         done
830     else
831         echo "default"
832     fi >>"$f"
833
834     return 0
835 }
836
837 ## Usage: vshelper.doDestroy <vserver> <xid>
838 function vshelper.doDestroy
839 {
840     vshelper.isEnabled || return 0
841
842     $_RM -f "$__VSHELPERSTATEDIR/$2"
843 }
844
845 ## Usage: vshelper.initSync <vserver> <pipe-varname>
846 function vshelper.initSync
847 {
848     local _vis_tmpdir
849     _vis_tmpdir=$($_MKTEMPDIR /tmp/vserver-stop.XXXXXX) || {
850         warning $"Failed to generate temporary directory for vshelper sync"
851         return 1
852     }
853
854     local _vis_fifo="$_vis_tmpdir"/pipe
855     $_MKFIFO -m700 "$_vis_fifo"
856     vshelper.doInit "$1" sync "$_vis_fifo"
857     eval $2=\$_vis_fifo
858 }
859
860 ## Usage: vshelper.getSyncTimeout <vserver> <varname>
861 function vshelper.getSyncTimeout
862 {
863     local _vgst_appdir _vgst_file _vgst_tmp
864     _vgst_appdir=$($_VSERVER_INFO "$1" APPDIR vshelper) || _vgst_appdir=
865
866     findFile _vgst_file ${_vgst_appdir:+"$_vgst_appdir"/sync-timeout} "$__CONFDIR"/.defaults/apps/vshelper/sync-timeout ''
867     test -n "$_vgst_file" || return 1
868     read _vgst_tmp <"$_vgst_file"
869     eval $2=\$_vgst_tmp
870 }
871
872
873 function _rpmFake.getCapFlags
874 {
875     local ctx=$1
876     
877     if test -n "$ctx" && ! $_VSERVER_INFO - FEATURE migrate; then
878         set -- $($_CHCONTEXT_COMPAT --xid 1 \
879             $_SH -c "$_CAT /proc/[0-9]*/status | $_EGREP '^(CapBset|s_context|ctxflags)'" | \
880             $_GREP -B 1 -A 1 "^s_context: $ctx " | \
881             $_SED -e '1,3p;d' | $_AWK '{ print $2 }')
882     else
883         set --
884     fi
885
886     if test -n "$3"; then
887         RPM_FAKE_CAP=$[ ~0x$1 ]
888         RPM_FAKE_FLAGS=$3
889     else
890         RPM_FAKE_CAP=$[ ~0xd40c04ff ]
891         RPM_FAKE_FLAGS=4
892     fi
893 }
894
895 function rpmFake.init
896 {
897     local vdir ctx
898     
899     vdir=$($_VSERVER_INFO "$1" VDIR)    || vdir="$1"
900     ctx=$($_VSERVER_INFO  "$1" CONTEXT) || ctx=
901
902     test -d "$vdir" ||
903         panic $"Can not find chroot environment at '$vdir' for '$1'"
904
905     _rpmFake.getCapFlags "$ctx"
906
907     RPM_FAKE_CHROOT=$vdir
908     RPM_FAKE_CTX=$ctx
909 }
910
911 function rpmFake.exec
912 {
913     export RPM_FAKE_CHROOT RPM_FAKE_CTX RPM_FAKE_CAP RPM_FAKE_FLAGS
914     
915     LD_PRELOAD=$_RPM_FAKE_SO${LD_PRELOAD:+:$LD_PRELOAD} \
916         exec "$@"
917 }