blob: d5b14d705e9a8988c9bd9d21348713139e3addc5 [file] [log] [blame]
hilata6ee6e072014-04-20 17:10:18 -05001.. _ndn-autoconfig-server:
2
Alexander Afanasyev49272f72014-04-06 21:49:46 -07003ndn-autoconfig-server
4=====================
5
hilata6ee6e072014-04-20 17:10:18 -05006Usage
7-----
Alexander Afanasyev49272f72014-04-06 21:49:46 -07008
9::
10
Junxiao Shif0dfb332017-02-02 05:32:25 +000011 ndn-autoconfig-server [-h] [-p <PREFIX>] [-p <PREFIX>] ... <FACEURI>
Alexander Afanasyev49272f72014-04-06 21:49:46 -070012
Alexander Afanasyev49272f72014-04-06 21:49:46 -070013Description
14-----------
15
Niv Sardi5e8755c2016-12-13 14:11:53 -030016``ndn-autoconfig-server`` is a daemon that implements the server part for the stage 1 of
hilata6ee6e072014-04-20 17:10:18 -050017:ref:`NDN hub discovery procedure`.
18
19This daemon essentially waits for Interests for ``/localhop/ndn-autoconf/hub`` and
Niv Sardi5e8755c2016-12-13 14:11:53 -030020satisfies them with a Data packet that contains a TLV-encoded FaceUri block. The value of
21this block is the ``Uri`` for the HUB, preferably a UDP tunnel.
hilata6ee6e072014-04-20 17:10:18 -050022
Junxiao Shif0dfb332017-02-02 05:32:25 +000023``<FACEURI>``
hilata6ee6e072014-04-20 17:10:18 -050024 FaceUri for this NDN hub.
25
Junxiao Shif0dfb332017-02-02 05:32:25 +000026``-p <PREFIX>``
Niv Sardi5e8755c2016-12-13 14:11:53 -030027 A local prefix for which the local hub allows end applications to register prefixes
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070028 (See more details in :ref:`local-prefix-discovery`). One can supply more than one
29 prefixes. All supplied prefixes will be put into the local prefix discovery data
30 as described in :ref:`local-prefix-discovery`. If no prefix is specified,
31 auto-config-server will not serve any local prefix discovery data.
32
Davide Pesavento59769b12017-11-12 23:52:06 -050033``-h``
34 Print usage and exit.
35
36``-V``
37 Print version number and exit.
38
39Exit status
40-----------
41
420: No error.
43
441: An unspecified error occurred.
45
462: Malformed command line, e.g., invalid, missing, or unknown argument.
47
484: Insufficient privileges.
49
hilata6ee6e072014-04-20 17:10:18 -050050Examples
51--------
52
Alexander Afanasyev49272f72014-04-06 21:49:46 -070053::
54
hilata6ee6e072014-04-20 17:10:18 -050055 ndn-autoconfig-server tcp://spurs.cs.ucla.edu
Alexander Afanasyev49272f72014-04-06 21:49:46 -070056
Yingdi Yu7b0e9cf2014-08-29 14:57:32 -070057 ndn-autoconfig-server -p /ndn/edu/ucla tcp://spurs.cs.ucla.edu
58
hilata6ee6e072014-04-20 17:10:18 -050059See also
60--------
61
62:ref:`ndn-autoconfig`