نام (NAME)

timeout - اجرای یک دستور با محدودیت زمانی

خلاصه دستور (SYNOPSIS)

timeout [گزینه] مدت_زمان دستور [آرگومان]...
timeout [گزینه]

توضیحات (DESCRIPTION)

اجرای دستور، و متوقف کردن آن چنانچه پس از گذشت مدت_زمان مشخص‌شده همچنان در حال اجرا باشد.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز الزامی هستند.

-f, --foreground

هنگامی که timeout مستقیماً از یک اعلان پوسته اجرا نمی‌شود، به دستور امکان خواندن از TTY و دریافت سیگنال‌های TTY را می‌دهد؛ در این حالت، فرایندهای فرزند دستور مشمول محدودیت زمانی نخواهند شد.

-k, --kill-after=DURATION

همچنین چنانچه دستور پس از ارسال سیگنال اولیه به این اندازه همچنان در حال اجرا باشد، سیگنال KILL ارسال شود.

-p, --preserve-status

حتی در صورت پایان مهلت زمانی دستور، با همان وضعیت خروج دستور خارج شود.

-s, --signal=SIGNAL

تعیین سیگنالی که هنگام پایان مهلت زمانی ارسال می‌شود؛ SIGNAL می‌تواند نامی مانند HUP یا یک عدد باشد؛ برای مشاهده فهرست سیگنال‌ها دستور 'kill -l' را ببینید.

-v, --verbose

گزارش هرگونه سیگنال ارسال‌شده هنگام پایان مهلت زمانی به خروجی خطای استاندارد (stderr)

--help

نمایش این راهنما و خروج

--version

نمایش اطلاعات نسخه و خروج

DURATION یک عدد ممیز شناور همراه با یک پسوند اختیاری است: s برای ثانیه (پیش‌فرض)، m برای دقیقه، h برای ساعت یا d برای روز. مدت‌زمان 0 محدودیت زمانی متناظر را غیرفعال می‌کند.

در صورت پایان مهلت زمانی، چنانچه SIGNAL دیگری تعیین نشده باشد، سیگنال TERM به دستور ارسال می‌شود. سیگنال TERM هر فرایندی را که آن سیگنال را مسدود یا مهار نکند خاتمه می‌دهد. همچنین ممکن است استفاده از سیگنال KILL ضروری باشد، چرا که این سیگنال قابل مهار شدن نیست.

اشکالات (BUGS)

برخی از بسترها در حال حاضر از مهلت‌های زمانی فراتر از سال ۲۰۳۸ پشتیبانی نمی‌کنند.

نویسنده (AUTHOR)

نوشته شده توسط Padraig Brady.

گزارش اشکالات (REPORTING BUGS)

راهنمای آنلاین GNU coreutils: https://www.gnu.org/software/coreutils
گزارش هرگونه اشکال در ترجمه به: https://translationproject.org/team

حق نشر (COPYRIGHT)

حق نشر © 2025 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما می‌توانید آن را تغییر داده و دوباره توزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

همچنین ببینید (SEE ALSO)

kill(1)

مستندات کامل در https://www.gnu.org/software/coreutils/timeout
یا در دسترس به‌صورت محلی از طریق: info '(coreutils) timeout invocation'