blob: 89d7c08c812f3dec84fee2a044895b33a5a755a0 [file] [log] [blame]
Alexander Afanasyev45312f52015-09-27 12:06:50 -07001ndn-cxx version 0.2.0
2---------------------
3
4Release date: August 25, 2014
5
6Changes since version 0.1.0:
7
Davide Pesavento933a5672020-07-03 22:32:43 -04008New features
9^^^^^^^^^^^^
Alexander Afanasyev45312f52015-09-27 12:06:50 -070010
11- **Base**
12
Davide Pesaventod776a932020-03-20 18:42:36 -040013 + The license under which the library is released is changed to the **GNU Lesser
14 General Public License version 3.0**
Alexander Afanasyev45312f52015-09-27 12:06:50 -070015
16 + New ways to use incoming Interest dispatching:
17
18 * New :ndn-cxx:`InterestFilter` abstraction that supports filtering based on name
19 prefixes and regular expressions.
20
Davide Pesaventod776a932020-03-20 18:42:36 -040021 * Separate ``Face::registerPrefix()`` and ``Face::setInterestFilter()`` methods
22 allow distinct operations of registering with the local NDN forwarder and setting
Alexander Afanasyev45312f52015-09-27 12:06:50 -070023 up application-specific ``OnInterest`` call dispatch using InterestFilters.
24
Davide Pesavento933a5672020-07-03 22:32:43 -040025 + Add support for the `NDN naming conventions (revision 1)
26 <https://named-data.net/publications/techreports/ndn-tr-22-ndn-memo-naming-conventions/>`_
27 (:issue:`1761`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070028
29- **Security**
30
31 + Add ``type dir`` :ref:`trust-anchor in ValidatorConfig <validator-conf-trust-anchors>`
32 to add all certificates under the specified directory as trust anchors.
33 The new option also allow periodic reloading trust anchors, allowing dynamic trust
34 models.
35
susmitf47cef62018-02-13 12:01:14 -070036 + Added support for multiple signature types to ``PublicKey``, ``SecPublicInfo`` abstractions
Alexander Afanasyev45312f52015-09-27 12:06:50 -070037
38 + New :ndn-cxx:`SignatureSha256WithEcdsa` signature type
39
Davide Pesaventoa86300a2020-12-05 14:55:45 -050040 + Updates in ``Signature`` data structure to reflect changes in the `NDN-TLV spec v0.1.1
Davide Pesavento02ed3322023-02-23 19:40:22 -050041 <https://docs.named-data.net/NDN-packet-spec/0.1.1/>`__
Alexander Afanasyev45312f52015-09-27 12:06:50 -070042
43- **Wire encoding**
44
Davide Pesaventoa86300a2020-12-05 14:55:45 -050045 + :ndn-cxx:`Data::getFullName` method to get the Data packet name including the implicit digest
Alexander Afanasyev45312f52015-09-27 12:06:50 -070046
Davide Pesaventoa86300a2020-12-05 14:55:45 -050047 + :ndn-cxx:`Name::getSuccessor` method to get name successor (:issue:`1677`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070048
49 + New in-wire refreshing of Interest's nonce (:issue:`1758`)
50
51- **Management**
52
Davide Pesaventod776a932020-03-20 18:42:36 -040053 + Support for :ndn-cxx:`ChannelStatus` and :ndn-cxx:`StrategyChoice` datasets
Alexander Afanasyev45312f52015-09-27 12:06:50 -070054
55 + Defining new common Route Origins for NFD RIB management protocol (:issue:`1719`)
56
Davide Pesaventod776a932020-03-20 18:42:36 -040057 + New ``RibEntry`` and ``Route`` data structures for RIB management protocol (:issue:`1764`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070058
Davide Pesaventod776a932020-03-20 18:42:36 -040059 + Add support for RIB flags in ``setInterestFilter()`` and ``registerPrefix()`` (:issue:`1842`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070060
61- **Miscellaneous tools**
62
63 + Introduce :ndn-cxx:`Scheduler::cancelAllEvents` to cancel all previously scheduled events
64 (:issue:`1757`)
65
susmitf47cef62018-02-13 12:01:14 -070066 + Introduce ``util::EventEmitter``, :ndn-cxx:`util::NotificationSubscriber`,
Alexander Afanasyev45312f52015-09-27 12:06:50 -070067 :ndn-cxx:`util::NotificationStream`, and :ndn-cxx:`nfd::FaceMonitor` utility classes
68
Davide Pesavento47ce2ee2023-05-09 01:33:33 -040069 + Introduce :ndn-cxx:`SegmentFetcher` helper class to fetch multi-segmented data
Alexander Afanasyev45312f52015-09-27 12:06:50 -070070 (:issue:`1879`)
71
72- **Build**
73
Davide Pesaventod776a932020-03-20 18:42:36 -040074 + Enabled support of precompiled headers for clang and gcc compilers to speed up compilation
Alexander Afanasyev45312f52015-09-27 12:06:50 -070075
Davide Pesavento933a5672020-07-03 22:32:43 -040076Updates and bug fixes
77^^^^^^^^^^^^^^^^^^^^^
Alexander Afanasyev45312f52015-09-27 12:06:50 -070078
79- **Base**
80
Davide Pesaventoa86300a2020-12-05 14:55:45 -050081 + Serialization of socket write operations (:issue:`1769`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070082
83 + Enforcing limit on Interest and Data packet size in :ndn-cxx:`Face::expressInterest` and
84 :ndn-cxx:`Face::put` methods (:issue:`1774`)
85
86 + Cleaning up transport state on communication failure, so Face can try to reconnect
Davide Pesaventod776a932020-03-20 18:42:36 -040087 in the future
Alexander Afanasyev45312f52015-09-27 12:06:50 -070088
Davide Pesaventoa86300a2020-12-05 14:55:45 -050089 + Fix bug in ``Face::removePendingInterest()`` (:issue:`1917`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -070090
91- **Wire encoding**
92
Davide Pesaventod776a932020-03-20 18:42:36 -040093 + The Nonce field is now encoded as a 4-byte value, as defined by NDN-TLV spec
Alexander Afanasyev45312f52015-09-27 12:06:50 -070094
95 + Optimized Data packet signing
96
97 :ndn-cxx:`KeyChain::sign` method now pre-allocates :ndn-cxx:`EncodingBuffer`, requests
98 unsigned portion of :ndn-cxx:`Data` using ``Data::wireEncode(EncodingBuffer, true)``,
99 and then appends the resulting signature and prepends :ndn-cxx:`Data` packet header.
100 This way there is no extra memory allocation after :ndn-cxx:`Data` packet is signed.
101
102 + Optimized implicit digest calculation in :ndn-cxx:`Interest::matchesData` method
103 (:issue:`1769`)
104
105- **Management**
106
Davide Pesaventod776a932020-03-20 18:42:36 -0400107 + Add link-layer byte counts in ``FaceStatus`` data structure (:issue:`1765`)
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700108
109- **Security**
110
111 + Allow user to explicitly specify the cert name prefix before 'KEY' component in
112 ``ndnsec-certgen``
113
Davide Pesavento02ed3322023-02-23 19:40:22 -0500114 + ``SignatureSha256`` has been renamed to :ndn-cxx:`DigestSha256` to conform to the
115 `NDN-TLV specification <https://docs.named-data.net/NDN-packet-spec/0.1.1/>`__
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700116
Davide Pesaventod776a932020-03-20 18:42:36 -0400117 + Add checking of Timestamp and Nonce fields in signed Interest within
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700118 :ndn-cxx:`ValidatorConfig`
119
Davide Pesaventod776a932020-03-20 18:42:36 -0400120 + Allow validator customization using hooks.
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700121
122 Sub-classes of :ndn-cxx:`Validator` class can use the following hooks to fine-tune the
123 validation process:
124
Davide Pesaventod776a932020-03-20 18:42:36 -0400125 * ``preCertificateValidation`` to process received certificate before validation
susmitf47cef62018-02-13 12:01:14 -0700126 * ``onTimeout`` to process interest timeout
Davide Pesaventod776a932020-03-20 18:42:36 -0400127 * ``afterCheckPolicy`` to process validation requests
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700128
susmitf47cef62018-02-13 12:01:14 -0700129 + Fix memory issues in ``SecPublicInfoSqlite3``
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700130
131- **Miscellaneous tools**
132
133 + Redefine method for random number generation: ``random::generateWord*`` and
134 ``random::generateSecureWord*`` to generate cryptographically non-secure (fast) and
135 secure (slow) random numbers.
136
137- Other minor fixes and corrections
138
Davide Pesavento933a5672020-07-03 22:32:43 -0400139Deprecated
140^^^^^^^^^^
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700141
142- ``SignatureSha256`` class, use :ndn-cxx:`DigestSha256` instead.
143
144- All :ndn-cxx:`Face` constructors that accept ``shared_ptr<io_service>``.
145
146 Use versions that accept reference to ``io_service`` object.
147
148- ``Face::ioService`` method, use :ndn-cxx:`Face::getIoService` instead.
149
150- :ndn-cxx:`Interest` constructor that accepts name, individual selectors, and individual
151 guiders as constructor parameters.
152
153 Use ``Interest().setX(...).setY(...)`` or use the overload taking ``Selectors``
154
155- ``name::Component::toEscapedString`` method, use :ndn-cxx:`name::Component::toUri` instead.
156
susmitf47cef62018-02-13 12:01:14 -0700157- ``SecPublicInfo::addPublicKey`` method, use ``SecPublicInfo::addKey`` instead.
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700158
159- ``Tlv::ConentType`` constant (typo), use ``Tlv::ContentType`` instead.
160
161- ``CommandInterestGenerator`` and ``CommandInterestValidator`` utility classes.
162 :ndn-cxx:`ValidatorConfig` should be used instead.
163
Davide Pesavento933a5672020-07-03 22:32:43 -0400164Removed
165^^^^^^^
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700166
Davide Pesaventod776a932020-03-20 18:42:36 -0400167- Support for ndnd-tlv (only NFD management protocol is supported now)
Alexander Afanasyev45312f52015-09-27 12:06:50 -0700168
169- ``SecPublicInfoMemory`` and ``SecTpmMemory`` classes that were no longer used
170
171- Removing concept of periodic event from :ndn-cxx:`Scheduler`.
172
173 In applications, periodic events should be just re-scheduled within the callback for
174 single-shot events.