1CERTWATCH(1)                       certwatch                      CERTWATCH(1)
2
3
4

NAME

6       certwatch - generate SSL/TLS certificate expiry warnings
7

SYNOPSIS

9       certwatch [OPTION...] filename
10

DESCRIPTION

12       The certwatch program is used to issue warning mail when an SSL/TLS
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

OPTIONS

24       --quiet, -q
25           Enable quiet mode; no output is produced whether the certificate is
26           expired or not
27
28       --period days, -p days
29           Specify the number of days within which an expiry warning will be
30           produced; default is 30. Expiry warnings are always produced if, on
31           the day of invocation, the certificate is not yet valid, has
32           already expired, or is due to expire either that day or the
33           following day.
34
35       --address address, -a address
36           Specify the address used in the To field of the warning e-mail
37           issued if quiet mode is not enabled. The default is root.
38
39       --help, -h
40           Display usage information.
41

DIAGNOSTICS

43       The exit code indicates the state of the certificate:
44
45       0
46           The certificate is outside its validity period, or approaching
47           expiry
48
49       1
50           The certificate is inside its validity period, or could not be
51           parsed
52
53       2
54           An invalid argument was passed.
55

SEE ALSO

57       httpd(8), certwatch.cron(5), https://github.com/notroj/certwatch/
58

AUTHOR

60       Joe Orton <jorton@redhat.com>
61           Author
62
63
64
65certwatch                        February 2019                    CERTWATCH(1)
Impressum