Rechercher une page de manuel
Net::Interface.3pm
Langue: en
Version: 2006-04-19 (mandriva - 01/05/08)
Section: 3 (Bibliothèques de fonctions)
NAME
Net::Interface - Perl extension to access network interfacesSYNOPSIS
use Net::Interface qw( IFF_UP IFF_BROADCAST IFF_DEBUG IFF_LOOPBACK IFF_POINTOPOINT IFF_NOTRAILERS IFF_RUNNING IFF_NOARP IFF_PROMISC IFF_ALLMULTI IFF_MASTER IFF_SLAVE IFF_MULTICAST IFF_SOFTHEADERS IFHWADDRLEN IFNAMSIZ mac_bin2hex ); or use Net::Interface qw(:constants mac_bin2hex); or for methods only require Net::Interface;
METHODS
@all_ifs = Net::Interface->interfaces(); foreach(@all_ifs) { print $_->name,"\n" }; $if = Net::Interface->new ('eth0'); my $name = $if->name; Get or Set $naddr = $if->address($naddr); $naddr = $if->broadcast($naddr); $naddr = $if->netmask($naddr); $naddr = $if->destination($naddr); or ($sa_family,$size,$naddr) = $if->address($naddr); ($sa_family,$size,$naddr) = $if->broadcast($naddr); ($sa_family,$size,$naddr) = $if->netmask($naddr); ($sa_family,$size,$naddr) = $if->destination($naddr); $mac =$if->hwaddress($hwaddr); or ($sa_family,$size,$hwaddr) = $if->hwaddress($hwaddr); $val = $if->flags($val); $val = $if->mtu ($val); $val = $if->metric($val);
FUNCTIONS
$hexstring = mac_bin2hex(scalar $if->hwaddres);
DESCRIPTION
Net::Interface is designed to make the use of ifconfig(1) and friends unnecessary from within Perl. It provides methods to get at set all the attributes of an interface, and even create new logical or physical interfaces (if your O/S supports it).Scalar context
The Get methods:
$naddr = $if->address(); $naddr = $if->broadcast(); $naddr = $if->netmask(); $naddr = $if->destination();
return a network address in binary form.
$mac = $if->hwaddress();
returns a binary number which can be converted to the hex MAC address using unpack(``H*'',$val).
The methods:
$val = $if->flags(); $naddr = $if->mtu(); $naddr = $if->metric();
return numbers or bit patterns.
Array context
The methods:
($sa_family,$size,$naddr) = $if->address ($sa_family,$size,$naddr) = $if->broadcast ($sa_family,$size,$naddr) = $if->netmask ($sa_family,$size,$naddr) = $if->destination
return a three byte array of the form:
address family (AF_INET, etc...) size of address address as in Scalar context above ($sa_family,$size,$hwaddr) = $if->hwaddress();
returns a three byte array of the form:
address family (AF_LOCAL) size of address binary MAC address
Set methods
Where it is supported by the OS, the methods above may be used to set a value with the syntax:
$optional = $if->method($value); @optional = $if->method($value);
Functions
- •
- $hexstring = mac_bin2hex(scalar $if->hwaddress);
Converts the binary MAC address returned by the hwaddress method into a colon separated series of hex octets representing the MAC address of the hardware interface.
input: binary MAC address returns: hex string MAC address i.e. 00:A0:CC:26:D3:80
AUTHOR
Stephen Zander <gibreel@pobox.com> recent updates by: Jerrad Pierce jpierce@cpan.org Michael Robinton <michael@bizsystems.com>
COPYRIGHT 1998, Stephen Zander. All rights reserved.
Parts of the text of this README copyright 1996,1997 Graham Barr. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Copyright 2006 Michael Robinton This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
perl(1), ifconfig(8)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre