carta
xeno-config(1)

xeno-config1

Display xenomai libraries configuration

Usage

xeno-config

xeno-config {--v | --verbose}

xeno-config --help

Overview

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.

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.

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.

Environment

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.

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.

History

  • Debian 8 (Jessie): the text shown here
  • Debian 7 (Wheezy)
  • Debian 6.0 (Squeeze)
  • Debian 5.0 (Lenny)

--cflags since Debian 8 (Jessie); --ldflags since Debian 8 (Jessie); --skin since Debian 8 (Jessie).

From libxenomai-dev 2.6.3-2 in Debian 8 (Jessie). Parsed by carta from the page's man source.