developer-guidelines.sgml: Multiline output
[monitoring-plugins.git] / NEWS
blob1668dc4e1e42ee07b4459c1080100b4bfab43e07
1 This file documents the major additions and syntax changes between releases.
3 ...
4         ENHANCEMENTS
5         New check_dbi plugin for checking an (SQL) database using DBI
6         Let OpenSSL load its configuration file (see the OPENSSL_config(3) man page)
7         Add performance data to check_apt
8         Add performance data to check_procs
9         Added -4/-6 options to check_dig (Ville Mattila)
10         New check_oracle --connect option to perform real login
11         New check_nagios -t option to override the default timeout
12         New check_disk -N/--include-type option to limit the filesystem types to check
13         Allow for building the plugins in parallel
14         Add --without-{dbi,ldap,radius} options to ./configure
15         Made Verbose output of check_sensors compliant (Gabriele Tozzi)
16         New switch -E/--extended-perfdata for check_http to print additional performance data (Sebastian Nohn)
17         New check_http -d option to specify a string to expect within the response headers
18         New check_http -J/-K options for client certificate authentication support
19         Add support for executing queries to check_pgsql
20         Let check_pgsql accept a UNIX socket directory as hostname
21         New check_pgsql -o option to specify additional connection parameters
22         New check_fping -S option to specify the source IP address
23         New check_fping -I option to specify the interface to bind to
24         Let check_fping support IPv6
25         New check_procs -k option to ignore kernel threads (on Linux)
26         Let check_procs use /proc/<PID>/exe (if available) instead of getpid(2), unless -T is specified
27         Let check_mysql support SSL
28         Let check_mysql add perfromance metrics for all checks
29         New check_mysql -f option to specify a client options file
30         New check_mysql -g option to specify a client options group
31         New check_snmp --offset option to allow for adding/substracting an offset value to sensor data
32         Let check_ide_smart support NetBSD
34         FIXES
35         Change the MAIL FROM command generated by check_smtp to be RFC compliant
36         Fix compilation of check_http without SSL support
37         Fix check_snmp reversed threshold ranges (backward-compatibility)
38         Fix check_snmp memory violation when using more than 8 oids (Robin Sonefors)
39         Fix check_apt security regular expression (Alex Bradley)
40         Fix check_http handling extra header (-k) containing semicolons (Richard Leitner)
41         Fix check_apt handling unknown exit codes from apt-get (Richard Leitner)
42         Fix deprecated imports of check_nmap.py (Fabio Rueda)
44         WARNINGS
45         check_http behaviour of -k/--header changed since it does not seperate multiple headers by semicolons anymore. Use multiple -k switches instead.
47 1.4.16 27th June 2012
48         ENHANCEMENTS
49         check_nt UPTIME accepts warning/critical thresholds (Ryan Kelly)
50         check_disk_smb now allows spaces in share names (#990948, #1370031, Debian #601699)
51         check_http now uses standard threshold functions (enables floating point and ranges)
52         check_http now checks for and prints the certificate cn (hostname) in SSL certificate checks (Stéphane Urbanovski)
53         check_http now supports an optional -S/--ssl value to choose the SSL protocol version (#3066166 - Jason Lunn)
54         Add perfdata to check_ssh (#3244097 - Marco Beck)
55         New option to check_smtp to ignore failures when sending QUIT (#3358348 - Duncan Ferguson)
56         New check_by_ssh -F option which allows for specifying an alternative ssh_config(5) file (#2895334 - Sven Nierlein)
57         check_sensors now detects faulty sensors unless --ignore-fault is specified (Jan Wagner)
58         utils.sh now provides a check_range function (Alex Griffin)
59         Improved the performance of check_users (Marc Remy)
60         Add perfdata to check_disk_smb (Debian #654259 - Charles-Henri Larose)
61         Updated Nagios::Plugin perl module
62         Add warning threshold to certificate expiration checks of check_tcp/http/smtp (William Leibzon)
63         Add --perf-oids option for check_snmp (Jochen Bern)
65         FIXES
66         Fix check_disk free space calculation if blocksizes differ within a disk group (Bekar - #2973603)
67         check_disk_smb now handles NT_STATUS_ACCESS_DENIED properly (Debian #601696)
68         Make check_snmp work more like v1.4.14 with regard to using special values (Timeticks, STRING) as numeric thresholds
69         Fix check_ldap overriding the port when --ssl was specified after -p
70         Fix check_procs where regex input of '|' would get displayed in output - now replaced with ','
71         Fix segfault in check_host when hostname returns multiple IP addresses (Sebastian Harl)
72         Fix check_smtp and check_tcp where duplicate messages were displayed for certificate errors
73         Fix check_ping's parsing of ping6(1) output (#1894850, Debian #514588, Debian #662638 - Matej Vela)
74         Fix a check_dhcp bug which was triggered by checking Windows 2003 DHCP servers (#3503921)
75         Disable RFC4507 support, to work around SSL negotiation issues with (at least) some Tomcat versions
76         Fix performance data label containing spaces in check_snmp (Jochen Bern)
78 1.4.15 27th July 2010
79         ENHANCEMENTS
80         New check_ntp_peer -m and -n options to check the number of usable time sources ("truechimers")
81         New check_disk_smb -a option which allows for specifying the IP address of the remote server
82         New check_radius -N option which allows for specifying the value of the NAS-IP-Address attribute
83         New check_snmp --rate option to store differences between invocations. Saves state in PREFIX/var/{plugin}
84         check_snmp -l label option now also changes the perfdata label. See WARNINGS
85         check_snmp has an --invert-search option which reverses status of the string and regexp searches
86         check_http now displays the missing search string and the URL in the output when failed (Duncan Ferguson - #2999924)
87         Updated Nagios::Plugin perl module
88         Updated gnulib to June 2010
90         FIXES
91         Fix check_ircd binding to wrong interface (#668778)
92         Add proxy-authorization option to check_http (Marcel Kuiper - #1323230, Bryan Irvine - #2863925)
93         check_icmp now increment the sequence counter in each packet
94         Fix usage of repeated -o options in check_snmp
95         Try to detect arguments passed via --with-ping[6]-command and set options accordingly (#2908236)
96         Fix memory leak in check_http for large pages (Jimmy Bergman - #2957455)
97         Fix compilation with GCC 2.96 (Konstantin Khomoutov - #2977105)
98         Fix regression introduced in #1867716 where partially valid performance strings would not be printed anymore
99         Fix regression in check_http ssl checks on some servers - make SNI an option
100         Fix guest mode support in check_disk_smb
101         Fix check_disk_smb and check_ircd failures when run via ePN
102         check_ldap now allows for specifying an empty LDAP base
103         Fix compilation error of pst3 in Solaris 8
104         Fix check_radius returning OK on unexpected results (Craig Leres - #2911752)
105         Fix translations when extra-opts aren't enabled (Jan Wagner - #2832884)
106         Fix parsing of multi-line strings in check_snmp (broken in 1.4.14) and enhance output in such case (#2832451)
107         Fix detection of pst3 64-bit compile flags with Sun CC
108         Fix cmd_run overwriting the environment, which would break some commands that needed it
109         Allow check_ifstatus to accept version=2c - used to only allow version=2 (Brian Landers)
110         Fix examples in check_disk, where it implied was possible to suffix unit values to warn/crit parameters
112         WARNINGS
113         Updated developer documentation to say that performance labels should not have an equals sign or
114         single quote in the label
115         check_http 1.4.14 introduced SSL SNI support - you now have to enable it explicitly with "--sni"
116         check_snmp -l label option is also used for the performance label. This could change history from previous uses
118 1.4.14 16th September 2009
119         check_http has options to specify the HTTP method (#2155152)
120         check_users thresholds were not working exactly as documented (>= rather than >)
121         Updated tinderbox_build script to point to new tinderbox server
122         check_ifoperstatus -n flag now works as expected (sf.net #1569488)
123         check_ifoperstatus now supports ifType based lookup for ifIndex
124         check_ups now sends a LOGOUT string (debian bug #387001)
125         Extra-opts (C plugins) now allows both '#' and ';' for comments (like N::P)
126         Extra-opts (C plugins) does not allow trailing comments anymore (like N::P)
127         Fixed dependency issue on libtap when ./configure --enable-libtap used. Warning: will install libtap
128         Fixed segfault in extra-opts under some circumstance when reading multiple sections
129         Fix long options parsing in check_disk, check_dns, check_mrtg, check_mrtgtraf and check_tcp
130         Add missing long options for check_nt (for use with extra-opts)
131         check_icmp now reports min and max round trip time perfdata (Steve Rader)
132         Fixed check_http bug where additional headers with redirection caused a segfault (Dieter Van de Walle - 2089159)
133         check_disk: make autofs mount paths specified with -p before we determine the mount list (Erik Welch)
134         Fixed buffer overflow in check_ntp/check_ntp_peer (#1999319, Ubuntu #291265)
135         Re-bundled libtap as a built-in library (--enable-libtap): detects system library as pre-1.4.13 and does not install the built-in library anymore
136         Fixed check_mrtg returning UNKNOWN instead of OK (bug #2378068)
137         Fixed check_http behaviour: all check are now performed as long as a valid response is returned (sf.net #1460312)
138         check_http --onredirect=sticky follows using the same IP address (sf.net #2550208)
139         check_http --onredirect=stickyport also follows the same port
140         Fixed coredump from check_nt when invalid drive is specified (#2179754 - Olli Hauer)
141         Fixed crash from check_nt when -H unspecified or given multiple times (sf.net #2731755, debian #521097)
142         Fixed passing of quotes in OID for check_snmp (#1985230 - Jan Wagner, patch by John Barbuto)
143         Fixed check_http sending HTTP/1.0 with v1.1 headers (#2638765)
144         Fixed check_http not timing-out on redirects
145         Fixed negate not printing the real timeout in ALRM handler when left to default
146         negate timeout result is now configurable
147         Fixed segfault in check_mysql with old slaves (#2696823 - Oskar Ahner)
148         check_nt can return UNKNOWN on timeouts (-u)
149         Fixed typos for check_disk (Chris Pepper)
150         Fixed check_mysql* not using password set in my.cnf (#2531905 - Ben Timby) - Specify an empty password explicitly if you need to override it.
151         Fixed awk subst.in/subst script path error (#2722832 - Martin Foster)
152         check_http: Add SSL/TLS hostname extension support (SNI) - (#1939022 - Joe Presbrey)
153         Fixed wrong perfdata label for output traffic in check_mrtgtraf (#2654308 - Gavin Williams)
154         Fixed check_by_ssh interpretation of quotes in -C parameter (#1985246, #2268675)
155         check_snmp now supports standard threshold ranges and doubles (floating numbers) in thresholds
156         check_fping now supports passing target timeout and interval to fping (#2347686 - Martin Foster)
157         Fixed SNMPv3 behaviour of check_ifoperstatus and check_ifstatus. Added -P to define privprotocol (#2343438 - Robin Schroeder)
158         check_ifoperstatus and check_ifstatus are now more user-friendly in case of missing arguments
159         pst3 compile fix for Sun Studio Compiler (Grant Byers)
161 1.4.13 25th Sept 2008
162         Fix Debian bug #460097: check_http --max-age broken (Hilko Bengen)
163         Optimised pst3 for systems with large number of processes (Duncan Ferguson)
164         Updated Nagios::Plugin to 0.27
165         Fix Debian bug #479013: check_dig's -l is mandatory now (sf.net #1986306)
166         check_dig now returns CRITICAL instead of WARNING when no answer section is found
167         check_procs now captures stderr in external command and adds to plugin output
168         check_snmp now only prints perfdata for non numeric values (#1867716)
169         check_icmp now supports packet size modification
170         check_http -e now accepts a comma-delimited list of expected status codes (Sven Nierlein)
171         libtap now included with this distribution for easier testing. Run ./configure with --enable-libtap
172         check_ntp_peer/check_ntp_time used to show port in --help but ignored the argument - now implemented
173         Fix possible segfault in check_ntp_peer with deliberately invalid packets
175 1.4.12 27th May 2008
176         Added ./check_nt -v INSTANCES to count number of instances (Alessandro Ren)
177         New check_icmp -s option to specify the source IP address
178         check_dns now sorts addresses for testing results for more than one returned IP (Matthias Urlichs)
179         Fix segfault in check_ntp_time and (deprecated) check_ntp (Bug #1862300)
180         check_disk should now work with large file systems (2TB+) on all archs that supports it
181         Fixed check_disk disk usage calculation when using --group=NAME (related to bug #1348746)
182         Fix help text of check_ntp* (Bug #1880095)
183         Fix bugs and flaws in best offset server selection of check_ntp_time and (deprecated) check_ntp
184         check_ntp_peer now checks for the LI_ALARM flag
185         Sync to latest Gnulib (includes new floorf function)
186         check_pgsql now successfully builds with postgres lib v8.3 (Bug #1878972)  
187         check_procs now accepts --ereg-argument-array for a regular expression match to the argument array
188         Reverted back to using pst3 for Solaris systems. Fixed issues re: -m64 needed to compile on 64bit systems
189         If applicable, Gettext linked dynamically instead of statically
190         check_dig can now pass arguments to dig by using -A/--dig-arguments (#1874041/#1889453)
191         check_ntp and check_ntp_peer now show proper jitter/stratum thresholds longopts in --help
192         check_dns now allow to repeat -a to match multiple possibly returned address (common with load balancers)
193         check_mysql and check_radius now try clearing password in processlist just like check_mysql_query
194         check_mysql and check_mysql_query now support sockets explicitely (-s, --socket)
195         negate now has the ability to replace the status text as well (-s, --substitute)
196         Added performance data to check_ping (Christian Schneemann)
197         Added support for --extra-opts in all C plugins (disabled by default, see configure --help)
198         Fixed passive option in check_by_ssh
199         On non-skipped stderr, check_by_ssh now returns UNKNOWN or worse (result from command) instead of always UNKNOWN.
200         Fix linking against OpenSSL where libdl is required
202 1.4.11 13th December 2007
203         Fixed check_http regression in 1.4.10 where following redirects to
204           relative URLs on virtual hosts failed if both "-H" and "-I" were used
205         Merged two new checks that deprecates check_ntp: check_ntp_peer and check_ntp_time.
206           You should read the --help output so see which one is suitable for you. check_ntp_peer
207           implement stratum thresholds support (feature request #1703823).
208         check_ntp now returns UNKNOWN instead of WARNING if jitter is unavailable (jitter=-1.000000)
209           as long as the thresholds range include -1. If no offset threshold is specified
210           and the offset is unavailable, will return UNKNOWN as well.
211           NOTE: If jitter thresholds are specified as integers it will return CRITICAL if jitter
212           is "-1" as the default range starts at 0. See Examples in --help output.
213         Fixed broken usage2 in check_snmp and check_cluster
214         check_cluster now accepts all valid characters in its thresholds ("-", "@", "~")
215         Fixed check_disk reporting OK if disk usage grows over 100% (bug #1348746).
216           The problem happens to be in Gnulib but a workaround have been implemented in check_disk.c
217         Fixed check_load argument handling when not passing triplets (bug #1831890)
218         Fixed buffer overflow in check_snmp (CVE-2007-5623)
219         Tinderbox builds now runs tests in a verbose mode
220         Updated Nagios::Plugin to 0.22
221         VPATH problem fixed for compiling plugins-root
223 1.4.10 28th September 2007
224         Fix check_http buffer overflow vulnerability when following HTTP redirects (CVE-2007-5198)
225         check_http now explicitly asks HTTP/1.1 servers to close the connection
226           after completion of the response
227         Check_ldaps' guessing which secure method to use (starttls vs. ssl on connect)
228           is now deprecated. See --help for further information.
229         Check_disk now calls stat() on all filesystems to check. (Old: only the ones selected using -p)
230           A meaningful error message (eg "Stale NFS Handle") is printed if stat fails.
231         New check_disk option -L: Only check local filesystems, but call stat() on remote ones, too.
232           Thus accessibility of remote filesystems can be checked without any threshold comparison.
233         Check_disk's --help now prints some examples for the new features introduced in 1.4.8
234         New check_disk -i/-I option to ignore pathes/partitions based on regular expressions
235         New check_disk -A option to select all filesystems explicitly
236         WARNING: check_disk's -E option must now be passed before -p or -r/-R arguments
237           Passing -E after -p or -r results in UNKNOWN state, now
238           This is needed due to the new ignore feature
239         Fix check_disk bug when mixing case sensitive and case insensitive regex arguments
240         New check_dhcp -u/--unicast option for emulating a DHCP relay in order
241           to check DHCP servers on remote networks
242         New check_dhcp -m/--mac option which allows for specifying the MAC
243           address to use in the DHCP request
244         The check_dhcp -r and -s options now accept host names, too
245         Fix possible check_icmp bus errors on some (non-x86/AMD64) platforms
246         Fix check_smtp's handling of multiple-packet server responses
247         WARNING: Fix for negate which may break existing commands:
248           - stop evaluating command line options through shell twice
249           - enforce a full path for the command to run
250         The "negate" utility can now remap custom states
251         Check_radius now supports radiusclient-ng
252         The (undocumented) positional parameter parsing which check_radius used
253           instead of getopt(3) if 8 arguments were given is no longer available
254         Check_by_ssh now supports multiline output
255         IPv6 support can now be disabled using ./configure --without-ipv6
256         Fix check_ntp now honor ntp flags
258 1.4.9 4th June 2007
259         Inclusion of contrib/check_cluster2 as check_cluster with some improvements
260         New/improved -E/--skip-stderr and -S/--skip-stdout options for check_by_ssh
261         check_snmp now supports Counter64
262         Fix compilation of check_ldap, check_radius and check_pgsql
263         check_load can optionally divide by number of cpus
264         Fix check_time returning wrong OK when time is before the epoch on some arch
265         Make check_http output more consistent
266         Fix possible check_http segfaults when following HTTP redirects
267         check_snmp don't warn anymore if something is printed on stderr
268         Fix check_tcp segfault when multiple expect strings are given
269         New option for check_tcp: -A/--all to test if all given expect strings match
271 1.4.8 11th April 2007
272         Respects --without-world-permissions for setuid plugins
273         check_disk extra options for regex matching of filesystems and grouping of filesystems
274         for collective thresholds
275         Better configure test for mysqlclient availability
276         Various check_ntp fixes
278 1.4.7 29th March 2007
279         check_procs uses /usr/ucb/ps if available - fixes pst3 problems on Solaris
280         Fixed MKINSTALLDIRS problem in po/
281         ./configure now detects if possible to compile check_mysql
282         Fixed broken HELO in check_smtp
283         check_icmp now allows to set a minimum number of hosts required for successs (-m)
284         check_icmp fix for *BSD when running for long time
285         check_ping times out 1 second quicker if host is unreachable
286         Root plugins installed with world executable
287         check_sybase from contrib now maintained in NagiosExchange
288         --with-nagios-user/group reinstated ./configure option
289         New --without-world-permissions ./configure option
291 1.4.6 5th February 2007
292         Reduced number of DNS lookups in check_ping and netutils.c for IPv6 configurations
293         Fixed compile problems with *BSD re: alloca.h
294         Fixed Solaris problems with check_swap (tested on Solaris 9)
295         Fixed check_swap for HP/UX where swapinfo command was incorrect
296         Fixed check_disk inode threshold checks, regressed at r1.4.4.
297         Fixed crit/warn for check_disk perf data
298         Fixed buffer overflow in check_procs
299         Fixed error handling for UNIX sockets in netutils.c
300         New -q and -o options for check_by_ssh which are handed over to ssh(1) as is
301         Synced with latest GNUlib
302         Fixed check_jabber always returns warning
304 1.4.5
305         Fixed bug in perl's is_hostname routine
307 1.4.4
308         New C based check_ntp. The perl version is now deprecated.
309         New check_apt plugin
310         Notice: plugins in contrib/ will start to be removed from this distribution.
311           Please check at http://www.nagiosexchange.org for contributed plugins
312         Major bug fixes to check_disk where values were incorrectly calculated and alerted on.
313         check_udp2 removed. check_udp is now linked to check_tcp.c
314         check_mailq now errors if the sub-program run returns non-zero return code. This would appear
315           as if mailqs were okay when the nagios user could not query the mail-queues
316         Compile problems with check_snmp fixed
318 1.4.3
319         Setuid plugins (check_dhcp, check_icmp) separated into plugins-root/. Run make install as root to install
320         SSL plugins work with gnutls as well as OpenSSL
321         check_mysql_query added to run arbitrary SQL commands, with threshold checking
322         libtool now required for development systems
323         Notice: check_udp (compiled from check_udp.c) will be deprecated in the next release.
324           check_udp2 should be used instead and will be renamed to check_udp
326 1.4.2
327         Fix for Redhat ES4 for check_dns and check_dig
330         IPv6 support in check_ping, check_by_ssh, check_http, check_ldap, check_smtp, check_tcp
331         Internationalisation support
332         Performance data added to most plugins
333         check_disk now using GNU coreutils code
334         New plugins - check_dhcp, check_icmp
335         contrib/check_citrix has been replaced by contrib/check_ica* (requires packet_utils.pm in libexec)
336         check_http --min changed to --pagesize, added max so min:max in check
337         check_vsz and check_rss deprecated - functionality moved into check_procs
338         check_swap % thresholds changed to measure amount free, instead of amount used
339         check_disk syntax changes for -p, -m/-M, defaults to MB instead of kB
340         check_procs -C expects no path for the command name