Man page - autopkgtest-virt-unshare(1)
Packages contains this manual
- autopkgtest-build-lxd(1)
- autopkgtest-virt-lxc(1)
- autopkgtest-virt-ssh(1)
- autopkgtest-build-docker(1)
- autopkgtest-virt-null(1)
- autopkgtest(1)
- autopkgtest-build-incus(1)
- autopkgtest-build-qemu(1)
- autopkgtest-virt-chroot(1)
- autopkgtest-build-podman(1)
- autopkgtest-virt-schroot(1)
- autopkgtest-buildvm-ubuntu-cloud(1)
- autopkgtest-virt-lxd(1)
- autopkgtest-virt-podman(1)
- autopkgtest-virt-incus(1)
- autopkgtest-virt-qemu(1)
- autopkgtest-virt-docker(1)
- autopkgtest-virt-unshare(1)
- autopkgtest-build-lxc(1)
apt-get install autopkgtest
Manual
autopkgtest-virt-unshare
NAMESYNOPSIS
DESCRIPTION
OPTIONS
INPUT, OUTPUT AND EXIT STATUS
EXAMPLES
SEE ALSO
AUTHORS AND COPYRIGHT
NAME
autopkgtest-virt-unshare - autopkgtest using unshare user namespaces
SYNOPSIS
autopkgtest [...] -- unshare [ options ]
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 .
OPTIONS
-a | --arch ARCHITECTURE
Debian name of the architecture.
-b | --bind OUTSIDE INSIDE
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.
--bootstrapcmd CMD
Set alternative chroot bootstrap command (including command line options).
-p | --prefix PREFIX
Prefix for the temporary unpack directory (passed to mkdtemp ).
-m | --mirror MIRROR
Mirror to use for bootstrap (will be appended to bootstrapcmd).
-r | --release RELEASE
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.
INPUT, OUTPUT AND EXIT STATUS
The behaviour of autopkgtest-virt-unshare is as described by the AutomatedTesting virtualisation regime specification.
EXAMPLES
autopkgtest hello -- unshare -r unstable
SEE ALSO
autopkgtest (1), autopkgtest-chroot (1), /usr/share/doc/autopkgtest/ .
AUTHORS AND COPYRIGHT
This manpage is part of autopkgtest, a tool for testing Debian binary packages. autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others.
See /usr/share/doc/autopkgtest/CREDITS for the list of contributors and full copying conditions.