build.common

   1 # -*-Shell-script-*-
   2 #
   3 # Common functions for build scripts used by various packages
   4 # incorporated (e.g., build, myplc, myplc-devel, vserver-reference)
   5 #
   6 # Marc E. Fiuczynski <mef@cs.princeton.edu>
   7 # Copyright (C) 2007 The Trustees of Princeton University
   8 #
   9 # $Id$
  10 #
  11
  12 function pl_getDefaultDistro() {
  13     # FC4 is currently the default release
  14     echo "Fedora"
  15     return 0
  16 }
  17
  18 function pl_getDefaultRelease() {
  19     # FC4 is currently the default release
  20     echo "4"
  21     return 0
  22 }
  23
  24 function pl_getDistro() {
  25     defaultDistro=$(pl_getDefaultDistro)
  26     if [ -f "/etc/redhat-release" ] ; then
  27         distro=$(awk ' { print $1 } ' /etc/redhat-release)
  28     else
  29         distro=$defaultDistro
  30     fi
  31     echo "$distro"
  32     return 0
  33 }
  34
  35 function pl_getRelease() {
  36     defaultRelease=$(pl_getDefaultRelease)
  37     if [ -f "/etc/redhat-release" ] ; then
  38         release=$(awk ' { if ($1=="Fedora" && $2=="Core") print $4 ; if (($1=="Fedora" && $2!="Core")||$1=="CentOS") print $3 } ' /etc/redhat-release)
  39         [ $release -lt $defaultRelease ] && release=$defaultRelease
  40     else
  41         release=$defaultRelease
  42     fi
  43     echo "$release"
  44     return 0
  45 }
  46
  47 # vserver expects something like fc4 or f7
  48 # for fedora and centos only for now
  49 function pl_getReleaseName () {
  50     distro=$1; shift
  51     release=$1; shift
  52     case $distro in
  53         [Ff]edora*)
  54             if [ "$release" -le 6 ] ; then
  55                 releasename=fc$release
  56             else
  57                 releasename=f$release
  58             fi ;;
  59         [Cc]entOS*)
  60             if [ "$release" = "4.5" ] ; then
  61             # centos 4.5 is just centos4 + enhancements
  62                 releasename=centos4
  63             else
  64                 releasename=centos$release
  65             fi ;;
  66         *)
  67             releasename="unknown-name-for-${pl_DISTRO}-please-edit-build.common"
  68             echo 1>&2 "build.common: WARNING - releasename not set for distro=$distro"
  69             return 1
  70             ;;
  71     esac
  72     echo "$releasename"
  73     return 0
  74 }
  75
  76 # figure out which redhat distro we are using (fedora, centos, redhat)
  77 pl_DISTRO=$(pl_getDistro)
  78
  79 # select basearch of the host devel environment - protected for macos for local tests
  80 pl_DISTRO_ARCH=$(uname -i 2>/dev/null|| echo unknownarch)
  81
  82 # let mkfedora select one of its mirrors
  83 pl_DISTRO_URL=""
  84
  85 # the release number (plain number)
  86 pl_DISTRO_RELEASE=$(pl_getRelease)
  87
  88 # the release name - for vserver build - like fc4, f8 or centos4
  89 pl_DISTRO_NAME=$(pl_getReleaseName $pl_DISTRO $pl_DISTRO_RELEASE)
  90
  91 # get path to appropriate yumgroups.xml file
  92 # Thierry: quick & dirty improvement
  93 # this file is updated by the toplevel build, from groups/<pldistro>.xml
  94 pl_DISTRO_YUMGROUPS="../../../RPMS/yumgroups.xml"
  95
  96 function pl_process_fedora_options () {
  97     # Get options
  98     shiftcount=0
  99     while getopts "l:r:a:h" opt ; do
 100         case $opt in
 101             l)
 102                 pl_DISTRO_URL=$OPTARG
 103                 let shiftcount=$shiftcount+2
 104                 ;;
 105             r)
 106                 pl_DISTRO_RELEASE=$OPTARG
 107                 let shiftcount=$shiftcount+2
 108                 ;;
 109             a)
 110                 pl_DISTRO_ARCH=$OPTARG
 111                 let shiftcount=$shiftcount+2
 112                 ;;
 113             h|*)
 114                 echo "Usage: $0 [OPTION]..."
 115                 echo "  -l url          distro mirror location (default: $pl_DISTRO_URL)"
 116                 echo "  -r release      distro release number (default: $pl_DISTRO_RELEASE)"
 117                 echo "  -a arch         distro architecture (default: $pl_DISTRO_ARCH)"
 118                 echo "where distro can be either fedora, centos, or redhat"
 119                 echo "  -h              This message"
 120                 exit 1
 121                 ;;
 122         esac
 123     done
 124     return $shiftcount
 125 }
 126
 127 ######################################## handling a root image
 128 function pl_root_rpm_macros () {
 129     cat <<EOF
 130 %_install_langs C:en_US:en
 131 %_netsharedpath /proc:/dev/pts
 132 %_excludedocs 1
 133 %__file_context_path /dev/null
 134 EOF
 135 }
 136
 137 function pl_root_makedevs() {
 138     vroot=$1
 139     # Clean ${vroot}/dev, but only when ${vroot}!=""
 140     [ -n $vroot ] && rm -rf $vroot/dev
 141
 142     mkdir -p $vroot/dev
 143     mknod -m 666 $vroot/dev/null c 1 3
 144     mknod -m 666 $vroot/dev/zero c 1 5
 145     mknod -m 666 $vroot/dev/full c 1 7
 146     mknod -m 644 $vroot/dev/random c 1 8
 147     mknod -m 644 $vroot/dev/urandom c 1 9
 148     mknod -m 666 $vroot/dev/tty c 5 0
 149     mknod -m 666 $vroot/dev/ptmx c 5 2
 150     # For bash command substitution
 151     ln -nsf ../proc/self/fd $vroot/dev/fd
 152
 153     # For df and linuxconf
 154     touch $vroot/dev/hdv1
 155
 156     # For pseudo ttys
 157     mkdir -p $vroot/dev/pts
 158
 159     # (Might have to remove the following for vserver-reference.)
 160
 161     # for tmpfs mount
 162     mkdir -p $vroot/dev/shm
 163
 164     # For TUN/TAP
 165     mkdir -p $vroot/dev/net
 166     mknod -m 600 $vroot/dev/net/tun c 10 200
 167
 168     # For mkinitrd (in case a kernel is being installed)
 169     # As well for loop back mounting within a vserver.
 170     for i in $(seq 0 255) ; do
 171         mknod -m 640 $vroot/dev/loop$i b 7 $i
 172     done
 173 }
 174
 175 # Default yum repositories to try
 176 mirrors=(
 177     file:///data/fedora
 178     http://localhost/fedora
 179     http://build.planet-lab.org/fedora
 180     http://coblitz.codeen.org/coblitz.planet-lab.org/pub/fedora
 181     ftp://mirror.cs.princeton.edu/pub/mirrors/fedora
 182     ftp://mirror.stanford.edu/pub/mirrors/fedora
 183     ftp://rpmfind.net/linux/fedora
 184     )
 185
 186 function mkfedora_usage() {
 187     echo "Usage: mkfedora [OPTION]... [basedir]"
 188     echo "      -l url          Fedora mirror location. Defaults to try:"
 189     for mirror in "${mirrors[@]}" ; do
 190         echo "                  $mirror"
 191     done
 192     echo "      -f pkgsfile     use this pkgs file for packages, groups, excludes.."
 193     echo "      -k              Exclude kernel* packages from all repositories except bootstrap"
 194     echo "      -v              Be verbose"
 195     echo "      -h              This message"
 196     echo " target selection (defaults based on current build vserver)"
 197     echo "      -r release      Fedora release number (default: $releasever)"
 198     echo "      -a arch         Fedora architecture (default: $basearch)"
 199     echo " legacy (use -f instead)"
 200     echo "      -g group1 -g group2 ..."
 201     echo "                      Yumgroups to install (default: none)"
 202     echo "      -p package1 -p package2 ..."
 203     echo "                      Additional packages to install (default: none)"
 204     echo "      -x package1 -x package2 ..."
 205     echo "                      Packages to exclude (default: none)"
 206     exit 1
 207 }
 208
 209 function pl_root_mkfedora () {
 210
 211     echo "* Entering pl_root_mkfedora " "$@"
 212
 213 # Verbosity
 214     verbose=0
 215
 216 # Release and architecture to install : defaults to current vserver's settings or previously parsed fedora_options
 217     releasever=$pl_DISTRO_RELEASE
 218     basearch=$pl_DISTRO_ARCH
 219     [ -n "$pl_DISTRO_URL" ] && mirrors=($pl_DISTRO_URL)
 220
 221 # Yum groups to install
 222     groups=()
 223
 224 # Packages to install
 225     packages=()
 226
 227 # Packages to exclude
 228     exclude=()
 229
 230 # Exclude kernel* (and related) packages from all repositories except bootstrap
 231     exclude_kernel=
 232
 233 # Get options
 234     while getopts "l:r:a:g:p:x:f:kvh" opt ; do
 235         case $opt in
 236             l)
 237                 if echo $OPTARG | grep -q -i '^\(file\|http[s]*\)://' ; then
 238                     mirrors=($OPTARG)
 239                 else
 240                     # xxx rather use this as a .mirrors file, searched in config.pldistro/
 241                     # that would use the pkgs syntax with mirror:
 242                     #mirrors=($(pl_parsePkgs mirror <fcdistro> $(pl_locateDistroFile ../build/ <pldistro> $OPTARG.mirrors)))
 243                     mirrors=(file://$OPTARG)
 244                 fi
 245                 ;;
 246             r)
 247                 releasever=$OPTARG
 248                 ;;
 249             a)
 250                 basearch=$OPTARG
 251                 ;;
 252             g)
 253                 groups[${#groups[*]}]="$OPTARG"
 254                 ;;
 255             p)
 256                 packages[${#packages[*]}]="$OPTARG"
 257                 ;;
 258             x)
 259                 exclude[${#exclude[*]}]="$OPTARG"
 260                 ;;
 261             f)
 262                 pkgsfile=$OPTARG
 263                 ;;
 264             k)
 265                 exclude_kernel="exclude=kernel* ulogd iptables"
 266                 ;;
 267             v)
 268                 verbose=1
 269                 set -x
 270                 ;;
 271             h|*)
 272                 mkfedora_usage
 273                 ;;
 274         esac
 275     done
 276
 277     shift $(($OPTIND - 1))
 278     if [ ! -d "$1" ] ; then
 279         mkfedora_usage
 280     fi
 281
 282     vroot=$(cd $1 && pwd -P)
 283
 284     if [ $UID -ne 0 ] ; then
 285         echo "Error: You must run this script as root."
 286         exit 1
 287     fi
 288
 289     function mkfedora_fetch ()
 290     {
 291         curl --fail --silent --max-time 60 "$1"
 292     }
 293
 294     # set list of attempted locations according to releasever
 295     if [ $releasever -ge 7 ] ; then
 296         attempts="
 297 linux/releases/$releasever/Everything/$basearch/os
 298 $releasever/Everything/$basearch/os
 299 core/$releasever/Everything/$basearch/os
 300 linux/core/$releasever/$basearch/os
 301 "
 302     else
 303         attempts="
 304         linux/core/$releasever/$basearch/os
 305         core/$releasever/$basearch/os
 306         $releasever/$basearch/os
 307         "
 308     fi
 309
 310     echo "$0: candidate mirrors"
 311     for mirror in "${mirrors[@]}" ; do
 312         echo "* candidate mirror $mirror"
 313     done
 314     baseurl=""
 315     for mirror in "${mirrors[@]}" ; do
 316         for attempt in $attempts; do
 317             attempturl=$mirror/$attempt
 318             if mkfedora_fetch $attempturl/repodata/repomd.xml >/dev/null ; then
 319                 baseurl=$attempturl
 320                 break 2
 321             fi
 322         done
 323     done
 324
 325     if [ -z "$baseurl" ] ; then
 326         echo "Error: $releasever/$basearch/os/repodata/repomd.xml"
 327         echo "       could not be found in any of the following locations:"
 328         echo
 329         for mirror in ${mirrors[@]} ; do
 330             for attempt in $attempts ; do
 331                 echo $mirror/$attempt
 332             done
 333         done
 334         echo
 335         mkfedora_usage
 336     fi
 337
 338     # Do not tolerate errors
 339     set -e
 340
 341     ## make rpms ignore installing stuff to special fs entries like /proc
 342     # Because of https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=52725
 343     # you have to use at least one language beside 'C'
 344     # Prevent all locales from being installed in reference image
 345     mkdir -p $vroot/etc/rpm
 346     pl_root_rpm_macros > $vroot/etc/rpm/macros
 347
 348     # Trick rpm and yum, who read the real root /etc/rpm/macros file
 349     # rather than the one installed in the reference image, despite what
 350     # you might expect the --root and --installroot options to mean. Both
 351     # programs always read $HOME/.rpmmacros.
 352     export HOME=$vroot/tmp
 353     mkdir -p $vroot/tmp
 354     pl_root_rpm_macros > $vroot/tmp/.rpmmacros
 355
 356     function mkfedora_cleanup () {
 357         umount -l $vroot/proc
 358         umount -l $vroot/dev/shm
 359         umount -l $vroot/dev/pts
 360     }
 361
 362     # Clean up before exiting if anything goes wrong
 363     trap "mkfedora_cleanup" ERR INT
 364
 365     # Mount in reference image
 366     mount -t devpts none $vroot/dev/pts
 367     mount -t tmpfs none $vroot/dev/shm
 368     mkdir -p $vroot/proc
 369     mount -t proc none $vroot/proc
 370
 371     # Create a /var/lib dirs for yum & rpm
 372     mkdir -p $vroot/var/lib/yum
 373     mkdir -p $vroot/var/lib/rpm
 374     mkdir -p $vroot/usr/share/info
 375
 376     # Create a dummy /etc/fstab in reference image
 377     mkdir -p $vroot/etc
 378     cat >$vroot/etc/fstab <<EOF
 379 # This fake fstab exists only to please df and linuxconf.
 380 /dev/hdv1       /       ext2    defaults        1 1
 381 EOF
 382     cp $vroot/etc/fstab $vroot/etc/mtab
 383
 384     # Necessary for some scripts
 385     mkdir -p $vroot/etc/sysconfig
 386     echo "NETWORKING=yes" > $vroot/etc/sysconfig/network
 387
 388     # Initialize RPM database in reference image
 389     mkdir -p $vroot/var/lib/rpm
 390     rpm --root $vroot --initdb
 391     rpm --root $vroot --import $baseurl/RPM-GPG-KEY-fedora
 392
 393     # Initialize yum in reference image
 394     mkdir -p $vroot/var/cache/yum $vroot/var/log
 395     if [ $releasever -lt 7 ] ; then
 396         corename="Core "
 397     else
 398         corename=""
 399     fi
 400
 401     cat >$vroot/etc/yum.conf <<EOF
 402 [main]
 403 cachedir=/var/cache/yum
 404 debuglevel=2
 405 logfile=/var/log/yum.log
 406 pkgpolicy=newest
 407 distroverpkg=redhat-release
 408 tolerant=1
 409 exactarch=1
 410 retries=20
 411 obsoletes=1
 412 gpgcheck=0
 413 # Prevent yum-2.4 from loading additional repository definitions
 414 # (e.g., from /etc/yum.repos.d/)
 415 reposdir=/dev/null
 416
 417 [base]
 418 name=Fedora ${corename}${releasever} - $basearch - base
 419 baseurl=$baseurl/
 420 $exclude_kernel
 421 EOF
 422
 423     for optional in updates extras ; do
 424         for optionalurl in \
 425             $mirror/linux/core/$optional/$releasever/$basearch \
 426             $mirror/core/$optional/$releasever/$basearch \
 427             $mirror/linux/$optional/$releasever/$basearch \
 428             $mirror/$optional/$releasever/$basearch ; do
 429             if mkfedora_fetch $optionalurl/repodata/repomd.xml ; then
 430                 cat >>$vroot/etc/yum.conf <<EOF
 431
 432 [$(basename $optional)]
 433 name=Fedora ${corename}${releasever} - $basearch - $(basename $optional)
 434 baseurl=$optionalurl/
 435 $exclude_kernel
 436 EOF
 437                 break
 438             fi
 439         done
 440     done
 441
 442     # If we are being built as part of an automated RPM build, solve the
 443     # bootstrap problem by including any just built packages in the yum
 444     # configuration. This cooperates with the PlanetLab build system.
 445 ### make takes care of that
 446     if [ -n "$RPM_BUILD_DIR" ] ; then
 447         RPM_RPMS_DIR=$(cd $(dirname $RPM_BUILD_DIR)/RPMS && pwd -P)
 448 ###        # yum-2.0.x
 449 ###     if [ -x /usr/bin/yum-arch ] ; then
 450 ###         yum-arch -q $RPM_RPMS_DIR
 451 ###     fi
 452 ###        # yum-2.4.x
 453 ###     if [ -x /usr/bin/createrepo ] ; then
 454 ###         if [ -f $RPM_RPMS_DIR/yumgroups.xml ] ; then
 455 ###             groupfile="-g yumgroups.xml"
 456 ###         fi
 457 ###         createrepo --quiet $groupfile $RPM_RPMS_DIR
 458 ###     fi
 459         # If run under sudo, allow user to delete the headers/ and
 460         # repodata/ directories.
 461         if [ -n "$SUDO_USER" ] ; then
 462             chown -R $SUDO_USER $RPM_RPMS_DIR
 463         fi
 464         cat >>$vroot/etc/yum.conf <<EOF
 465
 466 [bootstrap]
 467 name=Bootstrap - $basearch - $RPM_RPMS_DIR/
 468 baseurl=file://$RPM_RPMS_DIR/
 469 EOF
 470 fi
 471
 472     # pkgs file
 473     if [ -n "$pkgsfile" ] ; then
 474         # parse pkgsfile and add to local vars
 475         fcdistro=$(pl_getReleaseName "Fedora" $releasever)
 476         for i in $(pl_parsePkgs package $fcdistro $pkgsfile)  ; do
 477             packages[${#packages[*]}]="$i"
 478         done
 479         for i in $(pl_parsePkgs group $fcdistro $pkgsfile) ; do
 480             groups[${#groups[*]}]="$i"
 481         done
 482         for i in $(pl_parsePkgs exclude $fcdistro $pkgsfile) ; do
 483             exclude[${#exclude[*]}]="$i"
 484         done
 485         junk=$(pl_parsePkgs junk $fcdistro $pkgsfile)
 486         precious=$(pl_parsePkgs precious $fcdistro $pkgsfile)
 487     fi
 488
 489     excludes=
 490     for package in "${exclude[@]}" ; do
 491         excludes="$excludes --exclude=$package"
 492     done
 493
 494     # glibc must be specified explicitly for the correct arch to be
 495     # chosen.
 496     echo "* Installing glibc"
 497     yum -c $vroot/etc/yum.conf --installroot=$vroot -y $excludes install glibc
 498
 499     # Go, baby, go
 500     if [ ${#packages[*]} -gt 0 ] ; then
 501         echo "* Installing optional packages" "${packages[@]}"
 502         yum -c $vroot/etc/yum.conf --installroot=$vroot -y $excludes \
 503             install "${packages[@]}"
 504         if ! rpm --root $vroot -q "${packages[@]}" >/dev/null ; then
 505             echo "* Warning: Missing packages"
 506             rpm --root $vroot -q "${packages[@]}" | grep "not installed"
 507         fi
 508     fi
 509
 510     if [ ${#groups[*]} -gt 0 ] ; then
 511        ## call yum sequentially to get finer-grained info on dependencies
 512         for grp in "${groups[@]}" ; do
 513             echo "* Installing optional group $grp"
 514             yum -c $vroot/etc/yum.conf --installroot=$vroot -y $excludes \
 515                 groupinstall "$grp"
 516         done
 517     fi
 518
 519     # formerly in bootcd/prep.sh : to optimize footprint
 520     echo "* Removing unnecessary junk"
 521
 522     pushd $vroot
 523
 524     # Save precious files
 525     [ -n "$precious" ] && tar --ignore-failed-read -cpf precious.tar $precious
 526
 527     # Remove unnecessary junk
 528     [ -n "$junk" ] && rm -rf $junk
 529
 530     # Restore precious files
 531     [ -n "$precious" ] && tar -xpf precious.tar && rm -f precious.tar
 532
 533     popd
 534
 535 ###    # FC2 dev %preinstall checks /proc/mounts to make sure that /dev is
 536 ###    # not currently mounted as devfs. If it thinks it is, it will refuse
 537 ###    # to install the package. On a modern system running udev that mounts
 538 ###    # /dev as tmpfs, this check fails. Since we are installing into a
 539 ###    # chroot, whether /dev is mounted on the host system or not doesn't
 540 ###    # matter. If dev was explicitly mentioned in the packages list, force
 541 ###    # its installation.
 542 ###    if [ "$releasever" = "2" ] ; then
 543 ###     for package in "${packages[@]}" ; do
 544 ###         if [ "$package" = "dev" ] && ! rpm --root $vroot -q dev >/dev/null 2>&1 ; then
 545 ###             rpm --root $vroot -Uvh --noscripts $baseurl/Fedora/RPMS/dev-3.3.13-1.i386.rpm
 546 ###             break
 547 ###         fi
 548 ###     done
 549 ###    fi
 550
 551     # Clean yum cache
 552     echo "* Cleaning up"
 553     yum -c $vroot/etc/yum.conf --installroot=$vroot -y clean all
 554
 555     # Clean RPM state
 556     rm -f $vroot/var/lib/rpm/__db*
 557
 558     # Set time zone to UTC
 559     if [ -f $vroot/usr/share/zoneinfo/UTC -a -f $vroot/etc/localtime ] ; then
 560         rm -f $vroot/etc/localtime
 561         ln -s /usr/share/zoneinfo/UTC $vroot/etc/localtime
 562     fi
 563
 564     # remove trap handler, as we are about to call it directly.
 565     trap - ERR INT
 566
 567     # Clean up
 568     mkfedora_cleanup
 569
 570     return 0
 571 }
 572
 573 function pl_root_setup_chroot() {
 574     root=$1; shift
 575     options="$@"
 576
 577     pl_root_makedevs $root
 578     pl_root_mkfedora $root $options
 579
 580     # Disable all services in reference image
 581     chroot $root sh -c "/sbin/chkconfig --list | awk '{ print \$1 }' | xargs -i /sbin/chkconfig {} off"
 582
 583     # FC2 minilogd starts up during shutdown and makes unmounting
 584     # impossible. Just get rid of it.
 585     rm -f $root/sbin/minilogd
 586     ln -nsf /bin/true $root/sbin/minilogd
 587
 588     # This tells the Boot Manager that it is okay to update
 589     # /etc/resolv.conf and /etc/hosts whenever the network configuration
 590     # changes. Users are free to delete this file.
 591     touch $vroot/etc/AUTO_UPDATE_NET_FILES
 592 }
 593
 594 # Move specified directories out of a src tree into a dst tree, and
 595 # then for each moved directory create a symlink in src to dst.
 596 function pl_move_dirs() {
 597     root=$1
 598     data=$2
 599     store=$3
 600     shift 3
 601
 602     mkdir -p $root/data
 603     for datadir in "$@" ; do
 604         mkdir -p ${data}${datadir}
 605         if [ -d ${root}/${datadir} -a ! -h ${root}/${datadir} ] ; then
 606             (cd ${root} && find ./${datadir} | cpio -p -d -u ../${data}/)
 607         fi
 608         rm -rf ${root}/${datadir}
 609         mkdir -p $(dirname ${root}/${datadir})
 610         ln -nsf /${store}/${datadir} ${root}/${datadir}
 611     done
 612 }
 613
 614 # Construct an image file from given some directory
 615 # XXX in the future maybe use livecdtools?
 616 function pl_make_image() {
 617     root=$1
 618     image=$2
 619     extraspace=$3
 620
 621     # Leave about 100 MB free space and allow for about 20% inode overhead
 622     bytes=$((($(du -sb $root | cut -f1) + $extraspace) * 120 / 100))
 623     bs=4096
 624     blocks=$(($bytes / $bs))
 625     dd bs=$bs count=$blocks if=/dev/zero of=$image
 626     mkfs.ext3 -b $bs -j -F $image
 627
 628     # Temporarily mount it
 629     tmp=$(mktemp -d tmp.XXXXXX)
 630     mount -o loop $image $tmp
 631     trap "umount $tmp; rmdir $tmp" ERR INT
 632
 633     # Move files to it
 634     (cd $root && tar cpf - .) | (cd $tmp && tar xpf -)
 635
 636     # Unmount it
 637     umount -l $tmp
 638     rmdir $tmp
 639     trap - ERR INT
 640 }
 641
 642 # Fix permissions on tmp directories
 643 function pl_fixtmp_permissions() {
 644     root=$1
 645     chmod 1777 $root/tmp $root/usr/tmp $root/var/tmp
 646 }
 647
 648 function pl_fixdirs() {
 649     root=$1
 650     datadirs=$2
 651     for datadir in datadirs ; do
 652         if [ -h ${root}/${datadir} ] ; then
 653             rm -f ${root}/${datadir}
 654             mkdir -p ${root}/${datadir}
 655         fi
 656     done
 657 }
 658
 659 ########## .pkgs format
 660 # comments start with a # - this is needed only if you use a keyword in a comment
 661 # for a given keyword like 'package' :
 662 # we support fcdistro-dependant format, for tokens (pkgname) without whitespace
 663 # you can e.g. use
 664 # package: pkg1 .. pkgn
 665 # package+f8: pkg1 .. pkgn
 666 # package-f8: pkg1 .. pkgn
 667
 668 function pl_parsePkgs () {
 669
 670     keyword=$1;shift
 671     fcdistro=$1; shift
 672     # remaining arguments are paths to the pkgs files
 673
 674     # grab regular descriptions
 675     all=$(grep -v '^#' "$@" | grep --regexp="^${keyword}:" | sed -e "s,${keyword}:,,")
 676     # grab additions
 677     add=$(grep -v '^#' "$@" | grep --regexp="^${keyword}+${fcdistro}:" | sed -e "s,${keyword}\+${fcdistro}:,,")
 678     # grab exclusions
 679     sub=$(grep -v '^#' "$@" | grep --regexp="^${keyword}\-${fcdistro}:" | sed -e "s,${keyword}\-${fcdistro}:,,")
 680
 681     for i in $all $add; do
 682         for exclude in $sub; do
 683             [ "$i" = "$exclude" ] && continue 2
 684         done
 685         echo "$i "
 686     done
 687     return 0
 688 }
 689
 690 function pl_getPackages() { fcdistro=$1; shift ; pl_parsePkgs package $fcdistro "$@" ; }
 691 function pl_getGroups() { fcdistro=$1; shift ; pl_parsePkgs group $fcdistro "$@" ; }
 692
 693 # locates a pldistro-dependant file
 694 # tries first in build/<pldistro>/, then in build/planetlab/
 695 function pl_locateDistroFile () {
 696     builddir=$1; shift
 697     pldistro=$1; shift
 698     pkgsfile=$1; shift
 699
 700     pkgspath=""
 701     # locate it
 702     paths="$builddir/config.$pldistro/$pkgsfile $builddir/config.planetlab/$pkgsfile"
 703     for path in $paths; do
 704         if [ -f $path ] ; then
 705             pkgspath=$path
 706             break
 707         fi
 708     done
 709     if [ -z "$pkgspath" ] ; then
 710         echo 1>&2 "pl_locateDistroFile - in $(pwd) : cannot locate $pkgsfile in $builddir"
 711         echo 1>&2 "candidates were $paths"
 712         echo "not-found-by-pl_locateDistroFile"
 713         return 1
 714     else
 715         echo 1>&2 "pl_locateDistroFile: using $pkgspath"
 716         echo $pkgspath
 717         return 0
 718     fi
 719 }