mod_env.html revision 5e93a97ccf053b0acd5c79b0aa349520fd922778
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<HTML>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<HEAD>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<TITLE>Apache module mod_env</TITLE>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe</HEAD>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<BODY>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--#include virtual="header.html" -->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<H1>Apache module mod_env</h1>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweThis module is contained in the <code>mod_env.c</code> file, and
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankovis not compiled in by default. It provides for
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowepassing environment variables to CGI/SSI scripts. Is is only available
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankovin Apache 1.1 and later.
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<h2>Summary</h2>
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweThis module allows Apache's CGI and SSI environment to inherit
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankovenvironment variables from the shell which invoked the httpd process.
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweCERN web-servers are able to do this, so this module is especially
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankovuseful to web-admins who wish to migrate from CERN to Apache without
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowerewriting all their scripts
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<h2>Directives</h2>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<ul>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<li><A HREF="#passenv">PassEnv</A>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<li><A HREF="#setenv">SetEnv</A>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<li><A HREF="#unsetenv">UnsetEnv</A>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe</ul>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<hr>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<A name="passenv"><h2>PassEnv</h2></A>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Syntax:</strong> PassEnv <em>variable variable ...</em><br>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Context:</strong> server config, virtual host<br>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Status:</strong> Base<br>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Module:</strong> mod_env<br>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Compatibility:</strong> PassEnv is only available in
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweApache 1.1 and later.<p>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweSpecifies one or more environment variables to pass to CGI scripts
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankovfrom the server's own environment. Example:
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov<pre>
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov PassEnv LD_LIBRARY_PATH
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov</pre>
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<HR>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<A name="setenv"><h2>SetEnv</h2></A>
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov<strong>Syntax:</strong> SetEnv <em>variable value</em><br>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<strong>Context:</strong> server config, virtual host<br>
a9478106a12424322498e53cf7cd75bd8a4d6004Yuri Pankov<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>