mod_env.html revision c166eea2dab0d7c45a0c2580f2c9983206a43ad5
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<HTML>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<HEAD>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<TITLE>Apache module mod_env</TITLE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</HEAD>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<BODY
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac BGCOLOR="#FFFFFF"
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac TEXT="#000000"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift LINK="#0000FF"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift VLINK="#000080"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift ALINK="#FF0000"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift>
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac<!--#include virtual="header.html" -->
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac<H1 ALIGN="CENTER">Apache module mod_env</H1>
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac
3437829f938dbb44527d91fbbc5f430a1243c5a5JnRouvignac<p>This module provides for
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftpassing environment variables to CGI/SSI scripts.</p>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<P><A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftHREF="module-dict.html#Status"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftREL="Help"
05b42f00b813c3dc70cbb80d62089f9cc0f6f549ludovicp><STRONG>Status:</STRONG></A> Base
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftHREF="module-dict.html#SourceFile"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftREL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Source File:</STRONG></A> mod_env.c
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftHREF="module-dict.html#ModuleIdentifier"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftREL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Module Identifier:</STRONG></A> env_module
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftHREF="module-dict.html#Compatibility"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftREL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Compatibility:</STRONG></A> Available in Apache 1.1 and later.
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</P>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<H2>Summary</H2>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<!-- XXX: Should mention mod_setenvif and the effect of suexec -->
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<p>This module allows Apache's CGI and SSI environment to inherit
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftenvironment variables from the shell which invoked the httpd process.
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftCERN web-servers are able to do this, so this module is especially
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftuseful to web-admins who wish to migrate from CERN to Apache without
0c45338572f2f6593fea8fc9e70bcb9ef3a6d2f8matthew_swiftrewriting all their scripts</p>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<H2>Directives</H2>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<UL>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<LI><A HREF="#passenv">PassEnv</A>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<LI><A HREF="#setenv">SetEnv</A>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<LI><A HREF="#unsetenv">UnsetEnv</A>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</UL>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<HR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift<H2><A NAME="passenv">PassEnv</A> directive</H2>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift HREF="directive-dict.html#Syntax"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift REL="Help"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift><STRONG>Syntax:</STRONG></A> PassEnv <EM>variable variable ...</EM><BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Context"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Context:</STRONG></A> server config, virtual host<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Status"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Status:</STRONG></A> Base<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Module"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift><STRONG>Module:</STRONG></A> mod_env<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift HREF="directive-dict.html#Compatibility"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Compatibility:</STRONG></A> PassEnv is only available in
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftApache 1.1 and later.<P>
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftSpecifies one or more environment variables to pass to CGI scripts
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftfrom the server's own environment. Example:
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<PRE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift PassEnv LD_LIBRARY_PATH
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</PRE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<HR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift<H2><A NAME="setenv">SetEnv</A> directive</H2>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Syntax"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Syntax:</STRONG></A> SetEnv <EM>variable value</EM><BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Context"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Context:</STRONG></A> server config, virtual host<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Status"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Status:</STRONG></A> Base<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift HREF="directive-dict.html#Module"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Module:</STRONG></A> mod_env<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Compatibility"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Compatibility:</STRONG></A> SetEnv is only available in
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftApache 1.1 and later.<P>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftSets an environment variable, which is then passed on to CGI
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftscripts. Example:
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<PRE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift SetEnv SPECIAL_PATH /foo/bin
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</PRE>
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<HR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<H2><A NAME="unsetenv">UnsetEnv</A> directive</H2>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Syntax"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Syntax:</STRONG></A> UnsetEnv <EM>variable variable ...</EM><BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Context"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift><STRONG>Context:</STRONG></A> server config, virtual host<BR>
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift<A
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift HREF="directive-dict.html#Status"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Status:</STRONG></A> Base<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift HREF="directive-dict.html#Module"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift REL="Help"
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift><STRONG>Module:</STRONG></A> mod_env<BR>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<A
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift HREF="directive-dict.html#Compatibility"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift REL="Help"
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift><STRONG>Compatibility:</STRONG></A> UnsetEnv is only available in
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swiftApache 1.1 and later.<P>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swiftRemoves one or more environment variables from those passed on to
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swiftCGI scripts. Example:
61fbd336a48baa76e081a898f88762fc9fd82ee4matthew_swift<PRE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift UnsetEnv LD_LIBRARY_PATH
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</PRE>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<P>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift<!--#include virtual="footer.html" -->
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</BODY>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift</HTML>
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift
381702f11a0e7f4dfdd611ab124946bcaca74dd5matthew_swift