'\" t .\" Title: rawshark .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-09-03 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "RAWSHARK" "1" "2026-09-03" "\ \&" "\ \&" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "نام (NAME)" rawshark \- استخراج و تحلیل داده‌های خام pcap .SH "خلاصه دستور (SYNOPSIS)" .sp \fBrawshark\fP [\~\fB\-d\fP\~|\~] [\~\fB\-F\fP\~\~] [\~\fB\-l\fP\~] [\~\fB\-m\fP\~\~] [\~\fB\-o\fP\~\~]\~.\|.\|. [\~\fB\-p\fP\~] [\~\fB\-r\fP\~|\-\~] [\~\fB\-R\fP\~\~] [\~\fB\-s\fP\~] [\~\fB\-S\fP\~\~] [\~\fBoptions\fP\~] .sp \fBrawshark\fP \fB\-h|\-\-help\fP .sp \fBrawshark\fP \fB\-v|\-\-version\fP .SH "توضیحات (DESCRIPTION)" .sp \fBRawshark\fP جریانی از بسته‌ها را از یک فایل یا پایپ خوانده و یک سطر برای توصیف خروجی، و به دنبال آن مجموعه‌ای از فیلدهای منطبق برای هر بسته را در خروجی استاندارد چاپ می‌کند. .SH "ورودی (INPUT)" .sp برخلاف \fBTShark\fP، برنامه \fBRawshark\fP هیچ پیش‌فرضی درباره کپسوله‌سازی یا ورودی در نظر نمی‌گیرد. فلگ‌های \fB\-d\fP و \fB\-r\fP باید برای اجرای آن مشخص شوند. همچنین برای اینکه خروجی مفید باشد، باید یک یا چند فلگ \fB\-F\fP تعیین گردند. سایر فلگ‌های فهرست‌شده در بالا از همان قواعد \fBWireshark\fP و \fBTShark\fP پیروی می‌کنند. .sp برنامه \fBRawshark\fP به طور پیش‌فرض انتظار رکوردهای ورودی با فرمت زیر را دارد. این ساختار با فرمت هدر بسته و داده‌های بسته در یک فایل با فرمت pcap روی دیسک مطابقت دارد. .sp .if n .RS 4 .nf .fam C struct rawshark_rec_s { uint32_t ts_sec;\& /* Time stamp (seconds) */ uint32_t ts_usec;\& /* Time stamp (microseconds) */ uint32_t caplen;\& /* Length of the packet buffer */ uint32_t len;\& /* "On the wire" length of the packet */ uint8_t data[caplen]; /* Packet data */ }; .fam .fi .if n .RE .sp اگر \fB\-p\fP ارائه شود، \fBrawshark\fP انتظار فرمت زیر را دارد. این ساختار با ساختار \fIstruct pcap_pkthdr\fP و داده‌های بسته مورد استفاده در libpcap یا Npcap مطابقت دارد. فرمت این ساختار وابسته به پلتفرم است؛ اندازه فیلد \fItv_sec\fP در ساختار \fIstruct timeval\fP می‌تواند ۳۲ بیت یا ۶۴ بیت باشد. برای اینکه \fBrawshark\fP به درستی کار کند، چیدمان (layout) ساختار در ورودی باید با چیدمان ساختار در \fBrawshark\fP یکسان باشد. توجه داشته باشید که اگر \fBrawshark\fP یک برنامه ۳۲ بیتی باشد، این فرمت احتمالاً مشابه فرمت قبلی خواهد بود، اما اگر \fBrawshark\fP برنامه‌ای ۶۴ بیتی باشد، لزوماً یکسان نخواهد بود. .sp .if n .RS 4 .nf .fam C struct rawshark_rec_s { struct timeval ts;\& /* Time stamp */ uint32_t caplen;\& /* Length of the packet buffer */ uint32_t len;\& /* "On the wire" length of the packet */ uint8_t data[caplen]; /* Packet data */ }; .fam .fi .if n .RE .sp در هر دو حالت، ترتیب بایت‌ها (اندیان) برای هر عدد صحیح باید با سیستمی که \fBrawshark\fP روی آن اجرا می‌شود یکسان باشد. .SH "خروجی (OUTPUT)" .sp اگر یک یا چند فیلد از طریق فلگ \fB\-F\fP مشخص شوند، \fBRawshark\fP شماره، نوع فیلد و فرمت نمایش را برای هر فیلد در سطر نخست به عنوان «شماره بسته» ۰ چاپ می‌کند. برای هر رکورد، شماره بسته، فیلدهای منطبق، و مقدار "1" یا "0" چاپ می‌شوند تا مشخص شود آیا فیلد با فیلتر نمایش ارائه‌شده مطابقت داشته است یا خیر. علامت "\-" برای نشان دادن پایان توصیف یک فیلد و همچنین در انتهای سطر هر بسته استفاده می‌شود. برای مثال، فلگ‌های \fB\-F ip.src \-F dns.qry.type\fP ممکن است خروجی زیر را تولید کنند: .sp .if n .RS 4 .nf .fam C 0 FT_IPv4 BASE_NONE \- 1 FT_UINT16 BASE_HEX \- 1 1="1" 0="192.168.77.10" 1 \- 2 1="1" 0="192.168.77.250" 1 \- 3 0="192.168.77.10" 1 \- 4 0="74.125.19.104" 1 \- .fam .fi .if n .RE .sp توجه داشته باشید که بسته‌های ۱ و ۲ از نوع درخواست‌های DNS هستند و بسته‌های ۳ و ۴ این‌گونه نیستند. افزودن \fB\-R "not dns"\fP همچنان هر سطر را چاپ می‌کند، اما نشانه‌ای وجود دارد مبنی بر اینکه بسته‌های ۱ و ۲ از فیلتر عبور نکرده‌اند: .sp .if n .RS 4 .nf .fam C 0 FT_IPv4 BASE_NONE \- 1 FT_UINT16 BASE_HEX \- 1 1="1" 0="192.168.77.10" 0 \- 2 1="1" 0="192.168.77.250" 0 \- 3 0="192.168.77.10" 1 \- 4 0="74.125.19.104" 1 \- .fam .fi .if n .RE .sp همچنین توجه داشته باشید که خروجی ممکن است به هر ترتیبی باشد و چندین فیلد منطبق نمایش داده شوند. .SH "گزینه‌ها (OPTIONS)" .sp \-d .RS 4 .sp نحوه تشریح داده‌های بسته را مشخص می‌کند. کپسوله‌سازی به فرم \fItype:value\fP است، که در آن \fItype\fP یکی از موارد زیر است: .sp \fBencap\fP:\fIname\fP داده‌های بسته باید با استفاده از \fIname\fP نوع پیوند داده (DLT) در libpcap/Npcap تشریح شوند، به عنوان مثال \fBencap:EN10MB\fP برای Ethernet. نام‌ها با استفاده از ()pcap_datalink_name_to_val تبدیل می‌شوند. فهرست کاملی از DLTها را می‌توان در نشانی زیر مشاهده کرد: .URL "https://www.tcpdump.org/linktypes.html" "" "." .sp \fBencap\fP:\fInumber\fP داده‌های بسته باید با استفاده از \fInumber\fP LINKTYPE_ در libpcap/Npcap تشریح شوند، به عنوان مثال \fBencap:105\fP برای IEEE 802.11 خام یا \fBencap:101\fP برای IP خام. .sp \fBproto\fP:\fIprotocol\fP داده‌های بسته باید به تشریح‌کننده پروتکل Wireshark مشخص‌شده ارسال شوند، به عنوان مثال \fBproto:http\fP برای داده‌های HTTP. .RE .sp \-F .RS 4 .sp فیلد منطبق را به خروجی اضافه می‌کند. فیلدها هر فیلد معتبر فیلتر نمایش هستند. می‌توان بیش از یک فلگ \fB\-F\fP را مشخص کرد و هر فیلد می‌تواند چندین بار در یک بسته مشخص مطابقت یابد. در هر فلگ \fB\-F\fP تنها یک فیلد ممکن است مشخص شود. اگر می‌خواهید یک فیلتر نمایش اعمال کنید، از فلگ \fB\-R\fP استفاده کنید. .RE .sp \-h|\-\-help .RS 4 شماره نسخه و گزینه‌ها را چاپ کرده و خارج می‌شود. .RE .sp \-l .RS 4 .sp پس از چاپ اطلاعات هر بسته، خروجی استاندارد را تخلیه (flush) می‌کند. (اگر \fB\-V\fP مشخص شده باشد، این حالت از نظر فنی بافر خطی نیست؛ با این حال، اگر \fB\-V\fP مشخص نشده باشد مشابه بافر خطی خواهد بود، زیرا برای هر بسته تنها یک خط چاپ می‌شود، و از آنجا که \fB\-l\fP معمولاً هنگام انتقال خروجی یک ضبط زنده به یک برنامه یا اسکریپت از طریق لوله (pipe) استفاده می‌شود تا خروجی یک بسته به محض مشاهده و تشریح آن ظاهر شود، باید درست مانند بافر خطی واقعی عمل کند. این کار به عنوان راه‌حلی برای رفع نقصی در کتابخانه Microsoft Visual C++ C انجام شده است.) .sp این گزینه ممکن است هنگام هدایت خروجی \fBTShark\fP به برنامه‌ای دیگر از طریق pipe مفید باشد، زیرا بدین معنی است که برنامه دریافت‌کننده، داده‌های تشریح‌شده یک بسته را به محض اینکه \fBTShark\fP بسته را مشاهده کرده و خروجی آن را تولید کند خواهد دید، نه اینکه تنها زمانی آن را دریافت کند که بافر خروجی استاندارد حاوی آن داده‌ها پر شود. .RE .sp \-m .RS 4 میزان استفاده حافظه rawshark را به تعداد بایت مشخص‌شده محدود می‌کند. فقط برای POSIX (غیر ویندوز). .RE .sp \-o : .RS 4 .sp یک مقدار ترجیحی (preference) را تنظیم کرده و مقدار پیش‌فرض و هر مقداری که از یک فایل تنظیمات ترجیحی خوانده شده باشد را بازنویسی می‌کند. آرگومان این گزینه رشته‌ای به شکل \fIprefname:value\fP است، که در آن \fIprefname\fP نام ترجیح (همان نامی که در فایل ترجیحات ظاهر می‌شود) و \fIvalue\fP مقداری است که باید تنظیم شود. .RE .sp \-p .RS 4 .sp فرض می‌کند که داده‌های بسته با یک ساختار pcap_pkthdr همان‌گونه که در pcap.h تعریف شده آغاز می‌شوند. در برخی سیستم‌ها اندازه داده‌های برچسب زمان با داده‌های نوشته‌شده روی دیسک متفاوت خواهد بود. در سایر سیستم‌ها یکسان بوده و این فلگ تاثیری ندارد. .RE .sp \-r |\- .RS 4 .sp داده‌های بسته را از \fIinput source\fP می‌خواند. می‌تواند نام یک FIFO (لوله نام‌گذاری‌شده) یا ``\-\*(Aq\*(Aq برای خواندن داده‌ها از ورودی استاندارد باشد، و باید دارای قالب رکوردی باشد که در بالا مشخص شده است. .sp اگر در ویندوز داده‌ها را از یک فرآیند والد به rawshark ارسال می‌کنید، نباید هندل ورودی استاندارد rawshark را پیش از موعد ببندید، در غیر این صورت ممکن است زمان اجرای C یک استثنا ایجاد کند. .RE .sp \-R|\-\-read\-filter .RS 4 .sp باعث می‌شود فیلتر مشخص‌شده (که به جای ساختار فیلترهای ضبط، از ساختار فیلترهای خواندن/نمایش استفاده می‌کند) پیش از چاپ خروجی اعمال شود. فیلترهای خواندن و فیلترهای نمایش در \fBrawshark\fP مترادف هستند. .RE .sp \-s .RS 4 با رد شدن از هدر ۲۴ بایتی فایل pcap، اجازه می‌دهد از فایل‌های استاندارد pcap به عنوان ورودی استفاده شود. .RE .sp \-S .RS 4 .sp از رشته قالب‌بندی مشخص‌شده برای چاپ هر فیلد استفاده می‌کند. قالب‌های زیر پشتیبانی می‌شوند: .sp \fB%D\fP نام فیلد یا توضیحات، به عنوان مثال "Type" برای dns.qry.type .sp \fB%N\fP مقدار عددی در مبنای ۱۰ برای فیلد. .sp \fB%S\fP مقدار رشته‌ای فیلد. .sp برای چیزی شبیه به نمایش استاندارد Wireshark (مانند "Type: A (1)") می‌توانید از \fB%D: %S (%N)\fP استفاده کنید. .RE .sp \-v|\-\-version .RS 4 اطلاعات نسخه کامل را چاپ کرده و خارج می‌شود. .RE .sp \-Y|\-\-display\-filter .RS 4 .sp باعث می‌شود فیلتر مشخص‌شده (که به جای ساختار فیلترهای ضبط، از ساختار فیلترهای خواندن/نمایش استفاده می‌کند) پیش از چاپ خروجی اعمال شود. فیلترهای خواندن و فیلترهای نمایش در \fBrawshark\fP مترادف هستند. .RE.SH "گزینه‌های کالبدشکافی (DISSECTION OPTIONS)" .sp \-\-disable\-all\-protocols .RS 4 غیرفعال‌سازی کالبدشکافی تمام پروتکل‌ها. .RE .sp \-\-disable\-protocol [,,.\|.\|.] .RS 4 غیرفعال‌سازی کالبدشکافی proto_name. استفاده از \fBALL\fP به عنوان proto_name برای نادیده‌گرفتن فهرست پیش‌فرض پروتکل‌های فعال در نمایه (profile) انتخابی شما و غیرفعال‌سازی موقت تمام پروتکل‌ها. .RE .sp \-\-disable\-heuristic .RS 4 غیرفعال‌سازی کالبدشکافی پروتکل اکتشافی (heuristic). .RE .sp \-\-enable\-protocol [,,.\|.\|.] .RS 4 .sp فعال‌سازی کالبدشکافی proto_name. استفاده از \fBALL\fP به عنوان proto_name برای نادیده‌گرفتن فهرست پیش‌فرض پروتکل‌های غیرفعال در نمایه انتخابی شما و فعال‌سازی موقت تمام پروتکل‌هایی که به‌طور پیش‌فرض فعال هستند. .sp اگر پروتکلی هم در \fB\-\-disable\-protocol\fP و هم در \fB\-\-enable\-protocol\fP ذکر شده باشد، آن پروتکل فعال می‌شود. این به شما امکان می‌دهد تمام پروتکل‌ها را به‌جز فهرستی از موارد استثنا به‌طور موقت غیرفعال کنید. مثال: \fB\-\-disable\-protocol ALL \-\-enable\-protocol eth,ip\fP .RE .sp \-\-enable\-heuristic .RS 4 فعال‌سازی کالبدشکافی پروتکل اکتشافی (heuristic). .RE .sp \-K .RS 4 .sp بارگذاری کلیدهای رمزنگاری کربروس (Kerberos) از فایل جدول کلید (keytab) مشخص‌شده. این گزینه می‌تواند چندین بار برای بارگذاری کلیدها از چند فایل استفاده شود. .sp مثال: \fB\-K krb5.keytab\fP .RE .sp \-n .RS 4 غیرفعال‌سازی تحلیل نام اشیاء شبکه (مانند نام میزبان، نام پورت‌های TCP و UDP)؛ گزینه \fB\-N\fP ممکن است این گزینه را نادیده بگیرد. .RE .sp \-N .RS 4 .sp روشن کردن تحلیل نام فقط برای انواع خاصی از آدرس‌ها و شماره پورت‌ها، به‌طوری که تحلیل نام برای سایر انواع آدرس‌ها و شماره پورت‌ها خاموش بماند. این گزینه (همراه با \fB\-n\fP) می‌تواند چندین بار مشخص شود؛ آخرین مقدار تعیین‌شده مقادیر پیشین را بازنویسی می‌کند. این گزینه و \fB\-n\fP گزینه‌های تنظیمات ترجیحی (preferences)، از جمله ترجیحات تنظیم‌شده با گزینه \fB\-o\fP را نادیده می‌گیرند. اگر هیچ‌یک از گزینه‌های \fB\-N\fP و \fB\-n\fP مشخص نشوند، مقادیر تنظیمات ترجیحی استفاده می‌شوند که پیش‌فرض آن \fB\-N dmN\fP است. .sp آرگومان رشته‌ای است که می‌تواند شامل این حروف باشد: .sp \fBd\fP برای فعال‌سازی تحلیل نام از بسته‌های DNS ضبط‌شده .sp \fBg\fP برای فعال‌سازی جستجوی اطلاعات موقعیت مکانی (geolocation) آدرس IP از پایگاه‌های داده پیکربندی‌شده MaxMind .sp \fBm\fP برای فعال‌سازی تحلیل آدرس MAC .sp \fBn\fP برای فعال‌سازی تحلیل آدرس شبکه .sp \fBN\fP برای فعال‌سازی استفاده از تحلیل‌گرهای خارجی (مانند DNS) جهت تحلیل آدرس شبکه؛ بدون فعال بودن همزمان \fBn\fP تاثیری ندارد. .sp \fBs\fP برای فعال‌سازی تحلیل آدرس با استفاده از اطلاعات SNI موجود در بسته‌های دست‌تکانی (handshake) ضبط‌شده .sp \fBt\fP برای فعال‌سازی تحلیل شماره پورت‌های لایه انتقال (transport\-layer) .sp \fBv\fP برای فعال‌سازی تحلیل شناسه‌های VLAN به نام‌ها .RE .sp \-\-only\-protocols .RS 4 تنها فعال‌سازی کالبدشکافی این پروتکل‌ها، جداشده با کاما. غیرفعال‌سازی هر چیز دیگر. .RE .sp \-t (a|ad|adoy|d|dd|e|r|rc|u|ud|udoy)[.[N]]|.[N] .RS 4 .sp تنظیم قالب برچسب زمانی بسته که در ستون پیش‌فرض زمان نمایش داده می‌شود. قالب می‌تواند یکی از موارد زیر باشد: .sp \fBa\fP مطلق (absolute): زمان مطلق، به صورت زمان محلی در منطقه زمانی شما، زمان واقعی ضبط بسته است بدون اینکه تاریخی نمایش داده شود .sp \fBad\fP مطلق همراه با تاریخ: تاریخ مطلق، به صورت YYYY\-MM\-DD، و زمان، به صورت زمان محلی در منطقه زمانی شما، زمان و تاریخ واقعی ضبط بسته است .sp \fBadoy\fP مطلق همراه با تاریخ با استفاده از روز در سال: تاریخ مطلق، نمایش‌یافته به صورت YYYY/DOY، و زمان، به صورت زمان محلی در منطقه زمانی شما، زمان و تاریخ واقعی ضبط بسته است .sp \fBd\fP دلتا (delta): زمان دلتا، زمان سپری‌شده پس از ضبط بسته قبلی است .sp \fBdd\fP دلتای نمایشی (delta_displayed): زمان delta_displayed، زمان سپری‌شده پس از ضبط بسته نمایشی قبلی است .sp \fBe\fP مبدأ زمانی (epoch): زمان به ثانیه از مبدأ زمانی یونیکس (1 ژانویه 1970، ساعت 00:00:00) .sp \fBr\fP نسبی (relative): زمان نسبی، زمان سپری‌شده میان اولین بسته و بسته فعلی است .sp \fBrc\fP نسبی نسبت به آغاز ضبط: زمان نسبی نسبت به آغاز ضبط، زمان سپری‌شده میان شروع ضبط و بسته فعلی است .sp \fBu\fP زمان هماهنگ جهانی (UTC): زمان مطلق، به صورت UTC با پسوند "Z"، زمان واقعی ضبط بسته است، بدون اینکه تاریخی نمایش داده شود .sp \fBud\fP زمان UTC همراه با تاریخ: تاریخ مطلق، نمایش‌یافته به صورت YYYY\-MM\-DD، و زمان، به صورت UTC با پسوند "Z"، زمان و تاریخ واقعی ضبط بسته است .sp \fBudoy\fP زمان UTC همراه با تاریخ با استفاده از روز در سال: تاریخ مطلق، نمایش‌یافته به صورت YYYY/DOY، و زمان، به صورت UTC با پسوند "Z"، زمان و تاریخ واقعی ضبط بسته است .sp \fB.[N]\fP تنظیم دقت: N تعداد رقم‌های اعشار است (۰ تا ۹). در صورت استفاده از "." بدون N، دقت به طور خودکار از روی ردگیری (trace) تعیین می‌شود. .sp قالب پیش‌فرض به‌صورت نسبی با دقت مبتنی بر قالب ضبط است. .RE .sp \-u .RS 4 .sp مشخص می‌کند که قالب‌های برچسب زمانی بسته در \fB\-t\fP که زمان‌های نسبی هستند (یعنی relative، delta و delta_displayed) چگونه نمایش داده شوند. انتخاب‌های معتبر عبارتند از: .sp \fBs\fP برای ثانیه‌ها .sp \fBhms\fP برای ساعت‌ها، دقیقه‌ها و ثانیه‌ها .sp قالب پیش‌فرض ثانیه است. .RE .SH "گزینه‌های عیب‌یابی (DIAGNOSTIC OPTIONS)" .sp \-\-log\-level .RS 4 تنظیم سطح فعال لاگ. سطوح پشتیبانی‌شده از کمترین به بیشترین ترتیب عبارتند از "noisy"، "debug"، "info"، "message"، "warning"، "critical" و "error". پیام‌های مربوط به هر سطح و بالاتر چاپ خواهند شد؛ برای نمونه "warning" پیام‌های "warning"، "critical" و "error" را چاپ می‌کند و "noisy" همه پیام‌های لاگ را چاپ می‌نماید. سطوح نسبت به کوچک و بزرگ بودن حروف حساس نیستند. .RE .sp \-\-log\-fatal .RS 4 در صورت ثبت هر پیامی در سطح مشخص‌شده یا بالاتر، برنامه را متوقف می‌کند. برای نمونه، "warning" با ثبت هر یک از پیام‌های "warning"، "critical" یا "error" برنامه را متوقف خواهد کرد. .RE .sp \-\-log\-fatal\-count .RS 4 تعداد پیام‌های لاگ مهلک (fatal) که می‌توانند پیش از متوقف شدن برنامه ثبت شوند. .RE .sp \-\-log\-domains .RS 4 فقط پیام‌های مربوط به دامنه‌های لاگ مشخص‌شده را چاپ می‌کند، مانند "GUI,Epan,sshdump". فهرست دامنه‌ها باید با کاما از هم جدا شوند. می‌تواند با "!" به عنوان نویسه نخست نفی شود (تطابق را معکوس می‌کند). .RE .sp \-\-log\-debug .RS 4 دامنه‌های مشخص‌شده را مجبور می‌کند در سطح "debug" لاگ ثبت کنند. فهرست دامنه‌ها باید با کاما از هم جدا شوند. می‌تواند با "!" به عنوان نویسه نخست نفی شود (تطابق را معکوس می‌کند). .RE .sp \-\-log\-noisy .RS 4 دامنه‌های مشخص‌شده را مجبور می‌کند در سطح "noisy" لاگ ثبت کنند. فهرست دامنه‌ها باید با کاما از هم جدا شوند. می‌تواند با "!" به عنوان نویسه نخست نفی شود (تطابق را معکوس می‌کند). .RE .sp \-\-log\-fatal\-domains .RS 4 در صورت ثبت هر پیامی برای دامنه‌های لاگ مشخص‌شده، برنامه را متوقف می‌کند. فهرست دامنه‌ها باید با کاما از هم جدا شوند. .RE .sp \-\-log\-file .RS 4 پیام‌های لاگ و خروجی stderr را در فایل مشخص‌شده می‌نویسد. .RE .SH "نحو فیلتر خواندن (READ FILTER SYNTAX)" .sp برای مشاهده جدول کاملی از پروتکل‌ها و فیلدهای پروتکلی که در \fBRawshark\fP قابل فیلتر شدن هستند، صفحه راهنمای wireshark\-filter(4) را ببینید. .SH "فایل‌ها (FILES)" .sp این فایل‌ها حاوی تنظیمات پیکربندی گوناگون \fBWireshark\fP هستند. .sp ترجیحات (Preferences) .RS 4 .sp فایل‌های \fIpreferences\fP شامل تنظیمات ترجیحی سراسری در سطح سیستم و شخصی هستند. اگر فایل ترجیحات سراسری در سطح سیستم وجود داشته باشد، ابتدا خوانده شده و تنظیمات پیش‌فرض را بازنویسی / لغو اولویت می‌کند. اگر فایل ترجیحات شخصی وجود داشته باشد، در مرحلهٔ بعد خوانده شده و هرگونه مقدار پیشین را بازنویسی / لغو اولویت خواهد کرد. نکته: اگر پرچم خط فرمان \fB\-o\fP استفاده شود (احتمالاً بیش از یک بار)، به نوبهٔ خود مقادیر فایل‌های ترجیحات را بازنویسی / لغو اولویت خواهد کرد. .sp تنظیمات ترجیحات به شکل \fIprefname:value\fP در هر خط نوشته می‌شوند، که در آن \fIprefname\fP نام ترجیح و \fIvalue\fP مقداری است که باید روی آن تنظیم شود؛ فاصلهٔ خالی (white space) بین \fB:\fP و \fIvalue\fP مجاز است. یک تنظیم ترجیح را می‌توان با دندانه‌دار کردن خطوط بعدی با فاصلهٔ خالی، در خطوط بعد ادامه داد. نویسهٔ \fB#\fP آغازگر توضیحی است که تا انتهای خط ادامه می‌یابد: .sp .if n .RS 4 .nf .fam C # Vertical scrollbars should be on right side? # TRUE or FALSE (case\-insensitive). gui.scrollbar_on_right: TRUE .fam .fi .if n .RE .sp فایل سراسری ترجیحات، در دایرکتوری \fIwireshark\fP زیر شاخهٔ \fIshare\fP از دایرکتوری اصلی نصب جستجو می‌شود. در macOS، این مسیر معمولاً \fI/Application/Wireshark.app/Contents/Resources/share\fP است؛ در سایر سیستم‌های سازگار با UNIX مانند Linux، \(rs*BSD، Solaris و AIX، این مسیر معمولاً برای بسته‌های نصب‌شده در سطح سیستم \fI/usr/share/wireshark/preferences\fP و برای بسته‌های نصب‌شده به صورت محلی \fI/usr/local/share/wireshark/preferences\fP خواهد بود؛ در ویندوز، این مسیر معمولاً \fIC:\(rsProgram Files\(rsWireshark\(rspreferences\fP است. .sp در سیستم‌های سازگار با UNIX، فایل ترجیحات شخصی در \fI$XDG_CONFIG_HOME/wireshark/preferences\fP (یا اگر \fI$XDG_CONFIG_HOME/wireshark\fP وجود نداشته باشد در حالی که \fI$HOME/.wireshark\fP وجود دارد، در \fI$HOME/.wireshark/preferences\fP) جستجو می‌شود؛ این مسیر معمولاً \fI$HOME/.config/wireshark/preferences\fP است. در ویندوز، فایل ترجیحات شخصی در \fI%APPDATA%\(rsWireshark\(rspreferences\fP (یا اگر %APPDATA% تعریف نشده باشد، در \fI%USERPROFILE%\(rsApplication Data\(rsWireshark\(rspreferences\fP) جستجو می‌شود. .RE .sp پروتکل‌های غیرفعال (فعال) .RS 4 .sp فایل‌های \fIdisabled_protos\fP شامل فهرست‌های سراسری در سطح سیستم و شخصی از پروتکل‌هایی هستند که غیرفعال شده‌اند، تا کالبدشکاف‌های آن‌ها هرگز فراخوانی نشوند. این فایل‌ها شامل نام‌های پروتکل در هر خط هستند، به طوری که نام پروتکل همان نامی است که در فیلتر نمایش برای آن پروتکل استفاده می‌شود: .sp .if n .RS 4 .nf .fam C http tcp\& # a comment .fam .fi .if n .RE .sp اگر پروتکلی در فایل سراسری \fIdisabled_protos\fP فهرست شده باشد، توسط کاربر قابل فعال‌سازی نخواهد بود. .sp فایل سراسری \fIdisabled_protos\fP از همان دایرکتوری فایل ترجیحات سراسری استفاده می‌کند. .sp فایل شخصی \fIdisabled_protos\fP از همان دایرکتوری فایل ترجیحات شخصی استفاده می‌کند. .sp فایل‌های \fIdisabled_protos\fP تنها پروتکل‌هایی را فهرست می‌کنند که به طور پیش‌فرض فعال بوده اما غیرفعال شده‌اند؛ پروتکل‌هایی که به طور پیش‌فرض غیرفعال هستند (مانند برخی کالبدشکاف‌های پسین - postdissectors) فهرست نمی‌شوند. فایل‌های مشابه \fIenabled_protos\fP برای پروتکل‌هایی وجود دارند که به طور پیش‌فرض غیرفعال بوده اما فعال شده‌اند. .RE .sp کالبدشکاف‌های اکتشافی (Heuristic Dissectors) .RS 4 .sp فایل‌های \fIheuristic_protos\fP شامل فهرست‌های سراسری در سطح سیستم و شخصی از کالبدشکاف‌های اکتشافی هستند و فعال یا غیرفعال بودن آن‌ها را مشخص می‌کنند. این فایل‌ها حاوی نام‌های کوتاه یکتای کالبدشکاف‌های اکتشافی در هر خط هستند که به دنبال آن یک کاما و سپس 0 برای غیرفعال و 1 برای فعال قرار می‌گیرد: .sp .if n .RS 4 .nf .fam C quic,1 rtcp_stun,1 rtcp_udp,1 rtp_stun,0 rtp_udp,0 tls_tcp,1 .fam .fi .if n .RE .sp فایل سراسری \fIheuristic_protos\fP از همان دایرکتوری فایل ترجیحات سراسری استفاده می‌کند. .sp فایل شخصی \fIheuristic_protos\fP از همان دایرکتوری فایل ترجیحات شخصی استفاده می‌کند. .RE .sp تحلیل نام (میزبان‌ها - hosts) .RS 4 .sp مدخل‌های موجود در فایل‌های \fIhosts\fP در دایرکتوری ترجیحات سراسری و شخصی، پیش از هر اقدام دیگری برای تحلیل نشانی‌های IPv4 و IPv6، برای تحلیل آن‌ها استفاده می‌شوند. این فایل از نحو استاندارد فایل \fIhosts\fP پیروی می‌کند؛ هر خط شامل یک نشانی IP و نام است که با فاصلهٔ خالی (whitespace) از یکدیگر جدا شده‌اند. در صورت وجود، فایل شخصی \fIhosts\fP فایل موجود در دایرکتوری سراسری را بازنویسی / لغو اولویت می‌کند. .sp تحلیل نام در فیلتر ضبط، در سیستم‌های سازگار با UNIX مانند Linux، macOS، \(rs*BSD، Solaris و AIX توسط libpcap، و در ویندوز توسط Npcap انجام می‌شود. از این رو، برای تحلیل نام در فیلتر ضبط، به فایل شخصی \fIhosts\fP در Wireshark مراجعه نخواهد شد. .RE .sp تحلیل نام (زیرشبکه‌ها - subnets) .RS 4 .sp اگر یک نشانی IPv4 نتواند از طریق تحلیل نام ترجمه شود (هیچ تطابق دقیقی یافت نشود)، یک تطابق جزئی از طریق فایل \fIsubnets\fP امتحان می‌شود. در صورت وجود، هر دو فایل سراسری \fIsubnets\fP و فایل شخصی \fIsubnets\fP استفاده می‌شوند. .sp هر خط از این فایل متشکل از یک نشانی IPv4، طول ماسک زیرشبکه که تنها با یک / جدا شده، و یک نام که با فاصلهٔ خالی جدا شده است، می‌باشد. در حالی که نشانی باید یک نشانی کامل IPv4 باشد، هر مقداری فراتر از طول ماسک در ادامه نادیده گرفته خواهد شد. .sp یک نمونه: .sp # Comments must be prepended by the # sign! 192.168.0.0/24 ws_test_network .sp نامی که به طور جزئی تطابق یافته باشد، به شکل "subnet\-name.remaining\-address" چاپ خواهد شد. برای نمونه، "192.168.0.1" ذیل زیرشبکهٔ بالا به صورت "ws_test_network.1" چاپ می‌شود؛ اگر طول ماسک بالا به جای 24 برابر با 16 بود، نشانی چاپ‌شده "ws_test_network.0.1" می‌بود. .RE .sp تحلیل نام (ethers) .RS 4 .sp فایل‌های \fIethers\fP برای تطبیق آدرس‌های سخت‌افزاری ۶\-بایتی EUI\-48 و ۸\-بایتی EUI\-64 با نام‌ها بررسی می‌شوند. ابتدا فایل \fIethers\fP شخصی بررسی می‌شود و اگر آدرس در آن یافت نشود، سپس فایل \fIethers\fP سراسری بررسی می‌گردد. .sp این فایل قالبی شبیه به قالب تعریف‌شده توسط ethers(5) در برخی سیستم‌های شبه\-یونیکس دارد. هر خط شامل یک آدرس سخت‌افزاری و نام است که با فاصله خالی (تب‌ها یا فاصله‌ها) جدا شده‌اند. ارقام هگزادسیمال آدرس سخت‌افزاری با دونقطه (:)، خط تیره (\-) یا نقطه (.) از هم جدا می‌شوند. باید از همان نویسه جداکننده به طور یکدست در یک آدرس استفاده شود. علامت \f(CR#\fP نشان‌دهنده یک توضیح است که تا انتهای خط امتداد می‌یابد. هر دو آدرس ۶\-بایتی MAC و ۸\-بایتی EUI\-64 پشتیبانی می‌شوند. چهار خط زیر خطوط معتبری از یک فایل \fIethers\fP هستند: .sp .if n .RS 4 .nf .fam C ff:ff:ff:ff:ff:ff\& Broadcast c0\-00\-ff\-ff\-ff\-ff\& TR_broadcast 00.00.00.00.00.00\& Zero_broadcast 00:00:00:00:00:00:00:00\& EUI64_zero_broadcast .fam .fi .if n .RE .sp توجه داشته باشید که این قالب تنوع بیشتری از قالب‌ها را نسبت به فایل تعریف‌شده توسط ethers(5) در اکثر سیستم‌های UN*X می‌پذیرد. .sp فایل سراسری \fIethers\fP در سیستم‌های سازگار با یونیکس، مانند لینوکس، macOS، \(rs*BSD، سولاریس، و AIX در دایرکتوری \fI/etc\fP جستجو می‌شود، و در سیستم‌های ویندوز در دایرکتوری اصلی نصب (برای مثال، \fIC:\(rsProgram Files\(rsWireshark\fP) جستجو می‌گردد. .sp فایل شخصی \fIethers\fP در همان دایرکتوری فایل تنظیمات شخصی جستجو می‌شود. .sp تحلیل نام فیلتر ضبط در سیستم‌های سازگار با یونیکس توسط libpcap و در سیستم‌های ویندوز توسط Npcap مدیریت می‌شود. بنابراین برای تحلیل نام فیلتر ضبط، فایل شخصی \fIethers\fP در Wireshark بررسی نخواهد شد. .RE .sp تحلیل نام (manuf) .RS 4 .sp فایل \fImanuf\fP برای تطبیق بخش ۳\-بایتی سازنده از یک آدرس سخت‌افزاری ۶\-بایتی با نام سازنده استفاده می‌شود؛ این فایل همچنین می‌تواند حاوی آدرس‌های MAC شناخته‌شده و محدوده‌های آدرس مشخص‌شده با ماسک شبکه باشد. قالب این فایل مشابه فایل‌های \fIethers\fP است، با این تفاوت که ورودی‌هایی مانند: .sp .if n .RS 4 .nf .fam C 00:00:0C\& Cisco\& Cisco Systems, Inc .fam .fi .if n .RE .sp می‌توانند ارائه شوند، همراه با OUI سه\-بایتی و هر دو نام کوتاه و طولانی برای یک سازنده، و ورودی‌هایی مانند: .sp .if n .RS 4 .nf .fam C 00\-00\-0C\-07\-AC/40\& All\-HSRP\-routers .fam .fi .if n .RE .sp می‌توانند مشخص شوند، همراه با یک آدرس MAC و ماسکی که نشان می‌دهد چند بیت از آدرس باید مطابقت داشته باشد. ورودی بالا، برای مثال، دارای ۴۰ بیت معنادار یا ۵ بایت است، و با آدرس‌های 00\-00\-0C\-07\-AC\-00 تا 00\-00\-0C\-07\-AC\-FF مطابقت دارد. نیازی نیست که ماسک مضربی از ۸ باشد. .sp فایل سراسری \fImanuf\fP در همان دایرکتوری فایل تنظیمات سراسری جستجو می‌شود، و فایل شخصی \fImanuf\fP در همان دایرکتوری فایل تنظیمات شخصی جستجو می‌گردد. .sp در نسخه‌های اولیه Wireshark، اطلاعات رسمی مرجع ثبت IEEE در این قالب به عنوان فایل سراسری \fImanuf\fP توزیع می‌شد. این اطلاعات اکنون برای افزایش سرعت راه‌اندازی برنامه کامپایل شده است، اما اطلاعات داخلی را می‌توان در این قالب با \fBtshark \-G manuf\fP ذخیره کرد. .sp علاوه بر فایل \fImanuf\fP، فایل دیگری با همین قالب به نام \fIwka\fP در دایرکتوری سراسری جستجو می‌شود. این فایل به همراه Wireshark توزیع می‌شود، و شامل داده‌هایی درباره آدرس‌های MAC شناخته‌شده و محدوده‌های آدرس گردآوری‌شده از منابع مختلف غیر IEEE اما معتبر است. .RE .sp تحلیل نام (سرویس‌ها - services) .RS 4 .sp فایل \fIservices\fP برای ترجمه شماره پورت‌ها به نام‌ها به کار می‌رود. هر دو فایل سراسری \fIservices\fP و فایل شخصی \fIservices\fP در صورت وجود استفاده می‌شوند. .sp این فایل دارای نحو استاندارد فایل \fIservices\fP است؛ هر خط شامل یک نام (سرویس) و یک شناسه انتقال است که با فاصله خالی جدا شده‌اند. شناسه انتقال شامل یک شماره پورت و یک نام پروتکل انتقال (معمولاً tcp، udp، یا sctp) است که با یک / جدا شده‌اند. .sp یک مثال: .sp mydns 5045/udp # My own Domain Name Server mydns 5045/tcp # My own Domain Name Server .sp در نسخه‌های اولیه Wireshark، اطلاعات رسمی رجیستری IANA در این قالب به عنوان فایل سراسری \fIservices\fP توزیع می‌شد. این اطلاعات اکنون برای افزایش سرعت راه‌اندازی برنامه کامپایل شده است، اما اطلاعات داخلی را می‌توان در این قالب با \fBtshark \-G services\fP ذخیره کرد. .RE .sp تحلیل نام (ipxnets) .RS 4 .sp فایل‌های \fIipxnets\fP برای تطبیق شماره‌های شبکه IPX چهار\-بایتی با نام‌ها به کار می‌روند. ابتدا فایل سراسری \fIipxnets\fP بررسی می‌شود و اگر آن آدرس در آنجا یافت نشود، سپس فایل شخصی بررسی می‌گردد. .sp قالب آن همانند فایل \fIethers\fP است، به جز اینکه هر آدرس به جای شش بایت، چهار بایت است. علاوه بر این، آدرس می‌تواند به عنوان یک عدد هگزادسیمال منفرد نشان داده شود، همان‌طور که در دنیای IPX معمول‌تر است، تا چهار اکتت هگزادسیمال. به عنوان مثال، این چهار خط، خطوط معتبری از یک فایل \fIipxnets\fP هستند: .sp .if n .RS 4 .nf .fam C C0.A8.2C.00\& HR c0\-a8\-1c\-00\& CEO 00:00:BE:EF\& IT_Server1 110f\& FileServer3 .fam .fi .if n .RE .sp فایل سراسری \fIipxnets\fP در دایرکتوری \fI/etc\fP در سیستم‌های سازگار با یونیکس، مانند Linux، macOS، \(rs*BSD، Solaris و AIX، و در دایرکتوری اصلی نصب (برای مثال، \fIC:\(rsProgram Files\(rsWireshark\fP) در سیستم‌های Windows جستجو می‌شود. .sp فایل شخصی \fIipxnets\fP در همان دایرکتوری فایل تنظیمات شخصی جستجو می‌شود. .RE .sp تحلیل نام (ss7pcs) .RS 4 .sp فایل \fIss7pcs\fP برای ترجمه کدهای نقطه (point codes) اس‌اس۷ (SS7) به نام‌ها به کار می‌رود. این فایل از دایرکتوری پیکربندی شخصی خوانده می‌شود. .sp هر خط در این فایل از یک شناسه شبکه تشکیل شده است که به دنبال آن یک خط تیره، یک کد نقطه به صورت ده‌دهی و یک نام گره که با فاصله خالی (whitespace) جدا شده‌اند می‌آید. یک مثال: .sp .if n .RS 4 .nf .fam C 2\-1234 MyPointCode1 .fam .fi .if n .RE .RE .sp تحلیل نام (vlans) .RS 4 .sp فایل \fIvlans\fP برای ترجمه شناسه برچسب VLAN به نام‌ها استفاده می‌شود. این فایل از دایرکتوری پیکربندی شخصی خوانده می‌شود. .sp هر خط در این فایل از یک شناسه برچسب VLAN تشکیل شده است که با فاصله خالی از یک نام جدا شده است. یک مثال: .sp .if n .RS 4 .nf .fam C 123\& Server\-Lan 2049\& HR\-Client\-LAN .fam .fi .if n .RE .RE .sp فیلترهای رنگی (قوانین رنگ‌آمیزی) .RS 4 .sp فایل‌های \fIcolorfilters\fP شامل فیلترهای رنگی سراسری سیستم و شخصی هستند. هر خط شامل یک فیلتر است که با رشته نمایش‌یافته در کادر محاوره آغاز می‌شود و به دنبال آن فیلتر نمایش متناظر می‌آید. سپس رنگ‌های پس‌زمینه و پیش‌زمینه افزوده می‌شوند: .sp .if n .RS 4 .nf .fam C # a comment @tcp@tcp@[59345,58980,65534][0,0,0] @udp@udp@[28834,57427,65533][0,0,0] .fam .fi .if n .RE .sp فایل سراسری \fIcolorfilters\fP از همان دایرکتوری فایل تنظیمات (preferences) سراسری استفاده می‌کند. .sp فایل شخصی \fIcolorfilters\fP از همان دایرکتوری فایل تنظیمات شخصی استفاده می‌کند. این فایل از طریق کادر محاوره‌ای View:Coloring Rules (نمایش: قوانین رنگ‌آمیزی) نوشته می‌شود. .sp اگر فایل سراسری \fIcolorfilters\fP وجود داشته باشد، فقط زمانی استفاده می‌شود که فایل شخصی \fIcolorfilters\fP وجود نداشته باشد؛ فیلترهای رنگی سراسری و شخصی با یکدیگر ادغام نمی‌شوند. .RE .sp افزونه‌ها (Plugins) .RS 4 .sp نرم‌افزار Wireshark افزونه‌ها را هم در پوشه افزونه‌های شخصی و هم در پوشه افزونه‌های سراسری جستجو می‌کند. .sp در سیستم‌های سازگار با یونیکس (UNIX)، مانند لینوکس، مک‌اواس (macOS)، \(rs*BSD، سولاریس و AIX، دایرکتوری سراسری افزونه‌ها \fIlib/wireshark/plugins/\fP (در برخی سیستم‌ها \fIlib64\fP جایگزین \fIlib\fP می‌شود) در زیر دایرکتوری اصلی نصب است (برای نمونه، \fI/usr/local/lib/wireshark/plugins/\fP). دایرکتوری شخصی افزونه‌ها \fI$HOME/.local/lib/wireshark/plugins\fP است. .sp در macOS، اگر Wireshark به صورت یک بسته برنامه‌ای (application bundle) نصب شده باشد، پوشه سراسری افزونه‌ها در عوض \fI%APPDIR%/Contents/PlugIns/wireshark\fP است. .sp در ویندوز، پوشه سراسری افزونه‌ها \fIplugins/\fP در زیر دایرکتوری اصلی نصب است (برای نمونه، \fIC:\(rsProgram Files\(rsWireshark\(rsplugins\(rs\fP). پوشه شخصی افزونه‌ها \fI%APPDATA%\(rsWireshark\(rsplugins\fP (یا اگر %APPDATA% تعریف نشده باشد، \fI%USERPROFILE%\(rsApplication Data\(rsWireshark\(rsplugins\fP) است. .sp افزونه‌های Lua در پوشه‌های افزونه ذخیره می‌شوند؛ افزونه‌های کامپایل‌شده در زیرپوشه‌هایی از پوشه‌های افزونه ذخیره می‌شوند که نام زیرپوشه، شماره نسخه فرعی Wireshark (به صورت X.Y) است. یک سطح سلسله‌مراتبی دیگر برای هر نوع از افزونه‌های Wireshark وجود دارد (شامل libwireshark، libwiretap و codecs). برای نمونه، محل قرارگیری یک افزونه libwireshark با نام \fIfoo.so\fP (یا \fIfoo.dll\fP در ویندوز) مسیر \fIPLUGINDIR/X.Y/epan\fP خواهد بود (libwireshark قبلاً libepan نامیده می‌شد؛ نام سایر پوشه‌ها \fIcodecs\fP و \fIwiretap\fP است). .if n .sp .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 .B نکته .ps -1 .br .sp در سیستم‌های سازگار با UNIX، افزونه‌های Lua (نه افزونه‌های باینری) ممکن است در \fI$XDG_CONFIG_HOME/wireshark/plugins\fP نیز قرار داده شوند، (یا اگر \fI$XDG_CONFIG_HOME/wireshark\fP وجود نداشته باشد در حالی که \fI$HOME/.wireshark\fP وجود دارد، \fI$HOME/.wireshark/plugins\fP.) .sp .5v .RE .sp توجه داشته باشید که یک ماژول افزونه کالبدشکاف (dissector plugin) ممکن است از بیش از یک پروتکل پشتیبانی کند؛ لزوماً تناظر یک‌به‌یک بین ماژول‌های افزونه کالبدشکاف و پروتکل‌ها وجود ندارد. پروتکل‌های پشتیبانی‌شده توسط یک ماژول افزونه کالبدشکاف به همان روشی فعال و غیرفعال می‌شوند که پروتکل‌های داخلی Wireshark کنترل می‌گردند. .RE .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .sp WIRESHARK_CONFIG_DIR .RS 4 .sp این متغیر محیطی مسیر فایل‌های پیکربندی شخصی را جایگزین می‌کند. در سیستم‌های سازگار با UNIX، مانند Linux، macOS، \(rs*BSD، Solaris و AIX، مقدار پیش‌فرض آن \fI$XDG_CONFIG_HOME/wireshark\fP است (یا اگر آن دایرکتوری وجود نداشته باشد اما \fI$HOME/.wireshark\fP وجود داشته باشد، \fI$HOME/.wireshark\fP)؛ این مسیر معمولاً \fI$HOME/.config/wireshark\fP است. در Windows، مقدار پیش‌فرض آن \fI%APPDATA%\(rsWireshark\fP است (یا اگر %APPDATA% تعریف نشده باشد، \fI%USERPROFILE%\(rsApplication Data\(rsWireshark\fP). از نسخه Wireshark 3.0 در دسترس است. .RE .sp WIRESHARK_DEBUG_WMEM_OVERRIDE .RS 4 .sp تنظیم این متغیر محیطی چارچوب wmem را وادار می‌کند تا برای \fBall\fP تخصیص‌ها از بک‌اند تخصیص‌دهنده حافظه مشخص‌شده استفاده کند، صرف‌نظر از اینکه کدام بک‌اند به طور معمول توسط کد تعیین شده است. این قابلیت عمدتاً برای توسعه‌دهندگان هنگام آزمایش یا اشکال‌زدایی مفید است. برای جزئیات به \fIREADME.wmem\fP در توزیع سورس کد مراجعه کنید. .RE .sp WIRESHARK_RUN_FROM_BUILD_DIRECTORY .RS 4 .sp این متغیر محیطی باعث می‌شود پلاگین‌ها و سایر فایل‌های داده به جای مکان‌های استاندارد، از دایرکتوری ساخت (جایی که برنامه کامپایل شده است) بارگذاری شوند. هنگامی که برنامه مورد نظر با دسترسی‌های root (یا setuid) در سیستم‌های سازگار با UNIX مانند Linux، macOS، \(rs*BSD، Solaris و AIX اجرا می‌شود، این متغیر هیچ تاثیری ندارد. .RE .sp WIRESHARK_DATA_DIR .RS 4 .sp این متغیر محیطی باعث می‌شود فایل‌های داده گوناگون از دایرکتوری دیگری غیر از مکان‌های استاندارد بارگذاری شوند. هنگامی که برنامه مورد نظر با دسترسی‌های root (یا setuid) در سیستم‌های سازگار با UNIX اجرا می‌شود، هیچ تاثیری ندارد. .RE .sp ERF_RECORDS_TO_CHECK .RS 4 .sp این متغیر محیطی تعداد رکوردهای ERF بررسی‌شده را هنگام تصمیم‌گیری درباره اینکه آیا فایل واقعاً در قالب ERF است یا خیر کنترل می‌کند. تنظیم این متغیر محیطی روی عددی بالاتر از مقدار پیش‌فرض (20)، احتمال موارد مثبت کاذب را کاهش می‌دهد. .RE .sp IPFIX_RECORDS_TO_CHECK .RS 4 .sp این متغیر محیطی تعداد رکوردهای IPFIX بررسی‌شده را هنگام تصمیم‌گیری درباره اینکه آیا فایل واقعاً در قالب IPFIX است یا خیر کنترل می‌کند. تنظیم این متغیر محیطی روی عددی بالاتر از مقدار پیش‌فرض (20)، احتمال موارد مثبت کاذب را کاهش می‌دهد. .RE .sp WIRESHARK_ABORT_ON_DISSECTOR_BUG .RS 4 .sp در صورت تنظیم این متغیر محیطی، \fBRawshark\fP هنگام برخورد با باگ در کالبدشکاف، abort(3) را فراخوانی می‌کند. فراخوانی abort(3) موجب خروج غیرعادی برنامه خواهد شد؛ اگر \fBRawshark\fP را درون یک دیباگر اجرا می‌کنید، برنامه باید درون دیباگر متوقف شده و امکان بازرسی فرآیند را فراهم کند، و اگر آن را درون دیباگر اجرا نمی‌کنید، در برخی سیستم‌عامل‌ها (به شرط پیکربندی صحیح محیط شما) یک فایل core dump تولید خواهد شد. این امر می‌تواند برای توسعه‌دهندگانی که در تلاش برای عیب‌یابی مشکلی در یک کالبدشکاف پروتکل هستند مفید باشد. .RE .sp WIRESHARK_ABORT_ON_TOO_MANY_ITEMS .RS 4 .sp در صورت تنظیم این متغیر محیطی، اگر کالبدشکاف تلاش کند موارد بیش از حدی را به یک درخت اضافه کند، \fBRawshark\fP اقدام به فراخوانی abort(3) خواهد کرد (معمولاً این امر نشانه خارج نشدن به موقع کالبدشکاف از یک حلقه است). فراخوانی abort(3) موجب خروج غیرعادی برنامه خواهد شد؛ اگر \fBRawshark\fP را درون یک دیباگر اجرا می‌کنید، برنامه باید درون دیباگر متوقف شده و امکان بازرسی فرآیند را فراهم کند، و اگر آن را درون دیباگر اجرا نمی‌کنید، در برخی سیستم‌عامل‌ها (به شرط پیکربندی صحیح محیط شما) یک فایل core dump تولید خواهد شد. این امر می‌تواند برای توسعه‌دهندگانی که در تلاش برای عیب‌یابی مشکلی در یک کالبدشکاف پروتکل هستند مفید باشد. .RE .SH "همچنین ببینید (SEE ALSO)" .sp wireshark\-filter(4), wireshark(1), tshark(1), editcap(1), pcap(3), dumpcap(1), text2pcap(1), pcap\-filter(7) یا tcpdump(8) .SH "نکات (NOTES)" .sp این صفحه راهنما مربوط به \fBRawshark\fP 4.7.3 است. \fBRawshark\fP بخشی از توزیع \fBWireshark\fP است. آخرین نسخه \fBWireshark\fP را می‌توانید در اینجا بیابید: \c .URL "https://www.wireshark.org" "" "." .sp نسخه‌های HTML صفحات راهنمای پروژه Wireshark در این نشانی در دسترس هستند: .URL "https://www.wireshark.org/docs/man\-pages" "" "." .SH "نویسندگان (AUTHORS)" .sp \fBRawshark\fP از همان کد کالبدشکافی بسته که در \fBWireshark\fP وجود دارد استفاده می‌کند، همچنین از بسیاری از ماژول‌های دیگر \fBWireshark\fP بهره می‌برد؛ برای مشاهده فهرست نویسندگان این کد، فهرست نویسندگان را در صفحه راهنمای \fBWireshark\fP ببینید.