.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "CHRONIC 1"
.TH CHRONIC 1 2024-12-11 moreutils " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
chronic \- اجرای ساکت یک دستور مگر در صورت بروز خطا
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
chronic [\-ev] COMMAND...
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور chronic یک فرمان را اجرا کرده و خروجی استاندارد و خطای استاندارد آن را تنها در صورتی نمایش می‌دهد که دستور با شکست مواجه شود (خروج با کد غیرصفر یا کرش کند). اگر دستور با موفقیت اجرا شود، تمام خروجی‌های اضافی پنهان خواهند شد.
.PP
یک کاربرد رایج chronic برای اجرای وظایف زمان‌بندی‌شده cron است. به جای تلاش برای ساکت نگه داشتن دستور و مواجهه با ایمیل‌های حاوی خروجی‌های تصادفی هنگام موفقیت و خروجی ناکافی هنگام شکست، می‌توانید دستور را همیشه با جزئیات کامل اجرا کرده و از chronic برای پنهان‌سازی خروجی در صورت موفقیت استفاده کنید.
.PP
.Vb 2
\&        0    1 * * * chronic backup # instead of backup >/dev/null 2>&1
\&        */20 * * * * chronic \-ve my_script # verbose for debugging
.Ve
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \-v 4
.IX Item "-v"
خروجی پرجزئیات (تفکیک میان STDOUT و STDERR، و همچنین گزارش RETVAL).
.IP \-e 4
.IX Item "-e"
فعال‌سازی با خطای استاندارد. هنگامی که طول خروجی خطای استاندارد (stderr) غیرصفر باشد خروجی را نمایش می‌دهد. بدون گزینه \-e، ابزار chronic برای نمایش خروجی نیازمند مقدار بازگشتی غیرصفر است.
.Sp
در این حالت، اگر مقدار بازگشتی دستور برابر \f(CW0\fR باشد اما در stderr متنی چاپ کرده باشد، مقدار بازگشتی chronic برابر با \f(CW2\fR خواهد بود.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
حق نشر ۲۰۱۰ توسط Joey Hess <id@joeyh.name>
.PP
ایده اولیه و نام «chronic» توسط Chuck Houpt.
کد مربوط به خروجی پرجزئیات و فعال‌سازی بر اساس خطای استاندارد توسط Tomas 'Harvie' Mudrunka در سال ۲۰۱۶.
.PP
تحت مجوز گنو جی‌پی‌ال نسخه ۲ یا بالاتر (GNU GPL v2+).