TIPC utilities package for Linux README

Last updated: 08 Aug 2012


This directory contains a variety of utility programs for use with Linux TIPC,
including:

1) tipc-config
An application for run-time configuration and monitoring of TIPC.

2) PTTS (Portable TIPC Test Suite)
A basic sanity test suite that can be used to verify that major aspects of TIPC
are operating correctly.

3) TIPC demos
A collection of demo programs.  The benchmark and inventory simulation demos
can be helpful in stressing certain aspects of TIPC beyond the areas covered
by PTTS.

4) TIPC pipe
A netcat like program for tipc.


Building the utilities package
------------------------------
The master makefile for the utilities package allows you to build all programs
in a single operation.  (If desired, you can also build a specific utility
individually from its own sub-directory.)

If you cloned out the git repo you will need to run

   ./bootstrap

first, if you have the dist tarball you need only run:

    ./configure
    make

If the TIPC includes are not found for some reason, 
or you want to build agains a different set of kernel headers.
You need to specify this directory in the configure stage as:
    ./configure  CFLAGS=-I<path to directory containing linux/tipc.h>

Note: In the standard Linux kernel source tree, this directory is located
at <top of source tree>/include.

The build procedure produces executable programs in the various sub-directories
that make up the package.


TIPC utilities uses autoconf and automake, to customize your build please
see the autotools and automake manuals. A few common targets are

    make install
    make dist


Running the utilities package
-----------------------------
Consult the README file in each sub-directory for further details on using
the associated application.