Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 1 | Changes |
| 2 | ======= |
| 3 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 4 | Version 0.3 |
| 5 | ----------- |
| 6 | |
Davide Pesavento | 4d6c357 | 2022-05-27 12:05:05 -0400 | [diff] [blame^] | 7 | - Rewrite TLV syntax specifications using IETF Augmented BNF (:rfc:`5234`) |
Junxiao Shi | 78ce295 | 2019-05-07 15:34:00 -0400 | [diff] [blame] | 8 | |
Davide Pesavento | cf4903e | 2021-11-08 22:06:22 -0500 | [diff] [blame] | 9 | - Require shortest encoding for TLV-TYPE and TLV-LENGTH numbers |
Junxiao Shi | 459e466 | 2019-05-31 15:28:03 +0000 | [diff] [blame] | 10 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 11 | - **Interest** |
| 12 | |
| 13 | + Remove ``Selectors`` element |
| 14 | + Add optional ``CanBePrefix`` element after Name |
| 15 | + Move optional ``MustBeFresh`` element after ``CanBePrefix`` |
| 16 | + Move optional ``ForwardingHint`` element after ``MustBeFresh`` (before ``Nonce``) |
| 17 | + Add optional ``HopLimit`` element |
Zhiyi Zhang | 0c04fd8 | 2018-09-04 16:29:47 -0400 | [diff] [blame] | 18 | + Add optional ``ApplicationParameters`` element |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 19 | + Define a new specification for Signed Interest using two new elements: ``InterestSignatureInfo`` and ``InterestSignatureValue`` |
Alexander Afanasyev | 9fba5f4 | 2021-12-21 12:40:17 -0500 | [diff] [blame] | 20 | + Redefine the contents of the ``ForwardingHint`` (remove numerical preference and nesting inside the ``Delegation`` TLV) |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 21 | |
| 22 | - **Data** |
| 23 | |
| 24 | + Make ``MetaInfo`` and ``Content`` elements optional |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 25 | + Change semantics of omitted (or set to zero) ``FreshnessPeriod`` element: it cannot be used to satisfy Interests with ``MustBeFresh`` |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 26 | |
Alexander Afanasyev | 9fba5f4 | 2021-12-21 12:40:17 -0500 | [diff] [blame] | 27 | - **LinkObject** |
| 28 | |
| 29 | + The content is now just a list of names (remove numerical preference) |
| 30 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 31 | - **Name** |
| 32 | |
Davide Pesavento | cf4903e | 2021-11-08 22:06:22 -0500 | [diff] [blame] | 33 | + Lift restriction on name component types, allowing types in the range 1-65535 |
| 34 | + Correct definition of name URI encoding: disallow unescaped encoding of PLUS (``+``) and allow TILDE (``~``) |
Alexander Afanasyev | 85f77b1 | 2021-10-26 17:44:35 -0400 | [diff] [blame] | 35 | + Add well-known special-use component types: |
| 36 | |
| 37 | - ``ParametersSha256DigestComponent`` (type 2) |
| 38 | - ``KeywordNameComponent`` (type 32) |
| 39 | - ``SegmentNameComponent`` (type 50) |
| 40 | - ``ByteOffsetNameComponent`` (type 52) |
| 41 | - ``VersionNameComponent`` (type 54) |
| 42 | - ``TimestampNameComponent`` (type 56) |
| 43 | - ``SequenceNumNameComponent`` (type 58) |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 44 | |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 45 | - **Signature** |
| 46 | |
| 47 | + Require all compliant implementations to support the ``SignatureSha256WithEcdsa`` signature type using NIST curve P-256 |
| 48 | + Redefine the signed portion of Data packets to be more future-proof |
Junxiao Shi | ac25eab | 2022-05-27 10:52:17 +0000 | [diff] [blame] | 49 | + Add ``SignatureEd25519`` signature type |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 50 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 51 | Version 0.2.1 |
| 52 | ------------- |
spirosmastorakis | 988e741 | 2016-10-27 14:01:59 -0700 | [diff] [blame] | 53 | |
| 54 | - Add definition of Link Object |
| 55 | |
| 56 | - **Interest** |
| 57 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 58 | + Add default of leftmost child if ChildSelector element not present |
| 59 | + Add specification of ForwardingHint element |
spirosmastorakis | 988e741 | 2016-10-27 14:01:59 -0700 | [diff] [blame] | 60 | |
Eric Newberry | 5651986 | 2017-02-13 13:26:19 -0700 | [diff] [blame] | 61 | - **Data** |
| 62 | |
| 63 | + Updated Content Store semantics for Data packets that do not carry FreshnessPeriod. |
| 64 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 65 | Version 0.2 |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 66 | ----------- |
Junxiao Shi | a0d3682 | 2014-09-21 11:32:09 -0700 | [diff] [blame] | 67 | |
| 68 | - **Name** |
| 69 | |
| 70 | + Allow zero-length name component |
Alexander Afanasyev | 4b8be21 | 2014-10-06 10:55:04 -0700 | [diff] [blame] | 71 | + Require implicit digest to be specified using ``ImplicitSha256Digest`` name component |
Junxiao Shi | a0d3682 | 2014-09-21 11:32:09 -0700 | [diff] [blame] | 72 | |
Alexander Afanasyev | 948affe | 2016-09-13 13:15:29 -0700 | [diff] [blame] | 73 | - **Signature** |
| 74 | |
| 75 | + Add spec for ``SignatureHmacWithSha256`` |
| 76 | |
Junxiao Shi | def7fc5 | 2015-06-10 13:29:21 -0700 | [diff] [blame] | 77 | - **Interest** |
| 78 | |
| 79 | + Delete deprecated ``Scope`` guider |
Alexander Afanasyev | 948affe | 2016-09-13 13:15:29 -0700 | [diff] [blame] | 80 | + Restrict Interest to have name with at least one name component |
| 81 | |
| 82 | - **Data** |
| 83 | |
| 84 | + Redirect ContentType number assignments to the `wiki page <https://redmine.named-data.net/projects/ndn-tlv/wiki/ContentType>`__ |
Junxiao Shi | def7fc5 | 2015-06-10 13:29:21 -0700 | [diff] [blame] | 85 | |
Junxiao Shi | 4406fdd | 2015-06-10 13:28:10 -0700 | [diff] [blame] | 86 | - **TLV-TYPE** |
| 87 | |
| 88 | + Reserve 800-1000 range for link protocol |
| 89 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 90 | Version 0.1.1 |
| 91 | ------------- |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 92 | |
| 93 | - **Signature** |
| 94 | |
Alexander Afanasyev | 4b89611 | 2014-06-23 21:47:15 -0700 | [diff] [blame] | 95 | + New ``SignatureSha256WithEcdsa`` signature type for Elliptic Curve Digital Signature Algorithm (ECDSA). |
Alexander Afanasyev | f3e5e85 | 2014-06-13 22:44:02 -0700 | [diff] [blame] | 96 | + ``KeyLocatorDigest`` renamed to ``KeyDigest``. The specification now explicitly allows KeyDigest to be a SHA256 of any type of the key. |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 97 | + ``KeyLocator`` element is now defined to be optionally present in generic ``SignatureInfo`` element. |
Alexander Afanasyev | 4b89611 | 2014-06-23 21:47:15 -0700 | [diff] [blame] | 98 | ``SignatureSha256WithRsa`` and ``SignatureSha256WithEcdsa`` still require ``KeyLocator`` to be always present. |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 99 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 100 | Version 0.1 |
| 101 | ----------- |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 102 | |
| 103 | - **General** |
| 104 | |
| 105 | + XML-based ccnb packet encoding is replaced by TLV encoding |
| 106 | |
| 107 | - **Name** |
| 108 | |
| 109 | + The name encoding is changed from binary XML to TLV format |
| 110 | + The discussions on naming conventions and the use of special markers inside NameComponents are removed from packet specification, and will be covered by a separate technical document |
| 111 | + Deprecated zero-length name component |
| 112 | |
| 113 | - **Interest Packet** |
| 114 | |
| 115 | + ``Nonce`` is changed from optional to required |
| 116 | + ``PublisherPublicKeyDigest`` is replaced by ``PublisherPublicKeyLocator`` |
| 117 | + ``AnswerOriginKind`` is simplified from 4bits to a 1-bit ``MustBeFresh`` |
| 118 | + ``FaceID`` has been removed |
| 119 | + ``InterestLifetime`` changes the unit to the number of milliseconds |
| 120 | + Removed Bloom Filter from Exclude |
| 121 | + Changed default semantics of staleness |
| 122 | |
| 123 | Specifically, NDN-TLV Interest without any selectors will bring any data that matches the name, and only when ``MustBeFresh`` selector is enabled it will try to honor freshness, specified in Data packets. |
| 124 | With Binary XML encoded Interests, the default behavior was to bring "fresh" data and return "stale" data only when ``AnswerOriginKind`` was set to 3. |
| 125 | |
| 126 | Application developers must be aware of this change, reexamine the Interest expression code, and enable ``MustBeFresh`` selector when necessary. |
| 127 | |
| 128 | - **Data Packet** |
| 129 | |
| 130 | + The structure of Data packet is changed: |
| 131 | |
| 132 | * ``Name``, ``MetaInfo``, ``Content``, ``Signature{SignatureInfo, SignatureValue}`` |
| 133 | |
| 134 | + ``SignedInfo`` is renamed to ``MetaInfo`` and its content is changed |
| 135 | + ``PublisherPublicKeyDigest`` and ``ExtOpt`` are removed. |
| 136 | + ``Timestamp`` is removed |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 137 | + ``KeyLocator`` is moved to be inside the ``Signature`` (``SignatureInfo``) element |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 138 | + Three content types, ENCR, GONE, and NACK are removed |
| 139 | + ``FreshnessSeconds`` is renamed to ``FreshnessPeriod`` and is expressed in units of milliseconds |
| 140 | |
| 141 | - **Signature** |
| 142 | |
| 143 | + ``Signature`` is moved to the end of Data packet. |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 144 | + ``KeyLocator`` is moved to be a part of the ``SignatureInfo`` element, if it is applicable for the specific signature type. |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 145 | |
| 146 | The rationale for the move is to make Signature (sequence of ``SignatureInfo`` and ``SignatureValue`` TLVs) self-contained and self-sufficient. |
| 147 | |
| 148 | + Signature type (or signing method information) is expressed as an assigned integer value (with no assumed default), rather than OID. |
| 149 | + Added support for hash-only "signature" |
| 150 | + The current specification does not define Merkle Hash Tree Aggregated Signatures, but it is expected that such (or similar) signatures will be defined in future version of this specification |