blob: 762ba1482ab2bc6cdb001231ae574e22a6e051b6 [file] [log] [blame] [view]
Junxiao Shi6ca48812015-03-26 23:14:19 -07001# ndn-tools Build Instructions
2
3This document describes how to build and install ndn-tools.
4
5## Prerequisites
6
Davide Pesaventodb9613e2023-01-20 20:52:21 -05007* Install the [ndn-cxx](https://github.com/named-data/ndn-cxx) library and its dependencies.
8 Check out [the documentation](https://docs.named-data.net/ndn-cxx/current/INSTALL.html) for
9 detailed installation instructions. All platforms supported by ndn-cxx are also supported
10 by ndn-tools.
Junxiao Shi6ca48812015-03-26 23:14:19 -070011
Davide Pesaventob04c52b2022-02-20 15:20:02 -050012 *Note*: If you have installed ndn-cxx from a binary package, please make sure the development
13 headers are installed (e.g., if using Ubuntu PPA, the `libndn-cxx-dev` package is needed).
Eric Newberry82ea0fa2016-12-28 21:44:44 -070014
Davide Pesaventodb9613e2023-01-20 20:52:21 -050015* Install `libpcap` (except on macOS where it is provided by the base system).
Eric Newberry82ea0fa2016-12-28 21:44:44 -070016
Davide Pesaventof597d072022-07-04 21:20:21 -040017 On Debian and Ubuntu:
Eric Newberry82ea0fa2016-12-28 21:44:44 -070018
Davide Pesaventof6d75992024-02-27 19:56:06 -050019 ```shell
20 sudo apt install libpcap-dev
21 ```
Davide Pesaventod5c24472020-04-01 17:46:18 -040022
Davide Pesaventob04c52b2022-02-20 15:20:02 -050023 On CentOS and Fedora:
Davide Pesaventod5c24472020-04-01 17:46:18 -040024
Davide Pesaventof6d75992024-02-27 19:56:06 -050025 ```shell
26 sudo dnf install libpcap-devel
27 ```
Junxiao Shi6ca48812015-03-26 23:14:19 -070028
29## Build Steps
30
Junxiao Shi6ca48812015-03-26 23:14:19 -070031To configure, compile, and install ndn-tools, type the following commands
32in ndn-tools source directory:
33
Davide Pesaventof6d75992024-02-27 19:56:06 -050034```shell
35./waf configure
36./waf
37sudo ./waf install
38```
Junxiao Shi6ca48812015-03-26 23:14:19 -070039
Davide Pesaventob04c52b2022-02-20 15:20:02 -050040To uninstall:
Junxiao Shi6ca48812015-03-26 23:14:19 -070041
Davide Pesaventof6d75992024-02-27 19:56:06 -050042```shell
43sudo ./waf uninstall
44```