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

NAME

Net::Link

SYNOPSIS

        use Net::Link;

        my $if = new Net::Link('eth0');

        print "Got uplink.\n" if($if->up);

DESCRIPTION

This is a simple extension of Net::Interface that adds two methods to determine if a network interface has a link/carrier. The information is taken from the 'sysfs', a virtual file system on Linux systems that provides system information (so the module will work on Linux only). The module has been tested with ethernet and wireless network devices.

For ethernet devices, being "up" means that there's a ethernet cable plugged in the port.

For wireless network devices, having an uplink means that the device is associated to an access point or something else.

The information provided by this module affects only the "link" level. For higher level information (IP address, netmask, etc.), use the methods provided by Net::Interface.

METHODS

The added methods are "up" and "down". Both return a boolean.

COPYRIGHT

Copyright (C) 2008 by Jonas Kramer <jkramer@cpan.org>. Published under the terms of the Artistic License 2.0.