# Standard Environments

Most VOV installations offer at least the following environments:
Environment Name Description
BASE A minimal environment for the basic operating system tools, X11, and VOV. This environment typically resets the PATH variable. Use this environment to cut the size of the PATH variable.
CLEAN A destructive environment that eliminates most environment variable except a few essential ones. Normally used in conjunciton with some other environment, as in CLEAN+BASE.
CSHRC The environment obtained by sourcing the ~/.cshrc file. Use this with caution, since many ~/.cshrc files fail to setup the environment properly, or have undesired side effects.
D A parameterized environment used to define environment variables. See also the environment 'U' to unset variables. Examples:
``````% ves 'BASE+D(DISPLAY=tahoe:0.0)'
% ves BASE+D,DISPLAY=tahoe:0.0``````
DOT An environment that explicitly adds "." to the search path. Please remember that having a "." in the PATH is actually a security risk, so avoid using this environment if possible.
DEFAULT An inactive environment. The use of this environment is discouraged, because it implies giving up on environment control.
M Interface to the "modules" package. This environment requires customization. The list of modules to load is passed as a comma separated list of module names. Examples:
``````BASE+M(cadence/5.1)
SNAPSHOT & SNAPPROP Use "snapshot" environments captured into a file or into a property using the utility `vovenvcapture`. When saved into a file, the environment can be used on a job by using the SNAPSHOT environment which takes the file name as a parameter, i.e. the job environment specification is `SNAPSHOT(name_of_the_file)`. If the environment snapshot is saved as a property, the environment can be used by specifying SNAPPROP environment, using the job environment specification `SNAPPROP(vov_id)`
When ```vovproject start``` is executed, it automatically saves a snapshot of the server's environment to a file inside the server working directory.
``````vovenvcapture: Usage Message
DESCRIPTION:
Capture the SNAPSHOT environment into a file or add it as a
property to an object.

USAGE:
% vovenvcapture -help
% vovenvcapture -autofile
% vovenvcapture -file  <filename>
% vovenvcapture -id    <id>

NORMAL FLAGS:
-help          This message.
-id            Id of the object to add a property containing the
environment. Use the property with the environment
SNAPPROP(<id>)
-file          File to write the environment to.
Use the file with the environment SNAPSHOT(<filename>)
-autofile      Automatically choose the file to write the environment to.
The file will be located in a subdirectory of the SWD.

EXAMPLES:
% vovenvcapture -help
% vovenvcapture -autofile
% vovenvcapture -id 1``````
U A parameterized environment used to undefine environment variables. See also the environment 'D' to set variables. Examples:
``````% ves 'BASE+U(DISPLAY,SHELL)'
% ves BASE+U,DISPLAY,SHELL``````