ISO/scripts/run_archiso.sh
David Runge e748a770b1
Add accessibility support based on option flag
scripts/run_archiso.sh:
Add the `-a` option flag to add accessibility support on demand for `run_archiso`.

Add accessibility specific options to qemu in `run_image()`.

Not providing the specific braille chardev hardware otherwise blocks running run_archiso with
`qemu-system-x86_64: -chardev braille,id=brltty: brlapi__openConnection: connect: No such file or directory`.

Fixes #77
2020-10-29 16:57:04 +01:00

168 lines
4.3 KiB
Bash
Executable File

#!/usr/bin/env bash
#
# Copyright (C) 2020 David Runge <dvzrv@archlinux.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# A simple script to run an archiso image using qemu. The image can be booted
# using BIOS or UEFI.
#
# Requirements:
# - qemu
# - edk2-ovmf (when UEFI booting)
set -eu
print_help() {
local usagetext
IFS='' read -r -d '' usagetext <<EOF || true
Usage:
run_archiso [options]
Options:
-a set accessibility support using brltty
-b set boot type to 'BIOS' (default)
-d set image type to hard disk instead of optical disc
-h print help
-i [image] image to boot into
-s use Secure Boot (only relevant when using UEFI)
-u set boot type to 'UEFI'
Example:
Run an image using UEFI:
$ run_archiso -u -i archiso-2020.05.23-x86_64.iso
EOF
printf '%s' "${usagetext}"
}
cleanup_working_dir() {
if [[ -d "${working_dir}" ]]; then
rm -rf -- "${working_dir}"
fi
}
copy_ovmf_vars() {
if [[ ! -f '/usr/share/edk2-ovmf/x64/OVMF_VARS.fd' ]]; then
printf 'ERROR: %s\n' "OVMF_VARS.fd not found. Install edk2-ovmf."
exit 1
fi
cp -av -- '/usr/share/edk2-ovmf/x64/OVMF_VARS.fd' "${working_dir}/"
}
check_image() {
if [[ -z "$image" ]]; then
printf 'ERROR: %s\n' "Image name can not be empty."
exit 1
fi
if [[ ! -f "$image" ]]; then
printf 'ERROR: %s\n' "Image file (${image}) does not exist."
exit 1
fi
}
run_image() {
if [[ "$boot_type" == 'uefi' ]]; then
copy_ovmf_vars
if [[ "${secure_boot}" == 'on' ]]; then
printf '%s\n' 'Using Secure Boot'
local ovmf_code='/usr/share/edk2-ovmf/x64/OVMF_CODE.secboot.fd'
else
local ovmf_code='/usr/share/edk2-ovmf/x64/OVMF_CODE.fd'
fi
qemu_options+=(
'-drive' "if=pflash,format=raw,unit=0,file=${ovmf_code},readonly"
'-drive' "if=pflash,format=raw,unit=1,file=${working_dir}/OVMF_VARS.fd"
'-global' "driver=cfi.pflash01,property=secure,value=${secure_boot}"
)
fi
if [[ "${accessibility}" == 'on' ]]; then
qemu_options+=(
'-chardev' 'braille,id=brltty'
'-device' 'usb-braille,id=usbbrl,chardev=brltty'
)
fi
qemu-system-x86_64 \
-boot order=d,menu=on,reboot-timeout=5000 \
-m "size=3072,slots=0,maxmem=$((3072*1024*1024))" \
-k en \
-name archiso,process=archiso_0 \
-device virtio-scsi-pci,id=scsi0 \
-device "scsi-${mediatype%rom},bus=scsi0.0,drive=${mediatype}0" \
-drive "id=${mediatype}0,if=none,format=raw,media=${mediatype/hd/disk},readonly=on,file=${image}" \
-display sdl \
-vga virtio \
-audiodev pa,id=snd0 \
-device ich9-intel-hda \
-device hda-output,audiodev=snd0 \
-device virtio-net-pci,romfile=,netdev=net0 -netdev user,id=net0 \
-machine type=q35,smm=on,accel=kvm,usb=on,pcspk-audiodev=snd0 \
-global ICH9-LPC.disable_s3=1 \
-enable-kvm \
"${qemu_options[@]}" \
-serial stdio \
-no-reboot
}
set_image() {
if [[ -z "$image" ]]; then
printf 'ERROR: %s\n' "Image name can not be empty."
exit 1
fi
if [[ ! -f "$image" ]]; then
printf 'ERROR: %s\n' "Image (${image}) does not exist."
exit 1
fi
image="$1"
}
image=''
accessibility=''
boot_type='bios'
mediatype='cdrom'
secure_boot='off'
qemu_options=()
working_dir="$(mktemp -dt run_archiso.XXXXXXXXXX)"
trap cleanup_working_dir EXIT
if (( ${#@} > 0 )); then
while getopts 'abdhi:su' flag; do
case "$flag" in
a)
accessibility='on'
;;
b)
boot_type='bios'
;;
d)
mediatype='hd'
;;
h)
print_help
exit 0
;;
i)
image="$OPTARG"
;;
u)
boot_type='uefi'
;;
s)
secure_boot='on'
;;
*)
printf '%s\n' "Error: Wrong option. Try 'run_archiso -h'."
exit 1
;;
esac
done
else
print_help
exit 1
fi
check_image
run_image