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.9.2
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        --assumeyes
28          Automatically answer yes for all dnf check-updates questions. Useful for importing GPG keys
29         --boot-check
30           CRITICAL if the machine was booted without the newest kernel (default)
31         --boot-check-warning
32           Like --boot-check but state is warning instead of critical
33         --no-boot-check
34           Do not complain if the machine was booted with an old kernel
35         --clean
36           Cleans YUM/DNF caches
37         -d, --debug
38           Enables debugging messages
39         --debug-file=STRING
40          Write debugging messages to a file
41         -w, --warning=INTEGER
42           Exit with WARNING status if more than INTEGER updates are available
43         -c, --critical=INTEGER
44           Exit with CRITICAL status if more than INTEGER updates are available
45         --security-only
46           Ignores non-security updates
47         -a, --yum-arguments=STRING
48           specific Yum arguments as STRING
49         -n, --number-only
50           consider the number of updates only (security updates are not automatically critical)
51         -t, --timeout=INTEGER
52           Seconds before plugin times out (default: 15)
53         -q, --quiet
54           Do not print package list
55         -v, --verbose
56           Show details for command-line debugging (can repeat up to 3 times)
57

OPTIONS

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

SECURITY UPDATES

96       If yum's security plugin is available
97

EXAMPLE

99       check_updates
100
101       check_updates checks if the system is up-to-date
102

DIAGNOSTICS

104       You can specify --verbose option (-v) multiple times to increase
105       program verbosity.
106

EXIT STATUS

108       0 if OK, 1 in case of a warning, 2 in case of a critical status and 3
109       in case of an unknown problem
110

DEPENDENCIES

112       check_updates depends on
113
114       •   Carp
115
116       •   English
117
118       •   Getopt::Long
119
120       •   Monitoring::Plugin
121
122       •   Monitoring::Plugin::Getopt
123
124       •   Monitoring::Plugin::Threshold
125
126       •   POSIX
127
128       •   Readonly
129

INCOMPATIBILITIES

131       None reported.
132

BUGS AND LIMITATIONS

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

AUTHOR

162       Matteo Corti <matteo@corti.li>
163

LICENSE AND COPYRIGHT

165       Copyright (c) 2007-2016, Matteo Corti
166
167       This module is free software; you can redistribute it and/or modify it
168       under the terms of GNU general public license (gpl) version 3 or (at
169       your option) any later version.  See the LICENSE file for details.
170

DISCLAIMER OF WARRANTY

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

ACKNOWLEDGMENTS

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