Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CHRONIC(1)			    moreutils			      CHRONIC(1)

NAME
     chronic - runs a command quietly unless it fails

SYNOPSIS
     chronic [-ev] COMMAND...

DESCRIPTION
     chronic runs a command, and arranges for its standard out and standard er-
     ror to only be displayed if the command fails (exits nonzero or crashes).
     If the command succeeds, any extraneous output will be hidden.

     A common use for chronic is for running a cron job. Rather than trying to
     keep the command quiet, and having to deal with mails containing accidental
     output when it succeeds, and not verbose enough output when it fails, you
     can just run it verbosely always, and use chronic to hide the successful
     output.

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

OPTIONS
     -v  Verbose output (distinguishes between STDOUT and STDERR, also reports
	 RETVAL)

     -e  Stderr triggering. Triggers output when stderr output length is
	 non-zero.  Without -e chronic needs non-zero return value to trigger
	 output.

	 In this mode, chronic's return value will be 2 if the command's return
	 value is 0 but the command printed to stderr.

AUTHOR
     Copyright 2010 by Joey Hess <id@joeyh.name>

     Original concept and "chronic" name by Chuck Houpt.  Code for verbose and
     stderr trigger by Tomas 'Harvie' Mudrunka 2016.

     Licensed under the GNU GPL version 2 or higher.

0.70				   2026-08-04			      CHRONIC(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=chronic&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help