1. SYNOPSIS

xeno-config

xeno-config --v | --verbose

xeno-config --help

xeno-config [--version] [--cc] [--arch] [--prefix] [--skin native|posix|psos|rtdm|uitron|vrtx|vxworks] [--cflags] [--ldflags] [--lib*-dir|--library-dir|--libdir|--user-libdir]

2. DESCRIPTION

xeno-config is a script that is used to to display the compiler and linker flags that are required for building applications that use Xenomai. Any combination of options can be chosen (except --verbose and --help) to display configuration information, and options can be given in any order. The command output one line for each option, in the same order as the options.

When xeno-config --verbose is executed, all configuration information is displayed in a different, more human-readable format.

When xeno-config is executed without any options, the output is equivalent to than when executing xeno-config --verbose then xeno-config --help.

3. OPTIONS

--v, --verbose

Outputs all configuration information, in a human-readable format.

--help

Outputs the list of available command-line options.

--version

Outputs one line with the installed Xenomai version.

--cc

Outputs one line with the path to the C compiler command that was used to compiled Xenomai.

--arch

Outputs one line with the architecture to compile to, e.g. i386. May be different from the architecture of the currently running system, if cross-compiling.

--prefix

Outputs one line with the absolute path to the base Xenomai installation directory.

--skin

Choose the skin for which xeno-config should print the compilation flags.

--cflags

Outputs one line with the C compiler command-line options that are necessary to compile applications that use the Xenomai skin passed to the --skin option.

--ldflags

Outputs one line with the C compiler command-line options that are necessary to link applications that use the Xenomai skin passed to the --skin option with the necessary libraries.

--lib*-dir, --library-dir, --libdir, --user-libdir

Outputs one line with the absolute path to Xenomai’s libraries. In the --lib*-dir option name, the * is meant as a wildcard: --lib-dir, --libfoo-dir and --libbar-dir are all valid and synonymous options.

4. DEPRECATED OPTIONS

--xeno-cflags

This option is deprecated, please use --skin and --cflags instead. Outputs one line with the C compiler command-line options that are necessary to compile applications that use any Xenomai skin, except the posix skin.

--xeno-ldflags

This option is deprecated, please use --skin and --ldflags instead. Outputs one line with the C compiler command-line options that are necessary to link applications that use any Xenomai skin, except the posix skin, with the necessary libraries. Note that the particular -llibskin flag should be added to the flags returned by this option.

--posix-cflags

This option is deprecated, please use --skin posix --cflags instead. Outputs one line with the C compiler command-line options that are necessary to compile applications that use Xenomai’s Posix-compatible layer library.

--posix-ldflags

This option is deprecated, please use --skin posix --ldflags instead. Outputs one line with the C compiler command-line options that are necessary to link applications against Xenomai’s Posix-compatible layer library.

5. ENVIRONMENT VARIABLES

DESTDIR

If the DESTDIR variable is set, its content is prepended to the Xenomai installed directories and files names output by the --prefix and --library-dir options, and to the Xenomai installation directories in the flags output by the --xeno-cflags, --xeno-ldflags, --posix-cflags, --posix-ldflags options.

If DESTDIR was set when compiling and installing Xenomai, e.g. for cross-compilation, DESTDIR must be set to the same value before calling xeno-config, in order to output valid directory and file names.

6. RETURN CODES

0

Successful script execution.

1

The --posix-ldflags option has been given but Posix support is not available in Xenomai; or an invalid argument has been given on the command-line.