memcache/request.h
author Tero Marttila <terom@fixme.fi>
Wed, 27 Aug 2008 10:11:44 +0300
changeset 39 0e21a65074a6
parent 38 9894df13b779
child 41 540737bf6bac
permissions -rw-r--r--
memcache connect error handling and req queuein
#ifndef MEMCACHE_REQ_H
#define MEMCACHE_REQ_H

#include <sys/queue.h>

#include "../memcache.h"
#include "connection.h"

struct memcache_req {
    // the memcache context that we belong to
    struct memcache *mc;

    // our key/obj
    struct memcache_key key;
    struct memcache_obj *obj;

    // our state
    enum memcache_req_state state;

    // our user callback argument
    void *cb_arg;

    // the conn 
    struct memcache_connection *conn;
    
    // we are a member of struct memcache_server.req_queue
    TAILQ_ENTRY(memcache_req) reqqueue_node;
};

/*
 * Allocate and return a new req, or NULL if unsuccesfull.
 */
struct memcache_req *memcache_req_alloc (struct memcache *mc, struct memcache_key *key, void *cb_arg);


/*
 * An error occurred, and the request must be abandoned. This will assume that the req is not active or enqueued
 * anymore, and the req should not be accessed by memcache_* code after this.
 */
void memcache_req_error (struct memcache_req *req);

/*
 * Free an unused req. Should always be called by the user, not via internal means.
 */
void memcache_req_free (struct memcache_req *req);

#endif /* MEMCACHE_REQ_H */