manual/mod/mod_env.html

	mod_env.html revision 5e93a97ccf053b0acd5c79b0aa349520fd922778
c25356d5978632df6203437e1953bcb29e0c736fTimo Sirainen<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
c25356d5978632df6203437e1953bcb29e0c736fTimo Sirainen<HTML>
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen<HEAD>
e34d170f8f0e084bd94bfbc1a7085ece67e508dfTimo Sirainen<TITLE>Apache module mod_env</TITLE>
e34d170f8f0e084bd94bfbc1a7085ece67e508dfTimo Sirainen</HEAD>
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen<BODY>
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen<!--#include virtual="header.html" -->
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen<H1>Apache module mod_env</h1>
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen
88c2db95c4a0f8f7986a63cd57cf4b6850d76543Timo SirainenThis module is contained in the <code>mod_env.c</code> file, and
88c2db95c4a0f8f7986a63cd57cf4b6850d76543Timo Sirainenis not compiled in by default. It provides for
88c2db95c4a0f8f7986a63cd57cf4b6850d76543Timo Sirainenpassing environment variables to CGI/SSI scripts. Is is only available
88c2db95c4a0f8f7986a63cd57cf4b6850d76543Timo Sirainenin Apache 1.1 and later.
88c2db95c4a0f8f7986a63cd57cf4b6850d76543Timo Sirainen
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen<h2>Summary</h2>
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainen
c7480644202e5451fbed448508ea29a25cffc99cTimo SirainenThis module allows Apache's CGI and SSI environment to inherit
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainenenvironment variables from the shell which invoked the httpd process.
a10ed8c47534b4c6b6bf2711ccfe577e720a47b4Timo SirainenCERN web-servers are able to do this, so this module is especially
a10ed8c47534b4c6b6bf2711ccfe577e720a47b4Timo Sirainenuseful to web-admins who wish to migrate from CERN to Apache without
c7480644202e5451fbed448508ea29a25cffc99cTimo Sirainenrewriting all their scripts
c25356d5978632df6203437e1953bcb29e0c736fTimo Sirainen
<h2>Directives</h2>
<ul>
<li><A HREF="#passenv">PassEnv</A>
<li><A HREF="#setenv">SetEnv</A>
<li><A HREF="#unsetenv">UnsetEnv</A>
</ul>

<hr>

<A name="passenv"><h2>PassEnv</h2></A>
<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>

<A name="setenv"><h2>SetEnv</h2></A>
<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>

<A name="unsetenv"><h2>UnsetEnv</h2></A>
<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>