/* Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License.
*/
#define MSEC_ONE_DAY ((apr_time_t)(86400*APR_USEC_PER_SEC)) /* one day, in microseconds */ #define MSEC_ONE_HR ((apr_time_t)(3600*APR_USEC_PER_SEC)) /* one hour, in microseconds */ #define MSEC_ONE_MIN ((apr_time_t)(60*APR_USEC_PER_SEC)) /* one minute, in microseconds */ #define MSEC_ONE_SEC ((apr_time_t)(APR_USEC_PER_SEC)) /* one second, in microseconds */
/* static information about the local cache */ typedefstruct {
apr_array_header_t *cacheenable; /* URLs to cache */
apr_array_header_t *cachedisable; /* URLs not to cache */ /** store the headers that should not be stored in the cache */
apr_array_header_t *ignore_headers; /** store the identifiers that should not be used for key calculation */
apr_array_header_t *ignore_session_id; constchar *lockpath;
apr_time_t lockmaxage;
apr_uri_t *base_uri; /** ignore client's requests for uncached responses */ unsignedint ignorecachecontrol:1; /** ignore query-string when caching */ unsignedint ignorequerystring:1; /** run within the quick handler */ unsignedint quick:1; /* thundering herd lock */ unsignedint lock:1; unsignedint x_cache:1; unsignedint x_cache_detail:1; /* flag if CacheIgnoreHeader has been set */ #define CACHE_IGNORE_HEADERS_SET 1 #define CACHE_IGNORE_HEADERS_UNSET 0 unsignedint ignore_headers_set:1; /* flag if CacheIgnoreURLSessionIdentifiers has been set */ #define CACHE_IGNORE_SESSION_ID_SET 1 #define CACHE_IGNORE_SESSION_ID_UNSET 0 unsignedint ignore_session_id_set:1; unsignedint base_uri_set:1; unsignedint ignorecachecontrol_set:1; unsignedint ignorequerystring_set:1; unsignedint quick_set:1; unsignedint lock_set:1; unsignedint lockpath_set:1; unsignedint lockmaxage_set:1; unsignedint x_cache_set:1; unsignedint x_cache_detail_set:1;
} cache_server_conf;
typedefstruct { /* Minimum time to keep cached files in msecs */
apr_time_t minex; /* Maximum time to keep cached files in msecs */
apr_time_t maxex; /* default time to keep cached file in msecs */
apr_time_t defex; /* factor for estimating expires date */ double factor; /* cache enabled for this location */
apr_array_header_t *cacheenable; /* cache disabled for this location */ unsignedint disable:1; /* set X-Cache headers */ unsignedint x_cache:1; unsignedint x_cache_detail:1; /* serve stale on error */ unsignedint stale_on_error:1; /** ignore the last-modified header when deciding to cache this request */ unsignedint no_last_mod_ignore:1; /** ignore expiration date from server */ unsignedint store_expired:1; /** ignore Cache-Control: private header from server */ unsignedint store_private:1; /** ignore Cache-Control: no-store header from client or server */ unsignedint store_nostore:1; unsignedint minex_set:1; unsignedint maxex_set:1; unsignedint defex_set:1; unsignedint factor_set:1; unsignedint x_cache_set:1; unsignedint x_cache_detail_set:1; unsignedint stale_on_error_set:1; unsignedint no_last_mod_ignore_set:1; unsignedint store_expired_set:1; unsignedint store_private_set:1; unsignedint store_nostore_set:1; unsignedint enable_set:1; unsignedint disable_set:1;
} cache_dir_conf;
/* A linked-list of authn providers. */ typedefstruct cache_provider_list cache_provider_list;
/* per request cache information */ typedefstruct {
cache_provider_list *providers; /* possible cache providers */ const cache_provider *provider; /* current cache provider */ constchar *provider_name; /* current cache provider name */ int fresh; /* is the entity fresh? */
cache_handle_t *handle; /* current cache handle */
cache_handle_t *stale_handle; /* stale cache handle */
apr_table_t *stale_headers; /* original request headers. */ int in_checked; /* CACHE_SAVE must cache the entity */ int block_response; /* CACHE_SAVE must block response. */
apr_bucket_brigade *saved_brigade; /* copy of partial response */
apr_off_t saved_size; /* length of saved_brigade */
apr_time_t exp; /* expiration */
apr_time_t lastmod; /* last-modified time */
cache_info *info; /* current cache info */
ap_filter_t *save_filter; /* Enable us to restore the filter on error */
ap_filter_t *remove_url_filter; /* Enable us to remove the filter */ constchar *key; /* The cache key created for this * request
*/
apr_off_t size; /* the content length from the headers, or -1 */
apr_bucket_brigade *out; /* brigade to reuse for upstream responses */
cache_control_t control_in; /* cache control incoming */
} cache_request_rec;
/** * Check the whether the request allows a cached object to be served as per RFC2616 * section 14.9.4 (Cache Revalidation and Reload Controls) * @param cache cache_request_rec * @param r request_rec * @return 0 ==> cache object may not be served, 1 ==> cache object may be served
*/ int ap_cache_check_no_cache(cache_request_rec *cache, request_rec *r);
/** * Check the whether the request allows a cached object to be stored as per RFC2616 * section 14.9.2 (What May be Stored by Caches) * @param cache cache_request_rec * @param r request_rec * @return 0 ==> cache object may not be served, 1 ==> cache object may be served
*/ int ap_cache_check_no_store(cache_request_rec *cache, request_rec *r);
/** * Check the freshness of the cache object per RFC2616 section 13.2 (Expiration Model) * @param h cache_handle_t * @param cache cache_request_rec * @param r request_rec * @return 0 ==> cache object is stale, 1 ==> cache object is fresh
*/ int cache_check_freshness(cache_handle_t *h, cache_request_rec *cache,
request_rec *r);
/** * Try obtain a cache wide lock on the given cache key. * * If we return APR_SUCCESS, we obtained the lock, and we are clear to * proceed to the backend. If we return APR_EEXISTS, then the lock is * already locked, someone else has gone to refresh the backend data * already, so we must return stale data with a warning in the mean * time. If we return anything else, then something has gone pear * shaped, and we allow the request through to the backend regardless. * * This lock is created from the request pool, meaning that should * something go wrong and the lock isn't deleted on return of the * request headers from the backend for whatever reason, at worst the * lock will be cleaned up when the request is dies or finishes. * * If something goes truly bananas and the lock isn't deleted when the * request dies, the lock will be trashed when its max-age is reached, * or when a request arrives containing a Cache-Control: no-cache. At * no point is it possible for this lock to permanently deny access to * the backend.
*/
apr_status_t cache_try_lock(cache_server_conf *conf, cache_request_rec *cache,
request_rec *r);
/** * Remove the cache lock, if present. * * First, try to close the file handle, whose delete-on-close should * kill the file. Otherwise, just delete the file by name. * * If no lock name has yet been calculated, do the calculation of the * lock name first before trying to delete the file. * * If an optional bucket brigade is passed, the lock will only be * removed if the bucket brigade contains an EOS bucket.
*/
apr_status_t cache_remove_lock(cache_server_conf *conf,
cache_request_rec *cache, request_rec *r, apr_bucket_brigade *bb);
/** * Get a value from a table, where the table may contain multiple * values for a given key. * * When the table contains a single value, that value is returned * unchanged. * * When the table contains two or more values for a key, all values * for the key are returned, separated by commas.
*/ constchar *cache_table_getm(apr_pool_t *p, const apr_table_t *t, constchar *key);
/** * String tokenizer that ignores separator characters within quoted strings * and escaped characters, as per RFC2616 section 2.2.
*/ char *cache_strqtok(char *str, constchar *sep, char **last);
/** * Merge err_headers_out into headers_out and add request's Content-Type and * Content-Encoding if available.
*/
apr_table_t *cache_merge_headers_out(request_rec *r);
/** * Return whether to use request's path/query from early stage (r->parsed_uri) * or the current/rewritable ones (r->uri/r->args).
*/ int cache_use_early_url(request_rec *r);
#ifdef __cplusplus
} #endif
#endif/* !CACHE_UTIL_H */ /** @} */
¤ Dauer der Verarbeitung: 0.29 Sekunden
(vorverarbeitet)
¤
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.
