Return-Path: Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 35812 invoked by uid 500); 29 Apr 2003 13:57:52 -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: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 35790 invoked by uid 500); 29 Apr 2003 13:57:51 -0000 Delivered-To: apmail-httpd-2.0-cvs@apache.org Date: 29 Apr 2003 13:57:48 -0000 Message-ID: <20030429135748.40190.qmail@icarus.apache.org> From: nd@apache.org To: httpd-2.0-cvs@apache.org Subject: cvs commit: httpd-2.0/docs/manual/programs suexec.html.en suexec.xml suexec.xml.meta suexec.html X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N nd 2003/04/29 06:57:48 Modified: docs/man suexec.8 Added: docs/manual/programs suexec.html.en suexec.xml suexec.xml.meta Removed: docs/manual/programs suexec.html Log: add fresh suexec manpage Revision Changes Path 1.8 +45 -73 httpd-2.0/docs/man/suexec.8 Index: suexec.8 =================================================================== RCS file: /home/cvs/httpd-2.0/docs/man/suexec.8,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- suexec.8 2 Feb 2003 20:46:06 -0000 1.7 +++ suexec.8 29 Apr 2003 13:57:48 -0000 1.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 + 1.1 httpd-2.0/docs/manual/programs/suexec.html.en Index: suexec.html.en =================================================================== 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.
1.1 httpd-2.0/docs/manual/programs/suexec.xml Index: suexec.xml =================================================================== 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.
 1.1 httpd-2.0/docs/manual/programs/suexec.xml.meta Index: suexec.xml.meta =================================================================== suexec /programs/ .. en