scripts/live-helpers

   1 # live-boot helper functions, used by live-boot on boot and by live-snapshot
   2
   3 if [ ! -x "/bin/fstype" ]
   4 then
   5         # klibc not in path -> not in initramfs
   6         export PATH="${PATH}:/usr/lib/klibc/bin"
   7 fi
   8
   9 # handle upgrade path from old udev (using udevinfo) to
  10 # recent versions of udev (using udevadm info)
  11 if [ -x /sbin/udevadm ]
  12 then
  13         udevinfo='/sbin/udevadm info'
  14 else
  15         udevinfo='udevinfo'
  16 fi
  17
  18 sys2dev ()
  19 {
  20         sysdev=${1#/sys}
  21         echo "/dev/$($udevinfo -q name -p ${sysdev} 2>/dev/null|| echo ${sysdev##*/})"
  22 }
  23
  24 subdevices ()
  25 {
  26         sysblock=${1}
  27         r=""
  28
  29         for dev in "${sysblock}"/* "${sysblock}"
  30         do
  31                 if [ -e "${dev}/dev" ]
  32                 then
  33                         r="${r} ${dev}"
  34                 fi
  35         done
  36
  37         echo ${r}
  38 }
  39
  40 storage_devices()
  41 {
  42         black_listed_devices="${1}"
  43         white_listed_devices="${2}"
  44
  45         for sysblock in $(echo /sys/block/* | tr ' ' '\n' | grep -vE "loop|ram|fd")
  46         do
  47                 fulldevname=$(sys2dev "${sysblock}")
  48
  49                 if echo "${black_listed_devices}" | grep -qe "\<${fulldevname}\>" || \
  50                         [ -n "${white_listed_devices}" ] && \
  51                         echo "${white_listed_devices}" | grep -qve "\<${fulldevname}\>"
  52                 then
  53                         # skip this device entirely
  54                         continue
  55                 fi
  56
  57                 for dev in $(subdevices "${sysblock}")
  58                 do
  59                         devname=$(sys2dev "${dev}")
  60
  61                         if echo "${black_listed_devices}" | grep -qe "\<${devname}\>"
  62                         then
  63                                 # skip this subdevice
  64                                 continue
  65                         else
  66                                 echo "${devname}"
  67                         fi
  68                 done
  69         done
  70 }
  71
  72 is_supported_fs ()
  73 {
  74         fstype="${1}"
  75
  76         # Validate input first
  77         if [ -z "${fstype}" ]
  78         then
  79                 return 1
  80         fi
  81
  82         # Try to look if it is already supported by the kernel
  83         if grep -q ${fstype} /proc/filesystems
  84         then
  85                 return 0
  86         else
  87                 # Then try to add support for it the gentle way using the initramfs capabilities
  88                 modprobe ${fstype}
  89                 if grep -q ${fstype} /proc/filesystems
  90                 then
  91                         return 0
  92                 # Then try the hard way if /root is already reachable
  93                 else
  94                         kmodule="/root/lib/modules/`uname -r`/${fstype}/${fstype}.ko"
  95                         if [ -e "${kmodule}" ]
  96                         then
  97                                 insmod "${kmodule}"
  98                                 if grep -q ${fstype} /proc/filesystems
  99                                 then
 100                                         return 0
 101                                 fi
 102                         fi
 103                 fi
 104         fi
 105
 106         return 1
 107 }
 108
 109 get_fstype ()
 110 {
 111         /sbin/blkid -s TYPE -o value $1 2>/dev/null
 112 }
 113
 114 where_is_mounted ()
 115 {
 116         device=${1}
 117
 118         if grep -q "^${device} " /proc/mounts
 119         then
 120                 # return the first found
 121                 grep -m1 "^${device} " /proc/mounts | cut -f2 -d ' '
 122         fi
 123 }
 124
 125 lastline ()
 126 {
 127         while read lines
 128         do
 129                 line=${lines}
 130         done
 131
 132         echo "${line}"
 133 }
 134
 135 base_path ()
 136 {
 137         testpath="${1}"
 138         mounts="$(awk '{print $2}' /proc/mounts)"
 139         testpath="$(busybox realpath ${testpath})"
 140
 141         while true
 142         do
 143                 if echo "${mounts}" | grep -qs "^${testpath}"
 144                 then
 145                         set -- $(echo "${mounts}" | grep "^${testpath}" | lastline)
 146                         echo ${1}
 147                         break
 148                 else
 149                         testpath=$(dirname $testpath)
 150                 fi
 151         done
 152 }
 153
 154 fs_size ()
 155 {
 156         # Returns used/free fs kbytes + 5% more
 157         # You could pass a block device as ${1} or the mount point as ${2}
 158
 159         dev="${1}"
 160         mountp="${2}"
 161         used="${3}"
 162
 163         if [ -z "${mountp}" ]
 164         then
 165                 mountp="$(where_is_mounted ${dev})"
 166
 167                 if [ -z "${mountp}" ]
 168                 then
 169                         mountp="/mnt/tmp_fs_size"
 170
 171                         mkdir -p "${mountp}"
 172                         mount -t $(get_fstype "${dev}") -o ro "${dev}" "${mountp}" || log_warning_msg "cannot mount -t $(get_fstype ${dev}) -o ro ${dev} ${mountp}"
 173
 174                         doumount=1
 175                 fi
 176         fi
 177
 178         if [ "${used}" = "used" ]
 179         then
 180                 size=$(du -ks ${mountp} | cut -f1)
 181                 size=$(expr ${size} + ${size} / 20 ) # FIXME: 5% more to be sure
 182         else
 183                 # free space
 184                 size="$(df -k | grep -s ${mountp} | awk '{print $4}')"
 185         fi
 186
 187         if [ -n "${doumount}" ]
 188         then
 189                 umount "${mountp}" || log_warning_msg "cannot umount ${mountp}"
 190                 rmdir "${mountp}"
 191         fi
 192
 193         echo "${size}"
 194 }
 195
 196 load_keymap ()
 197 {
 198         # Load custom keymap
 199         if [ -x /bin/loadkeys -a -r /etc/boottime.kmap.gz ]
 200         then
 201                 loadkeys /etc/boottime.kmap.gz
 202         fi
 203 }
 204
 205 setup_loop ()
 206 {
 207         local fspath=${1}
 208         local module=${2}
 209         local pattern=${3}
 210         local offset=${4}
 211         local encryption=${5}
 212         local readonly=${6}
 213
 214         # the output of setup_loop is evaluated in other functions,
 215         # modprobe leaks kernel options like "libata.dma=0"
 216         # as "options libata dma=0" on stdout, causing serious
 217         # problems therefor, so instead always avoid output to stdout
 218         modprobe -q -b "${module}" 1>/dev/null
 219
 220         udevadm settle
 221
 222         for loopdev in ${pattern}
 223         do
 224                 if [ "$(cat ${loopdev}/size)" -eq 0 ]
 225                 then
 226                         dev=$(sys2dev "${loopdev}")
 227                         options=''
 228
 229                         if [ -n "${readonly}" ]
 230                         then
 231                                 if losetup --help 2>&1 | grep -q -- "-r\b"
 232                                 then
 233                                         options="${options} -r"
 234                                 fi
 235                         fi
 236
 237                         if [ -n "${offset}" ] && [ 0 -lt "${offset}" ]
 238                         then
 239                                 options="${options} -o ${offset}"
 240                         fi
 241
 242                         if [ -z "${encryption}" ]
 243                         then
 244                                 losetup ${options} "${dev}" "${fspath}"
 245                         else
 246                                 # Loop AES encryption
 247                                 while true
 248                                 do
 249                                         load_keymap
 250
 251                                         echo -n "Enter passphrase for root filesystem: " >&6
 252                                         read -s passphrase
 253                                         echo "${passphrase}" > /tmp/passphrase
 254                                         unset passphrase
 255                                         exec 9</tmp/passphrase
 256                                         /sbin/losetup ${options} -e "${encryption}" -p 9 "${dev}" "${fspath}"
 257                                         error=${?}
 258                                         exec 9<&-
 259                                         rm -f /tmp/passphrase
 260
 261                                         if [ 0 -eq ${error} ]
 262                                         then
 263                                                 unset error
 264                                                 break
 265                                         fi
 266
 267                                         echo
 268                                         echo -n "There was an error decrypting the root filesystem ... Retry? [Y/n] " >&6
 269                                         read answer
 270
 271                                         if [ "$(echo "${answer}" | cut -b1 | tr A-Z a-z)" = "n" ]
 272                                         then
 273                                                 unset answer
 274                                                 break
 275                                         fi
 276                                 done
 277                         fi
 278
 279                         echo "${dev}"
 280                         return 0
 281                 fi
 282         done
 283
 284         panic "No loop devices available"
 285 }
 286
 287 try_mount ()
 288 {
 289         dev="${1}"
 290         mountp="${2}"
 291         opts="${3}"
 292         fstype="${4}"
 293
 294         old_mountp="$(where_is_mounted ${dev})"
 295
 296         if [ -n "${old_mountp}" ]
 297         then
 298                 if [ "${opts}" != "ro" ]
 299                 then
 300                         mount -o remount,"${opts}" "${dev}" "${old_mountp}" || panic "Remounting ${dev} ${opts} on ${old_mountp} failed"
 301                 fi
 302
 303                 mount -o bind "${old_mountp}" "${mountp}" || panic "Cannot bind-mount ${old_mountp} on ${mountp}"
 304         else
 305                 if [ -z "${fstype}" ]
 306                 then
 307                         fstype=$(get_fstype "${dev}")
 308                 fi
 309                 mount -t "${fstype}" -o "${opts}" "${dev}" "${mountp}" || \
 310                 ( echo "SKIPPING: Cannot mount ${dev} on ${mountp}, fstype=${fstype}, options=${opts}" > live-boot.log && return 0 )
 311         fi
 312 }
 313
 314 open_luks_device ()
 315 {
 316         dev="${1}"
 317         name="$(basename ${dev})"
 318         opts="--key-file=-"
 319         if [ -n "${PERSISTENT_READONLY}" ]
 320         then
 321                 opts="${opts} --readonly"
 322         fi
 323
 324         load_keymap
 325
 326         while true
 327         do
 328                 /lib/cryptsetup/askpass "Enter passphrase for ${dev}: " | \
 329                         /sbin/cryptsetup -T 1 luksOpen ${dev} ${name} ${opts}
 330
 331                 if [ 0 -eq ${?} ]
 332                 then
 333                         luks_device="/dev/mapper/${name}"
 334                         echo ${luks_device}
 335                         return 0
 336                 fi
 337
 338                 echo >&6
 339                 echo -n "There was an error decrypting ${dev} ... Retry? [Y/n] " >&6
 340                 read answer
 341
 342                 if [ "$(echo "${answer}" | cut -b1 | tr A-Z a-z)" = "n" ]
 343                 then
 344                         return 2
 345                 fi
 346         done
 347 }
 348
 349 find_persistent_media ()
 350 {
 351         # Scans devices for overlays and snapshots, and returns a whitespace
 352         # separated list of how to use them. Only overlays with a partition
 353         # label or file name in ${overlays} are returned, and ditto for
 354         # snapshots with labels in ${snapshots}.
 355         #
 356         # When scanning a LUKS device, the user will be asked to enter the
 357         # passphrase; on failure to enter it, or if no persistent partitions
 358         # or files were found, the LUKS device is closed.
 359         #
 360         # For a snapshot file the return value is ${label}=${snapdata}", where
 361         # ${snapdata} is the parameter used for try_snap().
 362         #
 363         # For all other cases (overlay/snapshot partition and overlay file) the
 364         # return value is "${label}=${device}", where ${device} a device that
 365         # can mount the content. In the case of an overlay file, the device
 366         # containing the file will remain mounted as a side-effect.
 367         #
 368         # No devices in ${black_listed_devices} will be scanned, and if
 369         # ${white_list_devices} is non-empty, only devices in it will be
 370         # scanned.
 371
 372         overlays="${1}"
 373         snapshots="${2}"
 374         black_listed_devices="${3}"
 375         white_listed_devices="${4}"
 376         persistent_backing="${rootmnt}/live/persistent"
 377
 378         for dev in $(storage_devices "${black_listed_devices}" "${white_listed_devices}")
 379         do
 380                 luks_device=""
 381
 382                 # Checking for a luks device
 383                 if echo ${PERSISTENT_ENCRYPTION} | grep -qe "\<luks\>" && \
 384                    /sbin/cryptsetup isLuks ${dev}
 385                 then
 386                         if luks_device=$(open_luks_device "${dev}")
 387                         then
 388                                 dev="${luks_device}"
 389                         else
 390                                 # skip $dev since we failed/chose not to open it
 391                                 continue
 392                         fi
 393                 elif echo ${PERSISTENT_ENCRYPTION} | grep -qve "\<none\>"
 394                 then
 395                         # skip $dev since we don't allow unencrypted storage
 396                         continue
 397                 fi
 398
 399                 if echo ${PERSISTENT_STORAGE} | grep -qe "\<filesystem\>"
 400                 then
 401                         for label in ${overlays} ${snapshots}
 402                         do
 403                                 if [ "$(/sbin/blkid -s LABEL -o value $dev 2>/dev/null)" = "${label}" ]
 404                                 then
 405                                         echo "${label}=${dev}"
 406                                         # skip to the next device
 407                                         continue 2
 408                                 fi
 409                         done
 410                 fi
 411
 412                 if echo ${PERSISTENT_STORAGE} | grep -qe "\<file\>"
 413                 then
 414                         devfstype="$(get_fstype ${dev})"
 415                         overlay_on_dev=""
 416                         snapshot_on_dev=""
 417                         backing="${persistent_backing}/$(basename ${dev})"
 418                         mkdir -p "${backing}"
 419                         if is_supported_fs ${devfstype} && try_mount "${dev}" "${backing}" "rw" "${devfstype}"
 420                         then
 421                                 for label in ${overlays}
 422                                 do
 423                                         path=${backing}/${PERSISTENT_PATH}${label}
 424                                         if [ -f "${path}" ]
 425                                         then
 426                                                 overlay_on_dev="yes"
 427                                                 echo "${label}=$(setup_loop "${path}" "loop" "/sys/block/loop*")"
 428                                         fi
 429                                 done
 430
 431                                 for label in ${snapshots}
 432                                 do
 433                                         for ext in squashfs cpio.gz ext2 ext3 ext4 jffs2
 434                                         do
 435                                                 path="${PERSISTENT_PATH}${label}.${ext}"
 436                                                 if [ -f "${backing}/${path}" ]
 437                                                 then
 438                                                         snapshot_on_dev="yes"
 439                                                         echo "${label}=${dev}:${backing}:${path}"
 440                                                 fi
 441                                         done
 442                                 done
 443                         fi
 444                         if [ -z "${overlay_on_dev}" ]
 445                         then
 446                                 umount ${backing} > /dev/null 2>&1 || true
 447                                 if [ -z "${snapshot_on_dev}" ] && [ -n "${luks_device}" ] && /sbin/cryptsetup status "${luks_device}" 1> /dev/null
 448                                 then
 449                                         /sbin/cryptsetup luksClose "${luks_device}"
 450                                 fi
 451                         fi
 452                 fi
 453         done
 454 }
 455
 456 get_mac ()
 457 {
 458         mac=""
 459
 460         for adaptor in /sys/class/net/*
 461         do
 462                 status="$(cat ${adaptor}/iflink)"
 463
 464                 if [ "${status}" -eq 2 ]
 465                 then
 466                         mac="$(cat ${adaptor}/address)"
 467                         mac="$(echo ${mac} | sed 's/:/-/g' | tr '[a-z]' '[A-Z]')"
 468                 fi
 469         done
 470
 471         echo ${mac}
 472 }
 473
 474 is_luks()
 475 {
 476     devname="${1}"
 477     if [ -x /sbin/cryptsetup ]
 478     then
 479         /sbin/cryptsetup isLuks "${devname}" 2>/dev/null || ret=${?}
 480         return ${ret}
 481     else
 482         return 1
 483     fi
 484
 485 }
 486
 487 removable_dev ()
 488 {
 489         output_format="${1}"
 490         want_usb="${2}"
 491         ret=
 492
 493         for sysblock in $(echo /sys/block/* | tr ' ' '\n' | grep -vE "/(loop|ram|dm-|fd)")
 494         do
 495                 dev_ok=
 496                 if [ "$(cat ${sysblock}/removable)" = "1" ]
 497                 then
 498                         if [ -z "${want_usb}" ]
 499                         then
 500                                 dev_ok="yes"
 501                         else
 502                                 if readlink ${sysblock} | grep -q usb
 503                                 then
 504                                         dev_ok="yes"
 505                                 fi
 506                         fi
 507                 fi
 508
 509                 if [ "${dev_ok}" = "yes" ]
 510                 then
 511                         case "${output_format}" in
 512                                 sys)
 513                                         ret="${ret} ${sysblock}"
 514                                         ;;
 515                                 *)
 516                                         devname=$(sys2dev "${sysblock}")
 517                                         ret="${ret} ${devname}"
 518                                         ;;
 519                         esac
 520                 fi
 521         done
 522
 523         echo "${ret}"
 524 }
 525
 526 removable_usb_dev ()
 527 {
 528         output_format="${1}"
 529
 530         removable_dev "${output_format}" "want_usb"
 531 }
 532
 533 non_removable_dev ()
 534 {
 535         output_format="${1}"
 536         ret=
 537
 538         for sysblock in $(echo /sys/block/* | tr ' ' '\n' | grep -vE "/(loop|ram|dm-|fd)")
 539         do
 540                 if [ "$(cat ${sysblock}/removable)" = "0" ]
 541                 then
 542                         case "${output_format}" in
 543                                 sys)
 544                                         ret="${ret} ${sysblock}"
 545                                         ;;
 546                                 *)
 547                                         devname=$(sys2dev "${sysblock}")
 548                                         ret="${ret} ${devname}"
 549                                         ;;
 550                         esac
 551                 fi
 552         done
 553
 554         echo "${ret}"
 555 }
 556
 557 link_files ()
 558 {
 559         # create source's directory structure in dest, and recursively
 560         # create symlinks in dest to to all files in source. if mask
 561         # is non-empty, remove mask from all source paths when
 562         # creating links (will be necessary if we change root, which
 563         # live-boot normally does (into $rootmnt)).
 564
 565         # remove multiple /:s and ensure ending on /
 566         local src_dir="$(echo "${1}"/ | sed -e 's|/\+|/|g')"
 567         local dest_dir="$(echo "${2}"/ | sed -e 's|/\+|/|g')"
 568         local src_mask="${3}"
 569
 570         # This check can only trigger on the inital, non-recursive call since
 571         # we create the destination before recursive calls
 572         if [ ! -d "${dest_dir}" ];
 573         then
 574                 log_warning_msg "Must link_files into a directory"
 575                 return
 576         fi
 577
 578         find "${src_dir}" -mindepth 1 -maxdepth 1 | while read x; do
 579                 local src="${x}"
 580                 local dest="${dest_dir}$(basename "${x}")"
 581                 if [ -d "${src}" ];
 582                 then
 583                         if [ -z "$(ls -A "${src}")" ];
 584                         then
 585                                 continue
 586                         fi
 587                         if [ ! -d "${dest}" ];
 588                         then
 589                                 mkdir -p "${dest}"
 590                                 prev="$(dirname "${dest}")"
 591                                 chown $(stat -c %u:%g "${prev}") "${dest}"
 592                                 chmod $(stat -c %a "${prev}") "${dest}"
 593                         fi
 594                         link_files "${src}" "${dest}" "${src_mask}"
 595                 else
 596                         if [ -n "${src_mask}" ]
 597                         then
 598                                 src="$(echo ${src} | sed "s|^${src_mask}||")"
 599                         fi
 600                         rm -rf "${dest}" 2> /dev/null
 601                         ln -s "${src}" "${dest}"
 602                 fi
 603         done
 604 }
 605
 606 do_union () {
 607         local unionmountpoint="${1}"    # directory where the union is mounted
 608         local unionrw="${2}"            # branch where the union changes are stored
 609         local unionro1="${3}"           # first underlying read-only branch (optional)
 610         local unionro2="${4}"           # second underlying read-only branch (optional)
 611
 612         if [ "${UNIONTYPE}" = "aufs" ]
 613         then
 614                 rw_opt="rw"
 615                 ro_opt="rr+wh"
 616                 noxino_opt="noxino"
 617         elif [ "${UNIONTYPE}" = "unionfs-fuse" ]
 618         then
 619                 rw_opt="RW"
 620                 ro_opt="RO"
 621         else
 622                 rw_opt="rw"
 623                 ro_opt="ro"
 624         fi
 625
 626         case "${UNIONTYPE}" in
 627                 unionfs-fuse)
 628                         unionmountopts="-o cow -o noinitgroups -o default_permissions -o allow_other -o use_ino -o suid"
 629                         unionmountopts="${unionmountopts} ${unionrw}=${rw_opt}"
 630                         if [ -n "${unionro1}" ]
 631                         then
 632                                 unionmountopts="${unionmountopts}:${unionro1}=${ro_opt}"
 633                         fi
 634                         if [ -n "${unionro2}" ]
 635                         then
 636                                 unionmountopts="${unionmountopts}:${unionro2}=${ro_opt}"
 637                         fi
 638                         ( sysctl -w fs.file-max=391524 ; ulimit -HSn 16384
 639                         unionfs-fuse ${unionmountopts} "${unionmountpoint}" ) && \
 640                         ( mkdir -p /run/sendsigs.omit.d
 641                         pidof unionfs-fuse >> /run/sendsigs.omit.d/unionfs-fuse || true )
 642                         ;;
 643
 644                 overlayfs)
 645                         # XXX: can unionro2 be used? (overlayfs only handles two dirs, but perhaps they can be chained?)
 646                         # XXX: and can unionro1 be optional? i.e. can overlayfs skip lowerdir?
 647                         unionmountopts="-o noatime,lowerdir=${unionro1},upperdir=${unionrw}"
 648                         mount -t ${UNIONTYPE} ${unionmountopts} ${UNIONTYPE} "${unionmountpoint}"
 649                         ;;
 650
 651                 *)
 652                         unionmountopts="-o noatime,${noxino_opt},dirs=${unionrw}=${rw_opt}"
 653                         if [ -n "${unionro1}" ]
 654                         then
 655                                 unionmountopts="${unionmountopts}:${unionro1}=${ro_opt}"
 656                         fi
 657                         if [ -n "${unionro2}" ]
 658                         then
 659                                 unionmountopts="${unionmountopts}:${unionro2}=${ro_opt}"
 660                         fi
 661                         mount -t ${UNIONTYPE} ${unionmountopts} ${UNIONTYPE} "${unionmountpoint}"
 662                         ;;
 663         esac
 664 }
 665
 666 get_custom_mounts () {
 667         # Side-effect: leaves $devices with live.persist mounted in ${rootmnt}/live/persistent
 668         # Side-effect: prints info to file $custom_mounts
 669
 670         local devices="${1}"
 671         local custom_mounts="${2}" # print result to this file
 672         local rootmnt="${3}"       # should be set empty post-live-boot
 673
 674         local bindings="/bindings.list"
 675         local links="/links.list"
 676         rm -rf ${bindings} ${links} 2> /dev/null
 677         local persistent_backing="${rootmnt}/live/persistent"
 678
 679         for device in ${devices}
 680         do
 681                 if [ ! -b "${device}" ]
 682                 then
 683                         continue
 684                 fi
 685                 local device_name="$(basename ${device})"
 686                 local backing="${persistent_backing}/${device_name}"
 687                 mkdir -p "${backing}"
 688                 local device_fstype="$(get_fstype ${device})"
 689                 if [ -z "${PERSISTENT_READONLY}" ]
 690                 then
 691                         device_mount_opts="rw,noatime"
 692                 else
 693                         device_mount_opts="ro,noatime"
 694                 fi
 695                 local device_used=""
 696                 mount -t "${device_fstype}" -o "${device_mount_opts}" "${device}" "${backing}"
 697                 local include_list="${backing}/${persistence_list}"
 698                 if [ ! -r "${include_list}" ]
 699                 then
 700                         umount "${backing}"
 701                         rmdir "${backing}"
 702                         continue
 703                 fi
 704
 705                 [ "${DEBUG}" = "Yes" ] && cp ${include_list} ${persistent_backing}/${persistence_list}.${device_name}
 706                 while read source dest options # < ${include_list}
 707                 do
 708                         if echo ${source} | grep -qe "^[[:space:]]*\(#.*\)\?$"
 709                         then
 710                                 # skipping empty or commented lines
 711                                 continue
 712                         fi
 713
 714                         if echo ${dest} | grep -qe "^[^/]"
 715                         then
 716                                 options="${dest}"
 717                                 dest="${source}"
 718                         elif [ -z "${dest}" ]
 719                         then
 720                                 dest="${source}"
 721                         fi
 722
 723                         if echo ${dest} | grep -qe "^/\+$\|^/\+live\(/.*\)\?$"
 724                         then
 725                                 # mounting on / or /live could cause trouble
 726                                 log_warning_msg "Skipping unsafe custom mount on ${dest}"
 727                                 continue
 728                         fi
 729
 730                         for opt in $(echo ${options} | tr ',' ' ');
 731                         do
 732                                 case "${opt}" in
 733                                         linkfiles|union)
 734                                                 ;;
 735                                         *)
 736                                                 log_warning_msg "Skipping custom mount with unkown option: ${opt}"
 737                                                 continue 2
 738                                                 ;;
 739                                 esac
 740                         done
 741
 742                         # FIXME: handle case: we already have /a/b in
 743                         # $bindings added from current $device, but
 744                         # now we find /a -- /a should replace /a/b in
 745                         # $bindings.
 746
 747                         # FIXME: handle case: we have /a in $bindings
 748                         # from current $device, now we find /a/b, so
 749                         # we skip /a/b
 750
 751                         # ensure that no multiple-/ occur in paths
 752                         local full_source="$(echo ${backing}/${source}/ | sed -e 's|/\+|/|g')"
 753                         local full_dest="$(echo ${rootmnt}/${dest}/ | sed -e 's|/\+|/|g')"
 754                         device_used="yes"
 755                         if echo ${options} | grep -qe "\<linkfiles\>";
 756                         then
 757                                 echo "${full_source} ${full_dest} ${options}" >> ${links}
 758                         else
 759                                 echo "${full_source} ${full_dest} ${options}" >> ${bindings}
 760                         fi
 761                 done < ${include_list}
 762
 763                 if [ -z "${device_used}" ]
 764                 then
 765                         # this device was not used for / earlier, or
 766                         # custom mount point now, so it's useless
 767                         umount "${backing}"
 768                         rmdir "${backing}"
 769                 fi
 770         done
 771
 772         # We sort the list according to destination so we're sure that
 773         # we won't hide a previous mount. We also ignore duplicate
 774         # destinations in a more or less arbitrary way.
 775         [ -e "${bindings}" ] && sort -k2 -sbu ${bindings} >> ${custom_mounts}
 776         rm ${bindings}
 777
 778         # After all mounts are considered we add symlinks so they
 779         # won't be hidden by some mount.
 780         [ -e "${links}" ] && sort -k2 -sbu ${links} >> ${custom_mounts}
 781         rm ${links}
 782
 783         rm -f ${bindings} ${links} 2> /dev/null
 784         echo ${custom_mounts}
 785 }
 786
 787 do_custom_mounts () {
 788         local custom_mounts="${1}" # the ouput from get_custom_mounts()
 789         local rootmnt="${2}"       # should be set empty post-live-boot
 790
 791         while read source dest options # < ${custom_mounts}
 792         do
 793                 local opt_linkfiles=""
 794                 local opt_union=""
 795                 for opt in $(echo ${options} | tr ',' ' ');
 796                 do
 797                          case "${opt}" in
 798                                 linkfiles)
 799                                         opt_linkfiles="yes"
 800                                         ;;
 801                                 union)
 802                                         opt_union="yes"
 803                                         ;;
 804                         esac
 805                 done
 806
 807                 if mountpoint -q "${dest}";
 808                 then
 809                         log_warning_msg "Skipping custom mount ${source} on ${dest}: destination is already a mount point"
 810                         continue
 811                 fi
 812
 813                 # FIXME: we don't handle already existing
 814                 # non-directory files in the paths of both $source and
 815                 # $dest.
 816
 817                 if [ ! -d "${dest}" ]
 818                 then
 819                         # if ${dest} is in /home/$user, try fixing
 820                         # proper ownership
 821                         # FIXME: this should really be handled by
 822                         # live-config since we don't know for sure
 823                         # which uid a certain user has until then
 824                         if echo ${dest} | grep -qe "^${rootmnt}/*home/\+[^/]\+"
 825                         then
 826                                 path="/"
 827                                 for dir in $(echo ${dest} | sed -e 's|/\+| |g')
 828                                 do
 829                                         path=${path}/${dir}
 830                                         if [ ! -e ${path} ]
 831                                         then
 832                                                 mkdir -p ${path}
 833                                                 # assume that the intended user is the first, which is usually the case
 834                                                 chown 1000:1000 ${path}
 835                                         fi
 836                                 done
 837                         else
 838                                 mkdir -p ${dest}
 839                         fi
 840                 fi
 841
 842                 # if ${source} doesn't exist on our persistent media
 843                 # we bootstrap it with $dest from the live filesystem.
 844                 # this both makes sense and is critical if we're
 845                 # dealing with /etc or other system dir.
 846                 if [ ! -d "${source}" ]
 847                 then
 848                         if [ -n "${PERSISTENT_READONLY}" ] || [ -n "${opt_linkfiles}" ]
 849                         then
 850                                 continue
 851                         elif [ -n "${opt_union}" ]
 852                         then
 853                                 # union's don't need to be bootstrapped
 854                                 mkdir "${source}"
 855                         else
 856                                 # ensure that $dest is not copied *into* $source
 857                                 mkdir -p "$(dirname ${source})"
 858                                 cp -a "${dest}" "${source}"
 859                         fi
 860                 fi
 861
 862                 rofs_dest_backing=""
 863                 for d in ${rootmnt}/live/rofs/*
 864                 do
 865                         if [ -n "${rootmnt}" ]
 866                         then
 867                                 rofs_dest_backing="${d}/$(echo ${dest} | sed -e "s|${rootmnt}||")"
 868                         else
 869                                 rofs_dest_backing="${d}/${dest}"
 870
 871                         fi
 872                         if [ -d "${rofs_dest_backing}" ]
 873                         then
 874                                 break
 875                         else
 876                                 rofs_dest_backing=""
 877                         fi
 878                 done
 879
 880                 if [ -z "${PERSISTENT_READONLY}" ]
 881                 then
 882                         if [ -n "${opt_linkfiles}" ]
 883                         then
 884                                 links_source="${source}"
 885                                 links_dest="${dest}"
 886                         elif [ -n "${opt_union}" ]
 887                         then
 888                                 do_union ${dest} ${source} ${rofs_dest_backing}
 889                         else
 890                                 mount --bind "${source}" "${dest}"
 891                         fi
 892                 else
 893                         if [ -n "${opt_linkfiles}" ]
 894                         then
 895                                 links_dest="${dest}"
 896                                 dest="$(mktemp -d ${persistent_backing}/links_source-XXXXXX)"
 897                                 links_source="${dest}"
 898                         fi
 899                         if [ -n "${rootmnt}" ]
 900                         then
 901                                 cow_dir="$(echo ${dest} | sed -e "s|${rootmnt}|/cow/|")"
 902                         else
 903                                 cow_dir="/live/cow/${dest}"
 904                         fi
 905                         mkdir -p ${cow_dir}
 906                         do_union ${dest} ${cow_dir} ${source} ${rofs_dest_backing}
 907                 fi
 908
 909                 if [ -n "${opt_linkfiles}" ]
 910                 then
 911                         link_files "${links_source}" "${links_dest}" "${rootmnt}"
 912                 fi
 913
 914                 PERSISTENCE_IS_ON="1"
 915                 export PERSISTENCE_IS_ON
 916         done < ${custom_mounts}
 917 }