blob: c4059c2e39fa1a6e92149ace7b61f1f9e6ab386c [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
32 RELEASE-NOTES
Vince Lehmanb722b102014-08-24 16:33:49 -050033 GETTING-STARTED
Vince Lehman18df0602015-05-01 11:24:10 -050034 INSTALL
Vince Lehmanb722b102014-08-24 16:33:49 -050035 ROUTER-CONFIG
36 SECURITY-CONFIG
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070037 manpages
Vince Lehmanb722b102014-08-24 16:33:49 -050038
Vince Lehmanb722b102014-08-24 16:33:49 -050039- :doc:`GETTING-STARTED`
Vince Lehman18df0602015-05-01 11:24:10 -050040- :doc:`INSTALL`
Vince Lehmanb722b102014-08-24 16:33:49 -050041- :doc:`ROUTER-CONFIG`
42- :doc:`SECURITY-CONFIG`
43- :doc:`RELEASE-NOTES`
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070044- :doc:`manpages`
Vince Lehmanb722b102014-08-24 16:33:49 -050045
46Downloading
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070047-----------
Vince Lehmanb722b102014-08-24 16:33:49 -050048
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070049- `GitHub NLSR repository <https://github.com/named-data/NLSR>`_
Vince Lehmanb722b102014-08-24 16:33:49 -050050
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050051NLSR mailing list
52-----------------
53
54- `NLSR Mailing List`_
55
56- `NLSR Mailing List Archives`_
57
58`Sign up`_ is needed to post to the list or access the archives.
59
Vince Lehmanb722b102014-08-24 16:33:49 -050060Additional information
61----------------------
62
63- `NLSR Wiki`_
64
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050065- `NLSR Redmine`_
66 Feature requests and bug reports
67
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070068- `NLSR Paper`_
69 Detailed explanation of the NLSR design
Vince Lehmanb722b102014-08-24 16:33:49 -050070
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050071- `NLSR Developer's Guide`_
72 For NLSR Development
Vince Lehmanb722b102014-08-24 16:33:49 -050073
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050074.. _NLSR Wiki: https://redmine.named-data.net/projects/nlsr/wiki
Ashlesh Gawande30096b82017-03-30 12:20:50 -050075.. _NLSR Paper: https://named-data.net/wp-content/uploads/2016/01/ndn-0037-1-nlsr.pdf
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050076.. _NLSR Mailing List: https://listserv.memphis.edu/scripts/wa.exe?SUBED1=NLSR-HELP-L&A=1
77.. _NLSR Mailing List Archives: https://listserv.memphis.edu/scripts/wa.exe?A0=NLSR-HELP-L
78.. _NLSR Developer's Guide: https://github.com/named-data/NLSR/blob/developers-guide/NLSR-Developers-Guide.pdf
79.. _Sign up: https://listserv.memphis.edu/scripts/wa.exe?GETPW1
80.. _NLSR Redmine: https://redmine.named-data.net/projects/nlsr