| Index | Alphabetical Index |
Option Name: | icap_service |
---|---|
Replaces: | |
Requires: | --enable-icap-client |
Default Value: | none |
Suggested Config: |
|
Defines a single ICAP service using the following format: icap_service service_name vectoring_point [options] service_url service_name: ID an opaque identifier which must be unique in squid.conf vectoring_point: reqmod_precache|reqmod_postcache|respmod_precache|respmod_postcache This specifies at which point of transaction processing the ICAP service should be activated. *_postcache vectoring points are not yet supported. service_url: icap://servername:port/servicepath ICAP server and service location. ICAP does not allow a single service to handle both REQMOD and RESPMOD transactions. Squid does not enforce that requirement. You can specify services with the same service_url and different vectoring_points. You can even specify multiple identical services as long as their service_names differ. Service options are separated by white space. ICAP services support the following name=value options: bypass=on|off|1|0 If set to 'on' or '1', the ICAP service is treated as optional. If the service cannot be reached or malfunctions, Squid will try to ignore any errors and process the message as if the service was not enabled. No all ICAP errors can be bypassed. If set to 0, the ICAP service is treated as essential and all ICAP errors will result in an error page returned to the HTTP client. Bypass is off by default: services are treated as essential. routing=on|off|1|0 If set to 'on' or '1', the ICAP service is allowed to dynamically change the current message adaptation plan by returning a chain of services to be used next. The services are specified using the X-Next-Services ICAP response header value, formatted as a comma-separated list of service names. Each named service should be configured in squid.conf and should have the same method and vectoring point as the current ICAP transaction. Services violating these rules are ignored. An empty X-Next-Services value results in an empty plan which ends the current adaptation. Routing is not allowed by default: the ICAP X-Next-Services response header is ignored. ipv6=on|off Only has effect on split-stack systems. The default on those systems is to use IPv4-only connections. When set to 'on' this option will make Squid use IPv6-only connections to contact this ICAP service. Older icap_service format without optional named parameters is deprecated but supported for backward compatibility. Example: icap_service svcBlocker reqmod_precache bypass=0 icap://icap1.mydomain.net:1344/reqmod icap_service svcLogger reqmod_precache routing=on icap://icap2.mydomain.net:1344/respmod |
|
| Index | Alphabetical Index |