NAME

Net::Address::IPv4::Local - A class for discovering the local system's IP address

VERSION

0.12

SYNOPSIS

use Net::Address::IPv4::Local;

# Get the local system's IP address that is "connected" to "the internet":
my $address = Net::Address::IPv4::Local->public;

# Get the local system's IP address that is "connected" to the given remote
# IP address:
my $address = Net::Address::IPv4::Local->connected_to($remote_address);

DESCRIPTION

Net::Address::IPv4::Local discovers the local system's IP address that would be used as the source address when contacting "the internet" or a certain specified remote IP address.

Instance methods

This class just provides the following instance methods:

public: RETURNS SCALAR; THROWS Net::Address::IPv4::Local::Error

Returns the textual representation of the local system's IP address that is "connected" to "the internet".

connected_to($remote_address): RETURNS SCALAR; THROWS Net::Address::IPv4::Local::Error

Returns the textual representation of the local system's IP address that is "connected" to the given remote IP address.

AVAILABILITY and SUPPORT

The latest version of Net::Address::IPv4::Local is available on CPAN and at http://www.mehnle.net/software/net-address-ipv4-local.

Support is usually (but not guaranteed to be) given by the author, Julian Mehnle <julian@mehnle.net>.

AUTHOR and LICENSE

Net::Address::IPv4::Local is Copyright (C) 2005 Julian Mehnle <julian@mehnle.net>.

Net::Address::IPv4::Local is free software. You may use, modify, and distribute it under the same terms as Perl itself, i.e. under the GNU GPL or the Artistic License.