NFD Notification mechanism¶

NFD Notification mechanism notifies applications about events happening inside NFD.

Naming¶

• A stream of notifications is published under a certain Name prefix.
• A notification is a Data packet under this Name prefix with a sequence number.
  • The sequence numbers of notifications in the same stream should be consecutive and increasing.
  • Each notification is limited to one Data packet.

Example:

ndn:/localhost/nfd/faces/events/%01 // first notification
ndn:/localhost/nfd/faces/events/%02 // second notification

Notification publisher¶

Notifications from NFD are Data packets generated and signed by NFD.

These Data packets enter forwarding system via the InternalFace, and are subject to regular forwarding pipelines.
They should be admitted into the ContentStore.

Notification subscriber¶

The subscriber should typically request the Name of notification stream (ndn:/localhost/nfd/faces/events in the example) with ChildSelector=1 and Exclude=<Any><Component>seq</Component>, where seq is the version number of the latest received notification.

• If no new notification has been generated after seq, this Interest will stay in the PIT, and be satisfied when a new notification is generated.
• If one or more new notifications have been generated after seq, the Interest will be satisfied from the ContentStore, and the latest notification is returned.
  The subscriber can retrieve missing notifications between seq and the returned latest notification by expressing additional Interests.