You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2002/02/04 04:06:57 UTC
cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en mod_mime.html.en
rbowen 02/02/03 19:06:57
Modified: htdocs/manual/mod core.html.en mod_mime.html.en
Log:
A few additional examples, and some links to related directives/docs.
Revision Changes Path
1.206 +61 -5 httpd-docs-1.3/htdocs/manual/mod/core.html.en
Index: core.html.en
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/core.html.en,v
retrieving revision 1.205
retrieving revision 1.206
diff -u -r1.205 -r1.206
--- core.html.en 11 Jan 2002 20:36:30 -0000 1.205
+++ core.html.en 4 Feb 2002 03:06:56 -0000 1.206
@@ -365,8 +365,12 @@
Off</code> disables this functionality. <code>AddDefaultCharset
On</code> enables Apache's internal default charset of
<code>iso-8859-1</code> as required by the directive. You can
- also specify an alternate <em>charset</em> to be used; e.g.
- <code>AddDefaultCharset utf-8</code>.</p>
+ also specify an alternate <em>charset</em> to be used.</p>
+
+ <p>For example:</p>
+
+ <code>AddDefaultCharset utf-8</code>
+
<hr />
<h2><a id="addmodule" name="addmodule">AddModule
@@ -388,6 +392,13 @@
of those modules. The server comes with a pre-loaded list of
active modules; this list can be cleared with the <a
href="#clearmodulelist">ClearModuleList</a> directive.</p>
+
+ <p>For example:</p>
+
+ <code>AddModule mod_include.c</code>
+
+ <p><strong>See also</strong>: <a
+ href="#clearmodulelist">ClearModuleList</a>,
<hr />
<h2><a id="allowoverride" name="allowoverride">AllowOverride
@@ -471,8 +482,10 @@
<dt>Limit</dt>
<dd>
- Allow use of the directives controlling host access (Allow,
- Deny and Order).</dd>
+ Allow use of the directives controlling host access (<a
+ href="mod_access.html#allow">Allow</a>,
+ <a href="mod_access.html#deny">Deny</a>
+ and <a href="mod_access.html#order">Order</a>).</dd>
<dt>Options</dt>
@@ -482,6 +495,9 @@
href="mod_include.html#xbithack">XBitHack</a>).</dd>
</dl>
+ <p>Example:</p>
+ <p><code>AllowOverride AuthConfig Indexes</code></p>
+
<p><strong>See Also:</strong> <a
href="#accessfilename">AccessFileName</a></p>
<hr />
@@ -510,6 +526,14 @@
as <a href="mod_auth.html#authuserfile">AuthUserFile</a> and <a
href="mod_auth.html#authgroupfile">AuthGroupFile</a> to
work.</p>
+
+ <p>For example:</p>
+
+ <code>AuthRealm Admins</code><br />
+ <code>AuthRealm "Top Secret"</br />
+
+ <p>The string provided for the <code>AuthRealm</code> is what will
+ appear in the password dialog provided by most browsers.</p>
<hr />
<h2><a id="authtype" name="authtype">AuthType
@@ -559,6 +583,11 @@
<em>IP-address</em> or a fully-qualified Internet
<em>domain-name</em>.</p>
+ <p>Examples:</p>
+
+ <code>BindAddress 192.168.15.48</code><br />
+ <code>BindAddress hostname.example.com</code>
+
<p>Only one <code>BindAddress</code> directive can be used. For
more control over which address and ports Apache listens to,
use the <code><a href="#listen">Listen</a></code> directive
@@ -694,6 +723,11 @@
dumps won't normally get written. If you want a core dump for
debugging, you can use this directive to place it in a
different location.</p>
+
+ <p>For example:</p>
+
+ <code>CoreDumpDirectory /tmp</code>
+
<hr />
<h2><a id="defaulttype" name="defaulttype">DefaultType
@@ -851,6 +885,8 @@
Directory, Location and Files sections work</a> for an
explanation of how these different sections are combined when a
request is received</p>
+ <p><strong>See also</strong>: <a
+ href="#directorymatch">DirectoryMatch</a></p>
<hr />
<h2><a id="directorymatch"
@@ -1210,6 +1246,11 @@
begins with a pipe (|) then it is assumed to be a command to
spawn to handle the error log.</p>
+ <p>Examples</p>
+
+ <code>ErrorLog logs/vhost1.error</code><br />
+ <code>ErrorLog |/usr/local/bin/errorlog.pl</code>
+
<p><strong>Apache 1.3 and above:</strong> Using
<code>syslog</code> instead of a filename enables logging via
syslogd(8) if the system supports it. The default is to use
@@ -1218,6 +1259,10 @@
<em>facility</em> can be one of the names usually documented in
syslog(1).</p>
+ <p>For example:</p>
+
+ <code>ErrorLog syslog</code>
+
<p>SECURITY: See the <a
href="../misc/security_tips.html#serverroot">security tips</a>
document for details on why your security could be compromised
@@ -1329,7 +1374,18 @@
href="#location"><code><Location></code></a> sections,
<code><Files></code> sections can be used inside
.htaccess files. This allows users to control access to their
- own files, at a file-by-file level.</p>
+ own files, at a file-by-file level.
+ For example, to password protect a single file within a
+ particular directory, you might add the following to your
+ <code>.htaccess</code> file:</p>
+
+ <pre>
+ <Files admin.cgi>
+ Require group admin
+ </Files></pre>
+
+ <p>(See <a href="#require">Require</a> for details on using the
+ <code>Require</code> directive</a>)</p>
<p><strong>See also</strong>: <a href="../sections.html">How
Directory, Location and Files sections work</a> for an
1.48 +17 -4 httpd-docs-1.3/htdocs/manual/mod/mod_mime.html.en
Index: mod_mime.html.en
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_mime.html.en,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- mod_mime.html.en 8 Oct 2001 01:34:31 -0000 1.47
+++ mod_mime.html.en 4 Feb 2002 03:06:56 -0000 1.48
@@ -260,7 +260,7 @@
be specified with or without a leading dot.</p>
<p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a></p>
+ multiple extensions</a>, <a href="#sethandler">SetHandler</a></p>
<hr />
<h2><a id="addlanguage" name="addlanguage">AddLanguage</a>
@@ -320,7 +320,8 @@
be specified with or without a leading dot.</p>
<p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a><br />
+ multiple extensions</a>, <a
+ href="#defaultlanguage">DefaultLanguage</a><br />
<strong>See also</strong>: <a
href="./mod_negotiation.html">mod_negotiation</a></p>
<hr />
@@ -398,6 +399,10 @@
languages, <samp>DefaultLanguage</samp> can only specify a
single language.</p>
+ <p>For example:</p>
+
+ <code>DefaultLanguage fr</code>
+
<p>If no <samp>DefaultLanguage</samp> directive is in force,
and a file does not have any language extensions as configured
by <samp>AddLanguage</samp>, then that file will be considered
@@ -437,6 +442,10 @@
<p>Note that this will override any filename extensions that
might determine the media type.</p>
+
+ <strong>See also</strong>: <a
+ href="#addtype">AddType</a></p>
+
<hr />
<h2><a id="removeencoding"
@@ -477,7 +486,8 @@
unencoded plaintext file.</p>
<p><b>Note:</b>RemoveEncoding directives are processed
- <i>after</i> any AddEncoding directives, so it is possible they
+ <i>after</i> any <a href="#addencoding">AddEncoding</a>
+ directives, so it is possible they
may undo the effects of the latter if both occur within the
same directory configuration.</p>
@@ -600,12 +610,15 @@
<p>Another example: if you wanted to have the server display a
status report whenever a URL of
<code>http://servername/status</code> was called, you might put
- the following into access.conf:</p>
+ the following into access.conf: (See <a
+ href="mod_status.html">mod_status</a> for more details.)</p>
<pre>
<Location /status>
SetHandler server-status
</Location>
</pre>
+
+ <p><strong>See also</strong>: <a href="#addhandler">AddHandler</a></p>
<hr />
<h2><a id="typesconfig" name="typesconfig">TypesConfig</a>
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en mo
Posted by Lars Eilebrecht <la...@hyperreal.org>.
According to Carlos Araya:
> If you're going to discourage something, always give an alternative. What
> would you do if you had to bind to one address on a machine with multiple
> addresses?
Use the Listen directive instead.
ciao...
--
Lars Eilebrecht - No matter where you go; you're there.
lars@hyperreal.org
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en
mod_mime.html.en
Posted by Carlos Araya <ca...@cvc.edu>.
IMHO:
If you're going to discourage something, always give an alternative. What
would you do if you had to bind to one address on a machine with multiple
addresses?
Carlos
On 02/03/02 20:30, "Lars Eilebrecht" <la...@hyperreal.org> wrote:
> According to Joshua Slive:
>
>>> + <p>Examples:</p>
>>> +
>>> + <code>BindAddress 192.168.15.48</code><br />
>>> + <code>BindAddress hostname.example.com</code>
>>> +
>>
>> Although hostnames are technically allowed, I think we shouldn't encourage
>> them.
>
> We shouldn't encourage the use of BindAddress at all.
>
>
> ciao...
--
Carlos E. Araya
---+ WebCT Administrator/Trainer
P | California Virtual Campus
- | C/O De Anza College
G | 21250 Stevens Creek Blvd
---+ Cupertino, CA 95014
email carlos@cvc.edu
web http://www.cvc1.org/ (work)
http://www.silverwolf-net.net (personal)
phone 408 257 0420 (work)
PGP Fingerprint: E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756
We cannot put off living until we are ready. The most salient
characteristic of life is its coerciveness: it is always urgent, 'here and
now' without any possible postponement. Life is fired at us point blank.
Jose Ortega Y Gasset
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
RE: cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en mod_mime.html.en
Posted by Lars Eilebrecht <la...@hyperreal.org>.
According to Joshua Slive:
>> + <p>Examples:</p>
>> +
>> + <code>BindAddress 192.168.15.48</code><br />
>> + <code>BindAddress hostname.example.com</code>
>> +
>
> Although hostnames are technically allowed, I think we shouldn't encourage
> them.
We shouldn't encourage the use of BindAddress at all.
ciao...
--
Lars Eilebrecht - Collect 1000 of these lines, and
lars@hyperreal.org - you'll have a large FREE BONUS FILE!
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
RE: cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en mod_mime.html.en
Posted by Joshua Slive <jo...@slive.ca>.
> From: rbowen@apache.org [mailto:rbowen@apache.org]
> rbowen 02/02/03 19:06:57
>
> Modified: htdocs/manual/mod core.html.en mod_mime.html.en
> Log:
> A few additional examples, and some links to related directives/docs.
This is good stuff. I hope you'll bring it forward to 2.0. A couple
comments below.
> + <p>Examples:</p>
> +
> + <code>BindAddress 192.168.15.48</code><br />
> + <code>BindAddress hostname.example.com</code>
> +
Although hostnames are technically allowed, I think we shouldn't encourage
them.
> + For example, to password protect a single file within a
> + particular directory, you might add the following to your
> + <code>.htaccess</code> file:</p>
> +
> + <pre>
> + <Files admin.cgi>
> + Require group admin
> + </Files></pre>
I think it deserves a note that this doesn't protect a "single file".
Rather, it protects the file admin.cgi in the directory and all
subdirectories.
Joshua.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org