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

.SH "نام (NAME)"
fcrontab \- مدیریت پرونده‌های fcrontab برای هر کاربر مطابق با قالب تعریف‌شده در fcrontab(5)
.SH "خلاصه دستور (SYNOPSIS)"

\fBfcrontab\fR [ \fB-c
\fIfile\fB\fR ] [ \fB-n\fR ] \fB\fIfile\fB\fR [ \fB\fIuser\fB\fR | \fB-u
\fIuser\fB\fR ]


\fBfcrontab\fR [ \fB-c
\fIfile\fB\fR ] [ \fB-n\fR ] { \fB-l\fR | \fB-r\fR | \fB-e\fR | \fB-z\fR } [ \fB\fIuser\fB\fR | \fB-u
\fIuser\fB\fR ]


\fBfcrontab\fR [ \fB-h\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBfcrontab\fR
برای نصب، ویرایش، فهرست کردن و حذف جدول‌های مورد استفاده توسط دیمن
\fBfcron\fR(8)
در نظر گرفته شده است. از آنجا که
\fBfcron\fR
در لایه داخلی از قالبی غیرقابل‌خواندن توسط انسان استفاده می‌کند (این امر لازم است زیرا
\fBfcron\fR
اطلاعات بیشتری نسبت به آنچه کاربر ارائه داده ذخیره می‌کند؛ به عنوان مثال زمان و تاریخ اجرای بعدی)، کاربر نمی‌تواند
\fBfcrontab\fR
خود (فایلی که مستقیماً توسط \fBfcron\fR استفاده می‌شود) را مستقیماً ویرایش کند.
.PP
هنگامی که یک کاربر یک
\fBfcrontab\fR
را نصب می‌کند، فایل منبع در دایرکتوری اسپول
(\fI/usr/local/var/spool/fcron\fR)
ذخیره می‌شود تا امکان ویرایش آن فراهم باشد، و یک فایل قالب‌بندی‌شده برای دیمن
\fBfcron\fR
تولید می‌شود. این فایل قالب‌بندی‌شده (غیرقابل‌خواندن توسط انسان) به همراه تمام تغییرات اخیر برای دیمن ارسال می‌شود. دیمن فوراً از تغییرات مطلع نمی‌شود بلکه پس از گذشت مدتی آگاه می‌گردد تا از مسدود کردن دیمن توسط کاربران بدخواه از طریق نصب مکرر و پی‌درپی
\fBfcrontab\fR
(یعنی حمله محروم‌سازی از سرویس یا DoS) جلوگیری شود. به طور پیش‌فرض، فایل یک‌بار در هر دقیقه (حدود ده ثانیه پیش از دقیقه کامل) برای دیمن ارسال می‌شود؛ پارامتر زمان ساخت
\fB--with-max-fcrontab-reload-delay-seconds\fR
می‌تواند برای تعیین حداکثر زمان متفاوت جهت ارسال این داده‌ها به کار رود. در ادامه ما به فایل منبع
\fBfcrontab\fR
عبارت
"\fBfcrontab\fR"
را اطلاق می‌کنیم.
.PP
فایل‌های fcrontab که کاربر ویرایش می‌کند باید از قالب تعریف‌شده در
\fBfcrontab\fR(5)
پیروی کنند.
.PP
کاربران در صورتی می‌توانند یک
\fBfcrontab\fR
را نصب کنند که نام آنها در
\fI/usr/local/etc/fcron.allow\fR
آمده باشد و در
\fI/usr/local/etc/fcron.deny\fR
ذکر نشده باشد (بخش "فایل‌ها" در زیر را ببینید). کلیدواژه 'all' کوتاه‌نوشتی برای همه کاربران است. اگر هیچ‌یک از فایل‌های
\fIfcron.allow\fR
یا
\fIfcron.deny\fR
وجود نداشته باشند، همه کاربران مجاز هستند. وجود هیچ‌کدام از این فایل‌ها الزامی نیست، اما در صورت وجود، فایل deny اولویت دارد.
.PP
شکل اول این دستور برای نصب یک فایل
\fBfcrontab\fR
جدید استفاده می‌شود؛ از هر فایل مشخص‌شده یا از ورودی استاندارد (اگر نام مجازی "-" داده شود)، و جایگزین فایل قبلی (در صورت وجود) می‌گردد. هر کاربر تنها می‌تواند یک
\fBfcrontab\fR
داشته باشد.
.PP
برای نمونه، کاربر root می‌تواند یک فایل fcrontab سراسری برای کل سیستم ایجاد کند (مثلاً
\fI/etc/fcrontab\fR)
و پس از هر بار تغییر فایل، دستور
"\fBfcrontab\fR \fI/etc/fcrontab\fR"
را برای نصب نسخه جدید اجرا نماید. همچنین کاربر root می‌تواند با اجرای دستور ساده
"\fBfcrontab\fR"
یک fcrontab جدید ایجاد کرده و سپس با
"\fBfcrontab\fR \fB-e\fR"
آن را نگهداری و ویرایش کند. همین نکات برای یک کاربر عادی بدون امتیاز ویژه نیز صدق می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-u \fIuser\fB\fR
مشخص کردن کاربری که \fBfcrontab\fR او مدیریت خواهد شد، یا "systab" برای fcrontab سیستمی. این گزینه فقط باید توسط root استفاده شود. در صورت عدم تعیین، فایل \fBfcrontab\fR کاربری که \fBfcrontab\fR را فراخوانی کرده رسیدگی می‌شود. این گزینه ممکن است کاربردی باشد زیرا دستور \fBsu\fR(8) ممکن است باعث سردرگمی \fBfcrontab\fR شود.
.sp
.RS
.B "نکته:"
عبارت
\&'\fIuser\fR\&'
در خلاصه دستور معادل
'\fB-u\fR \fIuser\fR\&'
است.
.RE
.TP
\fB-l\fR
فهرست کردن \fBfcrontab\fR فعلی کاربر در خروجی استاندارد.
.TP
\fB-e\fR
ویرایش \fBfcrontab\fR فعلی کاربر با استفاده از ویرایشگر مشخص‌شده توسط متغیر محیطی \fBVISUAL\fR، یا در صورت تنظیم نبودن آن، \fBEDITOR\fR. اگر هیچ‌یک تنظیم نشده باشند، از \fB/usr/bin/vi\fR استفاده خواهد شد.
.TP
\fB-r\fR
حذف \fBfcrontab\fR کاربر.
.TP
\fB-z\fR
نصب مجدد \fBfcrontab\fR کاربر از روی کد منبع آن. تمامی اطلاعاتی که \fBfcron\fR ممکن است در فایل دودویی \fBfcrontab\fR نگه داشته باشد (مانند زمان و تاریخ آخرین اجرا) فراموش (یعنی از دست رفته) خواهند شد.
.TP
\fB-n\fR
نادیده گرفتن نسخه قبلی. اگر این گزینه مشخص نشود، \fBfcron\fR تلاش خواهد کرد تا حد امکان اطلاعات بین نسخه قدیم و جدید \fBfcrontab\fR را حفظ کند (زمان و تاریخ اجرای بعدی، وضعیت قرارگیری وظیفه در صف ترتیبی، و غیره)، مشروط بر اینکه خط تغییری نکرده باشد (فیلدهای یکسان، دستور شل یکسان).
.TP
\fB-c \fIfile\fB\fR
وادار کردن \fBfcrontab\fR به استفاده از فایل پیکربندی \fIfile\fR به جای فایل پیکربندی پیش‌فرض \fI/usr/local/etc/fcron.conf\fR. برای تعامل با یک فرآیند در حال اجرای \fBfcron\fR، دستور \fBfcrontab\fR باید از همان فایل پیکربندی فرآیند استفاده کند. به این ترتیب، چندین فرآیند \fBfcron\fR می‌توانند به طور هم‌زمان روی یک سیستم اجرا شوند.
.TP
\fB-d\fR
اجرا در حالت دیباگ (اشکال‌زدایی). در این حالت، پیام‌های اطلاعاتی متعددی برای بررسی وقوع هرگونه خطا خروجی داده می‌شوند.
.TP
\fB-h\fR
نمایش توضیح مختصری از گزینه‌ها.
.TP
\fB-V\fR
نمایش یک پیام اطلاعاتی درباره \fBfcrontab\fR، شامل نسخه و مجوزی که تحت آن منتشر شده است.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
دستور
\fBfcrontab\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: شامل مسیرها (دایرکتوری اسپول، فایل 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).
.PP
اگر کار با fcron را از صفر یاد می‌گیرید، پیشنهاد می‌کنم نسخه HTML مستندات را بخوانید (اگر همین الان در حال خواندن آن نیستید! :) ): محتوا یکسان است، اما به لطف پیوندها مرور آن ساده‌تر است.
.SH "نویسنده (AUTHOR)"
.PP
Thibault Godouet <fcron@free.fr>