apache-perl(8)

NAME

apache-perl - Apache hypertext transfer protocol server

SYNOPSIS

apache-perl [ -X  ]  [  -F  ]  [  -R  libexecdir  ]  [  -d
serverroot ] [ -f config ] [ -C directive ] [ -c directive ] [ -D
parameter ]
apache-perl [ -h ] [ -l ] [ -L ] [ -v ] [ -V ] [ -S ] [ -t
] [ -T ]

DESCRIPTION

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 sig

nal to the initial (parent) process. The PID of this process is

written to a file as given in the configuration file. Alterna

tively 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 di

rective 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 ex

pected 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 ei

ther 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 con

figured document roots.

-F Run the main process in foreground, for pro

cess supervisors.

-X Run in single-process mode, for internal de

bugging purposes only; the daemon does not detach from the termi

nal or fork any children. Do NOT use this mode to provide ordi

nary 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

SEE ALSO

inetd(8).

February 2004

apache-perl(8)