From 0b4e3ed390b203ea48107ecd3011a5ae0f0a7668 Mon Sep 17 00:00:00 2001 From: Sahan Yılmaz Date: Sun, 23 Feb 2025 13:16:00 +0300 Subject: first commit --- debian/tmp/usr/sbin/overlayroot-chroot | 93 +++ .../share/initramfs-tools/conf-hooks.d/overlayroot | 1 + .../usr/share/initramfs-tools/hooks/overlayroot | 25 + .../scripts/init-bottom/overlayroot | 878 +++++++++++++++++++++ debian/tmp/usr/share/man/man8/overlayroot-chroot.8 | 21 + 5 files changed, 1018 insertions(+) create mode 100755 debian/tmp/usr/sbin/overlayroot-chroot create mode 100644 debian/tmp/usr/share/initramfs-tools/conf-hooks.d/overlayroot create mode 100755 debian/tmp/usr/share/initramfs-tools/hooks/overlayroot create mode 100755 debian/tmp/usr/share/initramfs-tools/scripts/init-bottom/overlayroot create mode 100644 debian/tmp/usr/share/man/man8/overlayroot-chroot.8 (limited to 'debian/tmp/usr') diff --git a/debian/tmp/usr/sbin/overlayroot-chroot b/debian/tmp/usr/sbin/overlayroot-chroot new file mode 100755 index 0000000..6c37962 --- /dev/null +++ b/debian/tmp/usr/sbin/overlayroot-chroot @@ -0,0 +1,93 @@ +#!/bin/sh +# +# overlayroot-chroot - chroot wrapper script for overlayroot +# Copyright (C) 2012 Dustin Kirkland +# +# Authors: Dustin Kirkland +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, version 3 of the License. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +set -e +set -f # disable path expansion +REMOUNTS="" + +error() { + printf "ERROR: $@\n" 1>&2 +} +fail() { [ $# -eq 0 ] || error "$@"; exit 1; } + +info() { + printf "INFO: $@\n" 1>&2 +} + +get_lowerdir() { + local overlay="" + overlay=$(awk \ + '$1 == "overlayroot" && $2 == "/" { print $0 }' /proc/mounts) + if [ -n "${overlay}" ]; then + lowerdir=${overlay##*lowerdir=} + lowerdir=${lowerdir%%,*} + if mountpoint "${lowerdir}" >/dev/null; then + _RET="${lowerdir}" + else + fail "Unable to find the overlayroot lowerdir" + fi + else + fail "Unable to find an overlayroot filesystem" + fi +} + +clean_exit() { + local mounts="$1" rc=0 d="" lowerdir="" mp="" + for d in ${mounts}; do + if mountpoint ${d} >/dev/null; then + umount ${d} || rc=1 + fi + done + for mp in $REMOUNTS; do + mount -o remount,ro "${mp}" || + error "Note that [${mp}] is still mounted read/write" + done + [ "$2" = "return" ] && return ${rc} || exit ${rc} +} + +# Try to find the overlayroot filesystem +get_lowerdir +lowerdir=${_RET} + +recurse_mps=$(awk '$1 ~ /^\/dev\// && $2 ~ starts { print $2 }' \ + starts="^$lowerdir/" /proc/mounts) + +mounts= +for d in proc run sys; do + if ! mountpoint "${lowerdir}/${d}" >/dev/null; then + mount -o bind "/${d}" "${lowerdir}/${d}" || fail "Unable to bind /${d}" + mounts="$mounts $lowerdir/$d" + trap "clean_exit \"${mounts}\" || true" EXIT HUP INT QUIT TERM + fi +done + +# Remount with read/write +for mp in "$lowerdir" $recurse_mps; do + mount -o remount,rw "${mp}" && + REMOUNTS="$mp $REMOUNTS" || + fail "Unable to remount [$mp] writable" +done +info "Chrooting into [${lowerdir}]" +chroot ${lowerdir} "$@" + +# Clean up mounts on exit +clean_exit "${mounts}" "return" +trap "" EXIT HUP INT QUIT TERM + +# vi: ts=4 noexpandtab diff --git a/debian/tmp/usr/share/initramfs-tools/conf-hooks.d/overlayroot b/debian/tmp/usr/share/initramfs-tools/conf-hooks.d/overlayroot new file mode 100644 index 0000000..3d812b6 --- /dev/null +++ b/debian/tmp/usr/share/initramfs-tools/conf-hooks.d/overlayroot @@ -0,0 +1 @@ +export CRYPTSETUP=y diff --git a/debian/tmp/usr/share/initramfs-tools/hooks/overlayroot b/debian/tmp/usr/share/initramfs-tools/hooks/overlayroot new file mode 100755 index 0000000..406ccac --- /dev/null +++ b/debian/tmp/usr/share/initramfs-tools/hooks/overlayroot @@ -0,0 +1,25 @@ +#!/bin/sh +set -e + +PREREQS="cryptsetup" +case $1 in + prereqs) echo "${PREREQS}"; exit 0;; +esac + +. /usr/share/initramfs-tools/hook-functions + +## +copy_exec /usr/bin/head /bin +copy_exec /usr/bin/sha512sum /bin +copy_exec /sbin/wipefs /sbin +copy_exec /sbin/cryptsetup /sbin +copy_exec /sbin/mke2fs /sbin + +# this is '||' only in case aesni_intel module isn't built (or others are built in) +manual_add_modules overlayfs overlay dm_mod dm_crypt aesni_intel || true + +# Grab as much true random data as possible, up to 4KB, and stash it into a +# random seed in the initramfs +dd if=/dev/random of="${DESTDIR}/.random-seed" bs=1 count=4096 iflag=nonblock >/dev/null 2>&1 || true + +# vi: ts=4 noexpandtab diff --git a/debian/tmp/usr/share/initramfs-tools/scripts/init-bottom/overlayroot b/debian/tmp/usr/share/initramfs-tools/scripts/init-bottom/overlayroot new file mode 100755 index 0000000..5c13811 --- /dev/null +++ b/debian/tmp/usr/share/initramfs-tools/scripts/init-bottom/overlayroot @@ -0,0 +1,878 @@ +#!/bin/sh +# Copyright, 2012 Dustin Kirkland +# Copyright, 2012 Scott Moser +# Copyright, 2012 Axel Heider +# +# Based on scripts from +# Sebastian P. +# Nicholas A. Schembri State College PA USA +# Axel Heider +# Dustin Kirkland +# Scott Moser +# +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see +# . + +case "$1" in + # no pre-reqs + prereqs) echo ""; exit 0;; +esac + +. /scripts/functions + +PATH=/usr/sbin:/usr/bin:/sbin:/bin +MYTAG="overlayroot" + +TEMP_D="${TMPDIR:-/tmp}/${0##*/}.configs" +VARIABLES="overlayroot overlayroot_cfgdisk" + +# generic settings +# ${ROOT} and ${rootmnt} are predefined by caller of this script. Note that +# the root fs ${rootmnt} it mounted readonly on the initrams, which fits +# nicely for our purposes. +root_rw=/media/root-rw +root_ro=/media/root-ro +ROOTMNT=${rootmnt} # use global name to indicate created outside this +OVERLAYROOT_DEBUG=0 +# PERSIST_DIR will persist after pivot-root. It is used for log file +# and for the mktemp-made password file in crypt. +PERSIST_DIR=/run/initramfs +if [ ! -d "$PERSIST_DIR" -a -d /dev/.initramfs ]; then + PERSIST_DIR="/dev/.initramfs" +fi +if [ ! -d "$PERSIST_DIR" ]; then + mkdir -p "$PERSIST_DIR" || + echo "WARNING: $MYTAG: failed to create ${PERSIST_DIR}" 1>&2 +fi +LOG_FILE="${PERSIST_DIR}/${MYTAG}.log" + +log() { + "log_${1}_msg" "$MYTAG: $2"; + _debug "[$1]:" "$2" +} +log_fail() { log failure "$*"; } +log_success() { log success "$*"; } +log_warn() { log warning "$*"; } +fail() { + [ $# -eq 0 ] || log_fail "$@"; + exit 0; # why do we exit success? +} +cleanup() { + [ -d "${TEMP_D}" ] && rm -Rf "${TEMP_D}" +} +debug() { + _debug "$@" + [ "${OVERLAYROOT_DEBUG:-0}" = "0" ] && return + echo "$MYTAG:" "$@" +} +_debug() { + if [ "${DEBUG_BUSTED:-0}" ]; then + { echo "$@" >> "$LOG_FILE"; } 2>/dev/null || + { DEBUG_BUSTED=1; log_warn "debug is busted"; } + fi +} + +safe_string() { + local prev="$1" allowed="$2" cur="" + [ -n "$prev" ] || return 1 + while cur="${prev#[${allowed}]}"; do + [ -z "$cur" ] && return 0 + [ "$cur" = "$prev" ] && break + prev="$cur" + done + return 1 +} + +parse_string() { + # parse a key/value string like: + # name=mapper,pass=foo,fstype=ext4,mkfs=1 + # set variables under namespace 'ns'. + # _RET_name=mapper + # _RET_pass=foo + # _RET_fstype=ext4 + # set _RET to the list of variables found + local input="${1}" delim="${2:-,}" ns="${3:-_RET_}" + local oifs="$IFS" tok="" keys="" key="" val="" + + set -f; IFS="$delim"; set -- $input; IFS="$oifs"; set +f; + _RET="" + for tok in "$@"; do + key="${tok%%=*}" + val="${tok#${key}}" + val=${val#=} + safe_string "$key" "0-9a-zA-Z_" || + { debug "$key not a safe variable name"; return 1; } + eval "${ns}${key}"='${val}' || return 1 + keys="${keys} ${ns}${key}" + done + _RET=${keys# } + return +} +get_varval() { eval _RET='${'$1'}'; } +write_kernel_cmdline_cfg() { + local cfg="$1" desc="${2:-kernel cmdline}" + local cmdline="" var="" + read cmdline < /proc/cmdline || return 1 + : > "${cfg}" || return + set -f + { + echo "desc='${desc}'" + for tok in $cmdline; do + for var in $VARIABLES; do + if [ "$tok" = "$var" ]; then + log_warn "kernel param without value '${tok}'"; + continue; + elif [ "${tok}" = "${var}=" ]; then + echo "${var}=''"; + elif [ "${tok#${var}=}" != "${tok}" ]; then + echo "${var}='${tok#${var}=}'" + fi + done + done + } >> "$cfg" + set +f +} + +wait_for_dev() { + local dev="$1" timeout="${2:-0}" + [ -b "$dev" ] && return 0 + [ "$timeout" = "0" ] && return 1 + # wait-for-root writes fstype to stdout, redirect to null + wait-for-root "$dev" "$timeout" >/dev/null +} +crypto_setup() { + local fstype="ext4" pass="" mapname="secure" mkfs="1" dev="" + local timeout=0 + local entropy_sources="/proc/sys/kernel/random/boot_id /proc/sys/kernel/random/uuid /dev/urandom" + local seed="" rootseed="$ROOTMNT/var/lib/urandom/random-seed" + if [ ! -f "$rootseed" -a -f "$ROOTMNT/var/lib/systemd/random-seed" ]; then + rootseed="$ROOTMNT/var/lib/systemd/random-seed" + fi + # Seed the psuedo random number generator with available seeds + for seed in "/.random-seed" "$rootseed"; do + [ -f "${seed}" ] || + { debug "missing rng seed [${seed}]"; continue; } + cat "${seed}" > /dev/urandom || + debug "failed seeding /dev/urandom from $seed" + done + # this does necessary crypto setup and sets _RET + # to the appropriate block device (ie /dev/mapper/secure) + + # mkfs (default is 1): + # 0: never create filesystem + # 1: if pass is given and mount fails, create a new one + # if no pass given, create new + # 2: if pass is given and mount fails, fail + # if no pass given, create new + local options="$1" + parse_string "${options}" || + { log_fail "failed parsing '${options}'"; return 1; } + + fstype=${_RET_fstype:-${fstype}} + pass=${_RET_pass:-${pass}} + mapname=${_RET_mapname:-${mapname}} + mkfs=${_RET_mkfs:-${mkfs}} + dev=${_RET_dev:-${dev}} + timeout=${_RET_timeout:-${timeout}} + + [ -n "$dev" ] || + { log_fail "dev= argument not provided in '${options}'"; return 1; } + + short2dev "$dev" || + { log_fail "failed to convert $dev to a device"; return 1; } + dev="${_RET}" + + debug "fstype=${fstype} pass=${pass} mapname=${mapname}" + debug "mkfs=${mkfs} dev=${dev} timeout=${timeout}" + + wait_for_dev "$dev" "$timeout" || { + log_fail "crypt dev device $dev does not exist after ${timeout}s"; + return 1; + } + + if [ -n "$pass" ]; then + printf "%s" "$pass" | + cryptsetup luksOpen "$dev" "$mapname" --key-file - + if [ $? -eq 0 ]; then + local tdev="/dev/mapper/$mapname" + log_warn "reusing existing luks device at $dev" + wait_for_dev "$tdev" 20 || + { log_fail "$tdev did not appear"; return 1; } + _RET_DEVICE="/dev/mapper/$mapname" + return 0 + fi + if [ "$mkfs" != "1" ]; then + log_fail "luksOpen failed on $dev with mkfs=$mkfs"; + return 1; + fi + log_warn "re-opening $dev failed with mkfs=$mkfs will create new" + else + [ "$mkfs" = "0" ] && + { log_fail "mkfs=0, but no password provided"; return 1; } + entropy_sources="$entropy_sources $dev" + local tmpf="" pass_file="${PERSIST_DIR}/${MYTAG}.passwd" + tmpf=$(mktemp "${PERSIST_DIR}/${MYTAG}.XXXXXX") || + { log_fail "failed creation of password file"; return 1; } + stat -L /dev/* /proc/* /sys/* >"$tmpf" 2>&1 || + { log_warn "could not seed with stat entropy [$entropy_sources]"; } + head -c 4096 $entropy_sources >> "$tmpf" || + { log_fail "failed reading entropy [$entropy_sources]"; return 1; } + pass=$(sha512sum "$tmpf") || + { log_fail "failed generation of password"; return 1; } + pass=${pass%% *} + printf "%s" "${pass}" > "$tmpf" || + { log_fail "failed to record password to '$tmpf'"; return 1; } + mv "$tmpf" "${pass_file}" || + { log_fail "failed rename '$tmpf' to '${pass_file}'"; return 1; } + log_debug "stored password in ${pass_file}" + fi + + log_warn "setting up new luks device at $dev" + # clear backing device + wipefs -a "$dev" || + { log_fail "failed to wipe $dev"; return 1; } + printf "%s" "$pass" | cryptsetup luksFormat "$dev" --key-file - || + { log_fail "luksFormat $dev failed"; return 1; } + printf "%s" "$pass" | + cryptsetup luksOpen "$dev" "$mapname" --key-file - || + { log_fail "luksOpen $dev failed"; return 1; } + mke2fs -t "${fstype}" "/dev/mapper/${mapname}" || { + log_fail "failed to mkfs -t $fstype on map $mapname"; + return 1; + } + + _RET_DEVICE="/dev/mapper/$mapname" + return 0 +} + +dev_setup() { + local options="$1" dev="" timeout=0 path="/" + # options supported: + # dev=device,timeout=X,path=/ + parse_string "${options}" || + { log_fail "failed parsing '${options}'"; return 1; } + + dev=${_RET_dev:-${dev}} + timeout=${_RET_timeout:-${timeout}} + + [ -n "$dev" ] || + { log_fail "dev= argument not provided in '${options}'"; return 1; } + + short2dev "$dev" || + { log_fail "failed to convert $dev to a device"; return 1; } + dev="${_RET}" + + debug "dev=${dev} timeout=${timeout}" + + wait_for_dev "$dev" "$timeout" + _RET_DEVICE="$dev" +} + +clean_path() { + # remove '//' in a path. + local p="$1" tmp="" + while [ "${p#*//}" != "$p" ]; do + tmp=${p#*//} + p="${p%%//*}/${tmp}" + done + _RET="$p" +} + +get_workdir() { + local root_rw="$1" dir_prefix="$2" file="$3" + file=${file%/} + if [ "$file" = "/" -o "$file" = "" ]; then + file="_" + fi + clean_path "${root_rw}/${dir_prefix%/}-workdir/${file}" +} + +gen_fstab() { + # gen_fstab(mp) - generate a fabricated /etc/fstab for mount point $mp + local mp="$1" m_spec="" m_opts="" m_fstype="" + local spec file vfstype opts pass freq + + # just remove any trailing / + [ "$mp" != "/" ] && mp=${mp%/} + while read spec file vfstype opts pass freq; do + [ "$file" = "$mp" ] && { + m_spec="$spec" + m_opts="$opts" + m_fstype="$vfstype" + break + } + done &2 + return 1 + fi + set -e + echo "desc=${__tick}${__desc}${__tick}" + for var in ${__vars}; do + eval val=\${${var}-${__unset__}} || + { echo "eval of $var failed"; exit 1; } + [ "${val#*${__tick}}" = "${val}" ] || { + echo "variable \"$var\" had single tick in it. fail"; + exit 1; + } + [ "${val}" = "${__unset__}" ] || + echo "$var=${__tick}${val}${__tick}" + done + ' -- "$@" +} + +readcfgd() { + local cfg_d="$1" + # this kind of stinks, each VARIABLE goes into global scope + local or="" or_cfgdisk="" + _RET_desc_oroot="" + _RET_desc_cfgdisk="" + set +f + for f in "${cfg_d}"/*; do + . "$f" || fail "failed reading $f" + [ "$or" != "${overlayroot}" ] && + _RET_desc_oroot="$desc" + [ "${or_cfgdisk}" != "${overlayroot_cfgdisk}" ] && + _RET_desc_cfgdisk="$desc" + or=${overlayroot} + or_cfgdisk=${overlayroot_cfgdisk} + done + set -f +} + +fix_upstart_overlayfs() { + # inotify events on an overlayfs underlay do not propogate through + # a newly created overlay. This causes job creation and deletion issues + # for upstart, which uses inotify on /etc/init. So ensure that the overlay + # explicitly has a /etc/init (LP: #1213925) + local root="$1" + local initctl="$root/sbin/initctl" + local eifile="/etc/init/.overlayfs-upstart-helper" + + [ -e "$initctl" -o -L "$initctl" ] || return 0 + [ -d "$root/etc/init" ] || return 0 + echo "#upstart needs help for overlayfs (LP: #1213925)." \ + > "$root/$eifile" || + { log_fail "failed to write $root/$eifile"; return 1; } + debug "created $eifile under $root (LP: #1213925)" +} + +needs_workdir() { + local uname_r="${UNAME_R}" + if [ -z "$uname_r" ]; then + uname_r=$(uname -r) && UNAME_R="$uname_r" || + { log_warn "failed to read uname!"; return 2; } + fi + # 3.18+ require 'workdir=' option. + case "${uname_r}" in + 2*|3.1[01234567]*|3.[0-9].*) return 1;; + *) return 0;; + esac +} + + +search_fs_driver() { + # search_fs_driver(driver1, driver2...) + # return the first supported filesystem driver in the list. + # if no drivers are provided, search default list. + # assumes that name in /proc/filesystems and module name are the same. + local m="" driver="" tab=' ' + for m in "$@"; do + grep -q "${tab}$m$" /proc/filesystems && driver="$m" && + { debug "/proc/filesystems support for '$m'"; break; } + done + if [ -z "$driver" ]; then + for m in "$@"; do + if modprobe -qb "$m"; then + if grep -q "${tab}$m$" /proc/filesystems; then + debug "loaded module '$m'"; + driver="$m" + break; + else + log_warn "loaded '$m' module but no '$m' in /proc/filesystems" + fi + fi + done + fi + [ -n "$driver" ] || + { debug "Unable to find driver/module. searched: $*"; return 1; } + _RET="$driver" +} + +cfgd="${TEMP_D}/configs" +mkdir -p "${cfgd}" || fail "failed to create tempdir" +trap cleanup EXIT + +# collect the different config locations into a file +# write individual config files in $cfgd that contain +{ +echo "desc='builtin'" +echo "overlayroot=''" +echo "overlayroot_cfgdisk='disabled'" +} > "$cfgd/00-builtin" + +write_kernel_cmdline_cfg "${cfgd}/90-kernel" || + fail "failed to read kernel command line!" + +parse_cfg "/conf/conf.d/overlayroot" "initramfs config" \ + "$VARIABLES" > "${cfgd}/10-initramfs" || + fail "failed parsing initramfs config" + +parse_cfg "${ROOTMNT}/etc/overlayroot.conf" "$ROOT/etc/overlayroot.conf" \ + "$VARIABLES" > "${cfgd}/20-root-config" || + fail "failed parsing root config" + +parse_cfg "${ROOTMNT}/etc/overlayroot.local.conf" \ + "$ROOT/etc/overlayroot.local.conf" \ + "$VARIABLES" > "${cfgd}/30-root-local-config" || + fail "failed parsing root config" + +# now read the trusted configs, to see if overlayroot_cfgdisk is set +readcfgd "$cfgd" || + fail "reading configs failed" +used_desc="${_RET_desc_oroot}" + +[ -n "${_RET_desc_cfgdisk}" ] && + debug "${_RET_desc_cfgdisk} set cfgdisk='${overlayroot_cfgdisk}'" + +# if one of the trusted configs above gave us set the overlayroot_cfgdisk +# variable, then look for such a device and read a config from it. +cfgdisk=0 +if [ "${overlayroot_cfgdisk:-disabled}" != "disabled" ] && + get_cfg "${overlayroot_cfgdisk}" "${TEMP_D}/cfgdisk"; then + desc=${_RET} + parse_cfg "${TEMP_D}/cfgdisk" "${desc}" "$VARIABLES" \ + > "${cfgd}/80-cfgdisk" || + fail "reading config from ${desc} failed" + used_desc="${_RET_desc_oroot}" + + # now read the parsed configs again. + readcfgd "$cfgd" || + fail "reading configs failed" + + [ -n "${_RET_desc_cfgdisk}" ] && + debug "${_RET_desc_cfgdisk} set cfgdisk=${overlayroot_cfgdisk}" + [ -n "${_RET_desc_oroot}" ] && + debug "${_RET_desc_oroot} set overlayroot=${overlayroot}" +fi + +opts="" +cfgmsg="${used_desc:+ (per ${used_desc})}" +case "${overlayroot:-disabled}" in + tmpfs|tmpfs:*) + mode="tmpfs" + opts="${overlayroot#tmpfs}"; + opts=${opts#:} + ;; + /dev/*|device:*) + case "$overlayroot" in + /dev/*) opts="dev=${overlayroot}";; + *) opts="${overlayroot#device:}";; + esac + dev_setup "${opts}" || + fail "failed setup overlay for ${overlayroot} [$opts]${cfgmsg}" + mode="device" + device="$_RET_DEVICE" + ;; + crypt:*) + mode="crypt" + opts=${overlayroot#crypt:} + crypto_setup "${opts}" || + fail "failed setup crypt for ${overlayroot}${cfgmsg}" + device="$_RET_DEVICE" + ;; + disabled) + debug "overlayroot disabled${cfgmsg}" + exit 0;; + *) + fail "invalid value for overlayroot: ${overlayroot}${cfgmsg}" + exit 0;; +esac + +parse_string "$opts" "," _RET_common_ +swap=${_RET_common_swap:-0} +recurse=${_RET_common_recurse:-1} +OVERLAYROOT_DEBUG=${_RET_common_debug:-${OVERLAYROOT_DEBUG}} +dir_prefix=${_RET_common_dir:-"/overlay"} +overlayroot_driver=${_RET_common_driver} + +read cmdline "$source_fstab" || + log_fail "gen_fstab failed for $ROOTMNT/$root_ro" +fi + +if [ -f "$source_fstab" ]; then + overlayrootify_fstab "$source_fstab" "$root_ro" \ + "$root_rw" "$dir_prefix" "$recurse" "$swap" "${overlayroot_driver}" \ + > "${ROOTMNT}/etc/fstab" || + log_fail "failed to modify /etc/fstab" +else + debug "rootfs did not contain /etc/fstab." +fi + +# we have to make the directories in ${root_rw} because if they do not +# exist, then the 'upper=' argument to overlayfs will fail. +for d in ${_RET}; do + mkdir -p "${ROOTMNT}/$d" +done + +if [ "${overlayroot_driver}" = "overlayfs" ]; then + fix_upstart_overlayfs "$ROOTMNT" || + log_fail "failed to fix upstart for overlayfs" +fi + +# if / is supposed to be mounted read-only (cmdline with 'ro') +# then mount our overlayfs as read-only just to be more normal +if [ "${cmdline_ro}" = "true" ]; then + mount -o remount,ro "$ROOTMNT" || + log_fail "failed to remount overlayroot read-only" + debug "mounted $ROOTMNT read-only per kernel cmdline" +fi + +msg="configured root with '$overlayroot' using ${overlayroot_driver} per" +msg="$msg ${used_desc}" +log_success "$msg" + +exit 0 +# vi: ts=4 noexpandtab diff --git a/debian/tmp/usr/share/man/man8/overlayroot-chroot.8 b/debian/tmp/usr/share/man/man8/overlayroot-chroot.8 new file mode 100644 index 0000000..57441cd --- /dev/null +++ b/debian/tmp/usr/share/man/man8/overlayroot-chroot.8 @@ -0,0 +1,21 @@ +.TH overlayroot-chroot 8 "20 July 2012" overlayroot-chroot "initramfs-tools-overlayroot" +.SH NAME +\fBoverlayroot-chroot\fP - chroot into the lower filesystem in a writable mode + +.SH SYNOPSIS +\fBoverlayroot-chroot\fP [COMMAND [ARG]...] + +.SH DESCRIPTION +\fBoverlayroot-chroot\fP is a program that sets up bind mounts for \fI/proc\fP, \fI/run\fP, and \fI/sys\fP, remounts the lower directory in an overlayfs with write capabilities and will \fBchroot\fP(8) into it. Upon exit, the bind mounts are unmounted. + +Any [COMMAND [ARG]...] are passed directly through to \fBchroot\fP(8). + +.SH SEE ALSO +.TP +\fBchroot\fP(8) +.PD + +.SH AUTHOR +This manpage and the utility were written by Dustin Kirkland for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document and the utility under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation. + +The complete text of the GNU General Public License can be found in \fI/usr/share/common-licenses/GPL\fP on Debian/Ubuntu systems, or on the web at \fIhttp://www.gnu.org/licenses/gpl.txt\fP. -- cgit v1.2.3