.TH POWERTOP "8" "2026-05-13" "راهنمای powertop" "مدیریت سیستم"
.SH "نام (NAME)"
powertop \- ابزار تشخیص مصرف انرژی و مدیریت توان
.SH "خلاصه دستور (SYNOPSIS)"
.B powertop
.RI [ گزینه‌ها ]
.SH "توضیحات (DESCRIPTION)"
برنامه
.B powertop
ابزاری است که به عیب‌یابی و تشخیص مشکلات گوناگون مصرف انرژی و مدیریت توان کمک می‌کند. این برنامه همچنین دارای یک حالت تعاملی است که به کاربر امکان می‌دهد تنظیمات مختلف مدیریت توان را بیازماید. هنگام فراخوانی powertop بدون آرگومان، برنامه در حالت تعاملی اجرا می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-auto\-tune
تنظیم تمام گزینه‌های قابل‌تنظیم روی مقادیر بهینه بدون تعامل کاربر.
.TP
.B \-\-auto\-tune\-dump
چاپ دستورات
.I auto\-tune
در خروجی استاندارد (STDOUT) به جای اجرای آن‌ها.
.TP
.B \-\-bypass\-root\-check
نادیده گرفتن بررسی دسترسی کاربر ریشه (root). صرفاً برای آزمایش در نظر گرفته شده است؛ اجرای بدون دسترسی ریشه، داده‌هایی را که powertop می‌تواند جمع‌آوری کند محدود می‌سازد.
.TP
.BR \-c ", " \-\-calibrate
اجرای powertop در حالت کالیبراسیون. هنگام کار روی باتری، powertop می‌تواند مصرف انرژی و همچنین فعالیت سیستم را ردیابی کند. هنگامی که اندازه‌گیری‌های کافی انجام شد، powertop می‌تواند تخمین‌های مصرف توان را گزارش دهد. با استفاده از این گزینه برای فعال‌سازی چرخه کالیبراسیون، می‌توان به تخمین‌های دقیق‌تری دست یافت. این چرخه سطوح مختلف نمایشگر و فعالیت‌ها و بارهای کاری دستگاه‌های USB را پیمایش می‌کند.
.TP
\fB\-C\fR, \fB\-\-csv\fR[=\fIنام_فایل\fR]
تولید گزارش CSV. اگر
.I نام_فایل
مشخص نشود، نام پیش‌فرض
.B powertop.csv
استفاده می‌شود. گزارش CSV می‌تواند برای گزارش‌گیری و تحلیل داده‌ها استفاده شود.
.TP
.B \-\-debug
اجرا در حالت اشکال‌زدایی (debug).
.TP
\fB\-\-extech\fR=\fIdevnode\fR
استفاده از تحلیل‌گر توان Extech برای اندازه‌گیری‌ها. این گزینه به کاربر اجازه می‌دهد گره دستگاه سریال مبدل سریال به USB متصل به تحلیل‌گر توان Extech، به عنوان مثال
.IR /dev/ttyUSB0 ،
را مشخص کند.
.TP
\fB\-r\fR, \fB\-\-html\fR[=\fIنام_فایل\fR]
تولید گزارش HTML. اگر
.I نام_فایل
مشخص نشود، نام پیش‌فرض
.B powertop.html
استفاده خواهد شد. گزارش HTML را می‌توان برای دیگران ارسال کرد تا در تشخیص مشکلات توان کمک کنند.
.TP
\fB\-i\fR, \fB\-\-iteration\fR[=\fIتعداد\fR]
تعداد دفعات اجرای هر آزمایش.
.TP
\fB\-M\fR, \fB\-\-markdown\fR[=\fIنام_فایل\fR]
تولید گزارش مارک‌داون (Markdown). اگر
.I نام_فایل
تعیین نشود، نام پیش‌فرض
.B powertop.md
به کار می‌رود.
.TP
.B \-\-once
اجرای اندازه‌گیری‌ها تنها برای یک بار و سپس خروج. در ترکیب با گزینه‌های
.BR \-\-html ،
.BR \-\-csv ،
یا
.B \-\-markdown
برای تولید یک گزارش یک‌باره به صورت غیرتعاملی مفید است.
.TP
.BR \-q ", " \-\-quiet
جلوگیری از چاپ پیام‌ها در خروجی خطای استاندارد (stderr).
.TP
\fB\-s\fR, \fB\-\-sample\fR[=\fIثانیه\fR]
تنظیم بازه زمانی بر حسب
.I ثانیه
میان اندازه‌گیری‌های مصرف توان. مقدار پیش‌فرض
.BR 5
است.
.TP
\fB\-t\fR, \fB\-\-time\fR[=\fIثانیه\fR]
تولید گزارش برای تعداد مشخصی از
.IR ثانیه‌ها .
.TP
\fB\-w\fR, \fB\-\-workload\fR[=\fIبار_کاری\fR]
اجرای فایل
.I بار_کاری
به عنوان بخشی از کالیبراسیون پیش از ایجاد گزارش.
.TP
.BR \-V ", " \-\-version
چاپ اطلاعات نسخه و خروج.
.TP
.BR \-h ", " \-\-help
نمایش پیام راهنما و خروج.
.SH "کلیدها و دستورات (COMMANDS)"
در حالت تعاملی، کلیدهای میانبر زیر در دسترس هستند:
.IP
.TS
tab(@);
l l.
\fBTab\fR@نمایش برگه بعدی
\fBBackTab\fR@نمایش برگه قبلی
\fBRight Arrow\fR@پیمایش به راست
\fBLeft Arrow\fR@پیمایش به چپ
\fBUp Arrow\fR, \fBPageUp\fR@پیمایش به بالا یا انتخاب مورد قبلی
\fBDown Arrow\fR, \fBPageDown\fR@پیمایش به پایین یا انتخاب مورد بعدی
\fBSpace\fR, \fBReturn\fR@فعال‌سازی مورد فعلی
\fBs\fR@تنظیم مهلت زمان نوسازی
\fBr\fR@نوسازی پنجره
\fBq\fR, \fBCtrl-C\fR, \fBEscape\fR@خروج از powertop
.TE
.SH "اشکالات (BUGS)"
گزارش‌های اشکال را به ردیاب مشکلات گیت‌هاب ارسال کنید:
.UR https://github.com/fenrus75/powertop/issues
.UE
.SH "همچنین ببینید (SEE ALSO)"
توضیحات کامل‌تر درباره این برنامه در نشانی زیر موجود است:
.UR https://github.com/fenrus75/powertop
.UE
.SH "نویسندگان (AUTHORS)"
برنامه powertop توسط
.MT arjan@\:linux.\:intel.\:com
Arjan van de Ven
.ME
نوشته شده است، و در حال حاضر توسط
.MT chris.\:e.\:ferron@\:linux.\:intel.\:com
Chris E Ferron
.ME
نگهداری می‌شود.