README.SuSE for nagios-plugins-icmp

== Special privileges ==

To be "safe per default", SuSE doesn't install this plugin with the
suid bit set. There are two recommended ways about overriding this on
your system:

=== Set the suid bit ===

Copy the prepared permissions file from this directory to the right place 
in your file system:

~ # cp /usr/share/doc/packages/nagios-plugins/example/permissions.d/nagios-plugins \
    /etc/permissions.d/nagios-plugins

...afterwards adapt the file /etc/permissions.d/nagios-plugins to your needs
(see comments in the file) and run:

~ # SuSEconfig --module permissions

This will set the correct permissions (from now on also during an update).

=== Alternative #1: Use sudo to grant the permission and modify your plugin config ===

This way you need an entry like:

   nagios ALL = NOPASSWD: /usr/lib/nagios/plugins/check_icmp

in ''/etc/sudoers'' and an adapted command definition like the following:

   define command{
        command_name    check_icmp
        command_line    /usr/bin/sudo $USER1$/check_icmp <other_options_here>
   }

=== Alternative #2: Use capabilities(7) to provide the necessary access right:

you can give just the necessary capability using setcap(8):

setcap cap_net_raw+ep /usr/lib/nagios/plugins/check_icmp

note that to use capabilities, you have to enable it before (SLE-11-SP3, per default
has it disabled). Please consulte your documentation to enabled it in your kernel.