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
Net::EPP::Frame::ObjectSpec(3) User Contributed Perl Documentation Net::EPP::Frame::ObjectSpec(3)

Net::EPP::Frame::ObjectSpec - metadata about EPP object types

        use Net::EPP::Frame;
        use strict;

        # create an EPP frame:
        my $check = Net::EPP::Frame::Command::Check->new;

        # get the spec:
        my @spec = Net::EPP::Frame::ObjectSpec->spec('domain');

        # create an object:
        my $domain = $check->addObject(@spec);

        # set the attributes:
        my $name = $check->createElement('domain:name');
        $name->addText('example.tld');

        # assemble the frame:
        $domain->appendChild($name);
        $check->getCommandNode->appendChild($domain);

        print $check->toString;

EPP is the Extensible Provisioning Protocol. EPP (defined in RFC 4930) is an application layer client-server protocol for the provisioning and management of objects stored in a shared central repository. Specified in XML, the protocol defines generic object management operations and an extensible framework that maps protocol operations to objects. As of writing, its only well-developed application is the provisioning of Internet domain names, hosts, and related contact details.

Net::EPP::Frame::ObjectSpec is a simple module designed to provide easy access to metadata for the object types defined in the EPP specification.

        my @spec = Net::EPP::Frame::ObjectSpec->spec($type);

This function returns an array containing metadata for the given object type. If no metadata is registered then the function returns undef.

The array contains three members:

        @spec = (
                $type,
                $xmlns,
                $schemaLocation,
        );

$type is the same as the supplied argument, and the other two members correspond to the XML attributes used to specify the object in an EPP "<command>" or "<response>" frame.

The objects currently registered are:

  • "domain", for domain names.
  • "host", for DNS server hosts.
  • "contact", for contact objects.
  • "secDNS", for DNSSEC information.

Note that secDNS is an extension to the domain object rather than an object in its own right.

CentralNic Ltd (http://www.centralnic.com/).

This module is (c) 2016 CentralNic Ltd. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

  • the Net::EPP::Frame module, for constructing valid EPP frames.
  • the Net::EPP::Client module, for communicating with EPP servers.
  • RFCs 4930 and RFC 4934, available from <http://www.ietf.org/>.
  • The CentralNic EPP site at <http://www.centralnic.com/resellers/epp>.
2016-04-06 perl v5.32.1

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

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