pfsense:squid:squid_result_codes
PFSense - Squid - Squid Result Codes
The Squid result code is composed of several tags (separated by underscore characters) which describe the response sent to the client.
One of these tags always exists to describe how it was delivered:
TCP | Requests on the HTTP port (usually 3128). |
UDP | Requests on the ICP port (usually 3130) or HTCP port (usually 4128). If ICP logging was disabled using the log_icp_queries option, no ICP replies will be logged. |
NONE | Squid delivered an unusual response or no response at all. Seen with cachemgr requests and errors, usually when the transaction fails before being classified into one of the above outcomes. Also seen with responses to CONNECT requests. |
These tags are optional and describe why the particular handling was performed or where the request came from:
CF | At least one request in this transaction was collapsed. See collapsed_forwarding for more details about request collapsing. Support for this tag has been added to Squid v5 on 2018-06-18 (commit d2a6dc). It may not be available in earlier Squid versions. |
CLIENT | The client request placed limits affecting the response. Usually seen with client issued a “no-cache”, or analogous cache control command along with the request. Thus, the cache has to validate the object. |
IMS | The client sent a revalidation (conditional) request. |
ASYNC | The request was generated internally by Squid. Usually this is background fetches for cache information exchanges, background revalidation from stale-while-revalidate cache controls, or ESI sub-objects being loaded. |
SWAPFAIL | The object was believed to be in the cache, but could not be accessed. A new copy was requested from the server. |
REFRESH | A revalidation (conditional) request was sent to the server. |
SHARED | This tag is not supported yet. This request was combined with an existing transaction by collapsed forwarding. NOTE: the existing request is not marked as SHARED. |
REPLY | The HTTP reply from server or peer. Usually seen on DENIED due to http_reply_access ACLs preventing delivery of servers response object to the client. |
These tags are optional and describe what type of object was produced:
NEGATIVE | Only seen on HIT responses. Indicating the response was a cached error response. e.g. “404 not found” |
STALE | The object was cached and served stale. This is usually caused by stale-while-revalidate or stale-if-error cache controls. |
OFFLINE | The requested object was retrieved from the cache during offline_mode. The offline mode never validates any object. |
INVALID | An invalid request was received. An error response was delivered indicating what the problem was. |
FAIL | Only seen on REFRESH to indicate the revalidation request failed. The response object may be the server provided network error or the stale object which was being revalidated depending on stale-if-error cache control. |
MODIFIED | Only seen on REFRESH responses to indicate revalidation produced a new modified object. |
UNMODIFIED | Only seen on REFRESH responses to indicate revalidation produced a 304 (Not Modified) status. The client gets either a full 200 (OK), a 304 (Not Modified), or (in theory) another response, depending on the client request and other details. |
REDIRECT | Squid generated an HTTP redirect response to this request. Only on Squid-3.2+ or Squid built with -DLOG_TCP_REDIRECTS compiler flag. |
These tags are optional and describe whether the response was loaded from cache, network, or otherwise:
HIT | The response object delivered was the local cache object. |
MEM | Additional tag indicating the response object came from memory cache, avoiding disk accesses. Only seen on HIT responses. |
MISS | The response object delivered was the network response object. |
DENIED | The request was denied by access controls. |
NOFETCH | A ICP specific type. Indicating service is alive, but not to be used for this request. Sent during “-Y” startup, or during frequent failures, a cache in hit only mode will return either UDP_HIT or UDP_MISS_NOFETCH. Neighbours will thus only fetch hits. |
TUNNEL | A binary tunnel was established for this transaction. Only on Squid-3.5+ |
These tags are optional and describe some error conditions which occured during response delivery (if any):
ABORTED | The response was not completed due to the connection being aborted (usually by the client). |
TIMEOUT | The response was not completed due to a connection timeout. |
IGNORED | While refreshing a previously cached response A, Squid got a response B that was older than A (as determined by the Date header field). Squid ignored response B (and attempted to use A instead). This “ignore older responses” logic complies with RFC 7234 Section 4 requirement: a cache MUST use the most recent response (as determined by the Date header field). |
References
pfsense/squid/squid_result_codes.txt · Last modified: 2020/07/15 09:30 by 127.0.0.1