apache-perl8

Usage

Overview

apache-perl 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. Alternatively apache-perl may be invoked by the Internet daemon inetd(8) each time a connection to the HTTP service is made.

This manual page only lists the command line arguments. For details of the directives necessary to configure apache-perl see the Apache manual, which is part of the Apache distribution or can be found at http://httpd.apache.org/. Paths in this manual may not reflect those compiled into apache-perl.

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 ServerRoot 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 overridden by the ServerRoot command in the configuration file. The default is /usr/local/apache.

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

-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 directive 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 syntax parsing with either a return code of 0 (Syntax OK) or return code not equal to 0 (Syntax Error).

-T

Same as option -t but does not check the configured document roots.

-F

Run the main process in foreground, for process supervisors.

-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 apache-perl , and then exit.

-V

Print the version and build parameters of apache-perl , and then exit.

Files

/etc/apache-perl/httpd.conf
/etc/apache-perl/srm.conf
/etc/apache-perl/access.conf
/etc/apache-perl/mime.types
/etc/apache-perl/magic
/var/log/apache-perl/error.log
/var/log/apache-perl/access.log
/var/run/apache-perl.pid