---

6 Configuring annobin and annocheck ¶

When building annobin and annocheck from the sources there are a few configure options available to customise the build:

--with-debuginfod

debuginfod is a web service that indexes ELF/DWARF debugging resources by build-id and serves them over HTTP.

By default the annocheck program will be built and linked with the debuginfod client library libdebuginfod if it is present at build time. The --with-debuginfod configure option can be used to force the linking against the library even if the run-time debuginfod program cannot be found. Alternatively the --without debuginfod can be used to force annobin to be built without libdebuginfod support, even if it is present on the build system.

debuginfod is packaged with elfutils, starting with version 0.178. You can get the latest version from ’https://sourceware.org/elfutils/’.

--with-gmp=PATH

The --with-gmp=PATH option can be used to specify an alternative path to the gmp libraries, if necessary.

--without-libelf

The annocheck program uses libelf to read ELF binaries. By default the configure system will detect if the library is installed and if not, then it will disable the building of annocheck and the running of the tests. (Since they use annocheck). This behaviour can be overridden by the --without-libelf option which forces the build to assume that libelf is absent even if it would normally be detected.

--without-tests

Disable running the testsuite after building the various binaries.

--with-clang-plugin=no

Disable the building of the annobin plugin for the Clang compiler.

--without-clang-plugin

An alias for --with-clang-plugin=no

--with-clang-plugin=yes

Enable the building of the annobin plugin for the Clang compiler. Fails if this is not possible.

--with-clang-plugin=auto

Enable the building of the annobin plugin for the Clang compiler. Does not fail if this is not possible, instead the plugin is just not built. This is the default setting for the --with-clang-plugin option.

--with-llvm-plugin=no

Disable the building of the annobin plugin for the LLVM compiler backend.

--without-llvm-plugin

An alias for --with-llvm-plugin=no

--with-llvm-plugin=yes

Enable the building of the annobin plugin for the LLVM compiler backend. Fails if this is not possible.

The LLVM plugin is separate from the Clang plugin and can be used with any language that uses LLVM as a backend compiler.

--with-llvm-plugin=auto

Enable the building of the annobin plugin for the LLVM compiler backend. Does not fail if this is not possible, instead the plugin is just not built. This is the default setting for the --with-llvm-plugin option.

--without-gcc-plugin

Do not build the gcc plugin.

--without-docs

Do not build the documentation.

--without-annocheck

Do not build the annocheck tool.

--enable-maintainer-mode

This enables the regeneration of the Makefile and configure files when building the annobin sources.

Also note that there is a script in the top level source directory called regenerate-configure-and-makefiles.sh which can be used to rebuild the configure and Makefile.in files, should something change.