====== CGI Environment Variables ======
This ''[[dir:ctrl]]/cgi_env.ini'' configuration file is used by the Synchronet [[server:Web]] Server to determine what environment variables will be created, preserved, or modified for use by any CGI programs. Any environment variables not specifically called-out in this file will not be present in the environment in which CGI programs are executed.

===== Format =====

Each [[ini_files#named_sections|named section]] identifies an environment variable that will be preserved or created.

Example:
  [PATH]

The optional key=value pairs for each section are:

==== default ====
The default value for the environment variable may be specified with a ''default=//value//'' key so that if the environment variable doesn't already exist it will be created with this value.

==== value ====
The value of the environment variable may be completely overridden using the ''value=//value//'' key.

==== prepend ====
If you wish to have a string prepended to an environment variable's value, use the ''prepend=//value//'' key.

==== append ====
If you wish to have a string appended to an environment variable's value, use the ''append=//value//'' key.

===== See Also =====
  * [[:config:|Configuration]]
  * [[:server:web|Web Server]]


{{tag>configuration cgi web_server ini}}