1APACHECTL(8) apachectl APACHECTL(8)
2
3
4
6 apachectl - Server control interface for httpd
7
9 apachectl [command]
10
11
13 apachectl is a front end to the Apache HyperText Transfer Protocol
14 (HTTP) server. It is designed to help the administrator control the
15 functioning of the Apache httpd daemon.
16
17 The apachectl script takes one-word arguments like start, restart, and
18 stop, and translates them into appropriate signals to httpd.
19
20 The apachectl script returns a 0 exit value on success, and >0 if an
21 error occurs.
22
23 Compatibility
24 The version of apachectl used on this system is a replacement script
25 intended to be mostly (but not completely) compatible with version
26 provided with Apache httpd. This apachectl mostly acts as a wrapper
27 around systemctl and manipulates the systemd service for httpd. The
28 interface to the Apache version of apachectl is described at
29 https://httpd.apache.org/docs/2.4/programs/apachectl.html.
30
31 The following differences are present in the version of apachectl
32 present on this system:
33
34 · Option arguments passed when starting httpd are not allowed. These
35 should be configured in the systemd service directly (see
36 httpd.service(8)).
37
38 · The "fullstatus" option is not available.
39
40 · The "status" option does not use or rely on the running server's
41 server-status output.
42
43
45 start
46 Start the Apache httpd daemon. Gives an error if it is already
47 running. This is equivalent to systemctl start httpd.service.
48
49 stop
50 Stops the Apache httpd daemon. This is equivalent to systemctl stop
51 httpd.service.
52
53 restart
54 Restarts the Apache httpd daemon. If the daemon is not running, it
55 is started. This is equivalent to systemctl restart httpd.service.
56
57 status
58 Displays a brief status report. This is equivalent to systemctl
59 status httpd.service.
60
61 graceful
62 Gracefully restarts the Apache httpd daemon. If the daemon is not
63 running, it is started. This differs from a normal restart in that
64 currently open connections are not aborted. A side effect is that
65 old log files will not be closed immediately. This means that if
66 used in a log rotation script, a substantial delay may be necessary
67 to ensure that the old log files are closed before processing them.
68 This is equivalent to systemctl kill --signal=SIGUSR1
69 --kill-who=main httpd.service.
70
71 graceful-stop
72 Gracefully stops the Apache httpd daemon. This differs from a
73 normal stop in that currently open connections are not aborted. A
74 side effect is that old log files will not be closed immediately.
75 This is equivalent to systemctl kill --signal=SIGWINCH
76 --kill-who=main httpd.service.
77
78 configtest
79 Run a configuration file syntax test. It parses the configuration
80 files and either reports Syntax OK or detailed information about
81 the particular syntax error. This is equivalent to httpd -t.
82
84 Please report bugs by filing an issue in Bugzilla via
85 https://bugzilla.redhat.com/.
86
88 httpd(8), httpd.conf(5), systemd(1), systemctl(1), httpd.service(8)
89
91 Apache Software Foundation contributors
92 Apache man page
93
94 Frank Dana
95 Fedora man page
96
97
98
99httpd 03/31/2020 APACHECTL(8)