Sys::V...WFilter(3pm)

💅 NAME

ok so bestie, welcome to Sys::Virt::NWFilter — it represents & manages a libvirt virtual network. That's the whole vibe. This is a Perl module (the (3pm) situation, you already know), and it lives in the User Contributed Perl Documentation corner of the manual universe. 🦋

---

✨ DESCRIPTION ✨

Sys::Virt::NWFilter is a module that represents a virtual network managed by the virtual machine monitor. Literally that's it. It's the little handle you get to poke at a network filter with. Give it main character energy, because it is the main character of this page. 👑

---

🌸 METHODS 🌸

okay so here's everything you can actually do with a filter object — the whole toolkit, no cap:

• my $uuid = $filter->get_uuid() — hands you a 16 byte long string containing the raw globally unique identifier (UUID) for the network. Raw. Unfiltered. Iconic. 💖
• my $uuid = $filter->get_uuid_string() — same UUID but printable, bestie 💅 — returns a string representation of the raw UUID, formatted exactly like 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'.
• my $name = $filter->get_name() — returns a string with a locally unique name of the network. Local legend behavior.
• my $xml = $filter->get_xml_description() — returns an XML document containing a complete description of the network's configuration. The whole thing. Not a summary. 🎀
• $filter->undefine() — removes the configuration associated with a network filter that was previously defined with the define_nwfilter method in Sys::Virt. So like, it's the delete button but with consequences, so be sure you meant it. 😭

---

⭐ CONSTANTS ⭐

This section documents constants that are used with various APIs described above. Yes, constants. They're little named values and they matter, don't skip them, iykyk. 🌈

🧚 NWFILTER DEFINE

The following constants can be used to control the behaviour of network filter define operations:

• Sys::Virt::NWFilter::DEFINE_VALIDATE — validate the XML document against the XML schema. That's it. That's the constant. Checks your XML is legit. ✨

---

🫶 AUTHORS

Daniel P. Berrange <berrange@redhat.com> — absolute legend, we stan. 💜

---

🎀 COPYRIGHT

Copyright (C) 2006 Red Hat Copyright (C) 2006-2007 Daniel P. Berrange

---

👑 LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of either of these two situations:

• 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), or
• the Artistic License, as specified in the Perl README file.

Pick one, slay either way. 🌸

---

🌟 SEE ALSO

• Sys::Virt
• Sys::Virt::Error
• "http://libvirt.org"

---

ok that's the whole page, go forth and manage your network filters bestie 🦋✨

and finally, the cute little sign-off: this page is from perl v5.40.2, dated 2026-06-08 💖 periodt.