Re: contrast cache_remove_url() and cache_remove_entity()?

[Eric Covener]

On Fri, Sep 13, 2013 at 12:32 PM, Mike Rumph <mike.ru...@oracle.com> wrote:
> Hello Eric,
>
> Do you mean cache_remove_url() and cache_create_entity()?
>

There is a remove_entity() and a remove_url(). Presumably the latter
removes all possible cached entities for the given URL?

> By "comment the callback structure" are you asking for documentation on how
> these functions are called?

Yes, some doc would be nice as if they were normal API.

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;