Interface::Simple(3pm)					User Contributed Perl Documentation				    Interface::Simple(3pm)

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
";
	   print "addr =      ",$if->address,"
",
		 "broadcast = ",$if->broadcast,"
",
		 "netmask =   ",$if->netmask,"
",
		 "dstaddr =   ",$if->dstaddr,"
",
		 "hwaddr =    ",$if->hwaddr,"
",
		 "mtu =       ",$if->mtu,"
",
		 "metric =    ",$if->metric,"
",
		 "index =     ",$if->index,"
";

	   print "is running
"     if $if->is_running;
	   print "is broadcast
"   if $if->is_broadcast;
	   print "is p-to-p
"	    if $if->is_pt2pt;
	   print "is loopback
"    if $if->is_loopback;
	   print "is promiscuous
" if $if->is_promiscuous;
	   print "is multicast
"   if $if->is_multicast;
	   print "is notrailers
"  if $if->is_notrailers;
	   print "is noarp
"	    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 Stein <lstein@cshl.org>

       This module is distributed under the same license as Perl itself.

SEE ALSO

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

perl v5.14.2							    2007-01-22						    Interface::Simple(3pm)