Presentation of the tools

Presentation of the tools

APES 2.0 is the latest evolution of the APES environment. It is built around a flexible, component-based architecture designed tools ease the integration and the compilation of software components from multiple sources. It also provides a set of comprehensive tools that allow to manipulate these components. This document presents each of these tools and gives a couple of example that explain thier usage.

apes-list

Lists the available components.

apes-info

Retrieves information about a component.

apes-resolve

Resolves all the dependences for a given component. This function has no purpose to be used directly.

apes-graph

Generates a DOTTY files that contains the component graph of a given component.

apes-compose

Builds the whole dependency graph of a given component. This tools relies on the following environment variables to work properly:

APES_COMPILER and APES_LINKER are pretty self explanatory. APES_CC_FLAGS must contain ONLY flags that do not influence the code produced by the compiler. APES_CC_OPTIMIZATIONS must contain ONLY flags that HAVE an influence on the produced code. APES_LINKER_FLAGS is, also, self explanatory.

In addition, apes-cc supports per-component flags. The naming convention of the variables containing those flags is presented above: the short version of a component’s name is used in its upcase form, to which is appended _CC_FLAGS. This variable must contain ONLY flags that HAVE an influence on the produced code.

apes-cache

Manages the object cache. show list all the present objects, purge remove all objects in the cache, and prune remove unreferenced and invalid objects. Unreferenced objects are objects for which the related component can not be found in the APES_COMPONENT_PATH.