summaryrefslogtreecommitdiff
path: root/examples/hooks/losetup-lukshome.sh
diff options
context:
space:
mode:
authorDaniel Baumann <daniel@debian.org>2009-11-11 17:25:50 +0100
committerDaniel Baumann <daniel@debian.org>2011-03-09 19:09:48 +0100
commitdbcae19129fb310cef3330d9e8342602e2845589 (patch)
tree99b53cfa4a94fe2d9cae99e466d63efb06844a64 /examples/hooks/losetup-lukshome.sh
parent02fee2236aa2203dbda715ab8c07c7678527f974 (diff)
downloadlive-build-dbcae19129fb310cef3330d9e8342602e2845589.zip
live-build-dbcae19129fb310cef3330d9e8342602e2845589.tar.gz
Renaming example hooks and prefixing them with distribution name.
Diffstat (limited to 'examples/hooks/losetup-lukshome.sh')
-rwxr-xr-xexamples/hooks/losetup-lukshome.sh460
1 files changed, 0 insertions, 460 deletions
diff --git a/examples/hooks/losetup-lukshome.sh b/examples/hooks/losetup-lukshome.sh
deleted file mode 100755
index 5542438..0000000
--- a/examples/hooks/losetup-lukshome.sh
+++ /dev/null
@@ -1,460 +0,0 @@
-#!/bin/sh
-
-# This hook was based and adapted from:
-# http://lists.debian.org/debian-live/2009/04/msg00186.html
-# ---------------------------------------------------------
-#
-#
-# NOTE 1: this was not tested with persistent boot option,
-# but it seems logic that persistent and lukshome can't
-# coexist as boot options (because of snapshots and others), so lukshome
-# won't be executed if any persistent option is given on boot.
-#
-# NOTE 2: if using an USB key, it will eventualy end up failing someday.
-# You should backup the encrypted disk image file itself (luks-home.img) to
-# prevent loosing your data.
-#
-# This hook will create 3 files:
-#
-# /usr/local/sbin/create-lukshome-file.sh
-# script to create an disk file image (luks-home.img) with a
-# LUKS encrypted ext2 filesystem inside to be placed in a
-# partition labeled lukshome.
-#
-# /usr/local/sbin/lukshome.sh
-# detects a partition with lukshome label, updates fstab and crypttab so
-# the encrypted file is mounted later in a loopback device (/dev/loopX).
-# It also changes /etc/init.d/umountfs so the encrypted home is correctly
-# umounted.
-#
-# /usr/share/initramfs-tools/scripts/live-bottom/13live_luks_home
-# a live-initramfs hook to execute lukshome.sh script
-# in initrd.
-#
-#
-# HOWTO lukshome
-# --------------
-#
-# First build your live system with this hook inside config/chroot_local-hooks/.
-# If you have an existing live-helper build directory with a previous live
-# build, you might have to run
-#
-# lh_clean
-# lh_clean --stage
-#
-# to make sure this hook is included in the live system. Then (re)build your
-# live system.
-#
-# lh_build
-#
-# After booting your (re)built live system, setup the encrypted losetup
-# filesystem to be used as /home using the instructions present in the
-# create-lukshome-file.sh script.
-#
-# Reboot and now use the "lukshome" boot option to mount the encrypted /home,
-# like in using "persistent" boot option with a home-rw file in some partition.
-#
-
-
-echo "I: to see how use lukshome hook run create-lukshome-file.sh as root."
-echo "I: creating script /usr/local/sbin/create-lukshome-file.sh"
-cat > /usr/local/sbin/create-lukshome-file.sh << 'EOF'
-#!/bin/sh
-
-# This script is to create an encrypted filesystem in a file to
-# be used as /home in a live system built with Debian Live Helper with
-# the lukshome hook in config/chroot_local-hooks/.
-#
-# The lukshome boot option will do the following:
-# - search for a partition with label 'lukshome'
-# (btw, you can't use the live system partition itself)
-# - mount the partition as /luks-home in the live system
-# - open /luks-home/luks-home.img file as a loopback device (/dev/loop)
-# - open the loopback device with cryptsetup
-# - mount the encrypted filesystem as /home
-#
-# This script will only create the luks-home.img file. Next are details of how
-# to use this script.
-#
-# CAUTION! THIS CAN WIPE YOUR DATA, backup first!
-# Be sure to understand what you will do, or you can end up
-# wiping disks or partitions you don't want to!
-#
-# Login as root:
-# $ sudo -i
-#
-# Create a mountpoint (don't use /mnt, it will be used by this script):
-# # mkdir /media/target
-#
-# !!! *** Skip the next line if you don't want to wipe a partition *** !!!
-# !!! * Just change the partition label to 'lukshome' (without quotes) * !!!
-# Create an ext2 filesystem in a partition with 'lukshome' label:
-# # mkfs.ext2 -L lukshome /dev/the_partition_to_be_used
-#
-# Mount the partition and cd into it:
-# # mount /dev/the_partition_to_be_used /media/target
-# # cd /media/target
-#
-# Create the encrypted file:
-# # create-lukshome-file.sh
-#
-# The script is located in /usr/local/sbin/, so it's in root $PATH.
-# It will copy the directories in /home/* into the file.
-# Now return to $HOME to be able to umount the target partition:
-# # cd
-#
-# Umount the target partition:
-# # umount /media/target
-#
-# Reboot and use the "lukshome" boot option to mount the encrypted /home,
-# like in using "persistent" boot option with a home-rw file in some partition.
-#
-# Press Shift-PgUp/Shift-PgDn to scrool the instructions on the screen.
-
-
-# check if root/sudo
-if [ "${USER}" != "root" ]
-then
- echo " ** Please run this script as root or with sudo."
- exit 1
-fi
-
-# check if /mnt is available and empty
-mount | grep "/mnt" > /dev/null
-MNT_IS_MOUNTED=${?}
-if [ "${MNT_IS_MOUNTED}" == 0 ]
-then
- echo "** ERROR: /mnt is mounted at the moment. Please umount it to use this script."
- exit 1
-fi
-if [ "$(ls -A /mnt)" ]
-then
- echo "** ERROR: /mnt is not empty. An empty /mnt is needed to use this script."
- exit 1
-fi
-
-# check if /dev/mapper/luks-home is available
-if [ -f /dev/mapper/luks-home ]
-then
- echo "** ERROR: /dev/mapper/luks-home is being used at the moment. Please run «cryptsetup remove luks-home» to use this script."
- exit 1
-fi
-
-
-# show instructions
-echo ""
-echo "** Instructions to use create-lukshome-file.sh (this script):"
-sed -n '2,51p' /usr/local/sbin/create-lukshome-file.sh | sed 's/^.//'
-echo ""
-
-
-# proceed?
-echo "** Do you want to proceed with this script? (y/N)"
-read CONFIRM
-
-case "${CONFIRM}" in
- y*|Y*)
- echo ""
- ;;
- *)
- exit 0
- ;;
-esac
-
-
-# create file
-echo ""
-echo "** Please type the size of the file disk image."
-echo "Size of the file in MB: "
-read FILE_SIZE
-
-echo ""
-echo "** Creating file luks-home.img."
-echo "** Filling file image with /dev/urandom output. It will take some time."
-echo "(Edit this script to use /dev/random. It's know to more secure but "
-echo "it will take a *very* long time to complete."
-dd if=/dev/urandom of=luks-home.img bs=1M count=${FILE_SIZE}
-# To use /dev/random comment the line above and uncomment the next line
-#dd if=/dev/random of=luks-home.img ibs=128 obs=128 count=$((8192*${FILE_SIZE}))
-# You might have to increase kernel entropy by moving the mouse, typing keyboard,
-# make the computer read disk or use network connections.
-echo "** Done."
-echo ""
-
-# losetup
-FREE_LOSETUP=$(losetup -f)
-echo "** Using ${FREE_LOSETUP} to open luks-home.img"
-losetup ${FREE_LOSETUP} ./luks-home.img
-echo "** Done."
-echo ""
-
-# cryptsetup
-echo "** Running cryptsetup."
-echo ""
-echo "** luksFormat"
-cryptsetup luksFormat ${FREE_LOSETUP}
-EXIT_CODE=${?}
-if [ "${EXIT_CODE}" != 0 ]
-then
- echo "** ERROR: Error while trying to format disk file image."
- losetup -d ${FREE_LOSETUP}
- exit 1
-fi
-echo ""
-
-echo "** luksOpen"
-cryptsetup luksOpen ${FREE_LOSETUP} luks-home
-EXIT_CODE=${?}
-if [ "${EXIT_CODE}" != 0 ]
-then
- echo "** ERROR: Error while trying to open LUKS file image."
- losetup -d ${FREE_LOSETUP}
- exit 1
-fi
-echo ""
-
-# format encrypted filesystem
-echo "** Now formating /dev/mapper/luks-home"
-mkfs.ext2 /dev/mapper/luks-home
-EXIT_CODE=${?}
-if [ "${EXIT_CODE}" != 0 ]
-then
- echo "** ERROR: Error while trying to format LUKS file."
- cryptsetup remove luks-home
- losetup -d ${FREE_LOSETUP}
- exit 1
-fi
-echo ""
-
-# mount in /mnt
-echo "** Now mounting luks-home.img in /mnt"
-mount /dev/mapper/luks-home /mnt
-EXIT_CODE=${?}
-if [ "${EXIT_CODE}" != 0 ]
-then
- echo "** ERROR: Error while trying to mount LUKS file in /mnt."
- umount /mnt
- cryptsetup remove luks-home
- losetup -d ${FREE_LOSETUP}
- exit 1
-fi
-echo ""
-
-# copy files
-HOME_DIR="/home/*"
-
-echo "** Copying ${HOME_DIR}."
-cp -rav ${HOME_DIR} /mnt
-EXIT_CODE=${?}
-if [ "${EXIT_CODE}" != 0 ]
-then
- echo "** ERROR: Error while trying to copy files to /mnt."
- umount /mnt
- cryptsetup remove luks-home
- losetup -d ${FREE_LOSETUP}
- exit 1
-fi
-echo "** Done."
-echo ""
-
-echo "** All done."
-echo "** Closing losetup, cryptsetup and mounted /mnt."
-# umount and close
-umount /mnt
-cryptsetup remove luks-home
-losetup -d ${FREE_LOSETUP}
-echo "** The disk file image luks-home.img is done and ready. Move it into a partition"
-echo "** with 'lukshome' as label and reboot with lukshome boot option to use it."
-echo ""
-
-EOF
-
-chmod 0755 /usr/local/sbin/create-lukshome-file.sh
-
-
-
-echo "I: creating script /usr/local/sbin/lukshome.sh"
-cat > /usr/local/sbin/lukshome.sh << 'EOF'
-#!/bin/sh
-
-# this script is to be executed by a hook in live-initramfs. It searches
-# for a partition with 'lukshome' label, mounts it as /luks-home, then opens an
-# encrypted disk image file called luks-home.img as a loopback device, opens it
-# with cryptsetup and finally mounts the present filesystem as /home.
-# It also changes /etc/init.d/umountfs to umount the lukshome partition
-# (/luks-home) and clear the loopback device on shutdown.
-
-# functions taken from live-helpers
-. /usr/share/initramfs-tools/scripts/live-helpers
-
-# search for a partition labeled "lukshome"
-for sysblock in $(echo /sys/block/* | tr ' ' '\n' | grep -v loop | grep -v ram | grep -v fd)
-do
- for dev in $(subdevices "${sysblock}")
- do
- devname=$(sys2dev "${dev}")
- # find partition name and filesystem type
- if [ "$(/lib/udev/vol_id -l ${devname} 2>/dev/null)" = "lukshome" ]
- then
- # found one partition named "lukshome"
- CRYPTHOME="${devname}"
- # don't search further
- break
- fi
- done
- # if already found, don't search further
- if [ -n "${CRYPTHOME}" ]
- then
- break
- fi
-done
-
-# if no partition found, exit
-if [ -z "${CRYPTHOME}" ]
-then
- echo "Could not find any partition with lukshome label. "
- echo "Proceeding with no encrypted /home."
- exit 0
-fi
-
-# mount partition where file container is
-echo "Mounting /luks-home with ${CRYPTHOME}."
-mkdir -p /luks-home
-mount -t $(get_fstype "${CRYPTHOME}") "${CRYPTHOME}" /luks-home
-
-# mount losetup encrypted file
-FREE_LOOP="$(/sbin/losetup -f)"
-echo "Opening /luks-home/luks-home.img in ${FREE_LOOP}."
-
-if [ -f /luks-home/luks-home.img ]
-then
- /sbin/losetup ${FREE_LOOP} /luks-home/luks-home.img
-
- echo "Adding ${FREE_LOOP} home to /etc/crypttab and setting it as /home in /etc/fstab."
-
- # update crypttab
- echo "home ${FREE_LOOP} none luks,check,timeout" >> /etc/crypttab
-
- # update fstab
- echo "/dev/mapper/home /home ext2 defaults,noatime 0 0" >> /etc/fstab
-else
- echo "Did not found any luks-home.img file in ${CRYPTHOME}!"
- echo "Proceeding with no encrypted /home."
- umount -r /luks-home
- exit 0
-fi
-
-# changes to /etc/init.d/umountfs to make /luks-home being umounted on shutdown
-sed -i 's/[\t]do_stop/CHANGE_HERE/' /etc/init.d/umountfs
-sed -i 's|CHANGE_HERE| \
- # added by lukshome hook - umount \/luks-home to prevent busy device on shutdown \
- LOOP_LUKSHOME=$(losetup -a \| grep luks-home \|cut -c 1-10) \
- if [ -n ${LOOP_LUKSHOME} ] \
- then \
- umount -r -d \/home \
- cryptsetup remove home \
- losetup -d ${LOOP_LUKSHOME} \
- umount -r \/luks-home \
- fi \
-\
- do_stop \
-|' /etc/init.d/umountfs
-
-EOF
-
-chmod 0755 /usr/local/sbin/lukshome.sh
-
-
-
-# scripts/live-bottom/13live_luks_home, right after 12fstab
-echo "I: creating /usr/share/initramfs-tools/scripts/live-bottom/13live_luks_home"
-
-cat > /usr/share/initramfs-tools/scripts/live-bottom/13live_luks_home << 'EOF'
-#!/bin/sh
-
-#set -e
-
-# initramfs-tools header
-
-PREREQ=""
-
-prereqs()
-{
- echo "${PREREQ}"
-}
-
-case "${1}" in
- prereqs)
- prereqs
- exit 0
- ;;
-esac
-
-. /scripts/live-functions
-
-# live-initramfs hook to use an disk image file with encrypted filesystem as /home.
-
-log_begin_msg "Executing losetup-lukshome"
-
-# get boot option lukshome - adapted from live-helpers
-for ARGUMENT in $(cat /proc/cmdline)
-do
- case "${ARGUMENT}" in
- lukshome)
- LUKSHOME=1
- ;;
- esac
-done
-
-# don't use persistent* and lukshome
-if [ -n "${PERSISTENT}" ] && [ -n "${LUKSHOME}" ]
-then
- echo "You should not use persistent and lukshome at the same time."
- echo "Skipping lukshome. Persistent medium, if any, will be used instead."
- log_end_msg
- exit 0
-fi
-
-# if no lukshome boot option, exit
-if [ -z "${LUKSHOME}" ]
-then
- log_end_msg
- exit 0
-fi
-
-log_begin_msg "Executing lukshome.sh script."
-
-mount -o bind /sys /root/sys
-mount -o bind /proc /root/proc
-mount -o bind /dev /root/dev
-
-# lukshome.sh detects lukshome partition and file location, mounts it
-# and opens the file and then updates fstab and crypttab to use it as /home.
-chroot /root /usr/local/sbin/lukshome.sh
-
-umount /root/sys
-umount /root/proc
-umount /root/dev
-
-# delete the lukshome scripts, not needed anymore
-# rm -f /root/usr/local/sbin/lukshome.sh
-# rm -f /root/usr/local/sbin/create-lukshome-file.sh
-
-log_end_msg
-
-EOF
-
-chmod 0755 /usr/share/initramfs-tools/scripts/live-bottom/13live_luks_home
-
-
-
-echo "I: update-initramfs to include 13live_luks_home."
-# if you already have installed the update-initramfs.sh hook, you can remove
-# this.
-
-for KERNEL in /boot/vmlinuz-*
-do
- VERSION="$(basename ${KERNEL} | sed -e 's|vmlinuz-||')"
-
- update-initramfs -k ${VERSION} -t -u
-done