2 # Filename: grml-debootstrap
3 # Purpose: wrapper around debootstrap for installing plain Debian via Grml
4 # Authors: grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
5 # Bug-Reports: see https://grml.org/bugs/
6 # License: This file is licensed under the GPL v2+
7 ################################################################################
10 [ -n "$REPORT_TRAP_ERR" ] || REPORT_TRAP_ERR='no'
11 [ -n "$FAIL_TRAP_ERR" ] || FAIL_TRAP_ERR='no'
15 last_bash_command="$BASH_COMMAND"
16 if [ "$REPORT_TRAP_ERR" = "yes" ]; then
17 echo "Unexpected non-zero exit code $last_exit_code in ${BASH_SOURCE[*]} at line ${BASH_LINENO[*]} detected!
18 last bash command: $last_bash_command"
20 if [ ! "$FAIL_TRAP_ERR" = "yes" ]; then
23 ## Check if "bailout" function is available.
24 ## This is not the case in chroot-script.
25 if command -v bailout >/dev/null 2>&1; then
28 echo 'FAIL_TRAP_ERR is set to "yes", exit 1.'
33 if [ "$REPORT_TRAP_ERR" = "yes" ] || [ "$FAIL_TRAP_ERR" = "yes" ]; then
37 trap "error_handler" ERR
38 export -f "error_handler"
44 if [[ -d "$(dirname "$(command -v "$0")")"/.git ]]; then
45 VERSION="$(git --git-dir $(dirname "$(command -v "$0")")/.git describe | sed 's|^v||')"
47 VERSION="$(dpkg-query --show --showformat='${Version}' "$PN")"
49 VERSION="${VERSION:-unknown}"
50 MNTPOINT="/mnt/debootstrap.$$"
53 [ -n "$CHROOT_SCRIPTS" ] || CHROOT_SCRIPTS='yes'
54 [ -n "$CONFFILES" ] || CONFFILES='/etc/debootstrap'
55 [ -n "$DEBCONF" ] || DEBCONF='yes'
56 [ -n "$DEBIAN_FRONTEND" ] || DEBIAN_FRONTEND='noninteractive'
57 [ -n "$DEBOOTSTRAP" ] || DEBOOTSTRAP='debootstrap'
58 [ -n "$DEFAULT_LANGUAGE" ] || DEFAULT_LANGUAGE='en_US:en'
59 [ -n "$DEFAULT_LOCALES" ] || DEFAULT_LOCALES='en_US.UTF-8'
60 [ -n "$DISK_IDENTIFIER" ] || DISK_IDENTIFIER='26ada0c0-1165-4098-884d-aafd2220c2c6'
61 [ -n "$EXTRAPACKAGES" ] || EXTRAPACKAGES='yes'
62 [ -n "$FALLBACK_MIRROR" ] || FALLBACK_MIRROR='http://deb.debian.org/debian'
63 [ -n "$FIXED_DISK_IDENTIFIERS" ] || FIXED_DISK_IDENTIFIERS="no"
64 [ -n "$FORCE" ] || FORCE=''
65 [ -n "$HOSTNAME" ] || HOSTNAME='grml'
66 [ -n "$INITRD" ] || INITRD='yes'
67 [ -n "$INITRD_GENERATOR" ] || INITRD_GENERATOR='initramfs-tools'
68 [ -n "$INITRD_GENERATOR_OPTS" ] || INITRD_GENERATOR_OPTS=''
69 [ -n "$INSTALL_NOTES" ] || INSTALL_NOTES='/etc/debootstrap/install_notes'
70 [ -n "$LOCALES" ] || LOCALES='yes'
71 [ -n "$MIRROR" ] || MIRROR="$FALLBACK_MIRROR"
72 [ -n "$MKFS" ] || MKFS='mkfs.ext4'
73 [ -n "$MKFS_OPTS" ] || MKFS_OPTS=''
74 [ -n "$PACKAGES" ] || PACKAGES='yes'
75 [ -n "$POST_SCRIPTS" ] || POST_SCRIPTS='yes'
76 [ -n "$PRE_SCRIPTS" ] || PRE_SCRIPTS='yes'
77 [ -n "$RECONFIGURE" ] || RECONFIGURE='console-data'
78 [ -n "$RELEASE" ] || RELEASE='bookworm'
79 [ -n "$RM_APTCACHE" ] || RM_APTCACHE='yes'
80 [ -n "$SCRIPTS" ] || SCRIPTS='no' # deprecated, replaced by POST_SCRIPTS
81 [ -n "$SECURE" ] || SECURE='yes'
82 [ -n "$TIMEZONE" ] || TIMEZONE='Europe/Vienna'
83 [ -n "$TUNE2FS" ] || TUNE2FS='tune2fs -c0 -i0'
84 [ -n "$UPGRADE_SYSTEM" ] || UPGRADE_SYSTEM='yes'
85 [ -n "$VMSIZE" ] || VMSIZE="2G"
86 [ -n "$GRUB_INSTALL" ] || GRUB_INSTALL='yes'
88 # inside the chroot system locales might not be available, so use minimum:
93 # make sure interactive mode is only executed when
94 # using an empty configuration file or option --interactive
100 echo "$PN - wrapper around debootstrap for installing Debian
106 -m, --mirror <URL> Mirror which should be used for apt-get/aptitude.
107 -i, --iso <mnt> Mountpoint where a Debian ISO is mounted to, for use
108 instead of fetching packages from a mirror.
109 -r, --release <name> Release of new Debian system (default: bullseye).
110 -t, --target <target> Target partition (/dev/...) or directory where the
111 system should be installed to.
112 -p, --mntpoint <mnt> Mountpoint used for mounting the target system,
113 has no effect if -t is given and represents a directory.
114 --debopt <params> Extra parameters passed to the debootstrap command.
115 --interactive Use interactive mode (frontend).
116 --nodebootstrap Skip debootstrap, only do configuration to the target.
117 --grub <device> Target for grub installation. Usage example: /dev/sda
118 --efi <device> Target for EFI installation. Usage example: /dev/sda1
119 --arch <arch> Set target architecture, use for installing i386 on amd64.
120 --filesystem <fs> Filesystem that should be used when target is a partition
121 or Virtual Machine (see --vmfile).
122 --force Do not prompt for user acknowledgement.
124 Options for Virtual Machine deployment:
126 --vm Set up a Virtual Machine on an existing block device
127 instead of plainly installing to a partition or
128 directory. Needs to be combined with --target.
129 Example: --vm --target /dev/mapper/your-vm-disk
130 --vmfile Like --vm, but install into a regular file (created by
131 'qemu-img create -f raw ...') instead.
132 Example: --vmfile --target /mnt/sda1/qemu.img
133 --vmsize <size> Use specified size for size of VM file (default: 2G).
134 Syntax as supported by qemu-img, like: --vmsize 3G
135 --vmefi Create an EFI boot partition for the VM.
137 Configuration options:
139 -c, --config <file> Use specified configuration file, defaults to
140 /etc/debootstrap/config
141 -d, --confdir <path> Place of config files for debootstrap, defaults
143 --packages <file> Install packages defined in specified list file
144 instead of using /etc/debootstrap/packages.
145 --nopackages Skip installation of packages defined in
146 /etc/debootstrap/packages
147 --nokernel Skip installation of default kernel images.
148 --nointerfaces Do not copy /etc/network/interfaces from host system
150 (This option is automatically enabled when using --vmfile.)
151 --defaultinterfaces Install a default /etc/network/interfaces file (enabling
152 DHCP for eth0) instead of taking over config from host system.
153 --debconf <file> Pre-seed packages using specified pre-seed db file.
154 --grmlrepos Enable Grml's Debian repository (deb.grml.org).
155 --backportrepos Enable Debian's backports repository (backports.debian.org).
156 --keep_src_list Do not overwrite user provided apt sources.list.
157 --contrib Enable 'contrib' in COMPONENTS (defaults to 'main' only).
158 --non-free Enable non-free / non-free-firmware in COMPONENTS (defaults to 'main' only).
159 --hostname <name> Hostname of Debian system.
160 --nopassword Do not prompt for the root password.
161 --password <pwd> Use specified password as password for user root.
162 --sshcopyauth Use ${HOME}/.ssh/authorized_keys to authorise root login on the target system.
163 --sshcopyid Use locally available public keys to authorise root login on the target system.
164 --bootappend <line> Add specified appendline to kernel whilst booting.
165 --chroot-scripts <d> Execute chroot scripts from specified directory.
166 --pre-scripts <dir> Execute scripts from specified directory (before chroot-scripts).
167 --scripts <dir> Execute scripts from specified directory (after chroot-scripts).
168 --remove-configs Delete grml-debootstrap configuration files from installed system.
172 -v, --verbose Increase verbosity.
173 --debug Execute in very verbose way.
174 -h, --help Print this usage information and exit.
175 -V, --version Show summary of options and exit.
177 Usage examples can be found in the grml-debootstrap manpage.
178 Send bugreports to the grml-team: bugs (at) grml.org || https://grml.org/bugs/
182 if [ "$1" = '-h' ] || [ "$1" = '-help' ] || [ "$1" = "--help" ] ; then
184 echo 'Please notice that this script requires root permissions!'
189 # early helper functions {{{
190 # skip colors when running within a dumb terminal
191 if [ "${TERM}" = "dumb" ] ; then
209 [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
210 printf " %s*%s $*" "${GOOD}" "${NORMAL}"
216 printf " %s*%s $*\\n" "${WARN}" "${NORMAL}"
221 [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
222 printf " %s*%s $*\\n" "${BAD}" "${NORMAL}" >&2
228 local retval="${1:-0}"
230 if [ "$retval" -gt 0 ]; then
231 printf " %s-> Failed (rc=%s)%s\\n" "${BAD}" "${retval}" "${NORMAL}"
237 if [ "$(id -u 2>/dev/null)" != 0 ] ; then
238 echo 1>&2 "Error: please run this script with uid 0 (root)." ; return 1
245 command -v "$arg" >/dev/null 2>&1 || RC="$arg"
247 if [ -n "$RC" ] ; then
248 echo "$RC not installed"
254 # helper functions {{{
256 if [ -n "$CHROOT_VARIABLES" ] ; then
257 einfo "Removing ${CHROOT_VARIABLES}" ; rm "$CHROOT_VARIABLES" ; eend $?
260 if [ -n "$STAGES" ] ; then
261 einfo "Removing ${STAGES}" ; rmdir "$STAGES" ; eend $?
264 if [ -n "$ARM_EFI_TARGET" ]; then
265 umount "${MNTPOINT}/boot/efi" >/dev/null 2>&1
268 # Remove temporary mountpoint again
269 if echo "$MNTPOINT" | grep -q '/mnt/debootstrap\.' ; then
270 rmdir "$MNTPOINT" 2>/dev/null
273 # make sure $TARGET is not mounted when exiting grml-debootstrap
274 if [ -n "$MNTPOINT" ] ; then
275 if grep -q "$MNTPOINT" /proc/mounts ; then
276 # make sure nothing is left inside chroot so we can unmount it
277 for service in ssh mdadm ; do
278 if [ -x "${MNTPOINT}/etc/init.d/${service}" ] ; then
279 chroot "$MNTPOINT" "/etc/init.d/${service}" stop
283 [ -x "$MNTPOINT"/bin/umount ] && chroot "$MNTPOINT" umount -a >/dev/null 2>&1
285 # ugly, but make sure we really don't leave anything (/proc /proc and
286 # /dev /dev are intended, trying to work around timing issues, see #657023)
287 for ARG in /run/udev /sys /proc /proc /dev/pts /dev/pts /dev /dev ; do
288 [ -x "$MNTPOINT"/bin/umount ] && chroot "$MNTPOINT" umount $ARG >/dev/null 2>&1
289 umount "$MNTPOINT"/$ARG >/dev/null 2>&1
292 if [ -n "$ISODIR" ] ; then
293 [ -d "$MNTPOINT/$ISODIR" ] && umount "$MNTPOINT/$ISODIR" >/dev/null 2>&1
296 if [ -n "$DIRECTORY" ] ; then
297 einfo "Not unmounting $MNTPOINT as you requested me to install into a directory of your own choice."
299 einfo "Unmounting $MNTPOINT"
304 if [ -n "$STAGES" ] ; then
305 echo -n "Removing stages directory ${STAGES}: "
306 rm -rf "$STAGES" && echo 'done'
309 # remove directory only if we used the default with process id inside the name
310 if echo "$MNTPOINT" | grep -q '/mnt/debootstrap\.' ; then
311 einfo "Removing directory ${MNTPOINT}"
318 if [ -n "${ORIG_TARGET}" ] ; then
319 einfo "Removing loopback mount of file ${ORIG_TARGET}."
320 kpartx -d "${ORIG_TARGET}"
321 # Workaround for a bug in kpartx which doesn't clean up properly,
322 # see Debian Bug #891077 and Github-PR grml/grml-debootstrap#112
323 if dmsetup ls | grep -q "^${LOOP_PART} "; then
324 kpartx -d "/dev/${LOOP_DISK}" >/dev/null
330 # we want to exit smoothly and clean:
335 [ -n "$1" ] && EXIT="$1" || EXIT="1"
336 [ -n "$2" ] && einfo "Notice: remove $STAGES/$2 to reexecute the stage"
340 trap bailout HUP INT QUIT TERM
342 # we want to execute all the functions only once, simple check for it:
344 if [ -n "$2" ] ; then
345 echo "$2" > "${STAGES}/${1}"
347 elif grep -q 'done' "${STAGES}/${1}" 2>/dev/null ; then
348 ewarn "Notice: stage $1 has been executed already, skipping execution therefore."
349 ewarn " To reexecute it clean up the according directory inside $STAGES"
355 # source main configuration file {{{
356 if [ -r /etc/debootstrap/config ] ; then
357 # shellcheck disable=SC1091
358 . /etc/debootstrap/config
362 # cmdline handling {{{
363 CMDLINE_OPTS=mirror:,iso:,release:,target:,mntpoint:,debopt:,defaultinterfaces,interactive,nodebootstrap,nointerfaces,nokernel,nopackages,filesystem:,config:,confdir:,packages:,chroot-scripts:,scripts:,post-scripts:,pre-scripts:,debconf:,vm,vmfile,vmsize:,vmefi,keep_src_list,hostname:,password:,nopassword,grmlrepos,backportrepos,bootappend:,grub:,efi:,arch:,insecure,verbose,help,version,force,debug,contrib,non-free,remove-configs,sshcopyid,sshcopyauth
365 _opt_temp=$(getopt --name grml-debootstrap -o +m:i:r:t:p:c:d:vhV --long \
366 $CMDLINE_OPTS -- "$@")
369 eerror "Try 'grml-debootstrap --help' for more information."; eend 1; exit 1
371 eval set -- "$_opt_temp"
376 # == Bootstrap options
377 --mirror|-m) # Mirror which should be used for apt-get/aptitude
378 shift; _opt_mirror="$1"
380 --iso|-i) # Mountpoint where a Debian ISO is mounted to
383 --release|-r) # Release of new Debian system
384 shift; _opt_release="$1"
386 --target|-t) # Target partition (/dev/...) or directory
387 shift; _opt_target="$1"
389 --vm) # Virtual machine image (no file)
392 --vmfile) # Virtual machine file
395 --vmsize) # size of Virtual machine file
396 shift; _opt_vmsize="$1"
398 --vmefi) # Create an EFI boot partition for the VM
401 --mntpoint|-p) # Mountpoint used for mounting the target system
402 shift; _opt_mntpoint="$1"
404 --debopt) # Extra parameters passed to the debootstrap command
405 shift; _opt_debopt="$1"
407 --filesystem) # Filesystem that should be used
408 shift; _opt_filesystem="$1" ; FILESYSTEM="${_opt_filesystem}"
410 --interactive) # Use interactive mode (frontend)
413 --nodebootstrap) # Skip debootstrap, only do configuration to the target
416 --nopackages) # Skip installation of packages defined in /etc/debootstrap/packages
419 --arch) # Target architecutre
420 shift; _opt_arch="$1"
422 # just for backwards compatibility
428 # == Configuration options
429 --config|-c) # Use specified configuration file, defaults to /etc/debootstrap
430 shift; _opt_config="$1"
432 --confdir|-d) # Place of config files for debootstrap, defaults to /etc/debootstrap
433 shift; _opt_confdir="$1"
435 --packages) # Install packages defined in specified file
436 shift; _opt_packages="$1"
439 --debconf) # Pre-seed packages using specified file
440 shift; _opt_debconf="$1"
443 --pre-scripts) # Execute scripts from specified directory (before chroot-scripts).
444 shift; _opt_pre_scripts="$1"
445 _opt_pre_scripts_set=T
447 --scripts) # Execute scripts from specified directory [NOTE: deprecated, replaced via --post-scripts]
448 shift; _opt_scripts="$1"
451 --post-scripts) # Execute scripts from specified directory
452 shift; _opt_post_scripts="$1"
453 _opt_post_scripts_set=T
455 --chroot-scripts) # Execute chroot scripts from specified directory
456 shift; _opt_chroot_scripts="$1"
457 _opt_chroot_scripts_set=T
459 --keep_src_list) # Do not overwrite user provided apt sources.list
462 --hostname) # Hostname of Debian system
463 shift; _opt_hostname="$1"
465 --password) # Use specified password as password for user root
466 shift; _opt_password="$1"
468 --defaultinterfaces) # Install default /etc/network/interfaces
469 _opt_defaultinterfaces=T
471 --nointerfaces) # Skip installation of /etc/network/interfaces
474 --nokernel) # Skip installation of default kernel images
477 --nopassword) # Skip password dialog
480 --sshcopyid) # Use locally available public keys to authorise root login on the target system
483 --sshcopyauth) # Use .ssh/authorized_keys to authorise root login on the target system
486 --grmlrepos) # Enable Grml repository
489 --backportrepos) # Enable Debian backports repository
492 --bootappend) # Add specified appendline to kernel whilst booting
493 shift; _opt_bootappend="$1"
495 --grub) # Target for grub installation. Use grub syntax for specifying
496 shift; _opt_grub="$1"
498 --efi) # Target for EFI boot installation
501 --contrib) # Add 'contrib' to list of components
504 --non-free) # Add 'non-free' to list of components
507 --remove-configs) # Drop config files from installed system
508 _opt_remove_configs=T
512 --verbose|-v) # Increase verbosity
513 if [ "$_opt_verbose" ]; then
514 _opt_verbose=$( _opt_verbose + 1 )
519 --debug) # Execute in debug mode
522 --help|-h) # Print usage information and exit
525 --version|-V) # Show version information and exit
528 --force) # Do not prompt for user input
535 eerror "Internal getopt error!"; eend 1 ; exit 1
541 # == business-logic of command line parameter-processing
543 # source configuration file in <confdir> if supplied. {{{
544 [ "$_opt_confdir" ] && {
545 CONFFILES=$_opt_confdir
546 einfo "Using config files under $CONFFILES/."
547 if ! [ -r "$CONFFILES/config" ] ; then
548 eerror "Error: config file $CONFFILES/config not found."; eend 1; bailout 1
550 # shellcheck disable=SC1091 source=config
551 if ! . "$CONFFILES/config" ; then
552 eerror "Error reading config file $CONFFILES/config" ; eend 1 ; bailout 1
554 # restore the command line parameter value
555 CONFFILES=$_opt_confdir
559 [ "$_opt_mirror" ] && MIRROR=$_opt_mirror
560 [ "$_opt_iso" ] && ISO=$_opt_iso
561 [ "$_opt_release" ] && RELEASE=$_opt_release
562 [ "$_opt_target" ] && TARGET=$_opt_target
563 [ "$_opt_vm" ] && VIRTUAL=1
564 [ "$_opt_vmfile" ] && VMFILE=1 && VIRTUAL=1
565 [ "$_opt_vmsize" ] && VMSIZE=$_opt_vmsize
566 [ "$_opt_vmefi" ] && VMEFI=1
567 [ "$_opt_mntpoint" ] && MNTPOINT=$_opt_mntpoint
568 [ "$_opt_debopt" ] && DEBOOTSTRAP_OPT=$_opt_debopt
569 [ "$_opt_interactive" ] && INTERACTIVE=1
570 [ "$_opt_config" ] && CONFIGFILE=$_opt_config
571 [ "$_opt_filesystem" ] && MKFS="mkfs.$_opt_filesystem"
572 [ "$_opt_packages_set" ] && PACKAGES='yes'
573 [ "$_opt_nopackages" ] && PACKAGES=''
574 [ "$_opt_debconf_set" ] && DEBCONF='yes'
575 [ "$_opt_post_scripts_set" ] && POST_SCRIPTS='yes'
576 [ "$_opt_pre_scripts_set" ] && PRE_SCRIPTS='yes'
577 [ "$_opt_chroot_scripts_set" ] && CHROOT_SCRIPTS='yes'
578 [ "$_opt_keep_src_list" ] && KEEP_SRC_LIST='yes'
579 [ "$_opt_grmlrepos" ] && GRMLREPOS='yes'
580 [ "$_opt_backportrepos" ] && BACKPORTREPOS='yes'
581 [ "$_opt_hostname" ] && HOSTNAME=$_opt_hostname
582 [ "$_opt_password" ] && ROOTPASSWORD=$_opt_password
583 [ "$_opt_nopassword" ] && NOPASSWORD='yes'
584 [ "$_opt_defaultinterfaces" ] && USE_DEFAULT_INTERFACES="true"
585 [ "$_opt_nointerfaces" ] && NOINTERFACES="true"
586 [ "$_opt_nokernel" ] && NOKERNEL="true"
587 [ "$_opt_sshcopyid" ] && SSHCOPYID="true"
588 [ "$_opt_sshcopyauth" ] && SSHCOPYAUTH="true"
589 [ "$_opt_bootappend" ] && BOOT_APPEND=$_opt_bootappend
590 [ "$_opt_grub" ] && GRUB=$_opt_grub
591 [ "$_opt_efi" ] && EFI=$_opt_efi
592 [ "$_opt_arch" ] && ARCH=$_opt_arch
593 [ "$_opt_insecure" ] && echo "Warning: --insecure is deprecated, continuing anyway."
594 [ "$_opt_force" ] && FORCE=$_opt_force
595 [ "$_opt_verbose" ] && VERBOSE="-v"
596 [ "$_opt_debug" ] && DEBUG="true"
597 [ "$_opt_remove_configs" ] && REMOVE_CONFIGS="yes"
599 # make sure main is always included
600 [ -z "$COMPONENTS" ] && COMPONENTS="main"
601 [ "$_opt_contrib" ] && COMPONENTS="$COMPONENTS contrib"
604 lenny|squeeze|wheezy|jessie|stretch|buster|bullseye)
605 [ "$_opt_non_free" ] && COMPONENTS="$COMPONENTS non-free"
608 [ "$_opt_non_free" ] && COMPONENTS="$COMPONENTS non-free-firmware non-free"
612 # command line option checks
613 if [ "$_opt_scripts_set" ] ; then
614 ewarn "Deprecation NOTE: --scripts option is deprecated, please switch to --post-scripts instead."
615 SCRIPTS='yes' # deprecated since grml-debootstrap >=0.71
618 if [ "$_opt_grub" ] && [ "$_opt_vmfile" ] ; then
619 eerror "The --grub option is incompatible with --vmfile, please drop it from your command line."
620 eerror "The --grub option is unneeded as GRUB will be installed automatically (unless GRUB_INSTALL='no')."
625 if [ "${_opt_sshcopyid}" ] && [ "${_opt_sshcopyauth}" ] ; then
626 eerror "The --sshcopyid option is incompatible with --sshcopyauth, please drop either of them from your command line."
631 if [ -n "$ISO" ] && [[ "$DEBOOTSTRAP" =~ mmdebstrap$ ]] ; then
632 eerror "The ISO option is incompatible with usage of mmdebstrap for bootstrapping."
633 eerror "Either drop the --iso ... option or use plain debootstrap instead."
638 if [ "$DEBUG" = "true" ] ; then
642 [ "$_opt_help" ] && {
647 [ "$_opt_version" ] && {
648 einfo "$PN - version $VERSION"
649 einfo "Report bugs via https://github.com/grml/grml-debootstrap/ or https://grml.org/bugs/"
654 # check for root permissions {{{
655 if ! check4root ; then
656 echo "For usage instructions please execute '$PN --help'."
661 # make sure we have what we need {{{
662 check4progs "${DEBOOTSTRAP}" || bailout 1
664 if [ -n "$VIRTUAL" ] ; then
665 check4progs kpartx parted qemu-img || bailout 1
669 # source specified configuration file {{{
670 if [ -n "$CONFIGFILE" ] ; then
671 einfo "Reading specified config file $CONFIGFILE."
672 # shellcheck disable=SC1091 source=config
673 if ! . "$CONFIGFILE" ; then
674 eerror "Error reading config file $CONFIGFILE" ; eend 1 ; bailout 1
679 # backwards compatibility checks {{{
680 if [ -n "$GROOT" ] ; then
681 eerror "Error: you seem to have \$GROOT configured."
682 eerror "This variable is no longer supported, please visit the"
683 eerror "grml-debootstrap documentation for details."
688 if echo "$GRUB" | grep -q '^hd' ; then
689 eerror "Error: this syntax for the grub configuration variable is no longer supported."
690 eerror "Please do not use hd... any longer but /dev/sdX instead."
699 dialog --title "$PN" --yesno "Welcome to the interactive configuration of ${PN}.
700 Do you want to continue installing Debian using this frontend?" 0 0 || bailout 0
707 AVAILABLE_PARTITIONS=$(LANG=C fdisk -l 2>/dev/null | \
709 grep -v 'Extended$' | \
710 gawk -v num=0 -v ORS=' ' '/^\/dev\// {print $1}'; ls /dev/md[0-9]* 2>/dev/null || true);
712 if [ -z "$AVAILABLE_PARTITIONS" ] ; then
713 dialog --title "$PN" --trim \
714 --msgbox "Sorry, no partitions found. Please configure your
715 harddisks (see /proc/partitions) using a tool like fdisk,
716 cfdisk, gpart, gparted,..." 0 0
720 PARTITION_LIST=$(for i in $AVAILABLE_PARTITIONS ; do
721 fs="$(blkid -s TYPE -o value "$i" 2>/dev/null)"
722 [ -n "$fs" ] || fs='[no_filesystem_yet]'
727 # shellcheck disable=SC2086
728 TARGET=$(dialog --title "$PN" --single-quoted --stdout \
729 --menu "Please select the target partition:" 0 0 0 \
731 [ $? -eq 0 ] || bailout 1
735 # ask for bootmanager {{{
736 prompt_for_bootmanager()
740 if echo "$TARGET" | grep -q "/dev/md" ; then
741 MBRPART="all disks of Software RAID $TARGET"
743 # figure out whole disk device
745 for device in /dev/disk/by-id/*
747 [ "$(readlink -f "$device")" = "${TARGET}" ] || continue
751 # shellcheck disable=SC2001
752 [ -n "$found" ] && MBRDISK=$(echo "${device}" | sed -e 's/-part[0-9][0-9]*$//')
753 if [ -e "$MBRDISK" ]; then
754 MBRDISK=$(readlink -f "$MBRDISK")
756 # fall back to old behaviour
757 # shellcheck disable=SC2001
758 MBRDISK=$(echo "${TARGET}" | sed -e 's/[0-9][0-9]*$//')
761 MBRPART="MBR of $MBRDISK"
764 for device in cciss/c0d0 sda hda; do
765 if [ "/dev/$device" != "${MBRDISK}" ]; then
766 grep -q $device /proc/partitions && \
767 ADDITIONAL_PARAMS="$ADDITIONAL_PARAMS:$device:install bootmanager grub into MBR of /dev/$device"
770 ADDITIONAL_PARAMS=${ADDITIONAL_PARAMS#:}
774 # shellcheck disable=SC2086
775 GETMBR=$(dialog --stdout --title "$PN" --default-item mbr \
776 --menu "Where do you want to install the bootmanager grub?" 0 0 0 \
777 mbr "install bootmanager into $MBRPART" \
778 nowhere "do not install bootmanager at all" \
779 ${ADDITIONAL_PARAMS})
780 [ $? -eq 0 ] || bailout 3
785 # /dev/md0: has to be installed in MBR of /dev/md0 and not in /dev/md:
786 if echo "$TARGET" | grep -q "/dev/md" ; then
805 # ask for Debian release {{{
808 [ -n "$RELEASE" ] && DEFAULT_RELEASE="$RELEASE" || DEFAULT_RELEASE='bullseye'
809 RELEASE="$(dialog --stdout --title "${PN}" --default-item $DEFAULT_RELEASE --menu \
810 "Please enter the Debian release you would like to use for installation:" \
815 sid Debian/unstable)"
816 [ $? -eq 0 ] || bailout
820 # ask for hostname {{{
821 prompt_for_hostname()
823 HOSTNAME="$(dialog --stdout --title "${PN}" --inputbox \
824 "Please enter the hostname you would like to use for installation:" \
826 [ $? -eq 0 ] || bailout
830 # ask for password {{{
831 prompt_for_password()
833 if [ "$_opt_nopassword" ] ; then
834 einfo "Skip asking for root password as requested."
840 while [ "$ROOTPW1" != "$ROOTPW2" ]; do
841 ROOTPW1=$(dialog --insecure --stdout --title "${PN}" --passwordbox \
842 "Please enter the password for the root account:" 10 60)
843 [ $? -eq 0 ] || bailout
845 ROOTPW2=$(dialog --insecure --stdout --title "${PN}" --passwordbox \
846 "Please enter the password for the root account again for \
847 confirmation:" 10 60)
848 [ $? -eq 0 ] || bailout
850 if [ "$ROOTPW1" != "$ROOTPW2" ]; then
851 dialog --stdout --title "${PN}" --ok-label \
852 "Retry" --msgbox "Passwords do not match!" 10 60
855 ROOTPASSWORD="$ROOTPW1"
859 # ask for Debian mirror {{{
862 [ -n "$ISO" ] && DEFAULT_MIRROR='local' || DEFAULT_MIRROR='net'
864 CHOOSE_MIRROR=$(dialog --stdout --title "$PN" --default-item $DEFAULT_MIRROR \
865 --menu "Where do you want to install from?" 0 0 0 \
866 net "install via network (downloading from mirror)" \
867 local "install from local directory/mirror"
869 [ $? -eq 0 ] || bailout
871 if [ "$CHOOSE_MIRROR" = 'net' ] ; then
872 [ -n "$MIRROR" ] || MIRROR='http://deb.debian.org/debian'
873 MIRROR="$(dialog --stdout --title "${PN}" --inputbox \
874 "Please enter Debian mirror you would like to use for installing packages." \
876 [ $? -eq 0 ] || bailout
877 else # CHOOSE_MIRROR == local
878 [ -n "$ISO" ] || ISO='/mnt/mirror'
879 ISO="$(dialog --stdout --title "${PN}" --inputbox \
880 "Please enter directory name you would like to use for installing packages." \
882 [ $? -eq 0 ] || bailout
887 # software raid setup {{{
888 config_swraid_setup()
892 # Currently we support only raid1:
895 MD_LIST=$(for i in $(seq 0 9) ; do
896 awk '{print $4}' /proc/partitions | grep -q "md$i" || \
897 echo "/dev/md$i /dev/md$i"
900 # shellcheck disable=SC2086
901 TARGET=$(dialog --stdout --title "$PN" --default-item /dev/md0 \
902 --menu "Which device do you want to use for ${RAIDLEVEL}?
904 Notice: activated devices will not be listed for security reasons. Anyway, please make sure the selected device is not in use already!" 0 0 0 \
906 [ $? -eq 0 ] || bailout 20
908 AVAILABLE_PARTITIONS=$(LANG=C fdisk -l 2>/dev/null | \
910 grep -v 'Extended$' | \
911 gawk -v num=0 -v ORS=' ' '/^\/dev\// {print $1}')
912 [ -n "$AVAILABLE_PARTITIONS" ] || echo "Fatal error: no partitions available?"
913 PARTITION_LIST=$(for i in $AVAILABLE_PARTITIONS ; do
914 echo "$i $(blkid -s TYPE -o value "$i" 2>/dev/null || echo '[no_filesystem_yet]') off"
917 # shellcheck disable=SC2086
918 dialog --title "$PN" --separate-output \
919 --checklist "Please select the partitions you would like to use for your $RAIDLEVEL on ${TARGET}:" 0 0 0 \
920 $PARTITION_LIST 2>"$TMPFILE"
921 [ $? -eq 0 ] || bailout
922 SELECTED_PARTITIONS="$(cat "$TMPFILE")"
925 while IFS= read -r i; do
926 NUM_PARTITIONS=$(( NUM_PARTITIONS + 1 ))
930 # shellcheck disable=SC2086
931 yes | mdadm --create "${TARGET}" --level="${RAIDLEVEL}" \
932 --raid-devices="${NUM_PARTITIONS}" ${SELECTED_PARTITIONS} >/dev/null 2>$ERRORFILE
934 if [ "$RC" = 0 ] ; then
935 dialog --title "$PN" --msgbox \
936 "Creating $TARGET was successful." 0 0
937 rm -f "$TMPFILE" "$ERRORFILE"
939 dialog --title "$PN" --msgbox \
940 "There was an error setting up $TARGET:
945 rm -f "$TMPFILE" "$ERRORFILE"
953 if dialog --stdout --title "$PN" \
954 --defaultno --yesno "Do you want to configure Software RAID?
956 Please notice that only RAID level 1 is supported by ${PN} currently. Configuration will take place using mdadm." 0 0 ; then
962 # user should recheck his configuration {{{
963 # support full automatic installation:
965 dialog --timeout 10 --title "$PN" \
966 --yesno "Do you want to stop at this stage?
968 Notice: you are running ${PN} in non-interactive mode.
969 ${PN} will install Debian ${RELEASE} on ${TARGET}.
970 Last chance to quit. Timeout of 10 seconds running....
972 Do you want to stop now?" 0 0 2>/dev/null
976 # format efi partition {{{
977 format_efi_partition() {
978 if [ -z "$EFI" ] ; then
982 if ! [ -b "$EFI" ] ; then
983 eerror "Specified efi argument [$EFI] not a valid block device."
987 if fsck.vfat -bn "$EFI" >/dev/null; then
988 einfo "EFI partition $EFI seems to have a FAT filesystem, not modifying."
990 einfo "EFI partition $EFI doesn't seem to be formatted, creating filesystem."
991 mkfs.fat -F32 -n "EFI" "$EFI"
993 if [ ! $RC -eq 0 ] ; then
994 eerror "Error while creating filesystem on ${EFI}."
1002 # check for EFI support or try to enable it {{{
1004 local efivars_loaded=false
1005 # this is for kernels versions before v3.10, which didn't provide efivarfs yet
1006 if modprobe efivars &>/dev/null ; then
1009 # kernel versions v3.10 and newer usually provide efivarfs
1010 if modprobe efivarfs &>/dev/null ; then
1014 if [ -d /sys/firmware/efi ] ; then
1015 einfo "EFI support detected."
1019 if ! [ -d /sys/firmware/efi ] && [ "${efivars_loaded:-}" = "true" ] ; then
1020 einfo "EFI support detected, but system seems to be running in BIOS mode."
1027 # make sure the user is aware of the used configuration {{{
1028 checkconfiguration()
1031 if efi_support ; then
1032 if [ -z "$_opt_efi" ] ; then
1033 ewarn "EFI support detected but no --efi option given, please consider enabling it."
1036 if [ -n "$_opt_efi" ] ; then
1037 eerror "EFI option used but no EFI support detected."
1042 if [ -n "$AUTOINSTALL" ] ; then
1043 if checkforrun ; then
1044 eerror "Exiting as requested"
1047 elif [ -n "$INTERACTIVE" ] ; then
1049 INFOTEXT="Please recheck configuration before execution:
1051 [ -n "$TARGET" ] && INFOTEXT="$INFOTEXT
1053 [ -n "$GRUB" ] && INFOTEXT="$INFOTEXT
1054 Install grub: $GRUB"
1055 [ -n "$EFI" ] && INFOTEXT="$INFOTEXT
1057 [ -n "$RELEASE" ] && INFOTEXT="$INFOTEXT
1058 Using release: $RELEASE"
1059 [ -n "$HOSTNAME" ] && INFOTEXT="$INFOTEXT
1060 Using hostname: $HOSTNAME"
1061 [ -n "$MIRROR" ] && INFOTEXT="$INFOTEXT
1062 Using mirror: $MIRROR"
1063 [ -n "$ISO" ] && INFOTEXT="$INFOTEXT
1065 [ -n "$ARCH" ] && INFOTEXT="$INFOTEXT
1067 [ -n "$CONFFILES" ] && INFOTEXT="$INFOTEXT
1068 Config files: $CONFFILES"
1072 Is this ok for you? Notice: selecting 'No' will exit ${PN}."
1074 dialog --title "$PN" --no-collapse \
1075 --yesno "$INFOTEXT" 0 0
1076 [ $? -eq 0 ] || bailout 0
1078 else # if not running automatic installation display configuration and prompt for execution:
1079 einfo "$PN [${VERSION}] - Please recheck configuration before execution:"
1081 echo " Target: $TARGET"
1083 # do not display if MNTPOINT is the default one
1084 case "$MNTPOINT" in /mnt/debootstrap*) ;; *) echo " Mount point: $MNTPOINT" ;; esac
1086 if [ -n "$VIRTUAL" ] && [ "$GRUB_INSTALL" = 'yes' ] ; then
1087 echo " Install grub: yes"
1088 [ -n "$VMEFI" ] && echo " Install efi: yes" || echo " Install efi: no"
1090 [ -n "$GRUB" ] && echo " Install grub: $GRUB" || echo " Install grub: no"
1091 [ -n "$EFI" ] && echo " Install efi: $EFI" || echo " Install efi: no"
1094 [ -n "$RELEASE" ] && echo " Using release: $RELEASE"
1095 [ -n "$HOSTNAME" ] && echo " Using hostname: $HOSTNAME"
1096 [ -n "$MIRROR" ] && echo " Using mirror: $MIRROR"
1097 [ -n "$ISO" ] && echo " Using ISO: $ISO"
1098 [ -n "$ARCH" ] && echo " Using arch: $ARCH"
1099 [ -n "$CONFFILES" ] && echo " Config files: $CONFFILES"
1100 if [ -n "$VIRTUAL" ] ; then
1101 echo " Deploying as Virtual Machine."
1102 if [ -n "$VMSIZE" ] && [ -n "$VMFILE" ]; then
1103 echo " Using Virtual Disk file with size of ${VMSIZE}."
1107 if [ ! -t 0 ] && [ -z "$ROOTPASSWORD" ] && [ -z "$NOPASSWORD" ] ; then
1109 echo " You do not have a TTY allocated, your password will be shown in"
1110 echo " plaintext on the terminal! If you are using SSH, try its -t option!"
1114 echo " Important! Continuing will delete all data from ${TARGET}!"
1116 if [ -n "$FORCE" ] ; then
1117 einfo "Skip user acknowledgement as requested via --force option."
1120 einfon "Is this ok for you? [y/N] "
1122 if ! [ "$a" = 'y' ] || [ "$a" = 'Y' ] ; then
1123 eerror "Exiting as requested." ; eend 1
1131 # interactive mode {{{
1134 check4progs dialog || bailout 1
1144 prompt_for_bootmanager
1153 # run interactive mode if we didn't get the according configuration yet
1154 if [ -z "$TARGET" ] || [ -n "$INTERACTIVE" ] ; then
1155 # only target might be unset, so make sure the INTERACTIVE flag is set as well
1161 # architecture setup {{{
1162 if [ -n "$ARCH" ] ; then
1163 ARCHCMD="--arch $ARCH"
1164 ARCHINFO=" (${ARCH})"
1166 ARCH="$(dpkg --print-architecture)"
1167 ARCHCMD="--arch $ARCH"
1168 ARCHINFO=" (${ARCH})"
1171 if [ -z "${ARCH:-}" ] ; then
1172 eerror 'Architecture neither set (environment variable ARCH), nor could be automatically identified (using dpkg).'
1173 eerror 'Consider setting the --arch ... option.' ; eend 1
1178 # It is not possible to build amd64 on i686. {{{
1179 CURRENT_ARCH="$(uname -m)"
1180 if [ "$CURRENT_ARCH" != "x86_64" ] ; then
1181 if [ "$ARCH" = "amd64" ] ; then
1182 eerror "It is not possible to build amd64 on $CURRENT_ARCH. Consider installing and booting the 'linux-image-amd64' kernel or using '--arch i386' instead." ; eend 1
1188 # Support for generic release codenames is unavailable. {{{
1189 if [ "$RELEASE" = "stable" ] || [ "$RELEASE" = "testing" ] ; then
1190 eerror "Generic release codenames (stable, testing) are unsupported. \
1191 Please use specific codenames such as bullseye or bookworm." ; eend 1
1198 # finally make sure at least $TARGET is set [the partition for the new system] {{{
1199 if [ -n "$TARGET" ] ; then
1200 SHORT_TARGET="${TARGET##*/}"
1202 eerror "Please adjust $CONFFILES/config or..."
1203 eerror "... use the interactive version for configuration before running ${0}" ; eend 1
1209 if [ -z "$STAGES" ] ; then
1210 STAGES="/var/cache/grml-debootstrap/stages_${SHORT_TARGET}"
1211 [ -d "$STAGES" ] || mkdir -p "$STAGES"
1214 if [ -r "$STAGES"/grml-debootstrap ] ; then
1215 if grep -q 'done' "${STAGES}/grml-debootstrap" ; then
1216 eerror "Error: grml-debootstrap has been executed already, won't continue therefore."
1217 eerror "If you want to re-execute grml-debootstrap just manually remove ${STAGES}" ; eend 1
1222 # partition handling {{{
1226 set_target_directory(){
1227 # assume we are installing into a directory, don't run mkfs and grub related stuff therefore
1233 # make sure we normalise the path to an absolute directory name so something like:
1234 # mkdir -p foo/a bar/a; (cd foo; grml-debootstrap -t a)&; (cd bar; grml-debootstrap -t a)&; wait
1236 TARGET="$(readlink -f "$TARGET")"
1239 if [ -b "$TARGET" ] || [ -n "$VIRTUAL" ] ; then
1242 # $TARGET was not detected as block device, but we do not want to create target directory in /dev/
1243 if [[ $TARGET == "/dev/"* ]]; then
1244 eerror "Error: Will not create target directory $TARGET in /dev."
1245 eerror " Please check the partition(s) of the blockdevice."; eend 1
1248 set_target_directory
1252 # make sure we have the right syntax when using an iso image {{{
1253 if [ -n "$ISO" ] ; then
1262 ISODIR=${ISO##file:}
1266 # Debian ISOs do not contain signed Release files {{{
1267 if [ -n "$ISO" ] ; then
1268 DEBOOTSTRAP_OPT="$DEBOOTSTRAP_OPT --no-check-gpg"
1272 # create filesystem {{{
1274 if [ -n "$DIRECTORY" ] ; then
1275 einfo "Running grml-debootstrap on a directory, skipping mkfs stage."
1279 if grep -q "$TARGET" /proc/mounts ; then
1280 eerror "$TARGET already mounted, exiting to avoid possible damage. (Manually unmount $TARGET)" ; eend 1
1284 # mkfs.ext* might prompt with "/dev/sdX# contains a ext* file system
1285 # created on ... Proceed anyway? (y,n)" which we want to skip in force mode
1286 if [ -n "$MKFS" ] && [ -n "$FORCE" ] ; then
1289 einfo "Enabling force option (-F) for mkfs.ext* tool as requested via --force switch."
1290 MKFS_OPTS="$MKFS_OPTS -F"
1295 # starting with e2fsprogs 1.43~WIP.2015.05.18-1 mkfs.ext4 enables the metadata_csum feature
1296 # by default, which requires a recent version of tune2fs on the target system then,
1297 # so disable this feature for older Debian releases where it's known to be unsupported
1298 if [ -n "$MKFS" ] && [ "$MKFS" = "mkfs.ext4" ] ; then
1300 lenny|squeeze|wheezy|jessie)
1301 # assume a more recent version if we can't identify the version via dpkg-query
1302 local e2fsprogs_version
1303 e2fsprogs_version="$(dpkg-query --show --showformat='${Version}' e2fsprogs 2>/dev/null || echo 1.44)"
1304 if [ -n "$e2fsprogs_version" ] && dpkg --compare-versions "$e2fsprogs_version" ge '1.43~WIP.2015.05.18-1' ; then
1305 einfo "Disabling metadata_csum feature for $MKFS as $RELEASE doesn't support it."
1306 MKFS_OPTS="$MKFS_OPTS -O ^metadata_csum"
1312 # starting with e2fsprogs v1.47.0 mkfs.ext4 enables the metadata_csum_seed feature
1313 # by default, which requires Linux kernel >=4.4, e2fsprogs >=1.43, according GRUB etc.
1314 # Disable this feature for Debian releases older than bookworm
1315 if [ -n "$MKFS" ] && [ "$MKFS" = "mkfs.ext4" ] ; then
1317 lenny|squeeze|wheezy|jessie|stretch|buster|bullseye)
1318 local e2fsprogs_version
1319 # assume a more recent version if we can't identify the version via dpkg-query
1320 e2fsprogs_version="$(dpkg-query --show --showformat='${Version}' e2fsprogs 2>/dev/null || echo 1.47)"
1321 if [ -n "$e2fsprogs_version" ] && dpkg --compare-versions "$e2fsprogs_version" ge '1.43' ; then
1322 einfo "Disabling metadata_csum_seed feature for $MKFS as $RELEASE doesn't support it."
1323 MKFS_OPTS="$MKFS_OPTS -O ^metadata_csum_seed"
1329 if [ -n "$MKFS" ] ; then
1331 if [ -n "${ARM_EFI_TARGET}" ] ; then
1332 einfo "Running mkfs.fat $MKFS_OPTS on $ARM_EFI_TARGET"
1333 mkfs.fat -n "EFI" "$ARM_EFI_TARGET"
1336 MKFS_OPTS="$MKFS_OPTS -L LINUX"
1339 einfo "Running $MKFS $MKFS_OPTS on $TARGET"
1340 # shellcheck disable=SC2086
1341 "$MKFS" $MKFS_OPTS "$TARGET" ; RC=$?
1343 if [ "$FIXED_DISK_IDENTIFIERS" = "yes" ] ; then
1344 if ! echo "$MKFS" | grep -q "mkfs.ext" ; then
1345 eerror "Not changing disk uuid for $TARGET because $MKFS doesn't seem to match for ext{2,3,4} file system"
1349 einfo "Changing disk uuid for $TARGET to fixed (non-random) value $DISK_IDENTIFIER using tune2fs"
1350 tune2fs "$TARGET" -U "$DISK_IDENTIFIER" </dev/null
1355 if [ -n "$VIRTUAL" ] && [ -n "$EFI_TARGET" ]; then
1356 einfo "Creating FAT filesystem on $EFI_TARGET"
1357 mkfs.fat -F32 -n "EFI" "$EFI_TARGET"
1361 # make sure /dev/disk/by-uuid/... is up2date, otherwise grub
1362 # will fail to detect the uuid in the chroot
1363 if [ -n "$VIRTUAL" ] ; then
1364 einfo "Virtual environment doesn't require blockdev --rereadpt, skipping therefore"
1365 elif echo "$TARGET" | grep -q "/dev/md" ; then
1366 blockdev --rereadpt "${TARGET}"
1368 # if we deploy to /dev/sdX# then let's see if /dev/sdX exists
1369 local main_device="${TARGET%%[0-9]*}"
1370 # sanity check to not try to e.g. access /dev/loop if we get /dev/loop0
1371 if [ -f "/sys/block/$(basename "${main_device}")/$(basename "${TARGET}")/dev" ] ; then
1372 blockdev --rereadpt "$main_device"
1374 einfo "No underlying block device for $TARGET identified, skipping blockdev --rereadpt."
1377 # give the system 2 seconds, otherwise we might run into
1378 # race conditions :-/
1386 # retrieve ID_FS_UUID {{{
1387 identify_target_uuid() {
1390 if ! [ -b "$device" ] ; then
1394 eval "$(blkid -o udev "$1" 2>/dev/null)"
1396 if [ -n "$ID_FS_UUID" ] ; then
1404 # identify TARGET_UUID {{{
1405 mountpoint_to_blockdevice() {
1408 TARGET_UUID=$(identify_target_uuid "$TARGET" 2>/dev/null || true)
1409 if [ -n "$TARGET_UUID" ] ; then
1410 einfo "Identified UUID $TARGET_UUID for $TARGET"
1414 # $TARGET might be a mountpoint and not a blockdevice, search for according entry
1415 for file in /sys/block/*/*/dev ; do
1416 if grep -q "^$(mountpoint -d "${TARGET}")$" "$file" ; then
1419 dev="/dev/${dev##*/}"
1420 TARGET_UUID=$(identify_target_uuid "$dev" 2>/dev/null || true)
1422 if [ -n "$TARGET_UUID" ] ; then
1423 einfo "Identified UUID $TARGET_UUID for $TARGET (via $file)"
1431 # modify filesystem settings {{{
1433 if [ -n "$TUNE2FS" ] && echo "$MKFS" | grep -q "mkfs.ext" ; then
1434 einfo "Disabling automatic filesystem check on $TARGET via tune2fs"
1435 $TUNE2FS "$TARGET" </dev/null
1441 # mount the new partition or if it's a directory do nothing at all {{{
1443 if [ -n "$DIRECTORY" ] ; then
1444 einfo "Running grml-debootstrap on a directory, nothing to mount."
1446 if grep -q "$TARGET" /proc/mounts ; then
1447 ewarn "$TARGET already mounted, continuing anyway."
1449 if ! [ -d "${MNTPOINT}" ] ; then
1450 [ -n "$VIRTUAL" ] || mkdir -p "${MNTPOINT}"
1452 einfo "Mounting $TARGET to $MNTPOINT"
1453 mkdir -p "$MNTPOINT"
1454 mount -o rw,suid,dev "$TARGET" "$MNTPOINT"
1458 if [ -n "$ISODIR" ] ; then
1459 einfo "Mounting Debian image loopback to $MNTPOINT/$ISODIR."
1460 mkdir -p "$MNTPOINT/$ISODIR"
1461 mount --bind "$ISODIR" "$MNTPOINT/$ISODIR"
1467 # prepare VM image for usage with debootstrap {{{
1469 if [ -z "$VIRTUAL" ] ; then
1470 return 0 # be quiet by intention
1473 if [ -b "$TARGET" ] && [ -n "$VMFILE" ] ; then
1474 eerror "Error: specified virtual disk target ($TARGET) is an existing block device."
1478 if [ ! -b "$TARGET" ] && [ -z "$VMFILE" ] ; then
1479 eerror "Error: specified virtual disk target ($TARGET) does not exist yet."
1484 # make sure loop module is present and a usable loop device exists
1486 if ! losetup -f >/dev/null 2>&1; then
1487 eerror "Error finding usable loop device" ; eend 1
1491 # if dm-mod isn't available then kpartx will fail with
1492 # "Is device-mapper driver missing from kernel? [...]"
1494 if ! grep -q 'device-mapper' /proc/misc >/dev/null 2>&1 ; then
1495 eerror "Device-mapper support missing in kernel." ; eend 1
1499 ORIG_TARGET="$TARGET" # store for later reuse
1501 if [ -n "$VMFILE" ]; then
1502 qemu-img create -f raw "${TARGET}" "${VMSIZE}"
1504 if [ -n "$VMEFI" ]; then
1505 parted -s "${TARGET}" 'mklabel gpt'
1506 parted -s "${TARGET}" 'mkpart ESP fat32 1MiB 101MiB'
1507 parted -s "${TARGET}" 'set 1 boot on'
1508 parted -s "${TARGET}" 'mkpart bios_grub 101MiB 102MiB'
1509 parted -s "${TARGET}" 'set 2 bios_grub on'
1510 parted -s "${TARGET}" 'mkpart primary ext4 102MiB 100%'
1513 # arm64 support largely only exists for GPT
1514 if [ "$ARCH" = 'arm64' ]; then
1515 einfo "Setting up GPT partitions for arm64"
1516 parted -s "${TARGET}" 'mklabel gpt'
1517 parted -s "${TARGET}" 'mkpart EFI fat32 1MiB 10MiB'
1518 parted -s "${TARGET}" 'set 1 boot on'
1519 parted -s "${TARGET}" 'mkpart LINUX ext4 10MiB 100%'
1521 parted -s "${TARGET}" 'mklabel msdos'
1522 if [ "$FIXED_DISK_IDENTIFIERS" = "yes" ] ; then
1523 einfo "Adjusting disk signature to a fixed (non-random) value"
1524 MBRTMPFILE=$(mktemp)
1525 dd if="${TARGET}" of="${MBRTMPFILE}" bs=512 count=1
1526 echo -en "\\x41\\x41\\x41\\x41" | dd of="${MBRTMPFILE}" conv=notrunc seek=440 bs=1
1527 dd if="${MBRTMPFILE}" of="${TARGET}" conv=notrunc
1530 parted -s "${TARGET}" 'mkpart primary ext4 4MiB 100%'
1531 parted -s "${TARGET}" 'set 1 boot on'
1535 DEVINFO=$(kpartx -asv "$TARGET") # e.g. 'add map loop0p1 (254:5): 0 20477 linear 7:0 3' - will be multi-line for arm64
1536 if [ -z "${DEVINFO}" ] ; then
1537 eerror "Error setting up loopback device." ; eend 1
1541 # if we're building for arm64, we operate on the first line of $DEVINFO which is the EFI partition
1542 if [ "$ARCH" = 'arm64' ]; then
1543 LOOP_PART="${DEVINFO##add map }" # 'loop0p1 (254:5): 0 20477 linear 7:0 3'
1544 LOOP_PART="${LOOP_PART// */}" # 'loop0p1'
1545 LOOP_DISK="${LOOP_PART%p*}" # 'loop0'
1546 export ARM_EFI_TARGET="/dev/mapper/$LOOP_PART"
1547 DEVINFO=${DEVINFO##*$'\n'} # now set $DEVINFO to the last line which is the OS partition
1550 # hopefully this always works as expected
1551 LOOP_PART="${DEVINFO##add map }" # 'loop0p1 (254:5): 0 20477 linear 7:0 3'
1552 LOOP_PART="${LOOP_PART// */}" # 'loop0p1'
1553 if [ -n "$VMEFI" ]; then
1554 export EFI_TARGET="/dev/mapper/$LOOP_PART" # '/dev/mapper/loop0p1'
1555 LOOP_PART="${LOOP_PART%p1}p3"
1557 LOOP_DISK="${LOOP_PART%p*}" # 'loop0'
1558 export TARGET="/dev/mapper/$LOOP_PART" # '/dev/mapper/loop0p1'
1560 if [ -z "$TARGET" ] ; then
1561 eerror "Error: target could not be set to according /dev/mapper/* device." ; eend 1
1567 # make VM image bootable {{{
1569 if [ -z "${VIRTUAL}" ] ; then
1572 if [ "${GRUB_INSTALL}" != "yes" ] ; then
1573 einfo "Not installing GRUB as requested via \$GRUB_INSTALL=$GRUB_INSTALL"
1577 if ! mount "${TARGET}" "${MNTPOINT}" ; then
1578 eerror "Error: Mounting ${TARGET} failed, can not continue." ; eend 1
1582 if [ -n "${ARM_EFI_TARGET}" ]; then
1583 mkdir -p "${MNTPOINT}/boot/efi"
1584 if ! mount "${ARM_EFI_TARGET}" "${MNTPOINT}/boot/efi" ; then
1585 eerror "Error: Mounting ${ARM_EFI_TARGET} failed, can not continue." ; eend 1
1590 mount -t proc none "${MNTPOINT}"/proc
1591 mount -t sysfs none "${MNTPOINT}"/sys
1592 mount -t devtmpfs udev "${MNTPOINT}"/dev
1593 mount -t devpts devpts "${MNTPOINT}"/dev/pts
1595 if [ -n "$ARM_EFI_TARGET" ]; then
1596 einfo "Installing Grub as bootloader into EFI."
1598 chroot "${MNTPOINT}" grub-install --target=arm64-efi --efi-directory=/boot/efi --bootloader-id=debian --recheck --no-nvram --removable
1599 # Has chroot-script installed GRUB to MBR using grub-install (successfully), already?
1600 # chroot-script skips installation for unset ${GRUB}
1601 elif [[ -z "${GRUB}" ]] || ! dd if="${GRUB}" bs=512 count=1 2>/dev/null | cat -v | grep -Fq GRUB; then
1602 einfo "Installing Grub as bootloader."
1604 if ! chroot "${MNTPOINT}" dpkg --list grub-pc 2>/dev/null | grep -q '^ii' ; then
1605 echo "Notice: grub-pc package not present yet, installing it therefore."
1606 # shellcheck disable=SC2086
1607 DEBIAN_FRONTEND=$DEBIAN_FRONTEND chroot "$MNTPOINT" apt-get -y --no-install-recommends install $DPKG_OPTIONS grub-pc
1610 mkdir -p "${MNTPOINT}/boot/grub"
1611 if ! [ -d "${MNTPOINT}"/usr/lib/grub/i386-pc/ ] ; then
1612 eerror "Error: grub not installed inside Virtual Machine. Can not install bootloader." ; eend 1
1615 cp -a "${MNTPOINT}"/usr/lib/grub/i386-pc "${MNTPOINT}/boot/grub/"
1617 if [ -n "$VMEFI" ]; then
1619 mkdir -p "${MNTPOINT}"/boot/efi
1620 mount -t vfat "${EFI_TARGET}" "${MNTPOINT}"/boot/efi
1622 if ! chroot "${MNTPOINT}" dpkg --list shim-signed 2>/dev/null | grep -q '^ii' ; then
1623 echo "Notice: shim-signed package not present yet, installing it therefore."
1624 # shellcheck disable=SC2086
1625 DEBIAN_FRONTEND=$DEBIAN_FRONTEND chroot "$MNTPOINT" apt-get -y --no-install-recommends install $DPKG_OPTIONS shim-signed
1628 if [ "$(dpkg --print-architecture)" = "arm64" ]; then
1629 if ! chroot "${MNTPOINT}" dpkg --list grub-efi-arm64-signed 2>/dev/null | grep -q '^ii' ; then
1630 echo "Notice: grub-efi-arm64-signed package not present yet, installing it therefore."
1631 # shellcheck disable=SC2086
1632 DEBIAN_FRONTEND=$DEBIAN_FRONTEND chroot "$MNTPOINT" apt-get -y --no-install-recommends install $DPKG_OPTIONS grub-efi-arm64-bin grub-efi-arm64-signed
1634 chroot "$MNTPOINT" grub-install --target=arm64-efi --efi-directory=/boot/efi --uefi-secure-boot --removable "/dev/$LOOP_DISK"
1635 elif [ "$(dpkg --print-architecture)" = "i386" ]; then
1636 if ! chroot "${MNTPOINT}" dpkg --list grub-efi-ia32-signed 2>/dev/null | grep -q '^ii' ; then
1637 echo "Notice: grub-efi-ia32-signed package not present yet, installing it therefore."
1638 # shellcheck disable=SC2086
1639 DEBIAN_FRONTEND=$DEBIAN_FRONTEND chroot "$MNTPOINT" apt-get -y --no-install-recommends install $DPKG_OPTIONS grub-efi-ia32-bin grub-efi-ia32-signed
1641 chroot "$MNTPOINT" grub-install --target=i386-efi --efi-directory=/boot/efi --uefi-secure-boot --removable "/dev/$LOOP_DISK"
1642 chroot "$MNTPOINT" grub-install --target=i386-pc "/dev/$LOOP_DISK"
1644 if ! chroot "${MNTPOINT}" dpkg --list grub-efi-amd64-signed 2>/dev/null | grep -q '^ii' ; then
1645 echo "Notice: grub-efi-amd64-signed package not present yet, installing it therefore."
1646 # shellcheck disable=SC2086
1647 DEBIAN_FRONTEND=$DEBIAN_FRONTEND chroot "$MNTPOINT" apt-get -y --no-install-recommends install $DPKG_OPTIONS grub-efi-amd64-bin grub-efi-amd64-signed
1649 chroot "$MNTPOINT" grub-install --target=x86_64-efi --efi-directory=/boot/efi --uefi-secure-boot --removable "/dev/$LOOP_DISK"
1650 chroot "$MNTPOINT" grub-install --target=i386-pc "/dev/$LOOP_DISK"
1653 dd if="${MNTPOINT}/usr/lib/grub/i386-pc/boot.img" of="${ORIG_TARGET}" conv=notrunc bs=440 count=1
1654 case "${_opt_filesystem}" in
1656 chroot "${MNTPOINT}" grub-mkimage -O i386-pc -p "(hd0,msdos1)/boot/grub" -o /tmp/core.img biosdisk part_msdos f2fs
1659 chroot "${MNTPOINT}" grub-mkimage -O i386-pc -p "(hd0,msdos1)/boot/grub" -o /tmp/core.img biosdisk part_msdos xfs
1661 # NOTE - we might need to distinguish between further filesystems
1663 chroot "${MNTPOINT}" grub-mkimage -O i386-pc -p "(hd0,msdos1)/boot/grub" -o /tmp/core.img biosdisk part_msdos ext2
1667 dd if="${MNTPOINT}/tmp/core.img" of="${ORIG_TARGET}" conv=notrunc seek=1
1668 rm -f "${MNTPOINT}/tmp/core.img"
1672 # workaround for Debian bug #918590 with lvm + udev:
1673 # WARNING: Device /dev/... not initialized in udev database even after waiting 10000000 microseconds
1674 if [ -d /run/udev ] ; then
1675 einfo "Setting up bind-mount /run/udev"
1676 mkdir -p "${MNTPOINT}"/run/udev
1677 mount --bind /run/udev "${MNTPOINT}"/run/udev
1681 if [ -n "${BOOT_APPEND}" ] ; then
1682 echo "Adding BOOT_APPEND configuration ['${BOOT_APPEND}'] to /etc/default/grub."
1683 sed -i "/GRUB_CMDLINE_LINUX_DEFAULT/ s#\"\$# ${BOOT_APPEND}\"#" "${MNTPOINT}/etc/default/grub"
1686 einfo "Updating grub configuration file."
1687 chroot "${MNTPOINT}" update-grub
1688 chroot "${MNTPOINT}" sync
1692 einfo "Applying workaround for GRUB font path bug in jessie (Debian #787685)."
1693 mkdir -p "${MNTPOINT}/boot/grub/fonts/"
1694 cp "${MNTPOINT}/usr/share/grub/unicode.pf2" "${MNTPOINT}/boot/grub/fonts/"
1698 if grep -q '^GRUB_DISABLE_LINUX_UUID=.*true' "${MNTPOINT}"/etc/default/grub 2>/dev/null ; then
1699 ewarn "GRUB_DISABLE_LINUX_UUID is set to true in /etc/default/grub, not adjusting root= in grub.cfg."
1700 ewarn "Please note that your system might NOT be able to properly boot."
1701 elif [ -z "$ARM_EFI_TARGET" ]; then
1702 einfo "Adjusting grub.cfg for successful boot sequence."
1703 sed -i "s;root=[^ ]\\+;root=UUID=$TARGET_UUID;" "${MNTPOINT}"/boot/grub/grub.cfg
1706 # workaround for Debian bug #918590 with lvm + udev:
1707 # WARNING: Device /dev/... not initialized in udev database even after waiting 10000000 microseconds
1708 if mountpoint "${MNTPOINT}"/run/udev &>/dev/null ; then
1709 einfo "Unmounting bind-mount /run/udev"
1710 umount "${MNTPOINT}"/run/udev
1714 umount "${MNTPOINT}"/proc
1715 umount "${MNTPOINT}"/sys
1716 umount "${MNTPOINT}"/dev/pts
1717 try_umount 3 "${MNTPOINT}"/dev
1719 if [ -n "$VMEFI" ]; then
1720 umount "${MNTPOINT}"/boot/efi
1726 # unmount VM image {{{
1728 if [ -z "${VIRTUAL}" ] ; then
1732 if [ -n "${ARM_EFI_TARGET}" ]; then
1733 umount "${MNTPOINT}/boot/efi"
1736 umount "${MNTPOINT}"
1737 kpartx -d "${ORIG_TARGET}" >/dev/null
1738 # Workaround for a bug in kpartx which doesn't clean up properly,
1739 # see Debian Bug #891077 and Github-PR grml/grml-debootstrap#112
1740 if dmsetup ls | grep -q "^${LOOP_PART} "; then
1741 kpartx -d "/dev/${LOOP_DISK}" >/dev/null
1746 # install main chroot {{{
1747 debootstrap_system() {
1748 if [ "$_opt_nodebootstrap" ]; then
1749 einfo "Skipping debootstrap as requested."
1753 if grep -q "$MNTPOINT" /proc/mounts || [ -n "$DIRECTORY" ] ; then
1756 eerror "Error: $MNTPOINT not mounted, can not continue."
1760 if [ -n "$ISO" ] ; then
1761 einfo "Running $DEBOOTSTRAP $DEBOOTSTRAP_OPT for release ${RELEASE}${ARCHINFO} using ${ISO}"
1762 einfo "Executing: $DEBOOTSTRAP $ARCHCMD $DEBOOTSTRAP_OPT $RELEASE $MNTPOINT $ISO"
1763 # shellcheck disable=SC2086
1764 "$DEBOOTSTRAP" $ARCHCMD $DEBOOTSTRAP_OPT "$RELEASE" "$MNTPOINT" "$ISO"
1767 einfo "Running $DEBOOTSTRAP $DEBOOTSTRAP_OPT for release ${RELEASE}${ARCHINFO} using ${MIRROR}"
1768 einfo "Executing: $DEBOOTSTRAP $ARCHCMD $DEBOOTSTRAP_OPT $RELEASE $MNTPOINT $MIRROR"
1769 # shellcheck disable=SC2086
1770 "$DEBOOTSTRAP" $ARCHCMD $DEBOOTSTRAP_OPT "$RELEASE" "$MNTPOINT" "$MIRROR"
1774 if [ $RC -ne 0 ] ; then
1775 if [ -r "$MNTPOINT/debootstrap/debootstrap.log" ] && \
1776 [ -s "$MNTPOINT/debootstrap/debootstrap.log" ] ; then
1777 einfo "Presenting last ten lines of debootstrap.log:"
1778 tail -10 "${MNTPOINT}"/debootstrap/debootstrap.log
1779 einfo "End of debootstrap.log"
1787 # prepare chroot via chroot-script {{{
1789 einfo "Preparing chroot system"
1791 # provide variables to chroot system
1792 CHROOT_VARIABLES="/var/cache/grml-debootstrap/variables_${SHORT_TARGET}"
1793 touch "$CHROOT_VARIABLES"
1794 chmod 600 "$CHROOT_VARIABLES" # make sure nobody except root can read it
1795 echo "# Configuration of ${PN}" > "$CHROOT_VARIABLES"
1796 # Resorting to sed(1) for escaping since "VAR='${VAR//\'/\'\\\'\'}'" does not work with all versions of Bash,
1797 # e.g. not with 4.2.37(1)-release (a.k.a 4.2+dfsg-0.1+deb7u3) of Debian wheezy
1798 [ -n "$ARCH" ] && echo "ARCH='$(sed "s,','\\\\'',g" <<<"${ARCH}")'" >> "$CHROOT_VARIABLES"
1799 [ -n "$BACKPORTREPOS" ] && echo "BACKPORTREPOS='$(sed "s,','\\\\'',g" <<<"${BACKPORTREPOS}")'" >> "$CHROOT_VARIABLES"
1800 [ -n "$BOOT_APPEND" ] && echo "BOOT_APPEND='$(sed "s,','\\\\'',g" <<<"${BOOT_APPEND}")'" >> "$CHROOT_VARIABLES"
1801 [ -n "$CHROOT_SCRIPTS" ] && echo "CHROOT_SCRIPTS='$(sed "s,','\\\\'',g" <<<"${CHROOT_SCRIPTS}")'" >> "$CHROOT_VARIABLES"
1802 [ -n "$COMPONENTS" ] && echo "COMPONENTS='$(sed "s,','\\\\'',g" <<<"${COMPONENTS}")'" >> "$CHROOT_VARIABLES"
1803 [ -n "$CONFFILES" ] && echo "CONFFILES='$(sed "s,','\\\\'',g" <<<"${CONFFILES}")'" >> "$CHROOT_VARIABLES"
1804 [ -n "$DEBCONF" ] && echo "DEBCONF='$(sed "s,','\\\\'',g" <<<"${DEBCONF}")'" >> "$CHROOT_VARIABLES"
1805 [ -n "$DEBIAN_FRONTEND" ] && echo "DEBIAN_FRONTEND='$(sed "s,','\\\\'',g" <<<"${DEBIAN_FRONTEND}")'" >> "$CHROOT_VARIABLES"
1806 [ -n "$DEBOOTSTRAP" ] && echo "DEBOOTSTRAP='$(sed "s,','\\\\'',g" <<<"${DEBOOTSTRAP}")'" >> "$CHROOT_VARIABLES"
1807 [ -n "$DEFAULT_LOCALES" ] && echo "DEFAULT_LOCALES='$(sed "s,','\\\\'',g" <<<"${DEFAULT_LOCALES}")'" >> "$CHROOT_VARIABLES"
1808 [ -n "$DEFAULT_LANGUAGE" ] && echo "DEFAULT_LANGUAGE='$(sed "s,','\\\\'',g" <<<"${DEFAULT_LANGUAGE}")'" >> "$CHROOT_VARIABLES"
1809 [ -n "$EXTRAPACKAGES" ] && echo "EXTRAPACKAGES='$(sed "s,','\\\\'',g" <<<"${EXTRAPACKAGES}")'" >> "$CHROOT_VARIABLES"
1810 [ -n "$EFI" ] && echo "EFI='$(sed "s,','\\\\'',g" <<<"${EFI}")'" >> "$CHROOT_VARIABLES"
1811 [ -n "$FALLBACK_MIRROR" ] && echo "FALLBACK_MIRROR='$(sed "s,','\\\\'',g" <<<"${FALLBACK_MIRROR}")'" >> "$CHROOT_VARIABLES"
1812 [ -n "$FILESYSTEM" ] && echo "FILESYSTEM='$(sed "s,','\\\\'',g" <<<"${FILESYSTEM}")'" >> "$CHROOT_VARIABLES"
1813 [ -n "$FORCE" ] && echo "FORCE='$(sed "s,','\\\\'',g" <<<"${FORCE}")'" >> "$CHROOT_VARIABLES"
1814 [ -n "$GRMLREPOS" ] && echo "GRMLREPOS='$(sed "s,','\\\\'',g" <<<"${GRMLREPOS}")'" >> "$CHROOT_VARIABLES"
1815 [ -n "$GRUB" ] && echo "GRUB='$(sed "s,','\\\\'',g" <<<"${GRUB}")'" >> "$CHROOT_VARIABLES"
1816 [ -n "$HOSTNAME" ] && echo "HOSTNAME='$(sed "s,','\\\\'',g" <<<"${HOSTNAME}")'" >> "$CHROOT_VARIABLES"
1817 [ -n "$INITRD" ] && echo "INITRD='$(sed "s,','\\\\'',g" <<<"${INITRD}")'" >> "$CHROOT_VARIABLES"
1818 [ -n "$INITRD_GENERATOR" ] && echo "INITRD_GENERATOR='$(sed "s,','\\\\'',g" <<<"${INITRD_GENERATOR}")'" >> "$CHROOT_VARIABLES"
1819 [ -n "$INITRD_GENERATOR_OPTS" ] && echo "INITRD_GENERATOR_OPTS='$(sed "s,','\\\\'',g" <<<"${INITRD_GENERATOR_OPTS}")'" >> "$CHROOT_VARIABLES"
1820 [ -n "$INSTALL_NOTES" ] && echo "INSTALL_NOTES='$(sed "s,','\\\\'',g" <<<"${INSTALL_NOTES}")'" >> "$CHROOT_VARIABLES"
1821 [ -n "$ISODIR" ] && echo "ISODIR='$(sed "s,','\\\\'',g" <<<"${ISO}")'" >> "$CHROOT_VARIABLES"
1822 [ -n "$ISO" ] && echo "ISO='$(sed "s,','\\\\'',g" <<<"${ISO}")'" >> "$CHROOT_VARIABLES"
1823 [ -n "$KEEP_SRC_LIST" ] && echo "KEEP_SRC_LIST='$(sed "s,','\\\\'',g" <<<"${KEEP_SRC_LIST}")'" >> "$CHROOT_VARIABLES"
1824 [ -n "$LOCALES" ] && echo "LOCALES='$(sed "s,','\\\\'',g" <<<"${LOCALES}")'" >> "$CHROOT_VARIABLES"
1825 [ -n "$MIRROR" ] && echo "MIRROR='$(sed "s,','\\\\'',g" <<<"${MIRROR}")'" >> "$CHROOT_VARIABLES"
1826 [ -n "$MKFS" ] && echo "MKFS='$(sed "s,','\\\\'',g" <<<"${MKFS}")'" >> "$CHROOT_VARIABLES"
1827 [ -n "$NOPASSWORD" ] && echo "NOPASSWORD=\"true\"" >> "$CHROOT_VARIABLES"
1828 [ -n "$NOKERNEL" ] && echo "NOKERNEL=\"true\"" >> "$CHROOT_VARIABLES"
1829 [ -n "$PACKAGES" ] && echo "PACKAGES='$(sed "s,','\\\\'',g" <<<"${PACKAGES}")'" >> "$CHROOT_VARIABLES"
1830 [ -n "$POST_SCRIPTS" ] && echo "POST_SCRIPTS='$(sed "s,','\\\\'',g" <<<"${POST_SCRIPTS}")'" >> "$CHROOT_VARIABLES"
1831 [ -n "$PRE_SCRIPTS" ] && echo "PRE_SCRIPTS='$(sed "s,','\\\\'',g" <<<"${PRE_SCRIPTS}")'" >> "$CHROOT_VARIABLES"
1832 [ -n "$RECONFIGURE" ] && echo "RECONFIGURE='$(sed "s,','\\\\'',g" <<<"${RECONFIGURE}")'" >> "$CHROOT_VARIABLES"
1833 [ -n "$RELEASE" ] && echo "RELEASE='$(sed "s,','\\\\'',g" <<<"${RELEASE}")'" >> "$CHROOT_VARIABLES"
1834 [ -n "$RM_APTCACHE" ] && echo "RM_APTCACHE='$(sed "s,','\\\\'',g" <<<"${RM_APTCACHE}")'" >> "$CHROOT_VARIABLES"
1835 [ -n "$ROOTPASSWORD" ] && echo "ROOTPASSWORD='$(sed "s,','\\\\'',g" <<<"${ROOTPASSWORD}")'" >> "$CHROOT_VARIABLES"
1836 [ -n "$SCRIPTS" ] && echo "SCRIPTS='$(sed "s,','\\\\'',g" <<<"${SCRIPTS}")'" >> "$CHROOT_VARIABLES"
1837 [ -n "$SECURE" ] && echo "SECURE='$(sed "s,','\\\\'',g" <<<"${SECURE}")'" >> "$CHROOT_VARIABLES"
1838 [ -n "$SELECTED_PARTITIONS" ] && echo "SELECTED_PARTITIONS='$(sed "s,','\\\\'',g" <<<"${SELECTED_PARTITIONS}")'" >> "$CHROOT_VARIABLES"
1839 [ -n "$TARGET" ] && echo "TARGET='$(sed "s,','\\\\'',g" <<<"${TARGET}")'" >> "$CHROOT_VARIABLES"
1840 [ -n "$UPGRADE_SYSTEM" ] && echo "UPGRADE_SYSTEM='$(sed "s,','\\\\'',g" <<<"${UPGRADE_SYSTEM}")'" >> "$CHROOT_VARIABLES"
1841 [ -n "$TARGET_UUID" ] && echo "TARGET_UUID='$(sed "s,','\\\\'',g" <<<"${TARGET_UUID}")'" >> "$CHROOT_VARIABLES"
1842 [ -n "$TIMEZONE" ] && echo "TIMEZONE='$(sed "s,','\\\\'',g" <<<"${TIMEZONE}")'" >> "$CHROOT_VARIABLES"
1843 [ -n "$TUNE2FS" ] && echo "TUNE2FS='$(sed "s,','\\\\'',g" <<<"${TUNE2FS}")'" >> "$CHROOT_VARIABLES"
1844 [ -n "$VMSIZE" ] && echo "VMSIZE='$(sed "s,','\\\\'',g" <<<"${VMSIZE}")'" >> "$CHROOT_VARIABLES"
1846 cp $VERBOSE "${CONFFILES}"/chroot-script "${MNTPOINT}"/bin/chroot-script
1847 chmod 755 "${MNTPOINT}"/bin/chroot-script
1848 [ -d "$MNTPOINT"/etc/debootstrap/ ] || mkdir "$MNTPOINT"/etc/debootstrap/
1850 # make sure we have our files for later use via chroot-script
1851 cp $VERBOSE "${CONFFILES}/config" "${MNTPOINT}"/etc/debootstrap/
1852 # make sure we adjust the configuration variables accordingly:
1853 sed -i "s#RELEASE=.*#RELEASE=\"$RELEASE\"#" "${MNTPOINT}"/etc/debootstrap/config
1854 sed -i "s#TARGET=.*#TARGET=\"$TARGET\"#" "${MNTPOINT}"/etc/debootstrap/config
1855 sed -i "s#GRUB=.*#GRUB=\"$GRUB\"#" "${MNTPOINT}"/etc/debootstrap/config
1858 if [ -n "$INSTALL_NOTES" ] ; then
1859 [ -r "$INSTALL_NOTES" ] && cp "$INSTALL_NOTES" "${MNTPOINT}"/etc/debootstrap/
1862 # package selection:
1863 if [ "$PACKAGES" = 'yes' ] ; then
1864 PACKAGES_FILE="packages"
1866 if [ "$ARCH" = 'arm64' ]; then
1867 PACKAGES_FILE="packages-arm64"
1870 cp $VERBOSE "${_opt_packages:-$CONFFILES/$PACKAGES_FILE}" \
1871 "${MNTPOINT}/etc/debootstrap/${PACKAGES_FILE}"
1874 # debconf preseeding:
1875 _opt_debconf=${_opt_debconf:-$CONFFILES/debconf-selections}
1876 [ -f "${_opt_debconf}" ] && [ "$DEBCONF" = 'yes' ] && \
1877 cp $VERBOSE "${_opt_debconf}" "${MNTPOINT}"/etc/debootstrap/debconf-selections
1879 # copy scripts that should be executed inside the chroot:
1880 _opt_chroot_scripts=${_opt_chroot_scripts:-$CONFFILES/chroot-scripts/}
1881 [ -d "$_opt_chroot_scripts" ] && [ "$CHROOT_SCRIPTS" = 'yes' ] && {
1882 mkdir -p "${MNTPOINT}"/etc/debootstrap/chroot-scripts
1883 cp -a $VERBOSE "${_opt_chroot_scripts}"/* "${MNTPOINT}"/etc/debootstrap/chroot-scripts/
1886 # notice: do NOT use $CHROOT_VARIABLES inside chroot but statically file instead!
1887 cp $VERBOSE "${CHROOT_VARIABLES}" "${MNTPOINT}"/etc/debootstrap/variables
1889 cp $VERBOSE -a -L "${CONFFILES}"/extrapackages/ "${MNTPOINT}"/etc/debootstrap/
1891 # make sure we can access network [relevant for cdebootstrap/mmdebstrap]
1892 [ -f "${MNTPOINT}"/etc/resolv.conf ] || cp $VERBOSE /etc/resolv.conf "${MNTPOINT}"/etc/resolv.conf
1894 # setup default locales
1895 [ -n "$LOCALES" ] && cp $VERBOSE "${CONFFILES}"/locale.gen "${MNTPOINT}"/etc/locale.gen
1897 # MAKEDEV is just a forking bomb crap, let's do it on our own instead :)
1898 ( cd "${MNTPOINT}"/dev && tar zxf /etc/debootstrap/devices.tar.gz )
1900 # copy any existing files to chroot
1901 [ -d "${CONFFILES}"/bin ] && cp $VERBOSE -a -L "${CONFFILES}"/bin/* "${MNTPOINT}"/bin/
1902 [ -d "${CONFFILES}"/boot ] && cp $VERBOSE -a -L "${CONFFILES}"/boot/* "${MNTPOINT}"/boot/
1903 [ -d "${CONFFILES}"/etc ] && cp $VERBOSE -a -L "${CONFFILES}"/etc/* "${MNTPOINT}"/etc/
1904 [ -d "${CONFFILES}"/sbin ] && cp $VERBOSE -a -L "${CONFFILES}"/sbin/* "${MNTPOINT}"/sbin/
1905 [ -d "${CONFFILES}"/share ] && cp $VERBOSE -a -L "${CONFFILES}"/share/* "${MNTPOINT}"/share/
1906 [ -d "${CONFFILES}"/usr ] && cp $VERBOSE -a -L "${CONFFILES}"/usr/* "${MNTPOINT}"/usr/
1907 [ -d "${CONFFILES}"/var ] && cp $VERBOSE -a -L "${CONFFILES}"/var/* "${MNTPOINT}"/var/
1910 DEFAULT_INTERFACES="# /etc/network/interfaces - generated by grml-debootstrap
1912 # Include files from /etc/network/interfaces.d when using
1913 # ifupdown v0.7.44 or newer:
1914 #source-directory /etc/network/interfaces.d
1917 iface lo inet loopback
1920 iface eth0 inet dhcp
1923 # add dhcp setting for Predictable Network Interface Names
1924 if [ -x /bin/udevadm ]; then
1926 for interface in /sys/class/net/*; do
1927 udevadm info --query=all --path="${interface}" > "${tmpfile}"
1928 # skip virtual devices, like bridges, vboxnet,...
1929 if grep -q 'P: /devices/virtual/net/' "${tmpfile}" ; then
1933 # iterate over possible naming policies by precedence (see udev/net/link-config.c),
1934 # use and stop on first match to have same behavior as udev's link_config_apply()
1935 for property in ID_NET_NAME_FROM_DATABASE ID_NET_NAME_ONBOARD ID_NET_NAME_SLOT ID_NET_NAME_PATH ID_NET_NAME_MAC ; do
1936 if grep -q "${property}" "${tmpfile}" ; then
1937 interface=$(grep "${property}" "${tmpfile}" | sed -n -e "s/E: ${property}=\([^\$*]\)/\1/p")
1938 DEFAULT_INTERFACES="${DEFAULT_INTERFACES}
1939 allow-hotplug ${interface}
1940 iface ${interface} inet dhcp
1949 if [ -n "$NOINTERFACES" ] ; then
1950 einfo "Not installing /etc/network/interfaces as requested via --nointerfaces option"
1951 elif [ -n "$USE_DEFAULT_INTERFACES" ] ; then
1952 einfo "Installing default /etc/network/interfaces as requested via --defaultinterfaces options."
1953 mkdir -p "${MNTPOINT}/etc/network"
1954 echo "$DEFAULT_INTERFACES" > "${MNTPOINT}/etc/network/interfaces"
1956 elif [ -n "$VIRTUAL" ] ; then
1957 einfo "Setting up Virtual Machine, installing default /etc/network/interfaces"
1958 mkdir -p "${MNTPOINT}/etc/network"
1959 echo "$DEFAULT_INTERFACES" > "${MNTPOINT}/etc/network/interfaces"
1961 elif [ -r /etc/network/interfaces ] ; then
1962 einfo "Copying /etc/network/interfaces from host to target system"
1963 mkdir -p "${MNTPOINT}/etc/network"
1964 cp $VERBOSE /etc/network/interfaces "${MNTPOINT}/etc/network/interfaces"
1967 ewarn "Couldn't read /etc/network/interfaces, installing default /etc/network/interfaces"
1968 mkdir -p "${MNTPOINT}/etc/network"
1969 echo "$DEFAULT_INTERFACES" > "${MNTPOINT}/etc/network/interfaces"
1973 # install config file providing some example entries
1974 if [ -r /etc/network/interfaces.examples ] && [ ! -r "$MNTPOINT/etc/network/interfaces.examples" ] ; then
1975 mkdir -p "${MNTPOINT}/etc/network"
1976 cp /etc/network/interfaces.examples "$MNTPOINT/etc/network/interfaces.examples"
1979 if [ -n "${SSHCOPYID}" ] ; then
1980 AUTHORIZED_KEYS_SOURCE=${AUTHORIZED_KEYS_SOURCE:-$HOME/.ssh/authorized_keys}
1981 AUTHORIZED_KEYS_TARGET=${AUTHORIZED_KEYS_TARGET:-$MNTPOINT/root/.ssh/}
1982 if ssh-add -L >/dev/null 2>&1 ; then
1983 einfo "Use locally available public keys to authorise root login on the target system as requested via --sshcopyid option."
1984 mkdir -p "${MNTPOINT}"/root/.ssh
1985 chmod 0700 "${MNTPOINT}"/root/.ssh
1986 if ! ssh-add -L >> "${MNTPOINT}"/root/.ssh/authorized_keys ; then
1987 eerror "Error: executing 'ssh-add -L' failed."
1991 elif [ -f "$AUTHORIZED_KEYS_SOURCE" ]; then
1992 einfo "copying '$AUTHORIZED_KEYS_SOURCE' to '$AUTHORIZED_KEYS_TARGET' as requested via --sshcopyid option."
1993 mkdir -p "$AUTHORIZED_KEYS_TARGET"
1994 chmod 0700 "$AUTHORIZED_KEYS_TARGET"
1995 if ! cp "$AUTHORIZED_KEYS_SOURCE" "$AUTHORIZED_KEYS_TARGET" ; then
1996 eerror "Error: copying '$AUTHORIZED_KEYS_SOURCE' to '$AUTHORIZED_KEYS_TARGET' failed"
2001 eerror "Error: Could not open a connection to your authentication agent or the agent has no identities."
2007 if [ -n "${SSHCOPYAUTH}" ] ; then
2008 AUTHORIZED_KEYS_SOURCE=${AUTHORIZED_KEYS_SOURCE:-${HOME}/.ssh/authorized_keys}
2010 if ! [ -f "${AUTHORIZED_KEYS_SOURCE}" ]; then
2011 eerror "Error: could not read '${AUTHORIZED_KEYS_SOURCE}' for setting up SSH key login."
2016 AUTHORIZED_KEYS_TARGET="${MNTPOINT}/root/.ssh/"
2017 einfo "Copying '${AUTHORIZED_KEYS_SOURCE}' to '${AUTHORIZED_KEYS_TARGET}' as requested via --sshcopyauth option."
2018 mkdir -p "${AUTHORIZED_KEYS_TARGET}"
2019 chmod 0700 "${AUTHORIZED_KEYS_TARGET}"
2020 if ! cp "${AUTHORIZED_KEYS_SOURCE}" "${AUTHORIZED_KEYS_TARGET}" ; then
2021 eerror "Error: copying '${AUTHORIZED_KEYS_SOURCE}' to '${AUTHORIZED_KEYS_TARGET}' failed."
2027 if [ -d /run/udev ] ; then
2028 einfo "Setting up bind-mount /run/udev"
2029 mkdir -p "${MNTPOINT}"/run/udev
2030 mount --bind /run/udev "${MNTPOINT}"/run/udev
2036 # execute all scripts in /etc/debootstrap/pre-scripts/ {{{
2037 execute_pre_scripts() {
2038 # make sure hostname is set even before chroot-script get executed
2039 echo "$HOSTNAME" > "$MNTPOINT"/etc/hostname
2041 # make sure we have $MNTPOINT available for our scripts
2044 if [ -d "$_opt_pre_scripts" ] || [ "$PRE_SCRIPTS" = 'yes' ] ; then
2045 [ -d "$_opt_pre_scripts" ] && pre_scripts="$_opt_pre_scripts" || pre_scripts="${CONFFILES}/pre-scripts/"
2046 for script in "${pre_scripts}"/* ; do
2047 if [ -x "$script" ] ; then
2048 einfo "Executing pre-script $script"
2056 # execute all scripts in /etc/debootstrap/post-scripts/ {{{
2057 execute_post_scripts() {
2058 # make sure we have $MNTPOINT and HOSTNAME available for our scripts
2060 export TARGET_HOSTNAME=$HOSTNAME
2062 if [ -d "$_opt_scripts" ] || [ "$SCRIPTS" = 'yes' ] ; then
2063 # legacy support for /etc/debootstrap/scripts/
2064 [ -d "$_opt_scripts" ] && post_scripts="$_opt_scripts" || post_scripts="${CONFFILES}/scripts/"
2065 ewarn "Deprecation NOTE: --scripts/SCRIPTS are deprecated, please switch to --post-scripts/POST_SCRIPTS instead."
2066 elif [ -d "$_opt_post_scripts" ] || [ "$POST_SCRIPTS" = 'yes' ] ; then
2067 [ -d "$_opt_post_scripts" ] && post_scripts="$_opt_post_scripts" || post_scripts="${CONFFILES}/post-scripts/"
2070 if [ -n "$post_scripts" ] ; then
2071 for script in "${post_scripts}"/* ; do
2072 if [ -x "$script" ] ; then
2073 einfo "Executing post-script $script"
2081 # unmount mountpoint {{{
2084 local mountpoint="$2"
2086 for (( try=1; try<=tries; try++ )); do
2087 if [[ ${try} -eq ${tries} ]]; then
2088 # Last time, show errors this time
2089 umount "${mountpoint}" && return 0
2091 # Not last time, hide errors until fatal
2092 if umount "${mountpoint}" 2>/dev/null ; then
2099 return 1 # Tried enough
2103 # execute chroot-script {{{
2105 if ! [ -r "$MNTPOINT/bin/chroot-script" ] ; then
2109 if ! [ -x "$MNTPOINT/bin/chroot-script" ] ; then
2110 eerror "Fatal: $MNTPOINT/bin/chroot-script could not be found."
2113 einfo "Executing chroot-script now"
2114 mount -t devtmpfs udev "${MNTPOINT}"/dev
2115 mount -t devpts devpts "${MNTPOINT}"/dev/pts
2116 if [ "$DEBUG" = "true" ] ; then
2117 chroot "$MNTPOINT" /bin/bash -x /bin/chroot-script ; RC=$?
2119 chroot "$MNTPOINT" /bin/chroot-script ; RC=$?
2121 try_umount 3 "$MNTPOINT"/dev/pts
2122 try_umount 3 "$MNTPOINT"/dev
2126 # finally get rid of chroot-script again, there's no good reason to
2127 # keep it on the installed system
2128 if grep -q GRML_CHROOT_SCRIPT_MARKER "${MNTPOINT}/bin/chroot-script" ; then
2129 einfo "Removing chroot-script again"
2130 rm -f "${MNTPOINT}/bin/chroot-script"
2133 einfo "Keeping chroot-script as string GRML_CHROOT_SCRIPT_MARKER could not be found"
2138 # unmount $MNTPOINT {{{
2141 # display installation notes:
2142 if [ -n "$INSTALL_NOTES" ] ; then
2143 [ -r "${MNTPOINT}/${INSTALL_NOTES}" ] && cat "${MNTPOINT}/${INSTALL_NOTES}"
2146 if [ -n "$ISODIR" ] ; then
2147 if grep -q "$ISODIR" /proc/mounts ; then
2148 einfo "Unmount $MNTPOINT/$ISODIR"
2149 umount "$MNTPOINT/$ISODIR"
2154 if grep -q "$MNTPOINT" /proc/mounts ; then
2155 if mountpoint "${MNTPOINT}"/run/udev &>/dev/null ; then
2156 einfo "Unmounting bind-mount /run/udev"
2157 umount "${MNTPOINT}"/run/udev
2161 if [ -n "$PARTITION" ] ; then
2162 einfo "Unmount $MNTPOINT"
2170 # execute filesystem check {{{
2172 if [ -n "$VIRTUAL" ] ; then
2173 einfo "Skipping filesystem check because we deploy a virtual machine."
2177 if [ "$FSCK" = 'yes' ] ; then
2178 [ -n "$FSCKTOOL" ] || FSCKTOOL="fsck.${MKFS#mkfs.}"
2179 einfo "Checking filesystem on $TARGET using $FSCKTOOL"
2180 "$FSCKTOOL" "$TARGET"
2186 # get rid of grml-debootstrap config files {{{
2188 if [ "$REMOVE_CONFIGS" != "yes" ] ; then
2192 if ! mountpoint "${MNTPOINT}" >/dev/null 2>&1 ; then
2193 ewarn "Target ${MNTPOINT} doesn't seem to be mounted, can't remove configuration files."
2197 einfo "Removing configuration files from installed system as requested via --remove-configs / REMOVE_CONFIGS."
2198 rm -rf "${MNTPOINT}"/etc/debootstrap/
2203 # now execute all the functions {{{
2204 for i in format_efi_partition prepare_vm mkfs tunefs \
2205 mount_target mountpoint_to_blockdevice debootstrap_system \
2206 preparechroot execute_pre_scripts chrootscript execute_post_scripts \
2207 remove_configs umount_chroot grub_install umount_target fscktool ; do
2208 if stage "${i}" ; then
2210 if [ $? -eq 0 ]; then
2211 stage "${i}" 'done' && rm -f "${STAGES}/${i}"
2221 # end dialog of autoinstallation {{{
2222 if [ -n "$AUTOINSTALL" ] ; then
2223 if dialog --title "${PN}" --pause "Finished execution of ${PN}.
2224 Automatically rebooting in 10 seconds.
2226 Choose Cancel to skip rebooting." 10 60 10 ; then
2227 noeject noprompt reboot
2230 einfo "Finished execution of ${PN}. Enjoy your Debian system."
2234 ## END OF FILE #################################################################
2235 # vim: ai tw=100 expandtab foldmethod=marker shiftwidth=2