Copyright (C) 2002 Arnaud BERTRAND web-site: http://www.apvsys.org
This is the most important administrative command. This is the command to use to register a tool (a version of a tool) in the ApVSys database.
The options enable the ApVSys administrator to tune the commands to register in the system.
apv-regtool -t toolname -v version [-v version] [-c -m -l -f -a] [-u ] [-d -D] [-o otherOS] [ -r restriction_level ] [ -i included-pattern ] [ -e excluded-pattern ] [ -L username ]
Note: the toolname must be the name of the directory in $APVSYS_ROOT/OsName/vOsVersion containing the different versions of the tool (or an installation image: please read ap-linktool documentation)
e.g. to register gcc, under Solaris 8, the directory:
/apvroot/SunOS/v5.8/gcc must contain the
version(s) to (un)register.
version(s)to (un)register, this option can appear several times to register several versions of the same tool.
Note 1: the versionname MUST always begin with ``v'' (the letter ``v'')
Note 2: the versionname must be the name of the directory in $APVSYS_ROOT/OsName/vOsVersion/toolname containing the version of the tool to register.
Note 3: instead of ``-t tool -v version'', the syntax ``-t tool/version'' can also be used.
This option is used to register the commands only ( the content of the bin directory )
This option is used to register the libraries only ( the content of the lib directory )
This option is used to register the manpages only ( the content of the man directory )
This option is used to register the infopages only ( the content of the info directory )
Note 1: To unregister a version, the installation directory $APVSYS_ROOT/OsName/vOsVersion/toolname/version STILL HAS TO EXIST. This directory can only be deleted AFTER the unregistration. If it was removed, apv-dbcheck would have to be used to clean-up the database properly. It takes more time but the result is the same, the tool will be properly removed.
Note 2: To -fully- unregister a version of a tool, the filter options ( -c,-l,-m,-f,-r,-i,-e ) CANNOT be used. It is of course possible to use these options to partially unregister a version of a tool.
version(s)in several operating systems at the same time. The tool will always be registered in the current O.S. This option can appear several times. The argument must be OsName/vOsVersion (e.g. ``SunOS/v5.8'' )
This is really interesting, when some commands are common with other tools, to tune the commands to register.
> apv-regtool -t gcc -v 2.95.3 -d ## self-explain > apv-regtool -t gcc -v 2.95.3 -u ## unregistration
In the next example, gcc will be registered for the current OS, but also for the 2 other specified OS. If there is no directory gcc/v2.95.3 for these O.S., a link will automatically be created.
> apv-regtool -t gcc -v 2.95.3 -D -o SunOS/v5.7 -o SunOS/v5.8
More complex but classical example. It assumes that the tool ``ncsim'' was previously installed with another ( or the same ) version and it does not register the entities beginning with ``lm'' ( typically the flexlm commands, which can be registered for the flexlm tool )
> apv-regtool -t ncsim -v 3.3s10 -r 21 -e "^lm"