Jonathan Schatz > Sys-HostIP-1.3.1 > Sys::HostIP

Download:
Sys-HostIP-1.3.1.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 1.3.1   Source  

NAME ^

Sys::HostIP - Try extra hard to get ip address related info

SYNOPSIS ^

  use Sys::HostIP; 
  
  #class methods 
  my $ip_address = Sys::HostIP->ip; 

  # $ip_address is a scalar containing a best guess of your host machines 
  # ip address. On unix systems, it will return loopback (127.0.0.1) if it 
  # can't find anything else. This is also exported as a sub (to keep 
  # compatability with older versions).

  my $ip_addresses = Sys::HostIP->ips; 

  # $ip_addresses is an array ref containing all the ip addresses of your
  # machine 

  my $interfaces = Sys::HostIP->interfaces;

  # $interfaces is a hash ref containg all pairs of interfaces/ip addresses
  # Sys::HostIP could find on your machine.

  Sys::HostIP->ifconfig("/somewhere/that/ifconfig/lives");
  # you can set the location of ifconfig with this class method if the code
  # doesn't seem to know where your ifconfig lives

DESCRIPTION ^

Sys::HostIP does what it can to determine the ip address of your machine. All 3 methods work fine on every system that I've been able to test on. (Irix, OpenBSD, FreeBSD, NetBSD, Solaris, Linux, OSX, Win32, Cygwin). It does this by parsing ifconfig(8) (ipconfig on Win32/Cygwin) output.

EXPORT

ip(), ips(), interfaces(), and ifconfig().

AUTHOR ^

Jonathan Schatz <bluelines@divisionbyzero.com>

TODO ^

I haven't tested the win32 code with dialup or wireless connections.

SEE ALSO ^

ifconfig(8) ipconfig

perl.

syntax highlighting: