apachectl(8) apachectl(8)

NAME
       apachectl - Apache HTTP server control interface

SYNOPSIS
       aappaacchheeccttll command [...]

DESCRIPTION
       aappaacchheeccttll  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 hhttttppdd daemon.

       NNOOTTEE::  If  your  Apache  installation uses non-standard paths, you will
       need to edit the aappaacchheeccttll script to set the appropriate paths to  your
       PID  file  and  your  hhttttppdd binary.  See the comments in the script for
       details.

       The aappaacchheeccttll script returns a 0 exit value on success, and  >0  if  an
       error occurs.  For more details, view the comments in the script.

       Full documentation for Apache is available at hhttttpp::////hhttttppdd..aappaacchhee..oorrgg//

OOPPTTIIOONNSS
       The command can be any one or more of the following options:

       ssttaarrtt       Start  the  Apache daemon.  Gives an error if it is already
                   running.

       ssttoopp        Stops the Apache daemon.

       rreessttaarrtt     Restarts the Apache daemon by sending it a SIGHUP.  If  the
                   daemon  is  not running, it is started.  This command auto-
                   matically checks the  configuration  files  via  ccoonnffiiggtteesstt
                   before  initiating  the restart to make sure Apache doesn't
                   die.

       ffuullllssttaattuuss  Displays a full status report from mmooddssttaattuuss..  For this to
                   work,  you  need to have modstatus enabled on your server.
                   If lynx is available on your system it will be used to dis-
                   play the status.  Otherwise the default system browser will
                   be used. The URL used to access the status  report  can  be
                   set by editing the SSTTAATTUUSSUURRLL variable in the script.

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

       ggrraacceeffuull    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 ccoonnffiiggtteesstt before initiating
                   the restart to make sure Apache doesn't die.

       ccoonnffiiggtteesstt  Run a configuration file syntax test. It parses the config-
                   uration  files  and  either  reports  SSyynnttaaxx OOkk or detailed
                   information about the particular syntax error.

       hheellpp        Displays a short help message.

SEE ALSO
       hhttttppdd((88))



                                 February 2004                    apachectl(8)