GitHub

The Void Linux live image/rootfs generator and installer

Overview

This repository contains several utilities:

  • mklive.sh - The Void Linux live image generator for x86
  • mkiso.sh - Wrapper script to generate bootable and installable live images for i686, x86_64, and aarch64.
  • mkrootfs.sh - The Void Linux rootfs generator for all platforms
  • mkplatformfs.sh - The Void Linux filesystem tool to produce a rootfs for a particular platform
  • mkimage.sh - The Void Linux image generator for ARM platforms
  • mknet.sh - Script to generate netboot tarballs for Void
  • installer.sh - The Void Linux el-cheapo installer for x86
  • release.sh - interacts with GitHub CI to generate and sign images for releases

Workflow

Generating x86 live ISOs

To generate a live ISO like the officially-published ones, use mkiso.sh. To generate a more basic live ISO (which does not include things like void-installer), use mklive.sh.

Generating ROOTFS tarballs

ROOTFS tarballs contain a basic Void Linux root filesystem without a kernel. These can be useful for doing a chroot install or for chroots and containers.

Use mkrootfs.sh to generate a Void Linux ROOTFS.

Generating platform-specific tarballs

Platform-specific ROOTFS tarballs, or PLATFORMFS tarballs, contain a basic Void Linux root filesystem including a kernel. These are commonly used for bootstrapping ARM systems or other environments that require platform-specific kernels, like Raspberry Pis.

First create a ROOTFS for the desired architecture, then use mkplatformfs.sh to generate a Void Linux PLATFORMFS.

Generating ARM images

Platform-specific filesystem images contain a basic filesystem layout (/ and /boot partitions), ready to be copied to the target drive with dd. These are not "live" images like those available on x86 platforms, and do not need installation like live ISOs.

To generate these images, first create a PLATFORMFS for the desired platform, then use mkimage.sh to generate the image.

Dependencies

Note that void-mklive is not guaranteed to work on distributions other than Void Linux, or in containers.

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

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

Usage

mkiso.sh

Usage: mkiso.sh [options ...] [-- mklive options ...]
Wrapper script around mklive.sh for several standard flavors of live images.
Adds void-installer and other helpful utilities to the generated images.
OPTIONS
 -a <arch>     Set architecture (or platform) in the image
 -b <variant>  One of base, enlightenment, xfce, mate, cinnamon, gnome, kde,
               lxde, lxqt, or xfce-wayland (default: base). May be specified multiple times
               to build multiple variants
 -d <date>     Override the datestamp on the generated image (YYYYMMDD format)
 -t <arch-date-variant>
               Equivalent to setting -a, -b, and -d
 -r <repo>     Use this XBPS repository. May be specified multiple times
 -h            Show this help and exit
 -V            Show version and exit
Other options can be passed directly to mklive.sh by specifying them after the --.
See mklive.sh -h for more details.

mklive.sh

"Usage: mklive.sh [options] Generates a basic live ISO image of Void Linux. This ISO image can be written to a CD/DVD-ROM or any USB stick. To generate a more complete live ISO image, use mkiso.sh. OPTIONS -a Set XBPS_ARCH in the ISO image -b Set an alternative base package (default: base-system) -r Use this XBPS repository. May be specified multiple times -c Use this XBPS cache directory (default: ./xbps-cachedir- ) -H Use this Host XBPS cache directory (default: ./xbps-cachedir- ) -k Default keymap to use (default: us) -l Default locale to use (default: en_US.UTF-8) -i Compression type for the initramfs image (default: xz) -s Compression type for the squashfs image (default: xz) -o Output file name for the ISO image (default: automatic) -p " ..." Install additional packages in the ISO image -g " ..." Ignore packages when building the ISO image -I Include directory structure under given path in the ROOTFS -S " ..." Enable services in the ISO image -e Default shell of the root user (must be absolute path). Set the live.shell kernel argument to change the default shell of anon. -C " ..." Add additional kernel command line arguments -P " ..." Platforms to enable for aarch64 EFI ISO images (available: pinebookpro, x13s) -T

Read the original on github.com ↗