NEWS 44 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767
  1. This file documents the major additions and syntax changes between releases.
  2. 2.3.1 xxxx-xx-xx
  3. FIXES
  4. check_icmp: Fixed backwards compatibility issue with performance data (#480)
  5. 2.3.0 xxxx-xx-xx
  6. ENHANCEMENTS
  7. Added a plugin "remove_perfdata" to remove perfdata from another plugin's output
  8. Added a plugin "check_ssl_validity" which verifies a certificate through CRL or OCSP
  9. Added directory plugins-python containing three Python plugins
  10. check_apt: Add --only-critical switch
  11. check_apt: Add --packages-warning (Marc Sánchez)
  12. check_disk: Add --combined-thresholds to alert on a percentage AND raw units.
  13. check_disk: Add --inode-perfdata to get extra performance data from inode statistics
  14. check_disk: Add support for base-10 units kB, MB, GB, TB; rename base-2 units to KiB, MiB, GiB, TiB
  15. check_disk_smb: Add configfile feature
  16. check_disk_smb: Added additional smb support
  17. check_disk_smb: Allow non-latin characters in names (Konstantin Shalygin)
  18. check_file_age: Use extended plugin output to show one file per line
  19. check_http: New parameter `--verify-host` will check if -H hostname matches the SSL certificate
  20. check_icmp: Add Jitter, MOS, Score (Alessandro Ren)
  21. check_ldap: Add support for checking LDAP cert age (Guillaume Rousse)
  22. check_mailq: Add mailq -C option for config dir or config file
  23. check_mailq: Add option for opensmtpd (brigriffin)
  24. check_mailq: Add support for opensmtpd
  25. check_mysql_query: Add --character-set flag
  26. check_ntp: Add --delay flag to circumvent DOS detection
  27. check_ntp: Add --allow-zero-stratum flag
  28. check_ntp_time: Add --delay flag to circumvent DOS detection
  29. check_ntp_time: Add support for monitoring stratum of timesources
  30. check_oracle: Add support for Oracle XE databases (Peter Athaks)
  31. check_ping: plugin output will now include hostname and IP address
  32. check_pgsql: Add --print-query flag
  33. check_procs: Add FreeBSD jail support (Mathieu Arnold)
  34. check_procs: Allow process to be excluded from check_procs (Marcel Klein)
  35. check_procs: Additional performance data metrics (azthec)
  36. check_radius: Add calling-station-id (cejkar)
  37. check_smtp: Add --proxy flag for PROXY protocol (Patrick Uiterwijk)
  38. check_smtp: Add support for --sni (Arkadiusz Miśkiewicz)
  39. check_snmp: Add --strict flag to ensure returned OID matches -o.
  40. check_swap: Add --no-swap flag (Mario Trangoni)
  41. check_ups: Add check for battery runtime left (gino0631)
  42. lib: Added warning_string/critical_string to struct thresholds for storing originally parsed strings
  43. ssl_utils: Added certificate expiry data in OK status (check_http, check_smtp, check_tcp) (Matt Capra)
  44. FIXES
  45. build: Fix ax_with_python not crashing on Python3 (Michael Orlitzky)
  46. build: fix configure.ac for FreeBSD SWAPFORMAT
  47. build: Fix rpmbuild errors (Josh Coughlan)
  48. check_disk: autofs being mounted despite '-l'. Fixed, and also excluded some system "fake" mountpoints
  49. check_disk: Add missing timeout logic
  50. check_dns: Fix for Bind 9.11.x AAAA records being reported with A record format (Troy Lea)
  51. check_dns: reverse (PTR) check is now case insensitive
  52. check_file_age: For multiple files, use the "worst" status instead of the "last" one
  53. check_file_age: perfdata labels when using multiple files
  54. check_file_age: For multiple files, don't exit immediately on first file not found
  55. check_http: Additional header/status checking
  56. check_http: Fix --no-body
  57. check_http: When checking certificate, don't check content/status unless specified by --continue-after-certificate
  58. check_load: Fixed for operating systems which don't have commas in their load averages (like Mac OSX)
  59. check_log does not check for "-O oldlog"
  60. check_log lost ability to use regexes for query (-q) in 2.1.4
  61. check_mysql_query & mysql_query: extra-opts causes crash
  62. check_ntp/ntp_time/ntp_peer: Fix how thresholds are displayed in performance data
  63. check_ntp_time calls `write` on a UDP socket without a successful call to `connect`
  64. check_ntp_time: Periodically returns "Socket timeout" when one of several ntp server doesn't respond
  65. check_ntp.pl: Fixed crash due to references to undefined variables
  66. check_ping: FreeBSD ping working natively
  67. check_procs: Prevent buffer overflow/crash on Solaris
  68. check_radius: Fix for null pointer dereference (Vít Heřman)
  69. check_sensors: Fix fault test with --ignore-fault
  70. check_snmp: Fix --authpasswd option
  71. check_snmp: Fix perfdata not adhering to plugin dev guidelines
  72. check_snmp: warning/critical perfdata is returned properly
  73. check_ups: Change performance data units to match spec. (Temperature and voltage units can be accessed via -e)
  74. check_wave: produces lots of errors if required arguments are not provided
  75. 2.2.1 2017-04-19
  76. FIXES
  77. check_users: not accepting zero as the threshold
  78. check_http: reports warning where it should report ok with -e
  79. check_snmp: does not work with -6 --ipv6 flags
  80. check_swap: threshold calculation in bytes requires subtracting 65
  81. check_uptime: fixed backward help text for thresholds
  82. check_http: Don’t prematurely report success when checking HTTP TLS cert validity
  83. check_http: fix parsing the last header
  84. check_mailq: Fix for Postfix and better Sudo Checking
  85. configure.ac: Fix spelling error
  86. check_ntp_peer: requires newline when there is a socket timeout (fix in netutils.c)
  87. check_users: segmentation fault if both thresholds are not provided
  88. check_dns: DNS CRITICAL - expected ‘{hostname}.’ but got 'name = {hostname}.'
  89. check_mailq: Nullmailer Regex is not working for Ubuntu 16.04
  90. check_swap: Downstream Fedora patch: Prevent check_swap from returning OK, if no swap activated
  91. Building RPMs on Amazon Linux - Add 'install-root' on line 165 of spec file
  92. check_http: Memory allocation error
  93. 2.2.0 2017-01-19
  94. ENHANCEMENTS
  95. check_flexlm: if `-F <license file>` is not specified, will use `LM_LICENSE_FILE` environment var
  96. check_load: Added per cpu load average message
  97. check_smtp: add -L flag to support LMTP (LHLO instead of HELO/EHLO)
  98. FIXES
  99. check_http: -e breaks -f
  100. check_mrtg: Add state to status output
  101. check_ping: ping runs 30 times when host is down
  102. check_icmp: does not have the -p argument in the help
  103. check_dns: Segfaulting with timeout > 26 sec
  104. check_disk: missing -lrt on Solaris
  105. check_http: segmentation fault
  106. check_http: help text update for virtual hosts
  107. check_snmp: Thresholds were being shown twice
  108. check_hpjd: some jd 610 cards have a false flag that printer is offline
  109. check_http: Handle reference redirect like //www.site.org/test
  110. check_disk: alerts issued too soon
  111. fix: Allocator sizeof operand mismatch
  112. fix: Dead assignment
  113. Shellcheck: fix most of the shellcheck warnings.
  114. check_ntp: touch ntp servers at most once every seconds
  115. check_dns: authoritative test (-A) is broken
  116. check_dns: reports TXT records incorrectly
  117. check_file_age: does not handle filenames WITHOUT space!
  118. de,fr.po: fix syntax errors end-of-line within string
  119. lib/parse_ini.c: fix gcc warning: implicit declaration of function ‘idpriv_temp_drop’ and ‘idpriv_temp_restore’
  120. add openssl 1.1 support
  121. 2.1.4 2016-11-17
  122. FIXES
  123. check_http: Don't include default Accept header if one is provided
  124. check_disk: added "fuse.gvfsd-fuse" to list of fs types to ignore
  125. check_http: Fixed non-text chunked-encoded decoding
  126. check_http: segmentation fault (FreeBSD)
  127. check_dns: Update IF_RECORD to not erase query_found
  128. check_http: SSL Certificate check returns 12:00:00AM <local timezone>
  129. check_http: -u is misleading. Changed help text
  130. check_file_age: does not handle filenames with space
  131. check_snmp: units label option outputs the label in the incorrect location
  132. plugins-root/check_dhcp.c: fix a potential segfault
  133. check_users: not correctly detecting thresholds
  134. 2.1.3 2016-09-12
  135. ENHANCEMENTS
  136. SNI support in check_tcp (ddbilik)
  137. check_disk_smb.pl: add support for -k for kerberos authentication
  138. check_file_age.c: allow wildcard matching
  139. FIXES
  140. check_tcp.c: tools/build_perl_modules hardcodes the perl used
  141. check_game.c: reports ping as number of players (Jason Rivers)
  142. fix some gcc5 warnings (Mario Trangoni)
  143. check_cluster.c: Update wording in comments (Troy Lea)
  144. check_nagios.c: could not locate a running nagios process
  145. check_swap.c: does not accept threshold of zero
  146. check_swap.c: uses inconsistent checks on negative thresholds
  147. check_snmp.c: --offset does not appear to do anything (Troy Lea)
  148. sslutils.c: output has first line of "SSL Version: xxxxxx"
  149. effects anything using sslutils including check_http, check_dhcp
  150. and others
  151. utils_cmd.c: when using ssh (or check-by-ssh) with ControlMaster/ControlPersist,
  152. nagios times out the first time and one gets zombie processes (Gordon Messmer)
  153. 2.1.2 2016-08-01
  154. SECURITY FIXES
  155. ENHANCEMENTS
  156. check_snmp's performance data now also includes warning/critical
  157. thresholds
  158. New check_snmp "-N" option to specify SNMPv3 context name
  159. New check_nt "-l" parameters: seconds|minutes|hours|days
  160. New check_mailq -s option which tells the plugin to use sudo(8)
  161. New -W/-C option for check_ldap to check number of entries (Gerhard Lausser)
  162. The check_http -S/--ssl option now accepts the arguments "1.1" and "1.2"
  163. to force TLSv1.1 and TLSv1.2 connections, respectively
  164. The check_http -S/--ssl option now allows for specifying the desired
  165. protocol with a "+" suffix to also accept newer versions
  166. New check_disk "-v" option to show troubled partition in verbose mode
  167. check_log.sh: Added a parameter -w (--max_warning) defining upper value to return a warning code
  168. check_ldap: Add support for LDAP URIs.
  169. check_file_age: Provide performance data
  170. check_by_ssh: added --hostname support
  171. check_ifstatus.pl: Add check_ifstatus option to ignore interfaces by name
  172. check_snmp: Introduce support for SNMPv3 context using "-N" option
  173. check_snmp.c: Added IPv6 support
  174. check_http: Added support for checking SSL-Websites through Proxies
  175. FIXES
  176. check_dig can now also use "drill" instead of "dig"
  177. check_dig honor the -4 and -6 switches
  178. check_ntp_peer: do not use uninitialized results for max state
  179. check_log.sh, check_oracle.sh, check_sensors.sh: Setting PATH at first
  180. check_log.sh: dropping path from basename while evaluating PROGNAME
  181. check_tcp: Fix check_jabber to work with Openfire servers
  182. check_ifstatus.pl: Fix "-n" and "-u" options to ignore if either is set, not just both
  183. check_mrtgtraf: Fix perfdata to comply with perfdata UOM definition
  184. check_real, check_ntp: fix null termination
  185. check_apt: fix memset
  186. check_ssh: change warning to critical for protocol/version errors
  187. utils_cmd.c: avoid a segfault, if ulimit is set to unlimited
  188. utils_cmd.c: make constants from maxfd values
  189. configure.ac: Added particular ps command for HP-UX
  190. check_disk: Fix pthread start routine type
  191. check_http: Make header_value() and chunked-encoding decoding more robust
  192. check_http: fix Host header if explicitly set with -k
  193. sslutils.c: Forcing further restriction of ciphers for current security concerns
  194. check_nagios, check_procs: Enable check_proc to monitor processes in PID name-spaced environments.
  195. check_dhcp.c: use /dev/urandom if available
  196. check_http.c: Don't decode page if it's not there
  197. check_disk.c: Prevent large tide values from truncation
  198. pst3.c: Fix for unclosed filehandle in pst3 on Solaris
  199. check_snmp: Timeticks are not being parsed correctly before performance data
  200. multiple *.h files: standardized header include fences
  201. multiple plugins/*.c files: fix unsafe signal handling
  202. sslutils.c: Fix compilation with GnuTLS which doesn't provide SSL_CTX_check_private_key()
  203. check_mailq.pl: fixed mailer names
  204. check_swap.c: Improving output when swap space has zero size
  205. check_icmp.c: Use kernel reception time on ICMP packets to compute rtt.
  206. check_icmp.c: make use of MSG_CONFIRM optional
  207. check_ldap.c: add counting of entries to check_ldap
  208. utils.c: add sperfdata() function which can handle threshold ranges
  209. sslutils.c: Check if OpenSSL supports SSLv3.
  210. check_dhcp.c: Fixes segfaults when running via monitoring worker (off-by-one)
  211. check_fping.c: autodetect ipv6 addresses
  212. sslutils.c: optimize output if certificate expires in less then 24h
  213. check_smtp.c: Let "-D" option imply "-S". Also QUIT SMTP connection when "-D" is used
  214. check_smtp.c: modified SSL check for use with -e
  215. check_tcp.c: Validate sent data size
  216. check_dns.c: conditional assignment
  217. check_dns.c: macro querytypes and auto cnames
  218. utils_cmd.c, utils_base.c: Multiple resource leaks
  219. check_http.c: Increase MAX_RE_SIZE from 256 to 2048
  220. check_procs.c: Changed the ps command args from axwo to axwwo allowing for longer output
  221. check_http.c: Allow a server to reply using only 'HTTP/1.x 200 OK' and a
  222. body, with no headers
  223. check_nt.c: check_nt does not correctly report a DNS entry it cannot resolve
  224. check_dhcp.c: check_dhcp broken on BSD
  225. TESTS
  226. check_procs.t: Add delay after forking in test to avoid race condition
  227. test.pl.in: Use "C" locale when running test suite
  228. check_http.t: Adjust date strings to the now-localized output
  229. check_dns.t - Fix Perl Warning. perl doesn't understand /d within "".
  230. check_snmp.t: skip extended snmp tests if snmpd has no perl support
  231. check_snmp.t: fix snmp test for included threshold
  232. check_http.t: fix tests for certificates expire date with seconds
  233. check_http.t: add faketime based tests for check_http
  234. LOCALIZATION
  235. 2.1.0 30th July 2015
  236. SECURITY FIXES
  237. ssl_utils.c - Disable SSLv3 & SSLv2 autonegotiation by default to limit poodle and other weak cipher attacks (sreinhardt)
  238. ENHANCEMENTS
  239. Timeout States Implemented - Plugins that support a timeout state will now also support specifying the exit state in case of timeout with the syntax -t <timeout>:<state> (abrist)
  240. Perl plugins now use FindBin for path discovery, obsoleting the nasty AWK script (evgeni, abrist)
  241. check_http.c - Added support for chunked transfer-encoding (koenwtje, dermoth, sreinhardt)
  242. check_radius.c - Added support for the FreeRADIUS Client library (weiss)
  243. check_snmp.c - Added thresholds to performance data (seemuellera)
  244. check_snmp.c - Added new option (-N) for SNMPv3 context (Johannes Engel)
  245. check_snmp.c - Added IPv6 support (abrist)
  246. check_ldap.c - Added a new option (-U) for LDAP URI support (qris)
  247. check_ifstatus.pl - Added new option (-n) to exclude interfaces (peelman, weiss)
  248. check_file_age.pl - Performance data output added (hggh)
  249. check_mailq.pl - Now supports sudo (Christopher Schultz, weiss)
  250. check_log.sh - Added a new option (-w) defining upper value to return a warning code (arvanus)
  251. FIXES
  252. check_by_ssh.c - Added --hostname support (sni)
  253. check_dbi.c - Spelling corrections (sreinhardt)
  254. check_dig.c - Fixed to work with dig/drill tools and ip version switch is now respected (abgandar)
  255. check_disk.c - Fix for hanging filesystems (Gerhard Lausser)
  256. check_disk.c - Partitions in problem state now reported in verbose mode (waja)
  257. check_disk.c - Prevent large tide values from truncation (JesperForsberg)
  258. check_dns.c - Server specific fixes and other cleanup (sreinhardt)
  259. check_http.c - Some small changes for readability (koenwtje)
  260. check_mrtgtraf.c - Added verbose output (sreinhardt)
  261. check_mrtgtraf.c - Perfdata now complies with UOM definition (Bobzikwick)
  262. check_ntp_peer.c - No longer uses uninitialized results for max state (sni)
  263. check_procs.c - Rare race condition fixed (Mikael Falkvidd)
  264. check_ssh.c - Now exits with CRITICAL when version/protocol string check fails to match (sni)
  265. check_tcp.c - Help description of escape characters now correct (Sebastian Herbszt)
  266. check_tcp.c - Fix to support Openfire servers with check_jabber (weiss)
  267. check_ups.c - Spelling corrections (sreinhardt)
  268. pst3.c - Fix for unclosed file handle in pst3 on Solaris (jwinkle01)
  269. plugins-scripts/*.sh - Trusted path fixes (waja)
  270. netutils.h - Decreased max path to 104 bytes to compensate for BSD paths (sreinhardt)
  271. configure.ac - Fix for HP-UX ps command (Tontonitch)
  272. lib/utils_cmd.c - Fix for potential segfault when ulimits are set to unlimited (nafets)
  273. lib/parse_ini.c - Many small fixes from coverity scans and the community (sreinhardt, weiss)
  274. lib/util_base.c - Code cleanup (sreinhardt)
  275. lib/utils_base.c - Add EIUD to state retention path for multi-user permissions support (sreinhardt)
  276. po/* - Spelling corrections (sreinhardt)
  277. Multiple resource leaks fixed (sreinhardt)
  278. Many other small fixes and cleanup caught by coverity (multiple contributors)
  279. TESTS
  280. Many small fixes to tests (multiple contributors)
  281. LOCALIZATION
  282. Many small fixes for locales and localizations (multiple contributors)
  283. 2.0.3 26th June 2014
  284. SECURITY FIXES
  285. parse_ini.c - Additional fixes for the SUID plugins vulnerabilities (sreinhardt)
  286. Added Gnulib module idpriv-droptemp (weiss)
  287. FIXES
  288. check_dns.c - Resolved issues with reverse lookup (sreinhardt)
  289. check_dns.c - Changed query types from ALL to ANY (sreinhardt)
  290. common.h - Include fixes for esoteric AIX compile issues (emislivec)
  291. negate.c - Small fixes from coverity (66479) (66480) (sreinhardt)
  292. check_dhcp.c - Small fix from coverity (66488) (sreinhardt)
  293. check_http.c - Potential memory leak and overflow fixed from coverity (66514) (sreinhardt)
  294. check_ntp.c - Small fix from coverity (66524) (sreinhardt)
  295. utils_cmd.c - Small file descriptor fix from coverity (66502) (sreinhardt)
  296. check_apt.c - Small fix for from coverity (66531) (sreinhardt)
  297. REVERTS
  298. check_mailq - Reverted autodetection commits to avoid awk parsing issues. Autodetection will return in version 2.1.0 as part of the changes in the FindBin branch (abrist)
  299. 2.0.2 20th May 2014
  300. SECURITY FIXES
  301. Fixed file access vulnerability with SUID binaries (check_icmp, check_dhcp) and extra-opts. Fixes were applied globally, so the new resrictions on fopen should apply to all plugins. Special thanks to Dawid Golunski for the submission. More information: http://www.exploit-db.com/exploits/33387/ (sreinhardt) (emislivec)
  302. ENHANCEMENTS
  303. check_disk - Now compiles in cygwin on windows (Gunnar Beutner)
  304. check_ping - Now compiles in cygwin on windows (Gunnar Beutner)
  305. check_users - Now compiles in cygwin on windows (Gunnar Beutner)
  306. netutils.c - Connection error verbosity increased. C plugins will now differentiate file socket errors from connection errors (Davide Madrisan)
  307. FIXES
  308. check_nt.c - Changed 'Mb' to 'MB' in MEMUSE output for clarity (abrist)
  309. 2.0.1 15th April 2014
  310. ENHANCEMENTS
  311. check_snmp.c - Added thresholds to performance data (jccomputing)
  312. check_http.c - Added */* MIME support (Alex Gottschalk)
  313. check_mailq.pl - Added autodetection for mailq implementation (evgeni)
  314. check_mailq.pl - Added autodetected version to output (evgeni)
  315. FIXES
  316. check_dns.c - Record type corrections for default check (sreinhardt)
  317. utils.c - Changed comment type - now supported by AIX and should no longer fail compile (hkpatv)
  318. check_uptime.c - Fixed timeout option (abrist)
  319. check_uptime.c - Fixed help output and updated verbose usage (abrist)
  320. check_uptime.c - Removed executable permissions on check_uptime.c (abrist)
  321. check_uptime.c - Removed old code (Davide Madrisan)
  322. check_pgsql.c - Fixed help output (weiss)
  323. lib/Makefile.am - Avoid deprecated includes (Davide Madrisan)
  324. lib/tests/Makefile.am - Avoid deprecated includes (Davide Madrisan)
  325. plugins/Makefile.am - Avoid deprecated includes (Davide Madrisan)
  326. check_apt.c - Removed the verbose flag suggestion (skottler)
  327. check_oracle.c - Changed regex to compensate for tns string match edge cases (waja)
  328. check_snmp.c - Always privides the security name when noAuthPriv is specified (catharsis)
  329. 2.0 4th March 2014
  330. ADDITIONS
  331. check_uptime - New plugin (only supports linux due to dependency on clock.gettime(). More supported platforms to follow.
  332. ENHANCEMENTS
  333. check_mysql_query - Added performance data (sreinhardt)
  334. check_file_age - New option -i/--ignore-missing which returns OK if file is missing (waja)
  335. check_nt - Added performance data to UPTIME -l seconds|minutes|hours|days (abrist)
  336. check_hpjd - New -p option for port specification (abrist)
  337. check_disk - new -n option for multi-line output (tmcnag)
  338. check_mysql_query - New -f/-g options for reading for mysql options file (awiddersheim)
  339. check_mailq - New -M option for nullmailer support in the mailserver (Luca Corti)
  340. check_dig - New -r option for specifying number of retries (abrist)
  341. check_ntp_peer - Added state output for each checked metric (abrist)
  342. check_dns - Warning and critical thresholds added to perfdata (jccomputing) (abrist)
  343. check_dns - New -q options for several query types (AAAA,TXT,SRV,MX) (sreinhardt)
  344. check_tcp - Status output now includes hostname when host_specified is set (madrisan)
  345. check_mysql - New -n/--ignore_auth option to ignore authentication failure (Julius Kriukas)
  346. check_ssh - New -P/--remote-protocol option to monitor the ssh protocol version (monitoring-user)
  347. check_ntp - New -o/--time-offset option to compensate for the ntp server's offset relative to the local server (monitoring-user)
  348. configure.ac - Added support for --disable-maintainer-mode (weiss)
  349. FIXES
  350. check_http - The -C option no longer resets SSL version if e.g. -S 1 -C 5 is specified
  351. check_ide_smart - Now defaults to nagios-compatible output (sreinhardt)
  352. Fixed misleading timeout message for non-network plugins (sreinhardt)
  353. check_swap - Now fails with 100% usage and a new status output when swap is disabled or missing (abrist)
  354. check_ifstatus - Removed commas from perfdata - should now output valid perfdata in nagios format (waja)
  355. check_ping - Now gracefully handle the "time of day goes back" error. This issue is rare, most will not notice the change (waja)
  356. check_disk - Help output was clarified that it supports mount paths or partitions instead of just paths and partitions (waja)
  357. check_ide_smart - Fixed attribute comparison (waja)
  358. check_ntp_time - Fixed average time calculation (larsi)
  359. NPTest.cache - Empty or Missing file no longer blocks writing to the file (dermoth)
  360. parse.ini - Fixed newlines in output (dermoth)
  361. check_dig - Fixed wrong IPv6 arguments order (Stéphane Bortzmeyer)
  362. check_dig - Now honors timeout value specified by switch -t (Jethro Carr) (abrist)
  363. configure.in - Renamed to configure.ac to avoid deprecation warning (abrist)
  364. configure.ac - The option --enable-extra-opts is now enabled by default (dermoth)
  365. check_snmp - Now handles negative values properly (Stephane Lapie)
  366. WARNINGS
  367. check_procs - Now ignores its parent process to avoid unexpected results when invoked via certain shells
  368. utils.sh - No longer defines ECHO (weiss)
  369. check_ide_smart now default to nagios output, -n kept for legacy support (sreinhardt)
  370. check_ntp_peer - Status output changed, now includes individual state for offset, truechimers, stratum, and jitter (abrist)
  371. check_tcp - Status output has changed, now includes hostname (madrisan)
  372. TESTS
  373. check_procs - Performance data tests added (dermoth)
  374. check_snmp - Added tests for negative thresholds (dermoth)
  375. check_hpjd - Added tests for port options (abrist)
  376. check_dns - Added new tests for query types (abrist)
  377. check_pop - Added option to enable ssl for the test (abrist)
  378. check_jabber - Fixed status output tests to account for hostname (abrist)
  379. check_procs - Tests no longer fail if uid 501 is not present (sni)
  380. check_mysql - Test prompts clarified (dermoth)
  381. check_file_age - Added tests for --ignore-missing (waja)
  382. OTHER
  383. Numerous small typos fixed.
  384. Help output has been changed in many places for clarity and verbosity.
  385. 1.5 2nd October 2013
  386. ENHANCEMENTS
  387. New check_dbi plugin for checking an (SQL) database using DBI
  388. Let OpenSSL load its configuration file (see the OPENSSL_config(3) man page)
  389. Add performance data to check_apt
  390. Add performance data to check_procs
  391. Added -4/-6 options to check_dig (Ville Mattila)
  392. New check_oracle --connect option to perform real login
  393. New check_nagios -t option to override the default timeout
  394. New check_disk -f/--freespace-ignore-reserved option to ignore space reserved for root
  395. New check_disk -N/--include-type option to limit the filesystem types to check
  396. Allow for building the plugins in parallel
  397. Add --without-{dbi,ldap,radius} options to ./configure
  398. Made Verbose output of check_sensors compliant (Gabriele Tozzi)
  399. New switch -E/--extended-perfdata for check_http to print additional performance data (Sebastian Nohn)
  400. New check_http -d option to specify a string to expect within the response headers
  401. New check_http -J/-K options for client certificate authentication support
  402. Add support for executing queries to check_pgsql
  403. Let check_pgsql accept a UNIX socket directory as hostname
  404. New check_pgsql -o option to specify additional connection parameters
  405. New check_fping -S option to specify the source IP address
  406. New check_fping -I option to specify the interface to bind to
  407. Let check_fping support IPv6
  408. New check_procs -k option to ignore kernel threads (on Linux)
  409. Let check_procs use /proc/<PID>/exe (if available) instead of getpid(2), unless -T is specified
  410. Let check_mysql support SSL
  411. Let check_mysql add performance metrics for all checks
  412. New check_mysql -f option to specify a client options file
  413. New check_mysql -g option to specify a client options group
  414. New check_snmp --offset option to allow for adding/subtracting an offset value to sensor data
  415. Let check_snmp support an arbitrary number of OIDs
  416. Let check_ide_smart support NetBSD
  417. FIXES
  418. Change the MAIL FROM command generated by check_smtp to be RFC compliant
  419. Fix compilation of check_http without SSL support
  420. Fix check_snmp reversed threshold ranges (backward-compatibility)
  421. Fix check_snmp memory violation when using more than 8 oids (Robin Sonefors)
  422. Fix check_apt security regular expression (Alex Bradley)
  423. Fix check_http handling extra header (-k) containing semicolons (Richard Leitner)
  424. Fix check_apt handling unknown exit codes from apt-get (Richard Leitner)
  425. Fix deprecated imports of check_nmap.py (Fabio Rueda)
  426. WARNINGS
  427. check_http behaviour of -k/--header changed since it does not separate multiple headers by semicolons anymore. Use multiple -k switches instead.
  428. check_http's --proxy_authorization option is now called --proxy-authorization (it was always documented this way)
  429. The contrib directory has been removed from this distribution
  430. 1.4.16 27th June 2012
  431. ENHANCEMENTS
  432. check_nt UPTIME accepts warning/critical thresholds (Ryan Kelly)
  433. check_disk_smb now allows spaces in share names (#990948, #1370031, Debian #601699)
  434. check_http now uses standard threshold functions (enables floating point and ranges)
  435. check_http now checks for and prints the certificate cn (hostname) in SSL certificate checks (Stéphane Urbanovski)
  436. check_http now supports an optional -S/--ssl value to choose the SSL protocol version (#3066166 - Jason Lunn)
  437. Add perfdata to check_ssh (#3244097 - Marco Beck)
  438. New option to check_smtp to ignore failures when sending QUIT (#3358348 - Duncan Ferguson)
  439. New check_by_ssh -F option which allows for specifying an alternative ssh_config(5) file (#2895334 - Sven Nierlein)
  440. check_sensors now detects faulty sensors unless --ignore-fault is specified (Jan Wagner)
  441. utils.sh now provides a check_range function (Alex Griffin)
  442. Improved the performance of check_users (Marc Remy)
  443. Add perfdata to check_disk_smb (Debian #654259 - Charles-Henri Larose)
  444. Updated Nagios::Plugin perl module
  445. Add warning threshold to certificate expiration checks of check_tcp/http/smtp (William Leibzon)
  446. Add --perf-oids option for check_snmp (Jochen Bern)
  447. FIXES
  448. Fix check_disk free space calculation if blocksizes differ within a disk group (Bekar - #2973603)
  449. check_disk_smb now handles NT_STATUS_ACCESS_DENIED properly (Debian #601696)
  450. Make check_snmp work more like v1.4.14 with regard to using special values (Timeticks, STRING) as numeric thresholds
  451. Fix check_ldap overriding the port when --ssl was specified after -p
  452. Fix check_procs where regex input of '|' would get displayed in output - now replaced with ','
  453. Fix segfault in check_host when hostname returns multiple IP addresses (Sebastian Harl)
  454. Fix check_smtp and check_tcp where duplicate messages were displayed for certificate errors
  455. Fix check_ping's parsing of ping6(1) output (#1894850, Debian #514588, Debian #662638 - Matej Vela)
  456. Fix a check_dhcp bug which was triggered by checking Windows 2003 DHCP servers (#3503921)
  457. Disable RFC4507 support, to work around SSL negotiation issues with (at least) some Tomcat versions
  458. Fix performance data label containing spaces in check_snmp (Jochen Bern)
  459. 1.4.15 27th July 2010
  460. ENHANCEMENTS
  461. New check_ntp_peer -m and -n options to check the number of usable time sources ("truechimers")
  462. New check_disk_smb -a option which allows for specifying the IP address of the remote server
  463. New check_radius -N option which allows for specifying the value of the NAS-IP-Address attribute
  464. New check_snmp --rate option to store differences between invocations. Saves state in PREFIX/var/{plugin}
  465. check_snmp -l label option now also changes the perfdata label. See WARNINGS
  466. check_snmp has an --invert-search option which reverses status of the string and regexp searches
  467. check_http now displays the missing search string and the URL in the output when failed (Duncan Ferguson - #2999924)
  468. Updated Nagios::Plugin perl module
  469. Updated gnulib to June 2010
  470. FIXES
  471. Fix check_ircd binding to wrong interface (#668778)
  472. Add proxy-authorization option to check_http (Marcel Kuiper - #1323230, Bryan Irvine - #2863925)
  473. check_icmp now increment the sequence counter in each packet
  474. Fix usage of repeated -o options in check_snmp
  475. Try to detect arguments passed via --with-ping[6]-command and set options accordingly (#2908236)
  476. Fix memory leak in check_http for large pages (Jimmy Bergman - #2957455)
  477. Fix compilation with GCC 2.96 (Konstantin Khomoutov - #2977105)
  478. Fix regression introduced in #1867716 where partially valid performance strings would not be printed anymore
  479. Fix regression in check_http ssl checks on some servers - make SNI an option
  480. Fix guest mode support in check_disk_smb
  481. Fix check_disk_smb and check_ircd failures when run via ePN
  482. check_ldap now allows for specifying an empty LDAP base
  483. Fix compilation error of pst3 in Solaris 8
  484. Fix check_radius returning OK on unexpected results (Craig Leres - #2911752)
  485. Fix translations when extra-opts aren't enabled (Jan Wagner - #2832884)
  486. Fix parsing of multi-line strings in check_snmp (broken in 1.4.14) and enhance output in such case (#2832451)
  487. Fix detection of pst3 64-bit compile flags with Sun CC
  488. Fix cmd_run overwriting the environment, which would break some commands that needed it
  489. Allow check_ifstatus to accept version=2c - used to only allow version=2 (Brian Landers)
  490. Fix examples in check_disk, where it implied was possible to suffix unit values to warn/crit parameters
  491. WARNINGS
  492. Updated developer documentation to say that performance labels should not have an equals sign or
  493. single quote in the label
  494. check_http 1.4.14 introduced SSL SNI support - you now have to enable it explicitly with "--sni"
  495. check_snmp -l label option is also used for the performance label. This could change history from previous uses
  496. 1.4.14 16th September 2009
  497. check_http has options to specify the HTTP method (#2155152)
  498. check_users thresholds were not working exactly as documented (>= rather than >)
  499. Updated tinderbox_build script to point to new tinderbox server
  500. check_ifoperstatus -n flag now works as expected (sf.net #1569488)
  501. check_ifoperstatus now supports ifType based lookup for ifIndex
  502. check_ups now sends a LOGOUT string (debian bug #387001)
  503. Extra-opts (C plugins) now allows both '#' and ';' for comments (like N::P)
  504. Extra-opts (C plugins) does not allow trailing comments anymore (like N::P)
  505. Fixed dependency issue on libtap when ./configure --enable-libtap used. Warning: will install libtap
  506. Fixed segfault in extra-opts under some circumstance when reading multiple sections
  507. Fix long options parsing in check_disk, check_dns, check_mrtg, check_mrtgtraf and check_tcp
  508. Add missing long options for check_nt (for use with extra-opts)
  509. check_icmp now reports min and max round trip time perfdata (Steve Rader)
  510. Fixed check_http bug where additional headers with redirection caused a segfault (Dieter Van de Walle - 2089159)
  511. check_disk: make autofs mount paths specified with -p before we determine the mount list (Erik Welch)
  512. Fixed buffer overflow in check_ntp/check_ntp_peer (#1999319, Ubuntu #291265)
  513. 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
  514. Fixed check_mrtg returning UNKNOWN instead of OK (bug #2378068)
  515. Fixed check_http behaviour: all check are now performed as long as a valid response is returned (sf.net #1460312)
  516. check_http --onredirect=sticky follows using the same IP address (sf.net #2550208)
  517. check_http --onredirect=stickyport also follows the same port
  518. Fixed coredump from check_nt when invalid drive is specified (#2179754 - Olli Hauer)
  519. Fixed crash from check_nt when -H unspecified or given multiple times (sf.net #2731755, debian #521097)
  520. Fixed passing of quotes in OID for check_snmp (#1985230 - Jan Wagner, patch by John Barbuto)
  521. Fixed check_http sending HTTP/1.0 with v1.1 headers (#2638765)
  522. Fixed check_http not timing-out on redirects
  523. Fixed negate not printing the real timeout in ALRM handler when left to default
  524. negate timeout result is now configurable
  525. Fixed segfault in check_mysql with old slaves (#2696823 - Oskar Ahner)
  526. check_nt can return UNKNOWN on timeouts (-u)
  527. Fixed typos for check_disk (Chris Pepper)
  528. Fixed check_mysql* not using password set in my.cnf (#2531905 - Ben Timby) - Specify an empty password explicitly if you need to override it.
  529. Fixed awk subst.in/subst script path error (#2722832 - Martin Foster)
  530. check_http: Add SSL/TLS hostname extension support (SNI) - (#1939022 - Joe Presbrey)
  531. Fixed wrong perfdata label for output traffic in check_mrtgtraf (#2654308 - Gavin Williams)
  532. Fixed check_by_ssh interpretation of quotes in -C parameter (#1985246, #2268675)
  533. check_snmp now supports standard threshold ranges and doubles (floating numbers) in thresholds
  534. check_fping now supports passing target timeout and interval to fping (#2347686 - Martin Foster)
  535. Fixed SNMPv3 behaviour of check_ifoperstatus and check_ifstatus. Added -P to define privprotocol (#2343438 - Robin Schroeder)
  536. check_ifoperstatus and check_ifstatus are now more user-friendly in case of missing arguments
  537. pst3 compile fix for Sun Studio Compiler (Grant Byers)
  538. 1.4.13 25th Sept 2008
  539. Fix Debian bug #460097: check_http --max-age broken (Hilko Bengen)
  540. Optimised pst3 for systems with large number of processes (Duncan Ferguson)
  541. Updated Nagios::Plugin to 0.27
  542. Fix Debian bug #479013: check_dig's -l is mandatory now (sf.net #1986306)
  543. check_dig now returns CRITICAL instead of WARNING when no answer section is found
  544. check_procs now captures stderr in external command and adds to plugin output
  545. check_snmp now only prints perfdata for non numeric values (#1867716)
  546. check_icmp now supports packet size modification
  547. check_http -e now accepts a comma-delimited list of expected status codes (Sven Nierlein)
  548. libtap now included with this distribution for easier testing. Run ./configure with --enable-libtap
  549. check_ntp_peer/check_ntp_time used to show port in --help but ignored the argument - now implemented
  550. Fix possible segfault in check_ntp_peer with deliberately invalid packets
  551. 1.4.12 27th May 2008
  552. Added ./check_nt -v INSTANCES to count number of instances (Alessandro Ren)
  553. New check_icmp -s option to specify the source IP address
  554. check_dns now sorts addresses for testing results for more than one returned IP (Matthias Urlichs)
  555. Fix segfault in check_ntp_time and (deprecated) check_ntp (Bug #1862300)
  556. check_disk should now work with large file systems (2TB+) on all archs that supports it
  557. Fixed check_disk disk usage calculation when using --group=NAME (related to bug #1348746)
  558. Fix help text of check_ntp* (Bug #1880095)
  559. Fix bugs and flaws in best offset server selection of check_ntp_time and (deprecated) check_ntp
  560. check_ntp_peer now checks for the LI_ALARM flag
  561. Sync to latest Gnulib (includes new floorf function)
  562. check_pgsql now successfully builds with postgres lib v8.3 (Bug #1878972)
  563. check_procs now accepts --ereg-argument-array for a regular expression match to the argument array
  564. Reverted back to using pst3 for Solaris systems. Fixed issues re: -m64 needed to compile on 64bit systems
  565. If applicable, Gettext linked dynamically instead of statically
  566. check_dig can now pass arguments to dig by using -A/--dig-arguments (#1874041/#1889453)
  567. check_ntp and check_ntp_peer now show proper jitter/stratum thresholds longopts in --help
  568. check_dns now allow to repeat -a to match multiple possibly returned address (common with load balancers)
  569. check_mysql and check_radius now try clearing password in processlist just like check_mysql_query
  570. check_mysql and check_mysql_query now support sockets explicitly (-s, --socket)
  571. negate now has the ability to replace the status text as well (-s, --substitute)
  572. Added performance data to check_ping (Christian Schneemann)
  573. Added support for --extra-opts in all C plugins (disabled by default, see configure --help)
  574. Fixed passive option in check_by_ssh
  575. On non-skipped stderr, check_by_ssh now returns UNKNOWN or worse (result from command) instead of always UNKNOWN.
  576. Fix linking against OpenSSL where libdl is required
  577. 1.4.11 13th December 2007
  578. Fixed check_http regression in 1.4.10 where following redirects to
  579. relative URLs on virtual hosts failed if both "-H" and "-I" were used
  580. Merged two new checks that deprecates check_ntp: check_ntp_peer and check_ntp_time.
  581. You should read the --help output so see which one is suitable for you. check_ntp_peer
  582. implement stratum thresholds support (feature request #1703823).
  583. check_ntp now returns UNKNOWN instead of WARNING if jitter is unavailable (jitter=-1.000000)
  584. as long as the thresholds range include -1. If no offset threshold is specified
  585. and the offset is unavailable, will return UNKNOWN as well.
  586. NOTE: If jitter thresholds are specified as integers it will return CRITICAL if jitter
  587. is "-1" as the default range starts at 0. See Examples in --help output.
  588. Fixed broken usage2 in check_snmp and check_cluster
  589. check_cluster now accepts all valid characters in its thresholds ("-", "@", "~")
  590. Fixed check_disk reporting OK if disk usage grows over 100% (bug #1348746).
  591. The problem happens to be in Gnulib but a workaround have been implemented in check_disk.c
  592. Fixed check_load argument handling when not passing triplets (bug #1831890)
  593. Fixed buffer overflow in check_snmp (CVE-2007-5623)
  594. Tinderbox builds now runs tests in a verbose mode
  595. Updated Nagios::Plugin to 0.22
  596. VPATH problem fixed for compiling plugins-root
  597. 1.4.10 28th September 2007
  598. Fix check_http buffer overflow vulnerability when following HTTP redirects (CVE-2007-5198)
  599. check_http now explicitly asks HTTP/1.1 servers to close the connection
  600. after completion of the response
  601. Check_ldaps' guessing which secure method to use (starttls vs. ssl on connect)
  602. is now deprecated. See --help for further information.
  603. Check_disk now calls stat() on all filesystems to check. (Old: only the ones selected using -p)
  604. A meaningful error message (eg "Stale NFS Handle") is printed if stat fails.
  605. New check_disk option -L: Only check local filesystems, but call stat() on remote ones, too.
  606. Thus accessibility of remote filesystems can be checked without any threshold comparison.
  607. Check_disk's --help now prints some examples for the new features introduced in 1.4.8
  608. New check_disk -i/-I option to ignore paths/partitions based on regular expressions
  609. New check_disk -A option to select all filesystems explicitly
  610. WARNING: check_disk's -E option must now be passed before -p or -r/-R arguments
  611. Passing -E after -p or -r results in UNKNOWN state, now
  612. This is needed due to the new ignore feature
  613. Fix check_disk bug when mixing case sensitive and case insensitive regex arguments
  614. New check_dhcp -u/--unicast option for emulating a DHCP relay in order
  615. to check DHCP servers on remote networks
  616. New check_dhcp -m/--mac option which allows for specifying the MAC
  617. address to use in the DHCP request
  618. The check_dhcp -r and -s options now accept host names, too
  619. Fix possible check_icmp bus errors on some (non-x86/AMD64) platforms
  620. Fix check_smtp's handling of multiple-packet server responses
  621. WARNING: Fix for negate which may break existing commands:
  622. - stop evaluating command line options through shell twice
  623. - enforce a full path for the command to run
  624. The "negate" utility can now remap custom states
  625. Check_radius now supports radiusclient-ng
  626. The (undocumented) positional parameter parsing which check_radius used
  627. instead of getopt(3) if 8 arguments were given is no longer available
  628. Check_by_ssh now supports multiline output
  629. IPv6 support can now be disabled using ./configure --without-ipv6
  630. Fix check_ntp now honor ntp flags
  631. 1.4.9 4th June 2007
  632. Inclusion of contrib/check_cluster2 as check_cluster with some improvements
  633. New/improved -E/--skip-stderr and -S/--skip-stdout options for check_by_ssh
  634. check_snmp now supports Counter64
  635. Fix compilation of check_ldap, check_radius and check_pgsql
  636. check_load can optionally divide by number of cpus
  637. Fix check_time returning wrong OK when time is before the epoch on some arch
  638. Make check_http output more consistent
  639. Fix possible check_http segfaults when following HTTP redirects
  640. check_snmp don't warn anymore if something is printed on stderr
  641. Fix check_tcp segfault when multiple expect strings are given
  642. New option for check_tcp: -A/--all to test if all given expect strings match
  643. 1.4.8 11th April 2007
  644. Respects --without-world-permissions for setuid plugins
  645. check_disk extra options for regex matching of filesystems and grouping of filesystems
  646. for collective thresholds
  647. Better configure test for mysqlclient availability
  648. Various check_ntp fixes
  649. 1.4.7 29th March 2007
  650. check_procs uses /usr/ucb/ps if available - fixes pst3 problems on Solaris
  651. Fixed MKINSTALLDIRS problem in po/
  652. ./configure now detects if possible to compile check_mysql
  653. Fixed broken HELO in check_smtp
  654. check_icmp now allows to set a minimum number of hosts required for successs (-m)
  655. check_icmp fix for *BSD when running for long time
  656. check_ping times out 1 second quicker if host is unreachable
  657. Root plugins installed with world executable
  658. check_sybase from contrib now maintained in NagiosExchange
  659. --with-nagios-user/group reinstated ./configure option
  660. New --without-world-permissions ./configure option
  661. 1.4.6 5th February 2007
  662. Reduced number of DNS lookups in check_ping and netutils.c for IPv6 configurations
  663. Fixed compile problems with *BSD re: alloca.h
  664. Fixed Solaris problems with check_swap (tested on Solaris 9)
  665. Fixed check_swap for HP/UX where swapinfo command was incorrect
  666. Fixed check_disk inode threshold checks, regressed at r1.4.4.
  667. Fixed crit/warn for check_disk perf data
  668. Fixed buffer overflow in check_procs
  669. Fixed error handling for UNIX sockets in netutils.c
  670. New -q and -o options for check_by_ssh which are handed over to ssh(1) as is
  671. Synced with latest GNUlib
  672. Fixed check_jabber always returns warning
  673. 1.4.5
  674. Fixed bug in perl's is_hostname routine
  675. 1.4.4
  676. New C based check_ntp. The perl version is now deprecated.
  677. New check_apt plugin
  678. Notice: plugins in contrib/ will start to be removed from this distribution.
  679. Please check at http://www.nagiosexchange.org for contributed plugins
  680. Major bug fixes to check_disk where values were incorrectly calculated and alerted on.
  681. check_udp2 removed. check_udp is now linked to check_tcp.c
  682. check_mailq now errors if the sub-program run returns non-zero return code. This would appear
  683. as if mailqs were okay when the nagios user could not query the mail-queues
  684. Compile problems with check_snmp fixed
  685. 1.4.3
  686. Setuid plugins (check_dhcp, check_icmp) separated into plugins-root/. Run make install as root to install
  687. SSL plugins work with gnutls as well as OpenSSL
  688. check_mysql_query added to run arbitrary SQL commands, with threshold checking
  689. libtool now required for development systems
  690. Notice: check_udp (compiled from check_udp.c) will be deprecated in the next release.
  691. check_udp2 should be used instead and will be renamed to check_udp
  692. 1.4.2
  693. Fix for Redhat ES4 for check_dns and check_dig
  694. 1.4
  695. IPv6 support in check_ping, check_by_ssh, check_http, check_ldap, check_smtp, check_tcp
  696. Internationalisation support
  697. Performance data added to most plugins
  698. check_disk now using GNU coreutils code
  699. New plugins - check_dhcp, check_icmp
  700. contrib/check_citrix has been replaced by contrib/check_ica* (requires packet_utils.pm in libexec)
  701. check_http --min changed to --pagesize, added max so min:max in check
  702. check_vsz and check_rss deprecated - functionality moved into check_procs
  703. check_swap % thresholds changed to measure amount free, instead of amount used
  704. check_disk syntax changes for -p, -m/-M, defaults to MB instead of kB
  705. check_procs -C expects no path for the command name