File Coverage

blib/lib/Metabrik/Network/Linux/Ping.pm

Criterion	Covered	Total	%
statement	9	20	45.0
branch	0	6	0.0
condition	0	6	0.0
subroutine	3	5	60.0
pod	1	2	50.0
total	13	39	33.3

#
# $Id$
#
# network::linux::ping Brik
#
package Metabrik::Network::Linux::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_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 $cmd = "ping -c $try -W $timeout $host > /dev/null 2>&1";

   my $r = $self->system($cmd) or return;
   if ($r == 1) {
      return 1;  # Host is alive
   }

   return 0;  # Host not alive
}

1;

__END__