~ubuntu-branches/ubuntu/trusty/nagios-plugins-contrib/trusty-proposed

« back to all changes in this revision

Viewing changes to check_ssl_cert/check_ssl_cert-1.14.6/check_ssl_cert.1

  • Committer: Package Import Robot
  • Author(s): Bernd Zeimetz, Bernd Zeimetz, Jan Wagner, Evgeni Golov
  • Date: 2013-06-14 20:53:49 UTC
  • Revision ID: package-import@ubuntu.com-20130614205349-34xiy38pm1hzpjoi
Tags: 7.20130614
[ Bernd Zeimetz ]
* [036816ff] Merge pull request #15 from evgeni/master
  check_packages should find security updates on the official security mirror too
* [658a2e93] Add check_checksums nagios plugin.
* [9d5d2056] Updating check_raid.
* [e3ec1293] Updating check_ssl_cert to 1.14.6
* [779543ef] Updating check_hpasm to 4.6.3.2
* [0c838ee9] Updating check_multipath to 0.1.9
* [bec11251] Updating check_whois to 1.13
* [8e0a65d0] Refreshing patches.
* [c0b88cdb] Auto update of debian/copyright
* [59648a17] Fix src link for check_hpasm
* [8c242d0f] Support pre-Wheezy versions of coretutils in check_checksums.
* [7d3d2a06] Update release date in changelog (gah!).
* [768e463b] Merge pull request #16 from evgeni/master
  check_libs: ignore /var/lib/postgresql/ and /var/log/
* [2b9aace5] Bumping standards-Verison, no changes needed.

[ Jan Wagner ]
* [3bb873e4] disable epn for check_rbl

[ Evgeni Golov ]
* [2a7ab4b8] check_libs: ignore /var/spool/

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Process this file with
 
2
.\" groff -man -Tascii foo.1
 
3
.\"
 
4
.TH "check_ssl_cert" 1 "May, 2013" "1.14.6" "USER COMMANDS"
 
5
.SH NAME
 
6
check_ssl_cert \- checks the validity of X.509 certificates
 
7
.SH SYNOPSIS
 
8
.BR "check_ssl_cert " "-H host [OPTIONS]"
 
9
.SH DESCRIPTION
 
10
.B check_ssl_cert
 
11
A Nagios plugin to check an X.509 certificate:
 
12
 - checks if the server is running and delivers a valid certificate
 
13
 - checks if the CA matches a given pattern
 
14
 - checks the validity
 
15
.SH ARGUMENTS
 
16
.TP
 
17
.BR "-H,--host" " host"
 
18
server
 
19
.SH OPTIONS
 
20
.TP
 
21
.BR "-A,--noauth"
 
22
ignore authority warnings (expiration only)
 
23
.TP
 
24
.BR "   --altnames"
 
25
matches the pattern specified in -n with alternate names too
 
26
.TP
 
27
.BR "-C,--clientcert" " path"
 
28
use client certificate to authenticate
 
29
.TP
 
30
.BR "   --clientpass" " phrase"
 
31
set passphrase for client certificate.
 
32
.TP
 
33
.BR "-c,--critical" " days"
 
34
minimum number of days a certificate has to be valid to issue a critical status
 
35
.TP
 
36
.BR "-e,--email" " address"
 
37
pattern to match the email address contained in the certificate
 
38
.TP
 
39
.BR "-f,--file" " file"
 
40
local file path (works with -H localhost only)
 
41
.TP
 
42
.BR "-h,--help,-?"
 
43
this help message
 
44
.TP
 
45
.BR "--long-output" " list"
 
46
append the specified comma separated (no spaces) list of attributes to the plugin output on additional lines.
 
47
Valid attributes are: enddate, startdate, subject, issuer, modulus, serial, hash, email, ocsp_uri and fingerprint. 'all' will include all the available attributes.
 
48
.TP
 
49
.BR "-i,--issuer" " issuer"
 
50
pattern to match the issuer of the certificate
 
51
.TP
 
52
.BR "-n,---cn" " name"
 
53
pattern to match the CN of the certificate
 
54
.TP
 
55
.BR "-N,--host-cn"
 
56
match CN with the host name
 
57
.TP
 
58
.BR "-o,--org" " org"
 
59
pattern to match the organization of the certificate
 
60
.TP
 
61
.BR "   --openssl" " path"
 
62
path of the openssl binary to be used
 
63
.TP
 
64
.BR "-p,--port" " port"
 
65
TCP port
 
66
.TP
 
67
.BR "-P,--protocol" " protocol"
 
68
use the specific protocol: http (default) or smtp,pop3,imap,ftp (switch to TLS)
 
69
.TP
 
70
.BR "-s,--selfsigned"
 
71
allows self-signed certificates
 
72
.TP
 
73
.BR "-r,--rootcert" " cert"
 
74
root certificate or directory to be used for certficate validation (passed to openssl's -CAfile or -CApath)
 
75
.TP
 
76
.BR "-t,--timeout"
 
77
seconds timeout after the specified time (defaults to 15 seconds)
 
78
.TP
 
79
.BR "--temp" " dir"
 
80
directory where to store the temporary files
 
81
.TP
 
82
.BR "-v,--verbose"
 
83
verbose output
 
84
.TP
 
85
.BR "-V,--version"
 
86
version
 
87
.TP
 
88
.BR "-w,--warning" " days"
 
89
minimum number of days a certificate has to be valid to issue a warning status
 
90
.SH DEPRECATED OPTIONS
 
91
.TP
 
92
.BR "-d,--days" " days"
 
93
minimum number of days a certificate has to be valid (see --critical and --warning)
 
94
 
 
95
.SH "SEE ALSO"
 
96
x509(1), openssl(1), expect(1), timeout(1)
 
97
.SH "EXIT STATUS"
 
98
check_ssl_cert returns a zero exist status if it finds no errors, 1 for warnings, 2 for a critical errors and 3 for unknown problems
 
99
.SH BUGS
 
100
Please report bugs to: Matteo Corti (matteo.corti (at) id.ethz.ch)
 
101
 
 
102
.SH AUTHOR
 
103
Matteo Corti (matteo.corti (at) id.ethz.ch)
 
104
See the AUTHORS file for the complete list of contributors
 
105