Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local/squid]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX]
By default, `make install' will install all the files in
`/usr/local/squid/bin', `/usr/local/squid/lib' etc. You can specify
an installation prefix other than `/usr/local/squid' using `--prefix',
for instance `--prefix=$HOME'.
For better control, use the options below.
Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var]
--libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include]
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
--datadir=DIR read-only architecture-independent data [DATAROOTDIR]
--infodir=DIR info documentation [DATAROOTDIR/info]
--localedir=DIR locale-dependent data [DATAROOTDIR/locale]
--mandir=DIR man documentation [DATAROOTDIR/man]
--docdir=DIR documentation root [DATAROOTDIR/doc/squid]
--htmldir=DIR html documentation [DOCDIR]
--dvidir=DIR dvi documentation [DOCDIR]
--pdfdir=DIR pdf documentation [DOCDIR]
--psdir=DIR ps documentation [DOCDIR]
Program names:
--program-prefix=PREFIX prepend PREFIX to installed program names
--program-suffix=SUFFIX append SUFFIX to installed program names
--program-transform-name=PROGRAM run sed PROGRAM on installed program names
System types:
--build=BUILD configure for building on BUILD [guessed]
--host=HOST cross-compile to build programs to run on HOST [BUILD]
Optional Features:
--disable-option-checking ignore unrecognized --enable/--with options
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--enable-maintainer-mode enable make rules and dependencies not useful
(and sometimes confusing) to the casual installer
--disable-dependency-tracking speeds up one-time build
--enable-dependency-tracking do not reject slow dependency extractors
--disable-strict-error-checking
By default squid is compiled with all possible
static compiler error-checks enbled. This flag
disables the behavior
--disable-loadable-modules
do not support loadable modules
--enable-shared[=PKGS] build shared libraries [default=yes]
--enable-static[=PKGS] build static libraries [default=yes]
--enable-fast-install[=PKGS]
optimize for fast installation [default=yes]
--disable-libtool-lock avoid locking (might break parallel builds)
--disable-optimizations Don't compile Squid with compiler optimizations
enabled. Optimization is good for production builds,
but not good for debugging. During development, use
--disable-optimizations to reduce compilation times
and allow easier debugging. This option implicitly
also enabled --disable-inline
--disable-inline Don't compile trivial methods as inline. Squid is
coded with much of the code able to be inlined.
Inlining is good for production builds, but not good
for development. During development, use
--disable-inline to reduce compilation times and
allow incremental builds to be quick. For production
builds, or load tests, use --enable-inline to have
squid make all trivial methods inlinable by the
compiler.
--enable-debug-cbdata Provide some debug information in cbdata
--enable-xmalloc-statistics
Show malloc statistics in status page
--enable-async-io=N_THREADS
Shorthand for "--with-aufs-threads=N_THREADS
--with-pthreads --enable-storeio=ufs,aufs"
--enable-disk-io="list of modules"
Build support for the list of disk I/O modules. Set
without a value or omitted, all available modules
will be built. See src/DiskIO for a list of
available modules, or Programmers Guide section on
DiskIO for details on how to build your custom disk
module
--enable-storeio="list of modules"
Build support for the list of store I/O modules. The
default is only to build the "ufs" module. See
src/fs for a list of available modules, or
Programmers Guide section <not yet written> for
details on how to build your custom store module
--enable-removal-policies="list of policies"
Build support for the list of removal policies. The
default is only to build the "lru" module. See
src/repl for a list of available modules, or
Programmers Guide section 9.9 for details on how to
build your custom policy
--enable-icmp Enable ICMP pinging and Network Measurement
--enable-delay-pools Enable delay pools to limit bandwidth usage
--enable-esi Enable ESI for accelerators. Benefits from expat or
libxml2. Enabling ESI will cause squid reverse
proxies to be capable of the Edge Acceleration
Specification (www.esi.org).
--enable-icap-client Enable the ICAP client.
--enable-ecap support loadable content adaptation modules
--enable-useragent-log Enable logging of User-Agent header
--enable-referer-log Enable logging of Referer header
--disable-wccp Disable Web Cache Coordination Protocol
--disable-wccpv2 Disable Web Cache Coordination V2 Protocol
--enable-kill-parent-hack
Kill parent on shutdown
--disable-snmp Disable SNMP monitoring support
--enable-cachemgr-hostname=hostname
Make cachemgr.cgi default to this host. If
unspecified, uses the name of the build-host
--enable-arp-acl Enable use of ARP ACL lists (ether address)
--disable-htcp Disable HTCP protocol support
--enable-ssl Enable ssl gatewaying support using OpenSSL
--enable-forw-via-db Enable Forw/Via database
--enable-cache-digests Use Cache Digests. See
http://wiki.squid-cache.org/SquidFaq/CacheDigests
--disable-poll Disable poll(2) support.
--disable-select Disable select(2) support.
--enable-kqueue Enable kqueue(2) support (experimental).
--disable-epoll Disable Linux epoll(2) support.
--disable-http-violations
This allows you to remove code which is known to
violate the HTTP protocol specification.
--enable-ipfw-transparent
Enable Transparent Proxy support for systems using
FreeBSD IPFW style redirection.
--enable-ipf-transparent
Enable Transparent Proxy support for systems using
IP-Filter network address redirection.
--enable-pf-transparent Enable Transparent Proxy support for systems using
PF network address redirection.
--enable-linux-netfilter
Enable Transparent Proxy support for Linux
(Netfilter)
--enable-linux-tproxy Enable real Transparent Proxy support for Netfilter
TPROXY (version 2).
--enable-leakfinder Enable Leak Finding code. Enabling this alone does
nothing; you also have to modify the source code to
use the leak finding functions. Probably Useful for
hackers only.
--enable-follow-x-forwarded-for
Enable support for following the X-Forwarded-For
HTTP header to try to find the IP address of the
original or indirect client when a request has been
forwarded through other proxies.
--disable-ident-lookups This allows you to remove code that performs Ident
(RFC 931) lookups.
--disable-internal-dns Prevents Squid from directly sending and receiving
DNS messages, and instead enables the old external
'dnsserver' processes.
--enable-default-hostsfile=path
Select default location for hosts file. See
hosts_file directive in squid.conf for details
--enable-auth="list of auth scheme modules"
Build support for the list of authentication
schemes. The default is to build support for the
Basic scheme. See src/auth for a list of available
modules, or Programmers Guide section authentication
schemes for details on how to build your custom auth
scheme module
--enable-basic-auth-helpers="list of helpers"
This option selects which basic scheme proxy_auth
helpers to build and install as part of the normal
build process. For a list of available helpers see
the helpers/basic_auth directory.
--enable-ntlm-auth-helpers="list of helpers"
This option selects which proxy_auth ntlm helpers to
build and install as part of the normal build
process. For a list of available helpers see the
helpers/ntlm_auth directory.
--enable-negotiate-auth-helpers="list of helpers"
This option selects which proxy_auth negotiate
helpers to build and install as part of the normal
build process. For a list of available helpers see
the helpers/negotiate_auth directory.
--enable-digest-auth-helpers="list of helpers"
This option selects which digest scheme
authentication helpers to build and install as part
of the normal build process. For a list of available
helpers see the helpers/digest_auth directory.
--enable-ntlm-fail-open Enable NTLM fail open, where a helper that fails one
of the Authentication steps can allow squid to still
authenticate the user.
--enable-external-acl-helpers="list of helpers"
This option selects which external_acl helpers to
build and install as part of the normal build
process. For a list of available helpers see the
helpers/external_acl directory.
--disable-mempools Disable memPools. Note that this option now simply
sets the default behaviour. Specific classes can
override this at runtime, and only lib/MemPool.c
needs to be altered to change the squid-wide default
for all classes.
--enable-win32-service Compile Squid as a WIN32 Service. Works only on
MS-Windows platforms (NT and up).
--disable-unlinkd Do not use unlinkd
--enable-stacktraces Enable automatic call backtrace on fatal errors
--enable-cpu-profiling Enable instrumentation to try and understand how CPU
power is spent by squid, by enabling specific probes
in selected functions. New probes can only be added
by modifying the source code. It is meant to help
developers in optimizing performance of Squid
internal functions. If you are not developer you
shouldn't enable this, as it slows squid down
somewhat. See lib/Profiler.c for more details.
--enable-x-accelerator-vary
Enable support for the X-Accelerator-Vary HTTP
header. Can be used to indicate variance within an
accelerator setup. Typically used together with
other code that adds custom HTTP headers to the
requests.
--enable-zph-qos Enable ZPH QOS support
--disable-ipv6 Disable IPv6 support
--enable-gnuregex Compile GNUregex. Unless you have reason to use this
option, you should not enable it. This library file
is usually only required on Windows and very old
Unix boxes which do not have their own regex library
built in.
--disable-translation Prevent Squid generating localized error page
templates and manuals. Which is usually tried, but
may not be needed.
--disable-auto-locale This prevents Squid providing localized error pages
based on the clients request headers. When disabled
Squid requires explicit language configuration.
Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--with-gnu-ld assume the C compiler uses GNU ld [default=no]
--with-pic try to use only PIC/non-PIC objects [default=use
both]
--with-tags[=TAGS] include additional configurations [automatic]
--with-default-user=USER
System user account for squid permissions. Default:
nobody
--with-logdir=PATH Default location for squid logs. default:
$DEFAULT_LOG_DIR
--with-pidfile=PATH Default location for squid PID file. default:
PREFIX/var/run/squid.pid
--with-aufs-threads=N_THREADS
Tune the number of worker threads for the aufs
object store.
--with-dl Use dynamic linking
--without-pthreads Disable POSIX Threads
--without-aio Do not use POSIX AIO. Default: auto-detect
--without-expat Do not use expat for ESI. Default: auto-detect
--without-libxml2 Do not use libxml2 for ESI. Default: auto-detect
--with-openssl{=PATH} Compile with the OpenSSL libraries. The path to the
OpenSSL development libraries and headers
installation can be specified if outside of the
system standard directories
--with-coss-membuf-size=size
COSS membuf size (default 1048576 bytes)
--with-large-files Enable support for large files (logs etc).
--with-build-environment=model
The build environment to use. Normally one of
POSIX_V6_ILP32_OFF32 32 bits
POSIX_V6_ILP32_OFFBIG 32 bits with large file support
POSIX_V6_LP64_OFF64 64 bits
POSIX_V6_LPBIG_OFFBIG large pointers and files
XBS5_ILP32_OFF32 32 bits (legacy)
XBS5_ILP32_OFFBIG 32 bits with large file support (legacy)
XBS5_LP64_OFF64 64 bits (legacy)
XBS5_LPBIG_OFFBIG large pointers and files (legacy)
default The default for your OS
--with-valgrind-debug Include debug instrumentation for use with valgrind
--with-filedescriptors=NUMBER
Force squid to support NUMBER filedescriptors
--with-cppunit-basedir=PATH
Path where the cppunit headers are libraries are
found for unit testing.
--without-libcap disable usage of Linux capabilities library to
control privileges
--with-ipv6-split-stack Force-Enable experimental split-stack support for
Windows XP and *BSD. Requires IPv6.
--with-po2html=[[PATH]]
absolute path to po2html executable
Some influential environment variables:
CC C compiler command
CFLAGS C compiler flags
LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a
nonstandard directory <lib dir>
LIBS libraries to pass to the linker, e.g. -l<library>
CPPFLAGS C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
you have headers in a nonstandard directory <include dir>
CXX C++ compiler command
CXXFLAGS C++ compiler flags
CPP C preprocessor
CXXCPP C++ preprocessor
F77 Fortran 77 compiler command
FFLAGS Fortran 77 compiler flags
PO2HTML Absolute path to po2html executable
Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations.