.\" Process this file with
.\" groff -man -Tascii iptstate.8
.\"
.TH IPTSTATE 8 "JUNE 2012" "" ""
.\"
.\" Man page written by Phil Dibowitz <phil AT ipom DOT com>
.\"
.\" IPTState is copyright by Phil Dibowitz. Please see the README and LICENSE.
.\"
.SH "نام (NAME)"
.B iptstate
\- نمایش شبیه به top از ورودی‌های جدول وضعیت IP Tables

.SH "خلاصه دستور (SYNOPSIS)"
.B iptstate
[\fIگزینه‌ها\fR]

.SH "توضیحات (DESCRIPTION)"
.B iptstate
اطلاعات نگه‌داری‌شده در جدول وضعیت IP Tables را به‌صورت بلادرنگ در قالبی شبیه به top نمایش می‌دهد.
خروجی می‌تواند بر اساس هر ستونی مرتب شود، یا ترتیب مرتب‌سازی هر ستون معکوس گردد. کاربران می‌توانند حالتی را انتخاب کنند که خروجی فقط یک بار چاپ شود و برنامه خارج شود، به‌جای اینکه سیستم پایش پیوسته شبیه به top اجرا شود. نرخ به‌روزرسانی قابل تنظیم است، آدرس‌های IP می‌توانند به نام‌های میزبان تفکیک شوند، خروجی قابل قالب‌بندی است، نمایش می‌تواند پالایش (فیلتر) شود، و تفکیک رنگی بر اساس پروتکل از جمله قابلیت‌های پرتعداد این ابزار است.

.SH "گزینه‌های خط فرمان (COMMAND\-LINE OPTIONS)"
.TP
.B \-c, \-\-no\-color
تغییر وضعیت رنگ‌بندی بر اساس پروتکل
.TP
.B \-C, \-\-counters
تغییر وضعیت نمایش شمارنده‌های بایت‌ها/بسته‌ها
.TP
.B \-d, \-\-dst\-filter \fIIP[/NETMASK]\fR
فقط وضعیت‌هایی را نشان می‌دهد که مقصد آن‌ها
\fIIP\fR
مشخص‌شده و با
\fINETMASK\fR
اختیاری باشد.
.br
توجه داشته باشید که این مقدار باید یک IP باشد؛ تطبیق بر اساس نام میزبان هنوز پشتیبانی نمی‌شود.
.TP
.B \-D, \-\-dstpt\-filter \fIport\fR
فقط وضعیت‌هایی را نشان می‌دهد که درگاه مقصد آن‌ها
\fIport\fR
باشد.
.TP
.B \-h, \-\-help
نمایش پیام راهنما
.TP
.B \-i, \-\-invert\-filters
معکوس کردن فیلترها برای نمایش نتایج غیرمنطبق
.TP
.B \-l, \-\-lookup
نمایش نام‌های میزبان به‌جای نشانی‌های IP. فعال کردن این گزینه همچنین
.B \-L
را برای جلوگیری از افزایش فزاینده تعداد درخواست‌های DNS فعال می‌کند.
.TP
.B \-m, \-\-mark\-truncated
علامت‌گذاری نام‌های میزبان کوتاه شده با علامت «+»
.TP
.B \-o, \-\-no\-dynamic
تغییر وضعیت قالب‌بندی پویا
.TP
.B \-L, \-\-no\-dns
نادیده گرفتن وضعیت‌های مربوط به تفکیک نام خروجی DNS
.TP
.B \-f, \-\-no\-loopback
فیلتر کردن وضعیت‌ها روی رابط loopback
.TP
.B \-p, \-\-no\-scroll
عدم پیمایش (عدم استفاده از «پد»). برای اطلاعات بیشتر بخش
\fBپیمایش و پدها (SCROLLING AND PADS)\fR
را ببینید.
.TP
.B \-r, \-\-reverse
معکوس کردن ترتیب مرتب‌سازی
.TP
.B \-R, \-\-rate \fIseconds\fR
نرخ به‌روزرسانی، همراه با مقدار زمان به
\fIثانیه\fR.
توجه داشته باشید که این گزینه برای حالت statetop است و در حالت اجرای تکی
.RB ( \-\-single )
کاربردی ندارد.
.TP
.B \-1, \-\-single
اجرای تکی (بدون curses)
.TP
.B \-b, \-\-sort \fIcolumn\fR
ستونی را که مرتب‌سازی بر اساس آن انجام می‌شود مشخص می‌کند. گزینه‌ها:
.br
.B "	S"
درگاه مبدأ (Source Port)
.br
.B "	d"
نشانی IP (یا نام) مقصد
.br
.B "	D"
درگاه مقصد (Destination Port)
.br
.B "	p"
پروتکل (Protocol)
.br
.B "	s"
وضعیت (State)
.br
.B "	t"
مدت زمان حیات (TTL)
.br
.B "	b"
بایت‌ها (Bytes)
.br
.B "	P"
بسته‌ها (Packets)
.br
برای مرتب‌سازی بر اساس نشانی IP (یا نام) مبدأ، از
.B \-b
استفاده نکنید. مرتب‌سازی بر اساس بایت‌ها/بسته‌ها فقط برای هسته‌هایی در دسترس است که از آن پشتیبانی کنند، و تنها زمانی که با libnetfilter_conntrack کامپایل شده باشد (حالت پیش‌فرض).
.TP
.B \-s, \-\-src\-filter \fIIP[/NETMASK]\fR
فقط وضعیت‌هایی را نشان می‌دهد که مبدأ آن‌ها
\fIIP\fR
مشخص‌شده و با
\fINETMASK\fR
اختیاری باشد.
.br
توجه داشته باشید که این مقدار باید یک IP باشد؛ تطبیق بر اساس نام میزبان هنوز پشتیبانی نمی‌شود.
.TP
.B \-S, \-\-srcpt\-filter \fIport\fR
فقط وضعیت‌هایی را نشان می‌دهد که درگاه مبدأ آن‌ها
\fIport\fR
باشد.
.TP
.B \-t, \-\-totals
تغییر وضعیت نمایش مجموع کل

.SH "گزینه‌های تعاملی (INTERACTIVE OPTIONS)"
از نسخه ۲.۰، تمامی گزینه‌های خط فرمان به‌صورت تعاملی با استفاده از همان کلید مربوط به گزینه کوتاه در دسترس هستند. برای مثال،
.B \-\-sort
همان
.B \-b
است، بنابراین در حین اجرای
.BR iptstate ،
فشردن کلید
.B b
مرتب‌سازی را به ستون بعدی تغییر می‌دهد. به‌طور مشابه،
.B t
نمایش مجموع‌ها را تغییر وضعیت می‌دهد و به همین ترتیب.
.PP
همچنین گزینه‌های تعاملی دیگری نیز وجود دارند:
.B B
\- تغییر مرتب‌سازی به ستون قبلی (برعکس
.BR b )؛
.B q
\- خروج؛ و
.B x
\- حذف وضعیت مشخص‌شده فعلی از جدول conntrack مربوط به netfilter.
.PP
علاوه بر این، کلیدهای زیر برای پیمایش درون
.B iptstate
به‌کار می‌روند:
.TP
\fBUp\fR یا \fBj\fR \- حرکت یک خط به بالا
.TP
\fBDown\fR یا \fBk\fR \- حرکت یک خط به پایین
.TP
\fBLeft\fR یا \fBh\fR \- حرکت یک ستون به چپ
.TP
\fBRight\fR یا \fBl\fR \- حرکت یک ستون به راست
.TP
\fBPageUp\fR یا \fB^u\fR \- حرکت یک صفحه به بالا
.TP
\fBPageDown\fR یا \fB^d\fR \- حرکت یک صفحه به پایین
.TP
\fBHome\fR \- رفتن به ابتدا
.TP
\fBEnd\fR \- رفتن به انتها
.PP
در بسیاری از موارد،
.B iptstate
برای تغییر دادن مقادیر باید از شما ورودی بخواهد. برای مثال، اگر بخواهید فیلتر IP مبدأ را تنظیم کرده یا تغییر دهید، با فشردن
.BR s ،
برنامه
.B iptstate
یک کادر ورودی در بالای پنجره باز می‌کند تا بپرسد می‌خواهید آن را روی چه مقداری تنظیم کنید.
.PP
توجه داشته باشید که همانند بسیاری از برنامه‌های یونیکس، کلید ترکیبی
.B ctrl\-G
به
.B iptstate
می‌گوید «صرف‌نظر کن» \- کادر ورودی برداشته می‌شود و فشرده شدن کلید
.B s
نادیده گرفته می‌شود.
.PP
در بیشتر موارد، یک پاسخ خالی به معنای «پاک کردن» است \- برای مثال، پاک کردن فیلتر IP مبدأ.
.PP
در هر زمان از اجرای
.BR iptstate ،
می‌توانید با فشردن
.B h
به بخش
\fBراهنمای تعاملی (interactive help)\fR
بروید که تمام تنظیمات فعلی را نمایش داده و فهرستی از تمام دستورات تعاملی موجود را در اختیارتان می‌گذارد.
.PP
در حین اجرا، کلید
.B space
بلافاصله صفحه را به‌روزرسانی می‌کند.
.B iptstate
باید تغییر اندازه پنجره را به‌درستی مدیریت کند، اما اگر چنین نشد، می‌توانید با زدن
.B ctrl\-L
برنامه را وادار کنید که صفحه را مجدداً محاسبه کرده و بازطراحی کند.
.PP
توجه داشته باشید که فشردن
.B l
برای فعال‌سازی تفکیک نام میزبان در حالت تعاملی، گزینه
.B L
را نیز فعال خواهد کرد تا تمام درخواست‌های DNS را رد کند (برای جلوگیری از افزایش بی‌پایان تعداد درخواست‌های DNS).

.SH "پیمایش و پدها (SCROLLING AND PADS)"
تقریباً برای هیچ کاربری دلیلی برای خاموش کردن پیمایش وجود ندارد. قابلیت خاموش کردن این ویژگی \- و به‌ویژه امکان تغییر وضعیت آن به‌صورت تعاملی \- بیشتر برای کامل بودن تئوری برنامه ارائه شده است تا هر دلیل کاربردی دیگر.
.TP
با این حال، جزئیات به این شرح است: به‌طور معمول در برنامه‌های curses شما یک «پنجره» (window) ایجاد می‌کنید. پنجره‌ها پیمایش نمی‌شوند. اندازه آن‌ها در بیشترین حالت به اندازه ترمینال شما است. پنجره‌ها قابلیت بافرسازی دوگانه (double-buffering) را ارائه می‌دهند تا بازخوانی و به‌روزرسانی صفحه تا جای ممکن سریع و روان باشد. با این حال، برای امکان‌پذیر شدن پیمایش، باید به‌جای پنجره‌ها از «پدها» (pads) استفاده شود. پدها می‌توانند بزرگ‌تر از ترمینال فعلی باشند. سپس تمام داده‌های لازم در پد نوشته می‌شوند، و «پیمایش» صرفاً به نمایش بخش مناسبی از آن پد روی صفحه تبدیل می‌شود.
.TP
با این حال، پدها قابلیت بافرسازی دوگانه را که پنجره‌ها دارند، دارا نیستند. بنابراین، _ممکن_ است مواردی وجود داشته باشد که برای کاربری در دستگاهی بسیار نامتعارف، فعال بودن پیمایش باعث بازخوانی ضعیف یا کندی شود. هرچند با توجه به ماهیت شیوه استفاده
.B iptstate
از صفحه، این احتمال بسیار بعید به نظر می‌رسد. علاوه بر این، روش پیمایش حافظه کمی بیشتری مصرف می‌کند. با این حال،
.B iptstate
برنامه پرمصرفی از نظر حافظه نیست، بنابراین این موضوع حتی در سیستم‌های با حافظه اندک نیز نباید مشکلی ایجاد کند.
.TP
با این همه، اگر این ویژگی روی سیستم شما تأثیر منفی دارد، گزینه غیرفعال کردن آن در دسترس است.

.SH "وضعیت خروج (EXIT STATUS)"
هر مقداری غیر از ۰ نشان‌دهنده خطا است. فهرستی از وضعیت‌های خروج فعلی در زیر آورده شده است:
.TP
.B 0
موفقیت‌آمیز
.TP
.B 1
آرگومان‌های نامعتبر در خط فرمان
.TP
.B 2
خطا در برقراری ارتباط با زیرسیستم netfilter
.TP
.B 3
عرض ترمینال بیش از حد کم است

.SH "اشکالات (BUGS)"
فیلتر کردن بر اساس نام‌های تفکیک‌شده پشتیبانی نمی‌شود. پشتیبانی از IPv6 تازه اضافه شده است و قالب‌بندی پویا هنوز آدرس‌های IPv6 را همیشه به همان خوبی که انتظار می‌رود مدیریت نمی‌کند.

.SH "گزارش اشکالات (BUG REPORTS)"
تمامی اشکالات باید به Phil Dibowitz <phil AT ipom DOT com> گزارش شوند. لطفاً برای اطلاعات بیشتر درباره گزارش اشکالات، فایل‌های
.B README
و
.B BUGS
را مطالعه کنید. لطفاً پیش از ارسال پیشنهاد قابلیت‌هایی که مایل به افزودنشان هستید، فایل
.B WISHLIST
را بررسی کنید.

.SH "نکات (NOTES)"
.B iptstate
تلاش زیادی می‌کند تا همه‌چیز را به‌صورت خوانا در صفحه جای دهد. با این حال، در برخی موارد ممکن است نام‌های میزبان نیاز به کوتاه شدن داشته باشند (در حالت جستجوی نام). به‌طور مشابه، ممکن است نیاز باشد نشانی‌های IPv6 نیز کوتاه شوند. کوتاه شدن نام‌ها برای مبدأ از سمت راست رخ می‌دهد زیرا شما به احتمال زیاد نام دامنه خود را می‌دانید، و برای مقصد از سمت چپ انجام می‌شود زیرا دانستن اینکه کاربران شما به «.mail.a» متصل هستند کمک چندانی نمی‌کند. با این حال، برای نشانی‌ها این موضوع برعکس است.
.PP
.B iptstate
تغییر اندازه پنجره را در صفحه
\fBراهنمای تعاملی (interactive help)\fR
به‌طور خودکار مدیریت نمی‌کند. اگر اندازه پنجره را در این صفحه تغییر دهید، باید به پنجره اصلی بازگردید، کلید
.B ctrl\-L
را برای محاسبه مجدد و رسم دوباره صفحه فشار دهید و سپس در صورت تمایل به
\fBراهنمای تعاملی\fR
بازگردید.
.PP
.B iptstate
در حال حاضر از libnetfilter_conntrack برای دسترسی به جدول وضعیت اتصالات netfilter استفاده می‌کند. با این وجود، نسخه‌های قدیمی‌تر از مسیر /proc/net/ip_conntrack داده‌ها را می‌خواندند، و نسخه فعلی را نیز همچنان می‌توان برای انجام این کار کامپایل کرد. این روش منسوخ‌شده می‌تواند در سیستم‌های SMP مستعد شرایط رقابت (race condition) باشد و عملکرد را در فایروال‌های تحت بار بسیار سنگین کاهش دهد. باید از این روش منسوخ اجتناب شود \- پشتیبانی از آن در نسخه‌های آینده حذف خواهد شد.

.SH "همچنین ببینید (SEE ALSO)"
.BR iptables (8)

.SH "نویسندگان (AUTHORS)"
.B iptstate
توسط Phil Dibowitz <phil AT ipom DOT com> نوشته شده است.
.br
http://www.phildev.net/iptstate