virt-index-validate(1)

📦
version 1.57.3 · 15 versions
, in centos-stream 10

💖 virt-index-validate(1) 💖

okay so this is the virt-index-validate man page, part of the Virtualization Support squad — pull up a chair bestie, we're gonna learn how to vibe-check an index file ✨

🌸 NAME 🌸

virt-index-validate — validate a virt-builder index file. that's it. that's the whole job. and she does it flawlessly 💅

🎀 SYNOPSIS 🎀

virt-index-validate index

🦋 DESCRIPTION 🦋

so virt-builder(1) keeps an index file around to store metadata about all the templates it knows how to use. think of it as the contact list of templates, iykyk 💖 and that index file has a very specific format — and virt-index-validate is literally the one who knows how to validate it. main character energy fr fr 👑

ngl, the best part: virt-index-validate can validate either the signed or the unsigned index file (ie. either index or index.asc) 🫶 but heads up — it can only validate a local file, not a URL. no remote vibes allowed, sorry 🙈

✨ OPTIONS ✨

  • --compat-1.24.0 — check for compatibility with virt-builder 1.24.0. (using this option implies --compat-1.24.1, so you don't need to use both — she's got you, one and done 🎀)

in particular:

  • this version of virt-builder could not handle "[...]" (square brackets) in field names (eg. "checksum[sha512]=...").
  • it required detached signatures ("sig=...").
  • --compat-1.24.1 — check for compatibility with virt-builder ≥ 1.24.1.

in particular:

  • this version of virt-builder could not handle "." (period) in field names or "," (comma) in subfield names.
  • it could not handle comments appearing in the file.
  • --help — display help. she's helpful like that 🫶
  • -V, --version — display the version number and exit. slay ⭐

💀 EXIT STATUS 💀

this program returns 0 if the index file validates, or non-zero if there was an error. basically: 0 = ate 💅, non-zero = something went sideways 😭

🌈 SEE ALSO 🌈

virt-builder(1), http://libguestfs.org/.

👑 AUTHOR 👑

Richard W.M. Jones http://people.redhat.com/~rjones/

Copyright (C) 2013 Red Hat Inc.

🧚 LICENSE 🧚

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

🔥 BUGS 🔥

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

when you're reporting a bug, please supply (fr fr, don't skip these 🙏):

  • the version of libguestfs.
  • where you got libguestfs (eg. which Linux distro, compiled from source, etc)
  • describe the bug accurately and give a way to reproduce it.
  • run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
🎀 and that's the whole page bestie! this one ships as part of guestfs-tools-1.57.3, dated 2026-09-16 — go validate something iconic today 💖✨🦋
📦 where this page comes from