blob: db4e6557b156210409f937731daa5c03491c4da1 [file] [log] [blame]
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -07001.. _local-prefix-discovery:
2
3Discover local hub prefix
4=========================
5
6Some applications need to discover prefix(es) under which they can publish data
7/ which Interests local hub will be able to forward down to the application.
8In order to discover that, applications need to send an interest for
Junxiao Shi0d6d0362015-02-14 10:02:47 -07009``/localhop/nfd/rib/routable-prefixes`` prefix. Response data to the
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070010interest contains a list of prefixes and should be encoded as:
11
12::
13
14 Response ::= DATA-TYPE TLV-LENGTH
Junxiao Shi0d6d0362015-02-14 10:02:47 -070015 Name (= /localhop/nfd/rib/routable-prefixes/[version]/[segment])
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070016 MetaInfo (= ResponseMetaInfo)
17 Content (= ResponseContent)
18 Signature
19
20 ResponseMetaInfo ::= META-INFO-TYPE TLV-LENGTH
21 ContentType (= DATA)
22 FreshnessPeriod (= 5000)
23
24 ResponseContent ::= Name+
25
26.. note::
Alexander Afanasyev7c10b3b2015-01-20 12:24:27 -080027 ResponseContent should contain at least one Name, which should be routable
28 towards the face from which the request has been received. The requester may
29 process list of the returned names and pick whichever it wants to use.
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070030
Junxiao Shi0d6d0362015-02-14 10:02:47 -070031For now, the ``/localhop/nfd/rib/routable-prefixes`` data is served by
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070032:ref:`ndn-autoconfig-server`.