dqtool(1)                    راهنمای ابزار dqtool                    dqtool(1)

نام (NAME)
       dqtool - ابزار بررسی و دستکاری صف‌های دیسک در syslog-ng

خلاصه دستور (SYNOPSIS)
       dqtool [دستور] [گزینه‌ها]

توضیحات (DESCRIPTION)
       نکته: برنامه dqtool همراه با برنامه ثبت وقایع سیستمی syslog-ng OSE
       توزیع می‌شود و معمولاً بخشی از بسته syslog-ng OSE است. آخرین نسخه برنامه
       syslog-ng OSE در صفحه وب syslog-ng OSE در دسترس است.

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

       برنامه dqtool ابزاری است که می‌تواند برای نمایش و قالب‌بندی پیام‌های
       ذخیره‌شده در یک فایل بافر دیسک (disk-buffer) استفاده شود.

دستور CAT (THE CAT COMMAND)
              cat [options] [file]

       از دستور cat برای نمایش پیام‌های ثبت وقایع ذخیره‌شده در فایل بافر دیسک
       (که صف دیسک یا disk-queue نیز نامیده می‌شود) و همچنین اطلاعات سربرگ فایل
       صف دیسک استفاده کنید. پیام‌ها در خروجی استاندارد (stdout) چاپ می‌شوند،
       بنابراین امکان استفاده از grep و سایر ابزارها برای یافتن پیام‌های وقایع
       خاص وجود دارد؛ برای مثال: dqtool cat /var/log/messages.lgs | grep
       192.168.1.1.

       دستور cat دارای گزینه‌های زیر است:

       --debug یا -d
           چاپ پیام‌های تشخیصی و اشکال‌زدایی در stderr.

       --help یا -h
           نمایش یک پیام راهنمای خلاصه.

       --template=<template> یا -t
           قالب‌بندی پیام‌ها با استفاده از الگوی مشخص‌شده.

       --verbose یا -v
           چاپ پیام‌های مشروح در stderr.

       --version یا -V
           نمایش اطلاعات نسخه.

   مثال (EXAMPLE)
              dqtool cat ../var/syslog-ng-00000.qf

       خروجی مشابه زیر خواهد بود:

              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

دستور RELOCATE (THE RELOCATE COMMAND)
              relocate [options] [files]

       از دستور relocate برای انتقال یا تغییر نام فایل‌های بافر دیسک (صف دیسک)
       استفاده کنید. توجه داشته باشید که این گزینه فایل persist را تغییر
       می‌دهد. پیش از استفاده از این دستور، اجرای syslog-ng OSE را متوقف کنید.

       دستور relocate دارای گزینه‌های زیر است:

       --all یا -a
           انتقال تمامی فایل‌های بافر دیسک که در فایل persist مربوط به
       syslog-ng OSE فهرست شده‌اند.

       --new_path یا -n
           دایرکتوری مقصدی که می‌خواهید فایل‌های بافر دیسک را به آن منتقل کنید.
       برای مثال: /var/disk-buffers

       --persist یا -p
           مسیر فایل persist مربوط به syslog-ng OSE. دستور relocate به طور
       خودکار ورودی‌های فایل‌های بافر دیسک را در فایل persist به‌روزرسانی می‌کند.

   مثال‌ها (EXAMPLES)
       انتقال یک فایل صف منفرد:

              dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist /tmp/syslog-ng-00000.rqf

       انتقال چندین فایل صف:

              dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist /tmp/syslog-ng-00000.rqf /tmp/syslog-ng-00001.rqf

       انتقال تمامی فایل‌های صف:

              dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist --all

فایل‌ها (FILES)
       /Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/dqtool

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

نویسنده (AUTHOR)
       این صفحه راهنما از راهنمای مدیریت syslog-ng OSE[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⟩

4.10.2                         18 December 2025                      dqtool(1)