blob: 6e2a4b4140b6588cf49bd5860f315bd220acc0ca [file] [log] [blame]
Vince Lehmanb722b102014-08-24 16:33:49 -05001NLSR - Named Data Link State Routing Protocol
2=============================================
3
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -07004NLSR is a routing protocol in NDN that populates NDN's Routing Information Base. NLSR will
5continue to evolve alongside the Named Data Networking `protocol
Davide Pesavento7ae8b082021-10-12 21:45:47 -04006<https://named-data.net/doc/NDN-packet-spec/current/>`_.
Vince Lehmanb722b102014-08-24 16:33:49 -05007
8NLSR is an open and free software package licensed under the GPL 3.0 license and free to
9all Internet users and developers. For more information about the licensing details and
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070010limitations, refer to `COPYING.md
11<https://github.com/named-data/NLSR/blob/master/COPYING.md>`_.
Vince Lehmanb722b102014-08-24 16:33:49 -050012
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070013NLSR is developed by the members of the `NSF-sponsored NDN project team
Ashlesh Gawande30096b82017-03-30 12:20:50 -050014<https://named-data.net/project/participants/>`_. For more details, please refer to
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070015`AUTHORS.md <https://github.com/named-data/NLSR/blob/master/AUTHORS.md>`_. Bug reports and
16feedback are highly appreciated and can be made through the `NLSR Wiki`_.
Vince Lehmanb722b102014-08-24 16:33:49 -050017
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070018The main design goal of NLSR is to provide a routing protocol to populate NDN's FIB. NLSR
Vince Lehmanb722b102014-08-24 16:33:49 -050019calculates the routing table using link-state or hyperbolic routing and produces multiple
20faces for each reachable name prefix in a single authoritative domain. NLSR will continue
21to evolve over time to include neighbor discovery and to become a full fledged
Junxiao Shif09e2632015-01-02 18:15:01 -070022inter-domain routing protocol for NDN. The protocol design is presented in full detail in
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070023the `NLSR Paper`_.
Vince Lehmanb722b102014-08-24 16:33:49 -050024
25NLSR Documentation
Davide Pesavento7ae8b082021-10-12 21:45:47 -040026------------------
Vince Lehmanb722b102014-08-24 16:33:49 -050027
28.. toctree::
29 :hidden:
Davide Pesavento7ae8b082021-10-12 21:45:47 -040030 :maxdepth: 2
Vince Lehmanb722b102014-08-24 16:33:49 -050031
Vince Lehmanb722b102014-08-24 16:33:49 -050032 GETTING-STARTED
Vince Lehman18df0602015-05-01 11:24:10 -050033 INSTALL
Vince Lehmanb722b102014-08-24 16:33:49 -050034 SECURITY-CONFIG
David Arjona2fa23ea2018-11-28 11:50:38 -060035 ROUTER-CONFIG
Ashlesh Gawande9e955bc2017-11-30 17:33:03 -060036 RELEASE-NOTES
37 releases
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070038 manpages
David Arjona2e6c8bb2018-11-14 16:27:09 -060039 beginners-guide
Vince Lehmanb722b102014-08-24 16:33:49 -050040
Vince Lehmanb722b102014-08-24 16:33:49 -050041- :doc:`GETTING-STARTED`
Vince Lehman18df0602015-05-01 11:24:10 -050042- :doc:`INSTALL`
Vince Lehmanb722b102014-08-24 16:33:49 -050043- :doc:`SECURITY-CONFIG`
David Arjona2fa23ea2018-11-28 11:50:38 -060044- :doc:`ROUTER-CONFIG`
Vince Lehmanb722b102014-08-24 16:33:49 -050045- :doc:`RELEASE-NOTES`
Ashlesh Gawande9e955bc2017-11-30 17:33:03 -060046- :doc:`releases`
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070047- :doc:`manpages`
David Arjona2e6c8bb2018-11-14 16:27:09 -060048- :doc:`beginners-guide`
Vince Lehmanb722b102014-08-24 16:33:49 -050049
50Downloading
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070051-----------
Vince Lehmanb722b102014-08-24 16:33:49 -050052
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070053- `GitHub NLSR repository <https://github.com/named-data/NLSR>`_
Vince Lehmanb722b102014-08-24 16:33:49 -050054
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050055NLSR mailing list
56-----------------
57
58- `NLSR Mailing List`_
59
60- `NLSR Mailing List Archives`_
61
62`Sign up`_ is needed to post to the list or access the archives.
63
Vince Lehmanb722b102014-08-24 16:33:49 -050064Additional information
65----------------------
66
67- `NLSR Wiki`_
68
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050069- `NLSR Redmine`_
70 Feature requests and bug reports
71
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070072- `NLSR Paper`_
73 Detailed explanation of the NLSR design
Vince Lehmanb722b102014-08-24 16:33:49 -050074
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050075- `NLSR Developer's Guide`_
76 For NLSR Development
Vince Lehmanb722b102014-08-24 16:33:49 -050077
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050078.. _NLSR Wiki: https://redmine.named-data.net/projects/nlsr/wiki
Ashlesh Gawande30096b82017-03-30 12:20:50 -050079.. _NLSR Paper: https://named-data.net/wp-content/uploads/2016/01/ndn-0037-1-nlsr.pdf
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050080.. _NLSR Mailing List: https://listserv.memphis.edu/scripts/wa.exe?SUBED1=NLSR-HELP-L&A=1
81.. _NLSR Mailing List Archives: https://listserv.memphis.edu/scripts/wa.exe?A0=NLSR-HELP-L
82.. _NLSR Developer's Guide: https://github.com/named-data/NLSR/blob/developers-guide/NLSR-Developers-Guide.pdf
83.. _Sign up: https://listserv.memphis.edu/scripts/wa.exe?GETPW1
84.. _NLSR Redmine: https://redmine.named-data.net/projects/nlsr