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