.\"/* Copyright 1988,1990,1993 by Paul Vixie
.\" * All rights reserved
.\" */
.\"
.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
.\" Copyright (c) 1997,2000 by Internet Software Consortium, Inc.
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\" Modified 2010/09/12 by Colin Dean, Durham University IT Service,
.\" to add clustering support.
.\"
.\" $Id: crontab.1,v 1.7 2004/01/23 19:03:32 vixie Exp $
.\"
.TH CRONTAB 1 "2019-10-29" "cronie" "User Commands"
.SH "نام (NAME)"
crontab \- نگهداری و ویرایش فایلهای جدول زمانبندی cron برای کاربران منفرد
.SH "خلاصه دستور (SYNOPSIS)"
.B crontab
.RB [ -u
.IR user ]
.RI < "file"
.RB | \ - >
.br
.B crontab
.RB [ -T ]
.RI < "file"
.RB | \ - >
.br
.B crontab
.RB [ -u
.IR user ]
.RB < -l " | " -r " | " -e >\ [ -i ]
.RB [ -s ]
.br
.B crontab
.BR -n \ [
.IR "hostname " ]
.br
.B crontab
.BR -c
.br
.B crontab
.BR -V
.SH "توضیحات (DESCRIPTION)"
برنامه
.I crontab
برای نصب یک
.IR فایل
جدول crontab، حذف یا فهرست‌کردن جدول‌های موجود که برای سرویس‌دهی به دیمن
.BR cron (8)
استفاده می‌شوند، به کار می‌رود. هر کاربر می‌تواند جدول crontab مختص به خود را داشته باشد؛ و هرچند این فایل‌ها در پوشه
.I /var/spool/
قرار دارند، برای ویرایش مستقیم در نظر گرفته نشده‌اند. برای SELinux در حالت MLS، می‌توانید برای هر محدوده crontabهای بیشتری تعریف کنید. برای اطلاعات بیشتر،
.BR selinux (8)
را ببینید.
.PP
در این نسخه از
.IR Cron ،
امکان استفاده از یک
.I /var/spool/cron
اشتراکی که از طریق شبکه متصل شده است (network-mounted) در سراسر یک کلاستر از میزبان‌ها وجود دارد و می‌توان مشخص کرد که در هر زمان تنها یکی از میزبان‌ها وظایف crontab را در دایرکتوری مورد نظر اجرا کند. همچنین می‌توانید از دستور
.B crontab
در هر یک از این میزبان‌ها برای ویرایش همان مجموعه فایل‌های crontab اشتراکی و همچنین برای تعیین و پرس‌وجو درباره اینکه کدام میزبان باید وظایف crontab را اجرا کند، استفاده کنید.
.PP
زمان‌بندی وظایف cron با استفاده از
.B crontab
می‌تواند برای کاربران مختلف مجاز یا غیرمجاز شود. برای این منظور از فایل‌های
.I cron.allow
و
.I cron.deny
استفاده کنید. اگر فایل
.I cron.allow
وجود داشته باشد، نام کاربر باید در آن فهرست شده باشد تا اجازه استفاده از
.B crontab
را داشته باشد. اگر فایل
.I cron.allow
وجود نداشته باشد اما فایل
.I cron.deny
موجود باشد، کاربر نباید در فایل
.I cron.deny
فهرست شده باشد تا بتواند از
.B crontab
استفاده کند. در صورتی که هیچ‌یک از این دو فایل وجود نداشته باشند، تنها مدیر سیستم (superuser) مجاز به استفاده از
.B crontab
خواهد بود.
.PP
راهکار دیگر برای محدود کردن زمان‌بندی وظایف cron فراتر از
.BR crontab ،
استفاده از احراز هویت PAM در فایل
.I /etc/security/access.conf
برای تنظیم کاربرانی است که مجاز یا غیرمجاز به استفاده از
.B crontab
یا تغییر وظایف سیستمی cron در دایرکتوری
.I /etc/cron.d/
هستند.
.PP
دایرکتوری موقت را می‌توان در یک متغیر محیطی تنظیم کرد. اگر توسط کاربر تنظیم نشده باشد، دایرکتوری
.I /tmp
استفاده خواهد شد.
.PP
هنگام فهرست‌کردن crontab در یک ترمینال، خروجی رنگی خواهد بود مگر اینکه متغیر محیطی
.I NO_COLOR
تنظیم شده باشد.
.PP
هنگام ویرایش یا حذف crontab، یک نسخه پشتیبان از آخرین crontab در
.I $XDG_CACHE_HOME/crontab/crontab.bak
ذخیره خواهد شد، یا در صورت استفاده از گزینه
.BR \-u ،
در
.I $XDG_CACHE_HOME/crontab/crontab.<user>.bak
ذخیره می‌شود. اگر متغیر محیطی
.I XDG_CACHE_HOME
تنظیم نشده باشد، به‌جای آن از
.I $HOME/.cache
استفاده خواهد شد.
.PP
.SH "گزینهها (OPTIONS)"
.TP
.B "\-u"
نام کاربری را مشخص می‌کند که crontab او باید تغییر یابد. اگر این گزینه استفاده نشود،
.B crontab
جدول زمان‌بندی «شما»، یعنی crontab شخصی که دستور را اجرا می‌کند بررسی می‌کند. اگر هیچ crontab برای یک کاربر خاص وجود نداشته باشد، اولین باری که دستور
.B crontab \-u
تحت نام کاربری او استفاده شود، برای وی ایجاد می‌گردد.
.TP
.B "\-T"
سینتکس فایل crontab را بدون نصب کردن آن آزمایش می‌کند. به‌محض یافتن اولین مشکل، اعتبارسنجی متوقف می‌شود؛ بنابراین تمام خطاهای موجود در یک بار اجرا بازگردانده نخواهند شد.
.TP
.B "\-l"
جدول crontab فعلی را در خروجی استاندارد نمایش می‌دهد.
.TP
.B "\-r"
جدول crontab فعلی را حذف می‌کند.
.TP
.B "\-e"
جدول crontab فعلی را با استفاده از ویرایشگر مشخص‌شده توسط متغیرهای محیطی
.I VISUAL
یا
.I EDITOR
ویرایش می‌کند. پس از خروج از ویرایشگر، crontab تغییریافته به‌طور خودکار نصب خواهد شد.
.TP
.B "\-i"
این گزینه رفتار گزینه
.B "\-r"
را تغییر می‌دهد تا قبل از حذف واقعی crontab، برای دریافت پاسخ 'y/Y' از کاربر تاییدیه بخواهد.
.TP
.B "\-s"
رشته بافت امنیتی (security context) فعلی SELinux را قبل از انجام ویرایش یا جایگزینی، به‌عنوان یک تنظیم MLS_LEVEL به فایل crontab ضمیمه می‌کند \- مستندات MLS_LEVEL را در
.BR crontab (5)
ببینید.
.TP
.B "\-n"
این گزینه تنها در صورتی کاربرد دارد که
.BR cron (8)
با گزینه
.B \-c
جهت فعال‌سازی پشتیبانی از کلاسترینگ راه‌اندازی شده باشد. این گزینه برای تعیین میزبانی در کلاستر استفاده می‌شود که باید وظایف مشخص‌شده در فایل‌های crontab واقع در دایرکتوری
.I /var/spool/cron
را اجرا کند. اگر یک نام میزبان (hostname) ارائه شود، میزبانی که نام آن توسط
.BR gethostname (2)
با نام میزبان ارائه‌شده مطابقت داشته باشد، پس از آن برای اجرای وظایف cron انتخاب‌شده برگزیده خواهد شد. اگر هیچ میزبانی در کلاستر با نام میزبان ارائه‌شده مطابقت نداشته باشد، یا صراحتاً یک نام میزبان خالی مشخص کنید، وظایف انتخاب‌شده اصلاً اجرا نخواهند شد. اگر نام میزبان حذف شود، نام میزبان محلی که توسط
.BR gethostname (2)
بازگردانده می‌شود به کار خواهد رفت. استفاده از این گزینه تأثیری بر فایل
.I /etc/crontab
و فایل‌های موجود در دایرکتوری
.I /etc/cron.d
ندارد؛ این فایل‌ها همیشه اجرا می‌شوند و وابسته به میزبان در نظر گرفته می‌شوند. برای اطلاعات بیشتر درباره پشتیبانی از خوشه‌بندی،
.BR cron (8)
را ببینید.
.TP
.B "\-c"
این گزینه تنها در صورتی کاربرد دارد که
.BR cron (8)
با گزینه
.B \-c
برای فعال‌سازی پشتیبانی از خوشه‌بندی اجرا شده باشد. از این گزینه برای پرس‌وجو درباره اینکه کدام میزبان در کلاستر در حال حاضر برای اجرای وظایف مشخص‌شده در فایل‌های crontab در دایرکتوری
.I /var/spool/cron
(که با استفاده از گزینه
.B \-n
تنظیم شده) تعیین شده است، استفاده می‌شود.
.TP
.B "\-V"
نسخه برنامه را چاپ کرده و خارج می‌شود.
.SH "هشدارها (CAVEATS)"
فایل‌های
.I cron.allow
و
.I cron.deny
نمی‌توانند برای محدود کردن اجرای وظایف cron استفاده شوند؛ آن‌ها فقط استفاده از دستور
.B crontab
را محدود می‌کنند. به‌ویژه، محدود کردن دسترسی به
.B crontab
هیچ تأثیری بر
.I crontab
موجود یک کاربر ندارد و وظایف آن تا زمانی که crontab حذف نشود به اجرا ادامه خواهند داد.
.PP
فایل‌های
.I cron.allow
و
.I cron.deny
باید توسط کاربری که
.B crontab
را فراخوانی می‌کند قابل خواندن باشند. اگر چنین نباشد، فرض می‌شود که وجود ندارند.
.SH "همچنین ببینید (SEE ALSO)"
.BR crontab (5),
.BR cron (8)
.SH "فایلها (FILES)"
.nf
/etc/cron.allow
/etc/cron.deny
.fi
.SH "استانداردها (STANDARDS)"
دستور
.I crontab
مطابق با استاندارد IEEE Std1003.2-1992 (``POSIX'') است، با یک استثنا: برای جایگزینی crontab فعلی با داده‌های ورودی استاندارد، در صورتی که ورودی استاندارد یک TTY باشد، باید
.B \-
در خط فرمان مشخص شود. این ساختار دستور جدید با نسخه‌های قبلی Vixie Cron و همچنین سینتکس کلاسیک SVR3 تفاوت دارد.
.SH "عیب‌یابی (DIAGNOSTICS)"
در صورتی که یک crontab را با دستوری نادرست یا معیوب اجرا کنید، یک پیام راهنمای نحوه استفاده نمایش داده می‌شود.
.SH "نویسندگان (AUTHORS)"
.MT vixie@isc.org
Paul Vixie
.ME
.br
.MT colin@colin-dean.org
Colin Dean
.ME