Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 55882 invoked from network); 24 Sep 2008 09:43:00 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 24 Sep 2008 09:43:00 -0000 Received: (qmail 63270 invoked by uid 500); 24 Sep 2008 09:42:56 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 63209 invoked by uid 500); 24 Sep 2008 09:42:56 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 63198 invoked by uid 99); 24 Sep 2008 09:42:56 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 24 Sep 2008 02:42:56 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 24 Sep 2008 09:42:04 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 3F274238896D; Wed, 24 Sep 2008 02:42:38 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r698484 - in /httpd/httpd/branches/2.2.x/docs/manual/mod: mod_suexec.xml mod_userdir.xml Date: Wed, 24 Sep 2008 09:42:37 -0000 To: cvs@httpd.apache.org From: nilgun@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080924094238.3F274238896D@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: nilgun Date: Wed Sep 24 02:42:37 2008 New Revision: 698484 URL: http://svn.apache.org/viewvc?rev=698484&view=rev Log: pre-translation improvements Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_suexec.xml httpd/httpd/branches/2.2.x/docs/manual/mod/mod_userdir.xml Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_suexec.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_suexec.xml?rev=698484&r1=698483&r2=698484&view=diff ============================================================================== --- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_suexec.xml (original) +++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_suexec.xml Wed Sep 24 02:42:37 2008 @@ -42,7 +42,7 @@ SuexecUserGroup -User and group permissions for CGI programs +User and group for CGI programs to run as SuexecUserGroup User Group server config virtual host @@ -52,9 +52,10 @@

The SuexecUserGroup directive allows you to specify a user and group for CGI programs to run as. Non-CGI - requests are still processes with the user specified in the User - directive. This directive replaces the Apache 1.3 configuration of - using the User and Group directives inside of VirtualHosts.

+ requests are still processes with the user specified in the User directive. This directive replaces + the Apache 1.3 configuration of using the User and + Group directives inside of VirtualHosts.

Example Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_userdir.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_userdir.xml?rev=698484&r1=698483&r2=698484&view=diff ============================================================================== --- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_userdir.xml (original) +++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_userdir.xml Wed Sep 24 02:42:37 2008 @@ -84,27 +84,31 @@ http://www.example.com/~bob/one/two.html will be translated to:

- - - - - - -
UserDir directive usedTranslated path
UserDir public_html~bob/public_html/one/two.html
UserDir /usr/web/usr/web/bob/one/two.html
UserDir /home/*/www/home/bob/www/one/two.html
- -

The following directives will send redirects to the client:

- - - - - - - -
UserDir directive usedTranslated path
UserDir http://www.example.com/usershttp://www.example.com/users/bob/one/two.html
UserDir -http://www.example.com/*/usrhttp://www.example.com/bob/usr/one/two.html
UserDir -http://www.example.com/~*/http://www.example.com/~bob/one/two.html
+ + + + + + + + + +
UserDir directive usedTranslated path
UserDir public_html~bob/public_html/one/two.html
UserDir /usr/web/usr/web/bob/one/two.html
UserDir /home/*/www/home/bob/www/one/two.html
+ +

The following directives will send redirects to the client:

+ + + + + + + + + + +
UserDir directive usedTranslated path
UserDir http://www.example.com/usershttp://www.example.com/users/bob/one/two.html
UserDir http://www.example.com/*/usrhttp://www.example.com/bob/usr/one/two.html
UserDir http://www.example.com/~*/http://www.example.com/~bob/one/two.html
- + Be careful when using this directive; for instance, "UserDir ./" would map "/~root" to "/" - which is probably undesirable. It is strongly @@ -113,49 +117,54 @@ module="core">Directory directive and the Security Tips page for more information. - + -

Additional examples:

+

Additional examples:

-

To allow a few users to have UserDir directories, but -not anyone else, use the following:

+

To allow a few users to have UserDir directories, but + not anyone else, use the following:

- -UserDir disabled
-UserDir enabled user1 user2 user3 -
- -

To allow most users to have UserDir directories, but -deny this to a few, use the following:

- - -UserDir enabled
-UserDir disabled user4 user5 user6 -
- -

It is also possible to specify alternative user directories. -If you use a command like:

- -Userdir public_html /usr/web http://www.example.com/ - -

With a request for http://www.example.com/~bob/one/two.html, will try to -find the page at ~bob/public_html/one/two.html first, then -/usr/web/bob/one/two.html, and finally it will send a redirect -to http://www.example.com/bob/one/two.html.

-

If you add a redirect, it must be the last alternative in the list. -Apache cannot determine if the redirect succeeded or not, so if you have -the redirect earlier in the list, that will always be the alternative -that is used.

- -

User directory substitution is not active by default in versions -2.1.4 and later. In earlier versions, UserDir public_html -was assumed if no UserDir -directive was present.

+ + UserDir disabled
+ UserDir enabled user1 user2 user3 +
+ +

To allow most users to have UserDir directories, but + deny this to a few, use the following:

+ + + UserDir enabled
+ UserDir disabled user4 user5 user6 +
+ +

It is also possible to specify alternative user directories. + If you use a command like:

+ + + Userdir public_html /usr/web http://www.example.com/ + + +

With a request for + http://www.example.com/~bob/one/two.html, will try to + find the page at ~bob/public_html/one/two.html first, then + /usr/web/bob/one/two.html, and finally it will send a + redirect to http://www.example.com/bob/one/two.html.

+ +

If you add a redirect, it must be the last alternative in the list. + Apache cannot determine if the redirect succeeded or not, so if you have + the redirect earlier in the list, that will always be the alternative + that is used.

+ +

User directory substitution is not active by default in versions + 2.1.4 and later. In earlier versions, UserDir public_html + was assumed if no UserDir + directive was present.

-public_html -tutorial + + public_html tutorial +