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