1

#ifndef MEMCACHE_H

     2

#define MEMCACHE_H

     3

     4

/*

     5

 * A libevent based memcached client that aims for high performance, concurrency and low latency.

     6

 */

     7

     8

#include "config.h"

     9

    10

/*

    11

 * Used to store the global information for a memcache context. A context contains both servers and active connections.

    12

 */

    13

struct memcache;

    14

    15

/*

    16

 * A transaction.

    17

 */

    18

struct memcache_req;

    19

    20

/*

    21

 * Keys used

    22

 */

    23

struct memcache_key {

    24

    char *buf;

    25

    size_t len;

    26

};

    27

    28

/*

    29

 * Object attributes

    30

 */

    31

struct memcache_obj {

    32

    unsigned int flags;

    33

    time_t exptime;

    34

    size_t bytes;

    35

    unsigned long long cas;

    36

};

    37

    38

/*

    48

 * Available commands

    49

 */

    50

enum memcache_command {

    82

};

    83

    84

enum memcache_req_state {

    86

    88

};

    89

    90

/*

    91

 * Callback used

    92

 */

    93

typedef int (*memcache_cb) (struct memcache_req *, void*);

    94

    95

/*

    96

 * Allocate a new memcache context for use with other methods.

    97

 */

    98

struct memcache *memcache_alloc (memcache_cb cb_fn);

    99

   100

/*

   101

 * Add a server to the pool of available servers.

   102

 */

   103

int memcache_add_server (struct memcache *mc, struct config_endpoint *endpoint, int max_connections);

   104

   105

/*

   106

 * Attempt to fetch a key from the cache.

   107

 */

   108

struct memcache_req *memcache_fetch (struct memcache *mc, const struct memcache_key *key, void *cb_arg);

   109

   110

/*

   111

 * Attempt to store a key into the cache

   112

 */

   113

struct memcache_req *memcache_store (struct memcache *mc, enum memcache_command cmd, const struct memcache_key *key, const struct memcache_obj *obj, void *cb_arg);

   114

   115

/*

   116

 * Request state

   117

 */ 

   118

enum memcache_req_state memcache_req_state (struct memcache_req *req);

   119

   120

/*

   121

 * Request key

   122

 */

   123

int memcache_req_key (struct memcache_req *req, const struct memcache_key *key);

   124

   125

/*

   126

 * Request data

   127

 */

   128

int memcache_req_obj (struct memcache_req *req, const struct memcache_obj *obj);

   129

   130

#endif /* MEMCACHE_H */