.TH TIMEOUT "1" "June 2025" "GNU coreutils 9.7" "دستورات کاربر"
.SH "نام (NAME)"
timeout \- اجرای یک دستور با محدودیت زمانی
.SH "خلاصه دستور (SYNOPSIS)"
.B timeout
[\fI\,گزینه\/\fR] \fI\,مدت_زمان دستور \/\fR[\fI\,آرگومان\/\fR]...
.br
.B timeout
[\fI\,گزینه\/\fR]
.SH "توضیحات (DESCRIPTION)"
اجرای
.IR دستور ،
و متوقف کردن آن چنانچه پس از گذشت
.I مدت_زمان
مشخص‌شده همچنان در حال اجرا باشد.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز الزامی هستند.
.HP
\fB\-f\fR, \fB\-\-foreground\fR
.IP
هنگامی که
.B timeout
مستقیماً از یک اعلان پوسته اجرا نمی‌شود، به
.I دستور
امکان خواندن از TTY و دریافت سیگنال‌های TTY را می‌دهد؛ در این حالت، فرایندهای فرزند
.I دستور
مشمول محدودیت زمانی نخواهند شد.
.HP
\fB\-k\fR, \fB\-\-kill\-after\fR=\fI\,DURATION\/\fR
.IP
همچنین چنانچه
.I دستور
پس از ارسال سیگنال اولیه به این اندازه همچنان در حال اجرا باشد، سیگنال
.B KILL
ارسال شود.
.HP
\fB\-p\fR, \fB\-\-preserve\-status\fR
.IP
حتی در صورت پایان مهلت زمانی دستور، با همان وضعیت خروج
.I دستور
خارج شود.
.HP
\fB\-s\fR, \fB\-\-signal\fR=\fI\,SIGNAL\/\fR
.IP
تعیین سیگنالی که هنگام پایان مهلت زمانی ارسال می‌شود؛
.I SIGNAL
می‌تواند نامی مانند
.B HUP
یا یک عدد باشد؛ برای مشاهده فهرست سیگنال‌ها دستور \(aq\fBkill \-l\fR\(aq را ببینید.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
گزارش هرگونه سیگنال ارسال‌شده هنگام پایان مهلت زمانی به خروجی خطای استاندارد (stderr)
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
.I DURATION
یک عدد ممیز شناور همراه با یک پسوند اختیاری است:
.B s
برای ثانیه (پیش‌فرض)،
.B m
برای دقیقه،
.B h
برای ساعت یا
.B d
برای روز.
مدت‌زمان 0 محدودیت زمانی متناظر را غیرفعال می‌کند.
.PP
در صورت پایان مهلت زمانی، چنانچه
.I SIGNAL
دیگری تعیین نشده باشد، سیگنال
.B TERM
به
.I دستور
ارسال می‌شود. سیگنال
.B TERM
هر فرایندی را که آن سیگنال را مسدود یا مهار نکند خاتمه می‌دهد. همچنین ممکن است استفاده از سیگنال
.B KILL
ضروری باشد، چرا که این سیگنال قابل مهار شدن نیست.
.SS "وضعیت خروج (Exit status)"
.TP
.B 124
اگر مهلت زمانی
.I دستور
به پایان برسد و گزینه
.B \-\-preserve\-status
مشخص نشده باشد
.TP
.B 125
اگر خود دستور
.B timeout
با شکست مواجه شود
.TP
.B 126
اگر
.I دستور
پیدا شود اما قابل فراخوانی نباشد
.TP
.B 127
اگر
.I دستور
یافت نشود
.TP
.B 137
اگر به
.I دستور
(یا خود
.BR timeout )
سیگنال
.B KILL
(9) ارسال شود (128+9)
.TP
\-
در غیر این صورت، همان وضعیت خروج خود
.I دستور
.SH "اشکالات (BUGS)"
برخی از بسترها در حال حاضر از مهلت‌های زمانی فراتر از سال ۲۰۳۸ پشتیبانی نمی‌کنند.
.SH "نویسنده (AUTHOR)"
نوشته شده توسط Padraig Brady.
.SH "گزارش اشکالات (REPORTING BUGS)"
راهنمای آنلاین GNU coreutils: <https://www.gnu.org/software/coreutils>
.br
گزارش هرگونه اشکال در ترجمه به: <https://translationproject.org/team>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2025 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما می‌توانید آن را تغییر داده و دوباره توزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
\fBkill\fP(1)
.PP
.br
مستندات کامل در <https://www.gnu.org/software/coreutils/timeout>
.br
یا در دسترس به‌صورت محلی از طریق: info \(aq(coreutils) timeout invocation\(aq