Operating System Image Tools
Go to file
Luke T. Shumaker 7a7c9e09f6 Delete notsystemd-tests specific TODO.md 2023-12-12 20:21:50 -07:00
Documentation osi-mount: Fix usage string 2023-11-07 21:39:42 -07:00
lib osi.sh: Use gprintf instead of print in error() 2023-10-30 12:37:42 -06:00
mypy-stubs Write a `pacman-choices` program 2023-10-30 12:37:42 -06:00
.gitignore rename things 2018-08-05 21:56:44 -04:00
COPYING.AGPL.txt copyright statements/identifiers 2018-08-18 14:42:42 -04:00
COPYING.md Update README.md and COPYING.md 2023-10-28 14:18:45 -06:00
Makefile Document the osi-mk module interface 2023-10-31 02:45:56 -06:00
README.md Move docs+examples to a 'Documentation' directory 2023-11-06 11:42:01 -07:00
indent indent: Relicense from GPLv3+ to AGPLv3+ 2023-12-12 20:19:52 -07:00
osi-extract Don't require to be run in this directory 2023-10-31 02:46:03 -06:00
osi-mk osi-mk: Drop the grub-hack 2023-12-12 20:12:33 -07:00
osi-mount osi-mount: Fix usage string 2023-11-07 21:39:42 -07:00
osi-shell Don't require to be run in this directory 2023-10-31 02:46:03 -06:00
pacman-choices osi-mk: Have the user explicitly make pacman choices 2023-10-30 15:10:08 -06:00

README.md

osi-tools: Operating System Image Tools

Usage

$ ./osi-mk [FLAGS] SYS.img                               # to build an image
$ ./osi-shell SYS.img                                    # launch an interactive shell in an emulator
$ sudo ./osi-mount --{root|user} SYS.img MNT COMMAND     # run command with SYS.img mounted at MNT
$ sudo ./osi-extract SYS.img IMAGE_SRC_DIR HOST_DST_DIR  # to extract files from an image

Dependencies

I believe the complete list of dependencies is (along with what I believe is the newest feature that is depended on):

  • arch-install-scripts
  • btrfs-progs
  • GNU Bash 4.4 (needs @Q)
  • GNU coretutils 8.15 (needs realpath)
  • GNU gettext
  • QEMU (needs qemu-system-x86_64)
  • sed
  • sudo
  • util-linux-ng 2.18 or newer (needs automatic loop devices in mount)

This can be install on a Parabola Parabola GNU/Linux-libre system with the following command:

sudo pacman -S --needed arch-install-scripts btrfs-progs bash coreutils gettext qemu-system-x86 sed sudo util-linux

Developing

You can lint the code in this repository by running make lint, which requires the shellcheck command.