File perl-Net-Ping.spec of Package perl-Net-Ping

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Net-Ping.spec of Package perl-Net-Ping

#
# spec file for package perl-Net-Ping
#
# Copyright (c) 2022 SUSE LLC
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via https://bugs.opensuse.org/
#

%define cpan_name Net-Ping
Name:           perl-Net-Ping
Version:        2.75
Release:        0
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Check a remote host for reachability
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/R/RU/RURBAN/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Socket) >= 2.007
BuildRequires:  perl(Test::Pod) >= 1.22
Requires:       perl(Socket) >= 2.007
%{perl_requires}

%description
This module contains methods to test the reachability of remote hosts on a
network. A ping object is first created with optional parameters, a
variable number of hosts may be pinged multiple times and then the
connection is closed.

You may choose one of six different protocols to use for the ping. The
"tcp" protocol is the default. Note that a live remote host may still fail
to be pingable by one or more of these protocols. For example,
www.microsoft.com is generally alive but not "icmp" pingable.

With the "tcp" protocol the ping() method attempts to establish a
connection to the remote host's echo port. If the connection is
successfully established, the remote host is considered reachable. No data
is actually echoed. This protocol does not require any special privileges
but has higher overhead than the "udp" and "icmp" protocols.

Specifying the "udp" protocol causes the ping() method to send a udp packet
to the remote host's echo port. If the echoed packet is received from the
remote host and the received packet contains the same data as the packet
that was sent, the remote host is considered reachable. This protocol does
not require any special privileges. It should be borne in mind that, for a
udp ping, a host will be reported as unreachable if it is not running the
appropriate echo service. For Unix-like systems see inetd(8) for more
information.

If the "icmp" protocol is specified, the ping() method sends an icmp echo
message to the remote host, which is what the UNIX ping program does. If
the echoed message is received from the remote host and the echoed
information is correct, the remote host is considered reachable. Specifying
the "icmp" protocol requires that the program be run as root or that the
program be setuid to root.

If the "external" protocol is specified, the ping() method attempts to use
the 'Net::Ping::External' module to ping the remote host.
'Net::Ping::External' interfaces with your system's default 'ping' utility
to perform the ping, and generally produces relatively accurate results. If
'Net::Ping::External' if not installed on your system, specifying the
"external" protocol will result in an error.

If the "syn" protocol is specified, the ping method will only send a TCP
SYN packet to the remote host then immediately return. If the syn packet
was sent successfully, it will return a true value, otherwise it will
return false. NOTE: Unlike the other protocols, the return value does NOT
determine if the remote host is alive or not since the full TCP three-way
handshake may not have completed yet. The remote host is only considered
reachable if it receives a TCP ACK within the timeout specified. To begin
waiting for the ACK packets, use the ack method as explained below. Use the
"syn" protocol instead the "tcp" protocol to determine reachability of
multiple destinations simultaneously by sending parallel TCP SYN packets.
It will not block while testing each remote host. This protocol does not
require any special privileges.

%prep
%autosetup  -n %{cpan_name}-%{version}

%build
perl Makefile.PL INSTALLDIRS=vendor
%make_build

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%doc Changes README TODO

%changelog

Places

File perl-Net-Ping.spec of Package perl-Net-Ping

Places