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

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

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

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

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

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

چاپ نام تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده در خروجی استاندارد و خروج بدون اعمال هیچ تغییری.
تنظیم تمام دسته‌بندی‌های شناخته‌شده روی حالت اشکال‌زدایی کامل (Full Debug) و خروج از برنامه.
خاموش کردن (Off) تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده و خروج از برنامه.
تنظیم سطح اشکال‌زدایی مشخص‌شده روی دسته‌بندی‌های ذکرشده و خروج از برنامه. مقادیر مجاز برای حالت عبارتند از: Full، Info، Warning، Critical یا Off. حداقل نام یک دسته‌بندی باید به عنوان آرگومان مشخص شود.
فعال‌سازی حالت آزمایشی QStandardPaths جهت استفاده از تنظیمات آزمون‌های واحد به جای تنظیمات واقعی کاربر.
نمایش پیام راهنما درباره گزینه‌های خط فرمان و خروج.
نمایش اطلاعات نسخه برنامه و خروج.
نمایش اطلاعات نویسندگان برنامه.
نمایش اطلاعات مجوز برنامه.

~/.config/qtlogging.ini
فایل پیکربندی محلی کاربر که قوانین وقایع‌نگاری کیوت در آن ذخیره می‌شوند.
/usr/share/qlogging-categories6/
دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها (.categories) برای برنامه‌های مبتنی بر KDE Frameworks 6.
/usr/share/qlogging-categories5/
دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها برای برنامه‌های مبتنی بر KDE Frameworks 5.

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

مشاهده فهرست تمامی دسته‌بندی‌های وقایع‌نگاری موجود در سیستم:

kdebugsettings --list

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

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

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

kdebugsettings --disable-full-debug

مستندات کامل در وب‌سایت رسمی KDE:

برنامه kdebugsettings توسط Laurent Montel نوشته شده است.

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

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

2026-10-08 KDE Applications