CROSSHURD-IMAGE(8)

NAME
crosshurd-image - Create a bootable disk image file with `crosshurd` setup

SYNOPSIS

crosshurd-image [option_*]

DESCRIPTION

The script crosshurd-image creates a bootable disk image file with a crosshurd setup. This may be used as primary disk for a virtual machine, e.g. with qemu-system-x86_64.

OPTIONS

--disk=filename
    use the given filename for the disk image file instead of the default base.img.

--size=number
    make the disk image file be the given number of GiB instead of the default 40.

--name=hostname
    setup the filesystem with the given hostname instead of the default hurd-test`. This name will be written into both /etc/hosts and /etc/hostname in the created filsystem.

--ip=address/bits
    use the given ipv4 address and network part bits size instead of the default 192.168.240.2/24.

--gw=address
    use the given ipv4 address for as gateway instead of the default 192.168.240.1.

--extlinux
    use extlinux boot equipment instad of the default grub.

NOTES

crosshurd-image runs through a straight-forward sequence of steps that involve:

    1. create a blank disk image file,
    partitioned in a DOS table with a single partition, and
    formatted for GNU Hurd (ext2fs -o hurd)

    2. use crosshurd for stage-1 setup of the GNU Hurd Debian filesystem

    3. add a bootloader (syslinux or grub) to the disk image file
    with stage 1 boot loader, and
    multiboot configuration for GNU Hurd core modules

    4. finalize setup with hostname and networking setup

The disk image file is then ready to be used as primary disk for a virtual machine with legacy bios boot.

Note that the disk image file is created as a "holes" file where only data blocks actually in use have been allocated in the filesystem. This means that the actual size initially is smaller than reported by, say, ls -l.

AUTHOR

Ralph Ronnquist <rrq@rrq.au>