vtk_equivalence

Usage         
vtk_equivalence logicalName physicalPath

Description   
This procedure is used only in the equiv.tcl file of a project. The procedure has several functions:

1. Define an equivalence between a logical name and a physical name.

Example 
vtk_equivalence TOP /projects/ram
vtk_equivalence TOP /remote/export/projects/ram

2. Control the capitalization of path names. In this case, the procedure needs one argument which is 
either -nocase or -case. With -nocase, all path names are canonicalized to lower case. 
This is useful if the VOV server is running on a Windows machine.

Example
vtk_equivalence  -nocase; # If server runs on Windows

3. This can also be used to control whether AFS paths should be normalized or not. 
Use option -afs to normalize (e.g. /.automount/hostname/xxx becomes /net/hostname/xxx) and option -noafs to leave those paths alone (the default).

Example
vtk_equivalence  -afs; # Normalize AFS paths.

Side Effects
1. The environment variable corresponding to the logical name is set, if it does not exist already. 
2. The Tcl global variable corresponding to the logical name is set to the value of the environment variable.

vtk_equivalence_get_cache

Usage         vtk_equivalence_get_cache hostname

Description   
This procedure is used to get the cache of equivalence rules for a given host. 
See documentation on equivalences for more information. 
If the entry for _default_ is defined, it will be returned for any host that does not have a specific entry. 
If hostname is the null string "", the procedure returns the list of hosts for which equivalences have been defined. 

Example 
set listOfHosts  [vtk_equivalence_get_cache ""]
set rulesForHost [vtk_equivalence_get_cache "pluto"]

vtk_equivalence_set_cache

Usage         
vtk_equivalence_set_cache hostname values

Description   
This procedure is used to set the cache of equivalence rules for a given host. 
See documentation on equivalences for more information. 
If the values field is empty, the entry will be deleted. 
If the hostname field is "_default_", then the default value will be defined.

Examples
vtk_equivalence_set_cache "pluto" "LICDIR /export/licenses"
vtk_equivalence_set_cache "_default_" "LICDIR /export/licenses"