manuel
/
void-mklive
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
The Void Linux live image maker
733 Commits 2 Branches 6 Tags 9.4 MiB
Shell 95.6%
Makefile 2.6%
HCL 1.8%
Go to file
classabbyamp 65b9796340 *.sh: clean up help output 2023-11-19 16:02:06 -05:00
.github/workflows .github/workflows/gen-images.yml: create CI workflow 2023-06-14 03:27:39 -04:00
data data, mklive.sh.in: remove void-vpkgs.conf 2021-03-15 22:17:38 -07:00
dracut build-x86-images, dracut/vmklive, installer: add support for brltty 2023-06-28 01:07:22 -04:00
grub grub: add menu entries for screenreader, memtest, efi fw setup, reboot, poweroff 2023-06-28 01:07:22 -04:00
isolinux isolinux: add menu entries for screenreader, memtest, reboot, poweroff 2023-06-28 01:07:22 -04:00
keys Added musl.voidlinux.net RSA pubkey. 2015-05-08 17:25:42 +02:00
packer packer: Ensure cloud images generate new keys 2023-03-20 22:42:36 -05:00
pxelinux.cfg Add netboot generator script 2017-08-06 21:03:55 -07:00
.gitignore release.sh: replace with script that triggers CI 2023-06-14 03:27:39 -04:00
COPYING COPYING: it's 2015. 2015-04-15 07:33:47 +02:00
Makefile *: remove support for cubie, bananapi, odroid, beaglebone, ci20 boards 2023-10-13 01:01:08 -04:00
README.md dracut/vmklive: rename live.screenreader to live.accessibility 2023-06-28 01:07:22 -04:00
build-x86-images.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
installer.sh installer: also remove xmirror 2023-08-06 11:28:40 -04:00
lib.sh lib.sh: support sourcing with set -u 2023-11-19 15:50:14 -05:00
mkimage.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
mklive.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
mknet.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
mkplatformfs.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
mkrootfs.sh *.sh: clean up help output 2023-11-19 16:02:06 -05:00
release.sh release.sh: replace with script that triggers CI 2023-06-14 03:27:39 -04:00
version version: bump 2023-06-28 02:05:13 -04:00

README.md

The Void Linux image/live/rootfs maker and installer

This repository contains utilities for Void Linux:

  • installer (The Void Linux el-cheapo installer for x86)

  • mklive (The Void Linux live image maker for x86)

  • mkimage (The Void Linux image maker for ARM platforms)

  • mkplatformfs (The Void Linux filesystem tool to produce a rootfs for a particular platform)

  • mkrootfs (The Void Linux rootfs maker for ARM platforms)

  • mknet (Script to generate netboot tarballs for Void)

Dependencies

  • Compression type for the initramfs image
    • liblz4 (for lz4, xz) (default)
  • xbps>=0.45
  • qemu-user-static binaries (for mkrootfs)
  • bash

Usage

See the usage output:

$ ./mklive.sh -h
$ ./mkrootfs.sh -h
$ ./mkimage.sh -h

Examples

Build a native live image keyboard set to 'fr':

# ./mklive.sh -k fr

Build an i686 (on x86_64) live image with some additional packages:

# ./mklive.sh -a i686 -p 'vim rtorrent'

Build an x86_64 musl live image with packages stored in a local repository:

# ./mklive.sh -a x86_64-musl -r /path/to/host/binpkgs

See the usage output for more information :-)

Kernel Command-line Parameters

void-mklive-based live images support several kernel command-line arguments that can change the behavior of the live system:

  • live.autologin will skip the initial login screen on tty1.
  • live.user will change the username of the non-root user from the default anon. The password remains voidlinux.
  • live.shell sets the default shell for the non-root user in the live environment.
  • live.accessibility enables accessibility features like the console screenreader espeakup in the live environment.
  • console can be set to ttyS0, hvc0, or hvsi0 to enable agetty on that serial console.
  • locale.LANG will set the LANG environment variable. Defaults to en_US.UTF-8.
  • vconsole.keymap will set the console keymap. Defaults to us.

Examples:

  • live.autologin live.user=foo live.shell=/bin/bash would create the user foo with the default shell /bin/bash on boot, and log them in automatically on tty1
  • live.shell=/bin/bash would set the default shell for the anon user to /bin/bash
  • console=ttyS0 vconsole.keymap=cf would enable ttyS0 and set the keymap in the console to cf
  • locale.LANG=fr_CA.UTF-8 would set the live system's language to fr_CA.UTF-8