.TH tlpctl 1 2026-07-06 "TLP 1.10.2" "مدیریت مصرف انرژی"
.
.SH "نام (NAME)"
tlpctl \- کنترل و مدیریت نمایه‌های TLP
.
.SH "خلاصه دستور (SYNOPSIS)"
.B tlpctl
[\fB\-h\fR]
.I command
[\fIoptions\fR] [\fIargs\fR]
.
.SH "توضیحات (DESCRIPTION)"
.B tlpctl
یک ابزار خط فرمانی برای کنترل نمایه‌های TLP است.
این ابزار به کاربران امکان می‌دهد میان نمایه‌ها جابه‌جا شوند، نمایه‌های موجود را فهرست کنند
و برنامه‌ها را با نمایه‌های مشخصی اجرا نمایند. این ابزار زیرمجموعه‌ای از دستورهای
powerprofilesctl را همراه با میان‌برهای اختصاصی TLP ارائه می‌دهد.
.PP
.B tlpctl
با دیمن نمایه‌های TLP به نام tlp-pd ارتباط برقرار می‌کند که رابط D-Bus با شناسهٔ
org.freedesktop.UPower.PowerProfiles را مشابه با power-profiles-daemon پیاده‌سازی می‌کند.
.
.SH "دستورها (COMMANDS)"
.SS "میان‌برهای نمایه (Profile Shortcuts)"
.TP
.B performance
جابه‌جایی به نمایهٔ performance (میان‌بری برای \fBtlpctl set performance\fR).
.TP
.B balanced
جابه‌جایی به نمایهٔ balanced (میان‌بری برای \fBtlpctl set balanced\fR).
.TP
.B power-saver
جابه‌جایی به نمایهٔ power-saver (میان‌بری برای \fBtlpctl set power-saver\fR).
.
.SS "مدیریت نمایه (Profile Management)"
.TP
.B list
فهرست کردن نمایه‌های موجود TLP. نمایهٔ فعال با یک علامت ستاره (*) مشخص می‌شود.
.TP
.B get
نمایش نمایهٔ فعال کنونی TLP.
.TP
.BI "set " profile
تنظیم نمایهٔ فعال TLP. نمایه‌های معتبر عبارتند از:
.BR performance "، " balanced " و " power-saver "."
این کار تمام نگه‌داشت‌های (holds) فعال نمایه را آزاد می‌کند.
.TP
.BI "launch " "command " "[\fIoptions\fR]"
اجرای یک دستور و درخواست یک نمایهٔ خاص TLP برای آن («نگه‌داشت نمایه» یا profile hold).
.RS
.TP
.BR \-p ", " \-\-profile " " \fIprofile\fR
نمایه برای نگه‌داشت هنگام اجرای دستور (پیش‌فرض: performance).
.TP
.BR \-r ", " \-\-reason " " \fIreason\fR
دلیل نگه‌داشت نمایه (پیش‌فرض: کلمهٔ دوم و کلمات بعدی \fIcommand\fR).
.TP
.BR \-i ", " \-\-appid " " \fIappid\fR
شناسهٔ برنامه برای نگه‌داشت (پیش‌فرض: کلمهٔ اول \fIcommand\fR).
.TP
نگه‌داشت‌ها به‌طور خودکار آزاد شده و به نمایهٔ انتخابی کاربر بازمی‌گردند، در صورتی که:
.IP \(bu 3
دستور نگه‌دارنده پایان یابد
.IP \(bu 3
کاربر نمایه را به‌صورت دستی تغییر دهد (با \fBtlpctl set\fR)
.IP \(bu 3
برنامه صراحتاً نگه‌داشت را آزاد کند
.TP
چندین نگه‌داشت می‌توانند به‌طور هم‌زمان فعال باشند.
.RE
.TP
.B list-holds
فهرست کردن نگه‌داشت‌های فعلی نمایهٔ TLP (ناشی از دستور launch)، همراه با نمایش نام نمایه، شناسهٔ برنامه، و دلیل هر نگه‌داشت.
.
.SS "عیب‌یابی و اشکال‌زدایی (Diagnostics and Debugging)"
.TP
.BI "loglevel " \fIlevel\fR
تنظیم سطح ثبت وقایع (loglevel) دیمن نمایه‌های TLP (tlp-pd). سطوح معتبر عبارتند از:
.BR info " و " debug "."
.
.SS "اطلاعات (Information)"
.TP
.BR version ", " --version
نمایش اطلاعات نگارش برای هر دو کلاینت tlpctl و دیمن نمایه‌های TLP.
.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-h ", " \-\-help
نمایش پیام راهنما و خروج. می‌تواند همراه با هر دستوری برای نمایش راهنمای مختص آن دستور استفاده شود.
.
.SH "مجوزها (AUTHORIZATION)"
.PP
برای انجام عملیات، یک نشست (session) فعال و قفل‌نشده مورد نیاز است.
تغییر دادن \fBloglevel\fR نیازمند دسترسی ریشه (root) است.
.
.SH "نمایه‌های مصرف انرژی (POWER PROFILES)"
.TP
.B performance
سیستم را به بهای مصرف انرژی بیشتر، برای بیشترین کارایی بهینه‌سازی می‌کند.
برای بارهای کاری سنگین توصیه می‌شود.
پیش‌فرض TLP هنگام اتصال به برق شهری (AC).
.TP
.B balanced
تعادلی بین کارایی و مصرف انرژی ایجاد می‌کند. مناسب برای استفاده‌های عمومی.
پیش‌فرض TLP هنگام استفاده از باتری.
.TP
.B power-saver
سیستم را به بهای کاهش کارایی، برای بیشترین طول عمر باتری بهینه‌سازی می‌کند.
برای به حداکثر رساندن زمان کارکرد باتری توصیه می‌شود.
.
.SH "مثال‌ها (EXAMPLES)"
.TP
فهرست کردن نمایه‌های موجود:
.EX
$ tlpctl list
.EE
.TP
جابه‌جایی به نمایهٔ power-saver:
.EX
$ tlpctl power-saver
.EE
.TP
دریافت نمایهٔ فعال کنونی TLP:
.EX
$ tlpctl get
.EE
.TP
اجرای یک بازی با نمایهٔ performance:
.EX
$ tlpctl launch --profile performance --reason "Gaming" steam
.EE
.TP
اجرای یک دستور با نگه‌داشت پیش‌فرض performance:
.EX
$ tlpctl launch make -j8
.EE
.TP
فهرست کردن نگه‌داشت‌های فعلی نمایهٔ TLP:
.EX
$ tlpctl list-holds
.EE
.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.B 0
موفقیت
.TP
.B 1
خطای عمومی (آرگومان‌های نامعتبر، رد عملیات توسط tlp-pd، شکست در ارتباط D-Bus)
.TP
.B سایر موارد
هنگام استفاده از \fBlaunch\fR، وضعیت خروج دستور اجراشده برگردانده می‌شود.
.
.SH "همچنین ببینید (SEE ALSO)"
.BR tlp (8),
.BR tlp-stat (8),
.BR tlp-pd (8).
.PP
مستندات TLP: <https://linrunner.de/tlp>
.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به: <https://github.com/linrunner/TLP/issues>
.
.SH "نویسندگان (AUTHORS)"
(c) 2026 Thomas Koch <linrunner at gmx.net>