Mark Overmeer > Net-Domain-TMCH-0.15 > Net::Domain::TMCH

Download:
Net-Domain-TMCH-0.15.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.15   Source   Latest Release: Net-Domain-TMCH-0.17

NAME ^

Net::Domain::TMCH - TradeMark Clearing House

INHERITANCE ^

 Net::Domain::TMCH
   is a Exporter

SYNOPSIS ^

  my $tmch  = Net::Domain::TMCH->new(%options);

  my $smd   = $tmch->smd($filename);

DESCRIPTION ^

Draft RFC http://tools.ietf.org/html/draft-lozano-tmch-func-07 specifies a way for TLD (top-level domain registries) to exchange information about trademark rights, brand registrations.

This module manages the verification process of "SMD"-files, each containing a crypto-signed XML structure of information related to a single trademark claim.

METHODS ^

Constructors

Net::Domain::TMCH->new(OPTIONS)
 -Option          --Default
  auto_datetime     <false>
  cert_revocations  <according to rfc>
  is_pilot          <false>
  smd_admin         <generated internally>
  smd_revocations   []
  tmch_certificate  <included>
auto_datetime => BOOLEAN

Convert dates in the XML automatically into DateTime objects.

cert_revocations => FILENAME|URI|OBJECT

The CRL for invalidated TMV certificates. You may also provide an Net::Domain::TMCH::CRL object.

is_pilot => BOOLEAN
smd_admin => Net::Domain::SMD::Schema-object
smd_revocations => FILENAME|URI|ARRAY
tmch_certificate => FILENAME

This must be a PEM file which contains the certificate on top of all TMCH certificates.

Attributes

$obj->certRevocations()
$obj->isPilot()
$obj->smdAdmin()
$obj->smdRevocations()
$obj->tmchCA()
$obj->tmchCertficate()

Actions

$obj->smd((FILENAME|XML|STRING), OPTIONS)

The first argument can be either a FILENAME (in which case an Net::Domain::SMD::File object is returned, or an XML::LibXML::Element or a STRING (bother returning an Net::Domain::SMD object). In either case, the returned object reflects what is kept inside the XML.

undef is returned when the data is invalid, for instance because it has expired.

 -Option            --Default
  accept_expired      <false>
  trust_certificates  <false>
accept_expired => BOOLEAN

When true, you will be able to access expired SMD files. This is especially useful in regression tests, or when you process ancient SMD files.

trust_certificates => BOOLEAN

Do not check the certificates inside the SMD file for validity.

example:

   my $smd = $tmch->smd($fh)
       or die "cannot use $fn: $@";

SEE ALSO ^

This module is part of Net-Domain-TMCH distribution version 0.15, built on November 07, 2013. Development was supported by NIC.at, the Austrian Domainname Registry.

 Website: F<http://perl.overmeer.net/net-domain-tmch/>

The documentation and interface style is consistent with a large set of modules, belonging to the XML::Compile suite.

LICENSE ^

Copyrights 2013 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: