Skip to site navigation (Press enter)

[PATCH 01/16] xml: Add , <description> and <metadata> to nwfilter xml schema</span></a></span> </h1> <p class="darkgray font13"> <span class="sender pipe"><a href="/search?l=libvir-list@redhat.com&q=from:%22K+Shiva+Kiran%22" rel="nofollow"><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">K Shiva Kiran</span></span></a></span> <span class="date"><a href="/search?l=libvir-list@redhat.com&q=date:20230903" rel="nofollow">Sun, 03 Sep 2023 08:50:20 -0700</a></span> </p> </div> <div itemprop="articleBody" class="msgBody">  <pre>Signed-off-by: K Shiva Kiran <shiva...@riseup.net> --- docs/formatnwfilter.rst | 31 +++++++++++++++++++++++++++++++ src/conf/schemas/nwfilter.rng | 9 +++++++++ 2 files changed, 40 insertions(+)</pre><pre> diff --git a/docs/formatnwfilter.rst b/docs/formatnwfilter.rst index 434da5b1fd..766d7e85f5 100644 --- a/docs/formatnwfilter.rst +++ b/docs/formatnwfilter.rst @@ -419,6 +419,37 @@ better organized for more efficient processing by the firewall subsystem of the underlying host. Currently the system only supports the chains ``root, ipv4, ipv6, arp and rarp``. +General Metadata + + +:: + + <filter name='clean-traffic' filter='arp'> + <uuid>6ef53069-ba34-94a0-d33d-17751b9b8cb1</uuid> + <title>A short description - title - of the filter</title> + <description>Some human readable description</description> + <metadata> + <app1:foo xmlns:app1="<a rel="nofollow" href="http://app1.org/app1/"">http://app1.org/app1/"</a>;>..</app1:foo> + <app2:bar xmlns:app2="<a rel="nofollow" href="http://app1.org/app2/"">http://app1.org/app2/"</a>;>..</app2:bar> + </metadata> + ... + </filter> + +``title`` + The optional element ``title`` provides space for a short description of the + filter. The title should not contain any newlines. :since:`Since 9.8.0` . +``description`` + The content of the ``description`` element provides a human readable + description of the filter. This data is not used by libvirt in any + way, it can contain any information the user wants. :since:`Since 9.8.0` +``metadata`` + The ``metadata`` node can be used by applications to store custom metadata in + the form of XML nodes/trees. Applications must use custom namespaces on their + XML nodes/trees, with only one top-level element per namespace (if the + application needs structure, they should have sub-elements to their namespace + element). :since:`Since 9.8.0` + + References to other filters ~~~~~~~~~~~ diff --git a/src/conf/schemas/nwfilter.rng b/src/conf/schemas/nwfilter.rng index 262bd551e3..c56bbac732 100644 --- a/src/conf/schemas/nwfilter.rng +++ b/src/conf/schemas/nwfilter.rng @@ -14,6 +14,15 @@ <ref name="UUID"/> </element> </optional> + <optional> + <ref name="title"/> + </optional> + <optional> + <ref name="description"/> + </optional> + <optional> + <ref name="metadata"/> + </optional> <zeroOrMore> <choice> <element name="filterref"> -- 2.42.0 </pre> </div> <div class="msgButtons margintopdouble"> <ul class="overflow"> <li class="msgButtonItems"><a class="button buttonleft " accesskey="p" href="msg239628.html">Previous message</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="c" href="thrd2.html#239626">View by thread</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="i" href="mail3.html#239626">View by date</a></li> <li class="msgButtonItems textalignright"><a class="button buttonright " accesskey="n" href="msg240026.html">Next message</a></li> </ul> </div> <a name="tslice"></a> <div class="tSliceList margintopdouble"> <ul class="icons monospace"> <li class="icons-email"><span class="subject"><a href="msg239628.html">[PATCH 00/16] nwfilter: Add support for user defined me...</a></span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email tSliceCur"><span class="subject">[PATCH 01/16] xml: Add <title>, <descript...</span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg240026.html">Re: [PATCH 01/16] xml: Add <title>, <...</a></span> <span class="sender italic">Michal Prívozník</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg239627.html">[PATCH 02/16] conf: Add parser logic for nwfilter ...</a></span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg240029.html">Re: [PATCH 02/16] conf: Add parser logic for n...</a></span> <span class="sender italic">Michal Prívozník</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg239629.html">[PATCH 04/16] nwfilter: Add error code and message...</a></span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg240027.html">Re: [PATCH 04/16] nwfilter: Add error code and...</a></span> <span class="sender italic">Michal Prívozník</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg239630.html">[PATCH 06/16] nwfilter: Introduce public API to re...</a></span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg240024.html">Re: [PATCH 06/16] nwfilter: Introduce public A...</a></span> <span class="sender italic">Michal Prívozník</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg239631.html">[PATCH 03/16] nwfilter: Add enum to operate on use...</a></span> <span class="sender italic">K Shiva Kiran</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg240028.html">Re: [PATCH 03/16] nwfilter: Add enum to operat...</a></span> <span class="sender italic">Michal Prívozník</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg239632.html">[PATCH 05/16] nwfilter: Introduce public API to mo...</a></span> <span class="sender italic">K Shiva Kiran</span></li> </ul> </ul> </div> <div class="overflow msgActions margintopdouble"> <div class="msgReply" > <h2> Reply via email to </h2> <form method="POST" action="/mailto.php"> <input type="hidden" name="subject" value="[PATCH 01/16] xml: Add <title>, <description> and <metadata> to nwfilter xml schema"> <input type="hidden" name="msgid" value="20230903155034.211476-2-shiva_kr@riseup.net"> <input type="hidden" name="relpath" value="libvir-list@redhat.com/msg239626.html"> <input type="submit" value=" K Shiva Kiran "> </form> </div> </div> </div> <div class="aside" role="complementary"> <div class="logo"> <a href="/"><img src="/logo.png" width=247 height=88 alt="The Mail Archive"></a> </div> <form class="overflow" action="/search" method="get"> <input type="hidden" name="l" value="libvir-list@redhat.com"> <label class="hidden" for="q">Search the site</label> <input class="submittext" type="text" id="q" name="q" placeholder="Search libvir-list"> <input class="submitbutton" name="submit" type="image" src="/submit.png" alt="Submit"> </form> <div class="nav margintop" id="nav" role="navigation"> <ul class="icons font16"> <li class="icons-home"><a href="/">The Mail Archive home</a></li> <li class="icons-list"><a href="/libvir-list@redhat.com/">libvir-list - all messages</a></li> <li class="icons-about"><a href="/libvir-list@redhat.com/info.html">libvir-list - about the list</a></li> <li class="icons-expand"><a href="/search?l=libvir-list@redhat.com&q=subject:%22%5C%5BPATCH+01%5C%2F16%5C%5D+xml%5C%3A+Add+%3Ctitle%3E%2C+%3Cdescription%3E+and+%3Cmetadata%3E+to+nwfilter+xml+schema%22&o=newest&f=1" title="e" id="e">Expand</a></li> <li class="icons-prev"><a href="msg239628.html" title="p">Previous message</a></li> <li class="icons-next"><a href="msg240026.html" title="n">Next message</a></li> </ul> </div> <div class="listlogo margintopdouble"> </div> <div class="margintopdouble"> </div> </div> </div> <div class="footer" role="contentinfo"> <ul> <li><a href="/">The Mail Archive home</a></li> <li><a href="/faq.html#newlist">Add your mailing list</a></li> <li><a href="/faq.html">FAQ</a></li> <li><a href="/faq.html#support">Support</a></li> <li><a href="/faq.html#privacy">Privacy</a></li> <li class="darkgray">20230903155034.211476-2-shiva_kr@riseup.net</li> </ul> </div> </body> </html>