NAME

Net::Address::Ethernet - find hardware ethernet address

SYNOPSIS

use Net::Address::Ethernet qw( get_address );
my $sAddress = get_address;
my $sMethod = &Net::Address::Ethernet::method;

FUNCTIONS

The following functions will be exported to your namespace if you request :all like so:

use Net::Address::Ethernet qw( :all );

get_address

Returns the 6-byte ethernet address in canonical form. For example, '1A:2B:3C:4D:5E:6F'.

When called in array context, returns a 6-element list representing the 6 bytes of the address in decimal. For example, (26,43,60,77,94,111).

On Windows (MSWin32), you can set package variable $sIpconfigHome to the folder containing ipconfig.exe (if ipconfig is not found your PATH).

$Net::Address::Ethernet::sIpconfigHome = 'C:\\my\\bin';
my $sAddr = &Net::Address::Ethernet::get_address;

method

After a successful call to get_address(), the method() function will tell you how the information was derived. Currently there are three possibilities: 'arp' or 'ifconfig' for Unix-like systems, or 'ipconfig' for Win32. If you haven't called get_address(), 'N/A' will be returned. If something went wrong during get_address(), 'failed' will be returned by method().

is_address

Returns a true value if its argument looks like an ethernet address.

canonical

Given a 6-byte ethernet address, converts it to canonical form. Canonical form is 2-digit uppercase hexadecimal numbers with colon between the bytes. The address to be converted can have any kind of punctuation between the bytes, the bytes can be 1-digit, and the bytes can be lowercase; but the bytes must already be hex.

NOTES

SEE ALSO

arp, ifconfig, ipconfig

BUGS

Please tell the author if you find any! And please show me the output format of `ipconfig /all` or `arp <hostname>` or `ifconfig` from your system.

AUTHOR

Martin Thurn (mthurn@cpan.org).