نام (NAME)

fcrondyn - گفتگو و تعامل پویا با دیمِن در حال اجرای fcron

خلاصه دستور (SYNOPSIS)

fcrondyn [ -c file ] [ -i ]

fcrondyn [ -c file ] -x command

fcrondyn [ -h ]

توضیحات (DESCRIPTION)

دستور Fcrondyn ابزاری کاربری برای تعامل با دیمِن در حال اجرای fcron است. برای نمونه، این ابزار می‌تواند کارهای بارگذاری‌شده کاربر توسط fcron را فهرست کند، یکی از آن‌ها را اجرا کند، اولویت (renice) یک کار در حال اجرا را تغییر دهد، به یک کار در حال اجرا سیگنال بفرستد و غیره.

گزینه‌ها (OPTIONS)

-i: اجرای fcrondyn در حالت تعاملی (interactive). همچنین در صورتی که هیچ گزینه‌ای داده نشود، fcrondyn در حالت تعاملی اجرا می‌شود.
-x command: اجرای command و بازگشت فوری. برای نحو و فهرستی از دستورها بخش زیر را ببینید.
-c file: باعث می‌شود fcrondyn به‌جای فایل پیکربندی پیش‌فرض /usr/local/etc/fcron.conf از فایل پیکربندی file استفاده کند. برای برقراری تعامل با یک فرایند در حال اجرای fcron، باید fcrondyn از همان فایل پیکربندی فرایند استفاده کند. به این ترتیب، چند فرایند fcron می‌توانند به‌طور هم‌زمان روی یک سیستم اجرا شوند.
-d: اجرا در حالت اشکال‌زدایی (debug). در این حالت، پیام‌های اطلاعاتی متعددی در خروجی نمایش داده می‌شوند تا درستی همه‌چیز بررسی شود.
-h: نمایش توضیحی کوتاه دربارهٔ گزینه‌ها.
-V: نمایش پیامی اطلاعاتی دربارهٔ fcrondyn، شامل نسخهٔ آن و مجوزی که تحت آن منتشر شده است.

شرح دستورها (COMMAND DESCRIPTION)

نحو دستورهای Fcrondyn به شرح زیر است:

command arg1 arg2 [...]

هر آرگومان در یک دستور fcrondyn از یکی از انواع زیر است: "انواع آرگومان‌های دستورهای FCRONDYN"

user: یک نام کاربری معتبر.
jobid: شناسه کار که توسط یکی از دستورهای ls* مربوط به fcrondyn ارائه شده است (یعنی یک عدد صحیح).
sig: شماره سیگنال، یا نام آن (بزرگی و کوچکی حروف اهمیتی ندارد). برای نمونه، "term" یا "15".
niceval: مقدار اولویت کار. یک niceval عددی صحیح از -20 (بالاترین اولویت) تا 19 (پایین‌ترین) است (تنها کاربر root مجاز است برای این گزینه مقدار منفی تعیین کند).

و در نهایت، دستورهای زیر شناسایی می‌شوند (آرگومان‌های اختیاری درون [] قرار دارند): "دستورهای معتبر FCRONDYN"

help
h: چاپ یک پیام راهنما دربارهٔ دستورهای fcrondyn.
quit
q: در حالت تعاملی، خروج از fcrondyn.
ls [user]: فهرست کردن تمام کارهای user. هنگامی که ls توسط root اجرا شود، کارهای تمام کاربران فهرست می‌شوند مگر اینکه نام کاربری به‌عنوان آرگومان داده شود. برای توضیحاتی دربارهٔ فیلدهای مورد استفاده در دستورهای ls* به بخش زیر مراجعه کنید.
ls_lavgq [user]: مشابه با ls، اما تنها کارهایی را فهرست می‌کند که در صف میانگین بار کاری (load-average queue) هستند (یعنی برای اجرا در انتظار میانگین بار کاری پایین‌تر هستند).
ls_serialq [user]: مشابه با ls، اما تنها کارهایی را فهرست می‌کند که در صف ترتیبی (serial queue) هستند (یعنی در انتظار به پایان رسیدن سایر کارها هستند).
ls_exeq [user]: مشابه با ls، اما تنها کارهایی را فهرست می‌کند که در حال اجرا هستند.
detail jobid: چاپ جزئیات مربوط به یک کار. مقدار jobid همان شناسه‌ای است که توسط ls نمایش داده شده است.
runnow jobid: اجرای کار در همین لحظه، به‌جای منتظر ماندن برای زمان‌بندی اجرای بعدی. زمان اجرای بعدی به‌گونه‌ای تنظیم می‌شود که گویی کار طبق زمان‌بندی عادی اجرا شده است.
run jobid: اجرای فوری کار. زمان اجرای بعدی آن تغییری نمی‌کند.
kill sig jobid: ارسال یک سیگنال به یک کار در حال اجرا.
renice niceval jobid: تغییر اولویت یک کار در حال اجرا. "فیلدهای مورد استفاده در دستورهای DETAIL و LS*"
ID: شماره شناسایی یکتای کار.
USER: کاربری که مالک این کار است.
PID: شناسه فرایند (PID) کار در حال اجرا.
INDEX: اندیس کار در صف ترتیبی (یعنی پس از اجرای تمام کارهای با اندیس پایین‌تر، اجرا خواهد شد).
R&Q: تعداد نمونه‌های وظیفه مورد نظر که یا در حال اجرا هستند یا در صف ترتیبی یا میانگین بار (lavg) قرار دارند.
OPTIONS: فهرست گزینه‌های اصلی که برای وظیفه تنظیم شده‌اند. حرف L برای کارهایی که تنها تحت یک میانگین بار سیستم (Load average) معین اجرا می‌شوند (گزینه‌های lavg،‏ lavg1،‏ lavg5 و lavg15)، حرف LO (مخفف Load average Once) اگر در هر زمان حداکثر تنها یک نمونه از وظیفه بتواند در صف میانگین بار قرار گیرد (گزینه lavgonce)، حرف S برای کارهای ترتیبی (گزینه serial)، حرف SO برای کارهایی که تنها برای اجرای بعدی ترتیبی می‌شوند (Serial Once)، و حرف ES اگر چند نمونه از یک کار بتوانند به‌طور هم‌زمان اجرا شوند (گزینه exesev).
LAVG: ۳ مقدار متناظر با میانگین بار سیستم در بازه‌های ۱، ۵ و ۱۵ دقیقه‌ای (به همین ترتیب) که کار در صورتی اجرا می‌شود که بار کاری کمتر از آن‌ها باشد، در غیر این صورت کار در صف قرار می‌گیرد تا میانگین بار سیستم به سطح مناسب برسد (گزینه lavg را ببینید).
UNTIL: فیلد مربوط به گزینه until.
STRICT: فیلد مربوط به گزینه strict. حرف Y برای بله و N برای خیر.
SCHEDULE: اجرای بعدی در این تاریخ و ساعت زمان‌بندی شده است. لطفاً توجه داشته باشید که fcrondyn تاریخ و زمان اجرای بعدی را در منطقه زمانی سیستمی که fcron روی آن در حال اجراست نمایش می‌دهد، نه منطقه زمانی‌ای که ممکن است با استفاده از گزینه timezone تعیین شده باشد.
CMD: دستوری که اجرا خواهد شد.

وضعیت خروج (EXIT STATUS)

دستور Fcrondyn در صورت خروج عادی مقدار 0 و در صورت بروز خطا مقدار 1 را برمی‌گرداند.

سازگاری با استانداردها (CONFORMING TO)

باید با استانداردهای POSIX سازگار باشد.

فایل‌ها (FILES)

/usr/local/etc/fcron.conf: فایل پیکربندی برای fcron،‏ fcrontab و fcrondyn: شامل مسیرها (مسیر spool، فایل pid) و برنامه‌های پیش‌فرض برای استفاده (ویرایشگر، شل و غیره). برای جزئیات بیشتر به fcron.conf(5) مراجعه کنید.
/usr/local/etc/fcron.allow: کاربران مجاز به استفاده از fcrontab و fcrondyn (در هر سطر یک نام، نام ویژه "all" برای همه اعمال می‌شود)
/usr/local/etc/fcron.deny: کاربرانی که مجاز به استفاده از fcrontab و fcrondyn نیستند (قالب مشابه فایل allow است)
/usr/local/etc/pam.d/fcron (یا /usr/local/etc/pam.conf): فایل پیکربندی PAM برای fcron. برای جزئیات بیشتر نگاهی به pam(8) بیندازید.

همچنین ببینید (SEE ALSO)

اگر در حال یادگیری نحوه استفاده از fcron از ابتدا هستید، پیشنهاد می‌کنم نسخه HTML مستندات را مطالعه فرمایید (اگر در حال حاضر مشغول خواندن آن نیستید! :) ): محتوا یکسان است، اما مرور آن به‌لطف پیوندها بسیار آسان‌تر است.

نویسندگان (AUTHORS)

Thibault Godouet <fcron@free.fr>