blob: be8070bc8864f33c0c541409d50af3bc98f116d7 [file] [log] [blame]
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +00001.. _types:
2
Davide Pesavento738fd312019-02-07 13:40:16 -05003TLV-TYPE number assignments
4---------------------------
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +00005
Junxiao Shi1082b422017-07-18 23:37:52 +00006+---------------------------------------------+------------------+-----------------+
7| Type | Assigned number | Assigned number |
8| | (decimal) | (hexadecimal) |
9+=============================================+==================+=================+
Alexander Afanasyeve9315e72014-02-12 19:53:49 +000010| **Packet types** |
Junxiao Shi1082b422017-07-18 23:37:52 +000011+---------------------------------------------+------------------+-----------------+
12| Interest | 5 | 0x05 |
13+---------------------------------------------+------------------+-----------------+
14| Data | 6 | 0x06 |
15+---------------------------------------------+------------------+-----------------+
Alexander Afanasyev0bc9f1a2014-02-13 08:05:36 +000016| **Common fields** |
Junxiao Shi1082b422017-07-18 23:37:52 +000017+---------------------------------------------+------------------+-----------------+
18| Name | 7 | 0x07 |
19+---------------------------------------------+------------------+-----------------+
Junxiao Shib211da22017-12-14 20:05:35 +000020| GenericNameComponent | 8 | 0x08 |
Junxiao Shi1082b422017-07-18 23:37:52 +000021+---------------------------------------------+------------------+-----------------+
22| ImplicitSha256DigestComponent | 1 | 0x01 |
23+---------------------------------------------+------------------+-----------------+
Alexander Afanasyev9013a562018-08-08 09:48:41 -040024| ParametersSha256DigestComponent | 2 | 0x02 |
25+---------------------------------------------+------------------+-----------------+
Alexander Afanasyeva4397b82013-12-26 05:25:27 +000026| **Interest packet** |
Junxiao Shi1082b422017-07-18 23:37:52 +000027+---------------------------------------------+------------------+-----------------+
Alexander Afanasyeve9f48512018-01-15 23:44:50 -050028| CanBePrefix | 33 | 0x21 |
29+---------------------------------------------+------------------+-----------------+
30| MustBeFresh | 18 | 0x12 |
31+---------------------------------------------+------------------+-----------------+
32| ForwardingHint | 30 | 0x1e |
Junxiao Shi1082b422017-07-18 23:37:52 +000033+---------------------------------------------+------------------+-----------------+
34| Nonce | 10 | 0x0a |
35+---------------------------------------------+------------------+-----------------+
36| InterestLifetime | 12 | 0x0c |
37+---------------------------------------------+------------------+-----------------+
Alexander Afanasyeve9f48512018-01-15 23:44:50 -050038| HopLimit | 34 (non-critical)| 0x22 |
Junxiao Shi1082b422017-07-18 23:37:52 +000039+---------------------------------------------+------------------+-----------------+
Junxiao Shif2bbb902019-03-15 14:36:30 -040040| ApplicationParameters | 36 (non-critical)| 0x24 |
Junxiao Shi1082b422017-07-18 23:37:52 +000041+---------------------------------------------+------------------+-----------------+
Zhiyi Zhang0c04fd82018-09-04 16:29:47 -040042| InterestSignatureInfo | 44 (non-critical)| 0x2c |
43+---------------------------------------------+------------------+-----------------+
44| InterestSignatureValue | 46 (non-critical)| 0x2e |
45+---------------------------------------------+------------------+-----------------+
Alexander Afanasyeva4397b82013-12-26 05:25:27 +000046| **Data packet** |
Junxiao Shi1082b422017-07-18 23:37:52 +000047+---------------------------------------------+------------------+-----------------+
48| MetaInfo | 20 | 0x14 |
49+---------------------------------------------+------------------+-----------------+
50| Content | 21 | 0x15 |
51+---------------------------------------------+------------------+-----------------+
52| SignatureInfo | 22 | 0x16 |
53+---------------------------------------------+------------------+-----------------+
54| SignatureValue | 23 | 0x17 |
55+---------------------------------------------+------------------+-----------------+
Alexander Afanasyeva4397b82013-12-26 05:25:27 +000056| **Data/MetaInfo** |
Junxiao Shi1082b422017-07-18 23:37:52 +000057+---------------------------------------------+------------------+-----------------+
58| ContentType | 24 | 0x18 |
59+---------------------------------------------+------------------+-----------------+
60| FreshnessPeriod | 25 | 0x19 |
61+---------------------------------------------+------------------+-----------------+
62| FinalBlockId | 26 | 0x1a |
63+---------------------------------------------+------------------+-----------------+
Zhiyi Zhang0c04fd82018-09-04 16:29:47 -040064| **Signature** |
Junxiao Shi1082b422017-07-18 23:37:52 +000065+---------------------------------------------+------------------+-----------------+
66| SignatureType | 27 | 0x1b |
67+---------------------------------------------+------------------+-----------------+
68| KeyLocator | 28 | 0x1c |
69+---------------------------------------------+------------------+-----------------+
Junxiao Shi665ccf92018-07-13 13:23:23 -040070| KeyDigest | 29 | 0x1d |
71+---------------------------------------------+------------------+-----------------+
Zhiyi Zhang47e51372019-02-25 13:47:01 -080072| SignatureNonce | 38 (non-critical)| 0x26 |
73+---------------------------------------------+------------------+-----------------+
Zhiyi Zhang0c04fd82018-09-04 16:29:47 -040074| SignatureTime | 40 (non-critical)| 0x28 |
75+---------------------------------------------+------------------+-----------------+
76| SignatureSeqNum | 42 (non-critical)| 0x2a |
Zhiyi Zhang47e51372019-02-25 13:47:01 -080077+---------------------------------------------+------------------+-----------------+
Junxiao Shib211da22017-12-14 20:05:35 +000078| **Link Object** |
79+---------------------------------------------+------------------+-----------------+
80| Delegation | 31 | 0x1f |
81+---------------------------------------------+------------------+-----------------+
82| Preference | 30 | 0x1e |
83+---------------------------------------------+------------------+-----------------+
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +000084
Junxiao Shi78ce2952019-05-07 15:34:00 -040085.. note::
Davide Pesaventoec746762020-06-24 22:57:31 -040086 The ABNF grammar of this specification denotes the TLV-TYPE of element ``X`` as ``X-TYPE``.
87 For example, ``INTEREST-TYPE`` means ``%x05``, the TLV-TYPE of ``Interest`` encoded in ``VAR-NUMBER-1`` format.
Junxiao Shi78ce2952019-05-07 15:34:00 -040088
Alexander Afanasyevca58dc22013-12-28 21:04:59 +000089.. _type reservations:
90
Junxiao Shi1082b422017-07-18 23:37:52 +000091TLV-TYPE number reservations
92~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +000093
94+----------------+-----------------------------------------------------------+
Junxiao Shi1082b422017-07-18 23:37:52 +000095| Number range | Designation |
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +000096+================+===========================================================+
Alexander Afanasyeve9f48512018-01-15 23:44:50 -050097| 9 | Reserved, formerly `Selectors` |
Junxiao Shibdc75012015-01-13 22:09:12 -070098+----------------+-----------------------------------------------------------+
99| 11 | Reserved, formerly `Scope` |
Alexander Afanasyev718b86a2014-02-16 05:42:20 +0000100+----------------+-----------------------------------------------------------+
Alexander Afanasyeve9f48512018-01-15 23:44:50 -0500101| 13 | Reserved, formerly `MinSuffixComponents` |
102+----------------+-----------------------------------------------------------+
103| 14 | Reserved, formerly `MaxSuffixComponents` |
104+----------------+-----------------------------------------------------------+
105| 15 | Reserved, formerly `PublisherPublicKeyLocator` |
106+----------------+-----------------------------------------------------------+
107| 16 | Reserved, formerly `Exclude` |
108+----------------+-----------------------------------------------------------+
109| 17 | Reserved, formerly `ChildSelector` |
110+----------------+-----------------------------------------------------------+
111| 19 | Reserved, formerly `Any` |
112+----------------+-----------------------------------------------------------+
Junxiao Shib211da22017-12-14 20:05:35 +0000113| 32 | Reserved, formerly `SelectedDelegation` |
114+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000115| [80, 100] | Reserved for assignments related to local-link data |
Junxiao Shi4406fdd2015-06-10 13:28:10 -0700116| | processing, e.g., `NDNLP`_, etc. (1-byte encoding) |
Alexander Afanasyevb917c0b2014-02-12 19:53:48 +0000117+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000118| [101, 127] | Reserved for assignments related to the forwarder |
Alexander Afanasyev7455e9b2014-06-25 09:41:08 -0700119| | (1-byte encoding) |
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +0000120+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000121| all other | |
122| numbers in | |
123| [1, 127] | Reserved for future assignments (1-byte encoding) |
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +0000124+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000125| [128, 252] | For application use (1-byte encoding) |
126+----------------+-----------------------------------------------------------+
127| [800, 1000] | Reserved for assignments related to local-link data |
Junxiao Shi4406fdd2015-06-10 13:28:10 -0700128| | processing, e.g., `NDNLP`_, etc. (3-byte encoding) |
129+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000130| all other | Reserved for future assignments (3-byte encoding) |
131| numbers in | |
132| [253, 32767] | |
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +0000133+----------------+-----------------------------------------------------------+
Junxiao Shidcb0f372019-04-06 18:45:55 +0000134| >32767 | For application use (3-byte or 5-byte encoding) |
Alexander Afanasyevfffabfb2013-12-11 21:29:05 +0000135+----------------+-----------------------------------------------------------+
Alexander Afanasyev718b86a2014-02-16 05:42:20 +0000136
Junxiao Shi1082b422017-07-18 23:37:52 +0000137.. _NDNLP: https://redmine.named-data.net/projects/nfd/wiki/NDNLPv2