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-buildchroot1.

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-chroot1 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 elbe1 suite