Environment

This chapter describes all the environment variables that the compiler uses. Some environment variables are also used by other tools. Consult the tool manuals for specific variable use information.

The major sections in this chapter are:

Use environment variables to set environment parameters. Specify your environment using one of the following methods:

(Recommended Method) The current project file with the [ Environment Configuration ] panel. Specify this file on tool startup using the -Prod option ( -Prod: Specify Project File at Startup).
An optional default.env file in the current directory. CodeWarrior IDE tools support backward compatibility for this file. Specify the filename using the ENVIRONMENT variable ( ENVIRONMENT: Environment File Specification). Using the default.env file is not recommended.
Setting environment variables on system level (DOS level). This method is not recommended.

Use the following syntax for setting an environment variable:

  Parameter:  <KeyName>=<ParamDef>

Note: Normally no white space is allowed in the definition of an environment variable.

Listing: Setting the GENPATH Environment Variable

GENPATH=C:\INSTALL\LIB;D:\PROJECTS\TESTS;/usr/local/lib;
/home/me/my_project

Define parameters using one of several methods:

Using system environment variables supported by your operating system.
Putting the definitions into the actual project file in the [Environment Variables] section.
Putting the definitions in the default.env file in the default directory.
Note: The maximum length of environment variable entries in the default.env file is 4096 characters.
Putting the definitions in a file given by the value of the ENVIRONMENT system environment variable.
Note: Set the default directory mentioned above using the DEFAULTDIR system environment variable ( DEFAULTDIR: Default Current Directory).

When looking for an environment variable, all programs first search the system environment, then the default.env file, and finally the global environment file defined by ENVIRONMENT. If no definition is found, the tools assume a default value.

Note: You can also change the environment using the -Env option ( -Env: Set Environment Variable).

Note: Make sure that there are no spaces at the end of any environment variable declaration.