autopkgtes...rt-unshare(1)

📦
version 6.0 · 5 versions
, in ubuntu stonking

🌈 autopkgtes...rt-unshare(1)

okay bestie, gather round, because we're reading a page straight out of the Linux Programmer's Manual and honestly? it's giving niche-but-iconic. this is autopkgtest-virt-unshare and she's here to do exactly what her name says 🫶

✨ NAME ✨

autopkgtest-virt-unshare — running autopkgtest using unshare user namespaces. that's it, that's the vibe. no cap 💅

🎀 SYNOPSIS 🎀

autopkgtest [...] -- unshare [options]

look at her. short, sweet, all the drama in the --. periodt.

🦋 DESCRIPTION 🦋

so the way this works: autopkgtest-virt-unshare hands you an autopkgtest by grabbing a rootfs tarball and using the unshare command to spin up a chroot as a totally normal user. no root era, we love that for us ✨

by default she goes hunting for tarballs in ~/.cache/sbuild, because why make new ones when you can reuse the ones sbuild already made? recycling is main character energy 🌸 and if she finds no tarball at all? not her being dramatic, she literally tries to create one on the fly using mmdebstrap. resourceful queen 👑

okay real talk though, one requirement: autopkgtest-virt-unshare needs the unshare(1) executable from util-linux version 2.38 or later. yes, that specific. for distro versions where that's just not available system-wide — looking at you Debian 11, Ubuntu 22.04, and all the older releases — it is sufficient to have a locally-installed copy of the unshare executable chilling in a directory that's prepended to the PATH. little hack, works perfectly, iykyk 💅

and normally? normally you're not even calling this yourself. autopkgtest-virt-unshare gets invoked by autopkgtest. she's a supporting character who absolutely ate 🔥

💖 OPTIONS 💖

  • -a | --arch ARCHITECTURE — the Debian name of the architecture. just tell her which one 🎀
  • -b | --bind OUTSIDE INSIDE — bind mount a file or directory from the outside to a mountpoint inside. OUTSIDE has to be an existing file or directory in the local filesystem, fr fr, she will check. INSIDE needs to be an absolute path in the new chroot, and if it doesn't exist yet? she creates it for you. so generous 🫶
  • --bootstrapcmd CMD — set an alternative chroot bootstrap command, command line options included. go wild.
  • -p | --prefix PREFIX — prefix for the temporary unpack directory. this one gets passed to mkdtemp. cute little detail 💜
  • -m | --mirror MIRROR — the mirror to use for bootstrap. heads up: it will be appended to bootstrapcmd. she's adding it, not replacing anything 🌈
  • -r | --release RELEASE — the distribution to use. mnemonic time bestie: the r is the first letter in "release". iconic memory device, lowkey 💀
  • -t | --tarball /path/to/tarball — path to a rootfs tarball. give her the goods ⭐
  • -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, so if you don't care, just let her cook 👑
  • -d | --debug — enables debugging output. and honestly? probably not hugely interesting. she said it, not me 🙈 but hey, sometimes you just want the logs

🌸 INPUT, OUTPUT AND EXIT STATUS 🌸

the behaviour of autopkgtest-virt-unshare is exactly as described by the AutomatedTesting virtualisation regime specification. that's the whole thing. she follows the spec, no notes 🎀

⭐ EXAMPLES ⭐

autopkgtest hello -- unshare -r unstable

see? -r for release, unstable for the distro, hello as the thing being tested. slay 💅

🌈 SEE ALSO 🌈

go read those too, bestie, the lore is deep 📚✨

this manpage is part of autopkgtest, a tool for testing Debian binary packages. autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others. iconic lineage honestly 💜

see /usr/share/doc/autopkgtest/CREDITS for the list of contributors and the full copying conditions. credit where credit is due, always 🫶

aaaand that's the page! brought to you by autopkgtest, dated 2022 — same source, same date, all the glamour, zero facts lost. bye bestie, go unshare responsibly 🌸💖🧚

📦 where this page comes from