From: André Malo Date: Tue, 29 Apr 2003 13:57:48 +0000 (+0000) Subject: add fresh suexec manpage X-Git-Tag: pre_ajp_proxy~1762 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d3b2c74bc04aaeb250fc2dcd3145aa3853e9fda7;p=apache add fresh suexec manpage git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@99639 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/man/suexec.8 b/docs/man/suexec.8 index e06ccc98fe..8a7c3b46cf 100644 --- a/docs/man/suexec.8 +++ b/docs/man/suexec.8 @@ -1,75 +1,47 @@ -.TH suexec 8 "March 2001" -.\" The Apache Software License, Version 1.1 -.\" -.\" Copyright (c) 2000-2003 The Apache Software Foundation. All rights -.\" reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in -.\" the documentation and/or other materials provided with the -.\" distribution. -.\" -.\" 3. The end-user documentation included with the redistribution, -.\" if any, must include the following acknowledgment: -.\" "This product includes software developed by the -.\" Apache Software Foundation (http://www.apache.org/)." -.\" Alternately, this acknowledgment may appear in the software itself, -.\" if and wherever such third-party acknowledgments normally appear. -.\" -.\" 4. The names "Apache" and "Apache Software Foundation" must -.\" not be used to endorse or promote products derived from this -.\" software without prior written permission. For written -.\" permission, please contact apache@apache.org. -.\" -.\" 5. Products derived from this software may not be called "Apache", -.\" nor may "Apache" appear in their name, without prior written -.\" permission of the Apache Software Foundation. -.\" -.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED -.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -.\" DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR -.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF -.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND -.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT -.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" This software consists of voluntary contributions made by many -.\" individuals on behalf of the Apache Software Foundation. For more -.\" information on the Apache Software Foundation, please see -.\" . -.\" -.SH NAME -suexec \- Switch User For Exec -.SH SYNOPSIS -.B suexec -V +.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +.\" DO NOT EDIT! Generated from XML source. +.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +.de Sh \" Subsection +.br +.if t .Sp +.ne 5 .PP -No other synopsis for usage, because this program -is otherwise only used internally by the Apache HTTP server. +\fB\\$1\fR .PP -.SH DESCRIPTION -.B suexec -is the "wrapper" support program for the suexec behaviour for the -Apache HTTP server. It is run from within the server automatically -to switch the user when an external program has to be run under a -different user. For more information about suexec, see the online -document `Apache suexec Support' on the HTTP server project's -Web site at http://httpd.apache.org/docs/suexec.html . -.SH OPTIONS -.IP -V -Display the list of compile-time settings used when \fBsuexec\fP -was built. No other action is taken. -.PD -.SH SEE ALSO -.BR httpd(8) +.. +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Ip \" List item +.br +.ie \\n(.$>=3 .ne \\$3 +.el .ne 3 +.IP "\\$1" \\$2 +.. +.TH "SUEXEC" 8 "2003-04-29" "Apache HTTP Server" "suexec" + +.SH "SYNOPSIS" + +.PP +\fBsuexec\fR -\fBV\fR + + +.SH "SUMMARY" + +.PP +suexec is used by the Apache HTTP Server to switch to another user before executing CGI programs\&. In order to achieve this, it must run as root\&. Since the HTTP daemon normally doesn't run as root, the suexec executable needs the setuid bit set and must be owned by root\&. It should never be writable for any other person than root\&. + +.PP +For further information about the concepts and and the security model of suexec please refer to the suexec documentation (http://httpd\&.apache\&.org/docs-2\&.1/suexec\&.html)\&. + + +.SH "OPTIONS" + +.RS + +.TP +-V +If you are root, this option displays the compile options of suexec\&. For security reasons all configuration options are changable only at compile time\&. +.RE + diff --git a/docs/manual/programs/suexec.html b/docs/manual/programs/suexec.html deleted file mode 100644 index bea3017af9..0000000000 --- a/docs/manual/programs/suexec.html +++ /dev/null @@ -1,52 +0,0 @@ - - - - - - - Manual Page: suexec - Apache HTTP Server - - - -
- [APACHE DOCUMENTATION] - -

Apache HTTP Server Version 2.1

-
- - - -

Manual Page: suexec

- -
-NAME
-     suexec - Switch User For Exec
-
-SYNOPSIS
-     No synopsis for usage, because this program is  used  inter-
-     nally by Apache only.
-
-DESCRIPTION
-     suexec is the  "wrapper"  support  program  for  the  suEXEC
-     behaviour for Apache.  It is run from within Apache automat-
-     ically to switch the user when an external program has to be
-     run  under  a  different  user.  For  more information about
-     suEXEC  see  the  document  `Apache  suEXEC  Support'  under
-     http://httpd.apache.org/docs-2.1/suexec.html .
-
-SEE ALSO
-     httpd(8)
-
-
-
- -

Apache HTTP Server Version 2.1

- Index - Home - - - - - diff --git a/docs/manual/programs/suexec.html.en b/docs/manual/programs/suexec.html.en new file mode 100644 index 0000000000..7c9b0eb2ae --- /dev/null +++ b/docs/manual/programs/suexec.html.en @@ -0,0 +1,53 @@ + + + +suexec - Switch user before executing external programs - Apache HTTP Server + + + + +
+

Modules | Directives | FAQ | Glossary | Sitemap

+

Apache HTTP Server Version 2.1

+
+
<-
+

suexec - Switch user before executing external programs

+

suexec is used by the Apache HTTP Server to switch + to another user before executing CGI programs. In order to achieve this, + it must run as root. Since the HTTP daemon normally doesn't + run as root, the suexec executable needs the + setuid bit set and must be owned by root. It should never be + writable for any other person than root.

+ +

For further information about the concepts and and the security model + of suexec please refer to the suexec documentation (http://httpd.apache.org/docs-2.1/suexec.html).

+
+ +
top
+
+

Synopsis

+

suexec -V

+
top
+
+

Options

+ +
+
-V
+ +
If you are root, this option displays the compile options of +suexec. For security reasons all configuration options are +changable only at compile time.
+ +
+
+ + \ No newline at end of file diff --git a/docs/manual/programs/suexec.xml b/docs/manual/programs/suexec.xml new file mode 100644 index 0000000000..0cd23927eb --- /dev/null +++ b/docs/manual/programs/suexec.xml @@ -0,0 +1,39 @@ + + + + +Programs + +suexec - Switch user before executing external programs + + +

suexec is used by the Apache HTTP Server to switch + to another user before executing CGI programs. In order to achieve this, + it must run as root. Since the HTTP daemon normally doesn't + run as root, the suexec executable needs the + setuid bit set and must be owned by root. It should never be + writable for any other person than root.

+ +

For further information about the concepts and and the security model + of suexec please refer to the suexec documentation (http://httpd.apache.org/docs-2.1/suexec.html).

+ + +
Synopsis +

suexec -V

+
+ +
Options + +
+
-V
+ +
If you are root, this option displays the compile options of +suexec. For security reasons all configuration options are +changable only at compile time.
+ +
+
+ + diff --git a/docs/manual/programs/suexec.xml.meta b/docs/manual/programs/suexec.xml.meta new file mode 100644 index 0000000000..7f829208d2 --- /dev/null +++ b/docs/manual/programs/suexec.xml.meta @@ -0,0 +1,11 @@ + + + + suexec + /programs/ + .. + + + en + +