KDEBUGSETTINGS(1)        راهنمای کاربر KDebugSettings        KDEBUGSETTINGS(1)

نام (NAME)
       kdebugsettings - مدیریت و تنظیم خروجی‌های اشکال‌زدایی QLoggingCategory در
       KDE

خلاصه دستور (SYNOPSIS)
       kdebugsettings [--list] [--enable-full-debug] [--disable-full-debug]
                      [--debug-mode حالت دسته‌بندی...] [--test-mode] [گزینه‌های
                      عمومی]

توضیحات (DESCRIPTION)
       برنامه kdebugsettings ابزاری برای محیط رومیزی KDE است که امکان پیکربندی
       و مدیریت پیام‌های اشکال‌زدایی و لاگ‌های برنامه‌ها و کتابخانه‌های مبتنی بر Qt
       و KDE را بدون نیاز به کامپایل مجدد آن‌ها فراهم می‌کند.

       برنامه‌های مدرن KDE و Qt خروجی‌های اشکال‌زدایی خود را در قالب «دسته‌بندی‌های
       وقایع‌نگاری» (QLoggingCategory) گروه‌بندی می‌کنند. با استفاده از
       kdebugsettings می‌توان مشخص کرد که کدام دسته‌بندی‌ها فعال یا غیرفعال باشند
       و پیام‌ها با چه سطح حساسیتی (Debug, Info, Warning, Critical) نمایش داده
       شوند.

       این برنامه تنظیمات را در فایل ~/.config/qtlogging.ini ذخیره می‌کند.
       علاوه بر رابط کاربری گرافیکی (GUI)، این ابزار گزینه‌های خط فرمان متنوعی
       را برای مشاهده و تغییر قوانین بدون باز کردن پنجره برنامه ارائه می‌دهد.

گزینه‌ها (OPTIONS)
       --list چاپ نام تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده در خروجی استاندارد
              و خروج بدون اعمال هیچ تغییری.

       --enable-full-debug
              تنظیم تمام دسته‌بندی‌های شناخته‌شده روی حالت اشکال‌زدایی کامل (Full
              Debug) و خروج از برنامه.

       --disable-full-debug
              خاموش کردن (Off) تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده و خروج از
              برنامه.

       --debug-mode حالت دسته‌بندی...
              تنظیم سطح اشکال‌زدایی مشخص‌شده روی دسته‌بندی‌های ذکرشده و خروج از
              برنامه.  مقادیر مجاز برای حالت عبارتند از: Full، Info، Warning،
              Critical یا Off.  حداقل نام یک دسته‌بندی باید به عنوان آرگومان
              مشخص شود.

       --test-mode
              فعال‌سازی حالت آزمایشی QStandardPaths جهت استفاده از تنظیمات
              آزمون‌های واحد به جای تنظیمات واقعی کاربر.

       -h, --help
              نمایش پیام راهنما درباره گزینه‌های خط فرمان و خروج.

       -v, --version
              نمایش اطلاعات نسخه برنامه و خروج.

       --author
              نمایش اطلاعات نویسندگان برنامه.

       --license
              نمایش اطلاعات مجوز برنامه.

فایل‌ها (FILES)
       ~/.config/qtlogging.ini
              فایل پیکربندی محلی کاربر که قوانین وقایع‌نگاری کیوت در آن ذخیره
              می‌شوند.

       /usr/share/qlogging-categories6/
              دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها (.categories) برای
              برنامه‌های مبتنی بر KDE Frameworks 6.

       /usr/share/qlogging-categories5/
              دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها برای برنامه‌های
              مبتنی بر KDE Frameworks 5.

متغیرهای محیطی (ENVIRONMENT)
       QT_LOGGING_RULES
              قوانین موقت وقایع‌نگاری کیوت را برای نشست یا پردازش جاری مشخص
              می‌کند و بر تنظیمات ذخیره‌شده در فایل qtlogging.ini ارجحیت دارد.

مثال‌ها (EXAMPLES)
       مشاهده فهرست تمامی دسته‌بندی‌های وقایع‌نگاری موجود در سیستم:

           kdebugsettings --list

       فعال‌سازی اشکال‌زدایی کامل برای دسته‌بندی‌های مربوط به KMail و پلاسما:

           kdebugsettings --debug-mode Full org.kde.pim.kmail org.kde.plasma

       غیرفعال‌سازی تمام پیام‌های اشکال‌زدایی در سراسر سیستم:

           kdebugsettings --disable-full-debug

همچنین ببینید (SEE ALSO)
       مستندات کامل در وب‌سایت رسمی KDE:

           <https://docs.kde.org/trunk_kf6/en/kdebugsettings/kdebugsettings>

نویسندگان (AUTHORS)
       برنامه kdebugsettings توسط Laurent Montel <montel@kde.org> نوشته شده
       است.

       این صفحه راهنما توسط تیم ترجمه صفحات راهنمای پارچ لینوکس به فارسی ترجمه
       و مستندسازی شده است.

گزارش اشکالات (REPORTING BUGS)
       گزارش اشکالات و پیشنهادات را به سامانه ردیابی خطاهای KDE ارسال کنید:

           <https://bugs.kde.org>

KDE Applications                  2026-10-08                 KDEBUGSETTINGS(1)