1APACHECTL(8)                       apachectl                      APACHECTL(8)
2
3
4

NAME

6       apachectl - Server control interface for httpd
7

SYNOPSIS

9       apachectl [command]
10
11

DESCRIPTION

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

OPTIONS

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

BUGS

84       Please report bugs by filing an issue in Bugzilla via
85       https://bugzilla.redhat.com/.
86

SEE ALSO

88       httpd(8), httpd.conf(5), systemd(1), systemctl(1), httpd.service(8)
89

AUTHORS

91       Apache Software Foundation contributors
92           Apache man page
93
94       Frank Dana
95           Fedora man page
96
97
98
99httpd                             06/02/2021                      APACHECTL(8)
Impressum