apv-xcheck : ApVSys administration utility

      Copyright (C) 2002-2020 Arnaud BERTRAND
      web-site: http://apvsys.sourceforge.net

NAME

Purpose

to check the cross-references in the ApVSys database By default, only the current tool-spec will be checked to see if command versions are defined by more than 1 tool-spec line. It can cause conflict or anoying situations.

This effect is named collision. You will see this "problem" when a command is registered for 2 different tools. Let's take an example:

We assume that the command cpp was registered for different tool/version, the output of "apv -a cpp" is:

 cpp:

 3 registered versions for the command cpp :
    gcc/v3.0.2
    Compiler8051/v1.7
    gcc/v2.95.3   <= <= <=

 Matched toolspec: /home/arn/tool-spec: gcc/default
 Chosen version from: "gcc/v2.95.3"

The command if known for 2 different tools (gcc and Compiler8051).

If a user is using both tools... we have a collision

If his toolspec is:

 gcc/default
 Compiler8051/v1.7

the executed version of cpp will be the gcc/v2.95.3 version (see above) but if his toolspec is:

 Compiler8051/v1.7
 gcc/default

the executed version of cpp will be the Compiler8051/v1.7 version.

NOTE:

This "problem" is not due to ApVSys, it does not have solution by using standard Unix PATH system. The order of the toolspec lines (you can check with apv -X) gives the priority order exactly as the order of the paths in the PATH environment variable.

SYNOPSYS

apv-xcheck [-h] [-v] [-t toolname] [-a]

OPTIONS

-t, --tool-name toolname

Limit the check to a specific tool, print only possible collisions with commands of this tool.

-a, --all

analyzes the cross-references in all the tools instead of only the tools mentionned in the toolspec.

-v, --verbose

Set the verbose mode: the chosen version (function of the toolspec is also reported).

-h, --help

print a short help message

EXAMPLES

 > apv-xcheck
 > apv-xcheck -v -t gcc
 > apv-xcheck -a -t gcc
 

SEE ALSO

apvsys-intro(1) ap-environment(1) apv(1) apv-lib(1) apv-linktool(1) apv-regtool(1) apv-setdefault(1) apv-osmirror(1) apv-nativeoscheck(1) apv-dbcheck(1)