نام (NAME)

chronic - اجرای ساکت یک دستور مگر در صورت بروز خطا

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

chronic [-ev] COMMAND...

توضیحات (DESCRIPTION)

دستور chronic یک فرمان را اجرا کرده و خروجی استاندارد و خطای استاندارد آن را تنها در صورتی نمایش می‌دهد که دستور با شکست مواجه شود (خروج با کد غیرصفر یا کرش کند). اگر دستور با موفقیت اجرا شود، تمام خروجی‌های اضافی پنهان خواهند شد.

یک کاربرد رایج chronic برای اجرای وظایف زمان‌بندی‌شده cron است. به جای تلاش برای ساکت نگه داشتن دستور و مواجهه با ایمیل‌های حاوی خروجی‌های تصادفی هنگام موفقیت و خروجی ناکافی هنگام شکست، می‌توانید دستور را همیشه با جزئیات کامل اجرا کرده و از chronic برای پنهان‌سازی خروجی در صورت موفقیت استفاده کنید.

0    1 * * * chronic backup # instead of backup >/dev/null 2>&1
*/20 * * * * chronic -ve my_script # verbose for debugging

گزینه‌ها (OPTIONS)

-v: خروجی پرجزئیات (تفکیک میان STDOUT و STDERR، و همچنین گزارش RETVAL).
-e: فعال‌سازی با خطای استاندارد. هنگامی که طول خروجی خطای استاندارد (stderr) غیرصفر باشد خروجی را نمایش می‌دهد. بدون گزینه -e، ابزار chronic برای نمایش خروجی نیازمند مقدار بازگشتی غیرصفر است.
در این حالت، اگر مقدار بازگشتی دستور برابر 0 باشد اما در stderr متنی چاپ کرده باشد، مقدار بازگشتی chronic برابر با 2 خواهد بود.

نویسنده (AUTHOR)

حق نشر ۲۰۱۰ توسط Joey Hess <id@joeyh.name>

ایده اولیه و نام «chronic» توسط Chuck Houpt. کد مربوط به خروجی پرجزئیات و فعال‌سازی بر اساس خطای استاندارد توسط Tomas 'Harvie' Mudrunka در سال ۲۰۱۶.

تحت مجوز گنو جی‌پی‌ال نسخه ۲ یا بالاتر (GNU GPL v2+).