blob: c141cc4c0e6e6175e915f8751a495b8fad47c31f [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
Ashlesh Gawande30096b82017-03-30 12:20:50 -05006<https://named-data.net/doc/ndn-tlv/>`_.
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
26-------------------
27
28.. toctree::
29 :hidden:
30 :maxdepth: 3
31
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 ROUTER-CONFIG
35 SECURITY-CONFIG
Ashlesh Gawande9e955bc2017-11-30 17:33:03 -060036 RELEASE-NOTES
37 releases
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070038 manpages
Vince Lehmanb722b102014-08-24 16:33:49 -050039
Vince Lehmanb722b102014-08-24 16:33:49 -050040- :doc:`GETTING-STARTED`
Vince Lehman18df0602015-05-01 11:24:10 -050041- :doc:`INSTALL`
Vince Lehmanb722b102014-08-24 16:33:49 -050042- :doc:`ROUTER-CONFIG`
43- :doc:`SECURITY-CONFIG`
44- :doc:`RELEASE-NOTES`
Ashlesh Gawande9e955bc2017-11-30 17:33:03 -060045- :doc:`releases`
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070046- :doc:`manpages`
Vince Lehmanb722b102014-08-24 16:33:49 -050047
48Downloading
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070049-----------
Vince Lehmanb722b102014-08-24 16:33:49 -050050
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070051- `GitHub NLSR repository <https://github.com/named-data/NLSR>`_
Vince Lehmanb722b102014-08-24 16:33:49 -050052
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050053NLSR mailing list
54-----------------
55
56- `NLSR Mailing List`_
57
58- `NLSR Mailing List Archives`_
59
60`Sign up`_ is needed to post to the list or access the archives.
61
Vince Lehmanb722b102014-08-24 16:33:49 -050062Additional information
63----------------------
64
65- `NLSR Wiki`_
66
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050067- `NLSR Redmine`_
68 Feature requests and bug reports
69
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070070- `NLSR Paper`_
71 Detailed explanation of the NLSR design
Vince Lehmanb722b102014-08-24 16:33:49 -050072
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050073- `NLSR Developer's Guide`_
74 For NLSR Development
Vince Lehmanb722b102014-08-24 16:33:49 -050075
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050076.. _NLSR Wiki: https://redmine.named-data.net/projects/nlsr/wiki
Ashlesh Gawande30096b82017-03-30 12:20:50 -050077.. _NLSR Paper: https://named-data.net/wp-content/uploads/2016/01/ndn-0037-1-nlsr.pdf
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050078.. _NLSR Mailing List: https://listserv.memphis.edu/scripts/wa.exe?SUBED1=NLSR-HELP-L&A=1
79.. _NLSR Mailing List Archives: https://listserv.memphis.edu/scripts/wa.exe?A0=NLSR-HELP-L
80.. _NLSR Developer's Guide: https://github.com/named-data/NLSR/blob/developers-guide/NLSR-Developers-Guide.pdf
81.. _Sign up: https://listserv.memphis.edu/scripts/wa.exe?GETPW1
82.. _NLSR Redmine: https://redmine.named-data.net/projects/nlsr