نام (NAME)

tlpctl - کنترل و مدیریت نمایه‌های TLP

خلاصه دستور (SYNOPSIS)

tlpctl [-h] command [options] [args]

توضیحات (DESCRIPTION)

tlpctl یک ابزار خط فرمانی برای کنترل نمایه‌های TLP است. این ابزار به کاربران امکان می‌دهد میان نمایه‌ها جابه‌جا شوند، نمایه‌های موجود را فهرست کنند و برنامه‌ها را با نمایه‌های مشخصی اجرا نمایند. این ابزار زیرمجموعه‌ای از دستورهای powerprofilesctl را همراه با میان‌برهای اختصاصی TLP ارائه می‌دهد.

tlpctl با دیمن نمایه‌های TLP به نام tlp-pd ارتباط برقرار می‌کند که رابط D-Bus با شناسهٔ org.freedesktop.UPower.PowerProfiles را مشابه با power-profiles-daemon پیاده‌سازی می‌کند.

دستورها (COMMANDS)

میان‌برهای نمایه (Profile Shortcuts)

performance: جابه‌جایی به نمایهٔ performance (میان‌بری برای tlpctl set performance).
balanced: جابه‌جایی به نمایهٔ balanced (میان‌بری برای tlpctl set balanced).
power-saver: جابه‌جایی به نمایهٔ power-saver (میان‌بری برای tlpctl set power-saver).

مدیریت نمایه (Profile Management)

list: فهرست کردن نمایه‌های موجود TLP. نمایهٔ فعال با یک علامت ستاره (*) مشخص می‌شود.
get: نمایش نمایهٔ فعال کنونی TLP.
set profile: تنظیم نمایهٔ فعال TLP. نمایه‌های معتبر عبارتند از: performance، balanced و power-saver. این کار تمام نگه‌داشت‌های (holds) فعال نمایه را آزاد می‌کند.
launch command [options]: اجرای یک دستور و درخواست یک نمایهٔ خاص TLP برای آن («نگه‌داشت نمایه» یا profile hold).

-p, --profile profile: نمایه برای نگه‌داشت هنگام اجرای دستور (پیش‌فرض: performance).
-r, --reason reason: دلیل نگه‌داشت نمایه (پیش‌فرض: کلمهٔ دوم و کلمات بعدی command).
-i, --appid appid: شناسهٔ برنامه برای نگه‌داشت (پیش‌فرض: کلمهٔ اول command).
نگه‌داشت‌ها به‌طور خودکار آزاد شده و به نمایهٔ انتخابی کاربر بازمی‌گردند، در صورتی که:

دستور نگه‌دارنده پایان یابد
کاربر نمایه را به‌صورت دستی تغییر دهد (با tlpctl set)
برنامه صراحتاً نگه‌داشت را آزاد کند

چندین نگه‌داشت می‌توانند به‌طور هم‌زمان فعال باشند.

list-holds: فهرست کردن نگه‌داشت‌های فعلی نمایهٔ TLP (ناشی از دستور launch)، همراه با نمایش نام نمایه، شناسهٔ برنامه، و دلیل هر نگه‌داشت.

عیب‌یابی و اشکال‌زدایی (Diagnostics and Debugging)

loglevel level: تنظیم سطح ثبت وقایع (loglevel) دیمن نمایه‌های TLP (tlp-pd). سطوح معتبر عبارتند از: info و debug.

اطلاعات (Information)

version, --version: نمایش اطلاعات نگارش برای هر دو کلاینت tlpctl و دیمن نمایه‌های TLP.

گزینه‌ها (OPTIONS)

-h, --help: نمایش پیام راهنما و خروج. می‌تواند همراه با هر دستوری برای نمایش راهنمای مختص آن دستور استفاده شود.

مجوزها (AUTHORIZATION)

برای انجام عملیات، یک نشست (session) فعال و قفل‌نشده مورد نیاز است. تغییر دادن loglevel نیازمند دسترسی ریشه (root) است.

نمایه‌های مصرف انرژی (POWER PROFILES)

performance: سیستم را به بهای مصرف انرژی بیشتر، برای بیشترین کارایی بهینه‌سازی می‌کند. برای بارهای کاری سنگین توصیه می‌شود. پیش‌فرض TLP هنگام اتصال به برق شهری (AC).
balanced: تعادلی بین کارایی و مصرف انرژی ایجاد می‌کند. مناسب برای استفاده‌های عمومی. پیش‌فرض TLP هنگام استفاده از باتری.
power-saver: سیستم را به بهای کاهش کارایی، برای بیشترین طول عمر باتری بهینه‌سازی می‌کند. برای به حداکثر رساندن زمان کارکرد باتری توصیه می‌شود.

مثال‌ها (EXAMPLES)

فهرست کردن نمایه‌های موجود:

$ tlpctl list

جابه‌جایی به نمایهٔ power-saver:

$ tlpctl power-saver

دریافت نمایهٔ فعال کنونی TLP:

$ tlpctl get

اجرای یک بازی با نمایهٔ performance:

$ tlpctl launch --profile performance --reason "Gaming" steam

اجرای یک دستور با نگه‌داشت پیش‌فرض performance:

$ tlpctl launch make -j8

فهرست کردن نگه‌داشت‌های فعلی نمایهٔ TLP:

$ tlpctl list-holds

وضعیت خروج (EXIT STATUS)

0: موفقیت
1: خطای عمومی (آرگومان‌های نامعتبر، رد عملیات توسط tlp-pd، شکست در ارتباط D-Bus)
سایر موارد: هنگام استفاده از launch، وضعیت خروج دستور اجراشده برگردانده می‌شود.

همچنین ببینید (SEE ALSO)

tlp(8), tlp-stat(8), tlp-pd(8).

مستندات TLP: https://linrunner.de/tlp

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها به: https://github.com/linrunner/TLP/issues