= 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:

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

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

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

. 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 pass:[<rrq@rrq.au>]
