freebsd-ports/www/apache20/Makefile.doc

156 lines
5.8 KiB
Text
Raw Normal View History

# Makefile.doc
# Author: Clement Laforet <clement@FreeBSD.org>
#
# This files contains:
# - make options output
# - apache2 man/docs routines
#
# $FreeBSD$
#
## Available knobs:
## By default, modules are compiled as dynamically loadable (DSO) modules.
##
## Modules knobs philosophy:
## Modules are split in categories, "make show-categories" shows you
## which modules they contain. You can enable/disable/customize a category:
## - To enable a category: WITH_<CATEGORY>_MODULES=yes
## [WITH_PROXY_MODULES=yes]
## - To disable a category: WITHOUT_<CATEGORY>_MODULES=yes
## [WITHOUT_DAV_MODULES=yes]
## - To customize a category: WITH_CUSTOM_<CATEGORY>
## [WITH_CUSTOM_PROXY="proxy proxy_http"]
##
## Apache-related
## WITH_MPM: prefork (default)
## worker
## perchild (deprecated)
## threadpool (testing purpose only)
## WITH_HTTP_PORT: default: 80
## WITH_LDAP: Enable LDAP support (mod_auth_ldap) (implies WITH_LDAP_MODULES)
## WITHOUT_V4MAPPED
## WITH_IPV6_V6ONLY: Don't allow IPv6 sockets to handle IPv4
## connections
## WITHOUT_SSL: Disable SSL support
## WITH_THREADS: Enable threads support !! USE IT WITH CARE !!
## WITH_DBM: Choose your DBM: bdb (Berkeley DB), gdbm or
## ndbm (default)
## WITH_BERKELEYDB: Choose your BerkeleyDB version: db2, db3,
## db4, db41, db42, db43 or FreeBSD (1.85)
## (default)
## WITH_STATIC_SUPPORT: Build statically linked support binaries
## WITH_STATIC_APACHE: Build a static version of httpd (implies
## WITH_STATIC_MODULES)
## WITH_ALL_STATIC_MODULES: All modules will be statically linked.
## WITH_STATIC_MODULES: List of modules to build modules statics
## (usefull for slave ports)
## (They must be already enabled (i.e.
## WITH_MODULES or with default configuration
## use 'make show-modules', to check if they are
## enabled)
## WITH_MODULES: List of modules you choose
## WITHOUT_MODULES: Disable selected modules
## WITH_SUEXEC: Enable suExec support
## SUEXEC_DOCROOT: SuExec root directory
## SUEXEC_USERDIR: User subdirectory (default public_html)
## SUEXEC_SAFEPATH: Set the safepath
- Update to 2.0.50 Important changes: *) SECURITY: CAN-2004-0493 (cve.mitre.org) Close a denial of service vulnerability identified by Georgi Guninski which could lead to memory exhaustion with certain input data. [Jeff Trawick] *) SECURITY: CAN-2004-0488 (cve.mitre.org) mod_ssl: Fix a buffer overflow in the FakeBasicAuth code for a (trusted) client certificate subject DN which exceeds 6K in length. [Joe Orton] Details can be found here: http://www.apache.org/dist/httpd/CHANGES_2.0 - Use autoconf 2.59 - Add add SUEXEC_LOGFILE tunable to set suexec logfile [1] - Silently ignore removal of libexec/apache2 directory - Import latest version of apr_reslit.c from apr CVS which adds timeout feature to apr_reslist_acquire(). This is required for future mod_logio-st. - Add explicit dependency on libiconv (so nowwe support libiconv) - Move Windows Update fix from MASTER_SITE_LOCAL to ports tree - add WITH_EXPERIMENTAL_PATCHES knobs: These patches are backports from apache CVS HEAD or apr CVS HEAD. They have positive impacts on apache responsiveness but can be instable and are NOT currently supported by apache/apr teams. * exp-http-ready.patch: add "httpready" support for ACCEPT_FILTER (currently apache 2 only support "dataready") * exp-apr-kqueue.patch: add support for kqueue in apr_poll(). This patch greatly improves apache network performance (up to 18% according to the author, on my test box, between 13% and 21%) Test and feedback on -STABLE are welcome ;) For more details, please see: http://marc.theaimsgroup.com/?t=108650227500001&r=1&w=2 Submitted by: knu [1] NOTE: Please set MASTER_SITE_APACHE_HTTPD to closest mirrors. you can easily find them from: http://www.apache.org/dyn/closer.cgi/httpd/ Thanks :
2004-07-01 07:54:56 +02:00
## SUEXEC_LOGFILE: Set log file for suexec (default: /var/log/httpd-suexec.log)
## SUEXEC_UIDMIN: Minimal allowed UID (default 1000)
## SUEXEC_GIDMIN: Minimal allowed GID (default 1000)
## SUEXEC_CALLER: User allowed to call SuExec (default
## ${WWWOWN} (www))
## SUEXEC_UMASK: Defines umask for suexec'd process(default:
## unset)
## WITH_DEBUG: Build a debug versoin of apache (set CFLAGS
## to "-O0 -g -ggdb3" or ${DEBUG_FLAGS} and
## defines WITH_EXCEPTION_HOOK too)
## WITH_EXCEPTION_HOOK: Enable fatal exception hook
##
## Port-related:
## WITHOUT_WWW: Implies NO_CGI, NO_WWWDATA, NO_ICONS and
## NO_ERROR
2004-10-21 09:08:46 +02:00
## WITH_CUSTOM_WWW: Let you choose your ${PREFIX}/www components
## [cgi|errordocs|icons|wwwdata]
##
## Optionnal patches:
## WITH_EXPERIMENTAL_PATCHES Add performance patches (generally backported
## from apr/httpd CVS)
## WITH_WINDOWSUPDATEFIX Add a fix to use apache as proxy with
## Windows Update service.
##
## Available make targets:
## show-options: prints this message
## show-modules: prints list of available modules
## show-categories: prints list of modules sorted by category
##
## Examples:
## make WITH_STATIC_MODULES="ssl rewrite include" WITH_EXPERIMENTAL_MODULES=yes \
## WITH_CUSTOM_AUTH="auth auth_dbm"
## make WITHOUT_MODULES="access speling status" WITH_PROXY_MODULES=yes
## make WITH_MODULES="include rewrite auth"
##
## Note: If you define your custom options in /etc/make.conf, don't forget
## to do not use quotes.
##
DOCSDIR= ${PREFIX}/share/doc/apache2
EXAMPLESDIR= ${PREFIX}/share/examples/apache2
MAKE_ENV+= EXAMPLESDIR=${EXAMPLESDIR}
.if defined(NOPORTDOCS)
MAKE_ENV+= NOPORTDOCS=yes
.endif
MAN1= dbmmanage.1 htdigest.1 htpasswd.1
MAN8= ab.8 apachectl.8 apxs.8 httpd.8 logresolve.8 rotatelogs.8 suexec.8
.if defined(WITHOUT_WWW)
NO_CGI= YES
NO_WWWDATA= YES
NO_ICONS= YES
NO_ERROR= YES
.elif defined(WITH_CUSTOM_WWW)
. if ${WITH_CUSTOM_WWW:Mcgi} == ""
NO_CGI= YES
. endif
. if ${WITH_CUSTOM_WWW:Mwwwdata} == ""
NO_WWWDATA= YES
. endif
. if ${WITH_CUSTOM_WWW:Merrordocs} == ""
NO_ERROR= YES
. endif
. if ${WITH_CUSTOM_WWW:Micons} == ""
NO_ICONS= YES
. endif
.endif
.if defined(NO_CGI)
MAKE_ENV+= NO_CGI=yes
PLIST_SUB+= CGI="@comment "
.else
PLIST_SUB+= CGI=""
.endif
.if defined(NO_ICONS)
MAKE_ENV+= NO_ICONS=yes
PLIST_SUB+= ICONS="@comment "
.else
PLIST_SUB+= ICONS=""
.endif
.if defined(NO_WWWDATA)
MAKE_ENV+= NO_WWWDATA=yes
PLIST_SUB+= WWWDATA="@comment "
.else
PLIST_SUB+= WWWDATA=""
.endif
.if defined(NO_ERROR)
MAKE_ENV+= NO_ERROR=yes
PLIST_SUB+= ERROR="@comment "
.else
PLIST_SUB+= ERROR=""
.endif
PORTDOCS= #don't blame me ;-)