NAME

Nagios::NRPE::Client - A Nagios NRPE client

SYNOPSIS

use Nagios::NRPE::Client;

my $client = Nagios::NRPE::Client->new( host => "localhost", check => 'check_cpu');
my $response = $client->run();
if(defined $response->{error}) {
  print "ERROR: Couldn't run check ".$client->check()." because of: "$response->{reason}."\n";
} else {
  print $response->{status}."\n";
}

DESCRIPTION

This Perl Module implements Version 2 of the NRPE-Protocol. With this module you can execute

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Andreas Marschke <andreas.marschke@googlemail.com>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

SUBROUTINES

new()

Constructor for the Nagios::NRPE::Client Object

example

my $client = Nagios::NRPE::Client->new( host => "localhost", check => 'check_cpu');

Takes a hash of options:

host => <hostname or IP>

The hostname or IP on which the NRPE-Server is running

port => <Portnumber>

The port number at which the NRPE-Server is listening

timeout => <number in seconds>

Timeout for TCP/IP communication

arglist => ["arg","uments"]

List of arguments attached to the check

check => "check_command"

Command defined in the nrpe.cfg on the NRPE-Server

ssl => 0,1

Use or don't use SSL

run()

Runs the communication to the server and returns a hash of the form:

my $response = $client->run();

The output should be a hashref of this form:

{
  version => NRPE_VERSION,
  type => RESPONSE_TYPE,
  crc32 => CRC32_CHECKSUM,
  code => RESPONSE_CODE,
  buffer => CHECK_OUTPUT
}