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 | |
Junxiao Shi | 78ce295 | 2019-05-07 15:34:00 -0400 | [diff] [blame] | 7 | - Rewrite TLV syntax specifications using `IETF Augmented BNF (RFC 5234) <https://tools.ietf.org/html/rfc5234>`__ |
| 8 | |
Junxiao Shi | 459e466 | 2019-05-31 15:28:03 +0000 | [diff] [blame] | 9 | + Require shortest encoding for TLV-TYPE and TLV-LENGTH numbers |
| 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 | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 20 | |
| 21 | - **Data** |
| 22 | |
| 23 | + Make ``MetaInfo`` and ``Content`` elements optional |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 24 | + 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] | 25 | |
| 26 | - **Name** |
| 27 | |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 28 | + Lift restriction on name component types, allowing types in the range ``1`` - ``32767`` |
| 29 | + 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^] | 30 | + Add well-known special-use component types: |
| 31 | |
| 32 | - ``ParametersSha256DigestComponent`` (type 2) |
| 33 | - ``KeywordNameComponent`` (type 32) |
| 34 | - ``SegmentNameComponent`` (type 50) |
| 35 | - ``ByteOffsetNameComponent`` (type 52) |
| 36 | - ``VersionNameComponent`` (type 54) |
| 37 | - ``TimestampNameComponent`` (type 56) |
| 38 | - ``SequenceNumNameComponent`` (type 58) |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 39 | |
Davide Pesavento | 3c0bc31 | 2020-05-18 22:03:09 -0400 | [diff] [blame] | 40 | - **Signature** |
| 41 | |
| 42 | + Require all compliant implementations to support the ``SignatureSha256WithEcdsa`` signature type using NIST curve P-256 |
| 43 | + Redefine the signed portion of Data packets to be more future-proof |
| 44 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 45 | Version 0.2.1 |
| 46 | ------------- |
spirosmastorakis | 988e741 | 2016-10-27 14:01:59 -0700 | [diff] [blame] | 47 | |
| 48 | - Add definition of Link Object |
| 49 | |
| 50 | - **Interest** |
| 51 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 52 | + Add default of leftmost child if ChildSelector element not present |
| 53 | + Add specification of ForwardingHint element |
spirosmastorakis | 988e741 | 2016-10-27 14:01:59 -0700 | [diff] [blame] | 54 | |
Eric Newberry | 5651986 | 2017-02-13 13:26:19 -0700 | [diff] [blame] | 55 | - **Data** |
| 56 | |
| 57 | + Updated Content Store semantics for Data packets that do not carry FreshnessPeriod. |
| 58 | |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 59 | Version 0.2 |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 60 | ----------- |
Junxiao Shi | a0d3682 | 2014-09-21 11:32:09 -0700 | [diff] [blame] | 61 | |
| 62 | - **Name** |
| 63 | |
| 64 | + Allow zero-length name component |
Alexander Afanasyev | 4b8be21 | 2014-10-06 10:55:04 -0700 | [diff] [blame] | 65 | + Require implicit digest to be specified using ``ImplicitSha256Digest`` name component |
Junxiao Shi | a0d3682 | 2014-09-21 11:32:09 -0700 | [diff] [blame] | 66 | |
Alexander Afanasyev | 948affe | 2016-09-13 13:15:29 -0700 | [diff] [blame] | 67 | - **Signature** |
| 68 | |
| 69 | + Add spec for ``SignatureHmacWithSha256`` |
| 70 | |
Junxiao Shi | def7fc5 | 2015-06-10 13:29:21 -0700 | [diff] [blame] | 71 | - **Interest** |
| 72 | |
| 73 | + Delete deprecated ``Scope`` guider |
Alexander Afanasyev | 948affe | 2016-09-13 13:15:29 -0700 | [diff] [blame] | 74 | + Restrict Interest to have name with at least one name component |
| 75 | |
| 76 | - **Data** |
| 77 | |
| 78 | + 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] | 79 | |
Junxiao Shi | 4406fdd | 2015-06-10 13:28:10 -0700 | [diff] [blame] | 80 | - **TLV-TYPE** |
| 81 | |
| 82 | + Reserve 800-1000 range for link protocol |
| 83 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 84 | Version 0.1.1 |
| 85 | ------------- |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 86 | |
| 87 | - **Signature** |
| 88 | |
Alexander Afanasyev | 4b89611 | 2014-06-23 21:47:15 -0700 | [diff] [blame] | 89 | + New ``SignatureSha256WithEcdsa`` signature type for Elliptic Curve Digital Signature Algorithm (ECDSA). |
Alexander Afanasyev | f3e5e85 | 2014-06-13 22:44:02 -0700 | [diff] [blame] | 90 | + ``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] | 91 | + ``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] | 92 | ``SignatureSha256WithRsa`` and ``SignatureSha256WithEcdsa`` still require ``KeyLocator`` to be always present. |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 93 | |
Alexander Afanasyev | 13f86d8 | 2018-01-31 12:50:34 -0500 | [diff] [blame] | 94 | Version 0.1 |
| 95 | ----------- |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 96 | |
| 97 | - **General** |
| 98 | |
| 99 | + XML-based ccnb packet encoding is replaced by TLV encoding |
| 100 | |
| 101 | - **Name** |
| 102 | |
| 103 | + The name encoding is changed from binary XML to TLV format |
| 104 | + 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 |
| 105 | + Deprecated zero-length name component |
| 106 | |
| 107 | - **Interest Packet** |
| 108 | |
| 109 | + ``Nonce`` is changed from optional to required |
| 110 | + ``PublisherPublicKeyDigest`` is replaced by ``PublisherPublicKeyLocator`` |
| 111 | + ``AnswerOriginKind`` is simplified from 4bits to a 1-bit ``MustBeFresh`` |
| 112 | + ``FaceID`` has been removed |
| 113 | + ``InterestLifetime`` changes the unit to the number of milliseconds |
| 114 | + Removed Bloom Filter from Exclude |
| 115 | + Changed default semantics of staleness |
| 116 | |
| 117 | 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. |
| 118 | With Binary XML encoded Interests, the default behavior was to bring "fresh" data and return "stale" data only when ``AnswerOriginKind`` was set to 3. |
| 119 | |
| 120 | Application developers must be aware of this change, reexamine the Interest expression code, and enable ``MustBeFresh`` selector when necessary. |
| 121 | |
| 122 | - **Data Packet** |
| 123 | |
| 124 | + The structure of Data packet is changed: |
| 125 | |
| 126 | * ``Name``, ``MetaInfo``, ``Content``, ``Signature{SignatureInfo, SignatureValue}`` |
| 127 | |
| 128 | + ``SignedInfo`` is renamed to ``MetaInfo`` and its content is changed |
| 129 | + ``PublisherPublicKeyDigest`` and ``ExtOpt`` are removed. |
| 130 | + ``Timestamp`` is removed |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 131 | + ``KeyLocator`` is moved to be inside the ``Signature`` (``SignatureInfo``) element |
Alexander Afanasyev | a6fc727 | 2014-06-13 11:58:06 -0700 | [diff] [blame] | 132 | + Three content types, ENCR, GONE, and NACK are removed |
| 133 | + ``FreshnessSeconds`` is renamed to ``FreshnessPeriod`` and is expressed in units of milliseconds |
| 134 | |
| 135 | - **Signature** |
| 136 | |
| 137 | + ``Signature`` is moved to the end of Data packet. |
Alexander Afanasyev | e9f4851 | 2018-01-15 23:44:50 -0500 | [diff] [blame] | 138 | + ``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] | 139 | |
| 140 | The rationale for the move is to make Signature (sequence of ``SignatureInfo`` and ``SignatureValue`` TLVs) self-contained and self-sufficient. |
| 141 | |
| 142 | + Signature type (or signing method information) is expressed as an assigned integer value (with no assumed default), rather than OID. |
| 143 | + Added support for hash-only "signature" |
| 144 | + 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 |