.TH etherape 1 "صفحه راهنمای EtherApe" ""
.SH "نام (NAME)"
etherape \- مرورگر گرافیکی ترافیک شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.B etherape
[
.B \-d
] [
.B \-f
\fIفیلتر\fR ] [
.B \-\-final\-export
\fIفایل_خروجی\fR ] [
.B \-\-glade\-file
\fIفایل_واسط\fR ] [
.B \-i
\fIرابط_شبکه\fR ] [
.B \-l
\fIحداکثر_گره‌ها\fR ] [
.B \-m
\fIحالت_کاری\fR ] [
.B \-\-max\-delay
\fIتاخیر\fR ] [
.B \-\-min\-delay
\fIتاخیر\fR ] [
.B \-n
] [
.B \-P
\fIفایل_ستون‌ها\fR
] [
.B \-q
] [
.B \-r
\fIفایل_ورودی\fR ] [
.B \-s
] [
.B \-\-signal\-export
\fIفایل_خروجی\fR ] [
.B \-Z
\fIکاربر\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
.B EtherApe
یک مرورگر ترافیک شبکه است که فعالیت‌های شبکه را به صورت گرافیکی نمایش می‌دهد. این برنامه از کتابخانه‌های گنوم (GNOME) به عنوان رابط کاربری و از libpcap به عنوان کتابخانه ضبط و فیلتر کردن بسته‌ها استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.PP
این گزینه‌ها را می‌توان به دستور ارائه داد:
.TP
.BR "\-d, \-\-diagram\-only"
عدم نمایش هرگونه متن شناسایی گره‌ها.
.TP
.BR "\-f, \-\-filter " "<\fIفیلتر ضبط\fR>"
تنظیم فیلتر ضبط بسته‌ها (فیلتر pcap).
.TP
.BR "\-\-final\-export " "<\fIنام فایل خروجی\fR>"
هنگام بازپخش، خروجی داده‌ها در انتهای پخش در فایل مشخص‌شده ذخیره می‌شود.
.TP
.BR "\-\-glade\-file " "<\fIنام فایل\fR>"
بارگذاری تعاریف رابط کاربری از فایل مشخص‌شده GtkBuilder به جای فایل پیش‌فرض.
.TP
.BR "\-i, \-\-interface " "<\fIنام رابط\fR>"
تنظیم رابط شبکه برای شنود.
.TP
.BR "\-l, \-\-node\-limit " "<\fIتعداد\fR>"
تنظیم حداکثر تعداد گره‌های قابل نمایش.
.TP
.BR "\-m, \-\-mode " "<link|ip|tcp>"
تنظیم حالت عملکرد (پیش‌فرض ip است).
.TP
.BR "\-\-max\-delay " "<\fIتاخیر به میلی‌ثانیه\fR>"
محدود کردن برچسب‌های زمانی به حداکثر تاخیر مشخص‌شده هنگام بازپخش یک فایل ضبط‌شده.
.TP
.BR "\-\-min\-delay " "<\fIتاخیر به میلی‌ثانیه\fR>"
تعیین حداقل تاخیر میان بسته‌ها هنگام بازپخش یک فایل ضبط‌شده.
.TP
.BR "\-n, \-\-numeric"
عدم تبدیل آدرس‌ها به نام؛ غیرفعال‌سازی تفکیک نام (DNS resolution).
.TP
.BR "\-\-no\-display"
محاسبه آمار، اما بدون نمایش گره‌ها. در صورت بازپخش، در انتها خارج می‌شود. این روش سریعی برای محاسبه آمار، استخراج داده‌ها یا تولید گزارش است.
.TP
.BR "\-P, \-\-position " "<\fIفایل حاوی فهرست گره‌ها و ستون‌ها\fR>"
فعال‌سازی موقعیت‌دهی ستونی با استفاده از فایل مشخص‌شده. گره‌ها به صورت دستی با استفاده از محتوای این فایل در ستون‌های مجازی چیده می‌شوند. بخش
.B "موقعیت‌دهی ستونی (COLUMN POSITIONING)"
را ببینید.
.TP
.BR "\-q, \-\-quiet"
غیرفعال کردن پیام‌های اطلاع‌رسانی.
.TP
.BR "\-r, \-\-replay\-file " "<\fIنام فایل\fR>"
تنظیم فایل ورودی برای بازپخش.
.TP
.BR "\-s"
عدم جابه‌جایی گره‌ها در صفحه. این گزینه با تغییر گره‌ها چندان خوب کار نمی‌کند، بنابراین در نسخه‌های آینده حذف خواهد شد.
.B
منسوخ شده است (Deprecated).
.TP
.BR "\-\-signal\-export " "<\fIنام فایل خروجی\fR>"
در صورت تعیین، پردازش سیگنال USR1 فعال می‌شود. با دریافت USR1، برنامه EtherApe وضعیت خود را در فایل مشخص‌شده با فرمت XML یا JSON ذخیره می‌کند. فرمت فایل خروجی در پنجره تنظیمات (Preferences) انتخاب می‌شود.

هشدار! فایل بدون درخواست تایید بازنویسی خواهد شد!
.TP
.BR "\-Z, \-\-relinquish\-privileges " "<\fIکاربر\fR>"
اجرای تمامی بخش‌ها به جز عملیات دارای امتیاز ضبط بسته‌ها تحت شناسه کاربری (UID) و شناسه گروهی (GID) کاربر مشخص‌شده.
.TP
.BR "\-?, \-\-help"
نمایش پیام راهنمای خلاصه.
.SH "موقعیت‌دهی ستونی (COLUMN POSITIONING)"
.PP
با گزینه
.B \-P|\-\-position
برنامه EtherApe فایلی را می‌خواند که موقعیت برخی گره‌ها را مشخص می‌کند. فایل ورودی این ساختار را دارد:
.PP
.nf
  node.mydomain.com        1
  router1.mydomain.com     2
  router2.mydomain.com     2
  172.16.2.[0-9]*          1
  .*.mydomain.com          1
  ff02:.*                  2
  fe80:.*                  1
.fi
.PP
ستون اول یک عبارت منظم (Regex) از نام کامل دامنه (FQDN) یا آدرس IP است.
.PP
ستون دوم عددی است که «ستون» قرارگیری گره در صفحه نمایش را مشخص می‌کند که ستون ۱ در دورترین نقطه سمت چپ قرار دارد. تا ۱۰۰۰ ستون مجاز است.
.PP
به جای چیدمان دایره‌ای، گره‌ها در ستون‌ها نمایش داده می‌شوند. این قابلیت برای چیدمان گره‌ها بسیار مفید است تا بتوانید گره‌های «درونی» شبکه خود را در سمت چپ و گره‌های اینترنت عمومی (هر آنچه در فایل کانفیگ تعیین نشده) را در سمت راست مشاهده کنید.
.PP
فایل ورودی نمونه بالا باعث ایجاد ۳ ستون نمایشی می‌شود. گره‌های دارای FQDN شامل mydomain.com، گره‌های موجود در زیرشبکه 172.16.2.0/24 و آدرس‌های محلی پیوند (link-local) در IPv6 در ستون سمت چپ قرار می‌گیرند. ۲ «روتر» و چندپخشی (multicast) در IPv6 در ستون وسط قرار گرفته و سایر موارد در ستون سمت راست نمایش داده می‌شوند.
.PP
مکان ستون‌ها با اولین تطابق هنگام جستجو از بالای ورودی تعیین می‌شود. عبارت‌های منظم دارای هم‌پوشانی را می‌توان استفاده کرد، با این درک که اولین تطابق مکان را تعیین خواهد کرد. گسترده‌ترین عبارت‌های منظم باید در نزدیکی انتهای مشخصات موقعیت قرار گیرند.
.SH "سیگنال‌ها (SIGNALS)"
.TP
.BR "USR1"
با دریافت سیگنال USR1، و در صورت فعال بودن با \-\-signal\-export، برنامه EtherApe وضعیت خود را در فایل XML یا JSON انتخاب‌شده ذخیره می‌کند.

هشدار! فایل بدون درخواست تایید بازنویسی خواهد شد!
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.TP
.BR "APE_DEBUG=" "normal|info|debug"
کنترل میزان جزئیات خروجی اشکال‌زدایی. اطلاعات اشکال‌زدایی روی خروجی استاندارد چاپ می‌شوند.
.SH "فایل‌ها (FILES)"
برنامه EtherApe در صورت وجود فایل
.I /etc/ethers
از آن برای تبدیل آدرس‌های MAC به نام‌ها و از فایل
.I /etc/services
برای مرتبط کردن شماره پورت‌های TCP/UDP با نام پروتکل‌ها استفاده می‌کند.


.SH "همچنین ببینید (SEE ALSO)"
.PP
صفحه وب EtherApe در
.UR http://etherape.sourceforge.io
.UE

.SH "نویسندگان (AUTHORS)"
Juan Toledo <toledo@users.sourceforge.net>
.PP
Riccardo Ghetta <bchiara@users.sourceforge.net>