.TH sprio "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands"

.SH "نام (NAME)"
sprio \- مشاهده فاکتورهای تشکیل‌دهنده اولویت زمان‌بندی یک کار

.SH "خلاصه دستور (SYNOPSIS)"
\fBsprio\fR [\fIOPTIONS\fR...]

.SH "توضیحات (DESCRIPTION)"
دستور \fBsprio\fR برای مشاهده مؤلفه‌های اولویت زمان‌بندی یک کار در زمان نصب بودن پلاگین اولویت چندعاملی (multi\-factor priority) به کار می‌رود.
\fBsprio\fR یک ابزار فقط‌خواندنی است که اطلاعات را از پلاگین اولویت چندعاملی استخراج می‌کند. به‌طور پیش‌فرض، \fBsprio\fR اطلاعات مربوط به تمام کارهای در انتظار (pending) را بازمی‌گرداند. گزینه‌هایی برای نمایش کارهای خاص بر اساس شناسه کار (Job ID) و نام کاربری وجود دارد.

.SH "گزینه‌ها (OPTIONS)"

.TP
\fB\-M\fR, \fB\-\-clusters\fR=<\fIstring\fR>
خوشه‌ای که دستورها باید به آن ارسال شوند. تنها می‌توان یک نام خوشه را مشخص کرد.
توجه داشته باشید که برای کارکرد صحیح این گزینه، سرویس \fBslurmdbd\fR باید فعال و در حال اجرا باشد؛ مگر اینکه در یک فدراسیون با پیکربندی \fBFederationParameters=fed_display\fR یا با تنظیم گزینه \fB\-\-federation\fR اجرا شود.
این گزینه به‌طور ضمنی گزینه \fB\-\-local\fR را فعال می‌کند.
.IP

.TP
\fB\-\-federation\fR
در صورت عضویت در یک فدراسیون، کارها را در فدراسیون نمایش می‌دهد.
.IP

.TP
\fB\-o\fR, \fB\-\-format\fR=<\fIoutput_format\fR>
اطلاعاتی که باید نمایش داده شوند، اندازه و موقعیت آن‌ها (راست‌چین یا چپ‌چین) را مشخص می‌کند. قالب‌های پیش‌فرض زمانی که به تمام فاکتورها وزن‌های غیرصفر تخصیص داده شده باشد عبارتند از:
.IP
.RS
.TP 15
\fIپیش‌فرض\fR
"%.15i %9r %.10Y %.10S %.10A %.10B %.10F %.10J %.10P %.10Q %20T"
.IP

.TP
\fI\-l, \-\-long\fR
"%.15i %9r %.8u %.8o %.10Y %.10S %.10A %.10B %.10F %.10J %.10P %.10n %.10Q %.11N %.20T";
.IP
.RE

قالب هر فیلد به صورت "%[.][size]type" است.
.IP
.RS
.TP 8
\fIsize\fR
حداقل اندازه فیلد است.
اگر اندازه‌ای تعیین نشود، هر مقدار فضایی که برای چاپ اطلاعات لازم باشد استفاده خواهد شد.
.IP

.TP
\fI .\fR
نشان‌دهنده این است که خروجی باید چپ‌چین باشد.
به‌طور پیش‌فرض، خروجی راست‌چین است.
.IP
.RE

مشخصه‌های معتبر برای \fItype\fR عبارتند از:
.IP
.RS
.TP 4
\fB%a\fR
اولویت سن (age) نرمال‌شده
.IP

.TP
\fB%A\fR
اولویت سن (age) وزن‌دار
.IP

.TP
\fB%b\fR
اولویت انتساب (association) نرمال‌شده
.IP

.TP
\fB%B\fR
اولویت انتساب (association) وزن‌دار
.IP

.TP
\fB%c\fR
نام خوشه (Cluster). فقط برای خوشه‌های فدراسیونی کاربرد دارد
.IP

.TP
\fB%f\fR
اولویت سهم منصفانه (fair\-share) نرمال‌شده
.IP

.TP
\fB%F\fR
اولویت سهم منصفانه (fair\-share) وزن‌دار
.IP

.TP
\fB%i\fR
شناسه کار (Job ID)
.IP

.TP
\fB%j\fR
اولویت اندازه کار (job size) نرمال‌شده
.IP

.TP
\fB%J\fR
اولویت اندازه کار (job size) وزن‌دار
.IP

.TP
\fB%n\fR
نام QOS
.IP

.TP
\fB%N\fR
تنظیم Nice
.IP

.TP
\fB%o\fR
نام حساب (Account)
.IP

.TP
\fB%p\fR
اولویت پارتیشن (partition) نرمال‌شده
.IP

.TP
\fB%P\fR
اولویت پارتیشن (partition) وزن‌دار
.IP

.TP
\fB%q\fR
اولویت کیفیت خدمات (quality of service) نرمال‌شده
.IP

.TP
\fB%Q\fR
اولویت کیفیت خدمات (quality of service) وزن‌دار
.IP

.TP
\fB%r\fR
نام پارتیشن (Partition)
.IP

.TP
\fB%s\fR
شناسه SLUID اختصاص‌یافته به کار.
.IP

.TP
\fB%S\fR
اولویت مدیر سیستم (admin) وزن‌دار.
.IP

.TP
\fB%t\fR
اولویت‌های TRES نرمال‌شده
.IP

.TP
\fB%T\fR
اولویت‌های TRES وزن‌دار
.IP

.TP
\fB%u\fR
نام کاربری برای یک کار.IP

.TP
\fB%Y\fR
اولویت کار
.IP

.TP
\fB%y\fR
اولویت نرمال‌شدهٔ کار
.RE
.IP

.TP
\fB\-\-help\fR
نمایش یک پیام راهنما که تمام گزینه‌های \fBsprio\fR را شرح می‌دهد.
.IP

.TP
\fB\-j\fR, \fB\-\-jobs\fR=<\fIjob_id_list\fR>
درخواست فهرستی از شناسه‌های کار جداشده با کاما برای نمایش. پیش‌فرض،
تمام کارها است. کارها را می‌توان با شناسهٔ عددی کار یا با SLUID مشخص کرد.
.IP

.TP
\fB\-\-local\fR
تنها کارهای محلی این خوشه را نمایش می‌دهد. سایر خوشه‌ها در این فدراسیون
(در صورت وجود) نادیده گرفته می‌شوند. بر \-\-federation تقدم دارد.
.IP

.TP
\fB\-l\fR, \fB\-\-long\fR
اطلاعات بیشتری از موارد موجود را برای کارهای انتخاب‌شده گزارش می‌دهد.
.IP

.TP
\fB\-h\fR, \fB\-\-noheader\fR
سرآیند را در خروجی چاپ نمی‌کند.
.IP

.TP
\fB\-n\fR, \fB\-\-norm\fR
عوامل اولویت نرمال‌شده را برای کارهای انتخاب‌شده نمایش می‌دهد.
.IP

.TP
\fB\-p\fR, \fB\-\-partition\fR=<\fIpartition_list\fR>
درخواست فهرستی از پارتیشن‌های جداشده با کاما برای نمایش. پیش‌فرض،
تمام پارتیشن‌ها است.
.IP

.TP
\fB\-\-sibling\fR
نمایش تمام کارهای همزاد (sibling) روی یک خوشهٔ فدراسیونی. بدون این گزینه در یک
خوشهٔ فدراسیونی، اولویت و مؤلفه‌های آن برای هر کار در هر پارتیشن تنها برای یک خوشه
گزارش می‌شود. هر کار همزاد روی خوشه‌های مختلف در فدراسیون ممکن است اولویت‌های
متفاوتی داشته باشد که بدون استفاده از این گزینه گزارش نخواهد شد. به‌طور ضمنی "%c" (نام خوشه) را
به قالب خروجی اضافه می‌کند.
.IP

.TP
\fB\-S\fR, \fB\-\-sort\fR=<\fIsort_list\fR>
تعیین ترتیبی که کارها باید گزارش شوند. این گزینه از همان مشخصات فیلد
<output_format> استفاده می‌کند. مرتب‌سازی‌های چندگانه را می‌توان با درج چندین
فیلد مرتب‌سازی جداشده با کاما انجام داد. قبل از مشخصات فیلد می‌توان از "+" یا "\-"
به‌ترتیب برای صعودی (پیش‌فرض) یا نزولی استفاده کرد.
برای مثال، یک <sort_list> به‌صورت "u,r,\-y" گزارش‌های اولویت کار را به‌ترتیب بر اساس
نام کاربری، نام پارتیشن و اولویت نزولی کار مرتب می‌کند. <sort_list>
پیش‌فرض "i" است (شناسهٔ کار به‌صورت صعودی).
.IP

.TP
\fB\-\-usage\fR
نمایش یک پیام راهنمای مختصر که گزینه‌های \fBsprio\fR را فهرست می‌کند.
.IP

.TP
\fB\-u\fR, \fB\-\-user\fR=<\fIuser_list\fR>
درخواست کارها از فهرستی از کاربران که با کاما جدا شده‌اند. این فهرست می‌تواند
شامل نام‌های کاربری یا شماره شناسه‌های کاربری باشد.
.IP

.TP
\fB\-v\fR, \fB\-\-verbose\fR
گزارش جزئیات اقدامات sprio.
.IP

.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج.
.IP

.TP
\fB\-w\fR, \fB\-\-weights\fR
نمایش وزن‌های پیکربندی‌شده برای هر عامل. این مورد تنها برای مقاصد اطلاع‌رسانی
است. داده‌های واقعی کار نمایش داده نمی‌شوند.
.IP.SH "کارایی (PERFORMANCE)"
.PP
اجرای \fBsprio\fR یک فراخوانی رویه از راه دور (RPC) به \fBslurmctld\fR ارسال می‌کند. اگر تعداد فراخوانی‌های هم‌زمان از سوی \fBsprio\fR یا سایر دستورهای کلاینت Slurm که فراخوانی رویه از راه دور به دیمن \fBslurmctld\fR می‌فرستند بیش از حد باشد، می‌تواند به افت کارایی دیمن \fBslurmctld\fR و احتمالاً ایجاد شرایط منع سرویس (denial of service) منجر شود.
.PP
از اجرای \fBsprio\fR یا سایر دستورهای کلاینت Slurm که فراخوانی‌های رویه از راه دور به \fBslurmctld\fR ارسال می‌کنند، درون حلقه‌ها در اسکریپت‌های شل یا دیگر برنامه‌ها خودداری کنید. اطمینان حاصل کنید که برنامه‌ها، فراخوانی‌های \fBsprio\fR را به حداقل میزان لازم برای اطلاعاتی که در پی گردآوری آن هستید محدود کنند.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
در صورتی که گزینه متناظری در خط فرمان مشخص نشده باشد، \fBsprio\fR از مقدار متغیرهای محیطی زیر استفاده خواهد کرد.

.TP 20
\fBSLURM_CLUSTERS\fR
همانند \fB\-\-clusters\fR
.IP

.TP
\fBSLURM_CONF\fR
محل فایل پیکربندی Slurm.
.IP

.TP
\fBSLURM_DEBUG_FLAGS\fR
پرچم‌های اشکال‌زدایی مورد استفاده sprio را مشخص می‌کند. برای مشاهده فهرست کامل پرچم‌ها، DebugFlags را در صفحه راهنمای \fBslurm.conf\fR(5) ببینید. این متغیر محیطی بر تنظیمات درون slurm.conf ارجحیت دارد.
.IP

.TP
\fBSPRIO_FEDERATION\fR
همانند \fB\-\-federation\fR
.IP

.TP
\fBSPRIO_FORMAT\fR
همانند \fB\-o <output_format>, \-\-format=<output_format>\fR
.IP

.TP
\fBSPRIO_LOCAL\fR
همانند \fB\-\-local\fR
.IP

.TP
\fBSPRIO_SIBLING\fR
همانند \fB\-\-sibling\fR
.IP

.SH "مثال‌ها (EXAMPLES)"

.TP
چاپ فهرست تمام کارهای در انتظار همراه با اولویت‌های وزن‌دار آن‌ها
.IP
.nf
$ sprio
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65539      62664          0      51664       1000      10000          0
  65540      62663          0      51663       1000      10000          0
  65541      62662          0      51662       1000      10000          0
.fi

.TP
چاپ فهرست تمام کارهای در انتظار همراه با اولویت‌های نرمال‌سازی‌شده آن‌ها
.IP
.nf
$ sprio \-n
  JOBID PRIORITY   AGE        FAIRSHARE  JOBSIZE    PARTITION  QOS
  65539 0.00001459 0.0007180  0.5166470  1.0000000  1.0000000  0.0000000
  65540 0.00001459 0.0007180  0.5166370  1.0000000  1.0000000  0.0000000
  65541 0.00001458 0.0007180  0.5166270  1.0000000  1.0000000  0.0000000
.fi

.TP
چاپ اولویت‌ها برای کارهای مشخص
.IP
.nf
$ sprio \-\-jobs=65548,65547
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65547      62078          0      51078       1000      10000          0
  65548      62077          0      51077       1000      10000          0
.fi

.TP
چاپ اولویت‌ها برای کارهای مربوط به کاربران مشخص
.IP
.nf
$ sprio \-\-users=fred,sally
  JOBID     USER  PRIORITY       AGE  FAIRSHARE   JOBSIZE  PARTITION     QOS
  65548     fred     62079         1      51077      1000      10000       0
  65549    sally     62080         1      51078      1000      10000       0
.fi

.TP
چاپ وزن‌های پیکربندی‌شده برای هر مؤلفه اولویت
.IP
.nf
$ sprio \-w
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  Weights                1000     100000       1000      10000          1
.fi.SH "کپی‌رایت و تکثیر (COPYING)"
کپی‌رایت (C) 2009 Lawrence Livermore National Security.
تولید شده در Lawrence Livermore National Laboratory (ر.ک. DISCLAIMER).
.br
کپی‌رایت (C) 2010\-2022 SchedMD LLC.
.LP
این فایل بخشی از Slurm، یک برنامه مدیریت منابع، است.
برای جزئیات بیشتر، به <https://slurm.schedmd.com> مراجعه کنید.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزار آزاد؛ چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی، بازتوزیع کرده و/یا تغییر دهید.
.LP
نرم‌افزار Slurm با این امید که مفید واقع شود توزیع شده است، اما «بدون هرگونه ضمانت»؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر، پروانه عمومی همگانی گنو را مطالعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
\fBsqueue\fR(1), \fBsshare\fR(1)