You are viewing a plain text version of this content. The canonical link for it is here.
Posted to bugs@httpd.apache.org by bu...@apache.org on 2008/12/03 19:24:35 UTC
DO NOT REPLY [Bug 46333] New: Variable interpolation should be
documented
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Summary: Variable interpolation should be documented
Product: Apache httpd-2
Version: 2.3-HEAD
Platform: All
OS/Version: All
Status: NEW
Severity: normal
Priority: P2
Component: Documentation
AssignedTo: bugs@httpd.apache.org
ReportedBy: gm@ulmail.net
I've seen recently something like
Listen ${PORT}
in a httpd.conf.
But i'm unable to find the documentation for the variable interpolation.
I think env.html or configuring.html is a good place for that.
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
--- Comment #3 from Rainer Jung <ra...@kippdata.de> 2008-12-03 14:38:00 PST ---
What about this:
Index: configuring.xml
===================================================================
--- configuring.xml (revision 723103 ( https://svn.apache.org/viewcvs.cgi?view=rev&rev=723103 ))
+++ configuring.xml (working copy)
@@ -77,6 +77,9 @@
and white space occurring before a directive are ignored, so
you may indent directives for clarity.</p>
+ <p>Shell environment variables can be used in arguments
+ using the syntax <code>${MYVAR}</code>.</p>
+
<p>You can check your configuration files for syntax errors
without starting the server by using <code>apachectl
configtest</code> or the <code>-t</code> command line
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Ruediger Pluem <rp...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
Resolution| |INVALID
--- Comment #1 from Ruediger Pluem <rp...@apache.org> 2008-12-03 11:55:39 PST ---
You haven't found it in the documentation because this is no feature of httpd.
Maybe this is possible with 3rd party modules like mod_macro.
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
--- Comment #4 from Gerhard <gm...@ulmail.net> 2008-12-04 01:01:41 PST ---
That's what i've meant. The patch looks fine to me. Thank you.
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Shell environment variable interpolation in
config files should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Dan Poirier <po...@pobox.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|REOPENED |RESOLVED
Resolution| |FIXED
--- Comment #6 from Dan Poirier <po...@pobox.com> 2009-12-18 07:49:02 UTC ---
I never knew you could do that, and it looks handy.
Thanks for the doc patch. Committed to trunk in r892280
and 2.2.x in r892282.
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Nathan Stratton Treadway <ap...@nathanst.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |apachebugs@nathanst.com
--- Comment #5 from Nathan Stratton Treadway <ap...@nathanst.com> 2009-12-17 10:17:45 UTC ---
I just spent a while trying to find documentation for this functionality, too.
I was surprised to discover that it has been available since version 2.0a2
(according to e.g.
http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/CHANGES?revision=87174&view=co
), but still doesn't seem to be mentioned or explained in the httpd v2.2 or 2.3
documentation anywhere.
I see that since this bug was filed, the configuring.xml file has been updated
to include a mention of the line-length limit:
https://issues.apache.org/bugzilla/show_bug.cgi?id=45888
Perhaps something like the following could be added as well (replacing that new
paragraph with the following slightly modified one):
<p>The values of shell environment variables can be used in configuration
file lines using the syntax <code>${ENVVAR}</code>. If "ENVVAR" is
the name of a valid environment variable, the value of that
variable is substituted into that spot on the configuration file line,
and processing continues as if that text were found directly in the
configuration file. (If the ENVVAR variable is not found, the characters
"${ENVVAR}" are left unchanged for use by later stages in the config
file processing.)</p>
<p>The maximum length of a line in the configuration file,
after environment-variable substitution, joining any continued
lines, and removing leading and trailing white space, is 8192
characters.</p>
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Takashi Sato <ta...@lans-tv.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |takashi@lans-tv.com
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Variable interpolation should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Rainer Jung <ra...@kippdata.de> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |REOPENED
Resolution|INVALID |
--- Comment #2 from Rainer Jung <ra...@kippdata.de> 2008-12-03 13:49:56 PST ---
Hi Rüdiger,
I think the op means the environment variable interpolation in config. If you
have a shell environment variable XX and use ${XX} in the config, httpd
resolves it. You can find that in server/util.c:
/* Check a string for any ${ENV} environment variable
* construct and replace each them by the value of
* that environment variable, if it exists. If the
* environment value does not exist, leave the ${ENV}
* construct alone; it means something else.
*/
AP_DECLARE(const char *) ap_resolve_env(apr_pool_t *p, const char * word)
mod_define allows you to set variables inside httpd config, but if you simply
want to use external env vars, that's build in.
To the original reporter: do you have a documentation patch?
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Shell environment variable interpolation in
config files should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Dan Poirier <po...@pobox.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |CLOSED
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
DO NOT REPLY [Bug 46333] Shell environment variable interpolation in
config files should be documented
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46333
Nathan Stratton Treadway <ap...@nathanst.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Summary|Variable interpolation |Shell environment variable
|should be documented |interpolation in config
| |files should be documented
--
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org