blob: fdd94e52b6048689ed5bd81b1be62e1f94367492 [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 Pesaventob04c52b2022-02-20 15:20:02 -05007- Install the [ndn-cxx](https://named-data.net/doc/ndn-cxx/current/) library and its prerequisites.
8 Please see [Getting Started with ndn-cxx](https://named-data.net/doc/ndn-cxx/current/INSTALL.html)
9 for instructions.
10 All operating systems and compilers supported by ndn-cxx are also supported 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 Pesaventob04c52b2022-02-20 15:20:02 -050015- `libpcap`
Eric Newberry82ea0fa2016-12-28 21:44:44 -070016
Davide Pesaventob04c52b2022-02-20 15:20:02 -050017 Comes with the base system on macOS.
Eric Newberry82ea0fa2016-12-28 21:44:44 -070018
Davide Pesaventob04c52b2022-02-20 15:20:02 -050019 On Ubuntu:
Eric Newberry82ea0fa2016-12-28 21:44:44 -070020
Davide Pesaventob04c52b2022-02-20 15:20:02 -050021 sudo apt install libpcap-dev
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 Pesaventob04c52b2022-02-20 15:20:02 -050025 sudo dnf config-manager --enable powertools # CentOS only
26 sudo dnf install libpcap-devel
Junxiao Shi6ca48812015-03-26 23:14:19 -070027
28## Build Steps
29
Junxiao Shi6ca48812015-03-26 23:14:19 -070030To configure, compile, and install ndn-tools, type the following commands
31in ndn-tools source directory:
32
33 ./waf configure
34 ./waf
35 sudo ./waf install
36
Davide Pesaventob04c52b2022-02-20 15:20:02 -050037To uninstall:
Junxiao Shi6ca48812015-03-26 23:14:19 -070038
39 sudo ./waf uninstall