install.md

Install Instructions

Manual install from git

Assuming you have git, make and root privileges:

git clone --branch latest https://github.com/jsamr/bootiso.git
cd bootiso
make install

Check the dependencies section for a list of packages to install. The Makefile install target installs bootiso, its man page and shell completions. You can uninstall from the same directory as the install step with the following:

make uninstall

Dependencies

bootiso relies mainly on classic GNU and POSIX command line utilities, with the exception of the more recents wimlib and jq.

bootiso should also have a soft dependency on mkfs.xxx creation commands for each supported filesystem. User will be invited to install the appropriate utility when the requested filesystem has no matching creation command. However, for the sake of user comfort, it is recommended that package maintainers define a hard dependency on the following commands:

• mkfs.ext{2,3,4}
• mkfs.fat
• mkfs.ntfs

The corresponding packages in Arch Linux are e2fsprogs, dosfstools and ntfs-3g. Mandated dependencies are listed bellow.

command	package
	Arch Linux	Debian	Red Hat
wimlib-imagex	wimlib	wimtools	wimlib-utils
extlinux	syslinux	extlinux	syslinux
syslinux		syslinux
getconf	glibc	libc-bin	glibc
tput	ncurses	ncurses-bin	ncurses
sfdisk	util-linux ≥ 2.27	fdisk or util-linux ≥ 2.271	util-linux ≥ 2.27
blkid, blockdev, blockdev, column, eject, lsblk, mkfs, mount, partx, umount, wipefs		util-linux ≥ 2.27
bash	bash ≥ 4.0
basename, cat, chmod, cut, date, dirname, md5sum, mkdir, sha1sum, sha256sum, sha512sum, sleep, tr, tty, …etc	coreutils
strings	binutils
find, xargs	findutils
jq	jq
sed	sed
grep	grep
file	file
awk	gawk
rsync	rsync
curl	curl
tar	tar
bc	bc

¹ fdisk has been shipped as a separate package for Debian since “Buster” (10.4) and Ubuntu “Bionic” (18.04).