Squid Web Cache wiki

Squid Web Cache documentation

🔗 Feature: eCAP support

🔗 Adapters Available

Adapter Website Squid Version
gzip compression http://code.google.com/p/squid-ecap-gzip/ 3.1
ClamAV scanner http://www.e-cap.org/Downloads 3.2.0.6 or later

Disclaimer: The Squid Project does not distribute, support, or endorse these eCAP adapters. Please contact adapter developers with any adapter-specific feedback.

🔗 Configuration

Install libecap and build Squid with the –enable-ecap configure option. Install an adapter module. The library and sample adapters are available from the eCAP site.

Enable eCAP support, configure Squid to load an adapter module, and specify which services the module provides:

ecap_enable on
loadable_modules /usr/local/lib/ecap_adapter_minimal.so
ecap_service eReqmod reqmod_precache 0 ecap://e-cap.org/ecap/services/sample/minimal
ecap_service eRespmod respmod_precache 0 ecap://e-cap.org/ecap/services/sample/minimal

Among all dynamically loaded services, only the services matching ecap_service configuration are enabled by Squid. However, enabling an adaptation service is not enough. You need to direct messages to the service(s) using adaptation_access directives:

adaptation_service_set reqFilter eReqmod
adaptation_service_set respFilter eRespmod

adaptation_access respFilter allow all
adaptation_access reqFilter allow all

ICAP and eCAP services can co-exist. ACLs control which service gets to process the HTTP message.

🔗 Optional eCAP features

Squid supports sending client IP address to the adapter via the libecap::metaClientIp transaction option. Please see eCAP FAQ for details and do not forget to enable adaptation_send_client_ip in squid.conf.

🔗 Supported eCAP versions

Squid-3.2 releases starting with v3.2.0.6 support libecap v0.2.0 and have a configure-time libecap version check.

Eventually, Squid may also check (at runtime) that the loaded adapter was built with a compatible libecap version, but that check will not be possible until libecap API supports it.

🔗 License Issues

Note: These are not legally binding opinions. If you have any doubts regarding the licensing please contact your lawyer.

Squid is licensed under the GPLv2+, which brings up the question of licensing for distributed Squid plugins. There are several, conflicting views regarding eCAP adapter licensing requirements, including:

Categories: Feature

Navigation: Site Search, Site Pages, Categories, 🔼 go up