diff options
Diffstat (limited to 'frontends/kolibrios/kolibri_http.h')
-rw-r--r-- | frontends/kolibrios/kolibri_http.h | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/frontends/kolibrios/kolibri_http.h b/frontends/kolibrios/kolibri_http.h new file mode 100644 index 000000000..c53ef9a99 --- /dev/null +++ b/frontends/kolibrios/kolibri_http.h @@ -0,0 +1,81 @@ +#ifndef KOLIBRI_HTTP_H +#define KOLIBRI_HTTP_H + +/* kolibri_http.h: Defines C style functions for using the underlying Kolibri HTTP library. + Defines functions for performing HTTP and related routines. + + Interface intended to make life of C programmers easy in order to use the http.obj library + which serves as the HTTP library for KolibriOS on top of the network stack. + + Read description of kolibri_http_init() for more information. + Read documentation of procedures in http.asm ($SVN/kolibrios/programs/develop/libraries/http/) + for even more information on the procedures. + + Copyright hidnplayr , GPL v2 + Copyright ashmew2 , GPL v2 +*/ + + +struct http_msg{ + /* Internal library use only */ + unsigned int socket; + unsigned int flags; + unsigned int write_ptr; + unsigned int buffer_length; + unsigned int chunk_ptr; + unsigned int timestamp; + + /* Available for use */ + unsigned int status; + unsigned int header_length; + char * content_ptr; + unsigned int content_length; + unsigned int content_received; + unsigned int http_header; +}; + +/* C - assembly wrapper to initialize and load the http.obj DLL at runtime */ +extern int init_network_asm(void); + +/* Procedures found in http.obj */ +extern struct http_msg* (*http_get_asm)(char *, struct http_msg *, unsigned int, char *) __attribute__((__stdcall__)); +extern int (*http_receive_asm)(struct http_msg *) __attribute__((__stdcall__)); +extern void (*http_disconnect_asm)(struct http_msg *) __attribute__((__stdcall__)); +extern void (*http_free_asm)(struct http_msg *) __attribute__((__stdcall__)); +extern struct http_msg* (*http_head_asm)(char *, struct http_msg *, unsigned int, char *) __attribute__((__stdcall__)); +extern struct http_post* (*http_post_asm)(char *, struct http_msg *, unsigned int, char *, char *, unsigned int) __attribute__((__stdcall__)); +extern int (*http_send_asm)(struct http_msg *, char *, unsigned int) __attribute__((__stdcall__)); +extern char * (*http_find_header_field_asm)(struct http_msg *, char *) __attribute__((__stdcall__)); +extern char * (*http_escape_asm)(char *, unsigned int) __attribute__((__stdcall__)); +extern char * (*http_unescape_asm)(char *, unsigned int) __attribute__((__stdcall__)); + +/* A C Programmer calls *ONLY* this function for initializing http.obj library at runtime */ +/* After successfully returning from kolibri_http_init(), all http_*_asm functions can be used. */ +/* Returns 0 on successful init */ + +int kolibri_http_init(void); + +#define HTTP_HTTP11 1 << 0 +#define HTTP_GOT_HEADER 1 << 1 +#define HTTP_GOT_ALL_DATA 1 << 2 +#define HTTP_CONTENT_LENGTH 1 << 3 +#define HTTP_CHUNKED 1 << 4 +#define HTTP_CONNECTED 1 << 5 + +/* Flags for user options */ +#define HTTP_KEEPALIVE 1 << 8 +#define HTTP_STREAM 1 << 9 +#define HTTP_REUSE_BUFFER 1 << 10 +#define HTTP_BLOCK 1 << 11 + +/* Flags for HTTP Errors */ +#define HTTP_INVALID_HEADER 1 << 16 +#define HTTP_NO_RAM 1 << 17 +#define HTTP_SOCKET_ERROR 1 << 18 +#define HTTP_TIMEOUT_ERROR 1 << 19 +#define HTTP_TRANSFER_FAILED 1 << 20 + +void http_send(struct http_msg *handle, char *data, int remaining_length); + +#endif /* KOLIBRI_HTTP_H */ + |