.TH AT 1 2009-11-14
.SH "نام (NAME)"
at, batch, atq, atrm \- زمان‌بندی و اجرای دستورات در یک زمان مشخص در آینده
.SH "خلاصه دستور (SYNOPSIS)"
.B at
.RB [ \-V ]
.RB [ \-q
.IR queue ]
.RB [ \-f
.IR file ]
.RB [ \-u
.IR username ]
.RB [ \-mMlv ]
.IR timespec " ...\&"
.br
.B at
.RB [ \-V ]
.RB [ \-q
.IR queue ]
.RB [ \-f
.IR file ]
.RB [ \-u
.IR username ]
.RB [ \-mMkv ]
.RB [ \-t
.IR time ]
.br
.B "at \-c"
.I job
[...\&]
.br
.B at
.RB [ \-V ]
.RB \-l
.RB [ -o
.IR timeformat ]
.I [job
.IR ... ]
.br
.B atq
.RB [ \-V ]
.RB [ \-q
.IR queue ]
.RB [ -o
.IR timeformat ]
.I [job
.IR ... ]
.br
.B at
.RB [ \-rd ]
.I job
[...\&]
.br
.B atrm
.RB [ \-V ]
.I job
[...\&]
.br
.B batch
.br
.B "at \-b"
.SH "توضیحات (DESCRIPTION)"
دستورات
.B at
و
.B batch
دستورات را از ورودی استاندارد یا یک فایل مشخص می‌خوانند تا در زمانی دیگر با استفاده از
.B /bin/sh
اجرا شوند.
.TP 8
.B at
دستورات را در یک زمان مشخص اجرا می‌کند.
.TP 8
.B atq
کارهای معلق کاربر را فهرست می‌کند، مگر اینکه کاربر مدیر سیستم (کاربر ارشد) باشد؛ که در آن صورت، کارهای همه افراد فهرست می‌شود. قالب خطوط خروجی (یک خط برای هر کار) به این صورت است: شماره کار، تاریخ، ساعت، صف و نام کاربری.
.TP 8
.B atrm
کارهایی را که با شماره کارشان مشخص شده‌اند حذف می‌کند.
.TP 8
.B batch
دستورات را زمانی اجرا می‌کند که سطوح بار سیستم اجازه دهد؛ به عبارت دیگر، زمانی که میانگین بار سیستم (load average) به زیر 0.8 یا مقدار مشخص‌شده در هنگام فراخوانی
.B atd
کاهش یابد.
.PP
دستور
.B at
امکان تعیین زمان به شیوه‌های نسبتاً پیچیده را فراهم می‌کند و استاندارد POSIX.2 را گسترش می‌دهد. این دستور زمان‌هایی به فرم
.B HH:MM
را برای اجرای یک کار در زمان مشخصی از روز می‌پذیرد.
(اگر آن زمان سپری شده باشد، روز بعد در نظر گرفته می‌شود.)
شما همچنین می‌توانید
.BR midnight ،
.B noon
یا
.B teatime
(ساعت ۴ عصر)
را مشخص کنید و می‌توانید زمان روز را با پسوند
.B AM
یا
.B PM
برای اجرا در صبح یا عصر همراه کنید.
همچنین می‌توانید تعیین کنید که کار در چه روزی اجرا شود؛ با دادن تاریخی به فرم
.B month-name
.B day
به همراه یک
.B year
اختیاری، یا دادن تاریخی به فرم
.IR MMDD [ CC ] YY ،
.IR MM / DD /[ CC ] YY ،
.IR DD . MM .[ CC ] YY
یا
.RI [ CC ] YY - MM - DD .
مشخص کردن تاریخ
.I باید
پس از مشخص کردن زمان روز بیاید.
شما همچنین می‌توانید زمان‌هایی مانند
.B now
.B +
.I count
.I time-units
را مشخص کنید، که در آن واحدهای زمانی می‌توانند
.BR minutes ،
.BR hours ،
.B days
یا
.B weeks
باشند و می‌توانید با افزودن پسوند
.B today
به زمان، به
.B at
بگویید که کار را امروز اجرا کند و با افزودن پسوند
.B tomorrow
بگویید کار را فردا اجرا کند.
.PP
برای مثال، برای اجرای یک کار در ساعت ۴ بعدازظهر سه روز دیگر، دستور
.B at 4pm + 3 days
را اجرا می‌کنید؛ برای اجرای یک کار در ساعت ۱۰:۰۰ صبح در ۳۱ ژوئیه، دستور
.B at 10am Jul 31
و برای اجرای یک کار در ساعت ۱ بامداد فردا، دستور
.B at 1am tomorrow
را وارد می‌کنید.
.PP
اگر مشخص کنید که کاری دقیقاً در زمان و تاریخی در گذشته اجرا شود، کار در سریع‌ترین زمان ممکن اجرا خواهد شد. برای مثال، اگر ساعت ۸ شب باشد و شما دستور
.B at 6pm today
را اجرا کنید، کار به احتمال زیاد در ساعت ۸:۰۵ شب اجرا خواهد شد.
.PP
تعریف مشخصات زمان را می‌توانید در
.I /usr/share/doc/at/timespec
بیابید.
.PP
برای هر دو دستور
.BR at " و " batch ،
دستورات از ورودی استاندارد یا فایل مشخص‌شده با گزینه
.B \-f
خوانده و اجرا می‌شوند.
دایرکتوری کاری، متغیرهای محیطی (به جز متغیرهای
.BR BASH_VERSINFO ،
.BR DISPLAY ،
.BR EUID ،
.BR GROUPS ،
.BR SHELLOPTS ،
.BR TERM ،
.B UID
و
.BR _ )
و umask از زمان فراخوانی حفظ می‌شوند.
.PP
از آنجا که
.B at
در حال حاضر به عنوان یک برنامه setuid پیاده‌سازی شده است، سایر متغیرهای محیطی (مانند
.B LD_LIBRARY_PATH
یا
.BR LD_PRELOAD )
نیز صادر نمی‌شوند. این موضوع ممکن است در آینده تغییر کند. به عنوان یک راهکار موقت، این متغیرها را به صراحت در کار خود مقداردهی کنید.
.PP
یک دستور
.B at
یا
.B batch
که از یک شل
.BR su (1)
فراخوانی شود، شناسه کاربری (userid) فعلی را حفظ خواهد کرد.
خروجی استاندارد و خطای استاندارد دستورات در صورت وجود، برای کاربر ایمیل خواهد شد.
ایمیل با استفاده از دستور
.B /usr/bin/sendmail
ارسال خواهد شد.
اگر
.B at
از یک شل
.BR su (1)
اجرا شود، مالک شل ورود (login shell) ایمیل را دریافت خواهد کرد.
.PP
مدیر سیستم (کاربر ارشد) در هر صورت می‌تواند از این دستورات استفاده کند.
برای سایر کاربران، دسترسی استفاده از at توسط فایل‌های
.I /etc/at.allow
و
.I /etc/at.deny
تعیین می‌شود. برای جزئیات به
.BR at.allow (5)
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-V
شماره نسخه را در خطای استاندارد چاپ کرده و با موفقیت خارج می‌شود.
.TP 8
.BI \-q " queue"
از صف مشخص‌شده استفاده می‌کند.
تعیین صف شامل یک حرف تک‌نویسه‌ای است؛ شناسه‌های مجاز صف از
.B a
تا
.B z
و از
.B A
تا
.B Z
هستند.
صف
.B a
صف پیش‌فرض برای
.B at
و صف
.B b
برای
.B batch
است.
صف‌هایی با حروف بالاتر با اولویت کمتر (nice بیشتر) اجرا می‌شوند. صف ویژه "=" برای کارهایی که در حال حاضر در حال اجرا هستند رزرو شده است.
.P
اگر کاری به صفی که با یک حرف بزرگ مشخص شده ارسال شود، با آن کار طوری رفتار می‌شود که گویی در زمان اجرای کار به batch ارسال شده است. پس از فرارسیدن زمان، قوانین پردازش دسته‌ای با توجه به میانگین بار سیستم (load average) اعمال می‌شوند.
اگر به
.B atq
صف خاصی داده شود، تنها کارهای معلق در آن صف را نشان خواهد داد.
.TP 8
.B \-m
هنگامی که کار به پایان رسید، حتی اگر خروجی نداشته باشد، به کاربر ایمیل ارسال می‌کند.
.TP 8
.B \-M
هرگز به کاربر ایمیل ارسال نمی‌کند.
.TP 8
.BI \-u " username"
به جای کاربر فعلی، به
.I username
ایمیل ارسال می‌کند.
.TP 8
.BI \-f " file"
کار را به جای ورودی استاندارد از
.I file
می‌خواند.
.TP 8
.BI \-t " time"
کار را در زمان
.I time
که در قالب [[CC]YY]MMDDhhmm[.ss] داده شده است اجرا می‌کند.
.TP 8
.B \-l
یک نام مستعار برای
.B atq
است.
.TP
.B \-r
یک نام مستعار برای
.B atrm
است.
.TP
.B \-d
یک نام مستعار برای
.B atrm
است.
.TP
.B \-b
یک نام مستعار برای
.B batch
است.
.TP
.B \-v
پیش از خواندن کار، زمانی را که کار اجرا خواهد شد نشان می‌دهد.
.P
زمان‌های نمایش‌داده‌شده در قالب "Thu Feb 20 14:50:00 1997" خواهند بود.
.TP
.B \-c
کارهای فهرست‌شده در خط فرمان را در خروجی استاندارد چاپ می‌کند (مانند دستور cat).
.TP 8
.BI \-o " fmt"
قالب زمانی مشابه strftime که برای فهرست کارها استفاده می‌شود.
.SH "فایل‌ها (FILES)"
.I /var/spool/atd
.br
.I /var/spool/atd
.br
.I /proc/loadavg
.br
.I /var/run/utmp
.br
.I /etc/at.allow
.br
.I /etc/at.deny
.SH "همچنین ببینید (SEE ALSO)"
.BR at.allow (5),
.BR at.deny (5),
.BR atd (8),
.BR cron (1),
.BR nice (1),
.BR sh (1),
.BR umask (2).
.SH "اشکالات (BUGS)"
عملکرد صحیح
.B batch
در لینوکس به وجود یک دایرکتوری از نوع
.IR proc -
که روی
.I /proc
سوار (mount) شده باشد بستگی دارد.
.PP
اگر فایل
.I /var/run/utmp
در دسترس نباشد یا خراب شده باشد، یا اگر کاربر در زمان فراخوانی
.B at
به سیستم وارد نشده باشد، ایمیل به شناسه کاربری موجود در متغیر محیطی
.B LOGNAME
ارسال می‌شود. اگر این متغیر تعریف نشده یا خالی باشد، شناسه کاربری فعلی در نظر گرفته می‌شود.
.PP
دستورات
.B at
و
.B batch
به شکلی که در حال حاضر پیاده‌سازی شده‌اند، برای شرایطی که کاربران بر سر منابع با یکدیگر رقابت می‌کنند مناسب نیستند. اگر این موضوع در سیستم شما صدق می‌کند، ممکن است بخواهید یک سیستم دسته‌ای (batch) دیگر مانند
.B nqs
را در نظر بگیرید.
.SH "نویسندگان (AUTHORS)"
برنامه at عمدتاً توسط Thomas Koenig نوشته شده است.