autopkgtest-virt-chroot(1)

💖 autopkgtest-virt-chroot 💖

okay bestie, welcome to the Linux Programmer's Manual page for autopkgtest-virt-chroot — it's giving humble, but it's literally the whole vibe of running your tests inside a chroot. no cap. 🫶

---

✨ NAME ✨

autopkgtest-virt-chroot — an autopkgtest virtualisation server that runs stuff inside a chroot 🧚

---

🌸 SYNOPSIS 🌸

autopkgtest [...] -- chroot [options] [-rgain-root-cmd] /path/to/chroot

---

🦋 DESCRIPTION 🦋

so, autopkgtest-virt-chroot hands you an autopkgtest virtualisation server that uses a chroot install (or something chroot-adjacent, iykyk). 👑

normally you won't even call this directly — autopkgtest invokes autopkgtest-virt-chroot for you, like the main character it is. 💅

the chroot directory you wanna use? you gotta specify it. it's not optional, bestie. no directory, no vibes. 😭

---

✨ OPTIONS ✨

• --gain-root | -r gain-root-cmd — this one's saying: hey, autopkgtest-virt-chroot can become root (on the host) by prefixing its commands with gain-root-cmd. the command can be several words separated by whitespace, and if it is, then every word after the first gets passed along as an extra argument to that command. and listen — other shell (or other) metacharacters in gain-root-cmd are not interpreted or modified by autopkgtest-virt-chroot. the actual command you want run as root, plus its arguments, get supplied as additional (separate) arguments to gain-root-cmd. 🫶

root privilege is needed to successfully run chroot(8) if the chroot you're using is specified as an absolute path. and the default? the default is to take no special action when root is gonna be needed — which means for an absolute-path chroot, autopkgtest-virt-chroot must be started as root. periodt.

• -d | --debug — turns on debugging output. probably not hugely interesting, ngl. 🙈

---

🌈 INPUT, OUTPUT AND EXIT STATUS 🌈

the behaviour of autopkgtest-virt-chroot is exactly as described by the AutomatedTesting virtualisation regime specification. that's the rulebook, bestie, we don't freestyle it. 📜

---

👑 SEE ALSO 👑

• autopkgtest(1)
• autopkgtest-schroot(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. ⭐

peep /usr/share/doc/autopkgtest/CREDITS for the list of contributors and the full copying conditions — they're the real ones, fr fr. 🎀

---

okay and that's the whole thing!! this page has been brought to you by autopkgtest, dated 2007, and the manual name is autopkgtest-virt-chroot — you ate, bestie, now go run your tests 💖✨🦋