| nlsrc |
| ===== |
| |
| Usage |
| ----- |
| |
| :: |
| |
| nlsrc [-h] [-V] COMMAND [<Command Options>] |
| |
| |
| Description |
| ----------- |
| |
| ``nlsrc`` is a tool to retrieve link-state database (LSDB) status information from NLSR and |
| announce/withdraw Name prefixes advertised by NLSR. |
| |
| Options |
| ------- |
| |
| ``-h`` |
| Print usage information |
| |
| ``-V`` |
| Show NLSRC version information |
| |
| ``COMMAND`` |
| |
| ``lsdb`` |
| Retrieve LSDB status information |
| |
| ``routing`` |
| Retrieve routing table status information |
| |
| ``status`` |
| Retrieve LSDB status and routing table status information |
| |
| ``advertise`` |
| Add a Name prefix to be advertised by NLSR |
| |
| ``advertise <name>`` |
| |
| ``name`` |
| The Name prefix to be advertised |
| |
| ``advertise <name> save`` |
| |
| ``save`` |
| Advertise a prefix and also save it to the nlsr.conf file residing in the state-dir for the next start of NLSR that operator may copy and use for the next start of NLSR |
| |
| ``withdraw`` |
| Remove a Name prefix advertised through NLSR |
| |
| ``withdraw <name>`` |
| |
| ``name`` |
| The Name prefix to be withdrawn |
| |
| ``withdraw <name> delete`` |
| |
| ``delete`` |
| Withdraw a prefix and also delete it from the nlsr.conf file residing in the state-dir |
| |
| Notes |
| ----- |
| |
| When security is enabled, NLSR will not be allowed to successfully |
| advertise/withdraw names without first setting a default identity of operator. |
| If default identity is not set as operator, the user will be presented with the |
| error message: “Name prefix update error (code: 403)”. To remedy this |
| issue, use command 'ndn-sec-default'. |
| |
| Example: |
| |
| ndnsec-set-default /ndn/a-site/%C1.Operator/op |
| |
| Exit Status |
| ----------- |
| |
| nlsrc exits with one of the following values: |
| :: |
| |
| 0 nlsrc exited successfully |
| >0 An error occurred |