NLSR Management » History » Revision 21
Revision 20 (Vince Lehman, 06/22/2015 01:24 PM) → Revision 21/44 (Muktadir Chowdhury, 07/08/2015 11:10 AM)
NLSR Management =============== NLSR Management provides: - command to add(advertise) routes to name prefix list - command to remove(withdraw) routes from to name prefix list ## 1. Control Commands ### 1.1 Add a name prefix #### command-verb: advertise This command adds a name prefix to the name prefix list. This command can be accepted on ```ndn:/localhost/nlsr/prefix-update``` prefix. #### Control Parameters - Name (required) ### 1.2 Remove a name prefix #### command-verb: withdraw This command removes a name prefix from the name prefix list. This command can be accepted on ```ndn:/localhost/nlsr/prefix-update``` prefix. #### Control Parameters - Name (required) ## 2. Request format NLSR control commands are signed interests, whose name has the following form: ```/<prefix>/<management-module>/<command-verb>/<control-parameters>/<signed-interests-components>``` - ```<prefix>``` is ```/localhost/nlsr ```. Each individual command may specify additional prefixes under which that command could be accepted. - ```<management-module> ```is the name of management module to which the command needs to be dispatched. For example, the name of the management module in this case would be ```prefix-update```. - ```<command-verb>``` is the command to be executed. For this case this would be either ```withdraw``` or ```advertise```. - ```<control-parameters>``` is a ControlParameters TLV block wrapped in a NameComponent. - ```<signed-interest-components>``` are four additional components defined by [ndn-cxx:SignedInterest|Signed Interest] spec. So, putting everything together, the complete name of a command interest would be ```localhost/nlsr/prefix-update/advertise``` or ```localhost/nlsr/prefix-update/withdraw``` ## 3. Response Format A response from the command interface is a Data that matches the request Interest. The payload of this Data is a ControlResponse block. ### StatusCode StatusCode | Description ------------|------------------------------------ 200 | OK 400 | ControlParameters is incorrect 403 | Command Interest is not authorized 501 | Module or verb is not supported 503 | Feature is disabled