.\" 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 "FCRON" "8" "22 March 2025" "03/22/2025" ""

.SH "نام (NAME)"
fcron \- دیمن اجرای وظایف زمان‌بندی‌شده
.SH "خلاصه دستور (SYNOPSIS)"

\fBfcron\fR [ \fB\-c \fIپرونده\fB\fR ] [ \fB\-d\fR ] [ \fB\-b\fR ] [ \fB\-s \fIزمان\fB\fR ] [ \fB\-m \fIتعداد\fB\fR ] [ \fB\-q \fIتعداد\fB\fR ]


\fBfcron\fR [ \fB\-c \fIپرونده\fB\fR ] [ \fB\-d\fR ] [ \fB\-f\fR ] [ \fB\-o\fR ] [ \fB\-y\fR ] [ \fB\-p \fIپرونده\fB\fR ] [ \fB\-l \fIزمان\fB\fR ]


\fBfcron\fR [ \fB\-n \fIدایرکتوری\fB\fR ]


\fBfcron\fR [ \fB\-h\fR ]


\fBfcron\fR [ \fB\-V\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ \fBFcron\fR باید از \fI/etc/rc\fR یا
\fI/etc/rc.local\fR راه‌اندازی شود\&. مگر این‌که گزینهٔ \fB\-f\fR (یا
\fB\-\-foreground\fR) مشخص شده باشد، برنامه بلافاصله بازمی‌گردد، بنابراین
نیازی نیست آن را با '&\&' اجرا کنید.
.PP
برنامهٔ \fBFcron\fR پرونده‌های \fBfcrontab\fR کاربران (به \fBfcrontab\fR(5) مراجعه کنید) را که پیش‌تر توسط
\fBfcrontab\fR (به \fBfcrontab\fR(1) مراجعه کنید) نصب شده‌اند، بارگذاری می‌کند. سپس \fBfcron\fR زمان
و تاریخ اجرای بعدی هر کار را محاسبه کرده و مشخص می‌کند چه مدت باید به خواب برود،
و برای این مدت به خواب می‌رود. هنگامی که بیدار می‌شود، تمام کارهای بارگذاری‌شده را بررسی کرده
و در صورت نیاز آن‌ها را اجرا می‌کند. هنگامی که یک کار اجرا می‌شود، \fBfcron\fR منشعب شده (fork می‌کند)، مجوزهای کاربر
و گروه خود را به مجوزهای کاربری که کار برای او انجام می‌شود تغییر می‌دهد،
آن کار را اجرا کرده و خروجی‌ها را برای کاربر ایمیل می‌کند (این رفتار قابل تغییر است: به
\fBfcrontab\fR(5) مراجعه کنید).
.PP
پیام‌های اطلاع‌رسانی دربارهٔ آنچه \fBfcron\fR انجام می‌دهد، به
\fBsyslogd\fR(8) تحت تسهیلات (facility) \fBcron\fR با
اولویت \fBnotice\fR ارسال می‌شوند\&. پیام‌های هشدار و خطا نیز به ترتیب با
اولویت‌های \fBwarning\fR و
\fBerror\fR فرستاده می‌شوند\&.
.PP
.sp
.RS
.B "نکته:"
برنامهٔ \fBfcron\fR پس از راه‌اندازی، حداقل ۲۰ ثانیه پیش از
اجرای هر کاری به خواب می‌رود تا از مصرف بیش از حد منابع هنگام بوت سیستم جلوگیری شود.
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR
.TP
\fB\-\-foreground\fR
به پس‌زمینه منشعب نمی‌شود (fork نمی‌کند). در این حالت، \fBfcron\fR
پیام‌های اطلاع‌رسانی را افزون بر syslogd در خروجی خطای استاندارد نیز نمایش می‌دهد.
.TP
\fB\-b\fR
.TP
\fB\-\-background\fR
اجرا در پس‌زمینه را تحمیل می‌کند، حتی اگر \fBfcron\fR به‌طور پیش‌فرض
برای اجرا در پیش‌زمینه کامپایل شده باشد.
.TP
\fB\-s \fIزمان\fB\fR
.TP
\fB\-\-savetime \fIزمان\fB\fR
پرونده‌های \fBfcrontab\fR را هر
\fIزمان\fR ثانیه یک‌بار بر روی دیسک ذخیره می‌کند (پیش‌فرض ۱۸۰۰ ثانیه است).
.TP
\fB\-m \fIتعداد\fB\fR
.TP
\fB\-\-maxserial \fIتعداد\fB\fR
حداکثر \fIتعداد\fR کار متوالی (serial) را به‌طور
هم‌زمان اجرا می‌کند. به‌طور پیش‌فرض، این مقدار روی ۱ تنظیم شده است.
.sp
.BR "همچنین ببینید" :
گزینهٔ serial در \fBfcrontab\fR(5).
.TP
\fB\-q \fIتعداد\fB\fR
.TP
\fB\-\-queuelen \fIتعداد\fB\fR
اندازهٔ صف‌های مورد استفاده برای مدیریت کارهای متوالی
و صف lavg را هر کدام برابر با \fIتعداد\fR تنظیم می‌کند\&.
این بدان معناست که
(الف) حداکثر \fIتعداد\fR کار متوالی می‌تواند
در وضعیت انتظار باشد و
(ب) حداکثر \fIتعداد\fR کار می‌تواند منتظر بماند تا
میانگین بار سیستم (load average) به زیر یک مقدار مشخص کاهش یابد.
.TP
\fB\-c \fIپرونده\fB\fR
.TP
\fB\-\-configfile \fIپرونده\fB\fR
باعث می‌شود \fBfcron\fR به‌جای پروندهٔ پیکربندی پیش‌فرض
\fI/usr/local/etc/fcron.conf\fR، از پروندهٔ پیکربندی
\fIپرونده\fR استفاده کند\&. برای تعامل با فرایند در حال اجرای
\fBfcron\fR، برنامهٔ \fBfcrontab\fR نیز باید از همان پروندهٔ پیکربندی استفاده کند (که توسط
گزینهٔ \fB\-c\fR در \fBfcrontab\fR تعیین می‌شود). به این ترتیب، چند فرایند \fBfcron\fR
می‌توانند به‌طور هم‌زمان بر روی یک سیستم اجرا شوند (اما هر فرایند \fBfcron\fR *باید*
دایرکتوری اسپول و پروندهٔ pid متفاوتی نسبت به سایر فرایندها داشته باشد).
.TP
\fB\-o\fR
.TP
\fB\-\-once\fR
تمام کارهایی را که در زمان شروع \fBfcron\fR نیاز به اجرا دارند، اجرا کرده،
منتظر اتمام آن‌ها می‌ماند و سپس خارج می‌شود. مقدار \-\-sleeptime را برابر با ۰ قرار می‌دهد.
این گزینه می‌تواند به‌ویژه هنگامی که به همراه گزینه‌های \fB\-y\fR و
\fB\-f\fR در یک اسکریپت (برای نمونه هنگام اتصال dialup) اجرا می‌شود، بسیار مفید باشد.
.sp
.BR "همچنین ببینید" :
گزینه‌های volatile و stdout در fcrontab\&.
.TP
\fB\-y\fR
.TP
\fB\-\-nosyslog\fR
به‌هیچ‌وجه در syslog ثبت وقایع انجام نمی‌دهد. هنگام اجرا
در پیش‌زمینه می‌تواند مفید باشد.
.TP
\fB\-p \fIپرونده\fB\fR
.TP
\fB\-\-logfilepath \fIپرونده\fB\fR
در صورت تنظیم، وقایع را در پرونده‌ای که به عنوان آرگومان داده شده ثبت می‌کند. برنامهٔ \fBfcron\fR
به‌طور هم‌زمان وقایع را هم در آن پرونده و هم در syslog ثبت خواهد کرد، مگر این‌که
گزینهٔ \fB\-y\fR نیز تنظیم شده باشد.
.TP
\fB\-l \fIزمان\fB\fR
.TP
\fB\-\-firstsleep \fIزمان\fB\fR
تأخیر اولیه (به ثانیه) را پیش از اجرای هر کاری تنظیم می‌کند؛
مقدار پیش‌فرض ۲۰ ثانیه است.
.TP
\fB\-n \fIدایرکتوری\fB\fR
.TP
\fB\-\-newspooldir \fIدایرکتوری\fB\fR
مسیر \fIدایرکتوری\fR را به عنوان یک دایرکتوری اسپول جدید برای
\fBfcron\fR ایجاد می‌کند\&. حالت دسترسی و مالک آن را به‌درستی تنظیم کرده و سپس خارج می‌شود.
.TP
\fB\-h\fR
.TP
\fB\-\-help\fR
نمایش توضیح کوتاهی از گزینه‌ها.
.TP
\fB\-V\fR
.TP
\fB\-\-version\fR
نمایش پیام اطلاعاتی دربارهٔ \fBfcron\fR،
شامل نسخهٔ آن و مجوزی که تحت آن منتشر شده است.
.TP
\fB\-d\fR
.TP
\fB\-\-debug\fR
اجرا در حالت اشکال‌زدایی (نمایش جزئیات بیشتر در خروجی خطای استاندارد -- در صورتی که گزینهٔ
\fB\-f\fR تنظیم شده باشد -- و در پروندهٔ لاگ).
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
برنامهٔ \fBFcron\fR در صورت خروج عادی مقدار ۰، و در صورت
بروز خطا مقدار ۱ را بازمی‌گرداند.
.SH "سیگنال‌ها (SIGNALS)"
.TP
\fBSIGTERM\fR
ذخیرهٔ پیکربندی (زمان باقی‌مانده تا اجرای بعدی، زمان و تاریخ اجرای بعدی، و غیره)،
صبر برای اتمام تمام کارهای در حال اجرا و سپس خروج.
.TP
\fBSIGUSR1\fR
وادار کردن \fBfcron\fR به بارگذاری مجدد پیکربندی خود.
.TP
\fBSIGUSR2\fR
چاپ زمان‌بندی فعلی \fBfcron\fR در syslog. همچنین
چاپ اطلاعات اشکال‌زدایی در syslog را فعال/غیرفعال (toggle) می‌کند.
.TP
\fBSIGHUP\fR
اطلاع دادن به \fBfcron\fR برای بررسی وجود هرگونه به‌روزرسانی در
پیکربندی (این سیگنال توسط \fBfcrontab\fR(1) استفاده می‌شود).
.TP
\fBSIGCONT\fR
اطلاع به \fBfcron\fR مبنی بر بازگشت سیستم از حالت تعلیق (به حافظه یا دیسک). این کار باعث می‌شود \fBfcron\fR پروندهٔ \fI/usr/local/var/run/fcron.suspend\fR را خوانده و زمان‌بندی وظایف را متناسب با آن به‌روزرسانی کند. توجه داشته باشید که fcron در لینوکس برای تشخیص تعلیق/ازسرگیری نیازی به این سیگنال ندارد.
.SH "سازگاری با استانداردها (CONFORMING TO)"
.PP
باید با استانداردهای POSIX سازگار باشد.
.SH "فایل‌ها (FILES)"
.TP
\fB\fI/usr/local/etc/fcron.conf\fB\fR
پروندهٔ پیکربندی برای \fBfcron\fR، \fBfcrontab\fR و
\fBfcrondyn\fR: شامل مسیرها (دایرکتوری اسپول، پروندهٔ 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\&. برای جزئیات بیشتر نگاهی به \fBpam\fR(8) بیندازید.
.TP
\fB\fI/usr/local/var/run/fcron.suspend\fB\fR
محل پروندهٔ تعلیق \fBfcron\fR برای سیستم‌های غیرلینوکسی. این پرونده باید برای آگاه‌سازی \fBfcron\fR از مدت زمان تعلیق سیستم (در حافظه یا دیسک) استفاده شود تا زمان‌بندی وظایف متناسب با آن به‌روزرسانی گردد. این پرونده باید متعلق به root:root باشد و توسط دیگران قابل نوشتن نباشد. هنگامی که سیستم ازسرگرفته می‌شود، تعداد ثانیه‌هایی را که سیستم در تعلیق بوده (به عنوان یک رشته) در این پرونده بنویسید، و سپس سیگنال SIGCONT را بفرستید تا fcron آن پرونده را پردازش کرده (و سپس حذف نماید). این کار در لینوکس لازم نیست زیرا fcron از APIهای ویژهٔ لینوکس برای تشخیص ازسرگیری و اندازه‌گیری مدت زمان تعلیق استفاده می‌کند.
.SH "همچنین ببینید (SEE ALSO)"

\fBfcrontab\fR(1),

\fBfcrondyn\fR(1),

\fBfcrontab\fR(5),

\fBfcron.conf\fR(5),

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