blob: ccdf706656b464b55237fe0a17cbc2fee1b8af7e [file] [log] [blame] [view]
Davide Pesaventof6be8e32020-04-30 16:06:03 -04001# NLSR: Named Data Link State Routing Protocol
2
Davide Pesaventoba8a4ed2021-10-13 21:28:43 -04003[![CI](https://github.com/named-data/NLSR/actions/workflows/ci.yml/badge.svg)](https://github.com/named-data/NLSR/actions/workflows/ci.yml)
4[![Docs](https://github.com/named-data/NLSR/actions/workflows/docs.yml/badge.svg)](https://github.com/named-data/NLSR/actions/workflows/docs.yml)
Davide Pesaventoc1d0e8e2022-06-15 14:26:02 -04005![Language](https://img.shields.io/badge/C%2B%2B-17-blue)
Davide Pesaventoba8a4ed2021-10-13 21:28:43 -04006![Latest version](https://img.shields.io/github/v/tag/named-data/NLSR?label=Latest%20version)
akmhoquedbfd7912014-01-31 20:15:39 -06007
Davide Pesavento1e9faf12023-01-21 16:04:50 -05008> For more extensive documentation, please visit the [NLSR homepage](https://docs.named-data.net/NLSR/current/).
Junxiao Shif09e2632015-01-02 18:15:01 -07009
akmhoquecc827532014-07-09 08:48:49 -050010## Overview
akmhoquedbfd7912014-01-31 20:15:39 -060011
Davide Pesavento1e9faf12023-01-21 16:04:50 -050012NLSR is a routing protocol for Named Data Networking (NDN) that populates the Routing Information
13Base (RIB) of an NDN router, such as [NFD](https://github.com/named-data/NFD). NLSR continues to
14evolve alongside the core [NDN protocol](https://docs.named-data.net/NDN-packet-spec/current/).
akmhoquedbfd7912014-01-31 20:15:39 -060015
Davide Pesaventof6be8e32020-04-30 16:06:03 -040016The main design goal of NLSR is to provide a routing protocol to populate NDN's RIB.
akmhoquecc827532014-07-09 08:48:49 -050017NLSR calculates the routing table using link-state or hyperbolic routing and produces
18multiple faces for each reachable name prefix in a single authoritative domain. NLSR
19will continue to evolve over time to include neighbor discovery and to become a full
20fledged inter-domain routing protocol for NDN.
akmhoquedbfd7912014-01-31 20:15:39 -060021
Davide Pesavento1b640fd2023-01-04 21:00:05 -050022NLSR was mainly developed by members of the NSF-sponsored [NDN project team](
23https://named-data.net/project/participants/). See [`AUTHORS.md`](AUTHORS.md) for details.
24
Davide Pesaventof6be8e32020-04-30 16:06:03 -040025## Source releases
akmhoquedbfd7912014-01-31 20:15:39 -060026
Davide Pesaventoc1d0e8e2022-06-15 14:26:02 -040027The source code and installation instructions are available at the following locations:
akmhoquedbfd7912014-01-31 20:15:39 -060028
Davide Pesavento1e9faf12023-01-21 16:04:50 -050029- [Installation](https://docs.named-data.net/NLSR/current/INSTALL.html)
30- [Getting started with NLSR](https://docs.named-data.net/NLSR/current/GETTING-STARTED.html)
Davide Pesavento1b640fd2023-01-04 21:00:05 -050031- [NLSR GitHub repository](https://github.com/named-data/NLSR)
akmhoquedbfd7912014-01-31 20:15:39 -060032
Davide Pesavento1e9faf12023-01-21 16:04:50 -050033## Reporting bugs
34
35Please submit any bug reports or feature requests to the
36[NLSR issue tracker](https://redmine.named-data.net/projects/nlsr/issues).
37
Davide Pesaventoc1d0e8e2022-06-15 14:26:02 -040038## Additional resources
akmhoquedbfd7912014-01-31 20:15:39 -060039
Davide Pesavento1e9faf12023-01-21 16:04:50 -050040- [Contributor's Guide](https://github.com/named-data/.github/blob/main/CONTRIBUTING.md)
Davide Pesaventoc1d0e8e2022-06-15 14:26:02 -040041- [NLSR Wiki](https://redmine.named-data.net/projects/nlsr/wiki)
42- [NLSR Issue Tracker](https://redmine.named-data.net/projects/nlsr/issues)
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -050043- [NLSR Mailing List Sign Up](https://listserv.memphis.edu/scripts/wa.exe?GETPW1)
44- [NLSR Mailing List](https://listserv.memphis.edu/scripts/wa.exe?SUBED1=NLSR-HELP-L&A=1)
45- [NLSR Mailing List Archives](https://listserv.memphis.edu/scripts/wa.exe?A0=NLSR-HELP-L)
dmcoomesa47255c2017-09-29 16:08:32 -050046- [NLSR Developer's guide](https://github.com/named-data/NLSR/blob/developers-guide/NLSR-Developers-Guide.pdf)
Davide Pesavento1b640fd2023-01-04 21:00:05 -050047
48## License
49
50NLSR is free software distributed under the GNU General Public License version 3.
51See [`COPYING.md`](COPYING.md) for details.