httpd man page on OpenBSD

Man page or keyword search:  
man Server   11362 pages
apropos Keyword Search (all sections)
Output format
OpenBSD logo
[printable version]

HTTPD(8)		OpenBSD System Manager's Manual		      HTTPD(8)

NAME
     httpd - Apache HyperText Transfer Protocol server

SYNOPSIS
     httpd [-46FhLlSTtUuVvX] [-C directive] [-c directive] [-D parameter]
	   [-d serverroot] [-f config] [-R libexecdir]

DESCRIPTION
     httpd is the Apache HyperText Transfer Protocol (HTTP) server program.
     It is designed to be run as a stand-alone daemon process.	When used like
     this it 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 configuration file.
     Normally this service can be enabled for startup on OpenBSD by editing
     /etc/rc.conf.local.

     Alternatively, httpd may be invoked by the Internet daemon inetd(8) each
     time a connection to the HTTP service is made.

     httpd can be made to support HTTPS transactions if RSA certificates are
     generated and the utility is started with the -DSSL flag.	See ssl(8) for
     further information.

     By default, httpd will chroot(2) to the ``ServerRoot'' path, serving
     documents from the ``DocumentRoot'' path.	As a result of the default
     secure behaviour, httpd cannot access any objects outside ``ServerRoot''
     - this security measure is taken in case httpd is compromised.  This is
     not without drawbacks, though:

     CGI programs may fail due to the limited environment available inside
     this chroot space.	 ``UserDir'', of course, cannot access files outside
     the directory space.  Other modules will also have issues.
     ``DocumentRoot'' directories or any other files needed must be inside
     ``ServerRoot''.  For this to work, pathnames inside the configuration
     file do not need adjustment relative to ``ServerRoot''.  For this option
     to remain secure, it is important that no files or directories writable
     by user www or group www are created inside the ``ServerRoot''.

     The -u option (see below) can be specified to disable chroot(2)
     functionality.

     This manual page only lists the command line arguments.  For details of
     the directives necessary to configure httpd, see the Apache manual in
     /usr/share/doc/html/httpd/.  Paths in this manual page reflect those
     compiled into httpd by default with OpenBSD.

     The options are as follows:

     -4	     Assume IPv4 addresses on ambiguous directives (default).  Along
	     with -6 and -U, this can be used to remove ambiguities in cases
	     such as "BindAddress *".

     -6	     Assume IPv6 addresses on ambiguous directives.

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

     -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.

     -d serverroot
	     Set the initial value for the ``ServerRoot'' directive to
	     serverroot.  This can be overridden by the ``ServerRoot'' command
	     in the configuration file.	 The default is /var/www.

     -F	     Run the main process in foreground.  For process supervisors.

     -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.

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

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

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

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

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

     -T	     Run syntax tests for configuration files only, without
	     DocumentRoot checks.  The program immediately exits after this
	     syntax parsing with either a return code of 0 (Syntax OK) or
	     return code not equal to 0 (Syntax Error).

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

     -U	     Do not assume a specific address family for ambiguous
	     specifications.

     -u	     By default httpd will chroot(2) to the ``ServerRoot'' path.  The
	     -u option disables this behaviour, and returns httpd to the
	     expanded "unsecure" behaviour.

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

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

     -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.

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

FILES
     /var/www/cgi-bin/
     /var/www/conf/httpd.conf
     /var/www/conf/magic
     /var/www/conf/mime.types
     /var/www/icons/
     /var/www/logs/access_log
     /var/www/logs/error_log
     /var/www/logs/etag-state
     /var/www/logs/httpd.pid
     /var/www/logs/ssl_engine_log
     /var/www/logs/ssl_request_log
     /var/www/logs/ssl_scache.db
     /var/www/users/
     /etc/rc.conf.local

SEE ALSO
     dbmmanage(1), htdigest(1), htpasswd(1), chroot(2), apachectl(8), apxs(8),
     inetd(8), logresolve(8), rc.conf.local(8), rotatelogs(8), ssl(8),
     suexec(8)

     The Apache manual: /usr/share/doc/html/httpd/.

OpenBSD 4.9			 May 18, 2010			   OpenBSD 4.9
[top]

List of man pages available for OpenBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net