


httpd(8)                                                 httpd(8)


NAME
       httpd - Apache hypertext transfer protocol server

SYNOPSIS
       httpd [ -X ] [ -R libexecdir ] [ -d serverroot ] [ -f con-
       fig ] [ -C directive ] [ -c directive ] [ -D parameter ]

       httpd [ -h ] [ -l ] [ -L ] [ -v ] [ -V ] [ -S ]


DESCRIPTION
       httpd is the Apache  HyperText  Transfer  Protocol  (HTTP)
       server  program.  It is designed to be run as a standalone
       daemon process. When used like this is will create a  pool
       of  child processes to handle requests. To stop it, send a
       TERM signal to the initial (parent) process.  The  PID  of
       this process is written to a file as given in the configu-
       ration file.  Alternatively httpd may be  invoked  by  the
       Internet  daemon  inetd(8)  each  time a connection to the
       HTTP service is made. Normally this service can be enabled
       for startup on OpenBSD by editing /etc/rc.conf.

       This  manual  page  only lists the command line arguments.
       For details of the directives necessary to configure httpd
       see the Apache manual, which is part of the Apache distri-
       bution or can be found at  http://www.apache.org/,  or  in
       /var/www/htdocs/manual.    Paths   in   this  manual  page
       reflect those compiled into httpd by default with OpenBSD.

OPTIONS
       -R libexecdir
                   This  option  is  only available if Apache was
                   built with the SHARED_CORE rule enabled  which
                   forces  the Apache core code to be placed into
                   a dynamic shared object (DSO) file. This  file
                   is  searched in a hardcoded path under Server-
                   Root per default. Use this option if you  want
                   to override it.

       -d serverroot
                   Set  the  initial  value  for  the  ServerRoot
                   directive to serverroot. This can be  overrid-
                   den  by the ServerRoot command in the configu-
                   ration file. The default is /var/www.

       -f config   Execute the commands in  the  file  config  on
                   startup.  If  config  does not begin with a /,
                   then it is taken to be a path relative to  the
                   ServerRoot. The default is conf/httpd.conf.

       -C directive
                   Process  the  configuration  directive  before
                   reading config files.




                          February 1999                         1





httpd(8)                                                 httpd(8)


       -c directive
                   Process  the  configuration  directive   after
                   reading config files.

       -D parameter
                   Sets  a  configuration  parameter which can be
                   used with <IfDefine>...</IfDefine> sections in
                   the  configuration files to conditionally skip
                   or process commands.

       -h          Output a short summary  of  available  command
                   line options.

       -l          Output  a  list  of  modules compiled into the
                   server.

       -L          Output a  list  of  directives  together  with
                   expected arguments and places where the direc-
                   tive is valid.

       -S          Show the settings as parsed  from  the  config
                   file  (currently  only  shows  the virtualhost
                   settings).

       -t          Run syntax tests for configuration files only.
                   The program immediately exits after these syn-
                   tax parsing with either a  return  code  of  0
                   (Syntax  OK)  or  return  code  not equal to 0
                   (Syntax Error).

       -X          Run  in  single-process  mode,  for   internal
                   debugging  purposes  only; the daemon does not
                   detach from the terminal or fork any children.
                   Do  NOT  use this mode to provide ordinary web
                   service.

       -v          Print the version of httpd , and then exit.

       -V          Print the  version  and  build  parameters  of
                   httpd , and then exit.

       The  documents  served by httpd should not be owned by the
       user which httpd is running as (usually www).  They  must,
       however, be readable by this user.

FILES
       /var/www/conf/httpd.conf
       /var/www/conf/srm.conf
       /var/www/conf/access.conf
       /var/www/conf/mime.types
       /var/www/logs/error_log
       /var/www/logs/access_log
       /var/www/logs/httpd.pid
       /etc/rc.conf



                          February 1999                         2





httpd(8)                                                 httpd(8)


SEE ALSO
       inetd(8).























































                          February 1999                         3


