'\" t
.\"     Title: uclampset
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: دستورات کاربری
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "UCLAMPSET" "1" "2026-09-02" "util\-linux 2.42.3" "دستورات کاربری"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
uclampset \- تنظیم و مشاهده ویژگی‌های محدودسازی بهره‌وری پردازنده (Utilization Clamping)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBuclampset\fP [options] [\fB\-m\fP \fIminimum\fP] [\fB\-M\fP \fImaximum\fP] \fB\-p\fP \fIPID\fP
.sp
\fBuclampset\fP [options] [\fB\-m\fP \fIminimum\fP] [\fB\-M\fP \fImaximum\fP] \fIcommand\fP [\fIargument\fP.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBuclampset\fP ویژگی‌های محدودسازی بهره‌وری (utilization clamping) یک \fIPID\fP موجود را تنظیم یا دریافت می‌کند، یا \fIcommand\fP را با ویژگی‌های داده‌شده اجرا می‌نماید.
.sp
محدودسازی بهره‌وری (Utilization clamping) قابلیتی است که در نسخه ۵.۳ اضافه شد. این ویژگی راهنمایی (hint) را در اختیار زمان‌بند قرار می‌دهد که نشان‌دهنده محدوده مجاز بهره‌وری است که تسک (وظیفه) باید در آن کار کند.
.sp
میزان بهره‌وری تسک بر انتخاب فرکانس و جای‌گذاری تسک (task placement) اثر می‌گذارد. در زمان نگارش این مستند، تنها ناظم فرکانس پردازنده (cpufreq governor) با نام schedutil پردازش راهنماهای util clamp را درک می‌کند. برای اطلاعات بیشتر در مورد پشتیبانی سایر ناظم‌های cpufreq به مستندات هسته خود مراجعه کنید.
.sp
اگر روی سامانه‌ای ناهمگون و نامتقارن مانند big.LITTLE آرم اجرا می‌کنید، محدودسازی بهره‌وری می‌تواند به سوگیری در جای‌گذاری تسک‌ها کمک کند. اگر تسک تقویت (boost) شود به طوری که مقدار \fIutil_min\fP بالاتر از ظرفیت هسته‌های کوچک (little cores) باشد، زمان‌بند تمام تلاش خود را می‌کند تا آن را روی یک هسته بزرگ (big core) قرار دهد.
.sp
به طور مشابه، اگر \fIutil_max\fP کوچکتر یا مساوی ظرفیت هسته‌های کوچک باشد، زمان‌بند همچنان می‌تواند تصمیم بگیرد که آن را در آنجا قرار دهد، حتی اگر بهره‌وری واقعی تسک در حداکثر مقدار باشد.
.sp
تنظیم مقدار \fIuclamp_min\fP یک تسک به مقداری غیرصفر، عملاً تسک را تقویت می‌کند چرا که هنگام اجرا همواره از این مقدار بهره‌وری شروع خواهد کرد.
.sp
با تنظیم مقدار \fIuclamp_max\fP یک تسک به کمتر از ۱۰۲۴، عملاً سقف عملکرد تسک محدود می‌شود، زیرا هنگام اجرا هرگز قادر نخواهد بود از این مقدار بهره‌وری فراتر رود.
.sp
محدوده کامل بهره‌وری به صورت [0:1024] است. مقدار ویژه \-1 برای بازنشانی به مقدار پیش‌فرض سیستم استفاده می‌شود.
.sp
برای جزئیات بیشتر به آخرین مستندات هسته مراجعه کنید:
.sp
.if n .RS 4
.nf
.fam C
https://kernel.org/doc/html/latest/scheduler/sched\-util\-clamp.html
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-m\fP
.RS 4
تنظیم مقدار \fIutil_min\fP.
.RE
.sp
\fB\-M\fP
.RS 4
تنظیم مقدار \fIutil_max\fP.
.RE
.sp
\fB\-a\fP, \fB\-\-all\-tasks\fP
.RS 4
تنظیم یا دریافت ویژگی‌های محدودسازی بهره‌وری تمام وظایف (ریسه‌ها) برای یک PID مشخص.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP
.RS 4
عملیات روی یک PID موجود و عدم راه‌اندازی وظیفه جدید.
.RE
.sp
\fB\-s\fP, \fB\-\-system\fP
.RS 4
تنظیم یا دریافت ویژگی‌های محدودسازی بهره‌وری در سطح کل سیستم.
.RE
.sp
\fB\-R\fP, \fB\-\-reset\-on\-fork\fP
.RS 4
تنظیم پرچم \fBSCHED_FLAG_RESET_ON_FORK\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
نمایش اطلاعات وضعیت با جزئیات.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "نحوه استفاده (USAGE)"
.sp
رفتار پیش‌فرض، اجرای یک دستور جدید است:
.RS 4
\fBuclampset\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP \fIcommand\fP [\fIarguments\fP]
.RE
.sp
همچنین می‌توانید ویژگی‌های محدودسازی بهره‌وری یک وظیفه موجود را دریافت کنید:
.RS 4
\fBuclampset \-p\fP \fIPID\fP
.RE
.sp
یا آن‌ها را تنظیم نمایید:
.RS 4
\fBuclampset \-p\fP \fIPID\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.sp
یا ویژگی‌های سراسری سیستم را کنترل کنید:
.RS 4
\fBuclampset \-s\fP \fI[\-m uclamp_min]\fP \fI[\-M uclamp_max]\fP
.RE
.SH "مجوزها (PERMISSIONS)"
.sp
کاربر برای تغییر ویژگی‌های زمان‌بندی یک فرایند باید دارای قابلیت \fBCAP_SYS_NICE\fP باشد. هر کاربری می‌تواند اطلاعات زمان‌بندی را دریافت کند.
.SH "نکات (NOTES)"
.sp
ویژگی‌های محدودسازی بهره‌وری در سطح سیستم برای کنترل محدوده \fIمجاز\fP قابل استفاده توسط تسک‌ها قرار داده شده‌اند. به طور پیش‌فرض، هر دو مقدار \fIuclamp_min\fP و \fIuclamp_max\fP روی ۱۰۲۴ تنظیم شده‌اند. این بدان معناست که کاربران می‌توانند مقادیر محدودسازی بهره‌وری را برای تسک‌های خود در تمام محدوده [0:1024] تنظیم کنند.
.sp
برای مثال:
.RS 4
\fBuclampset \-s\fP \f(CR\-m 512\fP \f(CR\-M 700\fP
.RE
.sp
از تقویت هر تسکی به بالاتر از ۵۱۲ جلوگیری خواهد کرد، و تمام تسک‌ها در سیستم تا بهره‌وری ۷۰۰ محدود می‌شوند؛ که عملاً حداکثر کارایی سیستم را به ۷۰۰ تقلیل می‌دهد.
.sp
برای رفتار دقیق مورد انتظار در آن نسخه هسته، به مستندات هسته خود مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "qyousef\(atlayalina.io" "Qais Yousef" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnice\fP(1),
\fBrenice\fP(1),
\fBtaskset\fP(1),
\fBsched\fP(7)
.sp
برای توصیف طرح زمان‌بندی لینوکس به \fBsched_setscheduler\fP(2) و \fBsched_setattr\fP(2) مراجعه کنید.
.SH "گزارش اشکالات (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBuclampset\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دانلود کرد.