.TH syslog\-ng\-debun 1 "18 December 2025" 4.10.2 "راهنمای syslog\-ng\-debun"
.SH "نام (NAME)"
syslog\-ng\-debun \- تولیدکننده بسته اشکال‌زدایی syslog\-ng
.SH "خلاصه دستور (SYNOPSIS)"
.PP
syslog\-ng\-debun [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBنکته:\fP برنامه syslog\-ng\-debun همراه با برنامه ثبت گزارش سیستم syslog\-ng OSE توزیع می‌شود و معمولاً بخشی از بسته syslog\-ng OSE است. آخرین نسخه برنامه syslog\-ng OSE در صفحه syslog\-ng OSE در دسترس است.
.PP
این صفحه راهنما صرفاً یک چکیده است.
.PP
ابزار syslog\-ng\-debun اطلاعات مربوط به نصب syslog\-ng OSE شما را جمع‌آوری و ذخیره می‌کند تا عیب‌یابی را ساده‌تر سازد، به‌ویژه در مواردی که پیرامون مشکلات مربوط به syslog\-ng OSE درخواست کمک دارید.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.PP
\fB\fC\-r\fR
    اجرای syslog\-ng\-debun. استفاده از این گزینه برای اجرای واقعی فرایند جمع‌آوری داده‌ها با syslog\-ng\-debun الزامی است. این گزینه برای جلوگیری از اجرای تصادفی syslog\-ng\-debun در نظر گرفته شده است.
.PP
\fB\fC\-h\fR
    نمایش صفحه راهنما.
.PP
\fB\fC\-l\fR
    عدم جمع‌آوری داده‌های حساس به حریم خصوصی؛ مانند درخت پردازه‌ها (process tree)، fstab و غیره. در صورت استفاده هم‌زمان با \-d، پارامترهای زیر برای حالت اشکال‌زدایی استفاده خواهند شد: \-Fev
.PP
\fB\fC\-R <directory>\fR
    دایرکتوری محل نصب syslog\-ng PE به‌جای مسیر /opt/syslog\-ng.
.PP
\fB\fC\-W <directory>\fR
    تنظیم دایرکتوری کاری که بسته اشکال‌زدایی در آن ذخیره خواهد شد. مقدار پیش‌فرض: /tmp. نام فایل ایجادشده به این صورت خواهد بود:
    syslog.debun.${host}.${date}.${3\-random\-characters\-or\-pid}.tgz
.SH "گزینه‌های حالت اشکال‌زدایی (DEBUG MODE OPTIONS)"
.PP
\fB\fC\-d\fR
    شروع syslog\-ng OSE در حالت اشکال‌زدایی با استفاده از گزینه‌های \-Fedv \-\-enable\-core.
.PP
.RS
.nf
![](/assets/images/caution.png) **هشدار:**
استفاده از این گزینه تحت بار بالای پیام‌ها ممکن است ورودی/خروجی دیسک (disk I/O) را در طول
اشکال‌زدایی افزایش دهد، و بسته اشکال‌زدایی حاصل می‌تواند بسیار حجیم باشد. برای خروج از حالت
اشکال‌زدایی، کلید Enter را فشار دهید.
.fi
.RE
.PP
\fB\fC\-D <options>\fR
    شروع syslog\-ng OSE در حالت اشکال‌زدایی با استفاده از گزینه‌های خط فرمان مشخص‌شده. برای خروج از حالت اشکال‌زدایی، کلید Enter را فشار دهید.
.PP
\fB\fC\-t <seconds>\fR
    اجرای syslog\-ng OSE در حالت اشکال‌زدایی غیرتعاملی برای مدت <seconds> ثانیه، و خروج خودکار از حالت اشکال‌زدایی پس از پایان ثانیه‌های تعیین‌شده.
.PP
\fB\fC\-w <seconds>\fR
    انتظار به مدت <seconds> ثانیه پیش از شروع حالت اشکال‌زدایی.
.SH "ردیابی فراخوانی‌های سیستم (SYSTEM CALL TRACING)"
.PP
\fB\fC\-s\fR
    فعال‌سازی ردیابی فراخوانی‌های سیستم (strace \-f یا truss \-f). توجه داشته باشید که استفاده از \fB\fC\-s\fR به‌تنهایی حالت اشکال‌زدایی را فعال نمی‌کند، بلکه صرفاً فراخوانی‌های سیستمی یک پردازه در حال اجرای syslog\-ng OSE را ردیابی می‌کند. برای ردیابی فراخوانی‌های سیستم در حالت اشکال‌زدایی، از هر دو گزینه \fB\fC\-s\fR و \fB\fC\-d\fR با یکدیگر استفاده کنید.
.SH "گزینه‌های ضبط بسته‌ها (PACKET CAPTURE OPTIONS)"
.PP
ضبط بسته‌ها نیازمند یک ابزار ضبط بسته روی میزبان است. ابزار syslog\-ng\-debun در بیشتر پلتفرم‌ها تلاش می‌کند از tcpdump استفاده کند، به‌جز پلتفرم Solaris که در آن از snoop بهره می‌برد.
.PP
\fB\fC\-i <interface>\fR
    ضبط بسته‌ها تنها روی رابط شبکه مشخص‌شده، برای مثال eth0.
.PP
\fB\fC\-p\fR
    ضبط بسته‌های ورودی با استفاده از این پالایه (فیلتر): port 514 or port 601 or port 53
.PP
\fB\fC\-P <options>\fR
    ضبط بسته‌های ورودی با استفاده از پالایه مشخص‌شده.
.PP
\fB\fC\-t <seconds>\fR
    اجرای syslog\-ng OSE در حالت اشکال‌زدایی غیرتعاملی برای مدت <seconds> ثانیه، و خروج خودکار از حالت اشکال‌زدایی پس از پایان ثانیه‌های مشخص‌شده.
.SS "مثال‌ها (EXAMPLES)"
.PP
.RS
.nf
syslog\-ng\-debun \-r
.fi
.RE
.PP
ایجاد یک بسته اشکال‌زدایی ساده، شامل جمع‌آوری اطلاعاتی پیرامون محیط شما؛ برای مثال، فهرست بسته‌های حاوی واژه syslog، خروجی ldd برای باینری syslog و غیره.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-l
.fi
.RE
.PP
مشابه دستور syslog\-ng\-debun \-r، اما بدون جمع‌آوری اطلاعات حساس به حریم خصوصی. برای مثال، موارد زیر جمع‌آوری نمی‌شوند: fstab، خروجی df، اطلاعات mount، پیکربندی ip / رابط شبکه، اطلاعات DNS resolv و درخت پردازه‌ها.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-d
.fi
.RE
.PP
مشابه syslog\-ng\-debun \-r، با این تفاوت که ابتدا syslog\-ng OSE را متوقف کرده و سپس آن را در حالت اشکال‌زدایی (\-Fedv \-\-enable\-core) مجدداً راه‌اندازی می‌کند. برای متوقف کردن حالت اشکال‌زدایی، کلید Enter را فشار دهید. خروجی حالت اشکال‌زدایی در یک فایل جداگانه ذخیره شده و به بسته اشکال‌زدایی نیز افزوده می‌شود.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-s
.fi
.RE
.PP
ردیابی فراخوانی‌های سیستم (با استفاده از strace یا truss) برای یک پردازه syslog\-ng OSE که در حال حاضر در حال اجرا است.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-d \-s
.fi
.RE
.PP
راه‌اندازی مجدد syslog\-ng OSE در حالت اشکال‌زدایی و هم‌زمان ردیابی فراخوانی‌های سیستم (با استفاده از strace یا truss) پردازه syslog\-ng OSE.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-p
.fi
.RE
.PP
اجرای فرایند ضبط بسته‌ها (pcap) با پالایه: port 514 or port 601 or port 53. همانند حالت اشکال‌زدایی، تا زمان فشردن کلید Enter منتظر می‌ماند.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-p \-t 10
.fi
.RE
.PP
حالت اشکال‌زدایی غیرتعاملی: مشابه syslog\-ng\-debun \-r \-p، اما پس از ۱۰ ثانیه به‌طور خودکار خارج می‌شود.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-P "host 1.2.3.4"  \-D "\-Fev \-\-enable\-core"
.fi
.RE
.PP
تغییر پالایه ضبط بسته‌ها از پیش‌فرض به host 1.2.3.4. همچنین تغییر پارامترهای اشکال‌زدایی از پیش‌فرض به \-Fev \-\-enable\-core. از آنجا که محدودیت زمانی (\-t) تعیین نشده است، تا فشردن کلید Enter منتظر می‌ماند.
.PP
.RS
.nf
syslog\-ng\-debun \-r \-p \-d \-w 5 \-t 10
.fi
.RE
.PP
جمع‌آوری خروجی‌های pcap و حالت اشکال‌زدایی طبق سناریوی زیر:
.RS
.IP \(bu 2
شروع ضبط بسته‌ها با پارامترهای پیش‌فرض (\-p)
.IP \(bu 2
انتظار به مدت ۵ ثانیه (\-w 5)
.IP \(bu 2
توقف syslog\-ng
.IP \(bu 2
شروع syslog\-ng OSE در حالت اشکال‌زدایی با پارامترهای پیش‌فرض (\-d)
.IP \(bu 2
انتظار به مدت ۱۰ ثانیه (\-t 10)
.IP \(bu 2
توقف اشکال‌زدایی syslog\-ng OSE
.IP \(bu 2
شروع syslog\-ng OSE
.IP \(bu 2
توقف فرایند ضبط بسته‌ها
.RE
.SH "فایل‌ها (FILES)"
.PP
/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/loggen
.PP
\fBنکته:\fP
اگر با هرگونه مشکلی مواجه شدید یا برای syslog\-ng OSE به کمک نیاز داشتید، به \fIsyslog\-ng OSE Administration Guide\fP[1] مراجعه کنید، یا به \fIsyslog\-ng OSE mailing list\fP[2] بپیوندید.
برای اطلاع از اخبار و اطلاعیه‌های مربوط به syslog\-ng OSE، وبلاگ \fIsyslog\-ng OSE blogs\fP[3] را مشاهده فرمایید.
.SH "نویسندگان (AUTHORS)"
.PP
این صفحه راهنما بر اساس \fIsyslog\-ng OSE Administration Guide\fP[1] تولید شده است، که توسط چندین مشارکت‌کننده نگارش یافته و صمیمانه از آن‌ها قدردانی می‌شود.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.SH "نکات (NOTES)"
.PP
[1] \fB\fCsyslog\-ng OSE Administration Guide\fR
    \[la]https://syslog-ng.github.io/admin-guide/README\[ra]
.PP
[2] \fB\fCsyslog\-ng OSE mailing list\fR
    \[la]https://lists.balabit.hu/mailman/listinfo/syslog-ng\[ra]
.PP
[3] \fB\fCsyslog\-ng OSE blogs\fR
    \[la]https://syslog-ng.com/blog\[ra]