You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@httpd.apache.org by Brian Behlendorf <br...@hyperreal.com> on 1996/05/03 04:37:59 UTC

revamped Configuration file

To try and be a little bit more friendly, I revamped the module
configuration section a little bit.  Let me know what you think.
It involved moving some of the modules, and more importantly 
making some modules which were currently defaulted as compiled-in to be
compiled-out.

	Brian
# Config file for the Apache httpd.

# Configuration.tmpl is the template for Configuration. Configuration should
# be edited to select system type. Configuration.tmpl should only be changed
# when a new system or module is added, or an existing one modified.

# There are three types of lines here:

# '#' comments, distinguished by having a '#' as the first non-blank character
#
# Lines which set a Make option --- these are simply copied into the Makefile
#
# Module selection lines, distinguished by having 'Module' at the front.
# These list the configured modules, in priority order (highest priority
# first).  They're down at the bottom.

# First, ordinary compile-time configuration.

# What to call the compiler:  For normal machines with ANSI compilers
# CC= cc
# For Suns or other non-ANSI platforms. Please make sure your gcc is
# 2.0 or later, as 1.40 seems to create bad code for the Sun 4.
CC= gcc

# CFLAGS, compile flags.

# -DMINIMAL_DNS is now obsolete. Use httpd.conf settings of
# HostnameLookups on
# or
# HostnameLookups off
#
# If you want to have more secure hostname resolution at the cost of some 
# performance, use -DMAXIMUM_DNS.
# If you want setting the xbit of a file to cause it to be treated as
# server-included HTML (unless it is a CGI script), say -DXBITHACK.  Note
# that this is a run-time option, per-directory, either way (via the XBITHACK
# command); this option only sets the default.

# If you find that your OS can't cope with mmap (compiles OKAY but refuses
# to run and moans "httpd: Could not mmap memory" .. or similar) try
# disabling use of shared memory for process management (scoreboard with
# -DNO_MMAP

# Status Instrumentation
#  In order for the status module to obtain full statistics Apache must
#  be modified to keep track of various information.  This is not
#  turned on by default.
# In order to enable full status details add -DSTATUS to
# the end of the CFLAGS line below

# [Some other former Apache compile-time options are now treated differently;
#  the virtual host code is always present; DBM auth is an optional module, and
#  may be configured out by changing the module config below, though it still
#  defaults in.  Note that this config file does not include DBM auth by
#  default --- configure it in below if you need it].

CFLAGS= -O2

# Place here any flags you may need upon linking, such as a flag to
# prevent dynamic linking (if desired)
LFLAGS= 

# Place here any extra libraries you may need to link to. 
# -lndbm is commonly required for DBM auth, if that is configured in.
EXTRA_LIBS=

# AUX_CFLAGS are system-specific control flags.
# NOTE: IF YOU DO NOT CHOOSE ONE OF THESE, EDIT httpd.h AND CHOOSE
# SETTINGS FOR THE SYSTEM FLAGS. IF YOU DON'T, BAD THINGS WILL HAPPEN.

# For SunOS 4
#AUX_CFLAGS= -DSUNOS4
# For Solaris 2.
#AUX_CFLAGS= -DSOLARIS2
#AUX_LIBS= -lsocket -lnsl
# For SGI IRIX. Use the AUX_LIBS line if you're using NIS and want
# user-supported directories
#AUX_CFLAGS= -DIRIX
#AUX_LIBS= -lsun
# For HP-UX       n.b. if you use the paid-for HP CC compiler, use flag -Ae
#AUX_CFLAGS= -DHPUX
# For AIX
#AUX_CFLAGS= -DAIX -U__STR__
# For Ultrix
#AUX_CFLAGS= -DULTRIX
# For DEC OSF/1
#AUX_CFLAGS= -DOSF1
# For NeXT
#AUX_CFLAGS= -DNEXT
# For Sequent
#AUX_CFLAGS= -DSEQUENT
# For Linux -m486 ONLY IF YOU HAVE 486 BINARY SUPPORT IN KERNEL
#AUX_CFLAGS= -DLINUX
# For A/UX
#AUX_CFLAGS= -DAUX -D_POSIX_SOURCE
#AUX_LIBS= -lposix -lbsd -s
# For SCO ODT 3
# libcrypt_i available from sosco.sco.com, files /SLS/lng225b.Z and
# /SLS/lng225b.ltr.Z
# the -Oe option causes cc to die compiling mod_imap (using 3.0.0a of the dev sys)
#CFLAGS= -Oacgiltz
#AUX_CFLAGS= -DSCO
#AUX_LIBS= -lPW -lsocket -lmalloc -lcrypt_i
# For SCO OpenServer Release 5
#AUX_CFLAGS= -DSCO5
#AUX_LIBS=-lsocket -lmalloc -lprot
# For SVR4
#AUX_CFLAGS= -DSVR4
#AUX_LIBS= -lsocket -lnsl -lc
# For UnixWare 2.x, no longer just SVR4 (sigh) - use cc, not gcc
# AUX_CFLAGS= -DSVR4 -DUW2
# AUX_LIBS= -lsocket -lnsl -lcrypt
# For Amdahl UTS 2.1
# -Xa enables ANSI mode, -eft is expanded types
#AUX_CFLAGS= -Xa -eft -DUTS21
#AUX_LIBS= -lsocket -lbsd -la
# For HP/Apollo Domain/OS
#AUX_CFLAGS= -DAPOLLO
# For NetBSD/FreeBSD/BSDI 2.x
# -m486 only if you are running on Intel 486/586
#AUX_CFLAGS= -m486
# BSDI doesn't need -lcrypt
#AUX_LIBS= -lcrypt
# For QNX
#AUX_CFLAGS= -DQNX
#AUX_LFLAGS= -N 0x20000
# For LynxOS
#AUX_CFLAGS= -DLYNXOS
#EXTRA_LIBS=-lbsd -ldes -lc_p
# For DG/UX 5.4
#AUX_CFLAGS= -DDGUX
#AUX_LIBS=

# For EMX OS/2 port
#AUX_CFLAGS= -Zbsd-signals -Zbin-files
#-DNO_KILLPG -DNEED_STRCASECMP -DNO_SETSID
#-g
#AUX_LIBS= -lsocket -llibufc -lgdbm -lbsd

################################################################
# Module configuration
#
# Modules are listed in reverse priority order --- the ones that come
# later can override the behavior of those that come earlier.  This
# can have visible effects; for instance, if UserDir followed Alias,
# you couldn't alias out a particular user's home directory.

# The configuration below is what we consider a decent default 
# configuration.  If you want the functionality provided by a particular
# module, remove the "#" sign at the beginning of the line. But remember, 
# the more modules you compile into the server, the larger the executable
# is and the more memory it will take, so if you are unlikely to use the
# functionality of a particular module you might wish to leave it out.

## Basic modules (i.e., generally useful stuff that works everyplace):
## You should probably not comment out any of these unless you know what it
## does and you know you won't need it.

Module mime_module         mod_mime.o
Module access_module       mod_access.o
Module auth_module         mod_auth.o
Module negotiation_module  mod_negotiation.o
Module includes_module     mod_include.o
Module dir_module          mod_dir.o
Module cgi_module          mod_cgi.o
Module userdir_module      mod_userdir.o
Module alias_module        mod_alias.o
Module common_log_module   mod_log_common.o

## The asis module implemented ".asis" file types, which allow the embedding
## of HTTP headers at the beginning of the document.  mod_imap handles internal 
## imagemaps (no more cgi-bin/imagemap/!).  mod_actions is used to specify 
## CGI scripts which act as "handlers" for particular files, for example to
## automatically convert every GIF to another file type.

Module asis_module        mod_asis.o
Module imap_module        mod_imap.o
Module action_module      mod_actions.o

## cern_meta mimicks the behavior of the CERN web server with regards to 
## metainformation files.  mod_env allows the setting of extra CGI environment
## variables.  The anon_auth module allows for anonymous-FTP-style username/
## password authentication.

# Module cern_meta_module   mod_cern_meta.o
# Module env_module         mod_env.o
# Module anon_auth_module   mod_auth_anon.o

## The status module allows the server to display current details about 
## how well it is performing and what it is doing.  Consider also enabling 
## -DSTATUS (see the CFLAGS section near the start of the file) to allow
## full status information.  Check conf/access.conf on how to enable this.

# Module status_module	mod_status.o

## Optional authentication modules, which should only be
## uncommented out if you have the neccessary system support.
## (if you don't have the decade-old "new" DBM libs, for example)
## db_auth works with Berkeley DB files, and msql_auth checks 
## against an MSQL database.  Finally, mod_digest implements HTTP 
## Digest Authentication rather than the less secure Basic Auth
## used by the other modules.

# Module dbm_auth_module  mod_auth_dbm.o
# Module db_auth_module   mod_auth_db.o
# Module msql_auth_module mod_auth_msql.o
# Module digest_module    mod_digest.o

## Optional modules for NCSA user-agent/referer logging compatibility
## We recommend, however, that you migrate to the configurable logging
## module, below.

# Module agent_log_module    mod_log_agent.o
# Module referer_log_module  mod_log_referer.o

## This is a *replacement* for mod_log_common which supports a
## LogFormat directive which allows you to specify what goes into 
## the TransferLog (if you want Referer, etc.)  source code for docs.
##
## If you play with this, remember to drop the standard
## mod_log_common --- a server with both will work, but you'll get
## very confused trying to figure out what's going on...

# Module config_log_module mod_log_config.o

## Finally, outright experiments --- mod_dld defines commands which
## allows other modules to be loaded in at runtime, and mod_cookies
## uses Netscape cookies to automatically construct and log accurate
## click-trails from Netscape cookies, for Netscape-using clients who
## aren't coming in via proxy.   

# Module dld_module     mod_dld.o
# Module cookies_module mod_cookies.o

## Even more finally, the proxy module. Incomplete, buggy and possibly dangerous
## Use it at your own risk.

# Module proxy_module       mod_proxy.o