blob: 9508779bae818b74cf5f5dd481f519f694974ff3 [file] [log] [blame] [view]
Davide Pesavento82cc17a2025-02-17 18:30:05 -05001# Mini-NDN
carlosmscabrale3c810e2013-02-25 18:15:40 -03002
Davide Pesavento82cc17a2025-02-17 18:30:05 -05003![Latest version](https://img.shields.io/github/v/tag/named-data/mini-ndn?label=Latest%20version)
4[![Docker](https://github.com/named-data/mini-ndn/actions/workflows/docker.yml/badge.svg)](https://github.com/named-data/mini-ndn/actions/workflows/docker.yml)
Nick Gordon22642a32017-12-21 14:05:40 -06005
ashu4c858802015-04-15 11:28:07 -05006### What is Mini-NDN?
carlosmscabrale3c810e2013-02-25 18:15:40 -03007
Vince Lehman608a1332015-07-14 17:47:49 -05008Mini-NDN is a lightweight networking emulation tool that enables testing, experimentation, and
Ashlesh Gawande6c86e302019-09-17 22:27:05 -05009research on the NDN platform based on [Mininet](https://github.com/mininet/mininet).
10Mini-NDN uses the NDN libraries, NFD, NLSR, and tools released by the
Davide Pesavento82cc17a2025-02-17 18:30:05 -050011[NDN project](https://named-data.net/codebase/platform/) to emulate an NDN network on a single system.
carlosmscabrale3c810e2013-02-25 18:15:40 -030012
Davide Pesavento82cc17a2025-02-17 18:30:05 -050013Mini-NDN is free and open source software distributed under the GNU General Public License version 3.
14For more information about licensing details and limitations, please refer to [`COPYING.md`](COPYING.md).
carlosmscabrale3c810e2013-02-25 18:15:40 -030015
Vince Lehman4e7df5a2015-07-21 11:55:49 -050016The first release of Mini-NDN is developed by members of the NSF-sponsored NDN project team.
Davide Pesavento82cc17a2025-02-17 18:30:05 -050017For more details, please refer to [`AUTHORS.rst`](AUTHORS.rst).
Vince Lehman608a1332015-07-14 17:47:49 -050018Bug reports and feedback are highly appreciated and can be made through our
Davide Pesavento82cc17a2025-02-17 18:30:05 -050019[Redmine site](https://redmine.named-data.net/projects/mini-ndn) and the
20[mini-ndn mailing list](https://www.lists.cs.ucla.edu/mailman/listinfo/mini-ndn).
21
22Mini-NDN is open to contribution from the public.
23If you are new to the NDN software community and intend to contribute to the codebase, please read our
24[Contributor's Guide](https://github.com/named-data/.github/blob/main/CONTRIBUTING.md).
carlosmscabrale3c810e2013-02-25 18:15:40 -030025
26### Documentation
27
Davide Pesavento82cc17a2025-02-17 18:30:05 -050028Please refer to <https://minindn.memphis.edu/> for installation, usage, and other documentation.
awlane73add712024-08-12 21:49:00 -050029The documentation can also be built locally using:
Ashlesh Gawande6c86e302019-09-17 22:27:05 -050030
Davide Pesavento82cc17a2025-02-17 18:30:05 -050031```shell
32./docs/build.sh
33```
Ashlesh Gawande6c86e302019-09-17 22:27:05 -050034
35and is available under `docs/_build/html`.