ndn-cpp-dev: A dev version of Named Data Networking client library for C++

Supported platforms

ndn-cpp-dev is tested on the following platforms:

  • Ubuntu 12.04 (64 bit and 32 bit)
  • Ubuntu 13.10 (64 bit and 32 bit)
  • Mac OS X 10.8
  • Mac OS X 10.9

Prerequisites

(These are prerequisites to build ndn-cpp-dev. To do development of ndn-cpp-dev code and update the build system, see Development Prerequisites.)

Required:

  • python >= 2.6
  • libcrypto
  • libsqlite3
  • libcrypto++
  • pkg-config
  • Boost libraries >= 1.48
  • OSX Security framework (on OSX platform only)

Following are the detailed steps for each platform to install the prerequisites.

  • Mac OS X

    Install Xcode. In Xcode Preferences > Downloads, install "Command Line Tools".

    If using macports, dependencies can be installed using the following commands:

      sudo port install pkgconfig boost sqlite3 libcryptopp
    
  • Ubuntu 12.04, Ubuntu 13.10

    In a terminal, enter:

      sudo apt-get install build-essential
      sudo apt-get install libssl-dev libsqlite3-dev libcrypto++-dev
    
      # For Ubuntu 12.04
      sudo apt-get install libboost1.48-all-dev
    
      # For Ubuntu 13.10
      sudo apt-get install libboost-all-dev
    

Optional Dependencies:

To build tutorials, manpages, and API documentation the following dependencies need to be installed:

  • doxygen
  • graphviz
  • python-sphinx

The following lists steps for common platforms to install these prerequisites:

  • On OS X 10.8 and 10.9 with macports:

      sudo port install doxygen graphviz py27-sphinx sphinx_select
      sudo port select sphinx py27-sphinx
    
  • On Ubuntu >= 12.04:

      sudo apt-get install doxygen graphviz python-sphinx
    

Build

(These are instructions to build ndn-cpp-dev. To do development of ndn-cpp-dev code and update the build system, see Development.)

To build in a terminal, change directory to the ndn-cpp-dev root. Enter:

./waf configure
./waf
sudo ./waf install

This builds and installs the following items:

  • <LIBPATH>/libndn-cpp-dev.a: static NDN C++ library
  • <LIBPATH>/pkgconfig/libndn-cpp-dev.pc: pkgconfig file storing all neccessary flags to build against the library. For example, if pkgconfig or pkgconf package is installed and PKG_CONFIG_PATH is configured properly (or <LIBPATH>/pkgconfig is a default path), pkgconfig --libs --clflags libndn-cpp-dev will return all necessary compile and link flags for the library.
  • <BINPATH>/tlvdump: a simple tool to dump contents of TLV-formatted data
  • <BINPATH>/ndncatchunks3: a simplified equivalent to ndncatchunks2 in NDNx package
  • <BINPATH>/ndnputchunks3: a simplified equivalent to ndnputchunks2 in NDNx package
  • <BINPATH>/ndnsec: tool to manage NDN keys and certificates
  • <BINPATH>/ndnsec-*: convenience scripts for ndnsec tools

If configured with tests: ./waf configure --with-tests), the above commands will also produce:

  • build/unit-tests: A unit test binary for the library

Documentation

ndn-cpp-dev tutorials and API documentation can be built using the following commands:

# Full set of documentation (tutorials + API) in build/docs
./waf docs

# Only tutorials in `build/docs`
./waf sphinx

# Only API docs in `build/docs/doxygen`
./waf doxgyen

Manpages are automatically created and installed during the normal build process (e.g., during ./waf and ./waf install), if python-sphinx module is detected during ./waf configure stage. By default, manpages are installed into ${PREFIX}/share/man (where default value for PREFIX is /usr/local). This location can be changed during ./waf configure stage using --prefix, --datarootdir, or --mandir options.

For more details, refer to ./waf --help.

Development Build

The following is the suggested configure commands for development build.

./waf configure --debug --with-tests
./waf
sudo ./waf install

In the development build all compiler optimizations are disabled by default and all warnings are treated as error. The default behavior can be overridden by setting CXXFLAGS environment variable before running ./waf configure:

CXXFLAGS="-O1 -g3" ./waf configure --debug --with-tests
...