NAME

IO::Interface::Simple - Perl extension for access to network card configuration information

SYNOPSIS

use IO::Interface::Simple;

my $if1   = IO::Interface::Simple->new('eth0');
my $if2   = IO::Interface::Simple->new_from_address('127.0.0.1');
my $if3   = IO::Interface::Simple->new_from_index(1);

my @interfaces = IO::Interface::Simple->interfaces;

for my $if (@interfaces) {
   print "interface = $if\n";
   print "addr =      ",$if->address,"\n",
         "broadcast = ",$if->broadcast,"\n",
         "netmask =   ",$if->netmask,"\n",
         "dstaddr =   ",$if->dstaddr,"\n",
         "hwaddr =    ",$if->hwaddr,"\n",
         "mtu =       ",$if->mtu,"\n",
         "metric =    ",$if->metric,"\n",
         "index =     ",$if->index,"\n";

   print "is running\n"     if $if->is_running;
   print "is broadcast\n"   if $if->is_broadcast;
   print "is p-to-p\n"      if $if->is_pt2pt;
   print "is loopback\n"    if $if->is_loopback;
   print "is promiscuous\n" if $if->is_promiscuous;
   print "is multicast\n"   if $if->is_multicast;
   print "is notrailers\n"  if $if->is_notrailers;
   print "is noarp\n"       if $if->is_noarp;
 }

DESCRIPTION

IO::Interface::Simple allows you to interrogate and change network interfaces. It has overlapping functionality with Net::Interface, but might compile and run on more platforms.

Class Methods

$interface = IO::Interface::Simple->new('eth0')

Given an interface name, new() creates an interface object.

@iflist = IO::Interface::Simple->interfaces;

Returns a list of active interface objects.

$interface = IO::Interface::Simple->new_from_address('192.168.0.1')

Returns the interface object corresponding to the given address.

$interface = IO::Interface::Simple->new_from_index(2)

Returns the interface object corresponding to the given numeric index. This is only supported on BSD-ish platforms.

Object Methods

$name = $interface->name

Get the name of the interface. The interface object is also overloaded so that if you use it in a string context it is the same as calling name().

$index = $interface->index

Get the index of the interface. This is only supported on BSD-like platforms.

$addr = $interface->address([$newaddr])

Get or set the interface's address.

$addr = $interface->broadcast([$newaddr])

Get or set the interface's broadcast address.

$addr = $interface->netmask([$newmask])

Get or set the interface's netmask.

$addr = $interface->hwaddr([$newaddr])

Get or set the interface's hardware address.

$addr = $interface->mtu([$newmtu])

Get or set the interface's MTU.

$addr = $interface->metric([$newmetric])

Get or set the interface's metric.

$flags = $interface->flags([$newflags])

Get or set the interface's flags. These can be ANDed with the IFF constants exported by IO::Interface or Net::Interface in order to interrogate the state and capabilities of the interface. However, it is probably more convenient to use the broken-out methods listed below.

$flag = $interface->is_running([$newflag])

$flag = $interface->is_broadcast([$newflag])

$flag = $interface->is_pt2pt([$newflag])

$flag = $interface->is_loopback([$newflag])

$flag = $interface->is_promiscuous([$newflag])

$flag = $interface->is_multicast([$newflag])

$flag = $interface->is_notrailers([$newflag])

$flag = $interface->is_noarp([$newflag])

Get or set the corresponding configuration parameters. Note that the operating system may not let you set some of these.

AUTHOR

Lincoln D. Stein <lincoln.stein@gmail.com> Copyright 2001-2014, Lincoln D. Stein.

This library is distributed under the Perl Artistic License 2.0. Please see LICENSE for more information.

SUPPORT

For feature requests, bug reports and code contributions, please use the GitHub repository at https://github.com/lstein/LibIO-Interface-Perl

SEE ALSO

perl, IO::Socket, IO::Multicast), IO::Interface, Net::Interface