|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| build-aux/ | H | 11-Mar-2020 | - | 15,811 | 12,137 |
| config_test/ | H | 11-Mar-2020 | - | 122 | 74 |
| gl/ | H | 03-May-2022 | - | 88,593 | 69,055 |
| lib/ | H | 03-May-2022 | - | 7,967 | 6,438 |
| m4/ | H | 11-Mar-2020 | - | 136 | 123 |
| perlmods/ | H | 03-May-2022 | - | 3,082 | 2,933 |
| pkg/ | H | 16-Jan-2017 | - | 223 | 197 |
| plugins/ | H | 03-May-2022 | - | 36,103 | 27,227 |
| plugins-root/ | H | 03-May-2022 | - | 5,972 | 4,826 |
| plugins-scripts/ | H | 03-May-2022 | - | 7,248 | 5,645 |
| po/ | H | 03-May-2022 | - | 21,162 | 16,698 |
| tap/ | H | 03-May-2022 | - | 2,240 | 1,922 |
| tools/ | H | 11-Mar-2020 | - | 873 | 586 |
| ABOUT-NLS | H A D | 16-Jan-2017 | 78.7 KiB | 1,112 | 1,065 |
| ACKNOWLEDGEMENTS | H A D | 16-Jan-2017 | 1.2 KiB | 34 | 24 |
| AUTHORS | H A D | 04-Dec-2019 | 417 | 27 | 25 |
| CODING | H A D | 04-Dec-2019 | 4.8 KiB | 152 | 101 |
| COPYING | H A D | 16-Jan-2017 | 34.3 KiB | 675 | 553 |
| ChangeLog | H A D | 11-Mar-2020 | 869.7 KiB | 23,180 | 13,239 |
| FAQ | H A D | 16-Jan-2017 | 3.6 KiB | 109 | 71 |
| INSTALL | H A D | 11-Mar-2020 | 15.2 KiB | 366 | 284 |
| LEGAL | H A D | 16-Jan-2017 | 443 | 11 | 7 |
| Makefile.am | H A D | 04-Dec-2019 | 2.1 KiB | 66 | 45 |
| Makefile.in | H A D | 03-May-2022 | 65.6 KiB | 1,951 | 1,846 |
| NEWS | H A D | 11-Mar-2020 | 45.3 KiB | 789 | 724 |
| NP-VERSION-GEN | H A D | 11-Mar-2020 | 1.1 KiB | 56 | 32 |
| NPTest.pm | H A D | 04-Dec-2019 | 17.1 KiB | 673 | 350 |
| README | H A D | 04-Dec-2019 | 5.3 KiB | 150 | 103 |
| REQUIREMENTS | H A D | 16-Jan-2017 | 3.2 KiB | 98 | 77 |
| SUPPORT | H A D | 16-Jan-2017 | 3.8 KiB | 101 | 72 |
| THANKS | H A D | 04-Dec-2019 | 6.1 KiB | 421 | 419 |
| acinclude.m4 | H A D | 16-Jan-2017 | 2.3 KiB | 78 | 66 |
| aclocal.m4 | H A D | 11-Mar-2020 | 41.2 KiB | 1,170 | 1,067 |
| config.h.in | H A D | 11-Mar-2020 | 76.3 KiB | 2,518 | 1,764 |
| config.rpath | H A D | 16-Jan-2017 | 17.7 KiB | 661 | 557 |
| configure | H A D | 03-May-2022 | 1.9 MiB | 74,109 | 62,526 |
| configure.ac | H A D | 11-Mar-2020 | 67.5 KiB | 1,985 | 1,766 |
| mkinstalldirs | H A D | 16-Jan-2017 | 3.4 KiB | 159 | 109 |
| nagios-plugins.spec | H A D | 11-Mar-2020 | 6.3 KiB | 204 | 174 |
| nagios-plugins.spec.in | H A D | 04-Dec-2019 | 6.3 KiB | 204 | 179 |
| release | H A D | 11-Mar-2020 | 6 | 2 | 1 |
| test.pl.in | H A D | 16-Jan-2017 | 831 | 53 | 35 |
README
1Nagios Plugins
2==============
3
4* For instructions on installing these plugins for use with Nagios,
5 see below.
6
7* For major changes between releases, read the `NEWS` file.
8
9* For information on detailed changes that have been made or plugins
10 that have been added, read the `NEWS` file.
11
12* Some plugins require that you have additional programs and/or
13 libraries installed on your system before they can be used. Plugins that
14 are dependent on other programs/libraries that are missing are usually not
15 compiled. Read the `REQUIREMENTS` file for more information.
16
17* Individual plugins are self-documenting. All plugins that comply with
18 the basic guidelines for development will provide detailed help when
19 invoked with the `-h` or `--help` options.
20
21You can check for the latest plugins at:
22
23* <https://www.nagios-plugins.org/>
24
25Send an email to <help@nagios-plugins.org> for assistance. Please include
26the OS type and version that you are using. Also, run the plugin with the
27`-vvv` option and provide the resulting version information. Of course,
28there may be additional diagnostic information required as well. Use good
29judgment.
30
31Send an email to <devel@nagios-plugins.org> for developer discussions.
32
33For patch submissions and bug reports, please use the appropriate resources
34at:
35
36* <https://github.com/nagios-plugins>
37
38
39Installation Instructions
40-------------------------
41
421. If you are using the Git tree, you will need m4, gettext, automake, and
43 autoconf. To start out, run:
44
45 ./tools/setup
46
47 For more detail, see the developer guidelines at
48 <https://www.nagios-plugins.org/doc/guidelines.html>.
49
502. Run the configure script to initialize variables and create a Makefile,
51 etc.
52
53 ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL
54
55 Replace `BASEDIRECTORY` with the path of the directory under which Nagios
56 is installed (default is `/usr/local/nagios`), and replace `SOMEURL` with
57 the path used to access the Nagios CGIs with a web browser (default is
58 `/nagios/cgi-bin`).
59
603. Compile the plugins with the following command:
61
62 make
63
644. Install the compiled plugins and plugin scripts with the following
65 command:
66
67 make install
68
69 The installation procedure will attempt to place the plugins in a
70 `libexec/` subdirectory in the base directory you specified with the
71 `--prefix` argument to the configure script.
72
735. There are some plugins that require setuid. If you run make install as
74 a non-root user, they will not be installed. To install, switch to root
75 and run:
76
77 make install-root
78
79That's it! If you have any problems or questions, feel free to send an
80email to <help@nagios-plugins.org>.
81
82
83Testing With libtap
84-------------------
85
861. The nagios-plugins source includes a perl testing suite. the libtap
87 library and headers are included with the source. Configure with:
88
89 ./configure --enable-libtap
90
91 Note: "--enable-extra-opts" used to be required as well, but is no
92 longer required as it is a default configure option.
93
942. Make and then make test:
95
96 make
97 make test
98
993. Testing is pseudo intelligent and will try to autodetect which plugins
100 to test. You may need to look at the REQUIREMENTS doc as to what
101 dependencies are required to satisfy the test.
102
103 Additionally, default and user supplied (at runtime) testing parameters
104 are saved in the file:
105
106 /var/tmp/NPTest.cache
107
108 If you need to change any testing parameters, edit them in this file
109 or just remove the line to force the test to re-prompt you for input.
110
111
112License Notice
113--------------
114
115You can redistribute and/or modify this software under the terms of the GNU
116General Public License as published by the Free Software Foundation; either
117version 3 of the License, or (at your option) any later version; with the
118additional exemption that compiling, linking, and/or using OpenSSL is
119allowed.
120
121This software is distributed in the hope that it will be useful, but WITHOUT
122ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
123FITNESS FOR A PARTICULAR PURPOSE.
124
125See the `COPYING` file for the complete text of the GNU General Public
126License, version 3.
127
128Static Analysis Tools
129--------------
130
131Coverity is a tool used to statically analyze C\C++ code and determine
132possible vulnerabilities, bugs, and usage errors. Nagios-Plugins considers
133these items to be extremely important for proper code coverage and
134longevity. It should be noted that a "Passed", does not mean that all
135Coverity reported issues have been resolved, instead that the latest build
136submitted did not have any newly found issues, and may or may not have
137eliminated previously found issues. We use several testing processes that
138end with a submission to Coverity on each successful build. This means that
139you will often see this badge pending or with new issues found as new
140features, pull requests, and github issue resolutions submitted in other
141branches will reflect on the badge displayed on the master branch. However,
142the master branch and therefore any releases will not be updated without a
143current clean scan from Coverity. With that said, below you can find the
144current state of the Nagios-Plugins project per Coverity's view.
145
146<a href="https://scan.coverity.com/projects/2376">
147 <img alt="Coverity Scan Build Status"
148 src="https://scan.coverity.com/projects/2376/badge.svg"/>
149</a>
150