نام (NAME)

uu-timeout - اجرای دستور و متوقف کردن آن در صورت ادامه کار پس از مدت‌زمان مشخص

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

timeout [گزینه] DURATION COMMAND...

توضیحات (DESCRIPTION)

اجرای COMMAND و متوقف ساختن آن در صورت ادامه کار پس از گذشت DURATION.

گزینه‌ها (OPTIONS)

-f, --foreground: هنگامی که timeout مستقیماً از اعلان پوسته اجرا نمی‌شود، به COMMAND اجازه می‌دهد از TTY بخواند و سیگنال‌های TTY را دریافت کند؛ در این حالت، فرایندهای فرزند COMMAND مشمول محدودیت زمانی نمی‌شوند
-k, --kill-after: در صورتی که پس از ارسال سیگنال اولیه، COMMAND همچنان به مدت تعیین‌شده در حال اجرا باشد، یک سیگنال KILL نیز ارسال می‌کند
-p, --preserve-status: خروج با همان وضعیت خروج COMMAND، حتی هنگامی که مهلت زمانی دستور به پایان برسد
-s, --signal <SIGNAL>: تعیین سیگنال ارسالی هنگام پایان مهلت زمانی؛ SIGNAL می‌تواند نامی مانند 'HUP' یا یک عدد باشد؛ برای فهرست سیگنال‌ها 'kill -l' را ببینید
-v, --verbose: گزارش هرگونه سیگنال ارسالی هنگام پایان مهلت زمانی در stderr
-h, --help: نمایش راهنما
-V, --version: نمایش نسخه
<duration>: یک عدد اعشاری با پسوند اختیاری: 's' برای ثانیه (پیش‌فرض)، 'm' برای دقیقه، 'h' برای ساعت یا 'd' برای روز؛ مدت‌زمان 0 محدودیت زمانی مربوطه را غیرفعال می‌کند
<command>: دستوری که باید با آرگومان‌های اختیاری اجرا شود

توضیحات تکمیلی (EXTRA)

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

وضعیت خروج:

124  اگر مهلت زمانی COMMAND تمام شود و --preserve-status مشخص نشده باشد
125  اگر خود دستور timeout با شکست مواجه شود
126  اگر COMMAND پیدا شود اما قابل فراخوانی نباشد
127  اگر COMMAND یافت نشود
137  اگر به COMMAND (یا خود timeout) سیگنال KILL (9) ارسال شود (128+9)
-    در غیر این صورت، همان وضعیت خروج COMMAND

نسخه (VERSION)

v(uutils coreutils) 0.11.0