File Coverage

blib/lib/Metabrik/Network/Ping.pm

Criterion	Covered	Total	%
statement	9	22	40.9
branch	0	12	0.0
condition	0	6	0.0
subroutine	3	5	60.0
pod	1	2	50.0
total	13	47	27.6

#
# $Id$
#
# network::ping Brik
#
package Metabrik::Network::Ping;
use strict;
use warnings;

use base qw(Metabrik::Shell::Command Metabrik::System::Package);

sub brik_properties {
   return {
      revision => '$Revision$',
      tags => [ qw(unstable) ],
      author => 'GomoR ',
      license => 'http://opensource.org/licenses/BSD-3-Clause',
      attributes => {
         try => [ qw(count) ],
         timeout => [ qw(seconds) ],
      },
      attributes_default => {
         try => 2,
         timeout => 5,
         ignore_error => 0,  # We need return code from ping command
      },
      commands => {
         install => [ ],  # Inherited
         is_alive => [ qw(host try|OPTIONAL timeout|OPTIONAL) ],
      },
      require_modules => {
         'Metabrik::System::Os' => [ ],
         'Metabrik::Network::Linux::Ping' => [ ],
         'Metabrik::Network::Freebsd::Ping' => [ ],
      },
      require_binaries => {
         ping => [ ],
      },
      need_packages => {
         ubuntu => [ qw(iputils-ping) ],
         debian => [ qw(iputils-ping) ],
         kali => [ qw(iputils-ping) ],
      },
   };
}

#
# Sends ICMP echo-requests $try number of times or until $timeout seconds occurs.
#
sub is_alive {
   my $self = shift;
   my ($host, $try, $timeout) = @_;

   $try ||= $self->try;
   $timeout ||= $self->timeout;
   $self->brik_help_run_undef_arg('is_alive', $host) or return;

   my $np;
   my $os = Metabrik::System::Os->new_from_brik_init($self) or return;
   if ($os->is_linux) {
      $np = Metabrik::Network::Linux::Ping->new_from_brik_init($self) or return;
   }
   elsif ($os->is_freebsd) {
      $np = Metabrik::Network::Freebsd::Ping->new_from_brik_init($self) or return;
   }
   else {
      return $self->log->error("is_alive: OS unsupported");
   }

   return $np->is_alive($host, $try, $timeout);
}

1;

__END__