The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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).

method

After a successful call to get_address(), the method() function will tell you how the information was derived. Currently there are two possibilities: 'arp' 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 is 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

ipconfig, arp

BUGS

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

AUTHOR

Martin Thurn (mthurn@cpan.org).