?HAMA

Navigation

Breadcrumbs

/ / usr / include / apache2

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 7.09 KB

//usr/include/apache2/mod_cache.h

Text Base64

/* 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.
 */

/**
 * @file mod_cache.h
 * @brief Main include file for the Apache Transparent Cache
 *
 * @defgroup MOD_CACHE mod_cache
 * @ingroup  APACHE_MODS
 * @{
 */

#ifndef MOD_CACHE_H
#define MOD_CACHE_H

#include "httpd.h"
#include "apr_date.h"
#include "apr_optional.h"
#include "apr_hooks.h"

#include "cache_common.h"

/* Create a set of CACHE_DECLARE(type), CACHE_DECLARE_NONSTD(type) and
 * CACHE_DECLARE_DATA with appropriate export and import tags for the platform
 */
#if !defined(WIN32)
#define CACHE_DECLARE(type)            type
#define CACHE_DECLARE_NONSTD(type)     type
#define CACHE_DECLARE_DATA
#elif defined(CACHE_DECLARE_STATIC)
#define CACHE_DECLARE(type)            type __stdcall
#define CACHE_DECLARE_NONSTD(type)     type
#define CACHE_DECLARE_DATA
#elif defined(CACHE_DECLARE_EXPORT)
#define CACHE_DECLARE(type)            __declspec(dllexport) type __stdcall
#define CACHE_DECLARE_NONSTD(type)     __declspec(dllexport) type
#define CACHE_DECLARE_DATA             __declspec(dllexport)
#else
#define CACHE_DECLARE(type)            __declspec(dllimport) type __stdcall
#define CACHE_DECLARE_NONSTD(type)     __declspec(dllimport) type
#define CACHE_DECLARE_DATA             __declspec(dllimport)
#endif

/* cache info information */
typedef struct cache_info cache_info;
struct cache_info {
    /**
     * the original time corresponding to the 'Date:' header of the request
     * served
     */
    apr_time_t date;
    /** a time when the cached entity is due to expire */
    apr_time_t expire;
    /** r->request_time from the same request */
    apr_time_t request_time;
    /** apr_time_now() at the time the entity was actually cached */
    apr_time_t response_time;
    /**
     * HTTP status code of the cached entity. Though not necessarily the
     * status code finally issued to the request.
     */
    int status;
    /* cached cache-control */
    cache_control_t control;
};

/* cache handle information */
typedef struct cache_object cache_object_t;
struct cache_object {
    const char *key;
    cache_object_t *next;
    cache_info info;
    /* Opaque portion (specific to the implementation) of the cache object */
    void *vobj;
};

typedef struct cache_handle cache_handle_t;
struct cache_handle {
    cache_object_t *cache_obj;
    apr_table_t *req_hdrs;        /* cached request headers */
    apr_table_t *resp_hdrs;       /* cached response headers */
};

#define CACHE_PROVIDER_GROUP "cache"

typedef struct {
    int (*remove_entity) (cache_handle_t *h);
    apr_status_t (*store_headers)(cache_handle_t *h, request_rec *r, cache_info *i);
    apr_status_t (*store_body)(cache_handle_t *h, request_rec *r, apr_bucket_brigade *in,
                           apr_bucket_brigade *out);
    apr_status_t (*recall_headers) (cache_handle_t *h, request_rec *r);
    apr_status_t (*recall_body) (cache_handle_t *h, apr_pool_t *p, apr_bucket_brigade *bb);
    int (*create_entity) (cache_handle_t *h, request_rec *r,
                           const char *urlkey, apr_off_t len, apr_bucket_brigade *bb);
    int (*open_entity) (cache_handle_t *h, request_rec *r,
                           const char *urlkey);
    int (*remove_url) (cache_handle_t *h, request_rec *r);
    apr_status_t (*commit_entity)(cache_handle_t *h, request_rec *r);
    apr_status_t (*invalidate_entity)(cache_handle_t *h, request_rec *r);
} cache_provider;

typedef enum {
    AP_CACHE_HIT,
    AP_CACHE_REVALIDATE,
    AP_CACHE_MISS,
    AP_CACHE_INVALIDATE
} ap_cache_status_e;

#define AP_CACHE_HIT_ENV "cache-hit"
#define AP_CACHE_REVALIDATE_ENV "cache-revalidate"
#define AP_CACHE_MISS_ENV "cache-miss"
#define AP_CACHE_INVALIDATE_ENV "cache-invalidate"
#define AP_CACHE_STATUS_ENV "cache-status"

/* cache_util.c */
/* do a HTTP/1.1 age calculation */
CACHE_DECLARE(apr_time_t) ap_cache_current_age(cache_info *info, const apr_time_t age_value,
                                               apr_time_t now);

CACHE_DECLARE(apr_time_t) ap_cache_hex2usec(const char *x);
CACHE_DECLARE(void) ap_cache_usec2hex(apr_time_t j, char *y);
CACHE_DECLARE(char *) ap_cache_generate_name(apr_pool_t *p, int dirlevels,
                                             int dirlength,
                                             const char *name);
CACHE_DECLARE(const char *)ap_cache_tokstr(apr_pool_t *p, const char *list, const char **str);

/* Create a new table consisting of those elements from an
 * headers table that are allowed to be stored in a cache.
 */
CACHE_DECLARE(apr_table_t *)ap_cache_cacheable_headers(apr_pool_t *pool,
                                                        apr_table_t *t,
                                                        server_rec *s);

/* Create a new table consisting of those elements from an input
 * headers table that are allowed to be stored in a cache.
 */
CACHE_DECLARE(apr_table_t *)ap_cache_cacheable_headers_in(request_rec *r);

/* Create a new table consisting of those elements from an output
 * headers table that are allowed to be stored in a cache;
 * ensure there is a content type and capture any errors.
 */
CACHE_DECLARE(apr_table_t *)ap_cache_cacheable_headers_out(request_rec *r);

/**
 * Parse the Cache-Control and Pragma headers in one go, marking
 * which tokens appear within the header. Populate the structure
 * passed in.
 */
int ap_cache_control(request_rec *r, cache_control_t *cc, const char *cc_header,
        const char *pragma_header, apr_table_t *headers);

/* hooks */

/**
 * Cache status hook.
 * This hook is called as soon as the cache has made a decision as to whether
 * an entity should be served from cache (hit), should be served from cache
 * after a successful validation (revalidate), or served from the backend
 * and potentially cached (miss).
 *
 * A basic implementation of this hook exists in mod_cache which writes this
 * information to the subprocess environment, and optionally to request
 * headers. Further implementations may add hooks as appropriate to perform
 * more advanced processing, or to store statistics about the cache behaviour.
 */
APR_DECLARE_EXTERNAL_HOOK(cache, CACHE, int, cache_status, (cache_handle_t *h,
                request_rec *r, apr_table_t *headers, ap_cache_status_e status,
                const char *reason))

APR_DECLARE_OPTIONAL_FN(apr_status_t,
                        ap_cache_generate_key,
                        (request_rec *r, apr_pool_t*p, const char **key));

#endif /*MOD_CACHE_H*/
/** @} */

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 0 × Files: 66

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
.mmn	14 B	lrw-r--r--	2026-01-27 02:08:10	Edit Download recursive recursive
apache_noprobes.h	15.59 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_compat.h	1.05 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config.h	6.45 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config_auto.h	9.90 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_config_layout.h	2.52 KB	lrw-r--r--	2026-01-27 02:08:11	Edit Download recursive recursive
ap_expr.h	13.75 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_hooks.h	5.85 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_listen.h	6.19 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_mmn.h	39.53 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_mpm.h	10.51 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_provider.h	3.45 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_regex.h	11.14 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_regkey.h	8.97 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_release.h	3.07 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_slotmem.h	7.07 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
ap_socache.h	9.18 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
cache_common.h	1.97 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
heartbeat.h	1.56 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
httpd.h	95.02 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_config.h	56.37 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
http_connection.h	6.97 KB	lrw-r--r--	2026-01-27 02:08:07	Edit Download recursive recursive
http_core.h	36.40 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_log.h	36.01 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_main.h	3.17 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_protocol.h	41.41 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_request.h	25.72 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_ssl.h	14.62 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
http_vhost.h	4.49 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_auth.h	4.42 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_cache.h	7.09 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_cgi.h	2.44 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_core.h	3.33 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_dav.h	97.85 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_dbd.h	4.06 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_http2.h	4.59 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_include.h	3.89 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_log_config.h	2.43 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_proxy.h	65.80 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_request.h	1.59 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
mod_rewrite.h	1.36 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_session.h	6.61 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_so.h	1.20 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_ssl.h	4.87 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_ssl_openssl.h	4.80 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_status.h	2.38 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_unixd.h	1.09 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_watchdog.h	7.34 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mod_xml2enc.h	2.25 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
mpm_common.h	17.09 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
os.h	1.63 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
scoreboard.h	9.94 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
unixd.h	4.14 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive
util_cfgtree.h	3.08 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_charset.h	2.21 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_cookies.h	4.84 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_ebcdic.h	2.69 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_fcgi.h	9.75 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_filter.h	25.84 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_ldap.h	17.94 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_md5.h	2.12 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_mutex.h	9.07 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_script.h	9.63 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_time.h	4.10 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_varbuf.h	8.09 KB	lrw-r--r--	2026-01-27 02:08:08	Edit Download recursive recursive
util_xml.h	1.31 KB	lrw-r--r--	2026-01-27 02:08:09	Edit Download recursive recursive