NAME

Win32::IPConfig::Adapter - Windows NT/2000 Network Adapter IP Configuration Settings

SYNOPSIS

use Win32::IPConfig;

$host = shift || "";
if ($ipconfig = Win32::IPConfig->new($host)) {
    print "hostname=", $ipconfig->get_hostname, "\n";
    print "domain=", $ipconfig->get_domain, "\n";
    print "nodetype=", $ipconfig->get_nodetype, "\n";

    for $adapter (@{$ipconfig->get_adapters}) {
        print "\nAdapter ";
        print $adapter->get_id, "\n";
        print $adapter->get_description, "\n";

        if ($adapter->is_dhcp_enabled) {
            print "DHCP is enabled\n";
        } else {
            print "DHCP is not enabled\n";
        }

        @ipaddresses = @{$adapter->get_ipaddresses};
        print "ipaddresses=@ipaddresses (", scalar @ipaddresses, ")\n";

        @gateways = @{$adapter->get_gateways};
        print "gateways=@gateways (", scalar @gateways, ")\n";

        print "domain=", $adapter->get_domain, "\n";

        @dns = @{$adapter->get_dns};
        print "dns=@dns (", scalar @dns, ")\n";

        @wins = @{$adapter->get_wins};
        print "wins=@wins (", scalar @wins, ")\n";
    }
}

DESCRIPTION

Win32::IPConfig::Adapter encapsulates the TCP/IP configuration settings for a Windows NT/2000 network adapter.

METHODS

$adapter->is_dhcp_enabled

Returns 1 if DHCP is enabled, 0 if it is not. If DHCP is enabled, the values returned from the get_ipaddresses, get_gateways, get_dns, and get_wins methods will be retrieved from the dhcp-specific registry keys.

$adapter->get_ipaddresses

Returns a reference to a list of ip addresses for this adapter.

$adapter->get_gateways

Returns a reference to a list containing default gateway ip addresses. (Bet you didn't realise Windows NT/2000 allowed you to have multiple default gateways.) If no default gateways are configured, a reference to an empty list will be returned.

$adapter->get_dns

Returns a reference to a list containing DNS server ip addresses. If no DNS servers are configured, a reference to an empty list will be returned.

$adapter->get_wins

Returns a reference to a list containing WINS server ip addresses. If no WINS servers are configured, a reference to an empty list will be returned.

AUTHOR

James Macfarlane, <jmacfarla@cpan.org>