Project

General

Profile

FaceMgmt » History » Version 98

Davide Pesavento, 09/07/2018 01:26 PM

1 20 Junxiao Shi
# Face Management
2 1 Junxiao Shi
3 82 Davide Pesavento
{{>toc}}
4 38 Alex Afanasyev
5 20 Junxiao Shi
**Face Management** is a module of [[Management|NFD Management protocol]].
6
It provides:
7 1 Junxiao Shi
8 20 Junxiao Shi
* commands to create and destroy faces
9
* commands to enable and disable [[LocalControlHeader]] features on a face
10
* a dataset of description of all active faces and their counters
11 33 Junxiao Shi
* a dataset of description of all active channels
12 20 Junxiao Shi
* a notification stream for face creating and destroying events
13 1 Junxiao Shi
14 45 Junxiao Shi
Face Management commands, datasets, and notifications are available under namespace `ndn:/localhost/nfd/faces`.
15 12 Alex Afanasyev
16
17 20 Junxiao Shi
## FaceUri
18 1 Junxiao Shi
19 27 Junxiao Shi
A FaceUri represents the underlying protocol and address used by a Face.  
20
Every Face has two FaceUris: one for local endpoint, and the other for remote endpoint.
21 1 Junxiao Shi
22 27 Junxiao Shi
### UDP
23 9 Junxiao Shi
24 30 Junxiao Shi
`udp[4|6]://<IP-or-host>[:<port>]`  
25 2 Alex Afanasyev
26 9 Junxiao Shi
Examples:
27 1 Junxiao Shi
28 20 Junxiao Shi
* `udp4://192.0.2.1:6363` (canonical form)
29
* `udp6://[2001:db8::1]:6363` (canonical form)
30 71 Alex Afanasyev
* `udp6://[fe80::1068:dddb:fe26:fe3f%en0]:6363` (canonical form for link-local IPv6 addresses)
31
* `udp6://[fe80::1068:dddb:fe26:fe3f%25en0]:6363` (equivalent, but not canonical, version of the above FaceUri)
32 1 Junxiao Shi
* `udp://192.0.2.1` (remote-port defaults to 6363)
33
* `udp://example.net:6363`
34
* `udp4://example.net:6363` (resolve hostname to IPv4 address only)
35 9 Junxiao Shi
* `udp6://example.net:6363` (resolve hostname to IPv6 address only)
36 27 Junxiao Shi
* `udp4://224.0.23.170:56363` (multicast, canonical form)
37 1 Junxiao Shi
38 61 Davide Pesavento
LocalUri of a NIC-associated UDP face has the form:
39
40
`udp[4|6]+dev://<NIC>:<port>`
41
42 1 Junxiao Shi
This is only used in face dataset.
43 61 Davide Pesavento
44 51 Junxiao Shi
Examples:
45
46 60 Junxiao Shi
* `udp4+dev://eth1:6363`
47
* `udp6+dev://en0:6363`
48 51 Junxiao Shi
49 1 Junxiao Shi
### TCP
50
51 30 Junxiao Shi
`tcp[4|6]://<IP-or-host>[:<port>]`
52 1 Junxiao Shi
53
Examples:
54
55 20 Junxiao Shi
* `tcp4://192.0.2.1:6363` (canonical form)
56
* `tcp6://[2001:db8::1]:6363` (canonical form)
57 71 Alex Afanasyev
* `tcp6://[fe80::1068:dddb:fe26:fe3f%en0]:6363` (canonical form for link-local IPv6 addresses)
58
* `tcp6://[fe80::1068:dddb:fe26:fe3f%25en0]:6363` (equivalent, but not canonical, version of the above FaceUri)
59 1 Junxiao Shi
* `tcp://192.0.2.1` (remote-port defaults to 6363)
60
* `tcp://example.net:6363`
61 9 Junxiao Shi
* `tcp4://example.net:6363` (resolve hostname to IPv4 address only)
62 1 Junxiao Shi
* `tcp6://example.net:6363` (resolve hostname to IPv6 address only)
63
64
### UNIX stream
65
66 9 Junxiao Shi
`unix://<path>`
67 1 Junxiao Shi
68
Examples:
69
70 61 Davide Pesavento
* `unix:///var/run/nfd.sock` (note that there are three forward-slashes after 'unix:')
71 1 Junxiao Shi
72 84 Davide Pesavento
### File descriptor
73 30 Junxiao Shi
74
`fd://<file-descriptor>`
75
76
Examples:
77
78
* `fd://6`
79
80 1 Junxiao Shi
### Ethernet
81 27 Junxiao Shi
82 42 Junxiao Shi
`ether://[<MAC>]`
83 1 Junxiao Shi
84
Examples:
85 42 Junxiao Shi
86
* `ether://[08:00:27:01:01:01]`
87 1 Junxiao Shi
* `ether://[33:33:01:01:01:01]` (multicast)
88
89 84 Davide Pesavento
### Network device
90 1 Junxiao Shi
91 61 Davide Pesavento
`dev://<interface-name>`
92 30 Junxiao Shi
93
Examples:
94
95 1 Junxiao Shi
* `dev://eth0`
96
97
### Underlying protocol and FaceUri scheme
98
99 67 Junxiao Shi
Underlying protocol     | Remote FaceUri scheme            | Local FaceUri scheme
100
----------------------- | -------------------------------- | --------------------------
101
IPv4 UDP unicast        | udp4                             | udp4
102
IPv6 UDP unicast        | udp6                             | udp6
103
IPv4 UDP multicast      | udp4 (multicast IP)              | udp4 (local IP, same port)
104
IPv4 UDP NIC-associated | udp4                             | udp4+dev
105
IPv6 UDP NIC-associated | udp6                             | udp6+dev
106
IPv4 TCP                | tcp4                             | tcp4
107
IPv6 TCP                | tcp6                             | tcp6
108
UNIX stream             | fd (file descriptor on NFD side) | unix (socket path)
109
Ethernet unicast        | ether                            | dev
110
Ethernet multicast      | ether                            | dev
111
WebSocket               | wsclient                         | ws
112 46 Junxiao Shi
113
## Static Face Attributes
114
115
**FaceScope** indicates whether the face is local for [[ScopeControl|scope control]] purposes.
116
117
* non-local(=0)
118
* local(=1)
119
120
**FacePersistency** indicates whether the face is persistent.
121
122
* on-demand(=1), face closes if it remains idle for some time
123
* persistent(=0), face remains open until it's explicitly destroyed or there's a transport failure
124
* permanent(=2), face remains open until it's explicitly destroyed; transport failures will be recovered internally
125
126
**LinkType** indicates the type of communication link.
127
128
* point-to-point(=0), communication with one peer
129
* multi-access(=1), communication with a multicast group
130 75 Davide Pesavento
* ad-hoc(=2), communication over a wireless ad hoc network
131 52 Junxiao Shi
132
**LocalFieldsEnabled** indicates whether the face allows [[NDNLPv2]] NextHopFaceId, CachePolicy, IncomingFaceId fields.
133
134
* yes(=1), allows these fields; this is valid only if FaceScope=local
135
* no(=0), disallows these fields
136
137 74 Eric Newberry
**LpReliabilityEnabled** indicates whether the face has the [[NDNLPv2]] reliability feature enabled.
138 69 Eric Newberry
139
* yes(=1), enables this feature
140
* no(=0), disables this feature
141 1 Junxiao Shi
142 74 Eric Newberry
**CongestionMarkingEnabled** indicates whether the face has congestion marking based upon send queue length enabled.
143
144
* yes(=1), enables this feature
145
* no(=0), disables this feature
146
147
**BaseCongestionMarkingInterval** indicates the base marking interval for congestion marking.
148
149 77 Eric Newberry
The value of this attribute is the base marking interval in nanoseconds, which is used to compute the interval at which congested packets will be marked.
150 74 Eric Newberry
151
**DefaultCongestionThreshold** indicates the default congestion threshold if the face does not support retrieving the send queue capacity.
152
153 76 Davide Pesavento
The value of this attribute is the default congestion threshold in bytes.
154 74 Eric Newberry
155 85 Eric Newberry
**Mtu** contains a user-specified MTU to override the automatic MTU of the transport.
156
157 87 Davide Pesavento
The value of this attribute is the MTU of the transport in bytes. A transport type may limit the acceptable range of this value or even ignore it altogether.
158 85 Eric Newberry
159 52 Junxiao Shi
### Flags and Mask
160
161
Some attributes are collected as inclusive OR into a **Flags** field in commands and datasets.
162
These attributes are: (bit 0 is the least significant bit)
163
164
* bit 0: LocalFieldsEnabled
165 1 Junxiao Shi
* bit 1: LpReliabilityEnabled
166 74 Eric Newberry
* bit 2: CongestionMarkingEnabled
167 55 Junxiao Shi
168 1 Junxiao Shi
## Control Commands
169
170 20 Junxiao Shi
[[ControlCommand]] **management-module**: `faces`
171 41 Junxiao Shi
172
### Create a face
173 1 Junxiao Shi
174
**command-verb**: `create`
175 46 Junxiao Shi
176
ControlParameters fields:
177 1 Junxiao Shi
178
* **Uri** (required): canonical remote FaceUri of the face to create.
179 72 Davide Pesavento
* **LocalUri** (optional): canonical local FaceUri of the face to create; e.g., FaceUri of the local interface for an Ethernet unicast face.
180 1 Junxiao Shi
* **FacePersistency** (optional): either *persistent* or *permanent*; creating *on-demand* faces is not permitted. The default is *persistent*. See "static face attributes" for more information.
181 74 Eric Newberry
* **BaseCongestionMarkingInterval** (optional): see "static face attributes".
182
* **DefaultCongestionThreshold** (optional): see "static face attributes".
183 85 Eric Newberry
* **Mtu** (optional): see "static face attributes".
184 72 Davide Pesavento
* **Flags** (optional): see "static face attributes".
185 83 Davide Pesavento
* **Mask** (optional): MUST be specified if *Flags* is present, and omitted if *Flags* is omitted.
186 1 Junxiao Shi
187 65 Davide Pesavento
This command allows the creation of UDP unicast, Ethernet unicast, and TCP faces only.  
188 50 Junxiao Shi
If the command succeeds, the \<body> of the ControlResponse block contains the ControlParameters describing the current properties of the created face:
189 1 Junxiao Shi
190 64 Alex Afanasyev
* **FaceId**
191 1 Junxiao Shi
* **Uri**
192 64 Alex Afanasyev
* **LocalUri**
193 1 Junxiao Shi
* **FacePersistency**
194 78 Eric Newberry
* **BaseCongestionMarkingInterval** (optional)
195
* **DefaultCongestionThreshold** (optional)
196 85 Eric Newberry
* **Mtu** (optional)
197 90 Eric Newberry
* **Flags**: contains effective values for the *LocalFieldsEnabled*, *LpReliabilityEnabled*, and *CongestionMarkingEnabled* bits.
198 66 Davide Pesavento
199 97 Davide Pesavento
If this creation would conflict with an existing face (e.g., same underlying protocol and remote endpoint), the command fails with StatusCode 409, and the \<body> of the ControlResponse block contains the ControlParameters describing the existing face, with the same fields as above.
200 52 Junxiao Shi
201 1 Junxiao Shi
If the request attempts to create a face other than UDP unicast, Ethernet unicast, or TCP, or if a static property specified in the request is not acceptable, the command fails with StatusCode 406.
202 79 Eric Newberry
203 1 Junxiao Shi
If face creation fails due to a socket error (e.g. TCP connection timeout), the command fails with StatusCode 504.
204
205 88 Eric Newberry
If *BaseCongestionMarkingInterval* or *DefaultCongestionThreshold* are omitted from the ControlParameters sent with the creation command, the omitted static properties are left at their implementation-defined default values.
206 1 Junxiao Shi
207 95 Eric Newberry
If *Mtu* is omitted from the ControlParameters sent with the creation command, the automatic MTU of the transport is used as the MTU of the face. A forwarder MAY impose an implementation-defined minimum to the MTU specified during face creation. The current minimum in NFD is 64 bytes. In the response, the *Mtu* field in ControlParameters contains the effective MTU of the face (in bytes), capped at a maximum of `MAX_NDN_PACKET_SIZE` (8800 bytes), even if the MTU of the underlying transport is infinite. If *Mtu* is omitted from the response, the face and/or forwarder does not support MTU reporting.
208 85 Eric Newberry
209 84 Davide Pesavento
### Update the static properties of a face
210 1 Junxiao Shi
211 52 Junxiao Shi
**command-verb**: `update`
212 1 Junxiao Shi
213
ControlParameters fields:
214 64 Alex Afanasyev
215
* **FaceId** (optional)
216 81 Davide Pesavento
* **FacePersistency** (optional): one of *on-demand*, *persistent*, or *permanent*. See "static face attributes" for more information.
217 1 Junxiao Shi
* **BaseCongestionMarkingInterval** (optional): see "static face attributes".
218
* **DefaultCongestionThreshold** (optional): see "static face attributes".
219 90 Eric Newberry
* **Flags** (optional): allows *LocalFieldsEnabled*, *LpReliabilityEnabled*, and *CongestionMarkingEnabled* only. See "static face attributes" for more information.
220 81 Davide Pesavento
* **Mask** (optional): MUST be specified if *Flags* is present, and omitted if *Flags* is omitted.
221 52 Junxiao Shi
222 81 Davide Pesavento
*FaceId* is the FaceId returned in [[FaceMgmt|Face Management]].
223
If *FaceId* is omitted or is set to zero, it is implied to be that of the requesting face (self updating).
224
If the face does not exist, this command fails with StatusCode 404.
225 1 Junxiao Shi
226 79 Eric Newberry
Static properties of the face are updated.
227 81 Davide Pesavento
If an optional property field is omitted or a bitfield is zero in *Mask*, that static property remains unchanged.
228 1 Junxiao Shi
If no static properties are changed, this command does nothing, but is still considered successful.
229 55 Junxiao Shi
230 1 Junxiao Shi
If the command succeeds, \<body> in ControlResponse block contains ControlParameters describing the current properties of the face:
231
232
* **FaceId**
233
* **FacePersistency**
234 78 Eric Newberry
* **BaseCongestionMarkingInterval** (optional)
235
* **DefaultCongestionThreshold** (optional)
236 81 Davide Pesavento
* **Flags**: contains effective values for *LocalFieldsEnabled*, *LpReliabilityEnabled*, and *CongestionMarkingEnabled* bits.
237 1 Junxiao Shi
238
If any of the requested changes is invalid, none of the changes should be performed, and this command fails with StatusCode 409.
239 81 Davide Pesavento
The \<body> in ControlResponse block contains ControlParameters that includes only invalid fields; if some of the bit fields chosen in *Flags*+*Mask* is invalid, the \<body> block should also contain a *Mask* field indicating which bits are invalid, and echo back the original *Flags* field.
240
If the request had been sent without those fields (or bitfields in *Mask*), it would have been successful.
241 20 Junxiao Shi
242 1 Junxiao Shi
### Destroy a face
243 20 Junxiao Shi
244 26 Junxiao Shi
**command-verb:** `destroy`
245 20 Junxiao Shi
246 39 Junxiao Shi
ControlParameters fields:
247 1 Junxiao Shi
248 64 Alex Afanasyev
* **FaceId** (required)
249 39 Junxiao Shi
250 1 Junxiao Shi
If the specified face does not exist, this command does nothing, but is still considered successful.
251
252 40 Junxiao Shi
## Face Dataset
253 1 Junxiao Shi
254
Description and counters of all active faces are published as a [[StatusDataset|Status Dataset]] at `ndn:/localhost/nfd/faces/list`.
255 39 Junxiao Shi
256
Each face is represented by a **FaceStatus** block:
257 1 Junxiao Shi
258 39 Junxiao Shi
    FaceStatus      ::= FACE-STATUS-TYPE TLV-LENGTH
259
                          FaceId
260 37 Junxiao Shi
                          Uri (remote FaceUri)
261 39 Junxiao Shi
                          LocalUri
262 1 Junxiao Shi
                          ExpirationPeriod?
263
                          FaceScope
264
                          FacePersistency
265
                          LinkType
266 78 Eric Newberry
                          BaseCongestionMarkingInterval?
267 1 Junxiao Shi
                          DefaultCongestionThreshold?
268 85 Eric Newberry
                          Mtu?
269 1 Junxiao Shi
                          NInInterests
270 67 Junxiao Shi
                          NInData
271 39 Junxiao Shi
                          NInNacks
272 67 Junxiao Shi
                          NOutInterests
273 49 Junxiao Shi
                          NOutData
274
                          NOutNacks
275 46 Junxiao Shi
                          NInBytes
276 1 Junxiao Shi
                          NOutBytes
277 96 Alex Afanasyev
                          Flags
278 46 Junxiao Shi
279
    Uri             ::= URI-TYPE TLV-LENGTH
280 39 Junxiao Shi
                          FaceUri in UTF-8 encoding
281 46 Junxiao Shi
282 1 Junxiao Shi
    LocalUri        ::= LOCAL-URI-TYPE TLV-LENGTH
283 46 Junxiao Shi
                          FaceUri in UTF-8 encoding
284 1 Junxiao Shi
    
285
    ; other TLVs have nonNegativeInteger as value
286
287 40 Junxiao Shi
* **Uri** is a FaceUri representing remote endpoint.
288 39 Junxiao Shi
* **LocalUri** is a FaceUri representing local endpoint.
289 40 Junxiao Shi
* **ExpirationPeriod** is the remaining lifetime of this face.
290 46 Junxiao Shi
  If this field is omitted, the face has infinite lifetime.
291 40 Junxiao Shi
  Currently, this is applicable to on-demand datagram faces only.
292 46 Junxiao Shi
* **FaceScope** indicates whether the face is local for [[ScopeControl|scope control]] purposes.
293 1 Junxiao Shi
  See "static face attributes" for more information.
294 40 Junxiao Shi
* **FacePersistency** indicates whether the face is persistent.
295 1 Junxiao Shi
  See "static face attributes" for more information.
296 52 Junxiao Shi
* **LinkType** indicates the type of communication link
297 1 Junxiao Shi
  See "static face attributes" for more information.
298 77 Eric Newberry
* **BaseCongestionMarkingInterval** indicates the base interval used to compute the interval at which congested packets will be marked (in nanoseconds).
299 1 Junxiao Shi
  See "static face attributes" for more information.
300 76 Davide Pesavento
* **DefaultCongestionThreshold** indicates the default threshold for congestion if the face does not support retrieving the send queue capacity (in bytes).
301 1 Junxiao Shi
  See "static face attributes" for more information.
302 94 Davide Pesavento
* **Mtu** contains the effective MTU of the face (in bytes), capped at `MAX_NDN_PACKET_SIZE` (8800 bytes), even if the MTU of the underlying transport is infinite. If this field is omitted, the forwarder and/or face does not support MTU reporting.
303 85 Eric Newberry
  See "static face attributes" for more information.
304 46 Junxiao Shi
* **NInInterests**: number of incoming Interest packets since the face is established.
305 67 Junxiao Shi
* **NInData** counts the number of incoming Data packets since the face is established.
306 46 Junxiao Shi
* **NInNacks** counts the number of incoming Nack packets since the face is established.
307 1 Junxiao Shi
* **NOutInterests** counts the number of outgoing Interest packets since the face is established.
308 67 Junxiao Shi
* **NOutData** counts the number of outgoing Data packets since the face is established.
309 37 Junxiao Shi
* **NOutNacks** counts the number of outgoing Nack packets since the face is established.
310
* **NInBytes** counts the number of bytes of link layer packets received via this face.
311
  This counter is initialized to zero when the face is established, and can wrap around after overflowing unsigned 64-bit integer range.
312 1 Junxiao Shi
* **NOutBytes** counts the number of bytes of link layer packets sent via this face.
313
  This counter is initialized to zero when the face is established, and can wrap around after overflowing unsigned 64-bit integer range.
314 98 Davide Pesavento
* **Flags** contains these bitfields: *LocalFieldsEnabled*, *LpReliabilityEnabled*, *CongestionMarkingEnabled*.
315
  See "static face attributes" for more information.
316 37 Junxiao Shi
317 84 Davide Pesavento
### Query operation
318 1 Junxiao Shi
319 37 Junxiao Shi
The query operation allows one to retrieve a subset of face dataset that contains faces satisfying a filter.
320
321
To run a query, the consumer should express an Interest with Name: `ndn:/localhost/nfd/faces/query/<filter>`, where `<filter>` is a **FaceQueryFilter** block that specifies zero or more conditions.
322
323
    FaceQueryFilter ::= FACE-QUERY-FILTER-TYPE TLV-LENGTH
324 40 Junxiao Shi
                          FaceId?
325
                          UriScheme?
326
                          Uri?
327 37 Junxiao Shi
                          LocalUri?
328
                          FaceScope?
329 1 Junxiao Shi
                          FacePersistency?
330 37 Junxiao Shi
                          LinkType?
331
    
332
    UriScheme       ::= URI-SCHEME-TYPE TLV-LENGTH
333
                          string in UTF-8
334
335 40 Junxiao Shi
* **FaceId** permits a face if its FaceId equals the value
336
* **UriScheme** permits a face if the scheme part of its local FaceUri or remote FaceUri equals the value
337
* **Uri** permits a face if its remote FaceUri equals the value
338 1 Junxiao Shi
* **LocalUri** permits a face if its local FaceUri equals the value
339
* **FaceScope** permits a face if its *FaceScope* attribute equals the value
340 39 Junxiao Shi
* **FacePersistency** permits a face if its *FacePersistency* attribute equals the value
341 37 Junxiao Shi
* **LinkType** permits a face if its *LinkType* attribute equals the value
342
343
A face must satisfy ALL conditions to satisfy the filter.
344 1 Junxiao Shi
Faces that satisfy the filter are represented by **FaceStatus** blocks, and published as a [[StatusDataset]] under the Interest Name (a Data packet's Name would be `ndn:/localhost/nfd/faces/query/<filter>/<version>/<segment>`).
345 37 Junxiao Shi
346 41 Junxiao Shi
Examples of filters:
347 1 Junxiao Shi
348 75 Davide Pesavento
* a specific face: `FaceId=260`
349
* a specific TCP tunnel: `Uri=tcp4://192.0.2.1:6363`  
350
  (note: FaceUri must precisely match the canonical form: use either "tcp4" or "tcp6" instead of "tcp", use IP address instead of domain name, include port number)
351
* all TCP tunnels: `UriScheme=tcp`  
352
  (note: "tcp" permits both "tcp4" and "tcp6", "udp" permits both "udp4" and "udp6")
353
* all UDP multi-access faces: `UriScheme=udp` && `LinkType=multi-access`
354
* all Ethernet faces: `UriScheme=ether`  
355
  (note: UriScheme matches against both local and remote FaceUri, "dev" also works)
356 1 Junxiao Shi
* all faces: no condition  
357 75 Davide Pesavento
  (note: this is equivalent to face dataset, and face dataset should be preferred for this purpose)
358 33 Junxiao Shi
359
## Channel Dataset
360
361 20 Junxiao Shi
Description of all active channels is published as a [[StatusDataset|Status Dataset]] at `ndn:/localhost/nfd/faces/channels`.
362 1 Junxiao Shi
363
Each channel is represented by a **ChannelStatus** block:
364 20 Junxiao Shi
365
    ChannelStatus    := CHANNEL-STATUS-TYPE TLV-LENGTH
366 21 Alex Afanasyev
                          LocalUri
367 20 Junxiao Shi
368 83 Davide Pesavento
* **LocalUri** is a FaceUri representing the channel's local endpoint.
369 21 Alex Afanasyev
370 37 Junxiao Shi
## Face Status Change Notification
371
372
Face status change events are published as a [[Notification|Notification Stream]] at `ndn:/localhost/nfd/faces/events`.
373 1 Junxiao Shi
Notifications of all faces are sent into the same notification stream.
374 37 Junxiao Shi
375 83 Davide Pesavento
The Content of each notification Data packet is a **FaceEventNotification** block:
376 23 Alex Afanasyev
377 37 Junxiao Shi
    FaceEventNotification ::= FACE-EVENT-NOTIFICATION-TYPE TLV-LENGTH
378 40 Junxiao Shi
                                FaceEventKind
379
                                FaceId
380
                                Uri
381 25 Junxiao Shi
                                LocalUri
382 23 Alex Afanasyev
                                FaceScope
383
                                FacePersistency
384 58 Eric Newberry
                                LinkType
385 25 Junxiao Shi
                                Flags
386 23 Alex Afanasyev
    
387 9 Junxiao Shi
    FaceEventKind         ::= FACE-EVENT-KIND-TYPE TLV-LENGTH
388
                                nonNegativeInteger
389
390 1 Junxiao Shi
**FaceEventKind** indicates the kind of event. Its possible values are:
391 34 Junxiao Shi
392 83 Davide Pesavento
* 1 = face is created
393
* 2 = face is destroyed
394
* 3 = face goes UP (from DOWN state)
395
* 4 = face goes DOWN (from UP state)
396 32 Junxiao Shi
397 20 Junxiao Shi
## TLV-TYPE assignments
398
399
Type                                        | Assigned value    | Assigned value (hex)
400 39 Junxiao Shi
------------------------------------------- | ----------------- | --------------------
401 40 Junxiao Shi
FaceStatus                                  | 128               | 0x80
402
LocalUri                                    | 129               | 0x81
403
ChannelStatus                               | 130               | 0x82
404 75 Davide Pesavento
UriScheme                                   | 131               | 0x83
405 1 Junxiao Shi
FaceScope                                   | 132               | 0x84
406
FacePersistency                             | 133               | 0x85
407
LinkType                                    | 134               | 0x86
408 74 Eric Newberry
BaseCongestionMarkingInterval               | 135               | 0x87
409 1 Junxiao Shi
DefaultCongestionThreshold                  | 136               | 0x88
410 85 Eric Newberry
Mtu                                         | 137               | 0x89
411 67 Junxiao Shi
NInInterests                                | 144               | 0x90
412 48 Junxiao Shi
NInData                                     | 145               | 0x91
413 1 Junxiao Shi
NInNacks                                    | 151               | 0x97
414 67 Junxiao Shi
NOutInterests                               | 146               | 0x92
415 1 Junxiao Shi
NOutData                                    | 147               | 0x93
416
NOutNacks                                   | 152               | 0x98
417
NInBytes                                    | 148               | 0x94
418 39 Junxiao Shi
NOutBytes                                   | 149               | 0x95
419 1 Junxiao Shi
FaceQueryFilter                             | 150               | 0x96
420
FaceEventNotification                       | 192               | 0xc0
421
FaceEventKind                               | 193               | 0xc1
422
(reserved, formerly FaceFlags)              | 194               | 0xc2