.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FCRONDYN" "1" "22 March 2025" "03/22/2025" ""

.SH "نام (NAME)"
fcrondyn \- گفتگو و تعامل پویا با دیمِن در حال اجرای fcron
.SH "خلاصه دستور (SYNOPSIS)"

\fBfcrondyn\fR [ \fB-c \fIfile\fB\fR ] [ \fB-i\fR ]


\fBfcrondyn\fR [ \fB-c \fIfile\fB\fR ] \fB-x \fIcommand\fB\fR


\fBfcrondyn\fR [ \fB-h\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBFcrondyn\fR ابزاری کاربری برای تعامل با دیمِن در حال اجرای
fcron است. برای نمونه، این ابزار می‌تواند کارهای بارگذاری‌شده کاربر توسط fcron را فهرست کند، یکی از
آن‌ها را اجرا کند، اولویت (renice) یک کار در حال اجرا را تغییر دهد، به یک کار در حال اجرا سیگنال بفرستد و غیره.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-i\fR
اجرای \fBfcrondyn\fR در حالت تعاملی (interactive). همچنین در صورتی که
هیچ گزینه‌ای داده نشود، \fBfcrondyn\fR در حالت تعاملی اجرا می‌شود.
.TP
\fB-x \fIcommand\fB\fR
اجرای \fIcommand\fR و بازگشت
فوری. برای نحو و فهرستی از
دستورها بخش زیر را ببینید.
.TP
\fB-c \fIfile\fB\fR
باعث می‌شود \fBfcrondyn\fR به‌جای فایل پیکربندی پیش‌فرض
\fI/usr/local/etc/fcron.conf\fR\& از فایل پیکربندی
\fIfile\fR استفاده کند. برای برقراری تعامل با یک فرایند در حال اجرای
\fBfcron\fR، باید \fBfcrondyn\fR از همان فایل پیکربندی فرایند استفاده کند. به
این ترتیب، چند فرایند \fBfcron\fR می‌توانند به‌طور هم‌زمان روی یک سیستم اجرا شوند.
.TP
\fB-d\fR
اجرا در حالت اشکال‌زدایی (debug). در این حالت، پیام‌های اطلاعاتی
متعددی در خروجی نمایش داده می‌شوند تا درستی همه‌چیز بررسی شود.
.TP
\fB-h\fR
نمایش توضیحی کوتاه دربارهٔ گزینه‌ها.
.TP
\fB-V\fR
نمایش پیامی اطلاعاتی دربارهٔ \fBfcrondyn\fR،
شامل نسخهٔ آن و مجوزی که تحت آن منتشر شده است.
.SH "شرح دستورها (COMMAND DESCRIPTION)"
.PP
نحو دستورهای \fBFcrondyn\fR\& به شرح زیر است:
.sp
.RS
.PP
\fBcommand\fR \fIarg1\fR
\fIarg2\fR [...]
.RE
.PP
هر آرگومان در یک دستور \fBfcrondyn\fR از یکی از انواع
زیر است:
"انواع آرگومان‌های دستورهای FCRONDYN"
.TP
\fBuser\fR
یک نام کاربری معتبر.
.TP
\fBjobid\fR
شناسه کار که توسط یکی از دستورهای \fBls*\fR
مربوط به \fBfcrondyn\fR ارائه شده است (یعنی یک عدد صحیح).
.TP
\fBsig\fR
شماره سیگنال، یا نام آن (بزرگی و کوچکی حروف اهمیتی ندارد).
برای نمونه، "term" یا "15".
.TP
\fBniceval\fR
مقدار اولویت کار. یک
\fBniceval\fR عددی صحیح از -20 (بالاترین
اولویت) تا 19 (پایین‌ترین) است (تنها کاربر root مجاز است برای این گزینه مقدار منفی تعیین کند).
.PP
و در نهایت، دستورهای زیر شناسایی می‌شوند
(آرگومان‌های اختیاری درون [] قرار دارند):
"دستورهای معتبر FCRONDYN"
.TP
\fBhelp\fR
.TP
\fBh\fR
چاپ یک پیام راهنما دربارهٔ دستورهای
fcrondyn.
.TP
\fBquit\fR
.TP
\fBq\fR
در حالت تعاملی، خروج از fcrondyn.
.TP
\fBls [user]\fR
فهرست کردن تمام کارهای user. هنگامی که \fBls\fR
توسط root اجرا شود، کارهای تمام کاربران فهرست می‌شوند مگر اینکه نام کاربری به‌عنوان آرگومان داده شود. برای توضیحاتی دربارهٔ
فیلدهای مورد استفاده در دستورهای \fBls*\fR به بخش زیر مراجعه کنید.
.TP
\fBls_lavgq [user]\fR
مشابه با \fBls\fR، اما تنها کارهایی را فهرست می‌کند
که در صف میانگین بار کاری (load-average queue) هستند (یعنی برای اجرا در انتظار میانگین بار کاری پایین‌تر
هستند).
.TP
\fBls_serialq [user]\fR
مشابه با \fBls\fR، اما تنها کارهایی را فهرست می‌کند
که در صف ترتیبی (serial queue) هستند (یعنی در انتظار به پایان رسیدن
سایر کارها هستند).
.TP
\fBls_exeq [user]\fR
مشابه با \fBls\fR، اما تنها کارهایی را فهرست می‌کند
که در حال اجرا هستند.
.TP
\fBdetail jobid\fR
چاپ جزئیات مربوط به یک
کار. مقدار \fBjobid\fR همان شناسه‌ای است که توسط
\fBls\fR\& نمایش داده شده است.
.TP
\fBrunnow jobid\fR
اجرای کار در همین لحظه، به‌جای منتظر ماندن برای زمان‌بندی
اجرای بعدی. زمان اجرای بعدی به‌گونه‌ای تنظیم می‌شود
که گویی کار طبق زمان‌بندی عادی اجرا شده است.
.TP
\fBrun jobid\fR
اجرای فوری کار. زمان اجرای بعدی آن تغییری نمی‌کند.
.TP
\fBkill sig jobid\fR
ارسال یک سیگنال به یک کار در حال اجرا.
.TP
\fBrenice niceval jobid\fR
تغییر اولویت یک کار در حال اجرا.
"فیلدهای مورد استفاده در دستورهای DETAIL و LS*"
.TP
\fBID\fR
شماره شناسایی یکتای کار.
.TP
\fBUSER\fR
کاربری که مالک این کار است.
.TP
\fBPID\fR
شناسه فرایند (PID) کار در حال اجرا.
.TP
\fBINDEX\fR
اندیس کار در صف ترتیبی (یعنی پس از اجرای تمام کارهای با اندیس پایین‌تر، اجرا خواهد شد).
.TP
\fBR&Q\fR
تعداد نمونه‌های وظیفه مورد نظر که یا در حال اجرا هستند یا در صف ترتیبی یا میانگین بار (lavg) قرار دارند.
.TP
\fBOPTIONS\fR
فهرست گزینه‌های اصلی که برای وظیفه تنظیم شده‌اند.
حرف L برای کارهایی که تنها تحت یک میانگین بار سیستم (Load average) معین اجرا می‌شوند (گزینه‌های lavg،‏ lavg1،‏ lavg5 و lavg15)، حرف LO (مخفف Load average Once) اگر در هر زمان حداکثر تنها یک نمونه از وظیفه بتواند در صف میانگین بار قرار گیرد (گزینه lavgonce)، حرف S برای کارهای ترتیبی (گزینه serial)، حرف SO برای کارهایی که تنها برای اجرای بعدی ترتیبی می‌شوند (Serial Once)، و حرف ES اگر چند نمونه از یک کار بتوانند به‌طور هم‌زمان اجرا شوند (گزینه exesev).
.TP
\fBLAVG\fR
۳ مقدار متناظر با میانگین بار سیستم در بازه‌های ۱، ۵ و ۱۵ دقیقه‌ای (به همین ترتیب) که کار در صورتی اجرا می‌شود
که بار کاری کمتر از آن‌ها باشد، در غیر این صورت کار در صف قرار می‌گیرد
تا میانگین بار سیستم به سطح مناسب برسد (گزینه lavg را ببینید).
.TP
\fBUNTIL\fR
فیلد مربوط به گزینه until.
.TP
\fBSTRICT\fR
فیلد مربوط به گزینه strict. حرف Y برای
بله و N برای خیر.
.TP
\fBSCHEDULE\fR
اجرای بعدی در این تاریخ و ساعت زمان‌بندی شده است. لطفاً توجه داشته باشید که fcrondyn تاریخ و زمان اجرای بعدی را در منطقه زمانی سیستمی که fcron روی آن در حال اجراست نمایش می‌دهد، نه منطقه زمانی‌ای که ممکن است با استفاده از گزینه timezone\& تعیین شده باشد.
.TP
\fBCMD\fR
دستوری که اجرا خواهد شد.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور \fBFcrondyn\fR در صورت خروج عادی مقدار 0 و در صورت
بروز خطا مقدار 1 را برمی‌گرداند.
.SH "سازگاری با استانداردها (CONFORMING TO)"
.PP
باید با استانداردهای POSIX سازگار باشد.
.SH "فایل‌ها (FILES)"
.TP
\fB\fI/usr/local/etc/fcron.conf\fB\fR
فایل پیکربندی برای \fBfcron\fR،‏ \fBfcrontab\fR و
\fBfcrondyn\fR: شامل مسیرها (مسیر spool، فایل pid) و برنامه‌های پیش‌فرض برای استفاده
(ویرایشگر، شل و غیره). برای جزئیات بیشتر به \fBfcron.conf\fR(5)
مراجعه کنید.
.TP
\fB\fI/usr/local/etc/fcron.allow\fB\fR
کاربران مجاز به استفاده از \fBfcrontab\fR و \fBfcrondyn\fR (در
هر سطر یک نام، نام ویژه "all" برای همه اعمال می‌شود)
.TP
\fB\fI/usr/local/etc/fcron.deny\fB\fR
کاربرانی که مجاز به استفاده از \fBfcrontab\fR و
\fBfcrondyn\fR نیستند (قالب مشابه فایل allow است)
.TP
\fB\fI/usr/local/etc/pam.d/fcron\fB (یا \fI/usr/local/etc/pam.conf\fB)\fR
فایل پیکربندی PAM برای
\fBfcron\fR\&. برای جزئیات بیشتر نگاهی به pam(8) بیندازید.
.SH "همچنین ببینید (SEE ALSO)"

\fBfcrontab\fR(1),

\fBfcrondyn\fR(1),

\fBfcrontab\fR(5),

\fBfcron.conf\fR(5),

\fBfcron\fR(8).

اگر در حال یادگیری نحوه استفاده از fcron از ابتدا هستید، پیشنهاد می‌کنم
نسخه HTML مستندات را مطالعه فرمایید (اگر در حال حاضر
مشغول خواندن آن نیستید! :) ): محتوا یکسان است، اما مرور آن به‌لطف
پیوندها بسیار آسان‌تر است.
.SH "نویسندگان (AUTHORS)"
.PP
Thibault Godouet <fcron@free.fr>