blob: f3b74b6ced3719cedcaa9e00a6e3ae3132af4a45 [file] [log] [blame]
Jeff Thompson9b282e02013-08-09 17:13:38 -07001NDN-CPP: A Named Data Networking client library for C++ and C
Jeff Thompson057d3182013-08-09 17:02:25 -07002-------------------------------------------------------------
3
4Prerequisites
5-------------
6
Jeff Thompsonc2da8c72013-10-10 16:30:25 -07007Required: libcrypto
8Optional: libsqlite3 (for key storage)
9Optional: OSX Security framework (for key storage)
10
11Following are the detailed steps for each platform to install the prerequisites.
12
13* Ubuntu 12.04
14sudo apt-get install build-essential
15sudo apt-get install libssl-dev
Jeff Thompson057d3182013-08-09 17:02:25 -070016
17Build
18-----
19
20To build in a terminal, change directory to the ndn-cpp root. Enter:
21
22./configure
23make
Jeff Thompsonc2da8c72013-10-10 16:30:25 -070024make install
Jeff Thompson057d3182013-08-09 17:02:25 -070025
Jeff Thompson2f951cf2013-08-11 16:04:09 -070026To make documentation, enter:
27make doxygen-doc
28
Jeff Thompson057d3182013-08-09 17:02:25 -070029Files
30-----
31
32This makes the following libraries:
33
34.libs/libndn-c.a: The core C code for encoding and communication.
Jeff Thompsonc2da8c72013-10-10 16:30:25 -070035.libs/libndn-cpp.a: The C++ library API. (If linking to libndn-cpp, don't link to libndn-c since it is included.)
Jeff Thompson057d3182013-08-09 17:02:25 -070036
37This makes the following test files:
38
39bin/test-get-async: Connect to one of the NDN testbed hubs, express an interest and display the received data.
40bin/test-encode-decode-interest: Encode and decode an interest, testing interest selectors and the name URI.
41bin/test-encode-decode-data: Encode and decode a data packet, including signing the data packet.
Jeff Thompsonc2da8c72013-10-10 16:30:25 -070042bin/test-encode-decode-forwarding-entry: Encode and decode a data packet, including signing the data packet.
Jeff Thompson057d3182013-08-09 17:02:25 -070043
Jeff Thompson2f951cf2013-08-11 16:04:09 -070044Running make doxygen-doc puts code documentation in:
45doc/html
46
Jeff Thompson057d3182013-08-09 17:02:25 -070047Supported platforms
48-------------------
49
Jeff Thompson9b282e02013-08-09 17:13:38 -070050NDN-CPP is tested on the following platforms:
Jeff Thompson057d3182013-08-09 17:02:25 -070051Ubuntu 12.04 (gcc 4.6.3)
52Mac OS X 10.8.4 (clang 4.2)
53Mac OS X 10.8.4 (gcc 4.2)
54
55