Scroll to navigation

DEBSPAWN(1) debspawn DEBSPAWN(1)

NAME

debspawn - Build in nspawn containers

SYNOPSIS

debspawn [-h|--help] [-c|--config] [--verbose] [--no-unicode] [--version] [--owner] [COMMAND]

DESCRIPTION

This manual page documents the debspawn command.

debspawn is a tool to build Debian packages in an isolated environment, using nspawn containers. By using containers, debspawn can isolate builds from the host system much further. It also allows for more advanced features to manage builds, for example setting resource limits for individual builds.

Please keep in mind that debspawn is not a security feature! While it provides a lot of isolation from the host system, you should not run arbitrary untrusted code with it. The usual warnings for all container technology apply here. See systemd-nspawn(1) for more information on the container solution debspawn uses.

Debspawn also allows one to run arbitrary custom commands in its environment. This is useful to execute a variety of non-package build and QA actions in the same environment in which packages are normally built.

For more information about the DebSpawn project, you can visit its project page[1].

SUBCOMMANDS

debspawn actions are invoked via subcommands. Refer to their individual manual pages for further details.

create

Create a new container base image for a specific suite, architecture and variant. A custom mirror location can also be provided. For details, see debspawn-create(1).

delete

Delete a container base image and all data associated with it. For details, see debspawn-delete(1).

update

Update a container base image, ensuring all packages are up to date and all required scripts are installed. For details, see debspawn-update(1).

build

Build a Debian package in an isolated environment. For details, see debspawn-build(1).

login

Get an interactive shell session in a container. For details, see debspawn-login(1).

run

Run arbitrary commands in debspawn container session. This is primarily useful for using debspawn from another script. For details, see debspawn-run(1).

FLAGS

-h|--help
Print brief help information about available commands.

-c|--config

Path to the global config file.

--verbose

Enable debug messages.

--no-unicode

Disable unicode support.

--version

Display the version of debspawn itself.

--owner

Set the user name/uid and group/gid separated by a colon whose behalf we are acting.

SEE ALSO

dpkg-buildpackage(1), systemd-nspawn(1), sbuild(1).

AUTHOR

This manual page was written by Matthias Klumpp <mak@debian.org>.

COPYRIGHT

Copyright © 2018 Matthias Klumpp

NOTES

1.
project page
DebSpawn