libside

Specification for Instrumentation Data Encoding

Dependencies

• librseq at build and run time.

Building

Prerequisites

This source tree is based on the Autotools suite from GNU to simplify portability. Here are some things you should have on your system in order to compile the Git repository tree:

• GNU Autotools
• GNU Libtool
• GNU Make
• pkg-config

Building steps

If you get the tree from the Git repository, you will need to run

./bootstrap

in its root. It calls all the GNU tools needed to prepare the tree configuration.

To build and install, do:

./configure
make
sudo make install
sudo ldconfig

Console Tracer

libside includes a console tracer library (libside-console-tracer) for debugging and testing instrumented applications. When linked with an application, it registers as a tracer, enables all side events, and prints them to stdout in a human-readable format.

Usage

Preload the console tracer at runtime using LD_PRELOAD without modifying or relinking the application:

LD_PRELOAD=libside-console-tracer.so ./myapp

Or link your application with -lside-console-tracer in addition to -lside:

gcc -o myapp myapp.c -lside -Wl,--no-as-needed -lside-console-tracer

Or use pkg-config(1):

gcc -o myapp myapp.c					\
$(pkg-config --cflags --libs libside)			\
$(pkg-config --cflags --libs libside-console-tracer)

Example output

provider: myprovider, event: myevent, fields: { abc: { value: 42 } def: { value: -500 } }