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. dfa52c4 docs: Updating documentation and license boilerplates in all files by Alexander Afanasyev · 10 years ago
  2. fdbfc6d src: Improving consistency and correcting code style by Alexander Afanasyev · 10 years ago
  3. ff2d08f data+interest+selectors+meta-info+signature: Implementing EqualityComparable concept by Alexander Afanasyev · 10 years ago
  4. af8eeea interest: Interest::matchesData function by Junxiao Shi · 10 years ago
  5. b332e78 interest: add PublisherPublicKeyLocator selector by Junxiao Shi · 10 years ago
  6. aa0e7da all: Refactoring work with time using boost::chrono by Alexander Afanasyev · 10 years ago
  7. 5964fb7 management: Making LocalControlHeader encoding independent of Interest/Data wire by Alexander Afanasyev · 11 years ago
  8. 6d48bc1 management: Finalizing LocalControlHeader implementation by Alexander Afanasyev · 11 years ago
  9. c348f83 encoding: Optimized encoding of Interest and related data structures by Alexander Afanasyev · 11 years ago
  10. 10257b1 interest: Add setExclude function for Interest abstraction by chenatu · 11 years ago
  11. 0222fba api: Major API change. OnInterest/OnData callbacks now use just references, not shared pointers by Alexander Afanasyev · 11 years ago
  12. e2dcdfd build: Experimental support to build using precompiled headers by Alexander Afanasyev · 11 years ago
  13. a4e5767 interest+data: Add incomingFaceId into Interest and Data. by Yingdi Yu · 11 years ago
  14. 09c613f src: Another round of source updates: moving all headers close to implementation files by Alexander Afanasyev · 11 years ago[Renamed from include/ndn-cpp-dev/interest.hpp]
  15. 61ec272 renaming: ndn-cpp to ndn-cpp-dev by Yingdi Yu · 11 years ago[Renamed from include/ndn-cpp/interest.hpp]
  16. 8548084 binary-xml-wire-format: Partial enabling of binary-xml-wire-format by Alexander Afanasyev · 11 years ago
  17. 840139f interest: auto-generating random nonce if not set by Alexander Afanasyev · 11 years ago
  18. 1eb961a interest: More TLV-related changes by Alexander Afanasyev · 11 years ago
  19. 8468198 interest: Convert Interest to TLV by Alexander Afanasyev · 11 years ago
  20. 13e280b Interest: Added Interest::toUri(). by Jeff Thompson · 11 years ago
  21. 92342a9 code style: Exclude: Put return type on the previous line. by Jeff Thompson · 11 years ago
  22. 000a1e9 code style: In Exclude, put return types on previous line. by Jeff Thompson · 11 years ago
  23. 4dfca98 Exclude: Fix doc comment. by Jeff Thompson · 11 years ago
  24. f62f9f2 Interest: Moved class ExcludeEntry to inner class Exclude::Entry. by Jeff Thompson · 11 years ago
  25. 83bf07e Code style: In "setter" methods, use meaningful argument name instead of "value". by Jeff Thompson · 11 years ago
  26. f76efef Interest: In setNonce, make the argument const Blob&. by Jeff Thompson · 11 years ago
  27. 1b4a7b1 doc: Add documentation for Interest constructors and methods. by Jeff Thompson · 11 years ago
  28. b096e49 Interest exclude: Fix typo in comment. by Jeff Thompson · 11 years ago
  29. 832d297 Interest exclude: Added appendAny and appendComponent and deprecated addAny and addComponent (to be consistent with Name append). by Jeff Thompson · 11 years ago
  30. 4b70d3d interest: Added setName(). by Jeff Thompson · 11 years ago
  31. 9a8e82f common.hpp: time: Added typedef for Milliseconds and MillisecondsSince1970, and use instead of double where appropriate. by Jeff Thompson · 11 years ago
  32. 25b4e61 make: Global change: Move all public headers to include folder. Change source to including public headers using #include <ndn-cpp/*>. Split some header files to minimize exposing C .h files. by Jeff Thompson · 11 years ago[Renamed (96%) from ndn-cpp/interest.hpp]
  33. 97223af globa: Change unsigned int to size_t where it is the size of a byte array or an index/offset into it. by Jeff Thompson · 11 years ago
  34. 10ad12a global: Rename unsigned char to uint8, DynamicUCharArray to DynamicUInt8Array and DynamicUCharVector to DynamicUInt8Vector. by Jeff Thompson · 11 years ago
  35. 0050abe Code style: Put function return type on a line by itself. by Jeff Thompson · 11 years ago
  36. 7687dc0 All source files: Added UC Copyright. Added jefft0 email address. by Jeff Thompson · 11 years ago
  37. 412226d Change Interest.nonce to a Blob. by Jeff Thompson · 11 years ago
  38. c2b7b14 Change wire encoding to return a Blob. by Jeff Thompson · 11 years ago
  39. a7516e0 Use argument defaults for getDefaultWireFormat() instead of a separate overloaded method. by Jeff Thompson · 11 years ago
  40. 1656e6a Code style: Declare (Type& value) instead of (Type &value) by Jeff Thompson · 11 years ago
  41. f62382a Added Interest constructor for name and interestLifetimeMilliseconds by Jeff Thompson · 11 years ago
  42. 3f76e9e Added Interest constructor with default nonce. by Jeff Thompson · 11 years ago
  43. 37527d6 Added Exclude toUri. by Jeff Thompson · 11 years ago
  44. 4962c62 Fix bug: getter methods for vectors should return a reference. by Jeff Thompson · 11 years ago
  45. 38d0e08 Change the ExcludeEntry to use a name component directly. by Jeff Thompson · 11 years ago
  46. 2d27e2f Convert tabs to spaces. by Jeff Thompson · 11 years ago
  47. 5341219 Major code style change to rename all files to lower case. by Jeff Thompson · 11 years ago[Renamed (98%) from ndn-cpp/Interest.hpp]
  48. 67e9e0a Rename encode and decode to wireEncode and wireDecode by Jeff Thompson · 11 years ago
  49. f544701 In encode and decode with default WireFormat, use WireFormat::getDefaultWireFormat() by Jeff Thompson · 11 years ago
  50. f59a87a Added Interest constructor with all arguments by Jeff Thompson · 11 years ago
  51. b915b1d Rename BinaryXmlWireFormat::instance() to BinaryXmlWireFormat::getInstance() by Jeff Thompson · 11 years ago
  52. f0fea00 Code style: Rename BinaryXML to BinaryXml by Jeff Thompson · 11 years ago
  53. b0979fd In encode methods, return a ptr_lib::shared_ptr<vector<unsigned char> > by Jeff Thompson · 11 years ago
  54. c0486c1 Added Interest(const Name &name) by Jeff Thompson · 11 years ago
  55. 5a5e8b7 Rename interestLifetime to interestLifetimeMilliseconds and make it a double by Jeff Thompson · 11 years ago
  56. 3423865 In the Interest constructor, set int values to -1 by Jeff Thompson · 11 years ago
  57. a899539 Don't need to include vector since Name.hpp does by Jeff Thompson · 11 years ago
  58. dd3d229 In set methods, make the argument const by Jeff Thompson · 11 years ago
  59. 8238d00 Added separate PublishPublicKeyDigest and use in Interest. by Jeff Thompson · 11 years ago
  60. eb316a8 Added setter methods. by Jeff Thompson · 11 years ago
  61. 12c2776 Added non-const getName and getExclude by Jeff Thompson · 11 years ago
  62. fe55686 Implement Interest Exclude by Jeff Thompson · 11 years ago
  63. 0a68172 Added const getters. by Jeff Thompson · 11 years ago
  64. d345a5b Use const where possible. by Jeff Thompson · 11 years ago
  65. f2e5e28 In structures, put minSuffixComponents before maxSuffixComponents by Jeff Thompson · 11 years ago
  66. d9e278c Implement get(struct ndn_Interest &) by Jeff Thompson · 11 years ago
  67. 47eecfc Change all copyright notices to refer to file COPYING by Jeff Thompson · 11 years ago
  68. 2255290 Implement ndn_decodeBinaryXMLInterest (except for Exclude) by Jeff Thompson · 11 years ago
  69. b7f9556 Added Interest by Jeff Thompson · 11 years ago