mirror of
https://github.com/apache/httpd.git
synced 2025-08-27 16:41:57 +03:00
6f96ad5227
Obtained from: Apache 1.3.9 (minus unused files), tag APACHE_1_3_9 Submitted by: Apache Group git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@83750 13f79535-47bb-0310-9956-ffa450edef68
134 lines
5.2 KiB
Groff
134 lines
5.2 KiB
Groff
.TH apachectl 1 "September 1997"
|
|
.\" Copyright (c) 1997-1999 The Apache Group. 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. All advertising materials mentioning features or use of this
|
|
.\" software must display the following acknowledgment:
|
|
.\" "This product includes software developed by the Apache Group
|
|
.\" for use in the Apache HTTP server project (http://www.apache.org/)."
|
|
.\"
|
|
.\" 4. The names "Apache Server" and "Apache Group" must not be used to
|
|
.\" endorse or promote products derived from this software without
|
|
.\" prior written permission.
|
|
.\"
|
|
.\" 5. Products derived from this software may not be called "Apache"
|
|
.\" nor may "Apache" appear in their names without prior written
|
|
.\" permission of the Apache Group.
|
|
.\"
|
|
.\" 6. Redistributions of any form whatsoever must retain the following
|
|
.\" acknowledgment:
|
|
.\" "This product includes software developed by the Apache Group
|
|
.\" for use in the Apache HTTP server project (http://www.apache.org/)."
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``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 GROUP 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 Group and was originally based
|
|
.\" on public domain software written at the National Center for
|
|
.\" Supercomputing Applications, University of Illinois, Urbana-Champaign.
|
|
.\" For more information on the Apache Group and the Apache HTTP server
|
|
.\" project, please see <http://www.apache.org/>.
|
|
.SH NAME
|
|
apachectl \- Apache HTTP server control interface
|
|
.SH SYNOPSIS
|
|
.B apachectl
|
|
\fIcommand\fP [...]
|
|
.SH DESCRIPTION
|
|
.B apachectl
|
|
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 httpd
|
|
daemon.
|
|
.PP
|
|
.B NOTE:
|
|
If your Apache installation uses non-standard paths, you will need to
|
|
edit the
|
|
.B apachectl
|
|
script to set the appropriate paths to your PID file and your
|
|
.B httpd
|
|
binary. See the comments in the script for details.
|
|
.PP
|
|
The
|
|
.B apachectl
|
|
script returns a 0 exit value on success, and >0 if an error
|
|
occurs. For more details, view the comments in the script.
|
|
.PP
|
|
Full documentation for Apache is available at
|
|
.B http://www.apache.org/
|
|
.
|
|
.SH OPTIONS
|
|
The \fIcommand\fP can be any one or more of the following options:
|
|
.TP 12
|
|
.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 make sure Apache doesn't die.
|
|
.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 editing the
|
|
.B STATUSURL
|
|
variable in the script.
|
|
.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
|
|
.BI configtest
|
|
before initiating the restart to make sure Apache doesn't die.
|
|
.TP
|
|
.BI configtest
|
|
Run a configuration file syntax test. It parses the configuration
|
|
files and either reports
|
|
.B "Syntax Ok"
|
|
or detailed information about the particular syntax error.
|
|
.TP
|
|
.BI help
|
|
Displays a short help message.
|
|
.SH SEE ALSO
|
|
.BR httpd(8)
|
|
.
|