Copyright (C) 2002-2020 Arnaud BERTRAND
web-site: http://apvsys.sourceforge.netapv - ApVSys User Interface
It provides the user with all the information he needs to know which version will be executed and why. It also gives a lot of other functionalities as detailed in the options list. This is finally THE user interface for the apvsys database.
Two modes are foreseen: command mode for which the argument of the apv is a command and the tool mode (indicated by the switch -t or --tool) where a toolname is specified instead of a command. Most of the options are usable in both modes. Note: sometimes, a command has the same name as a tool (e.g. gcc). In this case, invoking the apv command with or without the --tool switch does not change anything.
The functionalities are classified like this:
The version information: available versions, chosen version, environment set for this version, related commands, real installation path,...
The configuration(toolspec) information: snapshot of all the tools/versions chosen in the current environment, toolspec expansion, collision checking.
Special executions: starting a specified version (bypassing the toolspec); loading the environment and starting a shell instead of the specified command/tool; starting documentation.
The db information: registered tools, tools/versions; starting the license check (as lmstat).
apv [ -aeEhnrR ] command
apv [ -aeEhnrR ] --tool toolname
apv [ -T | -V | -W | -X ]
apv -x tool/version command
apv [ -l | -L ] [ -t tool | command ] [ part_of_feature ]
apv -s [ -t tool | command ] [ command to execute ]
apv -c
apv -p [ -t ] toolname|command
print the help message
This is a general switch to inform apv to work at tool level instead of command level.
This is certainly the most frequent usage of the apv command because it informs the user about the version started for a command/tool in function of his configuration (toolspec).
e.g. apv g++gives all the versions available (registered for the current operating system). This option is usable at both: command and tool level.
e.g. apv -a g++
apv -a --tool gccprint the associated ap-environment.pl to the chosen version
e.g. apv -e dc_shell
e.g. apv -e --tool design_compilerprint the associated ap-environment to each available versions (-a is assumed)
e.g. apv -E dc_shell
apv -E -t design_compilerThis option can be used to avoid the indentation of the output for copy/paste facility
lists all the related commands available(registered in apvsys) of the same tool.
e.g. apv -r g++
apv -r -t gccthe same as -r but for all the existing versions of the tool/command (-a is assumed)
set the verbose mode(print the APVSYS_TOOLSPEC_FILES variable and the full path of the command).
e.g. apv -v -a ncsimcheck the collision between commands which are referenced by 2 different tools in the current tool-spec.
This situation can be dangerous when you specified a particular tool/version and you don't know that a command of this tool/version exists also for another tool/version that you also specified. In this case, the priority is given to the first version matching the toolspec but it can be the one you didn't expect! apv -c will inform you about this kind of conflict and about the version chosen.
apv -D dumps all the registered tools and, for each one the version currently selected by the configuration Interesting to keep an history in a project, you can have an history of the versions used for each tool even if it was the default one.
This option is interesting to summarize the current status of your toolspec, apv -X will expand your current toolspec. Each file specified in your toolspec will be printed (in the order where they appear in your toolspec!) It is then easy to understand the decision rule.
set the environment and executes the command stored in the APVSYS_LICENSE_CMD variable. This variable can ONLY be defined in an ap-environment file. If this variable is not defined, it tries to detect if flexlm is used (by checkin a change in LM_LICENSE_FILE variable) and, in this case, "lmstat -a" is assumed.
An optional regexp feature can be given as last arguments. In this case, only the feature(s) matching with this argument (case insensitive) will be printed. By default, the format of flexlm is assumed as standard for feature line detection. This feature line detection can be overwritten by defining the environment variable "APVSYS_LICENSE_FEATURE_LINE" in the ap-environment file (or somewhere else). In this case, the tag __FEATURE__ can be used to indicate the place of the feature name.
IMPORTANT NOTE: the $HOME/.flexlmrc is ignore with this option. (see the -L otion).
example: apv -l -t ncsim apv -L vsim apv -l ncvhdl vhdl affirma or, setenv APVSYS_LICENSE_LINE "^Feature: __FEATURE__ - " apv -l -t Non_flexlmbased_tool
In the last example, the setenv command should be placed in the ap-environment.pl of this tool. I was given to show the syntax to use.
NOTE: if your tool is using flexlm and you want the feature exactly matching with a name, you can perform this request like that: apv -l synopsys " test-atpg:" (between quote, with a white space before and a colon after)
Exactly identical to --lmstat except that the $HOME/.flexlmrc is not ignored
print or start the documentation associated with a tool/version
e.g. apv -d dc_shell
apv -d -t design_compilerWith this option, apv will start a new shell (sh) after the environment of the specified tool/command has been loaded.
e.g. apv -s dc_shell
apv -s -t design_compiler
apv -s g++since version 1.12b, it is possible to execute something else than a shell. Ypu can add any command in argument.
e.g. apv -s vsim perl -e 'echo $ENV{MODELSIM_ROOT}'
apv -s g++ ddd
apv -t modelsim tcsh -fWith this option, apv will execute a specific version of a command (Bypass the toolspec matching) the tool/version is directly specified as argument after the -x
e.g. apv -x design_compiler/v2002.05 dc_shell
apv -x gcc/v2.95.3 g++ foo.cc -o fooWith this option, apv returns the root path of a tool/command this is useful for scripts which need the root directory of a tool.
e.g. setenv CDS_ROOT `apv -p -t ncsim`apv -T prints all the registered tools
apv -V prints all the registered tools/versions
apv -W prints all the registered tools/versions in a table