| 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
- نمایش اطلاعات نسخه برنامه و خروج.
- نمایش اطلاعات نویسندگان برنامه.
- --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:
نویسندگان (AUTHORS)
برنامه kdebugsettings توسط Laurent Montel نوشته شده است.
این صفحه راهنما توسط تیم ترجمه صفحات راهنمای پارچ لینوکس به فارسی ترجمه و مستندسازی شده است.
گزارش اشکالات (REPORTING BUGS)
گزارش اشکالات و پیشنهادات را به سامانه ردیابی خطاهای KDE ارسال کنید:
| 2026-10-08 | KDE Applications |