HC_STATUS

NAME

hc_status - Show status information for HAMcast middleware

BUILD/INSTALL

Requirements

• cmake (Version 2.6+)
• cmake macro 'FindLibHamcast.cmake'
• boost libraries developers edition
• HAMcast library and middleware

Build

We recommend an 'out-of-source' cmake-build. Create a new folder, e.g. 'build' within the source directory. Change to new folder (cd build) and run:

  cmake ../

if you have not install libhamcast to standard directories, run:

  cmake -DHAMCAST_INCLUDE_PATH=<path-to-headers> \
        -DHAMCAST_LIBRARY_PATH=<path-to-libhamcast> ../

'path-to-headers' is the absolute path where 'hamcast/hamcast.hpp' can be found. 'path-to-libhamcast' is the absolute path where 'libhamcast.so' can be found. If both are the same, you have to provide only one of them. This will initialize the build environment, if no errors occure run:

  make

If build was successful you find the binary in 'build' folder.

Install

Currently not supported. Just run hc_status from build directory.

SYNOPSIS

  hc_status [GROUPS]...

DESCRIPTION

The program provides information on HAMcast middleware and multicast status of a node.

EXIT STATUS

hc_status exits with status 0 (EXIT_SUCCESS) if no error occurs, otherwise 1 (EXIT_FAILURE) is returned.

OPTIONS

None

EXAMPLES

Without args:

  ./hc_status

With args:

  ./hc_status ip://239.238.237.236:1234 ip://239.1.2.3:7890

FILES

No other files required or used.

NOTES

If started without arguments hc_status prints current status of middleware and multicast group association. If valid group URIs are passed hc_status will 'join' these groups, print status infos and 'leave' groups before program stops.

ENVIRONMENT

LD_LIBRARY_PATH must be set if libhamcast is not installed into standard directories, e.g. /usr/lib.