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