blob: bd0ba18afdcda0a21e1f3b95a5be823e34a43933 [file] [log] [blame]
Alexander Afanasyevc5452c52014-04-29 17:21:51 -07001ndn-cxx: NDN C++ library with eXperimental eXtensions
2=====================================================
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -07003
Alexander Afanasyev7c6aeb02014-04-10 19:59:19 -07004.. toctree::
Alexander Afanasyevabaab522014-04-30 20:42:11 -07005 :hidden:
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -07006 :maxdepth: 3
Alexander Afanasyevabaab522014-04-30 20:42:11 -07007
Alexander Afanasyevc5452c52014-04-29 17:21:51 -07008 INSTALL
Alexander Afanasyev151a8552014-04-11 00:54:43 -07009 examples
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -070010 tutorials
Yingdi Yu55ea01a2015-07-21 22:42:17 -070011 specs
Junxiao Shifa2128d2015-06-29 16:41:25 -070012 manpages
Alexander Afanasyev45312f52015-09-27 12:06:50 -070013
14.. toctree::
15 :hidden:
16 :maxdepth: 1
17
Alexander Afanasyevc5452c52014-04-29 17:21:51 -070018 code-style
Davide Pesavento81de5d92022-12-30 01:08:05 -050019 release-notes
Alexander Afanasyev45312f52015-09-27 12:06:50 -070020 releases
Alexander Afanasyevabaab522014-04-30 20:42:11 -070021
Davide Pesaventofcd3e442023-03-10 18:44:11 -050022**ndn-cxx** is a C++17 library implementing Named Data Networking (NDN) primitives
Davide Pesavento81de5d92022-12-30 01:08:05 -050023that can be used to write various NDN applications. The library is currently being
24used by the following projects:
25
26* `NFD - NDN Forwarding Daemon <https://github.com/named-data/NFD>`_
27* `NLSR - Named-data Link-State Routing protocol <https://github.com/named-data/NLSR>`_
28* `ndn-tools - Essential NDN command-line tools <https://github.com/named-data/ndn-tools>`_
29* `ndn-svs - State Vector Sync library <https://github.com/named-data/ndn-svs>`_
30* `PSync - Partial and full Sync library <https://github.com/named-data/PSync>`_
31* `ChronoSync - Sync library for distributed real-time applications (deprecated) <https://github.com/named-data/ChronoSync>`_
32* `NAC - Name-based Access Control library <https://github.com/named-data/name-based-access-control>`_
33* `NDNCERT - NDN certificate management protocol <https://github.com/named-data/ndncert>`_
34* `repo-ng - NDN repository implementation in C++ (deprecated) <https://github.com/named-data/repo-ng>`_
35* `ndn-traffic-generator - Simple NDN traffic generator <https://github.com/named-data/ndn-traffic-generator>`_
36
37Documentation
38-------------
39
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -070040- :doc:`INSTALL`
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -070041- :doc:`examples`
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -070042- :doc:`tutorials`
43
Alexander Afanasyev9b0e1142014-05-08 00:17:34 -070044 + :doc:`tutorials/utils-ndn-regex`
45 + :doc:`tutorials/security-validator-config`
Yingdi Yu55ea01a2015-07-21 22:42:17 -070046
Davide Pesavento81de5d92022-12-30 01:08:05 -050047- :doc:`manpages`
48- :doc:`release-notes`
49- :doc:`releases`
50
51For developers
52^^^^^^^^^^^^^^
53
Davide Pesaventoae39daf2023-02-14 23:46:46 -050054- `NDN Software Contributor's Guide <https://github.com/named-data/.github/blob/main/CONTRIBUTING.md>`__
Davide Pesavento81de5d92022-12-30 01:08:05 -050055 (guide for newcomers to the NDN community of software)
56
Yingdi Yu55ea01a2015-07-21 22:42:17 -070057- :doc:`specs`
58
Yingdi Yu55ea01a2015-07-21 22:42:17 -070059 + :doc:`specs/safe-bag`
Davide Pesaventocad94b02021-04-09 21:23:03 -040060 + :doc:`specs/signed-interest`
Junxiao Shifa2128d2015-06-29 16:41:25 -070061
Davide Pesavento81de5d92022-12-30 01:08:05 -050062- `API documentation (doxygen) <doxygen/annotated.html>`__
Alexander Afanasyevabaab522014-04-30 20:42:11 -070063- :doc:`code-style`
Davide Pesavento81de5d92022-12-30 01:08:05 -050064
65Issues
66------
67
Davide Pesavento02ed3322023-02-23 19:40:22 -050068Please submit any bug reports or feature requests to the
Davide Pesavento81de5d92022-12-30 01:08:05 -050069`ndn-cxx issue tracker <https://redmine.named-data.net/projects/ndn-cxx/issues>`__.
Alexander Afanasyev5946ed12015-01-19 23:41:39 -080070
Alexander Afanasyevc5452c52014-04-29 17:21:51 -070071License
72-------
73
Davide Pesavento46b04a52019-03-28 21:36:35 -040074ndn-cxx is an open source project licensed under the LGPL version 3. For more information about
Davide Pesaventof3e84872024-03-15 15:30:06 -040075the license, refer to `COPYING.md <https://github.com/named-data/ndn-cxx/blob/master/COPYING.md>`__
76and `COPYING.lesser <https://github.com/named-data/ndn-cxx/blob/master/COPYING.lesser>`__.