'\" t
.\"     Title: debspawn-run
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 18 August, 2018
.\"    Manual: debspawn run
.\"    Source: Debspawn
.\"  Language: English
.\"
.TH "DEBSPAWN\-RUN" "1" "" "Debspawn" "debspawn run"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
debspawn-run \- Run arbitrary commands in debspawn container session
.SH "SYNOPSIS"
.HP \w'\fBdebspawn\ run\fR\ 'u
\fBdebspawn run\fR [\-h|\-\-help] [\-\-variant] [\-a|\-\-arch] [\-\-artifacts\-out] [\-\-build\-dir] [\-\-cachekey] [\-\-init\-command] [\-x|\-\-external\-command] [\-\-header] [\-\-allow] {SUITE}
.SH "DESCRIPTION"
.PP
This subcommand allows you to run arbitrary commands in an ephemeral
\fBdebspawn\fR
container, using the same environment that is normally used for building packages\&.
.PP
\fBdebspawn run\fR
is explicitly designed to be used by other tools for custom applications, and usually, you will want to use
\fBdebspawn build\fR
instead to build Debian packages\&.
.SH "OPTIONS"
.PP
\-h|\-\-help
.RS 4
Print brief help information about available commands\&.
.RE
.PP
\-\-variant
.RS 4
Set the variant of the selected image, that was used for bootstrapping\&.
.RE
.PP
\-a|\-\-arch
.RS 4
The architecture of the base image that should be selected\&.
.RE
.PP
\-\-artifacts\-out
.RS 4
Directory on the host where artifacts can be stored\&. Mounted to /srv/artifacts in the guest\&.
.RE
.PP
\-\-build\-dir
.RS 4
Select a host directory that gets bind mounted to /srv/build\&.
.RE
.PP
\-\-cachekey
.RS 4
If set, use the specified cache\-ID to store an initialized container image for faster initialization times\&. This may mean that the command passed in `\-\-init\-command` is skipped if the cache already existed\&.
.RE
.PP
\-\-init\-command
.RS 4
The command or command script used to set up the container\&.
.RE
.PP
\-x|\-\-external\-command
.RS 4
If set, the command script(s) will be copied from the host to the container and then executed\&.
.RE
.PP
\-\-header
.RS 4
Name of the task that is run, will be printed as header\&.
.RE
.PP
\-\-allow
.RS 4
List one or more additional permissions to grant the container\&. Takes a comma\-separated list of capability names\&.
.RE
.SH "SEE ALSO"
.PP
debspawn\-build(1)\&.
.SH "AUTHOR"
.PP
This manual page was written by Matthias Klumpp
<mak@debian\&.org>\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2018-2021 Matthias Klumpp
.br