.TH IPTABLES-XML 1 "" "iptables 1.8.11" "iptables 1.8.11"
.\"
.\" Man page written by Sam Liddicott <azez@ufomechanic.net>
.\" It is based on the iptables-save man page.
.\"
.\"	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., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\"
.SH "نام (NAME)"
iptables-xml \- تبدیل خروجی iptables-save به فرمت XML
.SH "خلاصه دستور (SYNOPSIS)"
\fBiptables\-xml\fP [\fB\-c\fP] [\fB\-v\fP]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.B iptables\-xml
برای تبدیل خروجی
.B iptables\-save
به یک قالب XML با قابلیت دستکاری آسان در خروجی استاندارد (STDOUT) استفاده می‌شود. برای نوشتن در یک فایل، از تغییر مسیر ورودی/خروجی (I/O redirection) پوسته استفاده کنید.
.TP
\fB\-c\fR, \fB\-\-combine\fR
قوانین متوالی با تطابق‌های یکسان اما هدف‌های متفاوت را با یکدیگر ترکیب می‌کند.
.B iptables
در حال حاضر از بیش از یک هدف برای هر تطابق پشتیبانی نمی‌کند، بنابراین این گزینه با جمع‌آوری هدف‌ها از قوانین متوالی
.B iptables
در یک برچسب اقدام (action tag)، این رفتار را شبیه‌سازی می‌کند؛ اما تنها در صورتی که تطابق‌های قوانین کاملاً یکسان باشند. اقدامات پایانی مانند
.BR RETURN ،
.BR DROP ،
.B ACCEPT
و
.B QUEUE
با هدف‌های پس از خود ترکیب نمی‌شوند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
توضیحات (کامنت‌های) XML شامل خطی از iptables که XML از آن برگرفته شده است را در خروجی درج می‌کند.
.PP
دستور
.B iptables\-xml
تبدیلی ساختاریافته و مکانیکی را به یک قالب بسیار گویای XML انجام می‌دهد؛ تنها ملاحظات معنایی برای هدف‌های
.B \-g
و
.B \-j
به منظور تفکیک بین
.BR <call> ،
.B <goto>
و
.B <name\-of\-target>
لحاظ شده است، زیرا توانایی تشخیص تفاوت بین هدفی مانند
.B SNAT
و یک زنجیره دیگر، به اسکریپت‌های پردازش XML کمک می‌کند.
.PP
نمونه‌ای از خروجی به شرح زیر است:
.PP
.nf
<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>
.fi
.PP
تبدیل از فرمت XML به فرمت
.B iptables\-save
را می‌توان با استفاده از اسکریپت
.B iptables.xslt
و ابزار
.BR xsltproc ،
یا یک برنامه سفارشی با استفاده از
.B libxsltproc
یا موارد مشابه، به این صورت انجام داد:
.PP
.nf
xsltproc iptables.xslt my-iptables.xml | iptables-restore
.fi
.SH "اشکالات (BUGS)"
تا زمان انتشار نسخه iptables-1.3.7 هیچ اشکال شناخته‌شده‌ای وجود ندارد.
.SH "نویسندگان (AUTHORS)"
Sam Liddicott <azez@ufomechanic.net>
.SH "همچنین ببینید (SEE ALSO)"
\fBiptables\-save\fP(8)، \fBiptables\-restore\fP(8)، \fBiptables\fP(8)