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