1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 4 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 5 6<html xmlns="http://www.w3.org/1999/xhtml"> 7 <head> 8 <meta name="generator" content="HTML Tidy, see www.w3.org" /> 9 10 <title>Apache module mod_env</title> 11 </head> 12 <!-- Background white, links blue (unvisited), navy (visited), red (active) --> 13 14 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" 15 vlink="#000080" alink="#FF0000"> 16 <div align="CENTER"> 17 <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> 18 19 <h3>Apache HTTP Server Version 1.3</h3> 20 </div> 21 22 23 <h1 align="CENTER">Apache module mod_env</h1> 24 25 <p>This module provides for modifying the environment which is 26 passed to CGI scripts and SSI pages.</p> 27 28 <p><a href="module-dict.html#Status" 29 rel="Help"><strong>Status:</strong></a> Base<br /> 30 <a href="module-dict.html#SourceFile" 31 rel="Help"><strong>Source File:</strong></a> mod_env.c<br /> 32 <a href="module-dict.html#ModuleIdentifier" 33 rel="Help"><strong>Module Identifier:</strong></a> 34 env_module<br /> 35 <a href="module-dict.html#Compatibility" 36 rel="Help"><strong>Compatibility:</strong></a> Available in 37 Apache 1.1 and later.</p> 38 39 <h2>Summary</h2> 40 41 <p>This module allows for control of the environment that will 42 be provided to CGI scripts and SSI pages. Environment variables 43 may be passed from the shell which invoked the httpd process. 44 Alternatively, environment variables may be set or unset within 45 the configuration process.</p> 46 47 <p>For additional information, we provide a document on <a 48 href="../env.html">Environment Variables in Apache</a>.</p> 49 50 <h2>Directives</h2> 51 52 <ul> 53 <li><a href="#passenv">PassEnv</a></li> 54 55 <li><a href="#setenv">SetEnv</a></li> 56 57 <li><a href="#unsetenv">UnsetEnv</a></li> 58 </ul> 59 <hr /> 60 61 <h2><a id="passenv" name="passenv">PassEnv</a> directive</h2> 62 <a href="directive-dict.html#Syntax" 63 rel="Help"><strong>Syntax:</strong></a> PassEnv 64 <em>env-variable</em> [<em>env-variable</em>] ...<br /> 65 <a href="directive-dict.html#Context" 66 rel="Help"><strong>Context:</strong></a> server config, virtual 67 host, directory, .htaccess<br /> 68 <a href="directive-dict.html#Override" 69 rel="Help"><strong>Override:</strong></a> FileInfo<br /> 70 <a href="directive-dict.html#Status" 71 rel="Help"><strong>Status:</strong></a> Base<br /> 72 <a href="directive-dict.html#Module" 73 rel="Help"><strong>Module:</strong></a> mod_env<br /> 74 <a href="directive-dict.html#Compatibility" 75 rel="Help"><strong>Compatibility:</strong></a> PassEnv is only 76 available in Apache 1.1 and later. Directory and .htaccess context 77 is available in Apache 1.3.7 and later. 78 79 <p>Specifies one or more environment variables to pass to CGI 80 scripts and SSI pages from the environment of the shell which 81 invoked the httpd process. Example:</p> 82<pre> 83 PassEnv LD_LIBRARY_PATH 84</pre> 85 <hr /> 86 87 <h2><a id="setenv" name="setenv">SetEnv</a> directive</h2> 88 <a href="directive-dict.html#Syntax" 89 rel="Help"><strong>Syntax:</strong></a> SetEnv <em>env-variable 90 value</em><br /> 91 <a href="directive-dict.html#Context" 92 rel="Help"><strong>Context:</strong></a> server config, virtual 93 host, directory, .htaccess<br /> 94 <a href="directive-dict.html#Override" 95 rel="Help"><strong>Override:</strong></a> FileInfo<br /> 96 <a href="directive-dict.html#Status" 97 rel="Help"><strong>Status:</strong></a> Base<br /> 98 <a href="directive-dict.html#Module" 99 rel="Help"><strong>Module:</strong></a> mod_env<br /> 100 <a href="directive-dict.html#Compatibility" 101 rel="Help"><strong>Compatibility:</strong></a> SetEnv is only 102 available in Apache 1.1 and later. Directory and .htaccess context 103 is available in Apache 1.3.7 and later. 104 105 <p>Sets an environment variable, which is then passed on to CGI 106 scripts and SSI pages. Example:</p> 107<pre> 108 SetEnv SPECIAL_PATH /foo/bin 109</pre> 110 <hr /> 111 112 <h2><a id="unsetenv" name="unsetenv">UnsetEnv</a> 113 directive</h2> 114 <a href="directive-dict.html#Syntax" 115 rel="Help"><strong>Syntax:</strong></a> UnsetEnv 116 <em>env-variable</em> [<em>env-variable</em>] ...<br /> 117 <a href="directive-dict.html#Context" 118 rel="Help"><strong>Context:</strong></a> server config, virtual 119 host, directory, .htaccess<br /> 120 <a href="directive-dict.html#Override" 121 rel="Help"><strong>Override:</strong></a> FileInfo<br /> 122 <a href="directive-dict.html#Status" 123 rel="Help"><strong>Status:</strong></a> Base<br /> 124 <a href="directive-dict.html#Module" 125 rel="Help"><strong>Module:</strong></a> mod_env<br /> 126 <a href="directive-dict.html#Compatibility" 127 rel="Help"><strong>Compatibility:</strong></a> UnsetEnv is only 128 available in Apache 1.1 and later. Directory and .htaccess context 129 is available in Apache 1.3.7 and later. 130 131 <p>Removes one or more environment variables from those passed 132 on to CGI scripts and SSI pages. Example:</p> 133<pre> 134 UnsetEnv LD_LIBRARY_PATH 135</pre> 136 <hr /> 137 138 <h3 align="CENTER">Apache HTTP Server Version 1.3</h3> 139 <a href="./"><img src="../images/index.gif" alt="Index" /></a> 140 <a href="../"><img src="../images/home.gif" alt="Home" /></a> 141 142 </body> 143</html> 144 145 146 147