www/apache22/Makefile.doc

   1 # $FreeBSD$
   2 #
   3 # Author:                               Clement Laforet <clement@FreeBSD.org>
   4 #
   5 ##
   6 ## By default, modules are compiled as dynamically loadable modules (DSO).
   7 ##
   8 ## Modules knobs philosophy:
   9 ##  Note: Use this only for special builds, modules should be selected by
  10 ##  #> make config
  11 ##
  12 ##   Apache-related
  13 ##      WITH_MPM:                 prefork (default)
  14 ##                                worker
  15 ##                                event
  16 ##                                itk
  17 ##      WITH_HTTP_PORT:           default: 80
  18 ##
  19 ##      WITH_STATIC_SUPPORT:      Build statically linked support binaries
  20 ##      WITH_STATIC_APACHE:       Build a static version of httpd (implies
  21 ##                                WITH_STATIC_MODULES)
  22 ##      WITH_ALL_STATIC_MODULES:  All modules will be statically linked.
  23 ##      WITH_STATIC_MODULES (*):  List of modules to build modules statics
  24 ##                                (useful for slave ports)
  25 ##                                (They must be already enabled (i.e.
  26 ##                                WITH_MODULES or with default configuration
  27 ##                                use 'make show-modules', to check if they are
  28 ##                                enabled)
  29 ##      WITH_SUEXEC:              Enable suEXEC support
  30 ##            SUEXEC_DOCROOT:     suEXEC root directory
  31 ##            SUEXEC_USERDIR:     User subdirectory (default public_html)
  32 ##            SUEXEC_SAFEPATH:    Set the safepath
  33 ##            SUEXEC_LOGFILE:     Set log file for suEXEC (default: /var/log/httpd-suexec.log)
  34 ##            SUEXEC_UIDMIN:      Minimal allowed UID (default 1000)
  35 ##            SUEXEC_GIDMIN:      Minimal allowed GID (default 1000)
  36 ##            SUEXEC_CALLER:      User allowed to call suEXEC (default
  37 ##                                ${WWWOWN} (www))
  38 ##            SUEXEC_UMASK:       Defines umask for suEXEC'd process(default:
  39 ##                                unset)
  40 ##      WITH_DEBUG:               Build a debug version of Apache (set CFLAGS
  41 ##                                to "-O0 -g -ggdb3" or ${DEBUG_FLAGS} and
  42 ##                                defines WITH_EXCEPTION_HOOK too)
  43 ##      WITH_EXCEPTION_HOOK:      Enable fatal exception hook
  44 ##
  45 ##  Optional patches without option:
  46 ##      WITH_ITK_PERDIR_REGEX     Add the per-directory setting AssignUserFromPath for mpm-itk
  47 ##                                as described on http://www.pvv.ntnu.no/~knuta/mpm-itk/
  48 ##      WITH_ITK_LIMITS           Add rlimits based on login class for mpm-itk
  49 ##
  50 ## Available make targets:
  51 ##      config:                   open the configure dialog
  52 ##      show config:              prints configured options
  53 ##      show-options:             prints this message
  54 ##      show-modules:             prints list of available modules
  55 ##
  56 ## Examples (*):
  57 ##      make WITH_STATIC_MODULES="SSL REWRITE INCLUDE"
  58 ##      Note: If you define your custom options in /etc/make.conf, don't forget
  59 ##            to do not use quotes.
  60 ##
  61 ## Note about OPTION IPV4_MAPPED
  62 ##  For security reasons this OPTION is disabled.
  63 ##  You can find more information about IP binding and configuration
  64 ##  on the Apache website: http://httpd.apache.org/docs/2.2/bind.html
  65 ##  To find out which binding was used to build httpd use the command
  66 ##   $> httpd -V
  67 ##