elbe-init

NAME

elbe-init - create a project for an Elbe build virtual machine

SYNOPSIS

elbe init \
        [ --build-source ] \
        [ --buildtype <buildtype> ] \
        [ --debug ] \
        [ --directory <directory> ] \
        [ --skip-cds ] \
        [ --skip-validation ] \
        <xmlfile>

DESCRIPTION

This command generates a project directory for an Elbe build virtual machine.

When make is executed in that directory, a VM is started, which installs Debian and the Elbe build environment. If the XML file contains a target section, then the target root filesystem will be built inside the virtual machine using elbe-buildchroot(1).

The build VM can be started by executing make run (or make run-con, if a serial console is enough). After that, the virtual machine can be used to work inside the generated root filesystem. To do so, please use the elbe-chroot(1) command inside the VM.

OPTIONS

--build-source

Build a Debian source CD-ROM image, containing the source packages used by the project.

--buildtype <buildtype>

Override the build type specified in the XML file.

--debug

Enables a few features that allow for better debugging of the build process.

--directory <dir>

The location of the project directory. If this option isn’t given, a directory build is created in the current working directory. The directory must not exist.

--skip-cds

Skip the generation of Debian binary cdroms. This makes the build faster. Otherwise all used binary packages are stored on an ISO cdrom image.

--skip-validation

Skip the validation of the XML file. (Not recommended)

<xmlfile>

The XML describing the Elbe project.

EXAMPLES

  • Generate a build VM directory for the project specified in project.xml and build the target root filesystem.

    $ elbe init --directory=/scratch/example project.xml
    $ cd /scratch/example
    $ make
    

ELBE

Part of the elbe(1) suite