.TH dqtool 1 "18 December 2025" 4.10.2 "راهنمای ابزار dqtool"
.SH "نام (NAME)"
.PP
dqtool \- ابزار بررسی و دستکاری صف‌های دیسک در syslog-ng
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBdqtool\fP [\fIدستور\fP] [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBنکته:\fP برنامه dqtool همراه با برنامه ثبت وقایع سیستمی syslog\-ng OSE توزیع می‌شود و معمولاً بخشی از بسته syslog\-ng OSE است. آخرین نسخه برنامه syslog\-ng OSE در صفحه وب syslog\-ng OSE در دسترس است.
.PP
این صفحه راهنما صرفاً یک چکیده است.
.PP
برنامه dqtool ابزاری است که می‌تواند برای نمایش و قالب‌بندی پیام‌های ذخیره‌شده در یک فایل بافر دیسک (disk\-buffer) استفاده شود.
.SH "دستور CAT (THE CAT COMMAND)"
.PP
.RS
.nf
cat [options] [file]
.fi
.RE
.PP
از دستور cat برای نمایش پیام‌های ثبت وقایع ذخیره‌شده در فایل بافر دیسک (که صف دیسک یا disk\-queue نیز نامیده می‌شود) و همچنین اطلاعات سربرگ فایل صف دیسک استفاده کنید. پیام‌ها در خروجی استاندارد (stdout) چاپ می‌شوند، بنابراین امکان استفاده از grep و سایر ابزارها برای یافتن پیام‌های وقایع خاص وجود دارد؛ برای مثال: \fBdqtool cat /var/log/messages.lgs | grep 192.168.1.1\fP\&.
.PP
دستور cat دارای گزینه‌های زیر است:
.PP
\fB\fC\-\-debug\fR یا \fB\fC\-d\fR
    چاپ پیام‌های تشخیصی و اشکال‌زدایی در stderr.
.PP
\fB\fC\-\-help\fR یا \fB\fC\-h\fR
    نمایش یک پیام راهنمای خلاصه.
.PP
\fB\fC\-\-template=<template>\fR یا \fB\fC\-t\fR
    قالب‌بندی پیام‌ها با استفاده از الگوی مشخص‌شده.
.PP
\fB\fC\-\-verbose\fR یا \fB\fC\-v\fR
    چاپ پیام‌های مشروح در stderr.
.PP
\fB\fC\-\-version\fR یا \fB\fC\-V\fR
    نمایش اطلاعات نسخه.
.SS "مثال (EXAMPLE)"
.PP
.RS
.nf
dqtool cat ../var/syslog\-ng\-00000.qf
.fi
.RE
.PP
خروجی مشابه زیر خواهد بود:
.PP
.RS
.nf
Disk\-buffer state loaded;
filename='../var/syslog\-ng\-00000.qf', qout_length='65', qbacklog_length='0', qoverflow_length='9205', qdisk_length='0'
Mar  3 10:52:05 tristram localprg[1234]: seq: 0000011630, runid: 1267609923, stamp: 2010\-03\-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD
Mar  3 10:52:05 tristram localprg[1234]: seq: 0000011631, runid: 1267609923, stamp: 2010\-03\-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD
.fi
.RE
.SH "دستور RELOCATE (THE RELOCATE COMMAND)"
.PP
.RS
.nf
relocate [options] [files]
.fi
.RE
.PP
از دستور relocate برای انتقال یا تغییر نام فایل‌های بافر دیسک (صف دیسک) استفاده کنید. توجه داشته باشید که این گزینه فایل persist را تغییر می‌دهد. پیش از استفاده از این دستور، اجرای syslog\-ng OSE را متوقف کنید.
.PP
دستور relocate دارای گزینه‌های زیر است:
.PP
\fB\fC\-\-all\fR یا \fB\fC\-a\fR
    انتقال تمامی فایل‌های بافر دیسک که در فایل persist مربوط به syslog\-ng OSE فهرست شده‌اند.
.PP
\fB\fC\-\-new_path\fR یا \fB\fC\-n\fR
    دایرکتوری مقصدی که می‌خواهید فایل‌های بافر دیسک را به آن منتقل کنید. برای مثال: /var/disk\-buffers
.PP
\fB\fC\-\-persist\fR یا \fB\fC\-p\fR
    مسیر فایل persist مربوط به syslog\-ng OSE. دستور relocate به طور خودکار ورودی‌های فایل‌های بافر دیسک را در فایل persist به‌روزرسانی می‌کند.
.SS "مثال‌ها (EXAMPLES)"
.PP
انتقال یک فایل صف منفرد:
.PP
.RS
.nf
dqtool relocate \-\-new_path /tmp/dq \-\-persist var/syslog\-ng.persist /tmp/syslog\-ng\-00000.rqf
.fi
.RE
.PP
انتقال چندین فایل صف:
.PP
.RS
.nf
dqtool relocate \-\-new_path /tmp/dq \-\-persist var/syslog\-ng.persist /tmp/syslog\-ng\-00000.rqf /tmp/syslog\-ng\-00001.rqf
.fi
.RE
.PP
انتقال تمامی فایل‌های صف:
.PP
.RS
.nf
dqtool relocate \-\-new_path /tmp/dq \-\-persist var/syslog\-ng.persist \-\-all
.fi
.RE
.SH "فایل‌ها (FILES)"
.PP
/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/dqtool
.PP
\fBنکته:\fP
اگر با هرگونه مشکلی مواجه شدید یا به راهنمایی درباره syslog\-ng OSE نیاز دارید، به \fIراهنمای مدیریت syslog\-ng OSE\fP[1] مراجعه کنید یا از \fIلیست ایمیل syslog\-ng OSE\fP[2] دیدن فرمایید.
برای اخبار و اطلاعیه‌های مربوط به syslog\-ng OSE، از \fIوبلاگ‌های syslog\-ng OSE\fP[3] بازدید نمایید.
.SH "نویسنده (AUTHOR)"
.PP
این صفحه راهنما از \fIراهنمای مدیریت syslog\-ng OSE\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]