summaryrefslogtreecommitdiff
path: root/docs/manual/programs/apachectl.html
blob: 15f6b7433a3ae7285e061f993653dc8d8c429304 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title>Manual Page: apachectl  - Apache HTTP Server</title></head>
<body bgcolor="#ffffff" text="#000000" link="#0000ff"
vlink="#000080" alink="#ff0000">
<!--#include virtual="header.html" -->
<h1 align="center">Manual Page: apachectl</h1>
<!-- This document was autogenerated from the man page -->
<pre>
<strong>NAME</strong>
     apachectl - Apache HTTP server control interface

<strong>SYNOPSIS</strong>
     <strong>apachectl </strong><em>command </em>[...]

<strong>DESCRIPTION</strong>
     <strong>apachectl </strong>is a front end to the  Apache  HyperText  Transfer
     Protocol (HTTP) server.  It is designed to help the adminis-
     trator control the functioning of the Apache <strong>httpd </strong>daemon.

     <strong>NOTE: </strong>If your Apache installation uses  non-standard  paths,
     you  will  need  to  edit  the  <strong>apachectl  </strong>script to set the
     appropriate paths to your PID file and  your  <strong>httpd  </strong>binary.
     See the comments in the script for details.

     The <strong>apachectl </strong>script returns a 0 exit value on success,  and
     &gt;0  if an error occurs.  For more details, view the comments
     in the script.

     Full   documentation   for   Apache    is    available    at
     <strong>http://httpd.apache.org/</strong>

<strong>OPTIONS</strong>
     The <em>command </em>can be any one or more of the following options:

     <strong>start       </strong>Start the Apache daemon.  Gives an error  if  it
                 is already running.

     <strong>stop        </strong>Stops the Apache daemon.

     <strong>restart     </strong>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 <strong>configtest </strong>before ini-
                 tiating the restart to make sure Apache  doesn't
                 die.

     <strong>fullstatus  </strong>Displays a full status report  from  <strong>mod_status.</strong>
                 For  this  to  work, you need to have mod_status
                 enabled on your server and a text-based  browser
                 such  as <em>lynx </em>available on your system.  The URL
                 used to access the status report can be  set  by
                 editing the <strong>STATUSURL </strong>variable in the script.

     <strong>status      </strong>Displays a brief status report.  Similar to  the
                 fullstatus  option,  except  that  the  list  of
                 requests currently being served is omitted.

     <strong>graceful    </strong>Gracefully restarts the Apache daemon by sending
                 it a SIGWINCH.  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 configura-
                 tion files via <strong>configtest </strong>before initiating  the
                 restart to make sure Apache doesn't die.

     <strong>configtest  </strong>Run a configuration file syntax test. It  parses
                 the  configuration files and either reports <strong>Syn-</strong>
                 <strong>tax Ok </strong>or detailed information about the partic-
                 ular syntax error.

     <strong>help        </strong>Displays a short help message.

<strong>SEE ALSO</strong>
     <strong>httpd(8)</strong>

</pre>
<!--#include virtual="footer.html" -->
</body></html>