X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=server%2Ffastcgi.h;h=aad2421fc8f79699c8335fa5d63af12137ad750a;hb=a304c5e3c9ef6f145b7e30ebc618e03e749cba95;hp=f52a20aafbfebc55a2711dd907268975380dccef;hpb=18027c718bc45eaa191068da1e739eebeb6111e4;p=matches%2FMCTX3420.git diff --git a/server/fastcgi.h b/server/fastcgi.h index f52a20a..aad2421 100644 --- a/server/fastcgi.h +++ b/server/fastcgi.h @@ -16,17 +16,51 @@ typedef enum StatusCodes { STATUS_OK = 1, STATUS_ERROR = -1, - STATUS_UNAUTHORIZED = -2 + STATUS_UNAUTHORIZED = -2, + STATUS_NOTRUNNING = -3, + STATUS_ALREADYEXISTS = -4 } StatusCodes; -typedef struct FCGIContext FCGIContext; +#define FCGI_PARAM_REQUIRED (1 << 0) +#define FCGI_PARAM_RECEIVED (1 << 1) +#define FCGI_BOOL_T (1 << 2) +#define FCGI_INT_T (1 << 3) +#define FCGI_LONG_T (1 << 4) +#define FCGI_DOUBLE_T (1 << 5) +#define FCGI_STRING_T (1 << 6) +#define FCGI_REQUIRED(x) ((x) | FCGI_PARAM_REQUIRED) +#define FCGI_IS_REQUIRED(x) ((x) & FCGI_PARAM_REQUIRED) +#define FCGI_RECEIVED(x) ((x) & FCGI_PARAM_RECEIVED) +#define FCGI_TYPE(x) ((x) & ~(FCGI_PARAM_REQUIRED | FCGI_PARAM_RECEIVED)) + +typedef struct FCGIValue { + const char *key; + void *value; + unsigned flags; +} FCGIValue; + +/**Contextual information related to FCGI requests*/ +typedef struct +{ + /**The time of last valid user access possessing the control key*/ + time_t control_timestamp; + char control_key[41]; + char control_ip[16]; + /**The name of the current module**/ + const char *current_module; + /**For debugging purposes?**/ + int response_number; +} FCGIContext; + typedef void (*ModuleHandler) (FCGIContext *context, char *params); -extern void FCGI_BeginControl(FCGIContext *context, bool force); -extern void FCGI_EndControl(FCGIContext *context); +extern void FCGI_LockControl(FCGIContext *context, bool force); +extern void FCGI_ReleaseControl(FCGIContext *context); extern bool FCGI_HasControl(FCGIContext *context, const char *key); extern char *FCGI_KeyPair(char *in, const char **key, const char **value); +extern bool FCGI_ParseRequest(FCGIContext *context, char *params, FCGIValue values[], size_t count); extern void FCGI_BeginJSON(FCGIContext *context, StatusCodes status_code); +extern void FCGI_AcceptJSON(FCGIContext *context, const char *description, const char *cookie); extern void FCGI_JSONPair(const char *key, const char *value); extern void FCGI_JSONLong(const char *key, long value); extern void FCGI_JSONDouble(const char *key, double value); @@ -35,8 +69,11 @@ extern void FCGI_JSONKey(const char *key); extern void FCGI_PrintRaw(const char *format, ...); extern void FCGI_EndJSON(); extern void FCGI_RejectJSONEx(FCGIContext *context, StatusCodes status, const char *description); +extern char *FCGI_EscapeText(char *buf); extern void *FCGI_RequestLoop (void *data); +extern void FCGI_WriteBinary(void * data, size_t size, size_t num_elem); + /** * Shortcut to calling FCGI_RejectJSONEx. Sets the error code * to STATUS_ERROR.