Gitiles
Code Review Sign In
gerrit.named-data.net / NLSR / f6be8e37f62f98c6b80812c09a79d5df0e9c5118 / . / README.md
blob: 19dff9cb53c8724452542150d440aca3306d9680 [file] [log] [blame] [view]
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]1# NLSR: Named Data Link State Routing Protocol
2
3![Language](https://img.shields.io/badge/C%2B%2B-14-blue.svg)
4[![Build Status](https://travis-ci.org/named-data/NLSR.svg?branch=master)](https://travis-ci.org/named-data/NLSR)
5![Latest Version](https://img.shields.io/github/tag/named-data/NLSR.svg?color=darkkhaki&label=latest%20version)
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]6
Junxiao Shif09e2632015-01-02 18:15:01 -0700[diff] [blame]7For complete documentation and more extensive information,
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]8please visit the [NLSR homepage](https://named-data.net/doc/NLSR/current/).
Junxiao Shif09e2632015-01-02 18:15:01 -0700[diff] [blame]9
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]10If you are new to the NDN software community, please read the
11[Contributor's Guide](https://github.com/named-data/.github/blob/master/CONTRIBUTING.md)
12to get started.
Nick Gordoned473c62017-12-21 14:02:30 -0600[diff] [blame]13
akmhoquecc827532014-07-09 08:48:49 -0500[diff] [blame]14## Overview
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]15
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]16NLSR is a routing protocol in NDN that populates NDN's Routing Information Base.
17NLSR will continue to evolve alongside the Named Data Networking
18[protocol](https://named-data.net/doc/NDN-packet-spec/current/).
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]19
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]20NLSR is an open and free software package licensed under the GPL 3.0 license and free to
21all Internet users and developers. For more information about the licensing details and
22limitations, refer to [`COPYING.md`](COPYING.md).
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]23
Ashlesh Gawande39cf81a2018-02-22 13:37:07 -0600[diff] [blame]24NLSR is developed by the members of the [NSF-sponsored NDN project team](https://named-data.net/project/participants/).
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]25For more details, please refer to [`AUTHORS.md`](AUTHORS.md).
26Bug reports and feedback are highly appreciated and can be made through our
27[Redmine site](https://redmine.named-data.net/projects/nlsr/issues).
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]28
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]29The main design goal of NLSR is to provide a routing protocol to populate NDN's RIB.
akmhoquecc827532014-07-09 08:48:49 -0500[diff] [blame]30NLSR calculates the routing table using link-state or hyperbolic routing and produces
31multiple faces for each reachable name prefix in a single authoritative domain. NLSR
32will continue to evolve over time to include neighbor discovery and to become a full
33fledged inter-domain routing protocol for NDN.
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]34
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]35## Source releases
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]36
akmhoquecc827532014-07-09 08:48:49 -0500[diff] [blame]37The source code and source-code installation instructions are always available at
38the following links:
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]39
Ashlesh Gawande39cf81a2018-02-22 13:37:07 -0600[diff] [blame]40- [Installation](https://named-data.net/doc/NLSR/current/INSTALL.html)
41- [Getting Started with NLSR](https://named-data.net/doc/NLSR/current/GETTING-STARTED.html)
Junxiao Shif09e2632015-01-02 18:15:01 -0700[diff] [blame]42- [GitHub NLSR repository](https://github.com/named-data/NLSR)
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]43
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]44## Additional information
akmhoquedbfd7912014-01-31 20:15:39 -0600[diff] [blame]45
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]46- [Contributor's Guide](https://github.com/named-data/.github/blob/master/CONTRIBUTING.md)
Ashlesh Gawande39cf81a2018-02-22 13:37:07 -0600[diff] [blame]47- [NLSR Wiki](https://redmine.named-data.net/projects/nlsr/wiki/)
akmhoquecc827532014-07-09 08:48:49 -0500[diff] [blame]48- Feature requests and bug reports are welcome on our
Davide Pesaventof6be8e32020-04-30 16:06:03 -0400[diff] [blame^]49 [NLSR on NDN Redmine](https://redmine.named-data.net/projects/nlsr/issues)
Ashlesh Gawandeb4567f42017-04-28 14:40:39 -0500[diff] [blame]50- [NLSR Mailing List Sign Up](https://listserv.memphis.edu/scripts/wa.exe?GETPW1)
51- [NLSR Mailing List](https://listserv.memphis.edu/scripts/wa.exe?SUBED1=NLSR-HELP-L&A=1)
52- [NLSR Mailing List Archives](https://listserv.memphis.edu/scripts/wa.exe?A0=NLSR-HELP-L)
dmcoomesa47255c2017-09-29 16:08:32 -0500[diff] [blame]53- [NLSR Developer's guide](https://github.com/named-data/NLSR/blob/developers-guide/NLSR-Developers-Guide.pdf)