--- libaitwww/inc/aitwww.h 2012/03/10 15:00:45 1.2.2.1 +++ libaitwww/inc/aitwww.h 2012/09/17 13:05:47 1.4.2.5 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitwww.h,v 1.2.2.1 2012/03/10 15:00:45 misho Exp $ +* $Id: aitwww.h,v 1.4.2.5 2012/09/17 13:05:47 misho Exp $ * ************************************************************************** The ELWIX and AITNET software is distributed under the following @@ -50,6 +50,7 @@ SUCH DAMAGE. #include #include #include +#include /* URL staff ... */ @@ -60,17 +61,17 @@ typedef struct _tagURLItem { } url_Item_t; struct tagIOURL { - unsigned char url_line[BUFSIZ]; + ait_val_t url_line; - url_Item_t url_tech; - url_Item_t url_user; - url_Item_t url_pass; - url_Item_t url_host; - url_Item_t url_port; - url_Item_t url_path; - url_Item_t url_args; + ait_val_t url_tech; + ait_val_t url_user; + ait_val_t url_pass; + ait_val_t url_host; + ait_val_t url_port; + ait_val_t url_path; + ait_val_t url_args; - char *url_reserved; + unsigned char *url_reserved; }; struct tagReqXML { @@ -89,8 +90,8 @@ struct tagReqXML { /* CGI variables */ struct tagCGI { - char *cgi_name; - char *cgi_value; + ait_val_t *cgi_name; + ait_val_t *cgi_value; SLIST_ENTRY(tagCGI) cgi_node; }; @@ -133,6 +134,7 @@ cgi_t *www_initCGI(void); * return: none */ void www_closeCGI(cgi_t ** __restrict cgi); +#define www_freeAttributes www_closeCGI /* * www_parseQuery() - Parse CGI query string * @@ -200,23 +202,77 @@ inline int www_header(FILE *output); */ inline cgi_t *www_parseAttributes(const char **ct); /* - * www_freeAttributes() - Free attributes + * www_getAttribute() - Get Attribute from attribute session * - * @attr = Attributes + * @cgi = Inited attribute session + * @name = Name of attribute variable + * return: NULL not found or !=NULL value + */ +inline ait_val_t *www_getAttribute(cgi_t * __restrict cgi, const char *name); + + +/* + * www_cmp() - Compare two string + * + * @ct = content text from www + * @s = string + * return: 0 are equal or !0 are different + */ +int www_cmp(const char *ct, const char *s); +/* + * www_cmptype() - Compare context type + * + * @ct = content text from www + * @type = content type + * return: 0 are equal or !0 are different + */ +int www_cmptype(const char *ct, const char *type); +/* + * www_getpair() - Get AV pair from WWW query string + * + * @str = query string + * @delim = delimiter + * return: NULL error or AV pair, must be io_free() after use! + */ +ait_val_t *www_getpair(char ** __restrict str, const char *delim); +/* + * www_x2c() - Hex from string to digit + * + * @str = string + * return: digit + */ +inline char www_x2c(const char *str); +/* + * www_unescape() - Unescape/decode WWW query string to host string + * + * @str = string * return: none */ -inline void www_freeAttributes(cgi_t ** __restrict attr); +inline void www_unescape(char * __restrict str); /* - * www_getAttribute() - Get attribute by name + * www_undot() - Undotted and clean WWW query filename * - * @attr = Attributes - * @name = Name of attribute - * return: NULL not found or !=NULL attribute value + * @pname = query filename + * return: =NULL error or !=NULL allocated valid filename, after use you must call io_freeVar() */ -inline const char *www_getAttribute(cgi_t * __restrict attr, const char *name); +ait_val_t *www_undot(const char * __restrict pname); /* + * www_URLInit() - Init URL structure and free old one + * + * @url = Input URL + * return: -1 error or 0 ok + */ +inline int www_URLInit(struct tagIOURL * __restrict url); +/* + * www_URLFree() - URL free structure + * + * @url = Input parsed URL + * return: none + */ +inline void www_URLFree(struct tagIOURL * __restrict url); +/* * www_URLGet() - Parse and get data from input URL * * @csURL = Input URL line @@ -224,31 +280,17 @@ inline const char *www_getAttribute(cgi_t * __restrict * return: 0 error format not find tech:// and return URL like path; * -1 error:: can`t read; >0 ok, up bits for known elements */ -int www_URLGet(const char *csURL, struct tagIOURL *url); +int www_URLGet(const char *csURL, struct tagIOURL * __restrict url); /* * www_URLGetFile() - Get file from parsed URL * * @url = Input parsed URL - * @psValue = Return filename, if not specified file in url path, replace with / - * @valLen = Size of psValue array - * return: -1 error:: can`t read; 0 ok + * @value = Return filename, if not specified file in url path, replace with / + * return: -1 error, 0 filename from path, 1 filename or 2 not specified filename */ -int www_URLGetFile(struct tagIOURL *url, char * __restrict psValue, int valLen); +int www_URLGetFile(struct tagIOURL * __restrict url, ait_val_t * __restrict value); /* - * www_Path2File() - Parse and make path/filename pair - * - * @csArgs = Input argument line - * @psPath = Output Path, if ==NULL path not returned - * @pathLen = Size of path array - * @psFile = Output File - * @fileLen = Size of file array - * return: 0 error format; -1 error:: can`t read; >0 ok, number of readed items - */ -inline int www_Path2File(const char * __restrict csArgs, char * __restrict psPath, - int pathLen, char * __restrict psFile, int fileLen); - -/* * www_XMLGet() - Parse and get data from input XML request string * [ns:]container[|attribute[=value]][?data] * @@ -257,6 +299,21 @@ inline int www_Path2File(const char * __restrict csArg * return: 0 error format incorrect, -1 error:: can`t read; >0 ok readed elements bits */ int www_XMLGet(const char *csXML, struct tagReqXML *xml); + +/* + * www_b64encode() - Base64 encode function + * + * @src = source data + * return: NULL error or !=NULL encoded variable, after use call io_freeVar() + */ +ait_val_t *www_b64encode(ait_val_t * __restrict src); +/* + * www_b64decode() - Base64 decode function + * + * @src = source encoded data + * return: NULL error or !=NULL decoded variable, after use call io_freeVar() + */ +ait_val_t *www_b64decode(ait_val_t * __restrict src); #endif