XEN-LIST-IMAGES(8)

📦
version 4.9.2 · 4 versions
, in debian bookworm, ubuntu noble

💖 NAME 💖

xen-list-images — ok so basically it's the girl whose whole job is listing every Xen image you've created and configured 💅 (and yes bestie, the man page is section 8, we're in sysadmin territory now ✨)

🌸 SYNOPSIS 🌸

xen-list-image [options]

Filename Options:
 --extension  Specify the file extension to use. An empty extension is equal
              to any extension.

Help Options:
 --help     Show this scripts help information.
 --manual   Read this scripts manual.
 --version  Show the version number and exit.

Testing options:
 --test     Specify an alternate Xen configuration directory.
not me pointing out that the command in the synopsis is xen-list-image with no trailing s 💀 that's exactly how it's written, so I'm writing it exactly like that. no cap.

✨ OPTIONS ✨

  • --help — shows you the script's help info 🫶 the "wait what do I do" button.
  • --manual — reads you the manual 📖 it's giving "let me pull up the docs real quick".
  • --test — this flag makes the script load the Xen config files from a different directory than the default of /etc/xen 🧚 super handy for testing, lowkey iconic.
  • --version — prints the version number and then dips out 👋 exit stage left.

🦋 DESCRIPTION 🦋

So xen-list-images is a simple little script that displays all the Xen images you've created. that's it. that's the whole vibe 💖

How does it do it? It iterates over every single file matching the pattern /etc/xen/*.cfg — which is literally what the xen-create-image script would create in the first place. so it's just going "hey, what did we make?" 🌈

For each instance that's been created, it shows you the name, and then either the IP address that's configured, or "DHCP" to denote a dynamic host ✨ (because some of these babies get their address handed to them, and we respect that).

😭 TODO 😭

ngl, this part is still on the vision board:

It should be possible to determine the disk(s) used by the images, and then display their sizes. 👑 someday bestie, someday.

👑 AUTHORS 👑

💜 LICENSE 💜

Copyright (c) 2005-2009 by Steve Kemp, (c) 2010-2013 by The Xen-Tools Development Team. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license. 🎀

and that's the whole page bestie 🫶 this was version 4.9.2, dated 2023-02-06, straight from the Perl Programmers Reference Guide — xen-list-images(8), slay, periodt 💅✨

📦 where this page comes from