LIBEPP-NICBR
Copyright (C) 2006-2021 Registro.br. All rights reserved.

About This Software
-------------------

This is the LIBEPP-NICBR C++ library that partially implements the
Extensible Provisioning Protocol (EPP), as described in the Internet
drafts RFC5730 to RFC5734 and RFC3735.

RFC5731 - EPP Domain Name Mapping - was implemented with hosts as
attributes of the Domain Object.

In order to conform to the .BR model, extensions to the EPP Domain
Name and Contact Mapping were made (draft-neves-epp-brdomain and
draft-neves-epp-brorg), supported since version 0.2. The documentation
for these extensions is available at EPP References.

The source code is known to compile on supported versions of FreeBSD, 
Linux. We successfully compiled it on Ubuntu 16.04 and 18.04 and
on FreeBSD 11.3 and 12.1. There is also a report of successful build
on MacOS X 10.15.3.

Comments can be sent to <libepp at registro.br>.
Further information at https://registro.br/epp/


Restrictions
------------

- This release does not implement the transfer and delete commands for
  any object, nor it implements RFC5732 - EPP Host Mapping.

- Certificate validation not available.


Known Issues
------------

- Environment is assumed to set "ISO8859-1" as character encoding. The
  absence of this setting can cause some tests to fail.
  e.g.: LANG=en_US.ISO8859-1.


Brief Overview
--------------

include/   - All library header files

src/lib/   - EPP classes implementation

src/shepp/ - Interactive EPP shell client; type "?" inside it for online help

samples/   - A simple fully-commented sample client application

docs/      - XML schemas and templates for all implemented commands

lib/       - Where compiled libraries stay

unit_test/ - UnitTests for all library classes; also provide usage samples
