libicap.h

#ifndef LIBICAP_H_
#define LIBICAP_H_

#include <stdint.h>

#ifdef _cplusplus
extern "C" {
#endif

#define IC_CODE_CONTINUE    100
#define IC_CODE_OK          200
#define IC_CODE_NO_CONTENT  204
#define IC_CODE_BAD_REQUEST 400
#define IC_CODE_NOT_FOUND   404
#define IC_CODE_REQ_TIMEOUT 408

typedef struct ic_query {
    void *data;
} ic_query_t;

typedef enum ic_ctx_type {
    IC_CTX_TYPE_CLOSE = 1, /* objects arriving using a TCP close              */
    IC_CTX_TYPE_CHUNKED,   /* objects arriving using chunked encoding         */
    IC_CTX_TYPE_CL,        /* objects arriving using "Content-Length" headers */
} ic_ctx_type_t;

int ic_query_init(ic_query_t *q);
int ic_connect(ic_query_t *q, const char *srv, uint16_t port);
int ic_get_options(ic_query_t *q, const char *service);

/** @return 0 if got respond, 1 if not all chunk data was send, < 0 if error */
int ic_send_respmod(ic_query_t *q);
int ic_send_reqmod(ic_query_t *q);

int ic_set_service(ic_query_t *q, const char *service);
int ic_set_req_hdr(ic_query_t *q, const unsigned char *hdr, size_t len, ic_ctx_type_t *type);
int ic_set_res_hdr(ic_query_t *q, const unsigned char *hdr, size_t len, ic_ctx_type_t *type);
int ic_allow_204(ic_query_t *q);
int ic_set_preview_len(ic_query_t *q, size_t len); /* defaults: 4096 */
int ic_set_stream_ended(ic_query_t *q);

/* body will not be copyed, do not free it before using ic_send_(resp|req)mod() */
int ic_set_body(ic_query_t *q, const unsigned char *body, size_t len);

int ic_reuse_connection(ic_query_t *q, int proceed);
void ic_disconnect(ic_query_t *q);
void ic_query_deinit(ic_query_t *q);

const char *ic_strerror(int err);
int ic_enable_debug(ic_query_t *q, const char *path);

int ic_get_status_code(ic_query_t *q);
const char *ic_get_icap_hdr(ic_query_t *q);
const char *ic_get_req_hdr(ic_query_t *q);
const char *ic_get_resp_hdr(ic_query_t *q);
/** @return -1 if ERROR */
int ic_get_content_len(ic_query_t *q, uint64_t *len);
/** @return NULL if ERROR */
const char *ic_get_content(ic_query_t *q, size_t *len, int *err);

#ifdef _cplusplus
}
#endif

#endif