Name:: nmExample - Simple example program to pack, unpack, and validate NetMsgs messages.

Synopsis:: nmExample [OPTIONS] netmsgsgen –version netmsgsgen –help

Description:: The example program nmExample under the examples/ package subdirectory is a simple packing and unpacking test application. Both pre-packed and post-unpacked messages are compared for consistency. Tracing is also available.

No messages are actually transmitted and received. So message validation accross disparate architectures is not performed.

The message encoding and byte ordering can be define with make arguments. Defaults are itv encoding and big endian.

$ make [encoding=<val>] [endian=<val>] ...

AstroMsgs.xml provides the NetMsgs XML message specification for nmExample.

Options:

Mandatory arguments to long options are also mandatory for short options.

Trace

-t, --trace

Do [not] enable tracing of packing and unpacking operations. If enabled, tracing is printed to stderr.\n Default: false

Logging

-l level, --log=level

Set logging threshold level. All logging events with priority ≤ level will be logged. All others will be ignored. Error events are always logged. The level is one of:

'off' or 0	Disable all logging.
'error' or 1	Enable error logging.
'diag1' or 2	Enable diagnostics 1 logging.
'diag2' or 3	Enable diagnostics 2 logging.
'diag3' or 4	Enable diagnostics 3 logging. The libSkewlZone library logs at this level
'diag4' or 5	Enable diagnostics 4 logging.
'diag5' or 6	Enable diagnostics 5 logging.
>6	Enable user-defined logging.

DEFAULT: off

--logfile=file

Set log output file to file. Special file names are:

'stderr'	log to standard error.
'stdout'	log to standard output.

DEFAULT: stderr

Information

--help

Display command help and exit.

--version

Output version information and exit.

Examples:

# Example 1
# Run with tracing
$
$  nmExample --trace --log=diag1

beaucoup output here

$