This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with Mac OS X Server. It is not available on standard Mac OS X (client) installations.

For more information about the manual page format, see the manual page for manpages(5).

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 administrator control the functioning of the Apache httpd daemon.

       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://httpd.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.  If lynx is available on your system it will  be  used
                   to  display  the status.  Otherwise the default system browser will be used. 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 sending it a SIGUSR1.  If the daemon is not run-
                   ning, 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 immedi-
                   ately.  This means that if used in a log rotation script, a substantial delay may be nec-
                   essary  to ensure that the old log files are closed before processing them.  This command
                   automatically checks the configuration files via configtest 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)



                                                February 2004                                   apachectl(8)