autopkgtest-virt-unshare - autopkgtest using unshare user namespaces
Contents
Description
autopkgtest-virt-unshare provides an autopkgtest by using a rootfs tarball and the unshare command to
create a chroot as a normal user. By default it searches for tarballs in ~/.cache/sbuild to reuse the
those created for sbuild. In case no tarball was found it tries to create on on the fly by using
mmdebstrap.
autopkgtest-virt-unshare requires the unshare(1) executable from util-linux version 2.38 or later. For
distribution versions where that is not available system-wide, such as Debian 11, Ubuntu 22.04 and older
releases, a locally-installed copy of the unshare executable in a directory prepended to the PATH is
sufficient.
Normally autopkgtest-virt-unshare will be invoked by autopkgtest.
Examples
autopkgtest hello -- unshare -r unstable
Input, Output And Exit Status
The behaviour of autopkgtest-virt-unshare is as described by the AutomatedTesting virtualisation regime
specification.
Name
autopkgtest-virt-unshare - autopkgtest using unshare user namespaces
Options
-a | --archARCHITECTURE
Debian name of the architecture.
-b | --bindOUTSIDEINSIDE
Bind mount a directory from the outside to a mountpoint inside. OUTSIDE needs to be an existing
directory in the local filesystem. INSIDE needs to be an absolute path in the new chroot and will
be created if it does not exist.
--bootstrapcmdCMD
Set alternative chroot bootstrap command (including command line options).
-p | --prefixPREFIX
Prefix for the temporary unpack directory (passed to mkdtemp ).
-r | --releaseRELEASE
The distribution to use Mnemonic: the r is the first letter in "release".
-t | --tarball/path/to/tarball
Path to a rootfs tarball.
-u | --unpack-dir/path/for/new/rootfs
Specifies a directory where the rootfs tarball should be extracted. By default mkdtemp is used to
create a temporary directory.
-d | --debug
Enables debugging output. Probably not hugely interesting.
See Also
autopkgtest(1), autopkgtest-chroot(1), /usr/share/doc/autopkgtest/.
Synopsis
autopkgtest[...]--unshare [options]
