check_updates(1)

1CHECK_UPDATES(1)      User Contributed Perl Documentation     CHECK_UPDATES(1)
2
3
4

NAME

6       "check_updates" - a Nagios plugin to check if Red Hat or Fedora system
7       is up-to-date
8

DESCRIPTION

10       check_updates is a Nagios plugin to check if Red Hat or Fedora system
11       is up-to-date
12

VERSION

14       Version 1.6.23
15

SYNOPSIS

17         check_updates [OPTIONS]
18
19         -?, --usage
20           Print usage information
21         -h, --help
22           Print detailed help screen
23         -V, --version
24           Print version information
25         --extra-opts=[<section>[@<config_file>]]
26           Section and/or config_file from which to load extra options (may repeat)
27         --boot-check
28           Check if the machine was booted with the newest kernel (default)
29         --boot-check-warning
30           Like --boot-check but state is warning instead of critical
31         --no-boot-check
32           Do not complain if the machine was booted with an old kernel
33         --clean
34           Cleans YUM/DNF caches
35         -d, --debug
36           Enables debugging messages
37         -w, --warning=INTEGER
38           Exit with WARNING status if more than INTEGER updates are available
39         -c, --critical=INTEGER
40           Exit with CRITICAL status if more than INTEGER updates are available
41         --security-only
42           Ignores non-security updates
43         -a, --yum-arguments=STRING
44           specific Yum arguments as STRING
45         -t, --timeout=INTEGER
46           Seconds before plugin times out (default: 15)
47         -v, --verbose
48           Show details for command-line debugging (can repeat up to 3 times)
49

OPTIONS

51         -?, --usage                              Print usage information
52
53         -h, --help                               Print detailed help screen
54
55         -V, --version                            Print version information
56
57         --extra-opts=[<section>[@<config_file>]] Section and/or config_file from which to load extra options (may repeat)
58
59         --boot-check                             Check if the machine was booted with the newest kernel (default)
60
61         --boot-check-warning                     Like --boot-check but state is warning instead of critical
62
63         --no-boot-check                          Do not complain if the machine was booted with an old kernel
64
65         --clean                                  Cleans YUM/DNF caches
66
67         -d, --debug                              Enables debugging messages
68
69         -w, --warning=INTEGER                    Exit with WARNING status if more than INTEGER non-security updates are available
70
71         -c, --critical=INTEGER                   Exit with CRITICAL status if more than INTEGER non-security updates are available
72
73         --security-only                          Ignores non-security updates
74
75         -a, --yum-arguments=STRING               Specifies additional arguments for Yum.
76                                                  Arguments containing spaces must be quoted
77                                                  (e.g., ./check_updates -a "-d 20")
78
79         -t, --timeout=INTEGER                    Seconds before plugin times out (default: 15)
80
81         -v, --verbose                            Show details for command-line debugging (can repeat up to 3 times)
82
83       Security updates always force a CRITICAL state
84

SECURITY UPDATES

86       If yum's security plugin is available
87

EXAMPLE

89       check_updates
90
91       check_updates checks if the system is up-to-date
92

DIAGNOSTICS

94       You can specify --verbose option (-v) multiple times to increase
95       program verbosity.
96

EXIT STATUS

98       0 if OK, 1 in case of a warning, 2 in case of a critical status and 3
99       in case of an unknown problem
100

DEPENDENCIES

102       check_updates depends on
103
104       ·   Carp
105
106       ·   English
107
108       ·   Getopt::Long
109
110       ·   Monitoring::Plugin
111
112       ·   Monitoring::Plugin::Getopt
113
114       ·   Monitoring::Plugin::Threshold
115
116       ·   POSIX
117
118       ·   Readonly
119

INCOMPATIBILITIES

121       None reported.
122

BUGS AND LIMITATIONS

127       Some versions of yum deliver a wrong number of security updates. For
128       example
129
130               $ yum --security  check-update
131               Loaded plugins: downloadonly, product-id, rhnplugin, security
132               This system is receiving updates from RHN Classic or RHN Satellite.
133               Limiting package lists to security relevant ones
134               No packages needed for security; 7 packages available
135
136               mysql-libs.i686                                  5.1.73-5.el6_6                                   rhel-x86_64-server-6
137
138       Either is mysql-libs a security update (and the text should report it)
139       or the package is wrongly listed. If yum delivers a wrong count, the
140       plugin will do the same.
141
142       Please report any bugs or feature requests to matteo@corti.li, or
143       through the web interface at
144       https://github.com/matteocorti/check_updates/issues
145
146       Be sure to include the output produced by the plugin with the --verbose
147       option:
148
149         check_updates -v -v -v
150

AUTHOR

152       Matteo Corti <matteo@corti.li>
153

LICENSE AND COPYRIGHT

155       Copyright (c) 2007-2016, Matteo Corti
156
157       This module is free software; you can redistribute it and/or modify it
158       under the terms of GNU general public license (gpl) version 3 or (at
159       your option) any later version.  See the LICENSE file for details.
160

DISCLAIMER OF WARRANTY

162       BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
163       FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
164       WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
165       PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
166       EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
167       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
168       ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
169       YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
170       NECESSARY SERVICING, REPAIR, OR CORRECTION.
171
172       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
173       WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
174       REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE
175       TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
176       CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
177       SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
178       RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
179       FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
180       SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
181       DAMAGES.
182

ACKNOWLEDGMENTS

184       Many thanks to:
185
186       ·   Peter Bircher & Cristian Tuduce for several bug fixes
187
188       ·   Mark Greenheigh for the prompt and precise bug reports
189
190       ·   Jose Pedro Oliveria for the build and release fixes
191
192       ·   Tomas Edwardsson for a patch fixing the detection of RH EL 6
193           systems
194
195       ·   Cott Lang for the Amazon Linux patch
196
197       ·   Joop Boonen for the yum arguments patch
198
199       ·   Franky Van Liedekerke for the perfomance data and security plugin
200           patch and for the openvz kernels patch
201
202       ·   Andreas Dijkman for the Oracle UEK patch
203
204       ·   PhiBo (https://github.com/phibos) for the --boot-check-warning
205           patch
206
207
208
209perl v5.28.1                      2018-06-19                  CHECK_UPDATES(1)