.\" Sniffit man page file - Brecht Claerhout
.\" Some fixes by Joao Eriberto Mota Filho
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH SNIFFIT 8

.SH "نام (NAME)"
sniffit \- ابزار پایش و شنود بسته‌های شبکه

.SH "خلاصه دستور (SYNOPSIS)"
.B sniffit  [-xdabvnN] [-P
.I proto
.B ] [-A
.I char
.B ] [-p
.I port
.B ] [(-r|-R)
.I recordfile
.B ] [-l
.I sniflen
.B ] [-L
.I logparam
.B ] [-F
.I snifdevice
.B ] [-D
.I tty
.B ] [-M
.I plugin
.B ] [(-t
.I Target-IP
.B | -s
.I Source-IP
.B ) | (-i|-I) | -c
.I config-file
.B ]

.SH "توضیحات (DESCRIPTION)"
برنامه
.B sniffit
یک شنودکننده بسته (packet sniffer) برای بسته‌های TCP/UDP/ICMP است.
.B sniffit
می‌تواند اطلاعات فنی بسیار دقیقی در مورد این بسته‌ها (مانند SEQ، ACK، TTL، Window، ...) و همچنین محتوای بسته‌ها در قالب‌های گوناگون (هگزادسیمال یا متن ساده، ...) به شما ارائه دهد.
.LP
.B sniffit
به‌طور پیش‌فرض می‌تواند دستگاه‌های اترنت (ethernet) و PPP را مدیریت کند، اما به‌سادگی می‌توان آن را برای استفاده از دستگاه‌های دیگر نیز وادار کرد (برای این موضوع فایل‌های
.B README.FIRST
و
.B sn_config.h
را بخوانید!)
.LP
این شنودکننده را می‌توان به‌راحتی پیکربندی کرد تا بسته‌های ورودی را «فیلتر» کند (تا مطالعه و بررسی نتایج شنود آسان‌تر شود). فایل پیکربندی (نگاه کنید به
.BR sniffit (5)
) به شما امکان می‌دهد در مورد بسته‌هایی که باید پردازش شوند بسیار دقیق باشید.
.LP
همچنین
.B sniffit
دارای یک حالت تعاملی برای پایش فعال است و می‌تواند برای پایش مداوم در سطوح مختلف نیز مورد استفاده قرار گیرد.

.SH "نکته (NOTE)"
این صفحه راهنما به‌عنوان یک کتابچه راهنمای مرجع در نظر گرفته شده است. بنابراین لطفاً ابتدا
.B README.FIRST
را بخوانید و از این صفحه تنها برای درک بهتر یا بررسی سریع نحوه استفاده از
.B sniffit
استفاده کنید.

.SH "گزینه‌ها (OPTIONS)"

.IP -v
نسخه در حال اجرای
.B sniffit
را نمایش می‌دهد و خارج می‌شود
.I "(بر همه گزینه‌ها اولویت دارد)"

.IP "-t Target-IP"
فقط بسته‌های ارسالی به Target-IP (آدرس IP مقصد) را پردازش می‌کند. اگر Target-IP با نماد عددی نقطه‌دار باشد،
استفاده از 'x' به‌عنوان نویسه عام مجاز است (برای نمونه: ‎'\-t 157.193.x'‎، ‎'\-t x'‎ و غیره).
.I "(ناسازگار با: '-s'، '-i'، '-I'، '-c'، '-v'، '-L')"

.IP "-s Source-IP"
مشابه '\-t'، تنها بسته‌های ارسالی از Source-IP (آدرس IP مبدا) را پردازش می‌کند.
.I "(ناسازگار با: '-t'، '-i'، '-I'، '-c'، '-v'، '-L')"

.IP -b
حالت «هر دو» (both)، در کنار '\-s' یا '\-t'، تنها بسته‌های ارسالی از/به آدرس IP مشخص‌شده با '\-s' یا '\-t' را پردازش می‌کند.
.I "(ناسازگار با: '-t'، '-i'، '-I'، '-c'، '-v'، '-L')"

.IP "-c config-file"
استفاده از
.I config-file
(فایل پیکربندی) برای فیلتر کردن بسته‌ها. این به شما امکان می‌دهد روی بسته‌هایی که باید پردازش شوند بسیار دقیق عمل کنید (برای جزئیات قالب فایل به
.BR sniffit (5)
مراجعه کنید).
.I "(ناسازگار با: '-t'، '-s'، '-i'، '-I'، '-v'، '-L')"

.IP -i
راه‌اندازی رابط کاربری ncurses برای پایش فعال («حالت تعاملی»).
(اگر برنامه بدون پشتیبانی از INTERACTIVE کامپایل شده باشد در دسترس نیست؛ نگاه کنید به
.B sn_config.h
و
.B README.FIRST
)
(یکی از گزینه‌های '\-t'، '\-s'، '\-i'، '\-I'، '\-c' الزامی است)
.I "(ناسازگار با: '-t'، '-s'، '-c'، '-v'، '-L')"

.IP -I
مشابه '\-i'، اما اطلاعات بیشتری به شما می‌دهد.
(یکی از گزینه‌های '\-t'، '\-s'، '\-i'، '\-I'، '\-c' الزامی است)
.I "(ناسازگار با: '-t'، '-s'، '-c'، '-v'، '-L')"

.IP "-R <file>"
ضبط تمام ترافیک در
.I <file>
(فایل). سپس می‌توان این فایل را با گزینه '\-r' به Sniffit تحویل داد.
.I "(نیازمند یک پارامتر انتخابی مانند '-c'، '-t'، '-s' است)"
.I "(ناسازگار با: '-i'، '-I'، '-v'، '-L'، '-r')"

.IP "-r <file>"
این گزینه،
.I <file>
ضبط‌شده را به
.B sniffit
ارائه می‌دهد. این گزینه به گزینه '\-F' همراه با دستگاه صحیح نیاز دارد. فرض کنید فایلی را روی ماشینی با 'eth0' ثبت کرده‌اید. هنگام تحویل فایل ثبت‌شده به
.B sniffit
باید '\-F eth0' یا '\-F eth' را به خط فرمان اضافه کنید. نیازی به توضیح چندانی نیست که استفاده از '\-i' یا '\-I' در ترکیب با '\-r' (در حال حاضر) هیچ معنایی ندارد.
.I "(نیازمند '-F'، ناسازگار با '-R'، '-i'، '-I')"

.IP -n
غیرفعال کردن بررسی چکسام (checksum) آی‌پی. این می‌تواند بسته‌های جعلی یا نامعتبر (bogus) را به شما نشان دهد.
(توجه داشته باشید که ARP، RARP و سایر بسته‌های غیر IP نیز نامعتبر نشان داده خواهند شد)
.I "(سازگار با همه گزینه‌ها)"

.IP -N
هیچ‌یک از عملکردهای داخلی Sniffit را انجام ندهد. برای اجرای صرفاً یک افزونه (Plugin) کاربرد دارد.
.I "(سازگار با همه گزینه‌ها)"

.IP -x
چاپ اطلاعات تفصیلی درباره بسته‌های TCP در خروجی استاندارد (stdout) (شامل SEQ، ACK، پرچم‌ها و غیره).
هنگام ردگیری جعل هویت (spoofing)، اتلاف بسته و سایر وظایف اشکال‌زدایی و بررسی شبکه واقعی بسیار کاربردی است.
(اگر می‌خواهید این داده‌ها را ذخیره کنید، stdout را به یک فایل لوله کنید)
.I "(ناسازگار با: '-i'، '-I'، '-v')"

.IP -d
«حالت تخلیه» (dump mode)، بسته‌ها را به جای ثبت در فایل‌ها (حالت پیش‌فرض)، روی صفحه نمایش (stdout) نشان می‌دهد. داده‌ها به‌صورت بایت (هگزادسیمال) چاپ می‌شوند.
.I "(ناسازگار با: '-i'، '-I'، '-v'، '-L')"

.IP -a
«حالت تخلیه»، مشابه '\-d' است اما خروجی ASCII تولید می‌کند. نویسه‌های غیرقابل‌چاپ با '.' جایگزین می‌شوند.
(ترکیب '\-d' و '\-a' بدون هیچ مشکلی انجام می‌شود)
.I "(ناسازگار با: '-i'، '-I'، '-v'، '-L')"

.IP "-P proto"
مشخص کردن پروتکل‌هایی که باید پردازش شوند (پیش‌فرض: TCP). گزینه‌های ممکن در حال حاضر عبارتند از: IP، TCP، ICMP، UDP. این گزینه‌ها را می‌توان با هم ترکیب کرد.
اطلاعات IP، ICMP و UDP در خروجی استاندارد چاپ (dump) می‌شوند. پروتکل IP اطلاعات اضافی درباره بسته‌بندی IP در اطراف سایر بسته‌ها ارائه می‌دهد؛ برای ثبت بسته‌های TCP نیازی به مشخص کردن IP نیست.
بسته‌های IP و ICMP فیلتر نمی‌شوند (بسته‌های UDP از نسخه 0.3.4 به بعد فیلتر می‌شوند).
.I "(ناسازگار با: '-i'، '-I'، '-v'، '-L')"

.IP "-A char"
در «حالت عادی» (نه '\-d'، '\-a'، '\-i'، '\-I'، '\-L')، تمام نویسه‌های غیرقابل‌چاپ با
.I char
جایگزین خواهند شد.
.I "(ناسازگار با: '-a'، '-d'، '-i'، '-I'، '-v'، '-L')"

.IP "-p port"
فقط بسته‌هایی را بررسی می‌کند که به پورت (!!)
.I port
می‌روند؛ مقدار 0 به معنای همه پورت‌ها است و مقدار پیش‌فرض 0 (همه) می‌باشد.
.I "(ناسازگار با: '-c'، '-i'، '-I'، '-v'، '-L')"

.IP "-l sniflen"
مقدار داده برای ثبت وقایع در «حالت عادی» (پیش‌فرض ۳۰۰ بایت). نخستین
.B sniflen
بایت از هر اتصال ثبت می‌شود. طول 0 به معنای ثبت همه‌چیز است (مراقب فضای دیسک باشید!).
.I "(ناسازگار با: '-i'، '-I'، '-v'، '-L')"

.IP "-F snifdevice"
وادار کردن sniffit به استفاده از یک دستگاه شبکه مشخص.
.I snifdevice
را می‌توان با
.I ifconfig
پیدا کرد (نگاه کنید به
.BR ifconfig (8)).
.B sniffit
به‌طور پیش‌فرض از اترنت و PPP پشتیبانی می‌کند. برای اطلاعات بیشتر درباره وادار کردن به استفاده از سایر دستگاه‌ها،
.B README.FIRST
را بخوانید.
.I "(سازگار با همه گزینه‌ها)"

.IP "-D tty"
تمام خروجی ثبت وقایع به آن دستگاه ارسال خواهد شد.
.I "(تنها با '-i' و '-I' کار می‌کند)"

.IP "-M plugin"
فعال‌سازی افزونه شماره
.B plugin
؛ برای فهرستی از تمام افزونه‌های کامپایل‌شده در نسخه خود، کافی است دستور '
.B sniffit
' را اجرا کنید. تمام اطلاعات مربوط به افزونه‌ها را در PLUGIN-HOWTO بخوانید (حتماً آن را بخوانید!).
.I "(ناسازگار با: '-i'، '-I'، '-v')"

.IP "-L logparam"
استفاده از
.B sniffit
به‌عنوان یک ابزار پایش و فعال‌سازی حالت‌های مختلف ثبت وقایع (
.I logparam
). فایل مورد استفاده برای ثبت وقایع را می‌توان در فایل پیکربندی مشخص کرد (نگاه کنید به
.BR sniffit (5)
)، اما به‌طور پیش‌فرض
.B sniffit.log
است. پارامترهای مختلف
.I logparam
را می‌توان ترکیب کرد.
.I "(تنها با '-c' کار می‌کند)"

.SH "حالت عادی (NORMAL MODE)"
تعدادی از بایت‌های اولیه به میزان
.I sniflen
(پیش‌فرض ۳۰۰ بایت) از هر اتصال در فایلی با نام
.B x.x.x.x.p-y.y.y.y.o
ثبت می‌شود که در آن 'x.x.x.x' میزبان فرستنده (پورت 'p') و 'y.y.y.y' میزبان گیرنده (پورت 'o') است.

.SH "حالت تخلیه ('-d' و/یا '-a') (DUMP MODE ('-d' and/or '-a'))"
خروجی به stdout هدایت می‌شود، محتوای بسته به شکل بسته‌بندی‌نشده (بسته کامل IP) نمایش داده می‌شود.

.SH "حالت تعاملی ('-i' یا '-I') (INTERACTIVE MODE ('-i' or '-I'))"
کلیدهای موجود در حالت تعاملی:
.IP "'UP' یا 'k'"
بدون نیاز به توضیح (حرکت به بالا)
.IP "'DOWN' یا 'j'"
بدون نیاز به توضیح (حرکت به پایین)
.IP "F1 یا '1'"
ورود میزبان (برای بدون ماسک بودن 'all' را وارد کنید) برای فیلتر کردن بسته‌ها (میزبانی که بسته‌ها را ارسال می‌کند)
.IP "F2 یا '2'"
ورود میزبان (برای بدون ماسک بودن 'all' را وارد کنید) برای فیلتر کردن بسته‌ها (میزبانی که بسته‌ها را دریافت می‌کند)
.IP "F3 یا '3'"
ورود پورت (برای بدون ماسک بودن '0' را وارد کنید) برای فیلتر کردن بسته‌ها (میزبانی که بسته‌ها را ارسال می‌کند)
.IP "F4 یا '4'"
ورود پورت (برای بدون ماسک بودن '0' را وارد کنید) برای فیلتر کردن بسته‌ها (میزبانی که بسته‌ها را دریافت می‌کند)
.IP "F5 یا '5'"
اجرای برنامه 'sniffit_key5' با آرگومان‌های
.I "<from IP> <from port> <to IP> <to port>"
اگر برنامه وجود نداشته باشد، هیچ کاری انجام نمی‌شود. برنامه باید در همان مسیری باشد که sniffit از آنجا اجرا شده است (نه لزوماً مسیری که sniffit در آن ذخیره شده است). این قابلیت برای قطع تعاملی اتصال یا پایش اضافی مفید است. یک اسکریپت شل کوچک همواره می‌تواند آرگومان‌های ارائه‌شده را تبدیل کرده و به برنامه‌های دیگر ارسال کند.
.IP "F6 یا '6'"
همانند F5 یا '5'، اما با برنامه 'sniffit_key6'
.IP "F7 یا '7'"
همانند F5 یا '5'، اما با برنامه 'sniffit_key7'
.IP "F8 یا '8'"
همانند F5 یا '5'، اما با برنامه 'sniffit_key8'
.IP "ENTER"
پنجره‌ای باز شده و اتصال را ثبت می‌کند، یا اگر از گزینه '\-D' استفاده کرده باشید، خروجی اتصال به دستگاه انتخابی ارسال خواهد شد.
.IP "'q'"
هنگامی که در حالت ثبت وقایع هستید، ثبت متوقف می‌شود؛ در غیر این صورت، از برنامه خارج می‌شود.
.IP "'n'"
تغییر وضعیت نمایش آمار شبکه (netstatistics). این آمار در فواصل ۳ ثانیه‌ای نمونه‌برداری می‌شوند؛ برای تغییر این مقدار به فایل sn_config.h مراجعه کنید.
.IP "'g'"
برنامه
.B Sniffit
اکنون قادر است مقداری بار ترافیکی ایجاد کند. در حال حاضر این یک قابلیت «توسعه‌نیافته» با گزینه‌های بسیار محدود است، اما گسترش خواهد یافت.
در حال حاضر فقط بسته‌های UDP تولید می‌شوند. با فشردن کلید 'g'، از شما آدرس‌های IP و پورت مبدا/مقصد و تعداد بسته‌هایی که باید ارسال شوند پرسیده می‌شود.
بسته‌ها حاوی این خط هستند: "This Packet was fired with Sniffit!
.IP "'r'"
بازنشانی (Reset).. تمام اتصالات فعلی را از حافظه پاک کرده و برنامه را مجدداً راه‌اندازی می‌کند.

.SH "حالت ثبت وقایع ('-L') (LOGGING MODE ('-L'))"
خروجی در فایل
.B sniffit.log
ذخیره می‌شود، مگر اینکه نام دیگری را در فایل پیکربندی مشخص کرده باشید (نگاه کنید به
.BR sniffit (5)
).
.LP
.IP "raw"
ثبت تمام بسته‌های SYN، FIN، RST. این کار نمایی کلی از تمام ترافیک شبکه (TCP) را به‌صورت خام ('RAW') به شما ارائه می‌دهد (شروع یک اتصال می‌تواند دست‌کم ۲ بسته SYN برای شما داشته باشد و غیره...).
.IP "norm"
همانند raw، اما کمی هوشمندانه‌تر. مگر اینکه بسته‌ها به دلیل اتلاف بسته چندین بار مخابره شوند، تنها ۱ اعلان از شروع یا پایان اتصال دریافت خواهید کرد (شناسه بسته، میزبانی را که ابتدا اتصال را آغاز کرده است مشخص می‌کند).
.IP "telnet"
برنامه Sniffit تلاش خواهد کرد تا نام‌های کاربری و گذرواژه‌های این برنامه را به دست آورد (نگاه کنید به
.BR telnet (1)
).
.IP "ftp"
برنامه Sniffit تلاش خواهد کرد تا نام‌های کاربری و گذرواژه‌های این برنامه را به دست آورد (نگاه کنید به
.BR ftp (1)
).
.IP "mail"
برنامه Sniffit تلاش خواهد کرد تا تمام ایمیل‌های ثبت‌شده را شناسایی کند.

.SH "ثبت وقایع IP ICMP UDP (IP ICMP UDP LOGGING)"
اطلاعات این بسته‌ها در stdout ریخته می‌شود. گزینه‌های فیلتر کردن بسته تنها به بسته‌های TCP و UDP مربوط می‌شوند.
محتوای بسته‌های UDP تنها هنگام فعال کردن '\-a' یا '\-d' نشان داده می‌شود.

.SH "نویسنده (AUTHOR)"
Brecht Claerhout <coder@reptile.rug.ac.be>

.SH "همچنین ببینید (SEE ALSO)"
.BR sniffit (5)