ndn-cxx v0.1.0 Release Notes
============================

Version 0.1.0 is the initial release of ndn-cxx, an NDN C++ library with eXperimental eXtensions.

Originally based on [ndn-cpp library](https://github.com/named-data/ndn-cpp) the ndn-cxx library
adopts a slightly different design philosophy (including an extensive use of Boost libraries to
facilitate development, as well as the use of Crypto++ library to support cryptographic operations),
and includes a number of extensions that aim to simplify NDN application development.

The current features include:

-   **Base**
    -   Fully asynchronous, event-driven communication model, which is implemented using
        [Boost.Asio](http://www.boost.org/doc/libs/1_48_0/doc/html/boost_asio.html)
    -   Single-threaded, but thread-safe Face operations

        > A single Face object can be safely used in multiple threads to express Interests and
        > publish Data packets

    -   Explicit time management for NDN operations using
        [Boost.Chrono](http://www.boost.org/doc/libs/1_48_0/doc/html/chrono.html)
    -   Simplified and extended [NDN API](doxygen/annotated.html)
    -   Extensive set of unit-tests based on [Boost.Test
        framework](http://www.boost.org/doc/libs/1_48_0/libs/test/doc/html/index.html)
        -   Continuous integration using an in-house installation of Jenkins build bots and the
            hosted [Travis CI](https://travis-ci.org/named-data/ndn-cxx) continuous integration
            service compile and verify correctness of the library for each commit

-   **Wire format**
    -   Full support of [NDN-TLV packet format v0.1](http://named-data.net/doc/NDN-TLV/0.1/)
    -   Pure C++ implementation of wire encoding/decoding with simple access to wire format of all
        NDN packet abstractions via `wireEncode` and `wireDecode` methods

        > In many cases, NDN packet abstractions are just "indices" to the wire format

-   **Communication with the forwarder**
    -   Enable connecting to local forwarder via UNIX and TCP transports and to remote forwarders
        using TCP transport
    -   Full support for communication with [Named Data Networking Forwarding Daemon
        (NFD)](https://github.com/named-data/NFD)
        -   Full support for [NFD management
            protocols](http://redmine.named-data.net/projects/nfd/wiki/Management) to NFD status
            information, create and manage NFD Faces, receive NFD Face status change notifications,
            update StrategyChoice for namespaces, and manage routes in RIB
        -   Support for
            [LocalControlHeader](http://redmine.named-data.net/projects/nfd/wiki/LocalControlHeader)
            to implement special NDN applications that need low-level control of NDN packet
            forwarding
-   **Security support**
    -   A set of security primitives to allowing implementation of secure NDN applications in a
        simplified manner
        -   **KeyChain**: provides simple interfaces of packet signing, and key and certificate
            management
        -   **ValidatorConfig**: validator that implements trust model defined in a configuration
            file
        -   **CommandInterestGenerator** and **CommandInterestValidator**: convenient helpers to
            produce and validate command interests, while preventing potential replay attacks
    -   Several implementations of trusted platform modules to securely manage private keys
        -   **SecTpmOsx**: TPM based on OSX KeyChain (OSX-specific)
        -   **SecTpmFile**: TPM that uses file-based access control to protect keys (cross-platform)
    -   Extensive set of security command-line tools to manage security identities and certificates
        -   Generating private/public keys
        -   Issuing certificates
        -   Exporting/importing identities
        -   Managing default security settings
-   **Miscellaneous tools**
    -   Scheduler to support delayed time operations
    -   NDN regular expressions
    -   Simple config file to alter various aspects of the library
    -   **tlvdump**: a simple tool to visualize TLV-encoded blocks
  1. ba16b8f Move validation-request.hpp to public API. Moved static verifySha256WithRsaSignature to new Sha256WithRsaHandler::verify. by Jeff Thompson · 11 years ago
  2. 36fe1bc security: In SelfVerifyPolicyManager, fix typo in comment. by Jeff Thompson · 11 years ago
  3. 3a2eb2f security: Added SelfVerifyPolicyManager. by Jeff Thompson · 11 years ago
  4. 1596639 security: In key-chain.cpp, added a static utility function verifySha256WithRsaSignature. by Jeff Thompson · 11 years ago
  5. 31aeed8 security: PolicyManager: In checkVerificationPolicy, pass stepCount by value since the reference is not needed to modify the caller's value, and it is copied through to the ValidationRequest constructor. by Jeff Thompson · 11 years ago
  6. ac64b13 security: In BasicIdentityStorage, move the sqlite file to ~/.ndnx/ndnsec-identity.db. Refs #1077. by Jeff Thompson · 11 years ago
  7. a4aa4ce security: Add IdentityCertificate copy constructor. by Jeff Thompson · 11 years ago
  8. 09324ed security: In key-chain.cpp, need to qualify func_lib with ndn namespace. by Jeff Thompson · 11 years ago
  9. 2381da8 security: In key-chain.cpp, need to use namespace ndn::func_lib to use bind, etc. Refs #1063 by Jeff Thompson · 11 years ago
  10. 9bdeb6d security: in key-chain.cpp for bind with _1, if using std::function, need namespace placeholders. Refs #1063. by Jeff Thompson · 11 years ago
  11. cda349e security: Implement certificate checking in KeyChain::verifyData. by Jeff Thompson · 11 years ago
  12. f309aa6 security: In KeyChain::verifyData, actually check policyManager_->requireVerify and skipVerifyAndTrust. Use of ValidationRequest is still not implemented by Jeff Thompson · 11 years ago
  13. 56e6265 security: Fix bug in KeyChain::signByIdentity: Need to send the wireFormat to signByCertificate. by Jeff Thompson · 11 years ago
  14. 910dc2b Remove unused KEY_FORMAT_PUBLIC_OPENSSL and OSXPrivateKeyStorage::getFormat. by Jeff Thompson · 11 years ago
  15. 7494261 security: Added IdentityCertificate::certificateNameToPublicKeyName and use it in signByCertificate so that it doesn't t need to retrieve the certificate just to get the key name. by Jeff Thompson · 11 years ago
  16. 61805e9 security: MemoryIdentityStorage: Implement key and certificate stores. by Jeff Thompson · 11 years ago
  17. 418b05a security: In IdentityManager::setDefaultCertificateForKey, pass the certificate, not a Name. Make createIdentityCertificate take the certificatePrefix name. by Jeff Thompson · 11 years ago
  18. 22285ec security: Remove IdentityStorage::getKeyNameForCertificate. Make getNewKeyName not virtual. by Jeff Thompson · 11 years ago
  19. 556cc30 security: OSXPrivateKeyStorage: When calling CFStringCreateWithCString, need to use kCFStringEncodingUTF8. by Jeff Thompson · 11 years ago
  20. 43a57b1 security: In IdentityCertificate, added publicKeyName_ and make getPublicKeyName just return it. Internally call setPublicKeyName as needed to set it. Make isCorrectName() check for "KEY". by Jeff Thompson · 11 years ago
  21. 855b140 security: In Certificate::encode, need to set the type to KEY. by Jeff Thompson · 11 years ago
  22. 2db6037 files: Rename ndn-cpp/ to src/. Updated Makefile.am. Refs #1054. by Jeff Thompson · 11 years ago