نام (NAME)

syslog-ng-debun - تولیدکننده بسته اشکال‌زدایی syslog-ng

خلاصه دستور (SYNOPSIS)

syslog-ng-debun [گزینه‌ها]

توضیحات (DESCRIPTION)

نکته: برنامه syslog-ng-debun همراه با برنامه ثبت گزارش سیستم syslog-ng OSE توزیع می‌شود و معمولاً بخشی از بسته syslog-ng OSE است. آخرین نسخه برنامه syslog-ng OSE در صفحه syslog-ng OSE در دسترس است.

این صفحه راهنما صرفاً یک چکیده است.

ابزار syslog-ng-debun اطلاعات مربوط به نصب syslog-ng OSE شما را جمع‌آوری و ذخیره می‌کند تا عیب‌یابی را ساده‌تر سازد، به‌ویژه در مواردی که پیرامون مشکلات مربوط به syslog-ng OSE درخواست کمک دارید.

گزینه‌های عمومی (GENERAL OPTIONS)

-r
اجرای syslog-ng-debun. استفاده از این گزینه برای اجرای واقعی فرایند جمع‌آوری داده‌ها با syslog-ng-debun الزامی است. این گزینه برای جلوگیری از اجرای تصادفی syslog-ng-debun در نظر گرفته شده است.

-h
نمایش صفحه راهنما.

-l
عدم جمع‌آوری داده‌های حساس به حریم خصوصی؛ مانند درخت پردازه‌ها (process tree)، fstab و غیره. در صورت استفاده هم‌زمان با -d، پارامترهای زیر برای حالت اشکال‌زدایی استفاده خواهند شد: -Fev

-R <directory>
دایرکتوری محل نصب syslog-ng PE به‌جای مسیر /opt/syslog-ng.

-W <directory>
تنظیم دایرکتوری کاری که بسته اشکال‌زدایی در آن ذخیره خواهد شد. مقدار پیش‌فرض: /tmp. نام فایل ایجادشده به این صورت خواهد بود:
syslog.debun.${host}.${date}.${3-random-characters-or-pid}.tgz

گزینه‌های حالت اشکال‌زدایی (DEBUG MODE OPTIONS)

-d
شروع syslog-ng OSE در حالت اشکال‌زدایی با استفاده از گزینه‌های -Fedv --enable-core.

![](/assets/images/caution.png) **هشدار:**
استفاده از این گزینه تحت بار بالای پیام‌ها ممکن است ورودی/خروجی دیسک (disk I/O) را در طول
اشکال‌زدایی افزایش دهد، و بسته اشکال‌زدایی حاصل می‌تواند بسیار حجیم باشد. برای خروج از حالت
اشکال‌زدایی، کلید Enter را فشار دهید.

-D <options>
شروع syslog-ng OSE در حالت اشکال‌زدایی با استفاده از گزینه‌های خط فرمان مشخص‌شده. برای خروج از حالت اشکال‌زدایی، کلید Enter را فشار دهید.

-t <seconds>
اجرای syslog-ng OSE در حالت اشکال‌زدایی غیرتعاملی برای مدت <seconds> ثانیه، و خروج خودکار از حالت اشکال‌زدایی پس از پایان ثانیه‌های تعیین‌شده.

-w <seconds>
انتظار به مدت <seconds> ثانیه پیش از شروع حالت اشکال‌زدایی.

ردیابی فراخوانی‌های سیستم (SYSTEM CALL TRACING)

-s
فعال‌سازی ردیابی فراخوانی‌های سیستم (strace -f یا truss -f). توجه داشته باشید که استفاده از -s به‌تنهایی حالت اشکال‌زدایی را فعال نمی‌کند، بلکه صرفاً فراخوانی‌های سیستمی یک پردازه در حال اجرای syslog-ng OSE را ردیابی می‌کند. برای ردیابی فراخوانی‌های سیستم در حالت اشکال‌زدایی، از هر دو گزینه -s و -d با یکدیگر استفاده کنید.

گزینه‌های ضبط بسته‌ها (PACKET CAPTURE OPTIONS)

ضبط بسته‌ها نیازمند یک ابزار ضبط بسته روی میزبان است. ابزار syslog-ng-debun در بیشتر پلتفرم‌ها تلاش می‌کند از tcpdump استفاده کند، به‌جز پلتفرم Solaris که در آن از snoop بهره می‌برد.

-i <interface>
ضبط بسته‌ها تنها روی رابط شبکه مشخص‌شده، برای مثال eth0.

-p
ضبط بسته‌های ورودی با استفاده از این پالایه (فیلتر): port 514 or port 601 or port 53

-P <options>
ضبط بسته‌های ورودی با استفاده از پالایه مشخص‌شده.

-t <seconds>
اجرای syslog-ng OSE در حالت اشکال‌زدایی غیرتعاملی برای مدت <seconds> ثانیه، و خروج خودکار از حالت اشکال‌زدایی پس از پایان ثانیه‌های مشخص‌شده.

مثال‌ها (EXAMPLES)

syslog-ng-debun -r

ایجاد یک بسته اشکال‌زدایی ساده، شامل جمع‌آوری اطلاعاتی پیرامون محیط شما؛ برای مثال، فهرست بسته‌های حاوی واژه syslog، خروجی ldd برای باینری syslog و غیره.

syslog-ng-debun -r -l

مشابه دستور syslog-ng-debun -r، اما بدون جمع‌آوری اطلاعات حساس به حریم خصوصی. برای مثال، موارد زیر جمع‌آوری نمی‌شوند: fstab، خروجی df، اطلاعات mount، پیکربندی ip / رابط شبکه، اطلاعات DNS resolv و درخت پردازه‌ها.

syslog-ng-debun -r -d

مشابه syslog-ng-debun -r، با این تفاوت که ابتدا syslog-ng OSE را متوقف کرده و سپس آن را در حالت اشکال‌زدایی (-Fedv --enable-core) مجدداً راه‌اندازی می‌کند. برای متوقف کردن حالت اشکال‌زدایی، کلید Enter را فشار دهید. خروجی حالت اشکال‌زدایی در یک فایل جداگانه ذخیره شده و به بسته اشکال‌زدایی نیز افزوده می‌شود.

syslog-ng-debun -r -s

ردیابی فراخوانی‌های سیستم (با استفاده از strace یا truss) برای یک پردازه syslog-ng OSE که در حال حاضر در حال اجرا است.

syslog-ng-debun -r -d -s

راه‌اندازی مجدد syslog-ng OSE در حالت اشکال‌زدایی و هم‌زمان ردیابی فراخوانی‌های سیستم (با استفاده از strace یا truss) پردازه syslog-ng OSE.

syslog-ng-debun -r -p

اجرای فرایند ضبط بسته‌ها (pcap) با پالایه: port 514 or port 601 or port 53. همانند حالت اشکال‌زدایی، تا زمان فشردن کلید Enter منتظر می‌ماند.

syslog-ng-debun -r -p -t 10

حالت اشکال‌زدایی غیرتعاملی: مشابه syslog-ng-debun -r -p، اما پس از ۱۰ ثانیه به‌طور خودکار خارج می‌شود.

syslog-ng-debun -r -P "host 1.2.3.4"  -D "-Fev --enable-core"

تغییر پالایه ضبط بسته‌ها از پیش‌فرض به host 1.2.3.4. همچنین تغییر پارامترهای اشکال‌زدایی از پیش‌فرض به -Fev --enable-core. از آنجا که محدودیت زمانی (-t) تعیین نشده است، تا فشردن کلید Enter منتظر می‌ماند.

syslog-ng-debun -r -p -d -w 5 -t 10

جمع‌آوری خروجی‌های pcap و حالت اشکال‌زدایی طبق سناریوی زیر:

شروع ضبط بسته‌ها با پارامترهای پیش‌فرض (-p)
انتظار به مدت ۵ ثانیه (-w 5)
توقف syslog-ng
شروع syslog-ng OSE در حالت اشکال‌زدایی با پارامترهای پیش‌فرض (-d)
انتظار به مدت ۱۰ ثانیه (-t 10)
توقف اشکال‌زدایی syslog-ng OSE
شروع syslog-ng OSE
توقف فرایند ضبط بسته‌ها

فایل‌ها (FILES)

/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/loggen

نکته: اگر با هرگونه مشکلی مواجه شدید یا برای syslog-ng OSE به کمک نیاز داشتید، به syslog-ng OSE Administration Guide[1] مراجعه کنید، یا به syslog-ng OSE mailing list[2] بپیوندید. برای اطلاع از اخبار و اطلاعیه‌های مربوط به syslog-ng OSE، وبلاگ syslog-ng OSE blogs[3] را مشاهده فرمایید.

نویسندگان (AUTHORS)

این صفحه راهنما بر اساس syslog-ng OSE Administration Guide[1] تولید شده است، که توسط چندین مشارکت‌کننده نگارش یافته و صمیمانه از آن‌ها قدردانی می‌شود.

کپی‌رایت و تکثیر (COPYRIGHT)

نکات (NOTES)

[1] syslog-ng OSE Administration Guide
⟨https://syslog-ng.github.io/admin-guide/README⟩

[2] syslog-ng OSE mailing list
⟨https://lists.balabit.hu/mailman/listinfo/syslog-ng⟩

[3] syslog-ng OSE blogs
⟨https://syslog-ng.com/blog⟩