


apachectl(8)                                         apachectl(8)


NAME
       apachectl - Apache HTTP server control interface

SYNOPSIS
       apachectl command [...]

DESCRIPTION
       apachectl  is a front end to the Apache HyperText Transfer
       Protocol (HTTP) server.  It is designed to help the admin-
       istrator  control the functioning of the Apache httpd dae-
       mon.

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

       The  apachectl  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
       http://www.apache.org/

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

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

       stop        Stops the Apache daemon.

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

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

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

       graceful    Gracefully restarts the Apache daemon by send-
                   ing it  a  SIGUSR1.   If  the  daemon  is  not



                          September 1997                        1





apachectl(8)                                         apachectl(8)


                   running,  it  is started.  This differs from a
                   normal restart in that currently open  connec-
                   tions  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 automat-
                   ically checks the configuration files via con-
                   figtest before initiating the restart to  make
                   sure Apache doesn't die.

       configtest  Run  a  configuration  file  syntax  test.  It
                   parses  the  configuration  files  and  either
                   reports  Syntax  Ok  or  detailed  information
                   about the particular syntax error.

       help        Displays a short help message.

SEE ALSO
       httpd(8)




































                          September 1997                        2


