'\" t .\" Title: dumpcap .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-09-03 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "DUMPCAP" "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)" dumpcap \- ضبط ترافیک شبکه .SH "خلاصه دستور (SYNOPSIS)" .sp \fBdumpcap\fP [\~\fB\-a\fP|\fB\-\-autostop\fP\~\~]\~.\|.\|. [\~\fB\-b\fP|\fB\-\-ring\-buffer\fP\~\~]\~.\|.\|. [\~\fB\-B\fP|\fB\-\-buffer\-size\fP\~\~] [\~\fB\-c\fP\~\~] [\~\fB\-C\fP\~\~] [\~\fB\-d\fP\~] [\~\fB\-D\fP|\fB\-\-list\-interfaces\fP\~] [\~\fB\-f\fP\~\~] [\~\fB\-F\fP\~\~] [\~\fB\-g\fP\~] [\~\fB\-i\fP|\fB\-\-interface\fP\~|rpcap://:/|\-\~] [\~\fB\-I\fP|\fB\-\-monitor\-mode\fP\~] [\~\fB\-k\fP\~,[],[],[]\~] [\~\fB\-L\fP|\fB\-\-list\-data\-link\-types\fP\~] [\~\fB\-M\fP\~] [\~\fB\-n\fP\~] [\~\fB\-N\fP\~\~] [\~\fB\-p\fP|\fB\-\-no\-promiscuous\-mode\fP\~] [\~\fB\-\-ifdescr\fP\~\~] [\~\fB\-\-ifname\fP\~\~] [\~\fB\-P\fP\~] [\~\fB\-q\fP\~] [\~\fB\-Q\fP\~] [\~\fB\-s\fP|\fB\-\-snapshot\-length\fP\~\~] [\~\fB\-S\fP\~] [\~\fB\-t\fP\~] [\~\fB\-\-temp\-dir\fP\~\~] [\~\fB\-w\fP\~\~] [\~\fB\-y\fP|\fB\-\-linktype\fP\~\~] [\~\fB\-\-application\-flavor\fP\~[wireshark|stratoshark]\~] [\~\fB\-\-capture\-comment\fP\~\~] [\~\fB\-\-list\-time\-stamp\-types\fP\~] [\~\fB\-\-no\-optimize\fP\~] [\~\fB\-\-time\-stamp\-type\fP\~\~] [\~\fB\-\-update\-interval\fP\~\~] .sp \fBdumpcap\fP \fB\-h|\-\-help\fP .sp \fBdumpcap\fP \fB\-v|\-\-version\fP .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBDumpcap\fP ابزاری برای ضبط ترافیک شبکه است. این ابزار امکان ضبط داده‌های بسته‌ها را از یک شبکهٔ زنده و نوشتن آن‌ها در یک فایل فراهم می‌کند. قالب پیش‌فرض فایل ضبط در \fBDumpcap\fP قالب \fBpcapng\fP است. با مشخص کردن گزینهٔ \fB\-F\fP می‌توان فایل خروجی را در قالب \fBpcap\fP ذخیره کرد. .sp بدون تنظیم هیچ گزینه‌ای، این ابزار از کتابخانهٔ libpcap یا Npcap برای ضبط ترافیک از نخستین رابط شبکهٔ در دسترس استفاده کرده و داده‌های خام بسته‌های دریافت‌شده را به همراه برچسب زمانی آن‌ها در یک فایل ضبط می‌نویسد. .sp اگر گزینهٔ \fB\-w\fP مشخص نشده باشد، \fBDumpcap\fP در یک فایل ضبط تازه‌ساخته‌شده با نامی تصادفی می‌نویسد. اگر گزینهٔ \fB\-w\fP مشخص شده باشد، \fBDumpcap\fP درون فایلی که توسط آن گزینه تعیین شده است می‌نویسد. .sp عملیات ضبط بسته‌ها توسط کتابخانهٔ pcap انجام می‌شود. نحو فیلتر ضبط از قوانین کتابخانهٔ pcap پیروی می‌کند..SH "گزینه‌ها (OPTIONS)" .sp \-a|\-\-autostop .RS 4 .sp معیاری را تعیین می‌کند که مشخص می‌سازد چه زمانی \fBDumpcap\fP باید نوشتن در فایل ضبط را متوقف کند. این معیار به صورت \fItest:value\fP است، که در آن \fItest\fP یکی از موارد زیر است: .sp \fBduration\fP:\fIvalue\fP توقف نوشتن در فایل ضبط پس از سپری شدن \fIvalue\fP ثانیه. مقادیر ممیز شناور (مانند 0.5) مجاز هستند. .sp \fBfiles\fP:\fIvalue\fP توقف نوشتن در فایل‌های ضبط پس از نوشته شدن تعداد \fIvalue\fP فایل. .sp \fBfilesize\fP:\fIvalue\fP توقف نوشتن در فایل ضبط پس از رسیدن اندازه آن به \fIvalue\fP کیلوبایت (kB). اگر این گزینه همراه با گزینه \-b استفاده شود، dumpcap با رسیدن به این اندازه فایل، نوشتن در فایل فعلی را متوقف کرده و به فایل بعدی منتقل می‌شود. توجه داشته باشید که اندازه فایل به حداکثر مقدار 2 TB محدود است. .sp \fBpackets\fP:\fIvalue\fP توقف نوشتن در فایل ضبط پس از نوشته شدن \fIvalue\fP بسته. عملکردی مشابه \fB\-c\fP دارد. .RE .sp \-b|\-\-ring\-buffer .RS 4 .sp باعث می‌شود \fBDumpcap\fP در حالت «چند فایلی» (multiple files) اجرا شود. در حالت «چند فایلی»، \fBDumpcap\fP در چندین فایل ضبط می‌نویسد. هنگامی که نخستین فایل ضبط پر شود، \fBDumpcap\fP نوشتن را به فایل بعدی منتقل می‌کند و به همین ترتیب ادامه می‌دهد. .sp نام‌های فایل ایجادشده بر اساس نام فایل ارائه‌شده با گزینه \fB\-w\fP، شماره فایل و تاریخ و زمان ایجاد هستند؛ مانند: outfile_00001_20260714120117.pcapng، outfile_00002_20260714120523.pcapng، .\|.\|. .sp با گزینه \fIfiles\fP همچنین می‌توان یک «بافر حلقه‌ای» (ring buffer) تشکیل داد. این کار فایل‌های جدید را تا رسیدن به تعداد فایل‌های مشخص‌شده پر می‌کند، و در آن نقطه \fBDumpcap\fP داده‌های نخستین فایل را دور ریخته و شروع به نوشتن در آن فایل می‌کند و این روند ادامه می‌یابد. اگر گزینه \fIfiles\fP تنظیم نشده باشد، فایل‌های جدید پر می‌شوند تا زمانی که یکی از شرایط توقف ضبط محقق شود (یا دیسک پر شود). .sp این معیار به صورت \fIkey:value\fP است، که در آن \fIkey\fP یکی از موارد زیر است: .sp \fBduration\fP:\fIvalue\fP رفتن به فایل بعدی پس از سپری شدن \fIvalue\fP ثانیه، حتی اگر فایل فعلی کاملاً پر نشده باشد. مقادیر ممیز شناور (مانند 0.5) مجاز هستند. .sp \fBfiles\fP:\fIvalue\fP شروع دوباره از نخستین فایل پس از نوشته شدن تعداد \fIvalue\fP فایل (تشکیل بافر حلقه‌ای). این مقدار باید کمتر از 100000 باشد. در هنگام استفاده از تعداد زیادی فایل باید احتیاط کرد: برخی سیستم‌های فایل با وجود فایل‌های بسیار در یک دایرکتوری منفرد به خوبی کنار نمی‌آیند. معیار \fBfiles\fP مستلزم تعیین \fBduration\fP، \fBinterval\fP یا \fBfilesize\fP است تا زمان رفتن به فایل بعدی کنترل شود. لازم به ذکر است که هر پارامتر \fB\-b\fP دقیقاً یک معیار دریافت می‌کند؛ برای تعیین دو معیار، هر یک باید با یک گزینه \fB\-b\fP مجزا آورده شوند. .sp \fBfilesize\fP:\fIvalue\fP رفتن به فایل بعدی پس از رسیدن حجم آن به \fIvalue\fP کیلوبایت (kB). توجه داشته باشید که اندازه فایل به حداکثر مقدار 2 TB محدود است. .sp \fBinterval\fP:\fIvalue\fP رفتن به فایل بعدی هنگامی که زمان دقیقاً مضربی از \fIvalue\fP ثانیه باشد. برای نمونه، از 3600 برای جابجایی به یک فایل جدید در رأس هر ساعت استفاده کنید. .sp \fBpackets\fP:\fIvalue\fP رفتن به فایل بعدی پس از اینکه شامل \fIvalue\fP بسته شد. .sp \fBprintname\fP:\fIfilename\fP چاپ نام آخرین فایل نوشته‌شده در \fIfilename\fP پس از بسته شدن فایل. \fIfilename\fP می‌تواند \f(CRstdout\fP یا \f(CR\-\fP برای خروجی استاندارد، یا \f(CRstderr\fP برای خطای استاندارد باشد. .sp مثال: \fB\-b filesize:1000 \-b files:5\fP منجر به یک بافر حلقه‌ای متشکل از پنج فایل با حجم هر کدام یک مگابایت می‌شود. .RE .sp \-B|\-\-buffer\-size .RS 4 .sp تنظیم اندازه بافر ضبط (بر حسب MiB، پیش‌فرض ۲ مبی‌بایت است). این گزینه توسط درایور ضبط برای بافر کردن داده‌های بسته استفاده می‌شود تا زمانی که بتوان داده‌ها را روی دیسک نوشت. اگر در حین ضبط با افت بسته (packet drop) مواجه شدید، سعی کنید این اندازه را افزایش دهید. توجه داشته باشید، در حالی که \fBDumpcap\fP به طور پیش‌فرض تلاش می‌کند اندازه بافر را روی ۲ مبی‌بایت تنظیم کند و می‌توان آن را برای مقادیر بزرگ‌تر تنظیم کرد، اما سیستم یا رابطی که روی آن در حال ضبط هستید ممکن است بدون هشدار، اندازه بافر ضبط را به مقدار کمتری محدود کند یا آن را به مقدار بیشتری افزایش دهد. .sp این ویژگی در سیستم‌های سازگار با UNIX، مانند Linux، macOS، \(rs*BSD، Solaris و AIX، با libpcap نسخه 1.0.0 یا جدیدتر و در Windows در دسترس است. در سیستم‌های سازگار با UNIX با نسخه‌های قدیمی‌تر libpcap در دسترس نیست. .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینه \fB\-i\fP استفاده شود، اندازه بافر پیش‌فرض ضبط را تنظیم می‌کند. اگر پس از یک گزینه \fB\-i\fP استفاده شود، اندازه بافر ضبط را برای رابطی که با آخرین گزینه \fB\-i\fP پیش از این گزینه مشخص شده است، تنظیم می‌کند. اگر اندازه بافر ضبط به طور خاص تعیین نشده باشد، در عوض از اندازه بافر پیش‌فرض ضبط استفاده می‌شود. .RE .sp \-c .RS 4 تنظیم حداکثر تعداد بسته‌ها برای خواندن در هنگام ضبط زنده داده‌ها. عملکردی مشابه \fB\-a packets:\fP دارد. .RE .sp \-C .RS 4 محدود کردن میزان حافظه به بایت که برای ذخیره بسته‌های ضبط‌شده در حافظه هنگام پردازش استفاده می‌شود. اگر همراه با گزینه \fB\-N\fP استفاده شود، هر دو محدودیت اعمال خواهند شد. تنظیم این محدودیت، استفاده از ریسه (thread) مجزا به ازای هر رابط را فعال می‌کند. .RE .sp \-d .RS 4 کد تولیدشده برای فیلتر(های) ضبط را در قالبی خوانا برای انسان برون‌ریزی (dump) کرده و خارج می‌شود. در صورت ضبط روی چندین رابط، فیلتر ضبط برای هر رابط به ترتیبی که رابط‌ها تعیین شده‌اند چاپ خواهد شد. (توجه داشته باشید که ممکن است یک فیلتر ضبط روی رابط‌های گوناگون به صورت متفاوتی کامپایل شود.) .RE .sp \-D|\-\-list\-interfaces .RS 4 فهرستی از رابط‌هایی که \fBDumpcap\fP می‌تواند روی آن‌ها ضبط انجام دهد را چاپ کرده و خارج می‌شود. برای هر رابط شبکه، یک شماره و یک نام رابط، و در صورت وجود توضیحی متنی از رابط، چاپ می‌شود. نام رابط یا شماره را می‌توان به پرچم \fB\-i\fP داد تا رابطی که قرار است ضبط روی آن انجام شود تعیین گردد. شماره رابط می‌تواند در سیستم‌های Windows که رابط‌ها دارای نام‌های طولانی و معمولاً حاوی یک GUID هستند، مفید باشد. .RE .sp \-f .RS 4 .sp تنظیم عبارت فیلتر ضبط. .sp کل عبارت فیلتر باید به عنوان یک آرگومان واحد مشخص شود (بدین معنی که اگر شامل فاصله است، باید درون نقل‌قول قرار گیرد). .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینه \fB\-i\fP استفاده شود، عبارت فیلتر پیش‌فرض ضبط را تعیین می‌کند. اگر پس از یک گزینه \fB\-i\fP استفاده شود، عبارت فیلتر ضبط را برای رابطی که با آخرین گزینه \fB\-i\fP پیش از این گزینه مشخص شده است، تنظیم می‌کند. اگر عبارت فیلتر ضبط به طور خاص تعیین نشده باشد، در صورت ارائه، از عبارت فیلتر پیش‌فرض ضبط استفاده می‌شود. .RE .sp \-F .RS 4 تنظیم قالب فایل خروجی ضبط که با استفاده از گزینه \fB\-w\fP نوشته می‌شود. در شرایطی که قالب \fBpcapng\fP الزامی است، مانند ضبط از چندین رابط، این گزینه نادیده گرفته خواهد شد. گزینه \fB\-F\fP بدون مقدار، قالب‌های موجود را فهرست می‌کند. پیش‌فرض، قالب \fBpcapng\fP است. .RE .sp قالب‌های کمتری نسبت به tshark(1) پشتیبانی می‌شوند؛ این امر به دلایل امنیتی عامدانه است. اگر به قالب دیگری نیاز است، از \fBtshark\fP استفاده کنید یا ابتدا بسته‌ها را ضبط کرده و سپس فایل را با editcap(1) تبدیل نمایید. .sp \-g .RS 4 این گزینه باعث می‌شود فایل(های) خروجی با مجوز خواندن توسط گروه (group\-read) ایجاد شوند (بدین معنی که فایل(های) خروجی می‌توانند توسط سایر اعضای گروه کاربری فراخوانده‌شده خوانده شوند). .RE .sp \-h|\-\-help .RS 4 چاپ شماره نسخه و گزینه‌ها و سپس خروج. .RE .sp \-i|\-\-interface |rpcap://:/|\- .RS 4 .sp تنظیم نام رابط شبکه یا پایپ (pipe) برای استفاده در ضبط زنده بسته‌ها..sp نام‌های رابط شبکه باید با یکی از نام‌های فهرست‌شده در «\fBtshark \-D\fP» (توضیح داده شده در بالا) مطابقت داشته باشند؛ همچنین می‌توان از یک شماره، همان‌طور که توسط «\fBdumpcap \-D\fP» گزارش می‌شود، استفاده کرد. .sp اگر هیچ رابطی مشخص نشود، \fBDumpcap\fP فهرست رابط‌ها را جستجو می‌کند، و در صورت وجود هرگونه رابط غیر لوپ‌بک (non\-loopback)، نخستین رابط غیر لوپ‌بک را برمی‌گزیند، و اگر هیچ رابط غیر لوپ‌بکی وجود نداشته باشد، نخستین رابط لوپ‌بک را انتخاب می‌کند. اگر اصلاً هیچ رابطی وجود نداشته باشد، \fBDumpcap\fP خطایی را گزارش کرده و ضبط را آغاز نمی‌کند. .sp نام‌های لوله (pipe) باید یا نام یک FIFO (لوله نام‌گذاری‌شده) باشد یا «\-» برای خواندن داده‌ها از ورودی استاندارد (standard input). در سیستم‌های ویندوز، نام‌های لوله باید به شکل «\(rs\(rs.\(rspipe\(rs\fBpipename\fP» باشند. داده‌های خوانده‌شده از لوله‌ها باید در قالب استاندارد pcapng یا pcap باشند. داده‌های pcapng باید ترتیبی از بایت‌ها (endianness) یکسان با میزبان ضبط‌کننده داشته باشند. .sp این گزینه می‌تواند چندین بار تکرار شود. هنگام ضبط از چندین رابط، فایل ضبط در قالب pcapng ذخیره خواهد شد، حتی اگر \fB\-P\fP مشخص شده باشد. .RE .sp \-\-ifdescr .RS 4 استفاده از \fIdescription\fP به عنوان شرح در فایل ضبط برای رابط یا لوله‌ای که قبل از آن با \fB\-i\fP مشخص شده است. .RE .sp \-\-ifname .RS 4 استفاده از \fIname\fP به عنوان نام در فایل ضبط برای رابط یا لوله‌ای که قبل از آن با \fB\-i\fP مشخص شده است. .RE .sp \-I|\-\-monitor\-mode .RS 4 .sp قرار دادن رابط در «حالت پایش» (monitor mode)؛ این قابلیت تنها روی رابط‌های Wi\-Fi با استاندارد IEEE 802.11 و تنها روی برخی سیستم‌عامل‌ها پشتیبانی می‌شود. .sp توجه داشته باشید که در حالت پایش ممکن است آداپتور از شبکه‌ای که به آن متصل است جدا شود، به‌طوری که نتوانید از هیچ شبکه بی‌سیمی با آن آداپتور استفاده کنید. این امر در صورتی که در حالت پایش ضبط می‌کنید و با آداپتور دیگری به شبکه متصل نیستید، می‌تواند از دسترسی به فایل‌های روی یک سرور شبکه یا تحلیل نام‌های میزبان یا نشانی‌های شبکه جلوگیری کند. .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینه \fB\-i\fP استفاده شود، حالت پایش را برای همه رابط‌ها فعال می‌کند. اگر پس از یک گزینه \fB\-i\fP استفاده شود، حالت پایش را برای رابط مشخص‌شده توسط آخرین گزینه \fB\-i\fP قبل از این گزینه فعال می‌کند. .RE .sp \-k ,[],[],[> .RS 4 .sp تنظیم کانال روی رابط؛ این قابلیت تنها روی رابط‌های Wi\-Fi با استاندارد IEEE 802.11 و تنها روی برخی سیستم‌عامل‌ها پشتیبانی می‌شود. .sp مقدار \fIfreq\fP فرکانس کانال است. \fItype\fP نوع کانال برای 802.11n و بالاتر است. مقادیر مجاز برای \fItype\fP عبارت‌اند از: .RE .sp NOHT .RS 4 برای کانال‌های 802.11b/g استفاده می‌شود .RE .sp HT20 .RS 4 کانال ۲۰ مگاهرتز (20 MHz) .RE .sp HT40\- .RS 4 کانال اصلی ۴۰ مگاهرتز و یک کانال فرعی پایین‌تر .RE .sp HT40+ .RS 4 کانال اصلی ۴۰ مگاهرتز و یک کانال فرعی بالاتر .RE .sp HE40 .RS 4 کانال ۴۰ مگاهرتز، با \fIcenterfreq1\fP به عنوان فرکانس مرکزی آن .RE .sp HT80 .RS 4 کانال ۸۰ مگاهرتز، با \fIcenterfreq1\fP به عنوان فرکانس مرکزی آن .RE .sp VHT80+80 .RS 4 دو کانال ۸۰ مگاهرتزی ترکیب‌شده، با \fIcenterfreq1\fP و \fIcenterfreq2\fP به عنوان فرکانس‌های مرکزی دو کانال .RE .sp VHT160 .RS 4 کانال ۱۶۰ مگاهرتز، با \fIcenterfreq1\fP به عنوان فرکانس مرکزی آن .RE .sp EHT320 .RS 4 کانال ۳۲۰ مگاهرتز، با \fIcenterfreq1\fP به عنوان فرکانس مرکزی آن .RE .sp \-L|\-\-list\-data\-link\-types .RS 4 فهرست کردن انواع پیوند داده (data link) پشتیبانی‌شده توسط رابط و خروج. انواع پیوند گزارش‌شده می‌توانند برای گزینه \fB\-y\fP استفاده شوند. .RE .sp \-M .RS 4 .sp هنگامی که به همراه \fB\-D\fP، \fB\-L\fP، \fB\-S\fP یا \fB\-\-list\-time\-stamp\-types\fP استفاده شود، خروجی ماشین‌خوان چاپ می‌کند. خروجی ماشین‌خوان برای خوانده شدن توسط \fBWireshark\fP و \fBTShark\fP در نظر گرفته شده است؛ قالب آن ممکن است از نسخه‌ای به نسخه دیگر تغییر کند. .RE .sp \-n .RS 4 ذخیره فایل‌ها در قالب pcapng. این حالت پیش‌فرض است. این گزینه منسوخ شده است و ممکن است حذف شود. .RE .sp \-N .RS 4 .sp محدود کردن تعداد بسته‌های مورد استفاده برای نگهداری بسته‌های ضبط‌شده در حافظه حین پردازش آن. اگر در ترکیب با گزینه \fB\-C\fP استفاده شود، هر دو محدودیت اعمال خواهند شد. تنظیم این محدودیت، استفاده از ریسه (thread) جداگانه را برای هر رابط فعال می‌کند. .RE .sp \-p|\-\-no\-promiscuous\-mode .RS 4 .sp رابط در حالت بی‌قید (promiscuous mode) قرار \fIداده نشود\fP. توجه داشته باشید که رابط ممکن است به دلایل دیگری در حالت بی‌قید باشد؛ از این رو، نمی‌توان از \fB\-p\fP برای اطمینان از اینکه تنها ترافیک ضبط‌شده شامل ترافیک ارسالی به یا از ماشینی است که \fBDumpcap\fP روی آن اجرا می‌شود، ترافیک برودکست (پخش همگانی)، و ترافیک چندپخشی (multicast) به نشانی‌های دریافت شده توسط آن ماشین است، استفاده کرد. .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینه \fB\-i\fP استفاده شود، هیچ رابطی در حالت بی‌قید قرار نخواهد گرفت. اگر پس از یک گزینه \fB\-i\fP استفاده شود، رابط مشخص‌شده توسط آخرین گزینه \fB\-i\fP پیش از این گزینه در حالت بی‌قید قرار نخواهد گرفت. .RE .sp \-P .RS 4 ذخیره فایل‌ها به عنوان pcap به جای پیش‌فرض pcapng. در شرایطی که به pcapng نیاز است، مانند ضبط از چندین رابط، این گزینه نادیده گرفته خواهد شد. این گزینه به نفع گزینه \fB\-F\fP منسوخ شده است و ممکن است حذف شود. .RE .sp \-q .RS 4 .sp هنگام ضبط بسته‌ها، شمارش مداوم بسته‌های ضبط‌شده که معمولاً هنگام ذخیره ضبط در یک فایل نشان داده می‌شود نمایش داده نشود؛ در عوض، فقط در انتهای ضبط، تعداد بسته‌های ضبط‌شده نمایش داده شود. در سیستم‌هایی که از سیگنال SIGINFO پشتیبانی می‌کنند، مانند BSDهای گوناگون، می‌توانید با وارد کردن نویسه «status» خود (به‌طور معمول control\-T، اگرچه ممکن است حداقل در برخی از BSDها به‌طور پیش‌فرض روی «غیرفعال» تنظیم شده باشد، بنابراین برای استفاده از آن باید آن را به‌طور صریح تنظیم کنید)، باعث نمایش تعداد فعلی شوید. .RE .sp \-Q .RS 4.sp هنگام ضبط بسته‌ها، پیام اولیهٔ مشخص‌کنندهٔ رابط‌هایی که ضبط روی آن‌ها انجام می‌شود، پیام‌های مشخص‌کنندهٔ فایلی که ضبط در آن نوشته می‌شود، شمارش مداوم بسته‌های ضبط‌شده که معمولاً هنگام ذخیرهٔ ضبط در یک فایل نشان داده می‌شود، و پیام پایان ضبط مبنی بر تعداد بسته‌های ضبط‌شده، روی خطای استاندارد نمایش داده نمی‌شوند. این خروجی کمتری نسبت به گزینهٔ \fB\-q\fP تولید می‌کند؛ فقط خطاهای واقعی روی خطای استاندارد نمایش داده می‌شوند. .sp در سیستم‌هایی که از سیگنال SIGINFO پشتیبانی می‌کنند، مانند BSDهای مختلف، می‌توانید با فشردن نویسهٔ «وضعیت» خود (معمولاً control\-T، اگرچه ممکن است دست‌کم در برخی از BSDها به‌طور پیش‌فرض روی «disabled» تنظیم شده باشد، بنابراین برای استفاده از آن باید به‌طور صریح تنظیمش کنید) باعث نمایش تعداد فعلی شوید. .RE .sp \-s|\-\-snapshot\-length .RS 4 .sp طول اسنپ‌شات (snapshot length) پیش‌فرض را برای استفاده هنگام ضبط داده‌های زنده تنظیم می‌کند. بیش از \fIsnaplen\fP بایت از هر بستهٔ شبکه در حافظه خوانده نمی‌شود، یا روی دیسک ذخیره نمی‌شود. مقدار 0 طول اسنپ‌شات را 262144 تعیین می‌کند تا تمام بسته ضبط شود؛ این مقدار پیش‌فرض است. .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینهٔ \fB\-i\fP استفاده شود، طول اسنپ‌شات پیش‌فرض را تنظیم می‌کند. اگر پس از یک گزینهٔ \fB\-i\fP استفاده شود، طول اسنپ‌شات را برای رابط مشخص‌شده توسط آخرین گزینهٔ \fB\-i\fP پیش از این گزینه تنظیم می‌کند. اگر طول اسنپ‌شات به‌طور خاص تعیین نشده باشد، طول اسنپ‌شات پیش‌فرض (در صورت ارائه) استفاده می‌شود. .RE .sp \-S .RS 4 آمار هر رابط را در هر ثانیه یک‌بار چاپ می‌کند. .RE .sp \-t .RS 4 از یک ریسه (thread) جداگانه برای هر رابط استفاده می‌کند. .RE .sp \-\-temp\-dir .RS 4 .sp دایرکتوری را مشخص می‌کند که فایل‌های موقت (شامل فایل‌های ضبط) باید در آن نوشته شوند. رفتار پیش‌فرض در سیستم‌های سازگار با UNIX، مانند Linux، macOS، \(rs*BSD، Solaris و AIX، استفاده از متغیر محیطی \fI$TMPDIR\fP در صورت تنظیم بودن، و در غیر این صورت پیش‌فرض سیستم، یعنی معمولاً \fI/tmp\fP است. در Windows، متغیر محیطی \fI%TEMP%\fP استفاده می‌شود که معمولاً به‌طور پیش‌فرض \fI%USERPROFILE%\(rsAppData\(rsLocal\(rsTemp\fP است. .RE .sp \-v|\-\-version .RS 4 اطلاعات کامل نسخه را چاپ کرده و خارج می‌شود. .RE .sp \-w .RS 4 داده‌های خام بسته را در \fIoutfile\fP می‌نویسد. برای stdout از «\-» استفاده کنید. .RE .sp \-y|\-\-linktype .RS 4 .sp نوع پیوند داده (data link type) را برای استفاده هنگام ضبط بسته‌ها تنظیم می‌کند. مقادیر گزارش‌شده توسط \fB\-L\fP مقادیری هستند که می‌توان استفاده کرد. .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینهٔ \fB\-i\fP استفاده شود، نوع پیوند ضبط پیش‌فرض را تعیین می‌کند. اگر پس از یک گزینهٔ \fB\-i\fP استفاده شود، نوع پیوند ضبط را برای رابط مشخص‌شده توسط آخرین گزینهٔ \fB\-i\fP پیش از این گزینه تنظیم می‌کند. اگر نوع پیوند ضبط به‌طور خاص تعیین نشده باشد، نوع پیوند ضبط پیش‌فرض (در صورت ارائه) استفاده می‌شود. .RE .sp \-\-application\-flavor [wireshark|stratoshark] .RS 4 حالت کاربرد (application flavor) را تنظیم می‌کند. خروجی گزینهٔ \fB\-D\fP و سایر رفتارها را برای ضبط بسته یا ضبط فراخوانی‌های سیستم و لاگ مناسب می‌سازد. حالت پیش‌فرض «wireshark» است. .RE .sp \-\-capture\-comment .RS 4 .sp در صورت پشتیبانی قالب فایل خروجی، یک یادداشت ضبط به فایل خروجی اضافه می‌کند. .sp این گزینه تنها در صورتی در دسترس است که بسته‌های ضبط‌شده را در یک فایل تکی ذخیره کنیم. .sp این گزینه ممکن است چندین بار مشخص شود. توجه داشته باشید که Wireshark در حال حاضر تنها نخستین یادداشت یک فایل ضبط را نمایش می‌دهد. .RE .sp \-\-list\-time\-stamp\-types .RS 4 انواع برچسب زمانی (timestamp) پشتیبانی‌شده توسط رابط را فهرست می‌کند. اگر هیچ نوع برچسب زمانی قابل تنظیم نباشد، هیچ نوعی فهرست نمی‌شود. .RE .sp \-\-no\-optimize .RS 4 هنگام تولید کد برای فیلتر ضبط، بهینه‌ساز libpcap را اجرا نمی‌کند. این گزینه در صورت مشکوک بودن به وجود باگ در بهینه‌ساز یا برای اهداف آموزشی مفید است. .RE .sp این گزینه می‌تواند چندین بار تکرار شود. اگر پیش از نخستین رخداد گزینهٔ \fB\-i\fP استفاده شود، فیلترهای ضبط برای همهٔ رابط‌ها بهینه‌سازی نمی‌شوند. اگر پس از یک گزینهٔ \fB\-i\fP استفاده شود، فیلتر ضبط برای رابط مشخص‌شده توسط آخرین گزینهٔ \fB\-i\fP پیش از این گزینه بهینه‌سازی نمی‌شود. .sp \-\-time\-stamp\-type .RS 4 روش برچسب زمانی رابط را تغییر می‌دهد. .RE .sp \-\-update\-interval .RS 4 مدت زمان بین گزارش‌های بسته‌های جدید را در طول ضبط بر حسب میلی‌ثانیه تنظیم می‌کند. همچنین دقت شرایط مدت زمان فایل را تعیین می‌کند. مقدار پیش‌فرض 100ms است. .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 "ساختار فیلتر ضبط (CAPTURE FILTER SYNTAX)" .sp مراجعه کنید به صفحه راهنمای pcap\-filter(7) یا، در صورت عدم وجود آن، tcpdump(8)، یا، اگر آن هم وجود نداشت، به \c .URL "https://gitlab.com/wireshark/wireshark/\-/wikis/CaptureFilters" "" "." .SH "همچنین ببینید (SEE ALSO)" .sp wireshark(1), tshark(1), editcap(1), mergecap(1), capinfos(1), pcap(3), pcap\-filter(7) یا tcpdump(8) .SH "نکات (NOTES)" .sp این صفحه راهنما برای \fBDumpcap\fP 4.7.3 است. \fBDumpcap\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 \fBDumpcap\fP از کد موتور ضبط \fBWireshark\fP مشتق شده است؛ برای مشاهده فهرست نویسندگان آن کد، به فهرست نویسندگان در صفحه راهنمای \fBWireshark\fP مراجعه کنید.