'\" t
.\"     Title: mergecap
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MERGECAP" "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)"
mergecap \- ادغام دو یا چند فایل ضبط بسته در یک فایل
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBmergecap\fP
[\~\fB\-a\fP\~]
[\~\fB\-F\fP\~<\fIfile\~format\fP>\~]
[\~\fB\-I\fP\~<\fIIDB\~merge\~mode\fP>\~]
[\~\fB\-s\fP\~<\fIsnaplen\fP>\~]
[\~\fB\-V\fP\~]
[\~\-\-no\-merging\-comment\~]
\fB\-w\fP\~<\fIoutfile\fP>|\-
<\fIinfile\fP>\~[<\fIinfile\fP>\~\fI.\|.\|.\fP]
.sp
\fBmergecap\fP
\fB\-h|\-\-help\fP
.sp
\fBmergecap\fP
\fB\-v|\-\-version\fP
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ \fBMergecap\fP چندین فایل ضبط‌شده را در یک فایل خروجی منفرد که با آرگومان \fB\-w\fP مشخص می‌شود، ادغام می‌کند. \fBMergecap\fP نحوهٔ خواندن فایل‌های ضبط \fBpcap\fP و \fBpcapng\fP، شامل فایل‌های ایجادشده توسط \fBtcpdump\fP، \fBWireshark\fP و ابزارهای دیگری که در این قالب‌ها می‌نویسند را می‌داند.
.sp
به‌طور پیش‌فرض، \fBMergecap\fP فایل ضبط را در قالب \fBpcapng\fP می‌نویسد و تمامی بسته‌های فایل‌های ضبط ورودی را درون فایل خروجی می‌نویسد.
.sp
\fBMergecap\fP قادر به تشخیص، خواندن و نوشتن همان فایل‌های ضبطی است که توسط \fBWireshark\fP پشتیبانی می‌شوند.
فایل‌های ورودی نیازی به پسوند نام فایل خاصی ندارند؛ قالب فایل و فشرده‌سازی اختیاری gzip، zstd یا lz4 به‌طور خودکار تشخیص داده خواهند شد.
نزدیک به ابتدای بخش «توضیحات (DESCRIPTION)» در wireshark(1) یا
\c
.URL "https://www.wireshark.org/docs/man\-pages/wireshark.html" ""
شرح مفصلی از نحوهٔ مدیریت این موارد توسط \fBWireshark\fP آورده شده که دقیقاً مشابه نحوهٔ عملکرد \fBMergecap\fP است.
.sp
\fBMergecap\fP می‌تواند فایل را در چندین قالب خروجی بنویسد.
از گزینهٔ \fB\-F\fP می‌توان برای تعیین قالبی که فایل ضبط در آن نوشته می‌شود استفاده کرد؛ دستور \fBmergecap \-F\fP فهرستی از قالب‌های خروجی موجود را ارائه می‌دهد.
.sp
بسته‌ها از فایل‌های ورودی بر اساس برچسب زمانی هر فریم به ترتیب زمانی ادغام می‌شوند، مگر آن‌که گزینهٔ \fB\-a\fP مشخص شده باشد. \fBMergecap\fP فرض می‌کند فریم‌ها در یک فایل ضبط از پیش به ترتیب زمانی ذخیره شده‌اند. هنگامی که گزینهٔ \fB\-a\fP مشخص شود، بسته‌ها بدون در نظر گرفتن برچسب زمانی هر فریم، مستقیماً از هر فایل ورودی به فایل خروجی کپی می‌شوند.
.sp
نوع کپسوله‌سازی فریم در فایل خروجی، در صورتی که تمام فایل‌های ورودی نوع یکسانی داشته باشند، روی همان نوع فایل‌های ورودی تنظیم می‌شود. اگر همهٔ فایل‌های ورودی نوع کپسوله‌سازی فریم یکسانی نداشته باشند، نوع فایل خروجی روی WTAP_ENCAP_PER_PACKET تنظیم می‌گردد. توجه داشته باشید که برخی از قالب‌های فایل ضبط، به‌ویژه \fBpcap\fP، در حال حاضر از WTAP_ENCAP_PER_PACKET پشتیبانی نمی‌کنند. این ترکیب باعث شکست در ایجاد فایل خروجی خواهد شد..SH "گزینه‌ها (OPTIONS)"
.sp
\-a
.RS 4
.sp
باعث نادیده گرفتن برچسب‌های زمانی فریم‌ها شده و تمام بسته‌های نخستین فایل ورودی را و در ادامه تمام بسته‌های دومین فایل ورودی را می‌نویسد. به‌طور پیش‌فرض، هنگامی که \fB\-a\fP مشخص نشده باشد، محتویات فایل‌های ورودی بر اساس برچسب زمانی هر فریم، با ترتیب زمانی ادغام می‌شوند.
.sp
نکته: هنگام ادغام، \fBmergecap\fP فرض می‌کند که بسته‌ها درون یک فایل ضبط از قبل با ترتیب زمانی چیده شده‌اند.
.RE
.sp
\-F  <file format>
.RS 4
.sp
قالب فایل خروجی ضبط را تنظیم می‌کند. \fBMergecap\fP می‌تواند فایل را در چندین قالب بنویسد؛ دستور \fBmergecap \-F\fP فهرستی از قالب‌های خروجی موجود را ارائه می‌دهد. به‌طور پیش‌فرض این قالب \fBpcapng\fP است.
.RE
.sp
\-h|\-\-help
.RS 4
شماره نسخه و گزینه‌ها را چاپ کرده و خارج می‌شود.
.RE
.sp
\-I  <IDB merge mode>
.RS 4
.sp
حالت ادغام «بلوک توصیف رابط» (Interface Description Block یا IDB) را برای استفاده در حین ادغام مشخص می‌کند. دستور \fBmergecap \-I\fP فهرستی از حالت‌های موجود ادغام IDB را ارائه می‌دهد.
.sp
هر فایل ورودی دارای یک یا چند IDB است که رابط یا رابط‌هایی را که در ابتدا ضبط روی آن‌ها انجام شده، توصیف می‌کنند. این توصیفات شامل نوع کپسوله‌سازی، نام رابط و غیره است. هنگامی که mergecap چندین فایل ورودی را ادغام می‌کند، باید این IDBها را به‌نحوی برای فایل خروجی جدید ادغام‌شده ترکیب کند. این پرچم نحوه انجام این کار را کنترل می‌کند. حالت‌های موجود در حال حاضر عبارتند از:
.sp
\fBnone\fP: هیچ ادغامی روی IDBها انجام نمی‌شود و در عوض تمام IDBها در فایل خروجی ادغام‌شده کپی می‌شوند.
.sp
\fBall\fP: بلوک‌های IDB تنها در صورتی ادغام می‌شوند که تمام فایل‌های ورودی دارای تعداد یکسانی از IDB باشند و هر IDB با مدخل متناظر خود در سایر فایل‌ها مطابقت داشته باشد. (تنها IDBهایی که در ابتدای فایل‌ها و پیش از هر بلوک بسته‌ای قرار دارند با یکدیگر مقایسه می‌شوند. بلوک‌های IDB که بعداً در فایل‌ها می‌آیند، تنها و تنها در صورتی با موارد تکراری ادغام می‌شوند که IDBهای اولیه ادغام شده باشند.) این حالت پیش‌فرض است.
.sp
\fBany\fP: هر و همه IDBهای تکراری، صرف‌نظر از این‌که در چه فایلی قرار دارند، در یک IDB ادغام می‌شوند.
.sp
توجه داشته باشید که یک IDB تنها در صورتی یک نسخه تکراری منطبق در نظر گرفته می‌شود که دارای همان نوع کپسوله‌سازی، نام، سرعت، دقت زمانی، توضیحات، توصیف و غیره باشد.
.RE
.sp
\-s  <snaplen>
.RS 4
.sp
طول اسنپ‌شات (snapshot length) را برای استفاده هنگام نوشتن داده‌ها تعیین می‌کند.
اگر پرچم \fB\-s\fP برای تعیین طول اسنپ‌شات استفاده شود، فریم‌هایی در فایل ورودی که داده‌های ضبط‌شده بیشتری نسبت به طول اسنپ‌شات مشخص‌شده دارند، تنها به اندازه داده مشخص‌شده توسط طول اسنپ‌شات در فایل خروجی نوشته می‌شوند. این ممکن است در صورتی مفید باشد که برنامه خواننده فایل خروجی نتواند بسته‌های بزرگ‌تر از اندازه‌ای مشخص را پردازش کند (برای مثال، به نظر می‌رسد نسخه‌های snoop در Solaris 2.5.1 و Solaris 2.6 فریم‌های Ethernet بزرگ‌تر از MTU استاندارد Ethernet را رد می‌کنند، که باعث می‌شود در صورت استفاده از jumbo frames قادر به پردازش ضبط‌های gigabit Ethernet نباشند).
.RE
.sp
\-v|\-\-version
.RS 4
اطلاعات کامل نسخه را چاپ کرده و خارج می‌شود.
.RE
.sp
\-V
.RS 4
باعث می‌شود \fBmergecap\fP حین کار، پیام‌های متعددی را چاپ کند.
.RE
.sp
\-w  <outfile>|\-
.RS 4
نام فایل خروجی را تعیین می‌کند. اگر نام آن \*(Aq\fB\-\fP\*(Aq باشد، از stdout استفاده خواهد شد.
اگر گزینه \fB\-\-compress\fP داده نشده باشد، پسوند نام فایل برای تشخیص روش فشرده‌سازی مدنظر (در صورت وجود) استفاده می‌شود؛ برای نمونه، اگر نام دارای پسوند \*(Aq.gz\*(Aq باشد، فایل خروجی به شکل یک بایگانی gzip فشرده می‌شود. این تنظیم الزامی است.
.RE
.sp
\-\-compress <type>
.RS 4
.sp
فایل خروجی را با استفاده از قالب فشرده‌سازی type فشرده می‌کند.
اجرای \fB\-\-compress\fP بدون هیچ آرگومانی فهرستی از قالب‌های فشرده‌سازی پشتیبانی‌شده برای نوشتن را ارائه می‌دهد. نوع داده‌شده بر پسوند \fIoutfile\fP اولویت دارد.
.RE
.sp
\-\-no\-merging\-comment
.RS 4
.sp
از تولید یادداشت ضبط "File created by merging:.\|.\|." در فایل خروجی جلوگیری می‌کند.
.sp
به‌طور پیش‌فرض یک یادداشت چندخطی ضبط در فایل خروجی (ادغام‌شده) ایجاد می‌شود که تمام فایل‌های در حال ادغام را فهرست می‌کند. با این حال، اگر یادداشت ضبط تولیدشده طولانی‌تر از ۶۵۵۳۵ بایت باشد، بدون هشدار نادیده گرفته می‌شود.
.RE.SH "گزینه‌های عیب‌یابی (DIAGNOSTIC OPTIONS)"
.sp
\-\-log\-level <level>
.RS 4
سطح لاگ فعال را تنظیم می‌کند.
سطوح پشتیبانی‌شده از کمترین تا بیشترین به ترتیب عبارتند از "noisy"، "debug"، "info"، "message"، "warning"، "critical" و "error".
پیام‌های مربوط به هر سطح و سطوح بالاتر چاپ خواهند شد؛ برای مثال، مقدار "warning" پیام‌های "warning"، "critical" و "error" را چاپ می‌کند و "noisy" تمامی پیام‌ها را نمایش می‌دهد.
سطوح نسبت به بزرگی و کوچکی حروف حساس نیستند.
.RE
.sp
\-\-log\-fatal <level>
.RS 4
در صورتی که هر پیامی در سطح مشخص‌شده یا بالاتر ثبت شود، اجرای برنامه را متوقف می‌کند.
برای مثال، مقدار "warning" با دریافت هر یک از پیام‌های "warning"، "critical" یا "error" برنامه را خاتمه می‌دهد.
.RE
.sp
\-\-log\-fatal\-count <count>
.RS 4
تعداد پیام‌های لاگ مهلک (fatal) که می‌توانند پیش از توقف برنامه ثبت شوند.
.RE
.sp
\-\-log\-domains <list>
.RS 4
تنها پیام‌های مربوط به دامنه‌های لاگ مشخص‌شده را چاپ می‌کند، به عنوان مثال "GUI,Epan,sshdump".
فهرست دامنه‌ها باید با کاما جدا شود. می‌توان با قرار دادن "!" به عنوان نخستین نویسه، آن را نقیض کرد (معکوس کردن انطباق).
.RE
.sp
\-\-log\-debug <list>
.RS 4
دامنه‌های مشخص‌شده را وادار به ثبت لاگ در سطح "debug" می‌کند.
فهرست دامنه‌ها باید با کاما جدا شود. می‌توان با قرار دادن "!" به عنوان نخستین نویسه، آن را نقیض کرد (معکوس کردن انطباق).
.RE
.sp
\-\-log\-noisy <list>
.RS 4
دامنه‌های مشخص‌شده را وادار به ثبت لاگ در سطح "noisy" می‌کند.
فهرست دامنه‌ها باید با کاما جدا شود. می‌توان با قرار دادن "!" به عنوان نخستین نویسه، آن را نقیض کرد (معکوس کردن انطباق).
.RE
.sp
\-\-log\-fatal\-domains <list>
.RS 4
در صورتی که هر پیامی برای دامنه‌های لاگ مشخص‌شده ثبت شود، اجرای برنامه را متوقف می‌کند.
فهرست دامنه‌ها باید با کاما جدا شود.
.RE
.sp
\-\-log\-file <path>
.RS 4
پیام‌های لاگ و خروجی stderr را در فایل مشخص‌شده می‌نویسد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای ادغام دو فایل ضبط با یکدیگر در یک فایل سوم، به‌طوری که آخرین بسته یک فایل ۱۰۰ ثانیه پیش از نخستین بسته فایل دیگر برسد، از توالی دستورات زیر استفاده کنید.
.sp
ابتدا، از این دستور استفاده کنید:
.sp
.if n .RS 4
.nf
.fam C
capinfos \-aeS a.pcap b.pcap
.fam
.fi
.if n .RE
.sp
تا زمان شروع و پایان دو فایل ضبط را بر حسب ثانیه‌های سپری‌شده از ۱ ژانویه ۱۹۷۰، ساعت 00:00:00 UTC مشخص کنید.
.sp
اگر a.pcap در زمان 1009932757 شروع شود و b.pcap در زمان 873660281 پایان یابد، تنظیم زمانی مورد نیاز برای b.pcap که موجب شود ۱۰۰ ثانیه پیش از شروع a.pcap به پایان برسد، برابر خواهد بود با: 1009932757 \- 873660281 \- 100 = 136272376 ثانیه.
.sp
بنابراین، گام بعدی استفاده از دستور زیر است:
.sp
.if n .RS 4
.nf
.fam C
editcap \-t 136272376 b.pcap b\-shifted.pcap
.fam
.fi
.if n .RE
.sp
تا نسخه‌ای از b.pcap تولید شود که برچسب‌های زمانی آن ۱۳۶۲۷۲۳۷۶ ثانیه به جلو منتقل شده باشد.
.sp
سپس گام نهایی استفاده از این دستور خواهد بود:
.sp
.if n .RS 4
.nf
.fam C
mergecap \-w compare.pcap a.pcap b\-shifted.pcap
.fam
.fi
.if n .RE
.sp
تا فایل‌های a.pcap و b.pcap منتقل‌شده را در compare.pcap ادغام کند..SH "همچنین ببینید (SEE ALSO)"
.sp
pcap(3)، wireshark(1)، tshark(1)، dumpcap(1)، editcap(1)، text2pcap(1)،
pcap\-filter(7) یا tcpdump(8)
.SH "نکات (NOTES)"
.sp
\fBMergecap\fP تا حد زیادی بر اساس \fBeditcap\fP نوشتهٔ Richard Sharpe
<sharpe[AT]ns.aus.com> و Guy Harris <guy[AT]alum.mit.edu> توسعه یافته است.
.sp
این صفحهٔ راهنما مربوط به \fBMergecap\fP نسخهٔ 4.7.3 است.
\fBMergecap\fP بخشی از توزیع \fBWireshark\fP می‌باشد.
جدیدترین نسخهٔ \fBWireshark\fP را می‌توان در نشانی زیر یافت: \c
.URL "https://www.wireshark.org" "" "."
.sp
نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در نشانی زیر در دسترس هستند: \c
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
.B نویسندهٔ اصلی
.br
Scott Renfro <scott[AT]renfro.org>
.sp
.B مشارکت‌کنندگان
.br
Bill Guyton <guyton[AT]bguyton.com>