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.7.9
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         -q, --quiet
48           Do not print package list
49         -v, --verbose
50           Show details for command-line debugging (can repeat up to 3 times)
51

OPTIONS

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

SECURITY UPDATES

90       If yum's security plugin is available
91

EXAMPLE

93       check_updates
94
95       check_updates checks if the system is up-to-date
96

DIAGNOSTICS

98       You can specify --verbose option (-v) multiple times to increase
99       program verbosity.
100

EXIT STATUS

102       0 if OK, 1 in case of a warning, 2 in case of a critical status and 3
103       in case of an unknown problem
104

DEPENDENCIES

106       check_updates depends on
107
108       ·   Carp
109
110       ·   English
111
112       ·   Getopt::Long
113
114       ·   Monitoring::Plugin
115
116       ·   Monitoring::Plugin::Getopt
117
118       ·   Monitoring::Plugin::Threshold
119
120       ·   POSIX
121
122       ·   Readonly
123

INCOMPATIBILITIES

125       None reported.
126

BUGS AND LIMITATIONS

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

AUTHOR

156       Matteo Corti <matteo@corti.li>
157

LICENSE AND COPYRIGHT

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

DISCLAIMER OF WARRANTY

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

ACKNOWLEDGMENTS

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