.\" etterlog -- تحلیل‌گر گزارش برای فایل‌های لاگ ettercap .\" .\" 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. .\" .\" .de Sp .if n .sp .if t .sp 0.4 .. .TH ETTERLOG "8" "" "ettercap 0.8.4.1" .SH "نام (NAME)" etterlog \- تحلیل‌گر گزارش برای فایل‌های لاگ ettercap .SH "خلاصه دستور (SYNOPSIS)" .B etterlog [\fIOPTIONS\fR] \fIFILE\fR .SH "توضیحات (DESCRIPTION)" ابزار etterlog تحلیل‌گر فایل‌های لاگ ایجادشده توسط ettercap است. این ابزار می‌تواند با هر دو نوع فایل لاگ فشرده‌شده (ایجادشده با \-Lc) یا فشرده‌نشده کار کند. با این ابزار می‌توانید فایل‌های دودویی را مطابق نیاز خود دستکاری کرده و داده‌ها را هر زمان که بخواهید به روش‌های مختلف چاپ کنید (برخلاف سیستم وقایع‌نگاری قبلی که داده‌ها را فقط به یک روش ایستا ذخیره می‌کرد). .br شما قادر خواهید بود ترافیک تنها یک اتصال به انتخاب خود یا تنها یک یا چند میزبان را استخراج کنید، داده‌ها را به صورت هگز، اسکی، باینری و غیره چاپ نمایید... .Sp نکته: تمام پیام‌های غیرضروری در stderr چاپ می‌شوند، بنابراین می‌توانید خروجی etterlog را با دستور زیر ذخیره کنید: .TP \fIetterlog [options] logfile > outfile\fR .Sp بدین ترتیب برای مثال می‌توانید یک فایل باینری را از یک اتصال ftp استخراج کنید، در صورتی که داده‌ها را در حالت باینری، بدون سرایندها و تنها با انتخاب سرور ftp به عنوان مبدأ ارتباط چاپ نمایید. .TP .B "گزینه‌های عمومی (GENERAL OPTIONS)" .TP \fB\-a\fR, \fB\-\-analyze\fR تحلیل یک فایل لاگ و نمایش برخی آمار جالب توجه. .TP \fB\-c\fR, \fB\-\-connections\fR تجزیه فایل لاگ و چاپ یک جدول از اتصالات منحصربه‌فرد (پورت به پورت). این گزینه فقط در فایل‌های لاگ از نوع LOG_PACKET قابل استفاده است. در فایل‌های لاگ LOG_INFO بی‌فایده است. .Sp نکته: می‌توانید با استفاده از دستور زیر به دنبال یک میزبان خاص بگردید: .Sp etterlog \-c logfile.ecp | grep 10.0.0.1 .TP \fB\-f\fR, \fB\-\-filter \fR تنها چاپ بسته‌هایی که از TARGET می‌آیند یا به سمت آن می‌روند. شیوه تعیین TARGET همانند ettercap است. .br پارامتر \fITARGET\fR به شکل \fIMAC/IPs/PORTs\fR است. با فعال بودن پشتیبانی از IPv6، مقدار \fITARGET\fR به شکل \fIMAC/IPs/IPv6/PORTs\fR خواهد بود. حذف یک یا چند بخش از آن معادل تنظیم آن‌ها بر روی ANY (هرکدام) خواهد بود. با بخش‌های IPs و IPv6 به عنوان یک بخش رفتار می‌شود، بنابراین تنها در صورتی بر روی ANY تنظیم می‌شود که هر دوی IPs و IPv6 حذف شده باشند. این کار به نتیجه‌ای می‌انجامد که اکثر کاربران انتظار دارند. .Sp اگر نوع فایل لاگ LOG_INFO باشد، از target برای نمایش میزبان‌هایی استفاده می‌شود که با mac و ip تطابق داشته و پورت(های) مشخص‌شده در آن‌ها باز باشد. برای مثال هدف //80 تنها اطلاعات مربوط به میزبان‌هایی با وب‌سرور در حال اجرا را نمایش می‌دهد. .TP \fB\-r\fR, \fB\-\-reverse\fR معکوس کردن تطابق در انتخاب TARGET. این به معنای not(TARGET) است؛ یعنی همه به جز TARGET انتخاب‌شده. .TP \fB\-t\fR, \fB\-\-proto \fR شنود تنها بسته‌های PROTO (پیش‌فرض TCP + UDP است). این گزینه تنها در حالت "simple" مفید است. اگر ettercap را در حالت تعاملی آغاز کنید، هر دو پروتکل TCP و UDP شنود می‌شوند. .br مقدار PROTO می‌تواند "tcp"، "udp" یا "all" برای هر دو باشد. .TP \fB\-F\fR, \fB\-\-filcon \fR چاپ بسته‌هایی که تنها متعلق به این CONNECTION هستند. .br پارامتر CONNECTION به شکل PROTO:SOURCE:DEST است. پارامترهای SOURCE و DEST به شکل IP:PORT هستند. .Sp مثال: .Sp etterlog \-F TCP:10.0.0.23:3318:198.182.196.56:80 .TP \fB\-s\fR, \fB\-\-only\-source\fR تنها نمایش بسته‌هایی که توسط مبدأ CONNECTION انتخاب‌شده ارسال شده‌اند. این گزینه فقط در ترکیب با گزینه \-F معنا دارد. .Sp نکته: اگر می‌خواهید فایلی را که در یک اتصال HTTP یا FTP منتقل شده ذخیره کنید، می‌توانید از دستور زیر استفاده کنید: .Sp etterlog \-B \-s \-n \-F TCP:10.0.0.1:20:10.0.0.2:35426 logfile.ecp > example.tar.gz .TP \fB\-d\fR, \fB\-\-only\-dest\fR مشابه \-\-only\-source است اما بر روی میزبان مقصد فیلتر می‌کند. .TP \fB\-n\fR, \fB\-\-no\-headers\fR عدم چاپ سرایند هر بسته. این گزینه در صورتی مفید است که بخواهید یک فایل را در قالب باینری (گزینه \-B) ذخیره کنید. بدون سرایندها می‌توانید خروجی را به یک فایل هدایت کرده و جریان اصلی داده را دریافت نمایید. .Sp یادداشت: برچسب زمانی در سرایند به این شکل است: Thu Mar 27 23:03:31 2003 [169396]؛ مقدار داخل قلاب‌ها بر حسب میکروثانیه بیان شده است. .TP \fB\-m\fR, \fB\-\-show\-mac\fR در سرایندها آدرس‌های mac متناظر با آدرس‌های ip را نیز نمایش می‌دهد. .TP \fB\-k\fR, \fB\-\-color\fR اگر در ترکیب با \-F استفاده شود، مبدأ و مقصد اتصال را با رنگ‌های متفاوتی نمایش می‌دهد. اگر با یک فایل LOG_INFO استفاده شود، میزبان‌های شبکه محلی (LAN) را با رنگ سبز، میزبان‌های راه دور (REMOTE) را با رنگ آبی و دروازه‌ها (GATEWAYS) را با رنگ قرمز چاپ می‌کند. .TP \fB\-l\fR, \fB\-\-only\-local\fR هنگام نمایش یک فایل INFO، تنها اطلاعات مربوط به میزبان‌های محلی را نمایش می‌دهد. .TP \fB\-L\fR, \fB\-\-only\-remote\fR هنگام نمایش یک فایل INFO، تنها اطلاعات مربوط به میزبان‌های راه دور را نمایش می‌دهد. .TP .B "گزینه‌های جستجو (SEARCH OPTIONS)" .TP \fB\-e\fR, \fB\-\-regex \fR نمایش تنها بسته‌های منطبق با عبارت منظم . .br اگر این گزینه برای یک فایل لاگ LOG_PACKET استفاده شود، عبارت منظم بر روی محتوای داده (payload) بسته اجرا می‌شود. اگر نوع فایل LOG_INFO باشد، عبارت منظم بر روی تمامی فیلدهای نمایه میزبان (سیستم‌عامل، بنرها، سرویس و کارت شبکه اترنت) اجرا می‌شود. .br یادداشت: عبارت منظم با پرچم REG_ICASE (غیرحساس به حروف بزرگ و کوچک) کامپایل می‌شود. .TP \fB\-u\fR, \fB\-\-user \fR نمایش اطلاعات مربوط به این کاربر. جستجو در میان تمام جفت‌های نام‌کاربری/گذرواژه جمع‌آوری‌شده در تمامی میزبان‌ها انجام می‌شود. .TP \fB\-p\fR, \fB\-\-passwords\fR تنها چاپ اطلاعات حساب‌های کاربری جمع‌آوری‌شده برای هر میزبان. این کار از تولید خروجی حجیم نمایه جلوگیری می‌کند. می‌تواند در ترکیب با گزینه \-u برای فیلتر کردن کاربران استفاده شود. وجود علامت ستاره '*' در جلوی یک حساب نشان‌دهنده تلاش ناموفق برای ورود به سیستم است. .TP \fB\-i\fR, \fB\-\-show\-client\fR نمایش آدرس ip کلاینت هنگام نمایش نام‌های کاربری و گذرواژه‌های جمع‌آوری‌شده. این گزینه زمانی که کنترل‌های دسترسی (ACL) وجود دارند می‌تواند مفید باشد. .TP \fB\-I\fR, \fB\-\-client \fR نمایش گذرواژه‌هایی که تنها از یک خاص می‌آیند. این گزینه برای مشاهده تمام نام‌های کاربری و گذرواژه‌های یک کلاینت کاربرد دارد. .TP .B "گزینه‌های ویرایش (EDITING OPTIONS)" .TP \fB\-C\fR, \fB\-\-concat\fR از این گزینه برای پیوند دادن (الحاق) دو (یا چند) فایل در یک فایل واحد استفاده کنید. این قابلیت زمانی مفید است که فایل‌های لاگ ettercap را از چندین منبع جمع‌آوری کرده‌اید و می‌خواهید یک گزارش یکپارچه داشته باشید. فایل خروجی باید با گزینه \-o مشخص شود و فایل‌های ورودی به عنوان آرگومان‌های معمولی فهرست می‌شوند. .Sp مثال: .br etterlog \-C \-o outfile input1 input2 input3 .TP \fB\-o\fR, \fB\-\-outfile \fR فایل خروجی را برای عملیات الحاق مشخص می‌کند. .TP .B "روش نمایش (VISUALIZATION METHOD)" .TP \fB\-B\fR, \fB\-\-binary\fR چاپ داده‌ها همان‌گونه که هستند، در قالب دودویی. برای استخراج داده‌های باینری در یک فایل مفید است (همان‌طور که در بالا توضیح داده شد). .TP \fB\-X\fR, \fB\-\-hex\fR چاپ بسته‌ها در قالب هگزادسیمال. .Sp مثال: .Sp رشته "HTTP/1.1 304 Not Modified" به صورت زیر درمی‌آید: .Sp 0000: 4854 5450 2f31 2e31 2033 3034 204e 6f74 HTTP/1.1 304 Not .br 0010: 204d 6f64 6966 6965 64 Modified .TP \fB\-A\fR, \fB\-\-ascii\fR تنها چاپ نویسه‌های «قابل چاپ»؛ سایر نویسه‌ها به صورت نقطه '.' نمایش داده می‌شوند. .TP \fB\-T\fR, \fB\-\-text\fR تنها نویسه‌های «قابل چاپ» را چاپ می‌کند و از بقیه صرف‌نظر می‌نماید. .TP \fB\-E\fR, \fB\-\-ebcdic\fR تبدیل متن EBCDIC به ASCII. .TP \fB\-H\fR, \fB\-\-html\fR حذف تمام تگ‌های html از متن. یک تگ هر رشته‌ای است که بین '<' و '>' قرار دارد. .Sp مثال: .Sp This is the title, but the following will not be displayed. .Sp This is the title, but the following will not be displayed. .TP \fB\-U\fR, \fB\-\-utf8 \fR چاپ بسته‌ها در قالب UTF-8. پارامتر کدگذاری مورد استفاده در حین انجام تبدیل را مشخص می‌کند. از دستور `iconv \-\-list` برای دریافت فهرستی از تمامی کدگذاری‌های پشتیبانی‌شده استفاده کنید. .TP \fB\-Z\fR, \fB\-\-zero\fR همیشه رشته خالی چاپ می‌کند؛ یعنی تنها اطلاعات سرایند چاپ شده و هیچ محتوایی از بسته چاپ نخواهد شد. .TP \fB\-x\fR, \fB\-\-xml\fR چاپ اطلاعات میزبان در قالب xml، تا بتوانید آن را با برنامه دلخواه خود پردازش کنید. .Sp فایل DTD مرتبط با خروجی xml در مسیر share/etterlog.dtd قرار دارد. .TP .B "گزینه‌های استاندارد (STANDARD OPTIONS)" .TP \fB\-v\fR, \fB\-\-version\fR نمایش نسخه برنامه و خروج. .TP \fB\-h\fR, \fB\-\-help\fR نمایش صفحه راهنما به همراه خلاصه‌ای کوتاه از گزینه‌های موجود. .SH "مثال‌ها (EXAMPLES)" در اینجا چند مثال از نحوه استفاده از etterlog آورده شده است. .TP .B etterlog \-k \-l dump.eci .Sp نمایش اطلاعات میزبان‌های محلی با رنگ‌های متفاوت. .TP .B etterlog \-X dump.ecp .Sp چاپ بسته‌ها در حالت HEX با سرایندهای کامل. .TP .B etterlog \-c dump.ecp .Sp نمایش فهرست اتصالات ثبت‌شده در فایل. .TP .B etterlog \-Akn \-F TCP:10.0.0.1:13423:213.203.143.52:6666 dump.ecp .Sp نمایش ترافیک IRC مربوط به 10.0.0.1 در حالت ASCII، بدون اطلاعات سرایند و در حالت رنگی. .TP .B etterlog \-H \-t tcp \-f //80 dump.ecp .Sp استخراج تمام ترافیک HTTP و حذف تگ‌های html. .TP .B etterlog \-Z \-r \-f /10.0.0.2/22 dump.ecp .Sp نمایش تنها سرایندهای تمام اتصالات به جز ssh در میزبان 10.0.0.2 .TP .B etterlog \-A \-e 'user' \-f //110 dump.ecp .Sp نمایش تنها بسته‌های POP حاوی عبارت منظم 'user' (غیرحساس به حروف بزرگ و کوچک). .TP .B etterlog \-u root dump.eci .Sp نمایش اطلاعات درباره تمام حساب‌های کاربر 'root'. .TP .B etterlog \-e Apache dump.eci .Sp نمایش اطلاعات درباره تمام میزبان‌های اجراکننده 'Apache'. .TP .B etterlog \-e Linux dump.eci .Sp نمایش اطلاعات درباره تمام میزبان‌های دارای سیستم‌عامل 'Linux'. .TP .B etterlog \-t tcp \-f //110 dump.eci .Sp نمایش اطلاعات درباره تمام میزبان‌هایی که پورت tcp شماره 110 در آن‌ها باز است. .TP .B etterlog \-t udp dump.eci .Sp نمایش اطلاعات درباره تمام میزبان‌هایی که حداقل یک پورت UDP باز دارند. .TP .B etterlog \-B \-s \-n \-F TCP:10.0.0.1:20:10.0.0.2:35426 logfile.ecp > example.tar.gz .Sp استخراج داده‌های ارسال‌شده توسط 10.0.0.1 بر روی پورت داده FTP در قالب دودویی. از آنجا که سرایندها حذف شده‌اند، فایل را به همان صورت اصلی دریافت خواهید کرد. .SH "نویسندگان اصلی (ORIGINAL AUTHORS)" Alberto Ornaghi (ALoR) .br Marco Valleri (NaGA) .SH "مدیران پروژه (PROJECT STEWARDS)" Emilio Escobar (exfil) .br Eric Milam (Brav0Hax) .SH "توسعه‌دهندگان رسمی (OFFICIAL DEVELOPERS)" Mike Ryan (justfalter) .br Gianfranco Costamagna (LocutusOfBorg) .br Antonio Collarino (sniper) .br Ryan Linn .br Jacob Baines .SH "مشارکت‌کنندگان (CONTRIBUTORS)" Dhiru Kholia (kholia) .br Alexander Koeppe (koeppea) .br Martin Bos (PureHate) .br Enrique Sanchez .br Gisle Vanem .br Johannes Bauer .br Daten (Bryan Schneiders) .SH "همچنین ببینید (SEE ALSO)" .BR ettercap (8), .BR etterfilter (8), .BR etter.conf (5), .BR ettercap_curses (8), .BR ettercap_plugins (8), .BR ettercap\-pkexec (8) .LP