blob: d66d59f107565aba887bd8d1c78bc3d7a83f2aea [file] [log] [blame]
Vince Lehmanb722b102014-08-24 16:33:49 -05001NLSR Installation Instructions
2==============================
3
4.. toctree::
5..
6
7Prerequisites
8-------------
9
Davide Pesaventof6be8e32020-04-30 16:06:03 -040010- `NFD <https://named-data.net/doc/NFD/>`_ and its dependencies
Vince Lehmanb722b102014-08-24 16:33:49 -050011
Alexander Afanasyev67758b12018-03-06 18:36:44 -050012Refer to `Getting started with NFD <https://named-data.net/doc/NFD/current/INSTALL.html>`_
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070013for detailed installation and running instruction.
Vince Lehmanb722b102014-08-24 16:33:49 -050014
Davide Pesaventof6be8e32020-04-30 16:06:03 -040015- PSync library
Ashlesh Gawande415676b2016-12-22 00:26:23 -060016
Davide Pesaventof6be8e32020-04-30 16:06:03 -040017Download the PSync library and build it according to the instructions available at
18https://github.com/named-data/PSync#build
Ashlesh Gawande32ec3fd2018-07-18 13:42:32 -050019
Ashlesh Gawande30d96e42021-03-21 19:15:33 -070020- [Optional] ChronoSync library
21
22For testing purposes, NLSR can be optionally built with Chronosync support.
23Download the ChronoSync library and build it according to the instructions available at
24https://github.com/named-data/ChronoSync#build
25
Vince Lehmanb722b102014-08-24 16:33:49 -050026Build
27-----
28
Davide Pesaventof6be8e32020-04-30 16:06:03 -040029Execute the following commands to build NLSR::
Vince Lehmanb722b102014-08-24 16:33:49 -050030
31 ./waf configure
32 ./waf
33 sudo ./waf install
34
Davide Pesaventof6be8e32020-04-30 16:06:03 -040035Refer to ``./waf --help`` for more options that can be used during the configure stage and
Alexander Afanasyev7decbbf2014-08-24 21:29:01 -070036how to properly configure NLSR.
Vince Lehmanb722b102014-08-24 16:33:49 -050037
Vince Lehman59dfac32015-04-29 12:37:26 -050038If your pkgconfig path is not set properly you can do the following before running ``./waf
Davide Pesaventof6be8e32020-04-30 16:06:03 -040039configure``::
Vince Lehmanb722b102014-08-24 16:33:49 -050040
Davide Pesaventof6be8e32020-04-30 16:06:03 -040041 export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
42 # or
Vince Lehman59dfac32015-04-29 12:37:26 -050043 export PKG_CONFIG_PATH=/path/to/pkgconfig/on/your/machine
Ashlesh Gawande30d96e42021-03-21 19:15:33 -070044
45If ChronoSync support is desired, NLSR needs to be configured with the following option:
46
47 ./waf configure --with-chronosync