| squeue(1) | Slurm Commands | squeue(1) |
نام (NAME)
squeue - مشاهده اطلاعات کارهای موجود در صف زمانبندی Slurm
خلاصه دستور (SYNOPSIS)
squeue [OPTIONS...]
توضیحات (DESCRIPTION)
از squeue برای مشاهده اطلاعات کارها (jobs) و گامهای کار (job steps) مدیریتشده توسط Slurm استفاده میشود.
گزینهها (OPTIONS)
- -A, --account=<account_list>
- حسابهای کارهای مورد نظر برای مشاهده را مشخص میکند. فهرستی از نامهای حسابها را که با کاما از هم جدا شدهاند میپذیرد. این گزینه هنگام فهرست کردن گامهای کار بیتأثیر است.
- -a, --all
- نمایش اطلاعات درباره کارها و گامهای کار در تمام پارتیشنها. این گزینه باعث نمایش اطلاعات درباره پارتیشنهایی میشود که به صورت پنهان پیکربندی شدهاند، پارتیشنهایی که برای گروه کاربر در دسترس نیستند، و کارهای فدراسیونی که در وضعیت "revoked" (ابطالشده) قرار دارند.
- -r, --array
- نمایش هر عنصر آرایه کار در یک خط جداگانه. بدون این گزینه، نمایش برای استفاده با آرایههای کار بهینهسازی خواهد شد (عناصر در انتظار آرایه کار در یک خط خروجی ترکیب میشوند و مقادیر نمایه آرایه با استفاده از عبارت باقاعده چاپ میشوند).
- -M, --clusters=<cluster_name>
- خوشههایی که دستورها باید به آنها ارسال شوند. نام چند خوشه میتواند با کاما جدا شود. مقدار 'all' برای ارسال پرسوجو به همه خوشهها استفاده میشود. توجه داشته باشید که سرویس slurmdbd باید فعال باشد تا این گزینه به درستی کار کند، مگر اینکه در یک فدراسیون با پیکربندی FederationParameters=fed_display یا تنظیم گزینه --federation اجرا شود. این گزینه به طور ضمنی گزینه --local را فعال میکند.
- --expand-patterns
- گسترش الگوهای نام فایل در StdOut، StdErr و StdIn. فیلدهایی که به بازهای از مقادیر نگاشت میشوند، از اولین مقدار آن بازه استفاده خواهند کرد. برای مثال "%t" برای شناسه وظیفه (task id) با "0" جایگزین خواهد شد.
- --federation
- نمایش کارهای فدراسیون در صورت عضویت در آن.
- -o, --format=<output_format>
- مشخص کردن
اطلاعات
نمایشی،
اندازه و
موقعیت آن
(راستچین
یا چپچین).
همچنین
گزینه -O,
--Format=<output_format> شرح
دادهشده
در ادامه را
ببینید (که
انعطافپذیری
کمتری در
قالببندی
دارد، اما
دسترسی به
همه فیلدها
را فراهم
میکند).
اگر دستور
در یک محیط
خوشه
فدراسیونی
اجرا شود و
قرار باشد
اطلاعات
بیش از یک
خوشه نمایش
داده شود و
گزینه -h, --noheader
استفاده
شده باشد،
نام خوشه
قبل از
قالبهای
خروجی
پیشفرض
نشان
دادهشده
در زیر
نمایش داده
خواهد شد.
قالبهای پیشفرض با گزینههای مختلف عبارتند از:
- پیشفرض
- "%.18i %.9P %.8j %.8u %.2t %.10M %.6D %R"
- -l, --long
- "%.18i %.9P %.8j %.8u %.8T %.10M %.9l %.6D %R"
- -s, --steps
- "%.15i %.8j %.9P %.8u %.9M %N"
قالب هر فیلد به صورت "%[[.]size]type[suffix]" است:
- size
- حداقل اندازه فیلد. اگر اندازهای مشخص نشود، هر مقدار فضایی که برای چاپ اطلاعات لازم باشد استفاده خواهد شد.
- .
- نشان میدهد که خروجی باید راستچین باشد و اندازه (size) نیز باید مشخص گردد. به طور پیشفرض، خروجی چپچین است.
- suffix
- رشته دلخواهی که به انتهای فیلد افزوده میشود.
توجه داشته باشید که بسیاری از این مشخصههای type تنها برای کارها معتبر هستند، در حالی که برخی دیگر تنها برای گامهای کار اعتبار دارند. مشخصههای معتبر type عبارتند از:
- %all
- چاپ تمام فیلدهای موجود برای این نوع داده، به طوری که خط عمودی (|) فیلدها را از هم جدا میکند.
- %a
- حساب مرتبط با کار. (تنها برای کارها معتبر است)
- %A
- تعداد وظایف ایجادشده توسط یک گام کار. این مقدار گزینه srun --ntasks را گزارش میدهد. (تنها برای گامهای کار معتبر است)
- %A
- شناسه کار (Job id). این مقدار برای هر عنصر از آرایههای کار منحصربهفرد خواهد بود. (تنها برای کارها معتبر است)
- %B
- میزبان در حال اجرا (دستهای). برای یک نشست تخصیصیافته، این همان میزبانی است که نشست روی آن اجرا میشود (یعنی گرهی که دستور srun یا salloc از آن اجرا شده است). برای یک کار دستهای (batch job)، این گرهی است که اسکریپت دستهای را اجرا میکند. در یک خوشه معمولی لینوکس، این گره محاسباتیِ صفر از تخصیص خواهد بود.
- %c
- حداقل تعداد پردازندهها (CPUs) به ازای هر گره که توسط کار درخواست شده است. این مشخصه مقدار گزینه srun --mincpus را گزارش میدهد که مقدار پیشفرض آن صفر است. (تنها برای کارها معتبر است)
- %C
- تعداد پردازندههای (CPUs) درخواستی کار یا تخصیصیافته به آن در صورت در حال اجرا بودن. همزمان با تکمیل کار، این عدد نشاندهنده تعداد پردازندههای تخصیصیافته فعلی خواهد بود. (تنها برای کارها معتبر است)
- %d
- حداقل اندازه فضای دیسک موقت (به مبیبایت/MiB) درخواستشده توسط کار. (تنها برای کارها معتبر است)
- %D
- تعداد گرههای تخصیصیافته به کار یا حداقل تعداد گرههای مورد نیاز یک کار در انتظار (pending). اگر کار یک بازه برای تعداد گره مشخص کرده باشد (مثلاً حداقل و حداکثر تعداد گره) یا به جای تعداد گره، تعداد پردازنده مشخص کرده باشد، تعداد واقعی گرههای تخصیصیافته به یک کار در انتظار ممکن است از این مقدار فراتر رود. همزمان با تکمیل کار، این عدد نشاندهنده تعداد گرههای تخصیصیافته فعلی خواهد بود. (تنها برای کارها معتبر است).IP
- %e
- زمانی که کار پایان یافته یا انتظار میرود به پایان برسد (بر اساس محدودیت زمانی آن). (تنها برای کارها معتبر است)
- %E
- وابستگیهای باقیماندهٔ کار. این کار تا زمانی که این کارهای وابسته تکمیل نشوند، اجرای خود را آغاز نخواهد کرد. در مورد کاری که به دلیل برآورده نشدن وابستگیها هرگز نمیتواند اجرا شود، مشخصات اولیه و کامل وابستگی کار گزارش خواهد شد. به محض اینکه یک وابستگی برآورده شود، از کار حذف میگردد. مقدار NULL به این معنی است که کار هیچ وابستگیای ندارد. (تنها برای کارها معتبر است)
- %f
- ویژگیهای مورد نیاز کار. (تنها برای کارها معتبر است)
- %F
- شناسهٔ کار آرایهٔ کاری. این شناسه، شناسهٔ پایهٔ کار است. برای کارهای غیرآرایهای، این همان شناسهٔ کار است. (تنها برای کارها معتبر است)
- %g
- نام گروه کار. (تنها برای کارها معتبر است)
- %G
- شناسهٔ گروه (GID) کار. (تنها برای کارها معتبر است)
- %h
- وضعیت تخصیص بیشازحد (oversubscribe) برای کار (ستون OVER_SUBSCRIBE): مقدار "YES" اگر کار --oversubscribe را درخواست کرده باشد؛ در غیر این صورت "NO"؛ و "OK" در صورتی که افراز (partition) اجازهٔ اشتراک بیشازحد را بدهد (بدون اینکه کار آن را غیرفعال کرده باشد) در حالی که کار --oversubscribe را درخواست نکرده است. این وضعیت انحصاری بودن را مشخص نمیکند؛ فیلد Exclusive را در زیر ببینید. (تنها برای کارها معتبر است)
- %H
- تعداد سوکتهای درخواستی کار به ازای هر گره. این مورد مقدار گزینهٔ srun --sockets-per-node را گزارش میکند. هنگامی که --sockets-per-node تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- %i
- شناسهٔ کار یا گام کار. در مورد آرایههای کاری، قالب شناسهٔ کار به صورت "<base_job_id>_<index>" خواهد بود. بهطور پیشفرض، اندازهٔ فیلد نمایهٔ آرایهٔ کاری به ۶۴ بایت محدود میشود. از متغیر محیطی SLURM_BITSTR_LEN برای تعیین اندازههای بزرگتر فیلد استفاده کنید. (معتبر برای کارها و گامهای کار) در مورد تخصیص کارهای ناهمگن، قالب شناسهٔ کار به شکل "#+#" خواهد بود که در آن عدد اول "رهبر کار ناهمگن" و عدد دوم آفست بر مبنای صفر برای هر مؤلفهٔ کار است.
- %I
- تعداد هستهها به ازای هر سوکت که توسط کار درخواست شده است. این مقدار، گزینهٔ srun --cores-per-socket را گزارش میدهد. زمانی که --cores-per-socket تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- %j
- نام کار یا گام کار. (معتبر برای کارها و گامهای کار)
- %J
- تعداد رشتهها (threads) به ازای هر هسته که توسط کار درخواست شده است. این مقدار گزینهٔ srun --threads-per-core را گزارش میدهد. هنگامی که --threads-per-core تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- %k
- توضیح (comment) مرتبط با کار. (تنها برای کارها معتبر است)
- %K
- نمایهٔ آرایهٔ کاری. بهطور پیشفرض، اندازهٔ این فیلد به ۶۴ بایت محدود خواهد شد. برای مشخص کردن اندازههای بزرگتر فیلد از متغیر محیطی SLURM_BITSTR_LEN استفاده کنید. (تنها برای کارها معتبر است)
- %l
- محدودیت زمانی کار یا گام کار به صورت days-hours:minutes:seconds. این مقدار ممکن است در صورت مشخص نشدن "NOT_SET" یا برای حالت بدون محدودیت "UNLIMITED" باشد. (معتبر برای کارها و گامهای کار)
- %L
- زمان باقیمانده برای اجرای کار به صورت days-hours:minutes:seconds. این مقدار با کم کردن زمان مصرفشدهٔ کار از محدودیت زمانی آن محاسبه میشود. این مقدار ممکن است در صورتی که هنوز تعیین نشده باشد "NOT_SET" یا برای حالت بدون محدودیت "UNLIMITED" باشد. (تنها برای کارها معتبر است)
- %m
- حداقل اندازهٔ حافظه (به MiB) درخواستشده توسط کار. (تنها برای کارها معتبر است) اگر حافظه به ازای هر CPU یا به ازای هر GPU درخواست شده باشد، مقدار با این فرض نشان داده میشود که به ترتیب حداقل یک CPU یا GPU تخصیص خواهد یافت.
- %M
- زمان مصرفشده توسط کار یا گام کار به صورت days-hours:minutes:seconds. روزها و ساعتها تنها در صورت نیاز چاپ میشوند. برای گامهای کار این فیلد زمان سپریشده از زمان آغاز اجرا را نشان میدهد و بنابراین برای گامهای کاری که به حالت تعلیق درآمدهاند، دقیق نخواهد بود. ناهماهنگی ساعت (Clock skew) بین گرهها در خوشه باعث نادقیق بودن زمان میشود. اگر زمان به وضوح نادرست باشد (مانند منفی بودن)، به صورت "INVALID" نمایش داده میشود. (معتبر برای کارها و گامهای کار)
- %n
- فهرست نامهای گرههایی که به صراحت توسط کار درخواست شدهاند. (تنها برای کارها معتبر است)
- %N
- فهرست گرههای تخصیصیافته به کار یا گام کار. در مورد یک کار در وضعیت COMPLETING، فهرست گرهها تنها شامل آن دسته از گرههایی خواهد بود که هنوز به سرویسدهی بازنگشتهاند. (معتبر برای کارها و گامهای کار)
- %o
- دستوری که باید اجرا شود.
- %O
- مشخص میکند که آیا گرههای پیوسته توسط کار درخواست شدهاند یا خیر. (تنها برای کارها معتبر است)
- %p
- اولویت کار (تبدیلشده به یک عدد ممیز شناور بین 0.0 و 1.0). همچنین %Q را ببینید. (تنها برای کارها معتبر است)
- %P
- افراز (partition) کار یا گام کار. (معتبر برای کارها و گامهای کار).IP
- %q
- کیفیت خدمات (Quality of service) مرتبط با کار. (تنها برای کارها معتبر است)
- %Q
- اولویت کار (معمولاً یک عدد صحیح بدون علامت بسیار بزرگ). همچنین %p را ببینید. (تنها برای کارها معتبر است)
- %r
- دلیل قرار داشتن کار در وضعیت کنونیاش. برای اطلاعات بیشتر، بخش JOB REASON CODES را در ادامه ببینید. (تنها برای کارها معتبر است)
- %R
- برای کارهای در انتظار: دلیلی که کار توسط زمانبند آغاز نشده است درون پرانتز چاپ میشود. برای کارهای خاتمهیافته با شکست: توضیحی دربارهٔ دلیل شکست کار درون پرانتز چاپ میشود. برای تمام وضعیتهای دیگر کار: فهرست گرههای تخصیصیافته. برای اطلاعات بیشتر، بخش JOB REASON CODES را در ادامه ببینید. (تنها برای کارها معتبر است)
- %s
- شناسهٔ SLUID (تنها برای کارها معتبر است)
- %S
- زمان شروع واقعی یا مورد انتظار کار یا مرحلهٔ کار. (معتبر برای کارها و مراحل کار)
- %t
- وضعیت کار در قالب فشرده. برای فهرستی از وضعیتهای ممکن، بخش JOB STATE CODES را در ادامه ببینید. (تنها برای کارها معتبر است)
- %T
- وضعیت کار در قالب گسترده. برای فهرستی از وضعیتهای ممکن، بخش JOB STATE CODES را در ادامه ببینید. (تنها برای کارها معتبر است)
- %u
- نام کاربری برای یک کار یا مرحلهٔ کار. (معتبر برای کارها و مراحل کار)
- %U
- شناسه کاربری برای یک کار یا مرحلهٔ کار. (معتبر برای کارها و مراحل کار)
- %v
- رزرو برای کار. (تنها برای کارها معتبر است)
- %V
- زمان ارسال کار.
- %w
- کلید مشخصه حجم کار (wckey). (تنها برای کارها معتبر است)
- %W
- مجوزهای درخواستشده توسط کار. (تنها برای کارها معتبر است)
- %x
- فهرست نام گرههایی که به صراحت توسط کار مستثنی شدهاند. (تنها برای کارها معتبر است)
- %X
- تعداد هستههای رزروشده در هر گره برای استفادهٔ سیستم (core specialization). (تنها برای کارها معتبر است)
- %y
- مقدار Nice (تنظیم اولویت زمانبندی یک کار). (تنها برای کارها معتبر است)
- %Y
- برای کارهای در انتظار، فهرستی از گرههایی که انتظار میرود هنگام شروع کار استفاده شوند.
- %z
- تعداد سوکتها، هستهها و رشتههای درخواستی (S:C:T) به ازای هر گره برای کار. هنگامی که (S:C:T) تنظیم نشده باشد، «*» نمایش داده میشود. (تنها برای کارها معتبر است)
- %Z
- دایرکتوری کاری کار.
- -O, --Format=<output_format>
- اطلاعاتی
را که باید
نمایش داده
شوند، مشخص
میکند.
همچنین
گزینهٔ -o,
--format=<output_format>
شرحدادهشده
در بالا را
ببینید (که
انعطافپذیری
بیشتری در
قالببندی
فراهم
میکند،
اما به دلیل
اتمام حروف
الفبا، از
دسترسی به
تمام
فیلدها
پشتیبانی
نمیکند).
درخواست
فهرستی از
اطلاعات
کار جداشده
با کاما
برای نمایش
میدهد.
قالب هر فیلد به صورت "type[:[.][size][suffix]]" است
- size
- حداقل اندازهٔ فیلد. اگر اندازهای مشخص نشود، ۲۰ نویسه برای چاپ اطلاعات اختصاص مییابد.
- .
- نشان میدهد که خروجی باید راستچین شود و اندازه نیز باید مشخص شده باشد. به طور پیشفرض، خروجی چپچین است.
- suffix
- رشتهٔ دلخواه برای افزودن به انتهای فیلد.
توجه داشته باشید که بسیاری از این مشخصههای type تنها برای کارها معتبر هستند، در حالی که برخی دیگر تنها برای مراحل کار معتبرند. مشخصههای معتبر type عبارتند از:
- Account
- حساب مرتبط با کار را چاپ میکند. (تنها برای کارها معتبر است)
- AccrueTime
- زمان انباشت (accrue time) مرتبط با کار را چاپ میکند. (تنها برای کارها معتبر است)
- admin_comment
- توضیحات مدیر سیستم مرتبط با کار. (تنها برای کارها معتبر است).IP
- AllocNodes
- گرههای تخصیصیافته به کار را چاپ میکند. (تنها برای کارها معتبر است)
- AllocSID
- شناسه نشست (session ID) استفادهشده برای ارسال کار را چاپ میکند. (تنها برای کارها معتبر است)
- ArrayJobID
- شناسه کارِ مربوط به آرایه کار (job array) را چاپ میکند. (برای کارها و گامهای کار معتبر است)
- ArrayTaskID
- شناسه وظیفه (task ID) مربوط به آرایه کار را چاپ میکند. (برای کارها و گامهای کار معتبر است)
- AssocID
- شناسه انتساب (association) کار را چاپ میکند. (تنها برای کارها معتبر است)
- BatchFlag
- چاپ میکند که آیا پرچم دستهای (batch flag) تنظیم شده است یا خیر. (تنها برای کارها معتبر است)
- BatchHost
- میزبانِ در حال اجرا (دستهای). برای یک نشست تخصیصیافته، این همان میزبانی است که نشست روی آن در حال اجرا است (یعنی گرهای که دستور srun یا salloc از آن اجرا شده است). برای یک کار دستهای، این گرهای است که اسکریپت دستهای را اجرا میکند. در مورد یک کلاستر لینوکسی معمول، این گره محاسباتی صفر از تخصیص خواهد بود. (تنها برای کارها معتبر است)
- BoardsPerNode
- تعداد بردهای تخصیصیافته به کار به ازای هر گره را چاپ میکند. (تنها برای کارها معتبر است)
- BurstBuffer
- مشخصات بافر انفجاری (Burst Buffer) (تنها برای کارها معتبر است)
- BurstBufferState
- وضعیت بافر انفجاری (Burst Buffer) (تنها برای کارها معتبر است)
- Cluster
- نام کلاستری که کار یا گام کار را اجرا میکند.
- ClusterFeature
- ویژگیهای کلاستر مورد نیاز کار. (تنها برای کارها معتبر است)
- Command
- دستوری که باید اجرا شود. (تنها برای کارها معتبر است)
- Comment
- توضیحات مرتبط با کار. (تنها برای کارها معتبر است)
- Contiguous
- آیا گرههای پیوسته توسط کار درخواست شدهاند یا خیر. (تنها برای کارها معتبر است)
- Container
- مسیر بسته کانتینر OCI.
- ContainerID
- شناسه اختصاصیافته به کانتینر OCI.
- ContainerType
- نوع کانتینر کار برای کار.
- Cores
- تعداد هستهها به ازای هر سوکت که توسط کار درخواست شده است. این مقدار گزینه srun --cores-per-socket را گزارش میدهد. هنگامی که --cores-per-socket تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- CoreSpec
- تعداد هستههای رزرو شده روی هر گره برای استفاده سیستم (تخصیص هسته). (تنها برای کارها معتبر است)
- CPUFreq
- فرکانس پردازندههای (CPU) تخصیصیافته را چاپ میکند. (تنها برای گامهای کار معتبر است)
- cpus-per-task
- تعداد پردازندههای (CPU) تخصیصیافته به کار به ازای هر وظیفه را چاپ میکند. (تنها برای کارها معتبر است)
- cpus-per-tres
- حافظه مورد نیاز به ازای منابع قابل ردیابی تخصیصیافته به کار یا گام کار را چاپ میکند.
- CronJob
- بسته به اینکه کار توسط scrontab ایجاد شده است یا خیر، Yes/No چاپ میکند. (تنها برای کارها معتبر است)
- Deadline
- مهلت زمانی (deadline) تعیینشده برای کار را چاپ میکند. (تنها برای کارها معتبر است)
- DelayBoot
- زمان تأخیر راهاندازی (boot). (تنها برای کارها معتبر است)
- Dependency
- وابستگیهای باقیمانده کار. این کار تا زمانی که این کارهای وابسته تکمیل نشوند، اجرای خود را آغاز نخواهد کرد. در مورد کاری که به دلیل برآورده نشدن دائمی وابستگیها هرگز نمیتواند اجرا شود، مشخصات کامل و اولیه وابستگی کار گزارش خواهد شد. پس از برآورده شدن یک وابستگی، از کار حذف میشود. مقدار NULL نشان میدهد که این کار هیچ وابستگیای ندارد. (تنها برای کارها معتبر است)
- DerivedEC
- بالاترین کد خروجی (exit code) بازگردانده شده توسط گامهای کار (فراخوانیهای srun). در صورتی که فرآیند توسط یک سیگنال خاتمه یافته باشد، سیگنالی که باعث پایان آن شده است پس از دونقطه میآید. (تنها برای کارها معتبر است)
- EligibleTime
- زمانی که کار واجد شرایط برای اجرا میشود. (تنها برای کارها معتبر است).IP
- EndTime
- زمان پایان کار، واقعی یا مورد انتظار. (تنها برای کارها معتبر است)
- Exclusive
- وضعیت انحصاری بودن کار (ستون EXCLUSIVE). (تنها برای کارها معتبر است). مقادیر ممکن:
- MCS: تنها کارهایی با برچسب MCS یکسان میتوانند یک گره را به اشتراک بگذارند (کار با --exclusive=mcs ثبت شده است).
- NO: بدون انحصار.
- NODE: تخصیص کل گره (کار با --exclusive ثبت شده، یا پارتیشن با Exclusive=NODE).
- TOPO: تنها یک کار بهازای هر بخش توپولوژی (کار با --exclusive=topo ثبت شده، یا پارتیشن با Exclusive=TOPO).
- مشابه شناسههای فیلد Exclusive در scontrol show job.
- USER: تنها کارهای یک کاربر میتوانند یک گره را به اشتراک بگذارند (کار با --exclusive=user ثبت شده، یا پارتیشن با Exclusive=USER).
- ExcNodes
- گرههایی که درخواست شده هنگام تخصیص این کار کنار گذاشته (مستثنی) شوند. (تنها برای کارها معتبر است)
- exit_code
- کد خروج بازگرداندهشده توسط کار، معمولاً مقداری که توسط تابع exit() تنظیم شده است. پس از دونقطه، سیگنالی درج میشود که در صورت خاتمه فرآیند با سیگنال، باعث توقف آن شده است. (تنها برای کارها معتبر است)
- Feature
- ویژگیهای مورد نیاز کار. (تنها برای کارها معتبر است)
- GroupID
- شناسه گروه (Group ID) کار. (تنها برای کارها معتبر است)
- GroupName
- نام گروه کار. (تنها برای کارها معتبر است)
- HetJobID
- شناسه کارِ (Job ID) رهبر کار ناهمگن (heterogeneous job).
- HetJobIDSet
- عبارتی که تمام شناسههای کارِ مؤلفهها را در یک کار ناهمگن مشخص میکند.
- HetJobOffset
- آفست بر پایه صفر در مجموعهای از مؤلفههای کار ناهمگن.
- JobArrayID
- شناسه کارِ آرایه کار. این مقدار، شناسه پایه کار است. برای کارهای غیرآرایهای، این همان شناسه کار است. (تنها برای کارها معتبر است)
- JobID
- شناسه کار (Job ID). این فیلد برای هر عضو از آرایههای کار و هر مؤلفه از کارهای ناهمگن، مقداری یکتا خواهد داشت. (تنها برای کارها معتبر است)
- LastSchedEval
- آخرین زمانی که کار برای زمانبندی ارزیابی شده است را چاپ میکند. (تنها برای کارها معتبر است)
- Licenses
- مجوزهای درخواستشده توسط کار. (تنها برای کارها معتبر است)
- LicensesAlloc
- مجوزهای تخصیصیافته به کار. (تنها برای کارها معتبر است)
- MaxCPUs
- حداکثر تعداد پردازندههای (CPUs) تخصیصیافته به کار را چاپ میکند. (تنها برای کارها معتبر است)
- MaxNodes
- حداکثر تعداد گرههای تخصیصیافته به کار را چاپ میکند. (تنها برای کارها معتبر است)
- MCSLabel
- مقدار MCS_label کار را چاپ میکند. (تنها برای کارها معتبر است)
- mem-per-tres
- میزان حافظه (به مبیبایت - MiB) مورد نیاز بهازای منابع قابلردیابی تخصیصیافته به کار یا گام کار را چاپ میکند.
- MinCpus
- حداقل تعداد پردازندهها (CPUs) در هر گره که توسط کار درخواست شده است. این فیلد مقدار گزینه srun --mincpus را گزارش میدهد که مقدار پیشفرض آن صفر است. (تنها برای کارها معتبر است)
- MinMemory
- حداقل میزان حافظه (به MiB) درخواستشده توسط کار. (تنها برای کارها معتبر است)
- MinTime
- حداقل محدودیت زمانی کار. (تنها برای کارها معتبر است)
- MinTmpDisk
- حداقل فضای دیسک موقت (به MiB) درخواستشده توسط کار. (تنها برای کارها معتبر است)
- Name
- نام کار یا گام کار. (معتبر برای کارها و گامهای کار)
- Network
- شبکهای که کار روی آن در حال اجرا است. (معتبر برای کارها و گامهای کار)
- Nice
- مقدار Nice (تنظیم اولویت زمانبندی یک کار). (تنها برای کارها معتبر است) NodeList فهرست گرههای تخصیصیافته به کار یا گام کار (job step). در مورد یک کار در وضعیت COMPLETING، فهرست گرهها تنها شامل گرههایی خواهد بود که هنوز به چرخه سرویسدهی بازنگشتهاند. (تنها برای کارها معتبر است)
- Nodes
- فهرست گرههای تخصیصیافته به کار یا گام کار. در مورد یک کار در وضعیت COMPLETING، فهرست گرهها تنها شامل گرههایی خواهد بود که هنوز به چرخه سرویسدهی بازنگشتهاند. (تنها برای گامهای کار معتبر است)
- NTPerBoard
- تعداد وظایف (tasks) تخصیصیافته به ازای هر برد (board) برای کار. (تنها برای کارها معتبر است)
- NTPerCore
- تعداد وظایف به ازای هر هسته (core) تخصیصیافته به کار. (تنها برای کارها معتبر است)
- NTPerNode
- تعداد وظایف به ازای هر گره (node) تخصیصیافته به کار. (تنها برای کارها معتبر است)
- NTPerSocket
- تعداد وظایف به ازای هر سوکت (socket) تخصیصیافته به کار. (تنها برای کارها معتبر است)
- NumCPUs
- تعداد CPUها (پردازندهها) درخواستشده توسط کار یا تخصیصیافته به آن در صورت در حال اجرا بودن. هنگامی که یک کار رو به اتمام است، این عدد تعداد فعلی CPUهای تخصیصیافته را منعکس میکند. (معتبر برای کارها و گامهای کار)
- NumNodes
- تعداد گرههای تخصیصیافته به کار یا حداقل تعداد گرههای مورد نیاز یک کار معلق (pending). تعداد واقعی گرههای تخصیصیافته به یک کار معلق ممکن است از این مقدار بیشتر باشد اگر کار بازهای از تعداد گره (مثلاً حداقل و حداکثر تعداد گره) یا تعداد پردازنده را به جای تعداد گره مشخص کرده باشد. هنگامی که یک کار رو به اتمام است، این عدد تعداد فعلی گرههای تخصیصیافته را منعکس میکند. (تنها برای کارها معتبر است)
- NumTasks
- تعداد وظایف درخواستشده توسط یک کار یا گام کار. این مقدار، گزینه --ntasks را گزارش میدهد. (معتبر برای کارها و گامهای کار)
- Origin
- نام خوشهای (cluster) که کار فدرال از آن منشأ گرفته است. (تنها برای کارهای فدرال معتبر است)
- OriginRaw
- شناسه عددی خوشه که کار فدرال از آن منشأ گرفته است. (تنها برای کارهای فدرال معتبر است)
- OverSubscribe
- همان مقادیر %h / OVER_SUBSCRIBE: مقادیر "YES" ،"NO" یا "OK". %h را در بالا ببینید. (تنها برای کارها معتبر است)
- Partition
- پارتیشن کار یا گام کار. (معتبر برای کارها و گامهای کار)
- PendingTime
- زمان (به ثانیه) میان زمان شروع و زمان ارسال کار. اگر کار هنوز شروع نشده باشد، زمان (به ثانیه) میان اکنون و زمان ارسال کار. (تنها برای کارها معتبر است)
- PreemptTime
- زمان قبضهشدن (preempt time) برای کار. (تنها برای کارها معتبر است)
- Prefer
- ویژگیهای ترجیحی (preferred features) یک کار معلق. (تنها برای کارها معتبر است)
- Priority
- اولویت کار (تبدیلشده به یک عدد اعشاری ممیز شناور بین 0.0 و 1.0). همچنین prioritylong را ببینید. (تنها برای کارها معتبر است)
- PriorityLong
- اولویت کار (عموماً یک عدد صحیح بدون علامت بسیار بزرگ). همچنین priority را ببینید. (تنها برای کارها معتبر است)
- Profile
- پروفایل کار. (تنها برای کارها معتبر است)
- QOS
- کیفیت خدمات (Quality of service) مرتبط با کار. (تنها برای کارها معتبر است)
- Reason
- دلیل قرار داشتن کار در وضعیت فعلیاش. برای اطلاعات بیشتر، بخش JOB REASON CODES را در زیر ببینید. (تنها برای کارها معتبر است)
- ReasonList
- برای کارهای معلق: دلیل منتظر بودن کار برای اجرا درون پرانتز چاپ میشود. برای کارهای خاتمهیافته با شکست: توضیحی درباره چرایی شکست کار درون پرانتز چاپ میشود. برای تمام وضعیتهای دیگر کار: فهرست گرههای تخصیصیافته. برای اطلاعات بیشتر، بخش JOB REASON CODES را در زیر ببینید. (تنها برای کارها معتبر است)
- Reboot
- مشخص میکند که آیا گرههای تخصیصیافته باید پیش از شروع کار بازراهاندازی (reboot) شوند یا خیر. (تنها برای کارها معتبر است)
- ReqNodes
- فهرست نامهای گرههایی که به طور صریح توسط کار درخواست شدهاند. (تنها برای کارها معتبر است)
- ReqSwitch
- حداکثر تعداد سوییچهای درخواستشده برای کار. (تنها برای کارها معتبر است)
- Requeue
- چاپ میکند که آیا کار در صورت بروز خطا دوباره در صف قرار میگیرد یا خیر. (تنها برای کارها معتبر است)
- Reservation
- رزرو (reservation) انجامشده برای کار. (تنها برای کارها معتبر است).IP
- ResizeTime
- مدت زمانی که برای اجرای کار تغییر یافته است. (تنها برای کارها معتبر است)
- RestartCnt
- تعداد راهاندازیهای مجدد برای کار. (تنها برای کارها معتبر است)
- ResvPort
- پورتهای رزروشده برای کار. (تنها برای گامهای کار معتبر است)
- SchedNodes
- برای کارهای در انتظار، فهرستی از گرههایی که انتظار میرود هنگام شروع کار استفاده شوند. (تنها برای کارها معتبر است)
- SCT
- تعداد سوکتها، هستهها و رشتههای درخواستی (S:C:T) به ازای هر گره برای کار. هنگامی که (S:C:T) تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- SegmentSize
- اندازه قطعه درخواستی توسط کار. (تنها برای کارها معتبر است)
- SiblingsActive
- نام خوشههایی که کارهای همزاد فدرال در آنها وجود دارند. (تنها برای کارهای فدرال معتبر است)
- SiblingsActiveRaw
- شناسه خوشههایی که کارهای همزاد فدرال در آنها وجود دارند. (تنها برای کارهای فدرال معتبر است)
- SiblingsViable
- نام خوشههایی که کارهای همزاد فدرال در آنها امکان اجرا دارند. (تنها برای کارهای فدرال معتبر است)
- SiblingsViableRaw
- شناسه خوشههایی که کارهای همزاد فدرال در آنها امکان اجرا دارند. (تنها برای کارهای فدرال معتبر است)
- Sluid
- شناسه یکتای مرتبپذیر از نظر واژهنگاری اسلورم (SLUID) که به کار اختصاص داده شده است. این مقدار در طول عمر کار، حتی پس از تغییر اندازه، ثابت میماند. توجه داشته باشید که پایگاهداده حسابرسی یک SLUID مجزا را برای هر رکورد حسابرسی پیگیری میکند که با تغییر اندازه یا صفبندی مجدد تغییر مییابد.
- Sockets
- تعداد سوکتهای هر گره درخواستی توسط کار. این فیلد مقدار گزینه srun --sockets-per-node را گزارش میدهد. هنگامی که --sockets-per-node تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- SPerBoard
- تعداد سوکتهای هر بُرد اختصاصیافته به کار. (تنها برای کارها معتبر است)
- StartTime
- زمان شروع واقعی یا مورد انتظار کار یا گام کار. (معتبر برای کارها و گامهای کار)
- State
- وضعیت کار در قالب گسترده. برای دیدن فهرستی از وضعیتهای ممکن، بخش JOB STATE CODES را در زیر ببینید. (تنها برای کارها معتبر است)
- StateCompact
- وضعیت کار در قالب فشرده. برای دیدن فهرستی از وضعیتهای ممکن، بخش JOB STATE CODES را در زیر ببینید. (تنها برای کارها معتبر است)
- STDERR
- دایرکتوری مقصد برای خروجی خطای استاندارد. (معتبر برای کارها و گامها)
- STDIN
- دایرکتوری مربوط به ورودی استاندارد. (معتبر برای کارها و گامها)
- STDOUT
- دایرکتوری مقصد برای خروجی استاندارد. (معتبر برای کارها و گامها)
- StepID
- شناسه کار یا گام کار. در مورد آرایههای کاری، قالب شناسه کار به شکل "<base_job_id>_<index>" خواهد بود. (تنها برای گامهای کار معتبر است)
- StepName
- نام گام کار. (تنها برای گامهای کار معتبر است)
- StepState
- وضعیت گام کار. (تنها برای گامهای کار معتبر است)
- SubmitTime
- زمانی که کار در آن ثبت و ارسال شده است. (تنها برای کارها معتبر است)
- system_comment
- توضیح سیستمی مرتبط با کار. (تنها برای کارها معتبر است)
- Threads
- تعداد رشتههای هر هسته درخواستی توسط کار. این فیلد مقدار گزینه srun --threads-per-core را گزارش میدهد. هنگامی که --threads-per-core تنظیم نشده باشد، "*" نمایش داده میشود. (تنها برای کارها معتبر است)
- TimeLeft
- زمان باقیمانده برای اجرای کار در قالب days-hours:minutes:seconds. این مقدار با کم کردن زمان مصرفشده کار از محدودیت زمانی آن محاسبه میشود. اگر مقدار هنوز تعیین نشده باشد ممکن است "NOT_SET" یا در صورت نامحدود بودن "UNLIMITED" باشد. (تنها برای کارها معتبر است)
- TimeLimit
- محدودیت زمانی برای کار یا گام کار. (معتبر برای کارها و گامهای کار)
- TimeUsed
- زمان استفادهشده توسط کار یا گام کار در قالب days-hours:minutes:seconds. روزها و ساعتها فقط در صورت نیاز نمایش داده میشوند. برای گامهای کار، این فیلد زمان سپریشده از شروع اجرا را نشان میدهد و بنابراین برای گامهای کاری که به حالت تعلیق درآمدهاند، دقیق نخواهد بود. ناهماهنگی ساعت (Clock skew) بین گرهها در خوشه باعث نادقیق شدن این زمان میشود. اگر زمان به وضوح نادرست باشد (برای نمونه منفی باشد)، به صورت "INVALID" نمایش داده میشود. (معتبر برای کارها و گامهای کار).IP
- tres-alloc
- چاپ منابع قابل ردیابی (TRES) تخصیصیافته به کار در صورت در حال اجرا بودن آن. اگر در حال اجرا نباشد، منابع قابل ردیابی درخواستشده توسط کار چاپ میشود.
- tres-bind
- چاپ اتصال وظایف (task binding) منابع قابل ردیابی درخواستشده توسط کار یا گام کار.
- tres-freq
- چاپ فرکانسهای منابع قابل ردیابی درخواستشده توسط کار یا گام کار.
- tres-per-job
- چاپ منابع قابل ردیابی درخواستشده توسط کار.
- tres-per-node
- چاپ منابع قابل ردیابی بهازای هر گره درخواستشده توسط کار یا گام کار.
- tres-per-socket
- چاپ منابع قابل ردیابی بهازای هر سوکت درخواستشده توسط کار یا گام کار.
- tres-per-step
- چاپ منابع قابل ردیابی درخواستشده توسط گام کار.
- tres-per-task
- چاپ منابع قابل ردیابی بهازای هر وظیفه درخواستشده توسط کار یا گام کار.
- UserID
- شناسه کاربر برای یک کار یا گام کار. (معتبر برای کارها و گامهای کار)
- UserName
- نام کاربر برای یک کار یا گام کار. (معتبر برای کارها و گامهای کار)
- Wait4Switch
- مدتزمان انتظار برای تعداد سوییچهای مورد نظر. (تنها برای کارها معتبر است)
- WCKey
- کلید مشخصهسازی بار کاری (wckey). (تنها برای کارها معتبر است)
- WorkDir
- دایرکتوری کاری کار. (تنها برای کارها معتبر است)
- --help
- چاپ یک پیام راهنما که تمامی گزینههای squeue را شرح میدهد.
- --hide
- اطلاعات مربوط به کارها و گامهای کار در تمام پارتیشنها نمایش داده نشود. بهطور پیشفرض، اطلاعات پارتیشنهایی که بهصورت پنهان پیکربندی شدهاند یا برای گروه کاربر در دسترس نیستند، نمایش داده نخواهد شد (یعنی این رفتار پیشفرض است).
- -i, --iterate=<seconds>
- جمعآوری و گزارش مکرر اطلاعات درخواستشده در بازه زمانی مشخصشده (به ثانیه). بهطور پیشفرض، یک برچسب زمانی را همراه با سرآیند چاپ میکند.
- -j, --jobs[=<job_id_list>]
- مشخص کردن فهرستی از شناسههای کار (job ID) جداشده با کاما جهت نمایش. پیشفرض همه کارها است. گزینه --jobs=<job_id_list> میتواند به همراه گزینه --steps برای چاپ اطلاعات گام کارهای مشخص استفاده شود. نکته: اگر فهرستی از شناسههای کار ارائه شود، کارها حتی در صورت قرار داشتن در پارتیشنهای پنهان نیز نمایش داده میشوند. از آنجا که آرگومان این گزینه اختیاری است، برای تجزیه درست، گزینه تکحرفی باید بلافاصله با مقدار دنبال شود و فاصلهای بین آنها نباشد؛ برای مثال "-j1008" و نه "-j 1008". قالب شناسه کار "job_id[_array_id]" است. یک SLUID نیز میتواند بهجای یک شناسه عددی کار استفاده شود. عملکرد دستور در سیستمهایی با تعداد کار بالا، در صورت مشخص شدن یک شناسه کار تکی، میتواند بهطور محسوسی بهبود یابد. بهطور پیشفرض، اندازه این فیلد به ۶۴ بایت محدود خواهد بود. از متغیر محیطی SLURM_BITSTR_LEN برای مشخص کردن اندازههای بزرگتر فیلد استفاده کنید.
- --json, --json=list, --json=<data_parser>
- تخلیه اطلاعات بهصورت JSON با استفاده از پلاگین پیشفرض data_parser یا یک data_parser صریح همراه با پارامترها. تمام اطلاعات تخلیه میشوند، حتی اگر در حالت عادی نمایش داده نشوند. آرگومانهای مرتبسازی و قالببندی ارائهشده به سایر گزینهها نادیده گرفته میشوند؛ با این حال، بیشتر آرگومانهای پالایشی همچنان اعمال میشوند.
- -L, --licenses=<license_list>
- درخواست کارهایی که یک یا چند مورد از مجوزهای نامبرده را درخواست داده یا استفاده میکنند. فهرست مجوزها شامل فهرستی از نامهای مجوز جداشده با کاما است.
- --local
- تنها نمایش کارهای محلی همین کلاستر. خوشهها یا کلاسترهای دیگر در این فدراسیون (در صورت وجود) نادیده گرفته میشوند. بر --federation اولویت دارد.
- -l, --long
- گزارش بخش بیشتری از اطلاعات موجود برای کارها یا گامهای کار انتخابشده، با رعایت هرگونه محدودیت مشخصشده.
- --me
- معادل با --user=<my username>.
- -n, --name=<name_list>
- درخواست کارها یا گامهای کاری که یکی از نامهای مشخصشده را دارند. فهرست شامل فهرستی از نامهای کار است که با کاما جدا شدهاند.
- --noconvert
- واحدها از نوع اصلیشان تبدیل نشوند (برای مثال 2048M به 2G تبدیل نخواهد شد).
- -w, --nodelist=<hostlist>
- تنها گزارش کارهایی که به گره یا فهرستی از گرههای مشخصشده تخصیص یافتهاند. در صورتی که تفاوت داشته باشند، این مقدار میتواند NodeName یا NodeHostname تعریفشده در slurm.conf(5) باشد. مقدار node_name برابر با localhost به نام میزبان جاری نگاشت میشود.
- -h, --noheader
- سرآیند در خروجی چاپ نشود.
- --notme
- نقطه مقابل --me؛ تنها کارهایی نمایش داده میشوند که متعلق به کاربر فراخواننده نیستند.
- --only-job-state
- پرسوجو تنها برای وضعیت کار انجام شود. این پرسوجو از RPC استفاده میکند که تنها اطلاعات JobID و State را نگه میدارد، که باعث کاهش کار مورد نیاز slurmctld برای پاسخگویی میشود.
- -p, --partition=<part_list>
- مشخص کردن پارتیشنهای کارها یا گامها جهت مشاهده. فهرستی از نامهای پارتیشن جداشده با کاما را میپذیرد..IP
- -P, --priority
- برای کارهای در انتظار ارسالشده به چندین پارتیشن، کار را به ازای هر پارتیشن یکبار فهرست میکند. علاوه بر این، اگر کارها بر اساس اولویت مرتب شده باشند، هم اولویت پارتیشن و هم اولویت کار در نظر گرفته میشود. این گزینه میتواند برای ایجاد فهرستی از کارهای در انتظار با همان ترتیبی که توسط Slurm برای زمانبندی در نظر گرفته میشود، همراه با گزینههای اضافی مناسب (مانند «--sort=-p,i --states=PD») استفاده شود.
- -q, --qos=<qos_list>
- مشخصکردن qos(های) کارها یا گامها برای مشاهده. فهرستی از qosها را که با کاما از هم جدا شدهاند میپذیرد.
- -R, --reservation=<reservation_list>
- مشخصکردن رزروهای کارهای مورد نظر برای مشاهده. فهرستی از نامهای رزرو که با کاما از هم جدا شدهاند را میپذیرد. کارهایی که با هر رزروی مطابقت داشته باشند، شرط فیلتر را برآورده میکنند (منطق عملکرد مانند OR است).
- --running-over=<time>
- تنها کارهایی را نمایش میدهد که بیش از مدت زمان مشخصشده در حال اجرا بودهاند. قالبهای زمانی قابل قبول شامل «minutes»، «minutes:seconds»، «hours:minutes:seconds»، «days-hours»، «days-hours:minutes» و «days-hours:minutes:seconds» هستند.
- --running-under=<time>
- تنها کارهایی را نمایش میدهد که کمتر از مدت زمان مشخصشده در حال اجرا بودهاند. قالبهای زمانی قابل قبول شامل «minutes»، «minutes:seconds»، «hours:minutes:seconds»، «days-hours»، «days-hours:minutes» و «days-hours:minutes:seconds» هستند.
- --sibling
- نمایش همه کارهای همزاد (sibling) در یک کلاستر فدرال. مستلزم گزینه --federation است.
- -S, --sort=<sort_list>
- مشخصکردن ترتیبی که رکوردها باید بر اساس آن گزارش شوند. این گزینه از همان مشخصات فیلدهای <output_format> استفاده میکند. از گزینه قالب بلند «cluster» نیز میتوان برای مرتبسازی کارها یا گامهای کاری بر اساس نام کلاستر (مثلاً کارهای فدرال) استفاده کرد. با مشخص کردن چندین فیلد مرتبسازی که با کاما از هم جدا شدهاند، میتوان مرتبسازیهای چندگانه انجام داد. مشخصات فیلدها میتواند برای ترتیب صعودی (پیشفرض) و نزولی به ترتیب با «+» یا «-» شروع شود. برای مثال، مقدار مرتبسازی "P,U" رکوردها را بر اساس نام پارتیشن و سپس بر اساس شناسه کاربری (user id) مرتب میکند. مقدار پیشفرض مرتبسازی برای کارها "P,t,-p" است (افزایش نام پارتیشن، سپس در یک پارتیشن معین با افزایش وضعیت کار و سپس کاهش اولویت). مقدار پیشفرض مرتبسازی برای گامهای کاری "P,i" است (افزایش نام پارتیشن، سپس در یک پارتیشن معین با افزایش شناسه گام).
- --start
- گزارش زمان تخمینی شروع و منابعی که قرار است برای کارهای در انتظار تخصیص یابد، به ترتیب افزایش زمان شروع. این گزینه معادل گزینههای زیر است: --format="%.18i %.9P %.8j %.8u %.2t %.19S %.6D %20Y %R"، --sort=S و --states=PENDING. هر یک از این گزینهها را میتوان در صورت تمایل با ترکیب گزینه --start با مقادیر گزینههای دیگر صراحتاً تغییر داد (مثلاً برای استفاده از قالب خروجی متفاوت). زمان تخمینی شروع کارهای در انتظار تنها در صورتی در دسترس است که Slurm برای استفاده از افزونه زمانبندی backfill پیکربندی شده باشد.
- -t, --states=<state_list>
- مشخصکردن وضعیت کارهای مورد نظر برای مشاهده. فهرستی از نامهای وضعیت که با کاما از هم جدا شدهاند یا مقدار "all" را میپذیرد. اگر "all" مشخص شود، کارهای تمام وضعیتها گزارش خواهند شد. اگر وضعیتی مشخص نشود، کارهای در انتظار (pending)، در حال اجرا (running) و در حال اتمام (completing) گزارش میشوند. برای مشاهده فهرستی از وضعیتهای معتبر، بخش JOB STATE CODES را در زیر ببینید. هر دو شکل تفصیلی و فشرده معتبر هستند. توجه داشته باشید که <state_list> ارائهشده به بزرگی و کوچکی حروف حساس نیست ("pd" و "PD" معادل هستند).
- -s, --steps[=<step_list>]
- مشخصکردن گامهای کاری برای مشاهده. این پرچم نشان میدهد که فهرستی از گامهای کاری جداشده با کاما بدون علامت مساوی در ادامه میآید (به مثالها مراجعه کنید). قالب گام کاری به صورت "job_id[_array_id].step_id" است. پیشفرض روی تمام گامهای کاری تنظیم شده است. از آنجا که آرگومان این گزینه اختیاری است، برای تجزیه درست، گزینه تکحرفی باید بلافاصله با مقدار همراه شود و فاصلهای بین آنها وجود نداشته باشد؛ برای مثال «-s1008.0» و نه «-s 1008.0».
- --usage
- چاپ یک پیام راهنمای مختصر شامل فهرستی از گزینههای squeue.
- -u, --user=<user_list>
- درخواست کارها یا گامهای کاری از فهرستی از کاربران که با کاما از هم جدا شدهاند. این فهرست میتواند شامل نامهای کاربری یا شناسههای کاربری باشد. هنگامی که یک کاربر مشخص شود، کارایی دستور برای سیستمهایی با تعداد کارهای زیاد میتواند به طور چشمگیری بهبود یابد.
- -v, --verbose
- گزارش جزئیات اقدامات squeue.
- -V , --version
- چاپ اطلاعات نسخه و خروج.
- --yaml, --yaml=list, --yaml=<data_parser>
- تخلیه
اطلاعات در
قالب YAML با
استفاده از
افزونه
پیشفرض data_parser
یا یک data_parser
صریح به
همراه
پارامترها.
تمام
اطلاعات
استخراج
میشوند،
حتی اگر در
حالت عادی
چنین نباشد.
آرگومانهای
مرتبسازی
و
قالببندی
ارسالشده
به
گزینههای
دیگر
نادیده
گرفته
میشوند؛
با این حال،
بیشتر
آرگومانهای
فیلترسازی
همچنان
اعمال
میگردند.
این کدها
دلیلی را
مشخص
میکنند که
چرا یک کار
توسط
زمانبند
آغاز نشده
است. ممکن
است چندین
دلیل وجود
داشته باشد
که چرا یک
کار هنوز
نمیتواند
آغاز شود،
که در این
صورت فقط
علتی که در
روش
زمانبندی
اقدامشده
با آن مواجه
شده است،
نمایش داده
خواهد شد.
دلایل ذکرشده در زیر برخی از موارد رایجتری هستند که ممکن است مشاهده کنید. برای دیدن فهرست کامل کدهای دلیل به این صفحه مراجعه کنید: https://slurm.schedmd.com/job_reason_codes.html
- AssocGrp*Limit
- انتساب (association) کار به یک محدودیت تجمعی روی برخی منابع رسیده است.
- AssociationJobLimit
- انتساب (association) کار به حداکثر تعداد کارهای مجاز خود رسیده است.
- AssocMax*Limit
- کار منبعی را درخواست میکند که محدودیت بهازای هر کار (per-job limit) را در انتساب (association) درخواستی نقض میکند.
- AssociationResourceLimit
- انتساب (association) کار به یک محدودیت منبع رسیده است.
- AssociationTimeLimit
- انتساب (association) کار به محدودیت زمانی خود رسیده است.
- BadConstraints
- قیود کار برآوردهشدنی نیستند.
- BeginTime
- زودترین زمان آغاز کار هنوز فرا نرسیده است.
- Cleaning
- کار در حال صفبندی مجدد است و هنوز در حال پاکسازی پس از اجرای قبلی خود میباشد.
- Dependency
- این کار وابستگی به کار دیگری دارد که هنوز برآورده نشده است.
- DependencyNeverSatisfied
- این کار وابستگی به کار دیگری دارد که هرگز برآورده نخواهد شد.
- InactiveLimit
- کار به حد InactiveLimit سیستم رسیده است.
- InvalidAccount
- حساب (account) کار نامعتبر است.
- InvalidQOS
- کیفیت خدمات (QOS) کار نامعتبر است.
- JobHeldAdmin
- کار توسط یک مدیر سیستم متوقف (held) شده است.
- JobHeldUser
- کار توسط کاربر متوقف (held) شده است.
- JobLaunchFailure
- امکان راهاندازی کار وجود نداشت. این امر ممکن است به دلیل مشکل سیستم فایل، نامعتبر بودن نام برنامه و غیره باشد.
- Licenses
- کار در انتظار یک مجوز (license) است.
- NodeDown
- گره مورد نیاز کار از کار افتاده (down) است.
- NonZeroExitCode
- کار با یک کد خروج غیر-صفر خاتمه یافت.
- PartitionDown
- پارتیشن مورد نیاز این کار در وضعیت DOWN قرار دارد.
- PartitionInactive
- پارتیشن مورد نیاز این کار در وضعیت Inactive قرار دارد و قادر به آغاز کارها نیست.
- PartitionNodeLimit
- تعداد گرههای مورد نیاز این کار خارج از محدودیتهای کنونی پارتیشن آن است. همچنین میتواند نشاندهنده این باشد که گرههای مورد نیاز در وضعیت DOWN یا DRAINED هستند.
- PartitionTimeLimit
- محدودیت زمانی کار از محدودیت زمانی کنونی پارتیشن آن فراتر میرود.
- Priority
- یک یا چند کار با اولویت بالاتر برای این پارتیشن یا رزرو پیشرفته (advanced reservation) وجود دارد.
- Prolog
- برنامه Prolog آن هنوز در حال اجرا است.
- QOSGrp*Limit
- کیفیت خدمات (QOS) کار به یک محدودیت تجمعی روی برخی منابع رسیده است.
- QOSJobLimit
- کیفیت خدمات (QOS) کار به حداکثر تعداد کارهای مجاز خود رسیده است.
- QOSMax*Limit
- کار منبعی را درخواست میکند که محدودیت بهازای هر کار را روی QOS درخواستی نقض میکند.
- QOSResourceLimit
- کیفیت خدمات (QOS) کار به یک محدودیت منبع رسیده است.
- QOSTimeLimit
- کیفیت خدمات (QOS) کار به محدودیت زمانی خود رسیده است.
- QOSUsageThreshold
- آستانه مجاز QOS نقض شده است.
- ReqNodeNotAvail
- گرهای که مشخصاً توسط این کار مورد نیاز است، در حال حاضر در دسترس نیست. گره ممکن است هماکنون در حال استفاده باشد، برای کار دیگری رزرو شده باشد، در یک رزرو پیشرفته (advanced reservation) باشد، یا در وضعیت DOWN ،DRAINED یا عدم پاسخگویی باشد. گرههایی که DOWN ،DRAINED یا پاسخگو نیستند در فیلد "reason" کار تحت عنوان "UnavailableNodes" مشخص خواهند شد. معمولاً برای در دسترس قرار دادن چنین گرههایی، مداخله مدیر سیستم مورد نیاز خواهد بود. Reservation کار در انتظار در دسترس قرار گرفتن رزرو پیشرفتهٔ خود است.
- Resources
- کار در انتظار در دسترس قرار گرفتن منابع است.
- SystemFailure
- خرابی در سیستم Slurm، یک سیستمفایل، شبکه، یا موارد دیگر.
- TimeLimit
- محدودیت زمانی کار به پایان رسیده است.
- WaitingForScheduling
- هنوز دلیلی برای این کار تنظیم نشده است. در انتظار زمانبند برای تعیین دلیل مناسب.
کدهای وضعیت کار (JOB STATE CODES)
کارها معمولاً در طول اجرای خود از چندین وضعیت عبور میکنند. وضعیتهای متداول عبارتند از PENDING، RUNNING، SUSPENDED، COMPLETING و COMPLETED. وضعیتهای زیر توسط squeue شناخته میشوند. فهرست کاملی از وضعیتهای ممکن در https://slurm.schedmd.com/job_state_codes.html در دسترس است.
- BF BOOT_FAIL
- کار به دلیل شکست در راهاندازی خاتمه یافت؛ معمولاً ناشی از خرابی سختافزاری (مانند عدم امکان راهاندازی گره یا بلوک و عدم امکان بازگردانی کار به صف).
- CA CANCELLED
- کار بهطور صریح توسط کاربر یا مدیر سیستم لغو شد. ممکن است اجرای کار آغاز شده باشد یا نشده باشد.
- CD COMPLETED
- تمام فرایندهای کار روی تمام گرهها با کد خروج صفر خاتمه یافتهاند.
- CF CONFIGURING
- منابع به کار تخصیص یافتهاند، اما کار در انتظار آماده شدن آنها برای استفاده است (برای نمونه، راهاندازی و بوت شدن).
- CG COMPLETING
- کار در فرایند تکمیل است. ممکن است برخی فرایندها روی برخی از گرهها همچنان فعال باشند.
- DL DEADLINE
- کار با رسیدن به مهلت زمانی (deadline) خاتمه یافت.
- F FAILED
- کار با کد خروج غیر صفر یا تحت شرایط خطای دیگر خاتمه یافت.
- NF NODE_FAIL
- کار به دلیل خرابی یک یا چند گرهٔ تخصیصیافته خاتمه یافت.
- OOM OUT_OF_MEMORY
- کار با خطای کمبود حافظه (out of memory) مواجه شد.
- PD PENDING
- کار در انتظار تخصیص منابع است.
- PR PREEMPTED
- کار به دلیل پیشدستی و بازپسگیری منابع (preemption) خاتمه یافت.
- R RUNNING
- کار در حال حاضر دارای تخصیص منابع است.
- RD RESV_DEL_HOLD
- کار پس از حذف رزرو درخواستی، در وضعیت تعلیق قرار گرفته است.
- RF REQUEUE_FED
- کار توسط یک فدراسیون مجدداً در صف قرار میگیرد.
- RH REQUEUE_HOLD
- کارِ در حال تعلیق مجدداً به صف بازگردانده میشود.
- RQ REQUEUED
- کارِ در حال تکمیل مجدداً در صف قرار میگیرد.
- RS RESIZING
- کار در آستانهٔ تغییر اندازه است.
- RV REVOKED
- کار همزاد (sibling) به دلیل شروع کار در کلاستری دیگر، از کلاستر حذف شد.
- SI SIGNALING
- سیگنال به کار ارسال میشود.
- SE SPECIAL_EXIT
- کار در یک وضعیت خاص مجدداً به صف فرستاده شد. این وضعیت در صورتی که کار با مقدار خروج خاصی خاتمه یافته باشد، معمولاً میتواند توسط کاربران در EpilogSlurmctld تنظیم شود.
- SO STAGE_OUT
- کار در حال انتقال فایلهای خروجی به مقصد (stage out) است.
- ST STOPPED
- کار دارای تخصیص منابع است، اما اجرای آن با سیگنال SIGSTOP متوقف شده است. پردازندهها (CPUs) همچنان برای این کار حفظ شدهاند.
- S SUSPENDED
- کار دارای تخصیص منابع است، اما اجرای آن به حالت تعلیق درآمده و پردازندهها (CPUs) برای کارهای دیگر آزاد شدهاند.
- TO TIMEOUT
- کار با رسیدن به محدودیت زمانی خود خاتمه یافت.
اجرای squeue یک فراخوانی رویه از راه دور (RPC) به slurmctld ارسال میکند. اگر تعداد فراخوانیهای ارسالی از سوی squeue یا سایر دستورهای کلاینت Slurm که فراخوانیهای رویه از راه دور به دیمن slurmctld میفرستند در یک لحظه بسیار زیاد باشد، میتواند منجر به افت کارایی دیمن slurmctld و احتمالاً بروز منع سرویس (DoS) شود.
دستور squeue یا سایر دستورهای کلاینت Slurm را که فراخوانیهای رویه از راه دور به slurmctld میفرستند، درون حلقهها در اسکریپتهای پوسته یا برنامههای دیگر اجرا نکنید. اطمینان حاصل کنید که برنامهها فراخوانیهای squeue را به حداقل میزان لازم برای اطلاعاتی که در پی گردآوری آنها هستید، محدود کنند.
متغیرهای محیطی (ENVIRONMENT VARIABLES)
برخی از گزینههای squeue را میتوان از طریق متغیرهای محیطی تنظیم کرد. این متغیرهای محیطی به همراه گزینههای مربوطهشان در ادامه فهرست شدهاند. (نکته: گزینههای خط فرمان همواره بر این تنظیمات اولویت خواهند داشت.)
- SLURM_BITSTR_LEN
- طول رشتهای را که برای نگهداری عبارت شناسه وظیفه (task ID) آرایه کار استفاده میشود، مشخص میکند. مقدار پیشفرض ۶۴ بایت است. مقدار 0 کل عبارت را با هر طولی که نیاز باشد چاپ میکند. مقادیر بزرگتر ممکن است تأثیر نامطلوبی بر کارایی برنامه بگذارند.
- SLURM_CLUSTERS
- مشابه --clusters
- SLURM_CONF
- محل فایل پیکربندی Slurm.
- SLURM_DEBUG_FLAGS
- پرچمهای اشکالزدایی (debug flags) را برای استفاده squeue مشخص میکند. برای فهرست کامل پرچمها، DebugFlags را در صفحه راهنمای slurm.conf(5) ببینید. این متغیر محیطی بر تنظیمات موجود در slurm.conf اولویت دارد.
- SLURM_JSON
- کنترل سریالسازی JSON:
- SLURM_TIME_FORMAT
- قالب مورد
استفاده
برای گزارش
برچسبهای
زمانی را
مشخص
میکند.
مقدار standard که
مقدار
پیشفرض
است، خروجی
را به شکل
"year-month-dateThour:minute:second"
تولید
میکند.
مقدار relative
برای روز
جاری تنها
"hour:minute:second" را
بازمیگرداند.
برای سایر
روزها در
سال جاری،
"hour:minute" را پیش
از
عبارتهای
"Tomorr" (فردا)،
"Ystday" (دیروز)،
نام روز
برای هفته
آینده
(مانند "Mon"
،"Tue" و غیره)،
و در غیر
این صورت
تاریخ
(مانند "25 Apr")
چاپ میکند.
برای
سالهای
دیگر،
تاریخ ماه و
سال را بدون
زمان
بازمیگرداند
(مانند "6 Jun 2012").
تمام
برچسبهای
زمانی از یک
قالب ۲۴
ساعته
استفاده
میکنند.
یک قالب معتبر strftime() نیز میتواند مشخص شود. برای مثال، مقدار "%a %T" روز هفته و برچسب زمانی را گزارش میکند (مانند "Mon 12:34:56").
- SLURM_YAML
- کنترل سریالسازی YAML:
- SQUEUE_ACCOUNT
- -A <account_list>, --account=<account_list>
- SQUEUE_ALL
- -a, --all
- SQUEUE_ARRAY
- -r, --array
- SQUEUE_NAMES
- --name=<name_list>
- SQUEUE_FEDERATION
- --federation
- SQUEUE_FORMAT
- -o <output_format>, --format=<output_format>
- SQUEUE_FORMAT2
- -O <output_format>, --Format=<output_format>
- SQUEUE_LICENSES
- -p-l <license_list>, --license=<license_list>
- SQUEUE_LOCAL
- --local
- SQUEUE_PARTITION
- -p <part_list>, --partition=<part_list>
- SQUEUE_PRIORITY
- -P, --priority
- SQUEUE_QOS
- -p <qos_list>, --qos=<qos_list>
- SQUEUE_SIBLING
- --sibling
- SQUEUE_SORT
- -S <sort_list>, --sort=<sort_list>
- SQUEUE_STATES
- -t <state_list>, --states=<state_list>
- SQUEUE_USERS
- -u <user_list>, --users=<user_list>
- چاپ کارهای زمانبندیشده در پارتیشن debug و در وضعیت COMPLETED در قالبی با شش رقم راستچین برای job id و بهدنبال آن اولویت با اندازهٔ فیلد دلخواه:
-
$ squeue -p debug -t COMPLETED -o "%.6i %p" JOBID PRIORITY 65543 99993 65544 99992 65545 99991
- چاپ گامهای کار در پارتیشن debug مرتبشده بر اساس کاربر:
-
$ squeue -s -p debug -S u STEPID NAME PARTITION USER TIME NODELIST 65552.1 test1 debug alice 0:23 dev[1-4] 65562.2 big_run debug bob 0:18 dev22 65550.1 param1 debug candice 1:43:21 dev[6-12]
- چاپ اطلاعات فقط برای کارهای 12345، 12346 و 12348:
-
$ squeue --jobs 12345,12346,12348 JOBID PARTITION NAME USER ST TIME NODES NODELIST(REASON) 12345 debug job1 dave R 0:21 4 dev[9-12] 12346 debug job2 dave PD 0:00 8 (Resources) 12348 debug job3 ed PD 0:00 4 (Priority)
- چاپ اطلاعات فقط برای گام کار 65552.1:
-
$ squeue --steps 65552.1 STEPID NAME PARTITION USER TIME NODELIST 65552.1 test2 debug alice 12:49 dev[1-4]
کپیرایت و تکثیر (COPYING)
حق نشر (C) 2002-2007
متعلق به The Regents of the
University of California.
تولیدشده
در Lawrence Livermore National Laboratory (ر.ک:
DISCLAIMER).
حق نشر (C) 2008-2010
متعلق به Lawrence Livermore
National Security.
حق نشر (C) 2010-2022
متعلق به SchedMD LLC.
این فایل بخشی از Slurm، یک برنامهٔ مدیریت منابع است. برای جزئیات بیشتر، https://slurm.schedmd.com را ببینید.
نرمافزار Slurm یک نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط «پروانهٔ عمومی همگانی گنو» (GNU General Public License) همانطور که توسط بنیاد نرمافزارهای آزاد (Free Software Foundation) منتشر شده است، چه نسخهٔ ۲ پروانه یا (به انتخاب خودتان) هر نسخهٔ بعدی بازتوزیع کرده و/یا تغییر دهید.
نرمافزار Slurm با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر «پروانهٔ عمومی همگانی گنو» را ببینید.
همچنین ببینید (SEE ALSO)
scancel(1), scontrol(1), sinfo(1), srun(1), slurm_load_ctl_conf (3), slurm_load_jobs (3), slurm_load_node (3), slurm_load_partitions (3)
| Slurm Commands | Slurm 26.05 |