.TH sattach "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands"

.SH "نام (NAME)"
.LP
sattach \- متصل شدن به یک گام کاری در Slurm.
.SH "خلاصه دستور (SYNOPSIS)"
.LP
sattach [\fIoptions\fP] <jobid|sluid)>.<stepid>
.SH "توضیحات (DESCRIPTION)"
.LP
دستور sattach به یک گام کاری (job step) در حال اجرا در Slurm متصل می‌شود. با متصل شدن، این ابزار جریان‌های IO همه وظایف (tasks) یک گام کاریِ در حال اجرای Slurm را در دسترس قرار می‌دهد. همچنین برای استفاده به همراه یک اشکال‌زدا (debugger) موازی مانند TotalView مناسب است. از آن نمی‌توان برای اتصال مستقیم به گام‌های extern یا batch استفاده کرد، چرا که کانال‌های IO این گام‌ها تنظیم نشده‌اند یا مستقیماً به یک فایل هدایت شده‌اند.
.PP
می‌توان از یک SLUID به جای یک شناسه عددی کار (job ID) برای شناسایی کار استفاده کرد.

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

.TP
\fB\-\-error\-filter\fR[=]<\fItask number\fR>
.PD
فقط ورودی استاندارد را به یک وظیفه منفرد ارسال می‌کند، یا خروجی استاندارد یا خطای استاندارد را از یک وظیفه منفرد چاپ می‌کند. فیلتر کردن به صورت محلی در sattach انجام می‌شود.
.IP

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

.TP
\fB\-\-input\-filter\fR[=]<\fItask number\fR>
.PD
فقط ورودی استاندارد را به یک وظیفه منفرد ارسال می‌کند، یا خروجی استاندارد یا خطای استاندارد را از یک وظیفه منفرد چاپ می‌کند. فیلتر کردن به صورت محلی در sattach انجام می‌شود.
.IP

.TP
\fB\-l\fR, \fB\-\-label\fR
شماره وظیفه مبدأ را به ابتدای هر خط از خروجی استاندارد یا خطای استاندارد وظیفه اضافه می‌کند.
.IP

.TP
\fB\-\-layout\fR
برای دریافت اطلاعات چیدمان وظایف (task layout) مربوط به گام کاری با slurmctld ارتباط برقرار می‌کند، اطلاعات چیدمان وظایف را چاپ کرده و سپس بدون متصل شدن به گام کاری خارج می‌شود.
.IP

.TP
\fB\-\-output\-filter\fR[=]<\fItask number\fR>
.PD
فقط ورودی استاندارد را به یک وظیفه منفرد ارسال می‌کند، یا خروجی استاندارد یا خطای استاندارد را از یک وظیفه منفرد چاپ می‌کند. فیلتر کردن به صورت محلی در sattach انجام می‌شود.
.IP

.TP
\fB\-\-pty\fR
اجرای وظیفه صفر در شبه‌پایانه (pseudo terminal).
با گزینه‌های \fB\-\-input\-filter\fR، \fB\-\-output\-filter\fR یا \fB\-\-error\-filter\fR سازگار نیست.
نکات: اندازه پایانه و رخدادهای تغییر اندازه توسط sattach نادیده گرفته می‌شوند.
کارکرد صحیح نیازمند آن است که گام کاری توسط srun با استفاده از گزینه \-\-pty آغاز شده باشد.
.IP

.TP
\fB\-Q\fR, \fB\-\-quiet\fR
فرونشانی پیام‌های اطلاع‌رسانی از sattach. خطاها همچنان نمایش داده خواهند شد.
.IP

.TP
\fB\-u\fR, \fB\-\-usage\fR
نمایش پیام کوتاه نحوه استفاده و خروج.
.IP

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

.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش پرگویی (verbosity) پیام‌های اطلاع‌رسانی sattach. استفاده چندباره از \fB\-v\fR میزان پرگویی sattach را بیش از پیش افزایش می‌دهد.
.IP

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

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

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

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

.TP
\fBSLURM_EXIT_ERROR\fR
کد خروجی تولیدشده در هنگام وقوع خطای Slurm (مانند گزینه‌های نامعتبر) را مشخص می‌کند.
این متغیر می‌تواند توسط یک اسکریپت برای تفکیک کدهای خروج برنامه کاربردی از شرایط خطای مختلف Slurm استفاده شود.
.IP

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

.TP
اتصال به کار 15، گام 0:
.IP
.nf
$ sattach 15.0
.fi

.TP
اتصال به کار با شناسه SLUID به مقدار s4SNKN57XZTE00، گام 1:
.IP
.nf
$ sattach s4SNKN57XZTE00.1
.fi

.TP
محدود کردن خروجی به وظیفه پنجم کار 65386، گام 15:
.IP
.nf
$ sattach \-\-output\-filter 5 65386.15
.fi

.SH "کپی‌رایت و تکثیر (COPYING)"
کپی‌رایت (C) ۲۰۰۶\-۲۰۰۷ The Regents of the University of California.
تولید شده در Lawrence Livermore National Laboratory (ر.ک: DISCLAIMER).
.br
کپی‌رایت (C) ۲۰۰۸\-۲۰۰۹ Lawrence Livermore National Security.
.br
کپی‌رایت (C) ۲۰۱۰\-۲۰۲۲ SchedMD LLC.
.LP
این فایل بخشی از Slurm، یک برنامه مدیریت منابع است.
برای جزئیات بیشتر، ببینید <https://slurm.schedmd.com>.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ پروانه و چه (به دلخواه خود) هر نسخه بعدی آن.
.LP
نرم‌افزار Slurm با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBsinfo\fR(1), \fBsalloc\fR(1), \fBsbatch\fR(1), \fBsqueue\fR(1),
\fBscancel\fR(1), \fBscontrol\fR(1),
\fBslurm.conf\fR(5), \fBsched_setaffinity\fR (2), \fBnuma\fR (3)