void-mklive/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)
 * mkrootfs  (The Void Linux rootfs maker for ARM platforms)

#### Dependencies

 * xbps>=0.35
 * parted (for mkimage)
 * qemu-user-static binaries (for mkrootfs)

#### Usage

Type

    $ make

and then see the usage output:

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

#### Examples

Build an x86 live image with runit and keyboard set to 'fr':

    # ./mklive.sh -k fr

Build an x86 live image with systemd and some optional packages:

    # ./mklive.sh -b base-system-systemd -p 'vim rtorrent'

See the usage output for more information :-)
README: update. 2013-08-22 15:35:31 +00:00			`## The Void Linux image/live/rootfs maker and installer`
Initial import of void-mklive 0.9.5 (from srcpkgs/vmklive). 2012-06-12 14:27:17 +00:00
README: update. 2013-08-22 15:35:31 +00:00			`This repository contains utilities for Void Linux:`
Initial import of void-mklive 0.9.5 (from srcpkgs/vmklive). 2012-06-12 14:27:17 +00:00
README.md: sync with reality. 2014-04-23 09:30:05 +00:00			`* installer (The Void Linux el-cheapo installer for x86)`
			`* mklive (The Void Linux live image maker for x86)`
README: update. 2014-01-28 15:08:04 -01:00
README.md: sync with reality. 2014-04-23 09:30:05 +00:00			`* mkimage (The Void Linux image maker for ARM platforms)`
			`* mkrootfs (The Void Linux rootfs maker for ARM platforms)`
Revamped to support EFI booting via grub2. 2012-07-06 13:29:12 +00:00
README: update. 2013-08-22 15:35:31 +00:00			`#### Dependencies`
Multiple updates and fixes; needs bash and xbps>=0.21. 2013-03-11 21:52:40 -01:00
mklive: switch to xbps-uchroot(8); bye bye systemd-nspawn. 2014-04-22 10:11:34 +00:00			`* xbps>=0.35`
mklive: improved to avoid host deps; use our own pkgs to generate images. That means that mklive just needs xbps to generate working images. Usage: mklive.sh [options] Options: -r <repo-url> Use this XBPS repository (may be specified multiple times). -c <cachedir> Use this XBPS cache directory (/var/cache/xbps if unset). -k <keymap> Default keymap to use (us if unset) -l <locale> Default locale to use (en_US.UTF-8 if unset). -i <gzip\|bzip2\|xz> Compression type for the initramfs image (gzip if unset). -s <gzip\|bzip2\|xz> Compression type for the squashfs image (xz if unset) -o <file> Output file name for the ISO image (auto if unset). -p "pkg pkgN ..." Install additional packages into the ISO image. The mklive.sh script generates a live image of the Void Linux distribution. This ISO image can be written to a CD/DVD-ROM or any USB stick. 2014-05-22 20:00:31 +00:00			`* parted (for mkimage)`
			`* qemu-user-static binaries (for mkrootfs)`
Revamped to support EFI booting via grub2. 2012-07-06 13:29:12 +00:00
README.md: sync with reality. 2014-04-23 09:30:05 +00:00			`#### Usage`

			`Type`

			`$ make`

			`and then see the usage output:`

			`$ ./mklive.sh -h`
			`$ ./mkrootfs.sh -h`
			`$ ./mkimage.sh -h`
README: add some examples. 2014-06-25 16:10:09 +00:00
			`#### Examples`

			`Build an x86 live image with runit and keyboard set to 'fr':`

README: update. 2014-08-03 18:15:19 +00:00			`# ./mklive.sh -k fr`
README: add some examples. 2014-06-25 16:10:09 +00:00
			`Build an x86 live image with systemd and some optional packages:`

README: update. 2014-08-03 18:15:19 +00:00			`# ./mklive.sh -b base-system-systemd -p 'vim rtorrent'`
README: add some examples. 2014-06-25 16:10:09 +00:00
			`See the usage output for more information :-)`