diff options
Diffstat (limited to 'debian/manpages')
| -rw-r--r-- | debian/manpages/a2disconf.8 | 1 | ||||
| -rw-r--r-- | debian/manpages/a2dismod.8 | 1 | ||||
| -rw-r--r-- | debian/manpages/a2dissite.8 | 1 | ||||
| -rw-r--r-- | debian/manpages/a2enconf.8 | 97 | ||||
| -rw-r--r-- | debian/manpages/a2enmod.8 | 97 | ||||
| -rw-r--r-- | debian/manpages/a2ensite.8 | 91 | ||||
| -rw-r--r-- | debian/manpages/apache2.8 | 81 | ||||
| -rw-r--r-- | debian/manpages/apache2ctl.8 | 182 | ||||
| -rw-r--r-- | debian/manpages/apachectl.8 | 1 | ||||
| -rw-r--r-- | debian/manpages/apxs2.1 | 1 | ||||
| -rw-r--r-- | debian/manpages/check_forensic.8 | 16 | ||||
| -rw-r--r-- | debian/manpages/checkgid.8 | 36 | ||||
| -rw-r--r-- | debian/manpages/split-logfile.8 | 21 | ||||
| -rw-r--r-- | debian/manpages/suexec-custom.8 | 68 |
14 files changed, 694 insertions, 0 deletions
diff --git a/debian/manpages/a2disconf.8 b/debian/manpages/a2disconf.8 new file mode 100644 index 0000000..0423e86 --- /dev/null +++ b/debian/manpages/a2disconf.8 @@ -0,0 +1 @@ +.so man8/a2enconf.8 diff --git a/debian/manpages/a2dismod.8 b/debian/manpages/a2dismod.8 new file mode 100644 index 0000000..302eac1 --- /dev/null +++ b/debian/manpages/a2dismod.8 @@ -0,0 +1 @@ +.so man8/a2enmod.8 diff --git a/debian/manpages/a2dissite.8 b/debian/manpages/a2dissite.8 new file mode 100644 index 0000000..dfe1f1e --- /dev/null +++ b/debian/manpages/a2dissite.8 @@ -0,0 +1 @@ +.so man8/a2ensite.8 diff --git a/debian/manpages/a2enconf.8 b/debian/manpages/a2enconf.8 new file mode 100644 index 0000000..6f3a02b --- /dev/null +++ b/debian/manpages/a2enconf.8 @@ -0,0 +1,97 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH A2ENCONF 8 "14 February 2012" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +a2enconf, a2disconf \- enable or disable an apache2 configuration file +.SH SYNOPSIS +.B a2enconf +[ [\-q|\-\-quiet] +.IR configuration ] +.PP +.B a2disconf +[ [\-q|\-\-quiet] +.IR configuration ] +.SH DESCRIPTION +This manual page documents briefly the +.B a2enconf +and +.B a2disconf +commands. +.PP +.B a2enconf +is a script that enables the specified configuration file within the +.B apache2 +configuration. It does this by creating symlinks within +.BR /etc/apache2/conf-enabled . +Likewise, +.B a2disconf +disables a specific configuration part by removing those symlinks. It is not an +error to enable a configuration which is already enabled, or to disable one which is +already disabled. +.PP +Note that many configuration file may have a dependency to specific modules. +Unlike module dependencies, these are not resolved automatically. Configuration +fragments stored in the conf-available directory are considered non-essential or +being installed and manged by reverse dependencies (e.g. web scripts). +.SH OPTIONS +.TP +.B \-q, \-\-quiet +Don't show informative messages. +.TP +.B \-m, \-\-maintmode +Enables the maintainer mode, that is the program invocation is effectuated +automatically by a maintainer script. This switch should not be used by end +users. +.TP +.B \-p, \-\-purge +When disabling a module, purge all traces of the module in the internal state +data base. +.SH "EXIT STATUS" +.B a2enconf +and +.B a2disconf +exit with status 0 if all +.IR configuration s +are processed successfully, 1 if errors occur, 2 if an invalid option was used. +.SH EXAMPLES +.RS +.B "a2enconf security" +.br +.B "a2disconf charset" +.RE +.PP +Enables Apache security directives stored in the +.B security +configuration files, and disables the +.B charset +configuration. +.SH FILES +.TP +.B /etc/apache2/conf-available +Directory with files giving information on available configuration files. +.TP +.B /etc/apache2/conf-enabled +Directory with links to the files in +.B conf-available +for enabled configuration files. +.SH "SEE ALSO" +.BR apache2ctl (8), +.BR a2enmod (8), +.BR a2dismod (8). +.SH AUTHOR +This manual page was written by Arno Toell <debian@toell.net> for the Debian +GNU/Linux distribution, as it is a Debian-specific script with the package. diff --git a/debian/manpages/a2enmod.8 b/debian/manpages/a2enmod.8 new file mode 100644 index 0000000..016dc9b --- /dev/null +++ b/debian/manpages/a2enmod.8 @@ -0,0 +1,97 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH A2ENMOD 8 "12 October 2006" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +a2enmod, a2dismod \- enable or disable an apache2 module +.SH SYNOPSIS +.B a2enmod +[ [\-q|\-\-quiet] +.IR module ] +.PP +.B a2dismod +[ [\-q|\-\-quiet] +.IR module ] +.SH DESCRIPTION +This manual page documents briefly the +.B a2enmod +and +.B a2dismod +commands. +.PP +.B a2enmod +is a script that enables the specified module within the +.B apache2 +configuration. It does this by creating symlinks within +.BR /etc/apache2/mods-enabled . +Likewise, +.B a2dismod +disables a module by removing those symlinks. It is not an error to +enable a module which is already enabled, or to disable one which is +already disabled. +.PP +Note that many modules have, in addition to a .load file, an +associated .conf file. Enabling the module puts the configuration +directives in the .conf file as directives into the main server context of +.B apache2. +.SH OPTIONS +.TP +.B \-q, \-\-quiet +Don't show informative messages. +.TP +.B \-m, \-\-maintmode +Enables the maintainer mode, that is the program invocation is effectuated +automatically by a maintainer script. This switch should not be used by end +users. +.TP +.B \-p, \-\-purge +When disabling a module, purge all traces of the module in the internal state +data base. +.SH "EXIT STATUS" +.B a2enmod +and +.B a2dismod +exit with status 0 if all +.IR module s +are processed successfully, 1 if errors occur, 2 if an invalid option was used. +.SH EXAMPLES +.RS +.B "a2enmod imagemap" +.br +.B "a2dismod mime_magic" +.RE +.PP +Enables the +.B mod_imagemap +module, and disables the +.B mod_mime_magic +module. +.SH FILES +.TP +.B /etc/apache2/mods-available +Directory with files giving information on available modules. +.TP +.B /etc/apache2/mods-enabled +Directory with links to the files in +.B mods-available +for enabled modules. +.SH "SEE ALSO" +.BR apache2ctl (8), +.BR a2enconf (8), +.BR a2disconf (8). +.SH AUTHOR +This manual page was written by Daniel Stone <daniel@sfarc.net> for the Debian +GNU/Linux distribution, as it is a Debian-specific script with the package. diff --git a/debian/manpages/a2ensite.8 b/debian/manpages/a2ensite.8 new file mode 100644 index 0000000..9e37663 --- /dev/null +++ b/debian/manpages/a2ensite.8 @@ -0,0 +1,91 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH A2ENSITE 8 "8 June 2007" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +a2ensite, a2dissite \- enable or disable an apache2 site / virtual host +.SH SYNOPSIS +.B a2ensite +[ [\-q|\-\-quiet] +.IR site ] +.PP +.B a2dissite +[ [\-q|\-\-quiet] +.IR site ] +.SH DESCRIPTION +This manual page documents briefly the +.B a2ensite +and +.B a2dissite +commands. +.PP +.B a2ensite +is a script that enables the specified site (which contains a <VirtualHost> block) within the +.B apache2 +configuration. It does this by creating symlinks within +.BR /etc/apache2/sites-enabled . +Likewise, +.B a2dissite +disables a site by removing those symlinks. It is not an error to +enable a site which is already enabled, or to disable one which is +already disabled. +.PP +Apache treats the very first virtual host enabled specially as every request not +matching any actual directive is being redirected there. Thus it should be called +.B 000-default +in order to sort before the remaining hosts to be loaded first. +.SH OPTIONS +.TP +.B \-q, \-\-quiet +Don't show informative messages. +.TP +.B \-m, \-\-maintmode +Enables the maintainer mode, that is the program invocation is effectuated +automatically by a maintainer script. This switch should not be used by end +users. +.TP +.B \-p, \-\-purge +When disabling a module, purge all traces of the module in the internal state +data base. +.SH "EXIT STATUS" +.B a2ensite +and +.B a2dissite +exit with status 0 if all +.IR site s +are processed successfully, 1 if errors occur, 2 if an invalid option was used. +.SH EXAMPLES +.RS +.B "a2dissite 000-default" +.RE +.PP +Disables the +.B default +site. +.SH FILES +.TP +.B /etc/apache2/sites-available +Directory with files giving information on available sites. +.TP +.B /etc/apache2/sites-enabled +Directory with links to the files in +.B sites-available +for enabled sites. +.SH "SEE ALSO" +.BR apache2ctl (8). +.SH AUTHOR +This manual page was written by Stefan Fritsch <sf@debian.org> (based on the a2enmod manual +page by Daniel Stone <daniel@sfarc.net>) for the Debian GNU/Linux distribution. diff --git a/debian/manpages/apache2.8 b/debian/manpages/apache2.8 new file mode 100644 index 0000000..4e0e124 --- /dev/null +++ b/debian/manpages/apache2.8 @@ -0,0 +1,81 @@ +.TH "APACHE2" 8 "2008-04-05" "Apache HTTP Server" "apache2" + +.SH NAME +apache2 \- Apache Hypertext Transfer Protocol Server +.SH "SYNOPSIS" +.PP +\fBapache2\fR [ -\fBd\fR \fIserverroot\fR ] [ -\fBf\fR \fIconfig\fR ] [ -\fBC\fR \fIdirective\fR ] [ -\fBc\fR \fIdirective\fR ] [ -\fBD\fR \fIparameter\fR ] [ -\fBe\fR \fIlevel\fR ] [ -\fBE\fR \fIfile\fR ] [ \fB-k\fR start|restart|graceful|stop|graceful-stop ] [ -\fBR\fR \fIdirectory\fR ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ] [ -\fBM\fR ] +.SH "SUMMARY" +.PP +apache2 is the Apache HyperText Transfer Protocol (HTTP) server program\&. It is designed to be run as a standalone daemon process\&. When used like this it will create a pool of child processes or threads to handle requests\&. +.PP +In general, apache2 should not be invoked directly, but rather should be +invoked via /etc/init.d/apache2 or apache2ctl\&. The default Debian +configuration requires environment variables that are defined in +/etc/apache2/envvars and are not available if apache2 is started directly. +However, apache2ctl can be used to pass arbitrary arguments to apache2. +.SH "DOCUMENTATION" +.PP +The full documentation is available in the apache2-doc package or at +http://httpd.apache.org/docs/2.2/ . Information about Debian specific changes +and configuration can be found in +/usr/share/doc/apache2/README.Debian.gz . +.SH "OPTIONS" +.TP +-d \fIserverroot\fR +Set the initial value for the ServerRoot directive to \fIserverroot\fR\&. This can be overridden by the ServerRoot directive in the configuration file\&. +.TP +-f \fIconfig\fR +Uses the directives in the file \fIconfig\fR on startup\&. If \fIconfig\fR does not begin with a /, then it is taken to be a path relative to the ServerRoot\&. The default is /etc/apache2/apache2\&.conf\&. +.TP +-k start|restart|graceful|stop|graceful-stop +Signals apache2 to start, restart, or stop\&. See Stopping Apache for more information\&. +.TP +-C \fIdirective\fR +Process the configuration \fIdirective\fR before reading config files\&. +.TP +-c \fIdirective\fR +Process the configuration \fIdirective\fR after reading config files\&. +.TP +-D \fIparameter\fR +Sets a configuration \fIparameter \fRwhich can be used with <IfDefine> sections in the configuration files to conditionally skip or process commands at server startup and restart\&. +.TP +-e \fIlevel\fR +Sets the LogLevel to \fIlevel\fR during server startup\&. This is useful for temporarily increasing the verbosity of the error messages to find problems during startup\&. +.TP +-E \fIfile\fR +Send error messages during server startup to \fIfile\fR\&. +.TP +-R \fIdirectory\fR +When the server is compiled using the SHARED_CORE rule, this specifies the \fIdirectory\fR for the shared object files\&. +.TP +-h +Output a short summary of available command line options\&. +.TP +-l +Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&. +.TP +-L +Output a list of directives together with expected arguments and places where the directive is valid\&. +.TP +-M +Dump a list of loaded Static and Shared Modules\&. +.TP +-S +Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&. +.TP +-t +Run syntax tests for configuration files only\&. The program immediately exits after these syntax parsing tests with either a return code of 0 (Syntax OK) or return code not equal to 0 (Syntax Error)\&. If -D \fIDUMP\fR_\fIVHOSTS \fRis also set, details of the virtual host configuration will be printed\&. If -D \fIDUMP\fR_\fIMODULES \fR is set, all loaded modules will be printed\&. +.TP +-v +Print the version of apache2, and then exit\&. +.TP +-V +Print the version and build parameters of apache2, and then exit\&. +.TP +-X +Run apache2 in debug mode\&. Only one worker will be started and the server will not detach from the console\&. +.SH SEE ALSO +.BR apache2ctl (8), +.BR /usr/share/doc/apache2/README.Debian.gz + diff --git a/debian/manpages/apache2ctl.8 b/debian/manpages/apache2ctl.8 new file mode 100644 index 0000000..eb8983d --- /dev/null +++ b/debian/manpages/apache2ctl.8 @@ -0,0 +1,182 @@ +.TH apache2ctl 8 "April 2008" +.\" The Apache Software License, Version 1.1 +.\" +.\" Copyright (c) 2000-2002 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 +.\" <http://www.apache.org/>. +.\" +.SH NAME +apache2ctl \- Apache HTTP server control interface +.SH SYNOPSIS +When acting in SysV init mode, apache2ctl takes simple, one-word commands, +defined below. +.PP +.B apachectl +.I command +.PP +.B apache2ctl +.I command +.PP +When acting in pass-through mode, apache2ctl can take all the arguments available +for the httpd binary. +.PP +.B apachectl +.RI [ httpd-argument ] +.PP +.B apache2ctl +.RI [ httpd-argument ] +.PP +.SH DESCRIPTION +.B apache2ctl +is a front end to the Apache HyperText Transfer Protocol (HTTP) +server. It is designed to help the administrator control the +functioning of the Apache +.B apache2 +daemon. +.PP +.B NOTE: +The default Debian configuration requires the environment variables +.BR APACHE_RUN_USER , +.BR APACHE_RUN_GROUP , +and +.B APACHE_PID_FILE +to be set in +.BR /etc/apache2/envvars . +.PP +The +.B apache2ctl +script returns a 0 exit value on success, and >0 if an error +occurs. For more details, view the comments in the script. +.PP +.SH OPTIONS +The \fIcommand\fP can be any one or more of the following options: +.TP 14 +.BI start +Start the Apache daemon. Gives an error if it is already running. +.TP +.BI stop +Stops the Apache daemon. +.TP +.BI restart +Restarts the Apache daemon by sending it a SIGHUP. If the daemon +is not running, it is started. +This command automatically checks the configuration files via +.BI configtest +before initiating the restart to to catch the most obvious errors. +However, it is still possible for the daemon to die because of problems +with the configuration. +.TP +.BI fullstatus +Displays a full status report from +.B mod_status. +For this to work, you need to have mod_status enabled on your server +and a text-based browser such as \fIlynx\fP available on your system. The +URL used to access the status report can be set by setting the +.B APACHE_STATUSURL +variable in +.BR /etc/apache2/envvars . +.TP +.BI status +Displays a brief status report. Similar to the fullstatus option, +except that the list of requests currently being served is omitted. +.TP +.BI graceful +Gracefully restarts the Apache daemon by sending it a SIGUSR1. If +the daemon is not running, it is started. This differs from a +normal restart in that currently open connections are not aborted. +A side effect is that old log files will not be closed immediately. +This means that if used in a log rotation script, a substantial delay may be +necessary to ensure that the old log files are closed before processing them. +This command automatically checks the configuration files via apache2ctl +configtest before initiating the restart to to catch the most obvious errors. +However, it is still possible for the daemon to die because of problems with +the configuration. +.TP +.BI graceful-stop +Gracefully stops the Apache httpd daemon. +This differs from a normal stop in that currently open connections are not +aborted. +A side effect is that old log files will not be closed immediately. +.TP +.BI configtest +Run a configuration file syntax test. It parses the configuration +files and either reports +.B "Syntax Ok" +or information about the particular syntax error. This test does not catch +all errors. +.TP +.BI help +Displays a short help message. +.TP +The following option was available in earlier versions but has been removed. +.TP +.BI startssl +To start httpd with SSL support, you should edit your configuration file to +include the relevant directives and then use the normal apache2ctl start. +.SH ENVIRONMENT +The behaviour of +.B apache2ctl +can be influenced with these environment variables: +.BR APACHE_HTTPD , +.BR APACHE_LYNX , +.BR APACHE_STATUSURL , +.BR APACHE_ULIMIT_MAX_FILES , +.BR APACHE_RUN_DIR , +.BR APACHE_LOCK_DIR , +.BR APACHE_RUN_USER , +.BR APACHE_ARGUMENTS , +.BR APACHE_ENVVARS . +See the comments in the script for details. +These variables (except +.BR APACHE_ENVVARS ) +can be set in +.BR /etc/apache2/envvars . +.SH SEE ALSO +.BR apache2(8) , +.BR /usr/share/doc/apache2/README.Debian.gz +. diff --git a/debian/manpages/apachectl.8 b/debian/manpages/apachectl.8 new file mode 100644 index 0000000..f80e645 --- /dev/null +++ b/debian/manpages/apachectl.8 @@ -0,0 +1 @@ +.so man8/apache2ctl.8 diff --git a/debian/manpages/apxs2.1 b/debian/manpages/apxs2.1 new file mode 100644 index 0000000..e41678b --- /dev/null +++ b/debian/manpages/apxs2.1 @@ -0,0 +1 @@ +.so man1/apxs.1 diff --git a/debian/manpages/check_forensic.8 b/debian/manpages/check_forensic.8 new file mode 100644 index 0000000..6771a9e --- /dev/null +++ b/debian/manpages/check_forensic.8 @@ -0,0 +1,16 @@ +.TH check_forensic 8 +.SH NAME +check_forensic \- tool to extract mod_log_forensic output from apache log files +.SH SYNOPSIS +.B check_forensic +<log_file> +.SH "DESCRIPTION" +chech_forensic is a simple shell script designed to help apache administrators +to extract mod_log_forensic output from apache2 log files. +It checks the forensic log for requests that did not complete +and outputs the request log for each one. +.PP +.SH AUTHOR +This manual page was written by Fabio M. Di Nitto +<fabbione@fabbione.net>, for the Debian GNU/Linux system +(but may be used by others). diff --git a/debian/manpages/checkgid.8 b/debian/manpages/checkgid.8 new file mode 100644 index 0000000..a0b7492 --- /dev/null +++ b/debian/manpages/checkgid.8 @@ -0,0 +1,36 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH CHECKGID 8 "November 3rd, 2001" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +checkgid \- checks the gid +.SH SYNOPSIS +.B checkgid group +.SH DESCRIPTION +This manual page documents briefly the +.B checkgid +command. +.PP +.\" TeX users may be more comfortable with the \fB<whatever>\fP and +.\" \fI<whatever>\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBcheckgid\fP is a program that checks whether it can setgid to the group +specified. This is to see if it is a valid group for apache2 to use at runtime. +If the user (should be run as superuser) is in that group, or can setgid to it, +it will return 0. +.SH AUTHOR +This manual page was written by Daniel Stone <daniel@sfarc.net> for the Debian +GNU/Linux distribution, as the original did not have a manpage. diff --git a/debian/manpages/split-logfile.8 b/debian/manpages/split-logfile.8 new file mode 100644 index 0000000..b4879f9 --- /dev/null +++ b/debian/manpages/split-logfile.8 @@ -0,0 +1,21 @@ +.TH "SPLIT-LOGFILE" 8 "2009-12-06" "Apache HTTP Server" "split-logfile" + +.SH NAME +split-logfile - Split combined virtual hosts access log into one file per virtual host + +.SH "SYNOPSIS" + +.PP +\fBsplit-logfile\fR < \fIlogfile\fR + +.SH "SUMMARY" + +.PP +This script will take a combined Web server access log file and break its contents into separate files. +It assumes that the first field of each line is the virtual host identity (put there by "%v"), and that the logfiles should be named that+".log" in the current directory. + +The combined log file is read from stdin. +Records read will be appended to any existing log files. + +.SH "EXAMPLES" +split-logfile < /var/log/apache2/other_vhosts_access.log diff --git a/debian/manpages/suexec-custom.8 b/debian/manpages/suexec-custom.8 new file mode 100644 index 0000000..5e1acfc --- /dev/null +++ b/debian/manpages/suexec-custom.8 @@ -0,0 +1,68 @@ +.TH suexec-custom 8 "April 2008" +.\" Copyright 1999-2004 The Apache Software Foundation +.\" Copyright 2008 Stefan Fritsch +.\" +.\" Licensed under the Apache License, Version 2.0 (the "License"); +.\" you may not use this file except in compliance with the License. +.\" You may obtain a copy of the License at +.\" +.\" http://www.apache.org/licenses/LICENSE-2.0 +.\" +.\" Unless required by applicable law or agreed to in writing, software +.\" distributed under the License is distributed on an "AS IS" BASIS, +.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +.\" See the License for the specific language governing permissions and +.\" limitations under the License. +.\" +.SH NAME +suexec \- Switch User For Exec +.SH SYNOPSIS +.B suexec -V +.PP +This is a customized version that can be configured with +config files in /etc/apache2/suexec. +.PP +No other synopsis for usage, because this program +is otherwise only used internally by the Apache HTTP server. +.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 in general, see the online +document `Apache suexec Support' on the HTTP server project's +Web site at http://httpd.apache.org/docs/suexec.html . +.PP +This version of suexec reads a config file on every execution. Therefore +it is a bit slower than the standard suexec version from the apache2-suexec +package. +.SH CONFIGURATION +If suexec is called by a user with name 'username', it will look into +/etc/apache2/suexec/username for configuration. If the file does not exist, +suexec will abort. By creating several config files, you can allow several +different apache run users to use suexec. +.PP +The first line in the file is used as the document root (/var/www in the +standard suexec) and the second line in the file is used as the suffix that is +appended to users' home directories (public_html in standard suexec). +.PP +If any of the lines is commented out (with #), suexec will refuse the +corresponding type of request. It is recommended to comment out the +userdir suffix if you don't need it. +.SH SECURITY +Do not set the document root to a path that includes users' home directories +(like /home or /var) or directories where users can mount removable media. +Doing so would create local security issues. Suexec does not allow one to set +the document root to the root directory / . +.SH OPTIONS +.IP -V +Display the list of compile-time settings used when \fBsuexec\fP +was built. No other action is taken. +.PD +.SH FILES +.BR /etc/apache2/suexec/www-data +.SH SEE ALSO +.BR apache2(8) , +.BR /usr/share/doc/apache2/README.Debian.gz , +.BR dpkg-statoverride(8) |