From 5263714ee4d4710adea4c8b32422b48353c47b5a Mon Sep 17 00:00:00 2001 From: Daniel Lange Date: Tue, 15 Mar 2016 13:15:20 +0100 Subject: Imported Debian patch 2-1 --- debian/changelog | 5 ++ debian/compat | 1 + debian/control | 18 +++++++ debian/copyright | 133 +++++++++++++++++++++++++++++++++++++++++++++++++++ debian/cronic.1 | 99 ++++++++++++++++++++++++++++++++++++++ debian/install | 1 + debian/manpages | 1 + debian/rules | 3 ++ debian/source/format | 1 + 9 files changed, 262 insertions(+) create mode 100644 debian/changelog create mode 100644 debian/compat create mode 100644 debian/control create mode 100644 debian/copyright create mode 100644 debian/cronic.1 create mode 100644 debian/install create mode 100644 debian/manpages create mode 100755 debian/rules create mode 100644 debian/source/format diff --git a/debian/changelog b/debian/changelog new file mode 100644 index 0000000..3bb4f79 --- /dev/null +++ b/debian/changelog @@ -0,0 +1,5 @@ +cronic (2-1) unstable; urgency=medium + + * Initial release. (Closes: #711017) + + -- Daniel Lange Tue, 15 Mar 2016 13:15:20 +0100 diff --git a/debian/compat b/debian/compat new file mode 100644 index 0000000..f11c82a --- /dev/null +++ b/debian/compat @@ -0,0 +1 @@ +9 \ No newline at end of file diff --git a/debian/control b/debian/control new file mode 100644 index 0000000..8c84c9a --- /dev/null +++ b/debian/control @@ -0,0 +1,18 @@ +Source: cronic +Section: admin +Priority: optional +Maintainer: Daniel Lange +Build-Depends: debhelper (>= 9) +Vcs-Browser: https://anonscm.debian.org/cgit/collab-maint/cronic.git +Vcs-Git: https://anonscm.debian.org/git/collab-maint/cronic.git +Homepage: http://habilis.net/cronic/ +Standards-Version: 3.9.7 + +Package: cronic +Architecture: all +Depends: bash (>= 3.2), ${misc:Depends} +Suggests: cron +Description: Bash script for wrapping cron jobs to prevent excess email sending + Cronic is a small shim shell script for wrapping cron jobs so that cron only + sends email when an error has occurred. Cronic defines an error as any + non-trace error output or a non-zero result code. diff --git a/debian/copyright b/debian/copyright new file mode 100644 index 0000000..6bee17c --- /dev/null +++ b/debian/copyright @@ -0,0 +1,133 @@ +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: cronic +Upstream-Contact: Chuck Houpt +Source: http://habilis.net/cronic/ + +Files: * +License: CC0 +Copyright: 2007 Chuck Houpt + +Files: debian/* +License: CC0 +Copyright: 2016 Daniel Lange + +License: CC0 + CC0 1.0 Universal + . + CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE + LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN + ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS + INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES + REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS + PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM + THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED + HEREUNDER. + . + Statement of Purpose + . + The laws of most jurisdictions throughout the world automatically confer + exclusive Copyright and Related Rights (defined below) upon the creator + and subsequent owner(s) (each and all, an "owner") of an original work of + authorship and/or a database (each, a "Work"). + . + Certain owners wish to permanently relinquish those rights to a Work for + the purpose of contributing to a commons of creative, cultural and + scientific works ("Commons") that the public can reliably and without fear + of later claims of infringement build upon, modify, incorporate in other + works, reuse and redistribute as freely as possible in any form whatsoever + and for any purposes, including without limitation commercial purposes. + These owners may contribute to the Commons to promote the ideal of a free + culture and the further production of creative, cultural and scientific + works, or to gain reputation or greater distribution for their Work in + part through the use and efforts of others. + . + For these and/or other purposes and motivations, and without any + expectation of additional consideration or compensation, the person + associating CC0 with a Work (the "Affirmer"), to the extent that he or she + is an owner of Copyright and Related Rights in the Work, voluntarily + elects to apply CC0 to the Work and publicly distribute the Work under its + terms, with knowledge of his or her Copyright and Related Rights in the + Work and the meaning and intended legal effect of CC0 on those rights. + . + 1. Copyright and Related Rights. A Work made available under CC0 may be + protected by copyright and related or neighboring rights ("Copyright and + Related Rights"). Copyright and Related Rights include, but are not + limited to, the following: + . + i. the right to reproduce, adapt, distribute, perform, display, + communicate, and translate a Work; + ii. moral rights retained by the original author(s) and/or performer(s); + iii. publicity and privacy rights pertaining to a person's image or + likeness depicted in a Work; + iv. rights protecting against unfair competition in regards to a Work, + subject to the limitations in paragraph 4(a), below; + v. rights protecting the extraction, dissemination, use and reuse of data + in a Work; + vi. database rights (such as those arising under Directive 96/9/EC of the + European Parliament and of the Council of 11 March 1996 on the legal + protection of databases, and under any national implementation + thereof, including any amended or successor version of such + directive); and + vii. other similar, equivalent or corresponding rights throughout the + world based on applicable law or treaty, and any national + implementations thereof. + . + 2. Waiver. To the greatest extent permitted by, but not in contravention + of, applicable law, Affirmer hereby overtly, fully, permanently, + irrevocably and unconditionally waives, abandons, and surrenders all of + Affirmer's Copyright and Related Rights and associated claims and causes + of action, whether now known or unknown (including existing as well as + future claims and causes of action), in the Work (i) in all territories + worldwide, (ii) for the maximum duration provided by applicable law or + treaty (including future time extensions), (iii) in any current or future + medium and for any number of copies, and (iv) for any purpose whatsoever, + including without limitation commercial, advertising or promotional + purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each + member of the public at large and to the detriment of Affirmer's heirs and + successors, fully intending that such Waiver shall not be subject to + revocation, rescission, cancellation, termination, or any other legal or + equitable action to disrupt the quiet enjoyment of the Work by the public + as contemplated by Affirmer's express Statement of Purpose. + . + 3. Public License Fallback. Should any part of the Waiver for any reason + be judged legally invalid or ineffective under applicable law, then the + Waiver shall be preserved to the maximum extent permitted taking into + account Affirmer's express Statement of Purpose. In addition, to the + extent the Waiver is so judged Affirmer hereby grants to each affected + person a royalty-free, non transferable, non sublicensable, non exclusive, + irrevocable and unconditional license to exercise Affirmer's Copyright and + Related Rights in the Work (i) in all territories worldwide, (ii) for the + maximum duration provided by applicable law or treaty (including future + time extensions), (iii) in any current or future medium and for any number + of copies, and (iv) for any purpose whatsoever, including without + limitation commercial, advertising or promotional purposes (the + "License"). The License shall be deemed effective as of the date CC0 was + applied by Affirmer to the Work. Should any part of the License for any + reason be judged legally invalid or ineffective under applicable law, such + partial invalidity or ineffectiveness shall not invalidate the remainder + of the License, and in such case Affirmer hereby affirms that he or she + will not (i) exercise any of his or her remaining Copyright and Related + Rights in the Work or (ii) assert any associated claims and causes of + action with respect to the Work, in either case contrary to Affirmer's + express Statement of Purpose. + . + 4. Limitations and Disclaimers. + . + a. No trademark or patent rights held by Affirmer are waived, abandoned, + surrendered, licensed or otherwise affected by this document. + b. Affirmer offers the Work as-is and makes no representations or + warranties of any kind concerning the Work, express, implied, + statutory or otherwise, including without limitation warranties of + title, merchantability, fitness for a particular purpose, non + infringement, or the absence of latent or other defects, accuracy, or + the present or absence of errors, whether or not discoverable, all to + the greatest extent permissible under applicable law. + c. Affirmer disclaims responsibility for clearing rights of other persons + that may apply to the Work or any use thereof, including without + limitation any person's Copyright and Related Rights in the Work. + Further, Affirmer disclaims responsibility for obtaining any necessary + consents, permissions or other rights required for any use of the + Work. + d. Affirmer understands and acknowledges that Creative Commons is not a + party to this document and has no duty or obligation with respect to + this CC0 or use of the Work. diff --git a/debian/cronic.1 b/debian/cronic.1 new file mode 100644 index 0000000..b09e988 --- /dev/null +++ b/debian/cronic.1 @@ -0,0 +1,99 @@ +.\" man file for cronic +.TH cronic "1" "March 2016 - v2" "admin" "admin" +.SH NAME +cronic \- a shell script to help control the most annoying feature of cron: +unwanted emailed output +.SH SYNOPSIS +.B cronic +[\fICOMMAND\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Cronic is a small shim shell script for wrapping cron jobs so that cron only +sends email when an error has occurred. +.PP +Cronic defines an error as any non-trace error output or a non-zero result +code. +.PP +Cronic filters Bash execution traces (or anything matching \fBPS4\fR) from +the error output, so jobs can be run with execution tracing to aid forensic +debugging. +.PP +Cronic has no options, it simply executes its arguments. +.PP +\fI0 1 * * * \fR\fBcronic\fR \fibackup\fR +.PP +With cronic, you can turn on Bash's strict error handling and debug options +(exit on error, unset variable detection and execution tracing) to make sure +problems are caught early. +.PP +.SH EXAMPLES +.B Example cron job: +.PP +.nf +.RS +#!/bin/bash +set \-o errexit \-o nounset \-o xtrace +cp \-rp data1 /backup +cp \-rp data2 /backup +cp \-rp data3 /backup +.RE +.fi +.PP +When an error is detected, Cronic outputs a report listing the result code, +error output, and combined trace and error output. The combined output can +help put error messages in context. +.PP +.B Example email from cron with cronic info: +.PP +.nf +.RS +From: user@example.net (Cron Daemon) +To: user@example.net +Subject: Cron cronic backup + +Cronic detected failure or error output for the command: +backup + +RESULT CODE: 1 + +ERROR OUTPUT: +cp: data2: Permission denied + +STANDARD OUTPUT: + +TRACE-ERROR OUTPUT: ++ cp \-rp data1 /backup ++ cp \-rp data2 /backup +cp: data2: Permission denied +.RE +.fi +.PP +.SH VERSION HISTORY +\fBv2\fR \- Corrected command evaluation, so shell meta-chars are preserved +correctly (Thanks to Frank Wallingford for the fix). +.PP +\fBv1\fR \- Initial release. +.SH OTHER TOOLS +Joey Hess has written a simpler perl version of cronic, named chronic. +It is available in Debian as part of \fImoreutils\fR. +.SH AUTHOR +Cronic was written by Chuck Houpt. +.br +This man page was formatted from the cronic home page by Daniel Lange. +.SH "REPORTING BUGS" +Please report bugs upstream to Chuck Houpt and use the Debian +bugtracker for Debian-specific issues. +.br +The cronic home page is . +.SH COPYRIGHT +Copyright \(co 2007 Chuck Houpt. Debian packaging \(co 2016 Daniel Lange. +.br +License CCO: Public Domain dedication v1.0 . +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +.BR crontab(5), +.BR bash(1) +.\" end of man file for cronicl. Daniel Lange 160315, man v1.0 for cronic v2 diff --git a/debian/install b/debian/install new file mode 100644 index 0000000..ac5032a --- /dev/null +++ b/debian/install @@ -0,0 +1 @@ +cronic usr/bin diff --git a/debian/manpages b/debian/manpages new file mode 100644 index 0000000..1d27515 --- /dev/null +++ b/debian/manpages @@ -0,0 +1 @@ +debian/cronic.1 diff --git a/debian/rules b/debian/rules new file mode 100755 index 0000000..cbe925d --- /dev/null +++ b/debian/rules @@ -0,0 +1,3 @@ +#!/usr/bin/make -f +%: + dh $@ diff --git a/debian/source/format b/debian/source/format new file mode 100644 index 0000000..163aaf8 --- /dev/null +++ b/debian/source/format @@ -0,0 +1 @@ +3.0 (quilt) -- cgit v1.2.3