Users can build OF-DPA as an interprocess mode application or choose to generate the archives necessary to statically link with their code. The sections below provide the build instructions for these modes. In either mode, the SDK is also built as part of the OF-DPA make process. OF-DPA builds the SDK using the SDK Make system.

Build Variables

The environment variables documented in tools/Make.common control building OF-DPA. They are set in the Makefile in the platform output directory.

Interprocess Mode Application

Change to the platform subdirectory (e.g. output/gto-trident) and type "make". This will generate the following binaries in directory specified by DELIVERABLES_DIR. The default setting for DELIVERABLES_DIR is output/<platform>/build/ as defined in Make.common.

ofdpa: the OF-DPA executable. Clients invoke APIs via RPC calls. The OF-DPA process is started using the command "./ofdpa &" from the switch Linux prompt.
ofdpa.dbg: the OF-DPA executable with debug symbols. This is used with the GDB debugger.
librpc_client.so.1: the shared library used to dynamically link to invoke the OF-DPA APIs via RPC.
linux-kernel-bde.ko/linux-user-bde.ko: kernel objects used by the SDK.

Single Process Mode Application

Users can choose to link OF-DPA statically with their application. The OF-DPA build target 'libraries' generates the archives for OF-DPA code. By default, the SDK code archives are also generated on invocation of 'libraries' target. The archives are generated in LIBRARIES_DIR directory. Statically link the OF-DPA archives with the user application code to generate the executable image.

The OF-Agent application is an example of a single process mode application. This application is built by the OF-DPA target 'agentapp'.

OF-DPA Client and User Application Guidelines

Applications accessing the OF-DPA APIs must invoke ofdpaClientInitialize() before invoking any other OF-DPA APIs.

OF-DPA clean targets

Use the following commands to clean the builds

make clean: deletes the contents of all the subdirectories of output/<platform> except sdk
make clean-all: deletes the contents of all the subdirectories of output/<platform> including sdk

OFDPA documentation

Use the following command to generate OF-DPA documentation

make ofdoc