Jonas Kramer > Net-Link-0.01 > Net::Link

Download:
Net-Link-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

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.

syntax highlighting: