certwatch(1)

1CERTWATCH(1)                Cryptography Utilities                CERTWATCH(1)
2
3
4

NAME

6       certwatch - generate SSL certificate expiry warnings
7

SYNOPSIS

9       certwatch [OPTION...] filename
10

DESCRIPTION

12       The certwatch program is used to issue warning mail when an SSL
13       certificate is about to expire.
14
15       The program has two modes of operation: normal mode and quiet mode. In
16       normal mode, the certificate given by the filename argument is
17       examined, and a warning email is issued to standard output if the
18       certificate is outside its validity period, or approaching expiry. If
19       the certificate cannot be found, or any errors occur whilst parsing the
20       certificate, the certificate is ignored and no output is produced. In
21       quiet mode, no output is given, but the exit status can still be used.
22
23       The certificate can be specified by its nickname or by a path to the
24       containing file.
25

OPTIONS

27       --quiet, -q
28           Enable quiet mode; no output is produced whether the certificate is
29           expired or not
30
31       --period days, -p days
32           Specify the number of days within which an expiry warning will be
33           produced; default is 30. Expiry warnings are always produced if, on
34           the day of invocation, the certificate is not yet valid, has
35           already expired, or is due to expire either that day or the
36           following day.
37
38       --address address, -a address
39           Specify the address used in the To field of the warning e-mail
40           issued if quiet mode is not enabled. The default is root.
41
42       --directory cert-directory, -d cert-directory
43           Specify the database directory containing the certificate and key
44           database files. The default is yet to be determined.
45

DIAGNOSTICS

47       The exit code indicates the state of the certificate:
48
49       0
50           The certificate is outside its validity period, or approaching
51           expiry
52
53       1
54           The certificate is inside its validity period, or could not be
55           parsed
56

NOTES

58       The certwatch program is run daily by crond from the file
59       /etc/cron.daily/certwatch to generate warning mail concerning the
60       imminent expiry of SSL certificates configured for use in the Apache
61       HTTP server. These warnings can be disabled by adding the line:
62       NOCERTWATCH=yes to the file /etc/sysconfig/httpd. Additional options to
63       pass to certwatch can be specified in that file in the CERTWATCH_OPTS
64       environment variable.
65

FILES

67       /etc/cron.daily/certwatch, /etc/sysconfig/httpd
68