.TH sbcast "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands"

.SH "نام (NAME)"
sbcast \- انتقال فایل به گره‌های تخصیص‌یافته به یک کار Slurm

.SH "خلاصه دستور (SYNOPSIS)"
\fBsbcast\fR [\-CfFjpstvV] SOURCE DEST

.SH "توضیحات (DESCRIPTION)"
دستور
\fBsbcast\fR
برای انتقال یک فایل به تمام گره‌های تخصیص‌یافته به کار فعال فعلی Slurm استفاده می‌شود.
این دستور تنها باید از درون یک کار دسته‌ای (batch job) در Slurm یا درون پوسته‌ای که پس از تخصیص منابع یک کار Slurm ایجاد شده است اجرا شود.
\fBSOURCE\fR
نام فایل موجود در گره فعلی است.
\fBDEST\fR
باید نام مسیر کامل (fully qualified pathname) برای نسخه کپی فایلی باشد که قرار است روی هر گره ساخته شود.
اگر نام مسیر کامل ارائه نشود، فایل در دایرکتوری مشخص‌شده در پارامتر
\fBBcastParameters\fR
در فایل
\fBslurm.conf\fR
(در صورت وجود) ایجاد می‌شود، در غیر این صورت در دایرکتوری کاری فعلی که دستور sbcast از آن اجرا شده است ایجاد خواهد شد.
\fBDEST\fR
باید روی سیستم‌فایل محلی مربوط به آن گره باشد.
توجه داشته باشید که سیستم‌فایل‌های موازی
\fIممکن است\fR
عملکرد بهتری نسبت به آنچه
\fBsbcast\fR
ارائه می‌دهد داشته باشند، اگرچه کارایی بسته به اندازه فایل، درجه موازی‌سازی و نوع شبکه متفاوت خواهد بود.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-C\fR, \fB\-\-compress\fR[=\fIlibrary\fR]
فشرده‌سازی فایلی که منتقل می‌شود.
آرگومان اختیاری، کتابخانه فشرده‌سازی داده مورد استفاده را مشخص می‌کند.
مقادیر پشتیبانی‌شده عبارتند از "lz4" (پیش‌فرض) و "none".
برخی از کتابخانه‌های فشرده‌سازی ممکن است در بعضی سیستم‌ها در دسترس نباشند.
کتابخانه فشرده‌سازی پیش‌فرض (و فعال‌سازی خود فشرده‌سازی) را می‌توان در فایل slurm.conf با استفاده از گزینه BcastParameters تنظیم کرد.
.IP

.TP
\fB\-\-exclude\fR=<\fINONE\fR|\fIpath1\fR,\fI...\fR,\fIpathN\fR>
فهرست جداشده با کاما از مسیرهای دایرکتوری مطلق که هنگام تشخیص خودکار و انتشار وابستگی‌های شیء مشترک (shared object) فایل اجرایی، باید مستثنی شوند.
اگر کلمه کلیدی "\fINONE\fR" تنظیم شود، هیچ مسیر دایرکتوری مستثنی نخواهد شد.
مقدار پیش‌فرض همان مقدار \fBBcastExclude\fR در slurm.conf است و این گزینه آن را لغو می‌کند.
همچنین گزینه \fB\-\-send\-libs\fR را ببینید.
.IP

.TP
\fB\-f\fR, \fB\-\-force\fR
اگر فایل مقصد (و دایرکتوری کتابخانه مقصد هنگام استفاده از \fB\-\-send\-libs\fR) از قبل وجود داشته باشد، آن را جایگزین می‌کند.
.IP

.TP
\fB\-j\fR, \fB\-\-jobid\fR=<\fIjobID\fR[+\fIhetjobOffset\fR].[\fIstepID\fR]>
شناسه کار (job ID) مورد نظر را به همراه آفست hetjob اختیاری و/یا شناسه گام (step ID) مشخص می‌کند.
یک SLUID نیز می‌تواند به‌جای یک شناسه کار عددی استفاده شود.
اگر درون یک تخصیص (allocation) اجرا شود، نیازی به این گزینه نیست زیرا شناسه کار از محیط خوانده خواهد شد.
.IP

.TP
\fB\-Z\fR, \fB\-\-no-allocation\fR
انتقال فایل‌ها به فهرستی از گره‌ها صرف‌نظر از کارهایی که ممکن است در حال اجرا داشته باشند.
این کار فقط توسط SlurmUser/root قابل انجام است.

گزینه \fB\-\-nodelist\fR باید همراه با این گزینه استفاده شود.
.IP

.TP
\fB\-w\fR, \fB\-\-nodelist\fR=<\fInode_name_list\fR>
فهرست میزبان‌هایی که فایل‌ها به آن‌ها منتقل می‌شوند.
این گره‌ها باید زیرمجموعه‌ای از کار مورد نظر باشند، یا اینکه باید از گزینه \fB\-\-no-allocation\fR استفاده شود.
.IP

.TP
\fB\-p\fR, \fB\-\-preserve\fR
زمان‌های اصلاح، زمان‌های دسترسی و مجوزهای فایل اصلی را حفظ می‌کند.
.IP

.TP
\fB\-\-send\-libs\fR[=\fIyes\fR|\fIno\fR]
اگر روی \fIyes\fR تنظیم شود (یا بدون آرگومان فراخوانی شود)، وابستگی‌های شیء مشترک فایل اجرایی را به‌طور خودکار تشخیص داده و به گره‌های محاسباتی تخصیص‌یافته منتشر می‌کند.
این فایل‌ها در یک دایرکتوری در کنار فایل اجرایی قرار می‌گیرند.
این گزینه رفتار پیش‌فرض پیکربندی‌شده در \fBSbcastParameters send_libs\fR درون slurm.conf را لغو می‌کند.
همچنین گزینه \fB\-\-exclude\fR را ببینید.
.IP

.TP
\fB\-s\fR, \fB\-\-size\fR=<\fIsize\fR>
اندازه بلوک مورد استفاده برای انتشار فایل را مشخص می‌کند.
این اندازه می‌تواند پسوند \fIk\fR یا \fIm\fR برای کیلوبایت یا مگابایت داشته باشد (به‌طور پیش‌فرض بر حسب بایت است).
این اندازه جهت حفظ کارایی مناسب، مشمول گرد کردن و محدودیت‌های بازه‌ای است.
مقدار پیش‌فرض اندازه فایل یا 8MB است، هرکدام که کوچک‌تر باشد.
این مقدار ممکن است در سیستم‌هایی با حافظه بسیار محدود نیاز به تنظیم داشته باشد.
.IP

.TP
\fB\-t\fR, \fB\-\-timeout\fR=<\fIseconds\fR>
مهلت زمانی پیام را بر حسب ثانیه مشخص می‌کند.
مقدار پیش‌فرض همان \fIMessageTimeout\fR گزارش‌شده توسط "scontrol show config" است.
تنظیم یک مقدار بالاتر ممکن است به دلیل عملکرد نسبتاً کند I/O روی دیسک‌های گره محاسباتی لازم باشد.
.IP

.TP
\fB\-F\fR, \fB\-\-treewidth\fR=<\fInumber\fR>
عرض درختی (treewidth) پیام‌های مورد استفاده برای انتقال فایل را مشخص می‌کند.
حداکثر مقدار در حال حاضر ۶۴ است. مقدار "off" فن‌اوت (fanout) را غیرفعال می‌کند.
.IP

.TP
\fB\-v\fR, \fB\-\-verbose\fR
ثبت گزارش‌های تفصیلی از رویدادها را در طول اجرای برنامه فراهم می‌کند.
.IP

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

.SH "کارایی (PERFORMANCE)"
.PP
اجرای
\fBsbcast\fR
یک فراخوانی روال از راه دور (RPC) به
\fBslurmctld\fR
ارسال می‌کند.
اگر تعداد فراخوانی‌های هم‌زمان از سوی
\fBsbcast\fR
یا دیگر دستورات کلاینت Slurm که فراخوانی روال از راه دور به دیمن
\fBslurmctld\fR
می‌فرستند زیاد باشد، می‌تواند منجر به کاهش کارایی دیمن
\fBslurmctld\fR
و احتمالاً بروز شرایط انکار سرویس (DoS) شود.
.PP
دستور
\fBsbcast\fR
یا دیگر دستورات کلاینت Slurm را که فراخوانی‌های روال از راه دور به
\fBslurmctld\fR
ارسال می‌کنند، در حلقه‌های اسکریپت‌های شل یا دیگر برنامه‌ها اجرا نکنید.
اطمینان حاصل کنید که برنامه‌ها فراخوانی‌های
\fBsbcast\fR
را به حداقل مقدار لازم برای اطلاعاتی که در پی جمع‌آوری آن هستید محدود کنند.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
برخی از گزینه‌های
\fBsbcast\fR
را می‌توان از طریق متغیرهای محیطی تنظیم کرد.
این متغیرهای محیطی به همراه گزینه‌های متناظر آن‌ها در زیر آورده شده‌اند.
(توجه: گزینه‌های خط فرمان همواره بر این تنظیمات اولویت خواهند داشت.)

.TP 20
\fBSBCAST_COMPRESS\fR
\fB\-C, \-\-compress\fR
.IP

.TP
\fBSBCAST_EXCLUDE\fR
\fB\-\-exclude\fR=<\fINONE\fR|\fIpath1\fR,\fI...\fR,\fIpathN\fR>
.IP

.TP
\fBSBCAST_FANOUT\fR
\fB\-F\fR \fInumber\fR, \fB\-\-fanout\fR=\fInumber\fR
.IP

.TP
\fBSBCAST_FORCE\fR
\fB\-f, \-\-force\fR
.IP

.TP
\fBSBCAST_SEND_LIBS\fR
\fB\-\-send\-libs\fR[=\fIyes|no\fR]
.IP

.TP
\fBSBCAST_PRESERVE\fR
\fB\-p, \-\-preserve\fR
.IP

.TP
\fBSBCAST_SIZE\fR
\fB\-s\fR \fIsize\fR, \fB\-\-size\fR=\fIsize\fR
.IP

.TP
\fBSBCAST_TIMEOUT\fR
\fB\-t\fR \fIseconds\fR, \fB\-\-timeout\fR=\fIseconds\fR
.IP

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

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

.SH "مجوزها (AUTHORIZATION)"

هنگام استفاده از SlurmDBD، به کاربرانی که سطح مدیریتی (AdminLevel) برای آن‌ها تعریف شده است (Operator یا Admin) این اختیار داده می‌شود که sbcast را روی کارهای سایر کاربران اجرا کنند.

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

با استفاده از یک اسکریپت دسته‌ای (batch script)، فایل محلی \fBmy.prog\fR را به \fB/tmp/my.proc\fR روی گره‌های محلی منتقل کرده و سپس آن را اجرا کنید:

.nf
$ cat my.job
#!/bin/bash
sbcast my.prog /tmp/my.prog
srun /tmp/my.prog

$ sbatch \-\-nodes=8 my.job
srun: jobid 12345 submitted
.fi

.SH "کپی‌رایت و تکثیر (COPYING)"
Copyright (C) 2006\-2010 The Regents of the University of California.
Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
.br
Copyright (C) 2010\-2022 SchedMD LLC.
.LP
این فایل بخشی از Slurm، یک برنامه مدیریت منابع است.
برای جزئیات بیشتر، <https://slurm.schedmd.com> را ببینید.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است (یا نسخه ۲ مجوز، یا به انتخاب خودتان، هر نسخه بعدی آن) بازتوزیع کرده و/یا تغییر دهید.
.LP
این نرم‌افزار به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
\fBsrun\fR(1)