رفتن به محتوا

ضمیمه ب. فایل‌ها و پوشه‌ها (Files and Folders)

ضمیمه ب. فایل‌ها و پوشه‌ها (Files and Folders)

Section titled “ضمیمه ب. فایل‌ها و پوشه‌ها (Files and Folders)”

ب.۱. فایل‌های کپچر (Capture Files)

Section titled “ب.۱. فایل‌های کپچر (Capture Files)”

برای درک اینکه پس از ذخیره شدن بسته‌های کپچرشده در یک فایل کپچر چه اطلاعاتی در دسترس باقی خواهند ماند، مفید است که کمی درباره محتویات فایل کپچر بدانید.

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

وایرشارک همچنین از فرمت فایل libpcap پشتیبانی می‌کند. این فرمت بسیار ساده‌تر و به خوبی جاافتاده است. با این حال، معایبی نیز دارد: توسعه‌پذیر نیست و فاقد برخی اطلاعات است که می‌توانستند واقعاً مفید باشند (برای مثال، امکان افزودن توضیحی مانند «مشکلات از اینجا شروع می‌شوند» به یک بسته واقعاً عالی می‌بود).

علاوه بر فرمت libpcap، وایرشارک از چندین فرمت فایل کپچر مختلف دیگر نیز پشتیبانی می‌کند. با این حال، مشکلات شرح داده شده در بالا برای این فرمت‌ها نیز صدق می‌کنند.

در ابتدای هر فایل کپچر libpcap، اطلاعات پایه‌ای مانند یک عدد جادویی (Magic Number) برای شناسایی فرمت فایل libpcap ذخیره می‌شود. جالب‌ترین اطلاعات در این بخش آغازین فایل، نوع لایه پیوند (Link layer type مانند Ethernet، 802.11، MPLS و غیره) است.

داده‌های زیر برای هر بسته ذخیره می‌شوند:

  • برچسب زمانی (Timestamp) با دقت میلی‌ثانیه
  • طول بسته به همان شکلی که «بر روی سیم» (on the wire) بوده است
  • طول بسته به همان شکلی که در فایل ذخیره شده است
  • بایت‌های خام بسته

توضیحات مفصل درباره فرمت فایل libpcap را می‌توانید در آدرس https://wiki.wireshark.org/Development/LibpcapFileFormat بیابید.

ب.۱.۲. مواردی که در فایل کپچر ذخیره نمی‌شوند (Not Saved in the Capture File)

Section titled “ب.۱.۲. مواردی که در فایل کپچر ذخیره نمی‌شوند (Not Saved in the Capture File)”

همچنین باید مواردی را که در فایل‌های کپچر ذخیره نمی‌شوند بدانید:

  • انتخاب‌های فعلی (بسته انتخاب‌شده، …)

  • اطلاعات تفکیک نام (Name resolution). برای جزئیات بیشتر به بخش ۷.۹، «تفکیک نام (Name Resolution)» مراجعه کنید.

    فایل‌های Pcapng می‌توانند به صورت اختیاری اطلاعات تفکیک نام را ذخیره کنند. فایل‌های Libpcap قادر به این کار نیستند. سایر فرمت‌های فایل سطوح متفاوتی از پشتیبانی را دارند.

  • تعداد بسته‌های دور ریخته شده (Dropped) در حین کپچر

  • نشانه‌گذاری‌های بسته‌ها که با گزینه «Edit/Mark Packet» تنظیم شده‌اند

  • مراجع زمانی (Time references) که با گزینه «Edit/Time Reference» تنظیم شده‌اند

  • فیلتر نمایشی فعلی

ب.۲. پوشه‌های فایل پیکربندی و پلاگین‌ها (Configuration File and Plugin Folders)

Section titled “ب.۲. پوشه‌های فایل پیکربندی و پلاگین‌ها (Configuration File and Plugin Folders)”

به منظور تطابق با سیاست‌های مختلف برای سیستم‌های شبه‌یونیکس و ویندوز، و سیاست‌های متفاوت مورد استفاده در سیستم‌های مختلف شبه‌یونیکس، پوشه‌های حاوی فایل‌های پیکربندی و پلاگین‌ها در پلتفرم‌های مختلف، متفاوت هستند. ما در اینجا مکان پوشه‌های سطح بالایی را که فایل‌های پیکربندی و پلاگین‌ها در زیرمجموعه آن‌ها ذخیره می‌شوند مشخص می‌کنیم، به آن‌ها نام‌های جایگزین (Placeholder) مستقل از مکان واقعی‌شان می‌دهیم، و بعداً هنگام اعلام مکان پوشه‌های فایل‌های پیکربندی و پلاگین‌ها از این نام‌ها استفاده می‌کنیم.

[Tip]
نکته

فهرستی از پوشه‌هایی که وایرشارک در عمل استفاده می‌کند را می‌توانید در زبانه Folders در کادر محاوره‌ای که هنگام انتخاب About Wireshark از منوی Help نمایش داده می‌شود، مشاهده کنید.

ب.۲.۱. پوشه‌ها در ویندوز (Folders on Windows)

Section titled “ب.۲.۱. پوشه‌ها در ویندوز (Folders on Windows)”

متغیر %APPDATA% پوشه داده‌های برنامه شخصی است. این مسیر معمولاً C:\Users*username**\AppData\Roaming* است. وایرشارک داده‌های خود را در مسیر %APPDATA%\Wireshark ذخیره می‌کند. (جزئیات بیشتر را می‌توانید در بخش ب.۵.۱، «پروفایل‌های ویندوز» بیابید).

اگر وایرشارک از طریق بسته PortableApps.com نصب شده باشد، داده‌های خود را در عوض در پوشه Data متعلق به آن بسته ذخیره می‌کند؛ چه زمانی که لانچر PortableApps.com وایرشارک را راه‌اندازی کند و چه زمانی که Wireshark، TShark یا برنامه دیگری در پوشه App\Wireshark آن بسته به طور مستقیم اجرا شود.

WIRESHARK پوشه برنامه وایرشارک است، برای مثال: C:\Program Files\Wireshark.

ب.۲.۲. پوشه‌ها در سیستم‌های شبه‌یونیکس (Folders on Unix-like systems)

Section titled “ب.۲.۲. پوشه‌ها در سیستم‌های شبه‌یونیکس (Folders on Unix-like systems)”

متغیر $XDG_CONFIG_HOME پوشه مخصوص فایل‌های پیکربندی مختص کاربر است. این مسیر معمولاً $HOME/.config است، که در آن $HOME پوشه خانه (Home) کاربر بوده و معمولاً مسیری مانند /home/username، یا در macOS مسیری مانند /Users/username است.

اگر از macOS استفاده می‌کنید و نسخه‌ای از وایرشارک را اجرا می‌کنید که به صورت بسته برنامه (Application Bundle) نصب شده است، APPDIR دایرکتوری سطح بالای بسته برنامه وایرشارک است که معمولاً مسیر /Applications/Wireshark.app خواهد بود. در غیر این صورت، INSTALLDIR دایرکتوری سطح بالایی است که زیردایرکتوری‌های حاوی اجزای نصب‌شده وایرشارک در زیرمجموعه آن قرار دارند. این مسیر در صورتی که وایرشارک به همراه سیستم ارائه شده باشد (برای مثال، به عنوان یک بسته به همراه توزیع لینوکس ارائه شده باشد) معمولاً /usr است و اگر برای مثال خودتان وایرشارک را از روی کد منبع ساخته و نصب کرده باشید، مسیر /usr/local خواهد بود.

ب.۳. فایل‌های پیکربندی (Configuration Files)

Section titled “ب.۳. فایل‌های پیکربندی (Configuration Files)”

وایرشارک در حین اجرا از تعدادی فایل پیکربندی استفاده می‌کند. برخی از این فایل‌ها در پوشه پیکربندی شخصی قرار دارند و برای حفظ اطلاعات بین دفعات اجرای وایرشارک استفاده می‌شوند، در حالی که برخی از آن‌ها در بخش‌های سیستمی نگهداری می‌شوند.

فرمت محتوای فایل‌های پیکربندی در تمامی پلتفرم‌ها یکسان است.

در ویندوز:

  • پوشه پیکربندی شخصی برای وایرشارک، زیرپوشه Wireshark در آن پوشه است، یعنی %APPDATA%\Wireshark.
  • پوشه پیکربندی سراسری (Global) برای وایرشارک، پوشه برنامه وایرشارک است و همچنین به عنوان پوشه پیکربندی سیستمی نیز استفاده می‌شود.

در سیستم‌های شبه‌یونیکس:

  • پوشه پیکربندی شخصی، مسیر $XDG_CONFIG_HOME/wireshark است. برای سازگاری رو به عقب با نسخه‌های وایرشارک پیش از ۲.۲، اگر مسیر $XDG_CONFIG_HOME/wireshark وجود نداشته باشد و مسیر $HOME/.wireshark موجود باشد، از مورد دوم استفاده خواهد شد.
  • اگر از macOS استفاده می‌کنید و نسخه‌ای از وایرشارک را اجرا می‌کنید که به صورت بسته برنامه (Application Bundle) نصب شده است، پوشه پیکربندی سراسری مسیر APPDIR/Contents/Resources/share/wireshark است. در غیر این صورت، پوشه پیکربندی سراسری مسیر INSTALLDIR/share/wireshark است.
  • پوشه /etc پوشه پیکربندی سیستمی است. پوشه‌ای که در عمل روی سیستم شما استفاده می‌شود ممکن است متفاوت باشد، شاید چیزی شبیه به: /usr/local/etc.

جدول ب.۱. نمای کلی فایل‌های پیکربندی

فایل/پوشه توضیحات
cfilters فیلترهای کپچر (Capture filters).
coloring_rules.jsonc قوانین رنگ‌آمیزی (Coloring rules).
dfilter_buttons دکمه‌های فیلتر نمایشی (Display filter buttons).
dfilters فیلترهای نمایشی (Display filters).
disabled_protos پروتکل‌های غیرفعال‌شده (Disabled protocols).
dmacros ماکروهای فیلتر نمایشی (Display filter macros).
ethers تفکیک نام اترنت (Ethernet name resolution).
fieldurls آدرس‌های URL سفارشی برای عملیات Filter Field Reference.
hosts تفکیک نام IPv4 و IPv6.
ipxnets تفکیک نام IPX.
manuf تفکیک نام سازندگان اترنت (Ethernet name resolution).
preferences تنظیمات مربوط به کادر محاوره‌ای Preferences.
recent تنظیمات رابط کاربری گرافیکی (GUI) به ازای هر پروفایل.
recent_common تنظیمات مشترک رابط کاربری گرافیکی (GUI).
services سرویس‌های شبکه (Network services).
ss7pcs تفکیک کد نقطه (Point code) در SS7.
subnets تفکیک نام زیرشبکه (Subnet) در IPv4.
subnetsipv6 تفکیک نام زیرشبکه (Subnet) در IPv6.
tagrules.jsonc قوانین برچسب‌گذاری (Tagging rules).
vlans تفکیک نام شناسه VLAN.
wka آدرس‌های MAC شناخته‌شده (Well-known MAC addresses).
محتویات فایل‌ها (File contents)
Section titled “محتویات فایل‌ها (File contents)”
  • cfilters —

این فایل حاوی تمامی فیلترهای کپچری است که تعریف و ذخیره کرده‌اید. این فایل شامل یک یا چند خط است که هر خط دارای فرمت زیر است:

"<filter name>" <filter string>

در هنگام شروع برنامه، اگر فایلی با نام cfilters در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود. اگر فایل cfilters در پوشه پیکربندی شخصی وجود نداشته باشد، آنگاه در صورت وجود فایل cfilters در پوشه پیکربندی سراسری، آن فایل خوانده می‌شود.

هنگامی که دکمه Save را در کادر محاوره‌ای «Capture Filters» فشار می‌دهید، تمامی فیلترهای کپچر فعلی در فایل فیلترهای کپچر شخصی نوشته می‌شوند.

  • coloring_rules.jsonc —

این فایل حاوی تمامی قوانین رنگ‌آمیزی است که تعریف و ذخیره کرده‌اید. این فایل شامل آرایه‌ای از اشیاء JSON است که هر کدام یک قانون رنگ‌آمیزی را با فرمت زیر نشان می‌دهند:

{ "Filter name": {
"filter": "<display filter string>",
"foreground": "#rrggbb or rrggbb",
"background": "#rrggbb or rrggbb",
"enabled": "<boolean value>"
}
}

در هنگام شروع برنامه، اگر فایل coloring_rules.jsonc در پوشه پیکربندی شخصی وجود داشته باشد، تنها همان فایل خوانده می‌شود. اگر این فایل وجود نداشته باشد، فایل قدیمی colorfilters در پوشه پیکربندی شخصی که توسط نسخه‌های پیش از وایرشارک ۵.۰ نوشته شده است، در عوض خوانده شده و در دفعه بعدی که قوانین رنگ‌آمیزی ذخیره شوند، به coloring_rules.jsonc تبدیل می‌گردد. اگر هیچ‌کدام وجود نداشته باشند، وایرشارک تلاش می‌کند فایل سراسری coloring_rules.jsonc را بخواند.

هنگامی که دکمه Save را در کادر محاوره‌ای «Coloring Rules» فشار می‌دهید، تمامی فیلترهای رنگی فعلی در فایل شخصی فیلترهای رنگی نوشته می‌شوند.

  • dfilter_buttons —

این فایل حاوی تمامی دکمه‌های فیلتر نمایشی است که تعریف و ذخیره کرده‌اید. این فایل شامل یک یا چند خط است که هر خط دارای فرمت زیر است:

"TRUE/FALSE","<button label>","<filter string>","<comment string>"

که در آن اگر دکمه فعال (نمایش داده شده) باشد، فیلد اول مقدار TRUE دارد.

در هنگام شروع برنامه، اگر فایل dfilter_buttons در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود. اگر فایل dfilter_buttons در پوشه پیکربندی شخصی نباشد، آنگاه در صورت وجود فایل dfilter_buttons در پوشه پیکربندی سراسری، آن فایل خوانده می‌شود.

هنگامی که هرگونه تغییری را در دکمه‌های فیلتر ذخیره می‌کنید، تمامی دکمه‌های فیلتر نمایشی فعلی در فایل شخصی دکمه‌های فیلتر نمایشی نوشته می‌شوند.

  • dfilters —

این فایل حاوی تمامی فیلترهای نمایشی است که تعریف و ذخیره کرده‌اید. این فایل شامل یک یا چند خط است که هر خط دارای فرمت زیر است:

"<filter name>" <filter string>

در هنگام شروع برنامه، اگر فایل dfilters در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود. اگر فایل dfilters در پوشه پیکربندی شخصی نباشد، آنگاه در صورت وجود فایل dfilters در پوشه پیکربندی سراسری، آن فایل خوانده می‌شود.

هنگامی که دکمه Save را در کادر محاوره‌ای «Display Filters» فشار می‌دهید، تمامی فیلترهای نمایشی فعلی در فایل شخصی فیلترهای نمایشی نوشته می‌شوند.

  • disabled_protos —

هر خط در این فایل نام یک پروتکل غیرفعال‌شده را مشخص می‌کند. در ادامه چند مثال آورده شده است:

tcp
udp

در هنگام شروع برنامه، اگر فایل disabled_protos در پوشه پیکربندی سراسری وجود داشته باشد، ابتدا آن فایل خوانده می‌شود. سپس، اگر فایل disabled_protos در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود؛ اگر ورودی مربوط به یک مجموعه پروتکل در هر دو فایل وجود داشته باشد، تنظیمات موجود در فایل پروتکل‌های غیرفعال شخصی، تنظیمات موجود در فایل پروتکل‌های غیرفعال سراسری را بازنویسی (Override) می‌کند.

هنگامی که دکمه Save را در کادر محاوره‌ای «Enabled Protocols» فشار می‌دهید، مجموعه فعلی پروتکل‌های غیرفعال در فایل شخصی پروتکل‌های غیرفعال نوشته می‌شود.

  • dmacros —

این فایل حاوی تمامی ماکروهای فیلتر نمایشی است که تعریف و ذخیره کرده‌اید. این فایل شامل یک یا چند خط است که هر خط دارای فرمت زیر است:

"<macro name>" <macro expression>

در هنگام شروع برنامه، اگر فایل dmacros در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود. اگر فایل dmacros در پوشه پیکربندی شخصی نباشد، آنگاه در صورت وجود فایل dmacros در پوشه پیکربندی سراسری، آن فایل خوانده می‌شود.

در نسخه‌های وایرشارک پیش از ۴.۴، ماکروهای فیلتر نمایشی در فایلی با نام dfilter_macros با فرمتی تا حدی متفاوت (یک جدول UAT) ذخیره می‌شدند. در هنگام شروع برنامه، اگر فایل dmacros یافت نشود، فایل dfilter_macros در پوشه‌های پیکربندی شخصی و سراسری جستجو شده و به فرمت جدید تبدیل می‌شود.

هنگامی که دکمه Save را در کادر محاوره‌ای “Display Filter Macros” فشار می‌دهید، تمامی ماکروهای فیلتر نمایشی فعلی در فایل شخصی ماکروهای فیلتر نمایشی نوشته می‌شوند.

اطلاعات بیشتر درباره ماکروهای فیلتر نمایشی در بخش ۶.۷، «تعریف و ذخیره ماکروهای فیلتر (Defining And Saving Filter Macros)» در دسترس است.

  • ethers —

هنگامی که وایرشارک تلاش می‌کند یک آدرس سخت‌افزاری MAC یا EUI-64 را به یک نام ترجمه کند، ابتدا به سراغ فایل ethers در پوشه پیکربندی شخصی می‌رود. اگر آدرس در آن فایل یافت نشود، وایرشارک به سراغ فایل ethers در پوشه پیکربندی سیستمی می‌رود.

این فایل فرمتی مشابه فایل /etc/ethers در برخی سیستم‌های شبه‌یونیکس دارد. هر خط در این فایل‌ها شامل یک آدرس سخت‌افزاری و یک نام است که با فاصله سفید (تب یا اسپیس) از هم جدا شده‌اند. آدرس‌های سخت‌افزاری به صورت جفت ارقام هگزادسیمال جداشده با دو نقطه (:)، خط تیره (-) یا نقطه (.) بیان می‌شوند که در سرتاسر آدرس از یک جداکننده یکسان استفاده می‌شود. کاراکتر # می‌تواند برای نشان دادن یک توضیح (Comment) که تا انتهای خط ادامه می‌یابد استفاده شود. جستجوهای NIS، آن‌طور که در برخی سیستم‌های شبه‌یونیکس وجود دارد، پشتیبانی نمی‌شوند. هر دو نوع آدرس ۶ بایتی MAC و ۸ بایتی EUI-64 پشتیبانی می‌شوند. در ادامه چند مثال آورده شده است:

ff-ff-ff-ff-ff-ff Broadcast
c0-00-ff-ff-ff-ff TR_broadcast
00.2b.08.93.4b.a1 Freds_machine
00:00:00:00:00:00:00:00 zb_zero_broadcast

تنظیمات این فایل در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • fieldurls —

وایرشارک از فایل fieldurls برای بازنویسی (Override) صفحه‌ای که توسط گزینه Filter Field Reference در منوی راست‌کلیک (Context menu) جزئیات بسته باز می‌شود، استفاده می‌کند.

فایل fieldurls تنها از پوشه پیکربندی شخصی خوانده می‌شود و میان تمامی پروفایل‌های پیکربندی مشترک است.

هر خط در این فایل شامل مخفف یک فیلد یا پروتکل است که به دنبال آن یک آدرس URL قرار گرفته و با فاصله سفید یا تب از هم جدا شده‌اند. خطوطی که با # شروع می‌شوند، توضیح (Comment) هستند. هنگامی که از این گزینه منو استفاده می‌شود، در صورت وجود ورودی برای فیلد انتخاب‌شده از آن استفاده می‌گردد، در غیر این صورت از ورودی مربوط به پروتکل آن، و در غیر این صورت از صفحه آنلاین مرجع فیلترهای نمایشی استفاده می‌شود.

یک URL می‌تواند حاوی متغیرهای جایگزین (Placeholders) زیر باشد:

  • ${fieldname}: مخفف فیلد انتخاب‌شده که در آن هر نقطه (.) با خط تیره (-) جایگزین شده است، برای مثال tcp-len.
  • ${fieldnameraw}: مخفف فیلد انتخاب‌شده به همان شکل اصلی، برای مثال tcp.len.
  • ${fieldvalue}: مقدار فیلد انتخاب‌شده که در آن هر . و : با - جایگزین شده است (برای مثال 10-0-0-1 برای یک آدرس IPv4)، کدگذاری‌شده به روش درصدی (Percent-encoded).
  • ${fieldvalueraw}: مقدار فیلد انتخاب‌شده، کدگذاری‌شده به روش درصدی (Percent-encoded)، با حفظ کاراکتر .. کاراکتر : در یک آدرس IPv6 به %3A تبدیل می‌شود.

سایر متون، از جمله توالی‌های ناشناخته ${…}، بدون تغییر باقی می‌مانند.

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

موارد (items) با ویرگول از هم جدا می‌شوند. هر مورد می‌تواند یک مقدار مانند 443 یا GET، یا برای اعداد یک بازه شاملِ ابتدا و انتها (Inclusive range) مانند 8000..8080 باشد. اعداد می‌توانند در مبنای ده (دهدهی) یا هگزادسیمال (0x01bb) باشند.

هر مورد همچنین می‌تواند یک آدرس IPv4 یا IPv6، یک بازه آدرس شامل ابتدا و انتها مانند 10.0.0.5..10.0.0.9، یا یک شبکه در نمادگذاری CIDR مانند 10.0.0.0/8 یا 2700:7a00::/32 باشد. این موارد به عنوان آدرس مقایسه می‌شوند، بنابراین هر نحوه نگارشی از یک آدرس IPv6 مطابقت می‌یابد، و یک مورد IPv4 تنها با مقادیر IPv4 و یک مورد IPv6 تنها با مقادیر IPv6 مطابقت پیدا می‌کند. تفاوتی ندارد که کدام فیلد استفاده شده باشد؛ مقداری که یک آدرس باشد، به عنوان یک آدرس مقایسه می‌شود.

هر مورد را همچنین می‌توان داخل گیومه دوتایی (") قرار داد؛ این کار زمانی ضروری است که مورد حاوی فاصله سفید، ویرگول، کاراکتر } یا " باشد (از \" و \\ استفاده کنید) و باعث می‌شود همیشه به عنوان متن مقایسه شود، بنابراین "80" دیگر یک عدد محسوب نمی‌شود و "10.0.0.0/8" یک شبکه به شمار نمی‌آید.

پرچم‌ها (Flags) را می‌توان بین } و = قرار داد:

  • i: نادیده گرفتن بزرگی و کوچکی حروف هنگام مقایسه متن.
  • *: مطابقت در صورتی که مقدار فیلد حاوی یکی از موارد باشد، به جای اینکه دقیقاً برابر با آن باشد. در این حالت تمامی موارد به صورت متن مقایسه می‌شوند و نمی‌توان از بازه‌ها استفاده کرد.

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

یک مثال در ادامه آمده است:

tcp.len https://www.rfc-editor.org/rfc/rfc9293.html
http https://example.com/our-http-notes
ip https://example.com/fields/${fieldname}?value=${fieldvalueraw}
tcp.srcport {8000..8080}=http://porteightthousand.com {443,843}=http://tls.com http://else.com
http.user_agent {"Mozilla Firefox",curl}*i=https://example.com/browsers https://example.com/other
ip.src {10.0.0.0/8,192.168.0.0/16}=https://example.com/internal/${fieldvalue} https://example.com/external/${fieldvalue}
ipv6.src {2608:7700::/32}=https://example.com/ipv6/${fieldvalueraw}

تنظیمات این فایل در اولین باری که به آن‌ها نیاز باشد خوانده می‌شوند و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • hosts —

وایرشارک از ورودی‌های موجود در فایل‌های hosts برای ترجمه آدرس‌های IPv4 و IPv6 به نام‌ها استفاده می‌کند.

وایرشارک فایل‌های hosts را از چندین مکان به صورت سلسله‌مراتبی می‌خواند:

  1. فایل hosts سراسری (برای مثال، C:\Program Files\Wireshark\hosts در ویندوز)
  2. فایل hosts شخصی پایه (برای مثال، %APPDATA%\Wireshark\hosts در ویندوز)
  3. فایل hosts پروفایل (برای مثال، %APPDATA%\Wireshark\profiles\<name>\hosts در ویندوز)

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

فایل hosts پروفایل همیشه زمانی که تفکیک نام (Name resolution) فعال باشد بارگذاری می‌شود. فایل hosts شخصی پایه به کاربران اجازه می‌دهد نگاشت‌های تفکیک نام در سطح کاربر را در تمامی پروفایل‌ها بدون نیاز به دسترسی نوشتن در دایرکتوری‌های سیستمی یا تکرار ورودی‌ها در هر پروفایل، نگهداری کنند.

این فایل همان فرمت فایل معمول /etc/hosts در سیستم‌های یونیکس را دارد.

یک مثال در ادامه آمده است:

# Comments must be prepended by the # sign!
192.168.0.1 homeserver

تنظیمات این فایل‌ها در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • ipxnets —

هنگامی که وایرشارک تلاش می‌کند یک شماره شبکه IPX را به یک نام ترجمه کند، ابتدا به سراغ فایل ipxnets در پوشه پیکربندی شخصی می‌رود. اگر آدرس در آن فایل یافت نشود، وایرشارک به سراغ فایل ipxnets در پوشه پیکربندی سیستمی می‌رود.

یک مثال در ادامه آمده است:

C0.A8.2C.00 HR
c0-a8-1c-00 CEO
00:00:BE:EF IT_Server1
110f FileServer3

تنظیمات این فایل زمانی خوانده می‌شوند که قرار باشد یک شماره شبکه IPX به یک نام ترجمه شود، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • manuf —

در هنگام شروع برنامه، اگر فایلی با نام manuf در پوشه پیکربندی سراسری وجود داشته باشد، ابتدا خوانده می‌شود. سپس، اگر فایل manuf در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود؛ اگر ورودی مربوط به یک پیشوند آدرس مشخص در هر دو فایل وجود داشته باشد، تنظیمات موجود در فایل شخصی، ورودی موجود در فایل سراسری را بازنویسی (Override) می‌کند.

ورودی‌های این فایل برای ترجمه پیشوندهای آدرس MAC به نام‌های کوتاه و بلند شرکت‌های سازنده استفاده می‌شوند. هر خط شامل یک پیشوند آدرس MAC است که به دنبال آن نام مخفف سازنده و نام کامل سازنده قرار دارد. پیشوندها به طور پیش‌فرض ۲۴ بیت طول دارند و ممکن است یک طول اختیاری به دنبال آن‌ها بیاید. توجه داشته باشید که این فرمت با فرمت فایل ethers که اجازه تعیین طول پیشوند را نمی‌دهد، یکسان نیست.

مثال‌ها عبارتند از:

00:00:01 Xerox Xerox Corporation
00:50:C2:00:30:00/36 Microsoft Microsoft

در نسخه‌های قدیمی‌تر وایرشارک، اطلاعات رسمی مرجع ثبت IEEE (IEEE Registration Authority) با این فرمت به عنوان فایل manuf در پوشه پیکربندی سراسری توزیع می‌شد. در نسخه‌های فعلی وایرشارک، این اطلاعات برای افزایش سرعت راه‌اندازی در داخل برنامه کامپایل شده‌اند، اما اگر فایلی در پوشه پیکربندی سراسری موجود باشد همچنان خوانده می‌شود و درست مانند فایل شخصی می‌توان از آن برای تکمیل یا جایگزینی داده‌های رسمی استفاده کرد. اطلاعات کامپایل‌شده در برنامه را می‌توان با دستور tshark -G manuf با این فرمت به صورت یک گزارش خروجی گرفت.

تنظیمات این فایل در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • preferences —

این فایل حاوی ترجیحات (Preferences) وایرشارک شما، از جمله مقادیر پیش‌فرض برای کپچر و نمایش بسته‌ها است. این فایل یک فایل متنی ساده حاوی عباراتی به شکل زیر است:

variable: value

در هنگام شروع برنامه، اگر فایل preferences در پوشه پیکربندی سراسری وجود داشته باشد، ابتدا خوانده می‌شود. سپس، اگر فایل preferences در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود؛ اگر یک ویژگی (Preference) در هر دو فایل تنظیم شده باشد، تنظیمات موجود در فایل ترجیحات شخصی، تنظیمات موجود در فایل ترجیحات سراسری را بازنویسی می‌کند.

اگر دکمه Save را در کادر محاوره‌ای «Preferences» فشار دهید، تمامی تنظیمات فعلی در فایل ترجیحات شخصی نوشته می‌شوند.

  • recent —

این فایل حاوی تنظیمات رابط کاربری گرافیکی (GUI) مختص پروفایل فعلی، مانند عرض ستون‌ها و وضعیت نمایش نوارهای ابزار است. این فایل یک فایل متنی ساده حاوی عباراتی به شکل زیر است:

variable: value

این فایل در هنگام شروع برنامه خوانده می‌شود و هنگام ذخیره ترجیحات و در زمان خروج از برنامه نوشته می‌شود. همچنین هر بار که به پروفایل دیگری جابه‌جا می‌شوید، این فایل نوشته و خوانده می‌شود.

  • recent_common —

این فایل حاوی تنظیمات مشترک رابط کاربری گرافیکی (GUI)، مانند فایل‌های کپچر اخیراً باز شده، فیلترهای اخیراً استفاده شده و ابعاد و موقعیت پنجره‌ها است. این فایل یک فایل متنی ساده حاوی عباراتی به شکل زیر است:

variable: value

این فایل در هنگام شروع برنامه خوانده می‌شود و هنگام ذخیره ترجیحات و در زمان خروج از برنامه نوشته می‌شود.

  • services —

وایرشارک از فایل‌های services برای ترجمه شماره پورت‌ها به نام‌ها استفاده می‌کند.

در هنگام شروع برنامه، اگر فایل services در پوشه پیکربندی سراسری وجود داشته باشد، ابتدا خوانده می‌شود. سپس، اگر فایل services در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود؛ اگر ورودی مربوط به یک شماره پورت مشخص در هر دو فایل وجود داشته باشد، تنظیمات موجود در فایل services شخصی، ورودی موجود در فایل services سراسری را بازنویسی می‌کند. فرمت این فایل همان فرمت فایل استاندارد services(5) در سیستم‌های سازگار با یونیکس است.

یک مثال در ادامه آمده است:

mydns 5045/udp # My own Domain Name Server
mydns 5045/tcp # My own Domain Name Server

در نسخه‌های قدیمی‌تر وایرشارک، اطلاعات رسمی ثبت نام سرویس‌ها و شماره پورت‌های پروتکل انتقال IANA با این فرمت به عنوان فایل services در پوشه پیکربندی سراسری توزیع می‌شد. در نسخه‌های فعلی وایرشارک، این اطلاعات برای افزایش سرعت راه‌اندازی در داخل برنامه کامپایل شده‌اند، اما اگر فایلی در پوشه پیکربندی سراسری موجود باشد همچنان خوانده می‌شود و درست مانند فایل شخصی می‌توان از آن برای تکمیل یا جایگزینی داده‌های رسمی استفاده کرد. اطلاعات کامپایل‌شده در برنامه را می‌توان با دستور tshark -G services با این فرمت به صورت یک گزارش خروجی گرفت.

تنظیمات این فایل در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • ss7pcs —

وایرشارک از فایل ss7pcs برای ترجمه کدهای نقطه (Point codes) در پروتکل SS7 به نام گره‌ها (Node names) استفاده می‌کند.

در هنگام شروع برنامه، اگر فایل ss7pcs در پوشه پیکربندی شخصی وجود داشته باشد، خوانده می‌شود.

هر خط در این فایل شامل یک نشانگر شبکه (Network indicator) است که به دنبال آن یک خط تیره، سپس یک کد نقطه در مبنای ده (دهدهی) و یک نام گره که با فاصله سفید یا تب جدا شده است، قرار می‌گیرد.

یک مثال در ادامه آمده است:

2-1234 MyPointCode1

تنظیمات این فایل در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز شدن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • subnets و subnetsipv6 —

وایرشارک از فایل‌های subnets و subnetsipv6 برای ترجمه یک آدرس IP به نام زیرشبکه (Subnet) استفاده می‌کند. اگر هیچ تطابق دقیقی از فایل hosts یا از طریق DNS یافت نشود، وایرشارک تلاش می‌کند یک تطابق جزئی برای زیرشبکه آن آدرس پیدا کند.

در هنگام شروع برنامه، اگر فایل subnets یا subnetsipv6 در پوشه پیکربندی شخصی وجود داشته باشد، ابتدا خوانده می‌شود. سپس، اگر فایل subnets یا subnetsipv6 در پوشه پیکربندی سراسری وجود داشته باشد، خوانده می‌شود؛ اگر تنظیمی در هر دو فایل وجود داشته باشد، تنظیمات موجود در فایل ترجیحات سراسری، تنظیمات موجود در فایل ترجیحات شخصی را بازنویسی می‌کند.

هر خط در یکی از این فایل‌ها شامل یک آدرس IP، طول ماسک زیرشبکه که تنها با یک کاراکتر «/» جدا شده است، و یک نام که با فاصله سفید جدا شده است می‌باشد. در حالی که آدرس باید یک آدرس IP کامل باشد، هرگونه مقداری فراتر از طول ماسک متعاقباً نادیده گرفته می‌شود.

یک مثال در ادامه آمده است:

# Comments must be prepended by the # sign!
192.168.0.0/24 ws_test_network

یا

2001:DB8::/32 documentation

یک نام که به صورت جزئی مطابقت یافته باشد به شکل «subnet-name.remaining-address» چاپ خواهد شد. برای مثال، آدرس «192.168.0.1» تحت زیرشبکه بالا به صورت «ws_test_network.1» چاپ می‌شود؛ اگر طول ماسک در بالا به جای ۲۴ برابر با ۱۶ بود، آدرس چاپ‌شده به صورت «ws_test_network.0.1» می‌بود.

تنظیمات این فایل‌ها در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

فایل subnets همچنین زمانی که تنظیمات کاربری IPv4 به نام Aggregate subnets in Statistics Dialogs (تجمیع زیرشبکه‌ها در کادرهای محاوره‌ای آمار) فعال باشد، رفتار کادرهای محاوره‌ای آمار Endpoints و Conversations را برای پروتکل IPv4 تغییر می‌دهد. در این حالت، هنگامی که یک آدرس IPv4 با یک زیرشبکه مطابقت داشته باشد، کادر محاوره‌ای آمار به جای آدرس IPv4، این زیرشبکه را نمایش خواهد داد.

  • tagrules.jsonc —

این فایل حاوی تمامی قوانین برچسب‌گذاری (Tagging rules) است که در پروفایل پیکربندی فعلی تعریف و ذخیره کرده‌اید. این فایل شامل آرایه‌ای از اشیاء JSON است که هر کدام یک قانون برچسب‌گذاری را با فرمت زیر نشان می‌دهند:

{ "Rule name": {
"filter": "<display filter string>",
"tag": "<emoji or short text shown in the packet list>",
"url": "<optional URL opened when the tag is clicked>",
"comment": "<optional comment>",
"enabled": "<boolean value>"
}
}

یک شیء اختیاری با نام prefs_for_tagging_rules تنظیمات مربوط به نحوه نمایش برچسب‌ها (separator، emoji_size و click) را نگهداری می‌کند.

هنگامی که دکمه OK را در کادر محاوره‌ای «Tagging Rules» فشار می‌دهید، تمامی قوانین برچسب‌گذاری فعلی در فایل شخصی tagrules.jsonc نوشته می‌شوند.

  • vlans —

وایرشارک از فایل vlans برای ترجمه شناسه‌های تگ VLAN به نام‌ها استفاده می‌کند.

اگر فایل vlans در پوشه پروفایل فعال فعلی وجود داشته باشد، از آن استفاده می‌شود. در غیر این صورت، از فایل vlans موجود در پوشه پیکربندی شخصی استفاده می‌گردد.

هر خط در این فایل شامل یک شناسه تگ VLAN و یک نام توصیفی است که با فاصله سفید یا تب از هم جدا شده‌اند.

یک مثال در ادامه آمده است:

123 Server-LAN
2049 HR-Client-LAN

تنظیمات این فایل زمانی خوانده می‌شوند که قرار باشد یک شناسه VLAN به یک نام ترجمه شود، و هرگز توسط وایرشارک نوشته نمی‌شوند.

  • wka —

در هنگام شروع برنامه، اگر فایل wka در پوشه پیکربندی سراسری وجود داشته باشد، خوانده می‌شود.

ورودی‌های این فایل برای ترجمه آدرس‌های MAC و پیشوندهای آدرس MAC به نام‌ها استفاده می‌شوند. فرمت این فایل همان فرمت فایل manuf است. این فایل به همراه وایرشارک توزیع می‌شود و حاوی داده‌هایی است که از منابع مختلف معتبر غیر از IEEE گردآوری شده‌اند.

تنظیمات این فایل در هنگام شروع برنامه خوانده می‌شوند، و هنگام باز کردن یک فایل کپچر جدید یا تغییر پروفایل پیکربندی مجدداً بارگذاری می‌گردند، و هرگز توسط وایرشارک نوشته نمی‌شوند.

ب.۴. پوشه‌های پلاگین (Plugin folders)

Section titled “ب.۴. پوشه‌های پلاگین (Plugin folders)”

وایرشارک از پلاگین‌ها برای اهداف گوناگون پشتیبانی می‌کند. پلاگین‌ها می‌توانند یا اسکریپت‌های نوشته‌شده به زبان Lua باشند و یا کدهای نوشته‌شده به زبان C یا C++ که به کد ماشین کامپایل شده‌اند.

وایرشارک هم در یک پوشه پلاگین شخصی و هم در یک پوشه پلاگین سراسری به دنبال پلاگین‌ها می‌گردد. پلاگین‌های Lua در خود پوشه‌های پلاگین ذخیره می‌شوند؛ پلاگین‌های کامپایل‌شده در زیرپوشه‌هایی از پوشه‌های پلاگین ذخیره می‌شوند که نام زیرپوشه برابر با شماره نسخه فرعی وایرشارک (X.Y) است. یک سطح سلسله‌مراتبی دیگر نیز برای هر نوع پلاگین وایرشارک (libwireshark، libwiretap و codecs) وجود دارد. بنابراین برای مثال، مکان یک پلاگین libwireshark با نام foo.so (foo.dll در ویندوز) برابر با مسیر PLUGINDIR/X.Y/epan خواهد بود (libwireshark در گذشته libepan نامیده می‌شد؛ نام سایر پوشه‌ها codecs و wiretap است).

در ویندوز:

  • پوشه پلاگین شخصی مسیر %APPDATA%\Wireshark\plugins است.
  • پوشه پلاگین سراسری مسیر WIRESHARK\plugins است.

در سیستم‌های شبه‌یونیکس:

  • پوشه پلاگین شخصی مسیر ~/.local/lib/wireshark/plugins است.
[Note]
توجه

برای ارائه پشتیبانی بهتر از پلاگین‌های باینری، این پوشه در وایرشارک ۲.۵ تغییر کرد. توصیه می‌شود از پوشه جدید استفاده کنید اما صرفاً برای اسکریپت‌های Lua می‌توانید جهت سازگاری رو به عقب همچنان از مسیر $XDG_CONFIG_HOME/wireshark/plugins استفاده نمایید. این قابلیت برای داشتن نسخه‌های قدیمی‌تر وایرشارک در کنار نسخه‌های جدید مفید است. در صورت وجود نام‌های فایل تکراری میان پوشه قدیم و جدید، پوشه جدید برنده و دارای اولویت است.

  • اگر از macOS استفاده می‌کنید و وایرشارک به صورت بسته برنامه (Application Bundle) نصب شده است، پوشه پلاگین سراسری مسیر %APPDIR%/Contents/PlugIns/wireshark است، در غیر این صورت مسیر INSTALLDIR/lib/wireshark/plugins خواهد بود.

ب.۵. پوشه‌های ویندوز (Windows folders)

Section titled “ب.۵. پوشه‌های ویندوز (Windows folders)”

در اینجا جزئیاتی درباره پوشه‌های مورد استفاده در وایرشارک بر روی نسخه‌های مختلف ویندوز خواهید یافت.

همان‌طور که پیش‌تر اشاره شد، می‌توانید پوشه‌هایی را که در حال حاضر استفاده می‌شوند در کادر محاوره‌ای «About Wireshark» پیدا کنید.

ب.۵.۱. پروفایل‌های ویندوز (Windows profiles)

Section titled “ب.۵.۱. پروفایل‌های ویندوز (Windows profiles)”

ویندوز از برخی دایرکتوری‌های ویژه برای ذخیره فایل‌های پیکربندی کاربر استفاده می‌کند که «پروفایل کاربر» (user profile) را تعریف می‌کنند. این موضوع می‌تواند گیج‌کننده باشد، چرا که مکان دایرکتوری پیش‌فرض از نسخه‌ای از ویندوز به نسخه دیگر تغییر کرده است و همچنین ممکن است برای نسخه‌های انگلیسی و بین‌المللی‌شده (ترجمه‌شده) ویندوز متفاوت باشد.

[Note]
توجه

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

موارد زیر شما را به مکان مناسب برای یافتن داده‌های پروفایل وایرشارک راهنمایی می‌کنند:

  • Windows 11، Windows 10، Windows 8.1، Windows 8، Windows 7، Windows Vista، و نسخه‌های سرور مرتبط — C:\Users*username**\AppData\Roaming\Wireshark*.

  • Windows XP و Windows Server 2003 [1] — C:\Documents and Settings*username**\Application Data*. عبارات «Documents and Settings» و «Application Data» ممکن است بسته به زبان سیستم‌عامل بین‌المللی (ترجمه) شده باشند.

ب.۵.۲. پروفایل‌های رومینگ ویندوز (Windows roaming profiles)

Section titled “ب.۵.۲. پروفایل‌های رومینگ ویندوز (Windows roaming profiles)”

برخی از محیط‌های بزرگ‌تر ویندوزی از پروفایل‌های رومینگ (Roaming profiles) استفاده می‌کنند. اگر چنین باشد، پیکربندی‌های تمامی برنامه‌هایی که استفاده می‌کنید بر روی دیسک سخت محلی شما ذخیره نخواهند شد، بلکه در عوض بر روی سرور دامنه (Domain server) ذخیره می‌شوند.

تنظیمات شما با یک استثنا، از رایانه‌ای به رایانه دیگر همراه شما منتقل خواهند شد. پوشه «Local Settings» در داده‌های پروفایل شما (معمولاً مسیری شبیه به: C:\Documents and Settings*username**\Local Settings*) به سرور دامنه منتقل نخواهد شد. این پوشه مکان پیش‌فرض برای فایل‌های کپچر موقت است.

ب.۵.۳. پوشه موقت ویندوز (Windows temporary folder)

Section titled “ب.۵.۳. پوشه موقت ویندوز (Windows temporary folder)”

وایرشارک از پوشه‌ای استفاده می‌کند که توسط متغیر محیطی TMPDIR یا TEMP تنظیم شده است. این متغیر توسط برنامه نصب‌کننده (Installer) ویندوز تنظیم می‌شود.

  • Windows 11، Windows 10، Windows 8.1، Windows 8، Windows 7، Windows Vista، و نسخه‌های سرور مرتبط — C:\Users*username**\AppData\Local\Temp*

  • Windows XP و Windows Server 2003 [1] — C:\Documents and Settings*username**\Local Settings\Temp*

(هیچ‌کدام)

[1] دیگر توسط وایرشارک پشتیبانی نمی‌شود. صرفاً جهت ارجاع تاریخی آورده شده است.

ترجمه فارسی Wireshark User's Guide — بر اساس نسخه 5.1.0تحت مجوز GNU GPL v2نسخه رسمی انگلیسی:wireshark.org