extension.h

/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
#ifndef MEMCACHED_EXTENSION_H
#define MEMCACHED_EXTENSION_H

#include <memcached/types.h>
#include <memcached/server_api.h>

#ifdef __cplusplus
extern "C" {
#endif

    typedef enum {
        EXTENSION_SUCCESS     = 0x00,
        EXTENSION_FATAL       = 0xfe,
        EXTENSION_FAILED      = 0xff
    } EXTENSION_ERROR_CODE;

    typedef enum {
        EXTENSION_DAEMON = 0x00,
        EXTENSION_LOGGER,
        EXTENSION_ASCII_PROTOCOL
    } extension_type_t;

    typedef struct extension_daemon_descriptor {
        const char* (*get_name)(void);

        struct extension_daemon_descriptor *next;
    } EXTENSION_DAEMON_DESCRIPTOR;

    typedef enum {
        EXTENSION_LOG_DETAIL,
        EXTENSION_LOG_DEBUG,
        EXTENSION_LOG_INFO,
        EXTENSION_LOG_WARNING
    } EXTENSION_LOG_LEVEL;

    typedef struct {
        const char* (*get_name)(void);

        void (*log)(EXTENSION_LOG_LEVEL severity,
                    const void* client_cookie,
                    const char *fmt, ...);
    } EXTENSION_LOGGER_DESCRIPTOR;

    typedef struct {
        EXTENSION_LOGGER_DESCRIPTOR* (*get_logger)(void);
        EXTENSION_LOG_LEVEL (*get_level)(void);
        void (*set_level)(EXTENSION_LOG_LEVEL severity);
    } SERVER_LOG_API;

    typedef struct {
        char *value;
        size_t length;
    } token_t;

    typedef struct extension_ascii_protocol_descriptor {
        const char* (*get_name)(const void *cmd_cookie);

        bool (*accept)(const void *cmd_cookie,
                       void *cookie,
                       int argc,
                       token_t *argv,
                       size_t *ndata,
                       char **ptr);

        ENGINE_ERROR_CODE (*execute)(const void *cmd_cookie,
                                     const void *cookie,
                                     int argc, token_t *argv,
                                     ENGINE_ERROR_CODE (*response_handler)(const void *cookie,
                                                                           int nbytes,
                                                                           const char *dta));

        void (*abort)(const void *cmd_cookie, const void *cookie);

        const void *cookie;

        struct extension_ascii_protocol_descriptor *next;
    } EXTENSION_ASCII_PROTOCOL_DESCRIPTOR;

    typedef EXTENSION_ERROR_CODE (*MEMCACHED_EXTENSIONS_INITIALIZE)(const char *config, GET_SERVER_API get_server_api);


    typedef struct {
        bool (*register_extension)(extension_type_t type, void *extension);

        void (*unregister_extension)(extension_type_t type, void *extension);

        void *(*get_extension)(extension_type_t type);
    } SERVER_EXTENSION_API;

#ifdef __cplusplus
}
#endif

#endif