| commit | 571f3527d8d000baec3b6166a98da8f883adeade | [log] [tgz] |
|---|---|---|
| author | Jeff Thompson <jefft0@gmail.com> | Sun Jul 07 22:39:31 2013 -0700 |
| committer | Jeff Thompson <jefft0@gmail.com> | Sun Jul 07 22:39:31 2013 -0700 |
| tree | 5589b82c5643e5644a8254b839ca46a64665ce49 | |
| parent | 54909771a1096b8822cedb9229449878fa833840 [diff] |
Rename common.h to common.hpp and only define ptr_lib
People often feel confusing and tedious when using CCNx C library, and this is an attempt to make it easier to program NDN applications using C++.
This API remotely resembles PyCCN API if you by any chance have already got yourself familiar with that.
The functions included are be roughly devided into two categories: NDN operations and async operations.
This is a set of functions that provide relative easier ways to perform NDN operations, including manipulating NDN names, content objects, interests, sending interests, callbacks (closure) for content objects, name prefix discovery, signature verifications, etc.. There is also a blocking API to fetch content object.
Communications in NDN is mostly async. There is an event thread running NDN and processing the NDN events (e.g. interests received, expired, content received, etc..). As such, you don't really want to do a lot of processing in the NDN event thread (which blocks processing of that events). Hence we provide a simple executor API, which allows you to process the events in separate threads. We also provide a scheduler which allows you to scheduler various events as you wish. The scheduler is based on libevent C API.
To see more options, use ./waf configure --help. For default install, use
./waf configure ./waf sudo ./waf install
Normally, default install goes to /usr/local. If you have added /usr/local/lib/pkgconfig to your PKG_CONFIG_PATH, then you can compile your code like this:
g++ code.cpp `pkg-config --cflags --libs libndn.cxx`
example/ directory contains a fully working example of simple client and server applications written using NDN.cxx API.
There is also an extensive usage of this library in ChronoShare.