GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::DRI::DATA::HOSTS (3)

.ds Aq ’

NAME

Net::DRI::Data::Hosts - Handle ordered list of nameservers (name, IPv4 addresses, IPv6 addresses) for Net::DRI

CONTENTS

SYNOPSIS



 use Net::DRI::Data::Hosts;

 my $dh=Net::DRI::Data::Hosts->new();
 $dh->add(ns.example.foo,[1.2.3.4,1.2.3.5]);
 $dh->add(ns2.example.foo,[10.1.1.1]); ## Third element can be an array ref of IPv6 addresses
 ## ->add() returns the object itself, and thus can be chained

 ## Number of nameservers
 print $dh->count(); ## Gives 2

 ## List of names, either all without arguments, or the amount given by the argument
 my @a=$dh->get_names(2); ## Gives (ns.example.foo,ns2.example.foo)

 ## Details for the nth nameserver (the list starts at 1 !)
 my @d=$dh->get_details(2); ## Gives (ns2.example.foo,[10.1.1.1])

 ## Details by name is possible also
 my @d=$dh->get_details(ns2.example.foo);



DESCRIPTION

Order of nameservers is preserved. Order of IP addresses is preserved, but no duplicate IP is allowed.

If you try to add a nameserver that is already in the list, the IP addresses provided will be added to the existing IP addresses (without duplicates)

Hostnames are verified before being used with Net::DRI::Util::is_hostname().

IP addresses are verified with Net::DRI::Util::is_ipv4() and Net::DRI::Util::is_ipv6().

METHODS

    new(...)

creates a new instance ; if parameters are given, add() is called with them all at once

    new_set(...)

creates a new instance ; if parameters are given, add() is called once for each parameter

clear()

clears the current list of nameservers

    set(...)

clears the current list of nameservers, and call add() once for each parameter passed

    add(name,[ipv4],[ipv6])

adds a new nameserver with the given name and lists of IPv4 and IPv6 addresses

name()

name of this object (for example for registries having the notion of host groups) ; this has nothing to do with the name(s) of the nameservers inside this object

loid()

local id of this object

    get_names(limit)

returns a list of nameservers’ names included in this object ; if limit is provided we return only the number of names asked

count()

returns the number of nameservers currently stored in this object

is_empty()

returns 0 if this object has nameservers, 1 otherwise

    get_details(pos_or_name)

given an integer (position in the list, we start to count at 1) or a name, we return all details as a 3 element array in list context or only the first element (the name) in scalar context for the nameserver stored at the given position or with the given name ; returns undef if nothing found at the position/with the name given.

SUPPORT

For now, support questions should be sent to:

<netdri@dotandco.com>

Please also see the SUPPORT file in the distribution.

SEE ALSO

http://www.dotandco.com/services/software/Net-DRI/

AUTHOR

Patrick Mevzek, <netdri@dotandco.com>

COPYRIGHT

Copyright (c) 2005,2006,2007,2008,2009 Patrick Mevzek <netdri@dotandco.com>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

See the LICENSE file that comes with this distribution for more details.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::DRI::DATA::HOSTS (3) 2010-03-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.