uvt-simplestreams-libvirt(1)

📦 version 0~git189, in ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💅 uvt-simplestreams-libvirt — bestie edition

okay so you found the uvt-simplestreams-libvirt(1) page from the uvtool manual set, and honestly? it's giving "quietly powerful little tool that nobody told you about." let's get into it 🦋

✨ NAME ✨

uvt-simplestreams-libvirt — manage simplestreams images in libvirt. that's the whole vibe. you're the curator of your own little image gallery, and libvirt is the venue 🎀

🌸 SYNOPSIS 🌸

uvt-simplestreams-libvirt sync [--no-authentication] [--keyring keyring]
                               [--source source] [--path path] [filter ...]

uvt-simplestreams-libvirt query [filter ...]

uvt-simplestreams-libvirt purge

three whole modes, three whole moods, no notes 💖

💫 DESCRIPTION 💫

so basically, uvt-simplestreams-libvirt keeps a libvirt volume storage pool as a local mirror of a subset of images that live on a simplestreams source — think Ubuntu cloud images, iconic behavior, no cap 👑

uvt-simplestreams-libvirt sync updates your local mirror with the latest version of each product available in the simplestreams source. and every single filter you pass? it restricts the set of images the tool can even see. gatekeeping, but make it functional 🔥

lowkey important: if you're syncing images for emulation use — like armhf on an amd64 host — then sync will also prepare the kernel/initrd for later use. in that case, the sync action needs root permission to store the files. so like. bring your sudo, bestie 🙈

uvt-simplestreams-libvirt query queries your local mirror. each filter restricts the output. it's the vibe check for your image pool 💅

uvt-simplestreams-libvirt purge — okay so listen. this one exists only for development and debugging purposes, and it should not normally be used. it purges the entire libvirt volume storage pool and all metadata associated with it, which breaks any existing VMs that use these volumes. full nuclear. 💀 this subcommand may disappear in the future, so don't get attached fr fr

⭐ OPTIONS ⭐

  • --no-authentication — do not authenticate the source. this is useful when you're using a local source, or when you can otherwise trust both the source and your network path to the source. it is insecure in other cases and should not be used. like, genuinely, don't 🚩
  • --keyring keyring — use the gpg(1) keyring to authenticate the source. default: /usr/share/keyrings/ubuntu-cloudimage-keyring.gpg. that default is your bestie, she shows up for you every time 🫶
  • --source source — use the source URL as the simplestreams source of product images to sync. point her somewhere, she'll go 🌈
  • --path path — pass path to the simplestreams library. handing it straight over, no questions asked ✨

🧚 EXAMPLES 🧚

# Update uvtool's libvirt volume storage pool with all
# current amd64 images.
uvt-simplestreams-libvirt sync arch=amd64

# Update uvtool's libvirt volume storage pool with the
# latest amd64 Precise image
uvt-simplestreams-libvirt sync release=precise arch=amd64

# Update uvtool's libvirt volume storage pool with the
# latest amd64 (development) trusty image
uvt-simplestreams-libvirt sync \
        --source http://cloud-images.ubuntu.com/daily \
        release=trusty arch=amd64

three examples, three slays. notice the filters just vibe along at the end, no flags needed, they simply are 😌

💜 SEE ALSO 💜

gpg(1), uvt-kvm(1). go read those too, they're the rest of the friend group 💖

and that's the whole page, bestie!! this was uvtool, dated 2014-03-11, and it's still out here doing main character work in your image pool. periodt. 🎀✨👑

📦 where this page comes from