NAME

       iptables-xml — Convert iptables-save format to XML

SYNOPSIS

       iptables-xml [-c] [-v]

DESCRIPTION

       iptables-xml  is  used to convert the output of iptables-save into an easily manipulatable
       XML format to STDOUT.  Use I/O-redirection provided by your shell to write to a file.

       -c, --combine
              combine consecutive rules with the same matches  but  different  targets.  iptables
              does  not  currently support more than one target per match, so this simulates that
              by collecting the targets from consecutive iptables rules into one action tag,  but
              only  when  the  rule matches are identical. Terminating actions like RETURN, DROP,
              ACCEPT and QUEUE are not combined with subsequent targets.

       -v, --verbose
              Output xml comments containing the iptables line from which the XML is derived

       iptables-xml does a mechanistic conversion to a  very  expressive  xml  format;  the  only
       semantic  considerations are for -g and -j targets in order to discriminate between <call>
       <goto> and <nane-of-target> as it helps xml  processing  scripts  if  they  can  tell  the
       difference between a target like SNAT and another chain.

       Some sample output is:

       <iptables-rules>
         <table name="mangle">
           <chain name="PREROUTING" policy="ACCEPT" packet-count="63436" byte-count="7137573">
             <rule>
              <conditions>
               <match>
                 <p>tcp</p>
               </match>
               <tcp>
                 <sport>8443</sport>
               </tcp>
              </conditions>
              <actions>
               <call>
                 <check_ip/>
               </call>
               <ACCEPT/>
              </actions>
             </rule>
           </chain>
         </table> </iptables-rules>

       Conversion from XML to iptables-save format may be done using the iptables.xslt script and
       xsltproc, or a custom program using libxsltproc or similar; in this fashion:

       xsltproc iptables.xslt my-iptables.xml | iptables-restore

BUGS

       None known as of iptables-1.3.7 release

AUTHOR

       Sam Liddicott <azez@ufomechanic.net>

SEE ALSO

       iptables-save(8), iptables-restore(8), iptables(8)