blob: 55f3172c36cbdfa552f46587aef3c37ea5fb5a1a [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>Apache module mod_env</TITLE>
</HEAD>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#000080"
ALINK="#FF0000"
>
<!--#include virtual="header.html" -->
<H1 ALIGN="CENTER">Module mod_env</H1>
This module is contained in the <code>mod_env.c</code> file, and
is not compiled in by default. It provides for
passing environment variables to CGI/SSI scripts. Is is only available
in Apache 1.1 and later.
<h2>Summary</h2>
This module allows Apache's CGI and SSI environment to inherit
environment variables from the shell which invoked the httpd process.
CERN web-servers are able to do this, so this module is especially
useful to web-admins who wish to migrate from CERN to Apache without
rewriting all their scripts
<h2>Directives</h2>
<ul>
<li><A HREF="#passenv">PassEnv</A>
<li><A HREF="#setenv">SetEnv</A>
<li><A HREF="#unsetenv">UnsetEnv</A>
</ul>
<hr>
<h2><A name="passenv">PassEnv</A></h2>
<strong>Syntax:</strong> PassEnv <em>variable variable ...</em><br>
<strong>Context:</strong> server config, virtual host<br>
<strong>Status:</strong> Base<br>
<strong>Module:</strong> mod_env<br>
<strong>Compatibility:</strong> PassEnv is only available in
Apache 1.1 and later.<p>
Specifies one or more environment variables to pass to CGI scripts
from the server's own environment. Example:
<pre>
PassEnv LD_LIBRARY_PATH
</pre>
<HR>
<h2><A name="setenv">SetEnv</A></h2>
<strong>Syntax:</strong> SetEnv <em>variable value</em><br>
<strong>Context:</strong> server config, virtual host<br>
<strong>Status:</strong> Base<br>
<strong>Module:</strong> mod_env<br>
<strong>Compatibility:</strong> SetEnv is only available in
Apache 1.1 and later.<p>
Sets an environment variable, which is then passed on to CGI
scripts. Example:
<pre>
SetEnv SPECIAL_PATH /foo/bin
</pre>
<hr>
<h2><A name="unsetenv">UnsetEnv</A></h2>
<strong>Syntax:</strong> UnsetEnv <em>variable variable ...</em><br>
<strong>Context:</strong> server config, virtual host<br>
<strong>Status:</strong> Base<br>
<strong>Module:</strong> mod_env<br>
<strong>Compatibility:</strong> UnsetEnv is only available in
Apache 1.1 and later.<p>
Removes one or more environment variables from those passed on to
CGI scripts. Example:
<pre>
UnsetEnv LD_LIBRARY_PATH
</pre>
<p>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>