24#if defined(APR_BUCKET_DEBUG) && !defined(APR_RING_DEBUG)
54#define APR_BUCKET_BUFF_SIZE 8000
59#define APR_BUCKETS_STRING -1
294#ifdef APR_BUCKET_DEBUG
296#define APR_BRIGADE_CHECK_CONSISTENCY(b) do { \
297 APR_RING_CHECK_CONSISTENCY(&(b)->list, apr_bucket, link); \
298 assert(b->p != NULL); \
299 assert(b->bucket_alloc != NULL); \
302#define APR_BUCKET_CHECK_CONSISTENCY(e) \
303 APR_RING_CHECK_ELEM_CONSISTENCY((e), apr_bucket, link)
312#define APR_BRIGADE_CHECK_CONSISTENCY(b)
319#define APR_BUCKET_CHECK_CONSISTENCY(e)
339#define APR_BRIGADE_SENTINEL(b) APR_RING_SENTINEL(&(b)->list, apr_bucket, link)
346#define APR_BRIGADE_EMPTY(b) APR_RING_EMPTY(&(b)->list, apr_bucket, link)
353#define APR_BRIGADE_FIRST(b) APR_RING_FIRST(&(b)->list)
359#define APR_BRIGADE_LAST(b) APR_RING_LAST(&(b)->list)
366#define APR_BRIGADE_INSERT_HEAD(b, e) do { \
367 apr_bucket *ap__b = (e); \
368 APR_RING_INSERT_HEAD(&(b)->list, ap__b, apr_bucket, link); \
369 APR_BRIGADE_CHECK_CONSISTENCY((b)); \
377#define APR_BRIGADE_INSERT_TAIL(b, e) do { \
378 apr_bucket *ap__b = (e); \
379 APR_RING_INSERT_TAIL(&(b)->list, ap__b, apr_bucket, link); \
380 APR_BRIGADE_CHECK_CONSISTENCY((b)); \
388#define APR_BRIGADE_CONCAT(a, b) do { \
389 APR_RING_CONCAT(&(a)->list, &(b)->list, apr_bucket, link); \
390 APR_BRIGADE_CHECK_CONSISTENCY((a)); \
398#define APR_BRIGADE_PREPEND(a, b) do { \
399 APR_RING_PREPEND(&(a)->list, &(b)->list, apr_bucket, link); \
400 APR_BRIGADE_CHECK_CONSISTENCY((a)); \
408#define APR_BUCKET_INSERT_BEFORE(a, b) do { \
409 apr_bucket *ap__a = (a), *ap__b = (b); \
410 APR_RING_INSERT_BEFORE(ap__a, ap__b, link); \
411 APR_BUCKET_CHECK_CONSISTENCY(ap__a); \
419#define APR_BUCKET_INSERT_AFTER(a, b) do { \
420 apr_bucket *ap__a = (a), *ap__b = (b); \
421 APR_RING_INSERT_AFTER(ap__a, ap__b, link); \
422 APR_BUCKET_CHECK_CONSISTENCY(ap__a); \
430#define APR_BUCKET_NEXT(e) APR_RING_NEXT((e), link)
436#define APR_BUCKET_PREV(e) APR_RING_PREV((e), link)
442#define APR_BUCKET_REMOVE(e) APR_RING_REMOVE((e), link)
448#define APR_BUCKET_INIT(e) APR_RING_ELEM_INIT((e), link)
456#define APR_BUCKET_IS_METADATA(e) ((e)->type->is_metadata)
463#define APR_BUCKET_IS_FLUSH(e) ((e)->type == &apr_bucket_type_flush)
469#define APR_BUCKET_IS_EOS(e) ((e)->type == &apr_bucket_type_eos)
475#define APR_BUCKET_IS_FILE(e) ((e)->type == &apr_bucket_type_file)
481#define APR_BUCKET_IS_PIPE(e) ((e)->type == &apr_bucket_type_pipe)
487#define APR_BUCKET_IS_SOCKET(e) ((e)->type == &apr_bucket_type_socket)
493#define APR_BUCKET_IS_HEAP(e) ((e)->type == &apr_bucket_type_heap)
499#define APR_BUCKET_IS_TRANSIENT(e) ((e)->type == &apr_bucket_type_transient)
505#define APR_BUCKET_IS_IMMORTAL(e) ((e)->type == &apr_bucket_type_immortal)
512#define APR_BUCKET_IS_MMAP(e) ((e)->type == &apr_bucket_type_mmap)
519#define APR_BUCKET_IS_POOL(e) ((e)->type == &apr_bucket_type_pool)
658#define APR_BUCKET_ALLOC_SIZE APR_ALIGN_DEFAULT(2*sizeof(apr_bucket_structs))
670 __attribute__((nonnull(1,2)));
678 __attribute__((nonnull(1)));
692 __attribute__((nonnull(1)));
712 __attribute__((nonnull(1,2)));
727 __attribute__((nonnull(1,2)));
744 __attribute__((nonnull(1,3)));
757 __attribute__((nonnull(1,3)));
769 __attribute__((nonnull(1,2,3)));
782 __attribute__((nonnull(1,2,3,4)));
796 __attribute__((nonnull(1,2)));
825 const char *boundary,
826 apr_size_t boundary_len,
828 __attribute__((nonnull(1,2)));
840 struct iovec *vec,
int *nvec)
841 __attribute__((nonnull(1,2,3)));
855 __attribute__((nonnull(1)));
882 const char *str, apr_size_t nbyte)
883 __attribute__((nonnull(1,4)));
897 const struct iovec *vec,
899 __attribute__((nonnull(1,4)));
912 __attribute__((nonnull(1,4)));
925 __attribute__((nonnull(1)));
938#if defined(__GNUC__) && __GNUC__ >= 4
939 __attribute__((sentinel))
941 __attribute__((nonnull(1)))
957 const char *fmt, ...)
958 __attribute__((format(printf,4,5)))
959 __attribute__((nonnull(1)));
974 const
char *fmt, va_list va)
975 __attribute__((nonnull(1,4)));
994 __attribute__((nonnull(1,2,5)));
1024 __attribute__((nonnull(1)));
1031 __attribute__((nonnull(1)));
1043 __attribute__((nonnull(1)));
1052 __attribute__((nonnull(2)));
1059 __attribute__((nonnull(1)));
1069#define apr_bucket_destroy(e) do { \
1070 apr_bucket *apr__d = (e); \
1071 apr__d->type->destroy(apr__d->data); \
1072 apr__d->free(apr__d); \
1086#define apr_bucket_delete(e) do { \
1087 apr_bucket *apr__b = (e); \
1088 APR_BUCKET_REMOVE(apr__b); \
1089 apr_bucket_destroy(apr__b); \
1159#define apr_bucket_read(e,str,len,block) (e)->type->read(e, str, len, block)
1167#define apr_bucket_setaside(e,p) (e)->type->setaside(e,p)
1179#define apr_bucket_split(e,point) (e)->type->split(e, point)
1186#define apr_bucket_copy(e,c) (e)->type->copy(e, c)
1423 __attribute__((nonnull(1)));
1433 __attribute__((nonnull(1)));
1443 __attribute__((nonnull(1)));
1455 __attribute__((nonnull(1,3)));
1467 __attribute__((nonnull(1,2)));
1479 __attribute__((nonnull(1,3)));
1491 __attribute__((nonnull(1,2)));
1509 void (*free_func)(
void *data),
1511 __attribute__((nonnull(1,4)));
1523 void (*free_func)(
void *data))
1524 __attribute__((nonnull(1,2)));
1539 __attribute__((nonnull(1,3,4)));
1552 __attribute__((nonnull(1,2,4)));
1568 __attribute__((nonnull(1,4)));
1582 __attribute__((nonnull(1,2)));
1593 __attribute__((nonnull(1,2)));
1602 __attribute__((nonnull(1,2)));
1612 __attribute__((nonnull(1,2)));
1622 __attribute__((nonnull(1,2)));
1645 __attribute__((nonnull(1,4,5)));
1660 __attribute__((nonnull(1,2,5)));
1670 __attribute__((nonnull(1)));
APR Platform Definitions.
APR Miscellaneous library routines.
apr_bucket * apr_bucket_eos_make(apr_bucket *b)
void apr_bucket_destroy_noop(void *data)
apr_status_t apr_bucket_simple_copy(apr_bucket *a, apr_bucket **b)
apr_bucket * apr_bucket_pool_make(apr_bucket *b, const char *buf, apr_size_t length, apr_pool_t *pool)
const apr_bucket_type_t apr_bucket_type_transient
apr_bucket * apr_bucket_socket_make(apr_bucket *b, apr_socket_t *thissock)
apr_status_t apr_brigade_putstrs(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx,...)
apr_bucket * apr_bucket_flush_make(apr_bucket *b)
apr_bucket * apr_bucket_socket_create(apr_socket_t *thissock, apr_bucket_alloc_t *list)
apr_bucket * apr_brigade_insert_file(apr_bucket_brigade *bb, apr_file_t *f, apr_off_t start, apr_off_t len, apr_pool_t *p)
apr_status_t apr_brigade_split_line(apr_bucket_brigade *bbOut, apr_bucket_brigade *bbIn, apr_read_type_e block, apr_off_t maxbytes)
apr_bucket * apr_bucket_pipe_create(apr_file_t *thispipe, apr_bucket_alloc_t *list)
apr_bucket * apr_bucket_heap_create(const char *buf, apr_size_t nbyte, void(*free_func)(void *data), apr_bucket_alloc_t *list)
const apr_bucket_type_t apr_bucket_type_heap
apr_bucket * apr_bucket_immortal_make(apr_bucket *b, const char *buf, apr_size_t nbyte)
apr_status_t apr_brigade_puts(apr_bucket_brigade *bb, apr_brigade_flush flush, void *ctx, const char *str)
apr_status_t apr_bucket_shared_copy(apr_bucket *a, apr_bucket **b)
apr_status_t apr_brigade_destroy(apr_bucket_brigade *b)
apr_status_t apr_brigade_flatten(apr_bucket_brigade *bb, char *c, apr_size_t *len)
apr_status_t apr_bucket_split_notimpl(apr_bucket *data, apr_size_t point)
const apr_bucket_type_t apr_bucket_type_pipe
apr_status_t apr_brigade_putc(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, const char c)
apr_status_t apr_brigade_vputstrs(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, va_list va)
const apr_bucket_type_t apr_bucket_type_immortal
apr_bucket_brigade * apr_brigade_split(apr_bucket_brigade *b, apr_bucket *e)
apr_bucket * apr_bucket_transient_make(apr_bucket *b, const char *buf, apr_size_t nbyte)
apr_bucket * apr_bucket_mmap_create(apr_mmap_t *mm, apr_off_t start, apr_size_t length, apr_bucket_alloc_t *list)
apr_status_t apr_brigade_printf(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, const char *fmt,...)
int apr_bucket_shared_destroy(void *data)
apr_bucket * apr_bucket_heap_make(apr_bucket *b, const char *buf, apr_size_t nbyte, void(*free_func)(void *data))
apr_status_t apr_brigade_partition(apr_bucket_brigade *b, apr_off_t point, apr_bucket **after_point)
apr_bucket * apr_bucket_flush_create(apr_bucket_alloc_t *list)
apr_status_t apr_brigade_split_boundary(apr_bucket_brigade *bbOut, apr_bucket_brigade *bbIn, apr_read_type_e block, const char *boundary, apr_size_t boundary_len, apr_off_t maxbytes)
const apr_bucket_type_t apr_bucket_type_file
apr_bucket * apr_bucket_pipe_make(apr_bucket *b, apr_file_t *thispipe)
apr_status_t apr_bucket_copy_notimpl(apr_bucket *e, apr_bucket **c)
apr_bucket * apr_bucket_shared_make(apr_bucket *b, void *data, apr_off_t start, apr_size_t length)
const apr_bucket_type_t apr_bucket_type_mmap
apr_status_t apr_brigade_length(apr_bucket_brigade *bb, int read_all, apr_off_t *length)
apr_status_t apr_brigade_write(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, const char *str, apr_size_t nbyte)
apr_read_type_e
Definition apr_buckets.h:62
apr_bucket_alloc_t * apr_bucket_alloc_create(apr_pool_t *p)
apr_bucket * apr_bucket_mmap_make(apr_bucket *b, apr_mmap_t *mm, apr_off_t start, apr_size_t length)
apr_bucket * apr_bucket_file_make(apr_bucket *b, apr_file_t *fd, apr_off_t offset, apr_size_t len, apr_pool_t *p)
apr_bucket_brigade * apr_brigade_create(apr_pool_t *p, apr_bucket_alloc_t *list)
const apr_bucket_type_t apr_bucket_type_eos
apr_status_t apr_bucket_shared_split(apr_bucket *b, apr_size_t point)
const apr_bucket_type_t apr_bucket_type_pool
apr_bucket_brigade * apr_brigade_split_ex(apr_bucket_brigade *b, apr_bucket *e, apr_bucket_brigade *a)
void * apr_bucket_alloc(apr_size_t size, apr_bucket_alloc_t *list)
apr_status_t apr_brigade_to_iovec(apr_bucket_brigade *b, struct iovec *vec, int *nvec)
void apr_bucket_free(void *block)
struct apr_bucket_alloc_t apr_bucket_alloc_t
Definition apr_buckets.h:128
apr_status_t apr_brigade_vprintf(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, const char *fmt, va_list va)
apr_status_t apr_bucket_simple_split(apr_bucket *b, apr_size_t point)
apr_status_t apr_brigade_pflatten(apr_bucket_brigade *bb, char **c, apr_size_t *len, apr_pool_t *pool)
const apr_bucket_type_t apr_bucket_type_socket
apr_status_t apr_bucket_file_set_buf_size(apr_bucket *b, apr_size_t size)
apr_size_t apr_bucket_alloc_aligned_floor(apr_bucket_alloc_t *list, apr_size_t size)
apr_status_t apr_bucket_file_enable_mmap(apr_bucket *b, int enabled)
apr_bucket * apr_bucket_eos_create(apr_bucket_alloc_t *list)
apr_bucket * apr_bucket_file_create(apr_file_t *fd, apr_off_t offset, apr_size_t len, apr_pool_t *p, apr_bucket_alloc_t *list)
apr_bucket * apr_bucket_pool_create(const char *buf, apr_size_t length, apr_pool_t *pool, apr_bucket_alloc_t *list)
apr_bucket * apr_bucket_immortal_create(const char *buf, apr_size_t nbyte, apr_bucket_alloc_t *list)
apr_status_t apr_bucket_setaside_notimpl(apr_bucket *data, apr_pool_t *pool)
apr_bucket_alloc_t * apr_bucket_alloc_create_ex(apr_allocator_t *allocator)
apr_status_t apr_bucket_setaside_noop(apr_bucket *data, apr_pool_t *pool)
const apr_bucket_type_t apr_bucket_type_flush
void apr_bucket_alloc_destroy(apr_bucket_alloc_t *list)
apr_bucket * apr_bucket_transient_create(const char *buf, apr_size_t nbyte, apr_bucket_alloc_t *list)
apr_status_t(* apr_brigade_flush)(apr_bucket_brigade *bb, void *ctx)
Definition apr_buckets.h:287
apr_status_t apr_brigade_writev(apr_bucket_brigade *b, apr_brigade_flush flush, void *ctx, const struct iovec *vec, apr_size_t nvec)
apr_status_t apr_brigade_cleanup(void *data)
@ APR_BLOCK_READ
Definition apr_buckets.h:63
@ APR_NONBLOCK_READ
Definition apr_buckets.h:64
struct apr_allocator_t apr_allocator_t
Definition apr_allocator.h:41
int apr_status_t
Definition apr_errno.h:44
struct apr_file_t apr_file_t
Definition apr_file_io.h:195
struct apr_socket_t apr_socket_t
Definition apr_network_io.h:219
struct apr_pool_t apr_pool_t
Definition apr_pools.h:60
Definition apr_buckets.h:263
APR_RING_HEAD(apr_bucket_list, apr_bucket) list
apr_pool_t * p
Definition apr_buckets.h:269
apr_bucket_alloc_t * bucket_alloc
Definition apr_buckets.h:280
Definition apr_buckets.h:620
apr_pool_t * readpool
Definition apr_buckets.h:632
int can_mmap
Definition apr_buckets.h:626
apr_size_t read_size
Definition apr_buckets.h:634
apr_file_t * fd
Definition apr_buckets.h:629
apr_bucket_refcount refcount
Definition apr_buckets.h:622
Definition apr_buckets.h:551
apr_bucket_refcount refcount
Definition apr_buckets.h:553
char * base
Definition apr_buckets.h:557
void(* free_func)(void *data)
Definition apr_buckets.h:561
apr_size_t alloc_len
Definition apr_buckets.h:559
Definition apr_buckets.h:607
apr_mmap_t * mmap
Definition apr_buckets.h:611
apr_bucket_refcount refcount
Definition apr_buckets.h:609
Definition apr_buckets.h:569
apr_bucket_heap heap
Definition apr_buckets.h:581
apr_bucket_alloc_t * list
Definition apr_buckets.h:598
const char * base
Definition apr_buckets.h:587
apr_pool_t * pool
Definition apr_buckets.h:594
Definition apr_buckets.h:539
int refcount
Definition apr_buckets.h:541
Definition apr_buckets.h:136
@ APR_BUCKET_DATA
Definition apr_buckets.h:158
@ APR_BUCKET_METADATA
Definition apr_buckets.h:160
apr_status_t(* split)(apr_bucket *e, apr_size_t point)
Definition apr_buckets.h:208
apr_status_t(* copy)(apr_bucket *e, apr_bucket **c)
Definition apr_buckets.h:216
apr_status_t(* read)(apr_bucket *b, const char **str, apr_size_t *len, apr_read_type_e block)
Definition apr_buckets.h:181
enum apr_bucket_type_t::@0 is_metadata
const char * name
Definition apr_buckets.h:140
int num_func
Definition apr_buckets.h:145
apr_status_t(* setaside)(apr_bucket *e, apr_pool_t *pool)
Definition apr_buckets.h:197
void(* destroy)(void *data)
Definition apr_buckets.h:169
Definition apr_buckets.h:229
apr_size_t length
Definition apr_buckets.h:239
void(* free)(void *e)
Definition apr_buckets.h:257
apr_off_t start
Definition apr_buckets.h:247
apr_bucket_alloc_t * list
Definition apr_buckets.h:259
void * data
Definition apr_buckets.h:249
APR_RING_ENTRY(apr_bucket) link
const apr_bucket_type_t * type
Definition apr_buckets.h:233
Definition apr_buckets.h:643
apr_bucket_heap heap
Definition apr_buckets.h:645
apr_bucket_mmap mmap
Definition apr_buckets.h:648
apr_bucket b
Definition apr_buckets.h:644
apr_bucket_file file
Definition apr_buckets.h:650
apr_bucket_pool pool
Definition apr_buckets.h:646