رفتن به محتوا

پیش‌گفتار (Preface)

  1. پیش‌گفتار نویسندگان
  2. چه کسانی باید این سند را بخوانند؟
  3. قدردانی و تشکرها
  4. درباره این سند
  5. جدیدترین نسخه این سند را از کجا دریافت کنیم؟
  6. ارائه بازخورد درباره این سند
  7. قراردادهای نگارشی و تایپوگرافی

وایرشارک (Wireshark) برترین و پیشروترین تحلیل‌گر پروتکل شبکه در جهان است، اما مجموعه غنی از قابلیت‌های آن می‌تواند برای کاربران ناآشنا کمی گیج‌کننده یا دلهره‌آور باشد.

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


۲. چه کسانی باید این سند را بخوانند؟ (Who should read this document?)

Section titled “۲. چه کسانی باید این سند را بخوانند؟ (Who should read this document?)”

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

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

این کتاب قصد ندارد مبانی شنود شبکه (Network Sniffing) را به طور عمومی آموزش دهد و وارد جزئیات تک‌تک پروتکل‌های خاص شبکه نخواهد شد. اطلاعات مفید و فراوانی در رابطه با این موضوعات در وب‌سایت ویکی وایرشارک به آدرس https://wiki.wireshark.org/ در دسترس است.

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


۳. قدردانی و تشکرها (Acknowledgements)

Section titled “۳. قدردانی و تشکرها (Acknowledgements)”

نویسندگان مایلند از کل تیم وایرشارک برای کمک‌ها و راهنمایی‌هایشان تشکر کنند. به‌ویژه، نویسندگان صمیمانه قدردان افراد زیر هستند:

  • جرالد کامبز (Gerald Combs): برای پایه‌گذاری و آغاز پروژه وایرشارک و تأمین منابع مالی جهت نگارش این مستندات.
  • گای هریس (Guy Harris): برای نکات مفید بی‌شمار و شکیبایی بسیار بالا در بازبینی و بررسی این سند.
  • گیلبرت رامیرز (Gilbert Ramirez): برای تشویق‌های همیشگی و راهنمایی‌های سودمند در طول این مسیر.

نویسندگان همچنین می‌خواهند از افراد زیر به خاطر بازخوردهای مفیدشان درباره این سند تشکر نمایند:

  • پت ایلیر (Pat Eyler): برای پیشنهاداتش در بهبود مثال‌های مربوط به تولید Backtrace.
  • مارتین رگنر (Martin Regner): برای اصلاحات و پیشنهادات گوناگون.
  • گریم هیوسون (Graeme Hewson): برای اصلاحات دستوری فراوان در متن انگلیسی.

نویسندگان همچنین از نویسندگان صفحات Man و راهنماهای README پروژه وایرشارک که بخش‌هایی از این سند به شدت از آثار آن‌ها بهره برده است، تشکر و قدردانی می‌کنند:

  • اسکات رنفرو (Scott Renfro): که بخش D.9 مستندات با عنوان «mergecap: ادغام چندین فایل کپچر در یک فایل» از صفحه Man نوشته‌شده توسط او اقتباس شده است.
  • آشوک نارایانان (Ashok Narayanan): که بخش D.10 مستندات با عنوان «text2pcap: تبدیل هگز‌دمپ اسکی به کپچرهای شبکه» از صفحه Man نوشته‌شده توسط او گرفته شده است.

۴. درباره این سند (About this document)

Section titled “۴. درباره این سند (About this document)”

این سند با فرمت DocBook/AsciiDoc نگارش یافته است.

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

این ترجمه فارسی بر اساس نسخه 5.1.0 راهنمای کاربری انگلیسی وایرشارک (Wireshark User’s Guide) تهیه شده است. نسخه انگلیسی رسمی در نشانی https://www.wireshark.org/docs/wsug_html_chunked/ در دسترس است.


۵. جدیدترین نسخه این سند را از کجا دریافت کنیم؟ (Where to get the latest copy of this document?)

Section titled “۵. جدیدترین نسخه این سند را از کجا دریافت کنیم؟ (Where to get the latest copy of this document?)”

جدیدترین نسخه این سند همیشه به شکل نسخه‌های آنلاین در قالب‌های HTML یا PDF در وب‌سایت وایرشارک به نشانی https://www.wireshark.org/docs/ قرار می‌گیرد.


۶. ارائه بازخورد درباره این سند (Providing feedback about this document)

Section titled “۶. ارائه بازخورد درباره این سند (Providing feedback about this document)”

در صورتی که دیدگاه، نظر یا پیشنهادی در رابطه با این سند دارید، بسیار خوشحال می‌شویم که آن را از شما بشنویم! لطفاً نظرات و گزارش خطاهای خود را از طریق بخش ردیابی مشکلات و باگ‌های گیت‌لب وایرشارک ثبت نمایید:

https://gitlab.com/wireshark/wireshark/-/issues


۷. قراردادهای نگارشی و تایپوگرافی (Typographic Conventions)

Section titled “۷. قراردادهای نگارشی و تایپوگرافی (Typographic Conventions)”

در سراسر این راهنما از قراردادهای نگارشی زیر برای تمایز مفاهیم و عناصر مختلف استفاده شده است:

شیوه نمایش کاربرد مثال
ایتالیک (Italic) برای نام فایل‌ها، پوشه‌ها و مسیرها؛ نام‌ها و آدرس‌های کامل اینترنتی؛ موارد تأکیدی جدید. فایل را در پوشه C:\Program Files\Wireshark ذخیره کنید.
تک‌فاصله (Monospace) دستورات خط فرمان، سوئیچ‌ها و پرچم‌ها (Flags)، متغیرهای محیطی. گزینه -G در CMake.
تک‌فاصله پررنگ (Bold Monospace) دستوراتی که باید صریحاً توسط کاربر در خط فرمان اجرا شوند. اجرای دستور cmake -G Ninja .. در ترمینال.
دکمه‌ها (Button) دکمه‌های پنجره‌ها و کادرهای محاوره‌ای در رابط کاربری. دکمه Launch را برای شروع فرآیند فشار دهید.
کلید (Key) میانبرهای صفحه‌کلید. کلیدهای ترکیبی Ctrl + Down را برای رفتن به بسته بعدی فشار دهید.
منوها (Menu) آیتم‌های منو و سلسله‌مراتب دسترسی. مسیر Go → Next Packet را برای رفتن به بسته بعدی انتخاب کنید.

۷.۱. کادرهای اخطار و راهنما (Admonitions)

Section titled “۷.۱. کادرهای اخطار و راهنما (Admonitions)”

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

[Warning]
این یک اخطار است (Warning)

شما باید به هشدارها توجه جدی داشته باشید، در غیر این صورت ممکن است از دست رفتن داده‌ها (Data Loss) رخ دهد.

[Caution]
این یک احتیاط است (Caution)

با احتیاط عمل کنید (مستلزم دقت و مراقبت در اجرای دستورات است).

[Important]
این یک اطلاعات مهم است (Important)

RTFM - مطالعه دقیق دفترچه راهنما الزامی است (Read The Fine Manual).

[Tip]
این یک ترفند است (Tip)

ترفندها برای کارهای روزمره شما با وایرشارک بسیار کاربردی و سرعت‌بخش هستند.

[Note]
این یک یادداشت است (Note)

یادداشت‌ها شما را به اشتباهات متداول و مواردی که ممکن است در نگاه اول آشکار نباشند هدایت می‌کنند.


۷.۲. نمونه‌های خط فرمان و کدهای برنامه‌نویسی (Shell Prompt and Source Code Examples)

Section titled “۷.۲. نمونه‌های خط فرمان و کدهای برنامه‌نویسی (Shell Prompt and Source Code Examples)”

پوسته Bourne Shell (کاربر عادی):

Terminal window
$ # این یک کامنت است
$ git config --global log.abbrevcommit true

پوسته Bourne Shell (کاربر روت / Root):

Terminal window
# # این یک کامنت است
# ninja install

محیط Command Prompt ویندوز (cmd.exe):

Terminal window
>rem این یک کامنت است
>cd C:\Development

پاورشل ویندوز (PowerShell):

Terminal window
PS$># این یک کامنت است
PS$> choco list -l

کد منبع زبان C:

#include "config.h"
/* This method dissects foos */
static int
dissect_foo_message(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree _U_, void *data _U_)
{
/* TODO: implement your dissecting code */
return tvb_captured_length(tvb);
}

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