CAPINFOS(1)   CAPINFOS(1)

capinfos - چاپ اطلاعات دربارهٔ فایل‌های ضبط ترافیک

capinfos [ -a ] [ -A ] [ -b ] [ -B ] [ -c ] [ -C ] [ -d ] [ -D ] [ -e ] [ -E ] [ -F ] [ -h ] [ -H ] [ -i ] [ -I ] [ -k ] [ -K ] [ -l ] [ -L ] [ -m ] [ -M ] [ -n ] [ -N ] [ -o ] [ -p ] [ -P ] [ -q ] [ -Q ] [ -r ] [ -R ] [ -s ] [ -S ] [ -t ] [ -T ] [ -u ] [ -v ] [ -x ] [ -y ] [ -z ] <infile> ...

capinfos -h|--help

capinfos -v|--version

برنامهٔ Capinfos یک یا چند فایل ضبط ترافیک (capture) را می‌خواند و بخشی از آمارها یا تمام اطلاعات (infos) موجود از هر <infile> را در یکی از دو قالب خروجی ارائه می‌دهد: بلند (long) یا جدول (table).

خروجی بلند برای خواندن توسط انسان مناسب است. خروجی جدول برای تولید گزارشی مفید است که به‌راحتی بتوان آن را در یک صفحه گسترده (spreadsheet) یا پایگاه داده وارد کرد.

کاربر نوع خروجی (بلند یا جدول) و آمارهای مورد نظر برای نمایش را با مشخص کردن پرچم‌ها (گزینه‌ها)یی متناظر با نوع گزارش و اطلاعات دلخواه تعیین می‌کند. اگر هیچ گزینه‌ای مشخص نشود، Capinfos تمام آمارهای در دسترس را در قالب «long» گزارش خواهد داد.

گزینه‌ها به ترتیب از چپ به راست پردازش می‌شوند و گزینه‌های بعدی جایگزین گزینه‌های قبلی شده یا به آن‌ها اضافه می‌شوند.

برنامهٔ Capinfos قادر به تشخیص و خواندن همان فایل‌های ضبط ترافیکی است که توسط Wireshark پشتیبانی می‌شوند. فایل‌های ورودی نیازی به پسوند نام فایل خاصی ندارند؛ قالب فایل و فشرده‌سازی اختیاری gzip، zstd یا lz4 به‌طور خودکار شناسایی خواهند شد. در نزدیکی ابتدای بخش «توضیحات (DESCRIPTION)» از wireshark(1) یا https://www.wireshark.org/docs/man-pages/wireshark.html توضیحات مفصلی دربارهٔ نحوهٔ مدیریت این موضوع توسط Wireshark آمده است، که Capinfos نیز به همان روش عمل می‌کند.

-a

برچسب زمانی (timestamp) نخستین بسته از نظر زمانی در فایل ضبط را نمایش می‌دهد. نخستین بسته از نظر زمانی لزوماً اولین بستهٔ ذخیره‌شده در فایل ضبط نیست - اگر بسته‌ها در فایل ضبط از نظر زمانی «نامرتب» (out-of-order) باشند، Capinfos این مورد را شناسایی می‌کند.

-A

تولید تمام اطلاعات. به‌طور پیش‌فرض Capinfos تمام مقادیر اطلاعاتی را برای هر فایل ورودی نمایش می‌دهد، اما فعال کردن هر یک از گزینه‌های نمایش انفرادی اطلاعات، گزینهٔ تولید همه را غیرفعال می‌کند.

-b

جداسازی اطلاعات با نویسه‌های فاصله ASCII SPACE (0x20). این گزینه تنها هنگام تولید گزارش سبک جدولی (-T) مفید است. مقادیر مختلف اطلاعات با یک نویسهٔ تکی فاصله ASCII از یکدیگر جدا (تحدید) خواهند شد.


نکته

از آنجا که برخی از برچسب‌های سرآیند و همچنین برخی از
فیلدهای مقادیر حاوی نویسهٔ فاصله هستند، این گزینه کاربرد محدودی دارد مگر اینکه یکی از گزینه‌های نقل‌قول (-q یا -Q) نیز مشخص شده باشد.

-B

جداسازی اطلاعات با نویسه‌های ASCII TAB. این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. مقادیر مختلف اطلاعات با یک نویسهٔ تکی ASCII TAB از یکدیگر جدا (تحدید) می‌شوند. هنگام فعال بودن گزارش به سبک -T، نویسهٔ TAB جداکنندهٔ پیش‌فرض است.

-c

تعداد بسته‌های موجود در فایل ضبط را نمایش می‌دهد.

-C

لغو پردازش هرگونه فایل اضافی در صورت بروز خطا در باز کردن یا خواندن یک فایل ورودی توسط Capinfos. به‌طور پیش‌فرض Capinfos حتی در صورت مواجهه با خطا هنگام باز کردن یا خواندن یک فایل، به پردازش فایل‌های دیگر ادامه می‌دهد.

نکته: در صورت بروز خطا در باز کردن یا خواندن یک فایل توسط Capinfos، صرف‌نظر از اینکه گزینهٔ -C مشخص شده باشد یا خیر، یک پیام خطا در stderr نوشته خواهد شد. در هنگام خروج، در صورت رخ دادن هرگونه خطا در حین پردازش، Capinfos یک وضعیت خطا برمی‌گرداند.

-d

مجموع طول تمام بسته‌های موجود در فایل را به بایت نمایش می‌دهد. این اندازهٔ بسته‌ها را به همان شکلی که در قالب اصلی خود بوده‌اند محاسبه می‌کند، نه آن‌گونه که در این فایل ظاهر شده‌اند. برای مثال، اگر بسته‌ای در ابتدا ۱۵۱۴ بایت بوده و تنها ۲۵۶ بایت از آن در فایل ضبط ذخیره شده باشد (مثلاً در صورت ضبط بسته‌ها با snaplen یا سایر گزینه‌های برش)، Capinfos اندازهٔ بسته را ۱۵۱۴ بایت در نظر می‌گیرد.

-D

تعداد کلیدهای رمزگشایی (decryption secrets) موجود در فایل را نمایش می‌دهد. این اطلاعات در قالب جدول در دسترس نیست.

-e

برچسب زمانی واپسین بسته از نظر زمانی در فایل ضبط را نمایش می‌دهد. واپسین بسته از نظر زمانی لزوماً آخرین بستهٔ ذخیره‌شده در فایل ضبط نیست
•اگر بسته‌ها در فایل ضبط از نظر زمانی «نامرتب» (out-of-order) باشند، Capinfos این موضوع را شناسایی می‌کند.

-E

نوع کپسوله‌سازی بر اساس هر فایل (per-file encapsulation) را برای فایل ضبط نمایش می‌دهد.

-F

اطلاعات تکمیلی فایل ضبط را نمایش می‌دهد.

-h|--help

چاپ شماره نسخه و گزینه‌ها و سپس خروج.

-H

هش‌های SHA256 و SHA1 را برای فایل نمایش می‌دهد. ممکن است خروجی SHA1 در آینده حذف شود.

-i

میانگین نرخ داده را به بیت بر ثانیه (bits/sec) نمایش می‌دهد.

-I

اطلاعات تفصیلی رابط‌های (interface) فایل ضبط را نمایش می‌دهد. این اطلاعات در قالب جدول در دسترس نیست.

-k

توضیحات (comment) ضبط را نمایش می‌دهد. برای فایل‌های pcapng، این همان توضیح مربوط به بلوک سرآیند بخش (section header block) است.

-K

از این گزینه برای جلوگیری از چاپ توضیحات فایل ضبط استفاده کنید. به‌طور پیش‌فرض نمایش توضیحات فعال است. توضیحات ضبط ساختاری آزاد دارند و ممکن است حاوی نویسه‌های خط جدید یا نویسه‌های تحدیدکنندهٔ دیگر باشند که تجزیهٔ آسان خروجی Capinfos را برای انسان یا ماشین دشوار می‌سازد. حذف توضیحات ضبط می‌تواند به پس‌پردازش خروجی کمک کند.

-l

طول برش (snaplen، در صورت وجود) را برای یک فایل نمایش می‌دهد. snaplen (در صورت موجود بودن) از روی سرآیند فایل ضبط و با جستجوی رکوردهای ناقص (truncated) در فایل تعیین می‌شود.

-L

تولید گزارش بلند (long). برنامهٔ Capinfos می‌تواند دو سبک متفاوت از گزارش‌ها را ایجاد کند. گزارش «long» سبک خروجی پیش‌فرض بوده و برای استفاده توسط انسان مناسب است.

-m

جداسازی اطلاعات با نویسه‌های کاما (,). این گزینه تنها هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. مقادیر مختلف اطلاعات با یک نویسهٔ تکی کاما «,» از یکدیگر جدا (تحدید) خواهند شد.

-M

چاپ مقادیر خام (ماشین‌خوان) در گزارش‌های بلند. به‌طور پیش‌فرض Capinfos مقادیر عددی را با پسوندهای SI خوانا برای انسان چاپ می‌کند و نوع فایل و کپسوله‌سازی را به صورت انسان‌خوان نمایش می‌دهد. گزارش‌های جدول (-T) همواره مقادیر خام را چاپ می‌کنند.

-n

تعداد نشانی‌های IPv4 تحلیل‌شده و تعداد نشانی‌های IPv6 تحلیل‌شده در فایل را نمایش می‌دهد. این اطلاعات در قالب جدول موجود نیست.

-N

اطلاعات را داخل علامت نقل‌قول قرار نده. این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. حذف نویسه‌های نقل‌قول در اطراف مقادیر و استفاده از جداکنندهٔ TAB، گزارشی بسیار «تمیز» تولید می‌کند که به‌سادگی با ابزارهای خط فرمان قابل تجزیه است. به‌طور پیش‌فرض اطلاعات در نقل‌قول قرار نمی‌گیرند.

-o

اگر بسته‌ها دارای ترتیب زمانی دقیق باشند، «True» و اگر یک یا چند بسته در ضبط از نظر زمانی «نامرتب» (out-of-order) باشند، «False» را نمایش می‌دهد.

-p

نمایش توضیحات تک‌تک بسته‌ها. توصیه می‌شود هنگام استفاده از این گزینه چاپ مقادیر خام (-M) را فعال کنید، زیرا توضیحات بسته‌ها ممکن است شامل خطوط جدید و سایر نویسه‌های خاص باشند.

-P

غیرفعال کردن نمایش توضیحات تک‌تک بسته‌ها.

-q

قرار دادن اطلاعات درون علامت نقل‌قول تکی ('). این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. هنگامی که این گزینه فعال باشد، هر مقدار درون یک جفت نویسهٔ نقل‌قول تکی (') احاطه می‌شود. این گزینه (در صورت استفاده همراه با گزینهٔ -m) برای تولید یک نوع گزارش فایلی به سبک CSV مفید است.

-Q

قرار دادن اطلاعات درون علامت نقل‌قول دوگانه ("). این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. هنگامی که این گزینه فعال باشد، هر مقدار درون یک جفت نویسهٔ نقل‌قول دوگانه (") احاطه می‌شود. این گزینه (در صورت استفاده همراه با گزینهٔ -m) برای تولید رایج‌ترین نوع گزارش فایلی به سبک CSV مناسب است.

-r

عدم تولید رکورد سرآیند. این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. در صورت مشخص شدن این گزینه، هیچ رکورد سرآیندی در گزارش جدول تولید نخواهد شد.

-R

تولید رکورد سرآیند. این گزینه فقط هنگام تولید گزارش سبک جدولی (-T) کاربرد دارد. سرآیند به‌طور پیش‌فرض تولید می‌شود. رکورد سرآیند (در صورت تولید) اولین سطر از داده‌های گزارش‌شده است و شامل برچسب‌هایی برای تمام ستون‌های موجود در گزارش جدول می‌باشد.

-s

اندازهٔ فایل را به بایت نمایش می‌دهد. این مقدار، حجم خود فایل ضبط را گزارش می‌کند.

-S

نمایش برچسب‌های زمانی نخستین و واپسین بسته بر حسب ثانیه‌های سپری‌شده از ۱ ژانویه ۱۹۷۰. برای همگام‌سازی تخلیه‌ها (dumps) با استفاده از editcap -t بسیار کاربردی است.

-t

نوع ضبط (capture type) مربوط به فایل را نمایش می‌دهد.

-T

تولید یک گزارش جدولی. گزارش جدولی یک فایل متنی است که برای وارد کردن به یک صفحه‌گسترده یا پایگاه داده مناسب است. Capinfos می‌تواند یک فایل متنی تفکیک‌شده با Tab (پیش‌فرض) یا انواع متفاوتی از فایل‌های مقادیر تفکیک‌شده با کاما (CSV) را بسازد.

-u

مدت‌زمان ضبط را به ثانیه نمایش می‌دهد. این مقدار برابر است با اختلاف زمانی میان نخستین بسته و واپسین بستهٔ دیده‌شده.

-v|--version

چاپ اطلاعات کامل نسخه و خروج.

-x

میانگین نرخ بسته را به بسته بر ثانیه (packets/sec) نمایش می‌دهد.

-y

میانگین نرخ داده را به بایت بر ثانیه (bytes/sec) نمایش می‌دهد.

-z

میانگین اندازهٔ بسته را به بایت نمایش می‌دهد.

--log-level <level>

سطح فعال ثبت وقایع (log) را تعیین می‌کند. سطوح پشتیبانی‌شده از کمترین تا بیشترین به ترتیب عبارتند از: «noisy»، «debug»، «info»، «message»، «warning»، «critical» و «error». پیام‌های مربوط به هر سطح و سطوح بالاتر از آن چاپ خواهند شد؛ به عنوان مثال، «warning» پیام‌های «warning»، «critical» و «error» را نمایش می‌دهد و «noisy» تمام پیام‌ها را چاپ می‌کند. سطوح نسبت به بزرگی و کوچکی حروف حساس نیستند.

--log-fatal <level>

در صورتی که پیامی در سطح مشخص‌شده یا بالاتر از آن ثبت شود، اجرای برنامه را متوقف می‌کند. به عنوان مثال، «warning» با ثبت هر یک از پیام‌های «warning»، «critical» یا «error» برنامه را لغو می‌کند.

--log-fatal-count <count>

تعداد پیام‌های مهلک ثبتی که می‌توانند پیش از متوقف شدن برنامه نادیده گرفته شوند.

--log-domains <list>

تنها پیام‌های مربوط به دامنه‌های مشخص‌شده را چاپ می‌کند، مانند «GUI,Epan,sshdump». فهرست دامنه‌ها باید با کاما از هم جدا شوند. با قرار دادن نویسهٔ «!» در ابتدا، می‌توان این تطبیق را معکوس کرد.

--log-debug <list>

دامنه‌های مشخص‌شده را مجبور می‌کند تا در سطح «debug» پیام ثبت کنند. فهرست دامنه‌ها باید با کاما از یکدیگر جدا شوند. با قرار دادن نویسهٔ «!» در ابتدا، می‌توان شرط را معکوس کرد.

--log-noisy <list>

دامنه‌های مشخص‌شده را مجبور می‌کند تا در سطح «noisy» پیام ثبت کنند. فهرست دامنه‌ها باید با کاما از یکدیگر جدا شوند. با قرار دادن نویسهٔ «!» در ابتدا، می‌توان شرط را معکوس کرد.

--log-fatal-domains <list>

در صورتی که پیامی برای دامنه‌های مشخص‌شده ثبت شود، اجرای برنامه را متوقف می‌کند. فهرست دامنه‌ها باید با کاما از یکدیگر جدا شوند.

--log-file <path>

پیام‌های ثبت وقایع و خروجی خطای استاندارد (stderr) را در فایل مشخص‌شده می‌نویسد.

برای دیدن شرح گزینه‌ها از دستور زیر استفاده کنید:

capinfos -h

برای تولید گزارش قالب طولانی (مشروح) از فایل ضبط‌شدهٔ mycapture.pcap از دستور زیر استفاده کنید:

capinfos mycapture.pcap

برای تولید گزارشی به شکل جدول با جداکنندهٔ تب (TAB) برای فایل ضبط‌شدهٔ mycapture.pcap از دستور زیر استفاده کنید:

capinfos -T mycapture.pcap

برای تولید گزارشی به شکل جدول در قالب CSV برای فایل ضبط‌شدهٔ mycapture.pcap از دستور زیر استفاده کنید:

capinfos -T -m -Q mycapture.pcap

یا

capinfos -TmQ mycapture.pcap

برای تولید گزارشی جدولی با جداکنندهٔ تب که فقط شامل نام فایل‌ها، نوع ضبط، نوع کپسوله‌سازی ضبط و تعداد بسته‌ها برای تمامی فایل‌های pcap در دایرکتوری جاری باشد، از دستور زیر استفاده کنید:

capinfos -T -t -E -c *.pcap

یا

capinfos -TtEc *.pcap

نکته: قابلیت استفاده از نویسه‌های الگوهای نام فایل (globbing) از ویژگی‌های پوسته‌های دستوری شبه‌یونیکس (*nix) است.

برای تولید گزارشی جدولی در قالب CSV از تمام اطلاعات مربوط به تمامی فایل‌های pcap در دایرکتوری جاری و نوشتن آن در فایلی متنی به نام mycaptures.csv از دستور زیر استفاده کنید:

capinfos -TmQ *.pcap >mycaptures.csv

فایل mycaptures.csv حاصل را می‌توان به آسانی در برنامه‌های صفحه‌گسترده وارد (import) کرد..SH "همچنین ببینید (SEE ALSO)"

pcap(3), wireshark(1), mergecap(1), editcap(1), tshark(1), dumpcap(1), captype(1), pcap-filter(7) یا tcpdump(8)

این صفحهٔ راهنما برای Capinfos نسخهٔ 4.7.3 است. Capinfos بخشی از توزیع Wireshark است. آخرین نسخهٔ Wireshark را می‌توان در این نشانی یافت: https://www.wireshark.org.

نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در این نشانی در دسترس هستند: https://www.wireshark.org/docs/man-pages.

نویسندهٔ اصلی
Ian Schorr <ian[AT]ianschorr.com>

مشارکت‌کنندگان
Gerald Combs <gerald[AT]wireshark.org>
Jim Young <jyoung[AT]gsu.edu>

2026-09-03