httpd.h

Go to the documentation of this file.

/*
 *  Copyright (c) 2004, Dennis Kuschel.
 *  All rights reserved. 
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions
 *  are met:
 *
 *   1. Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in the
 *      documentation and/or other materials provided with the distribution.
 *   3. The name of the author may not be used to endorse or promote
 *      products derived from this software without specific prior written
 *      permission. 
 *
 *  THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
 *  OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 *  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 *  ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
 *  INDIRECT,  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 *  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 *  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 *  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 *  STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 *  OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */

#ifndef _HTTPD_H_
#define _HTTPD_H_

#include "sys.h"

#ifndef HTTP_SERVLETS
#define HTTP_SERVLETS   1
#endif


#if HTTP_SERVLETS

typedef  void*      SERVLET_t;

typedef  sint_t (*SERVLETFUNC_t)(SERVLET_t slobj);

#define SLERR_OK            0
#define SLERR_FAIL          -1
#define SLERR_NEEDMEM       -2

#define SLERR_BADREQUEST    -3  /* 400 Bad Request */
#define SLERR_NOTFOUND      -4  /* 404 Not Found   */
#define SLERR_SERVER        -5  /* 500 Internal Server Error */
#define SLERR_CREATED       -6  /* 201 Created */
#define SLERR_ACCEPTED      -7  /* 202 ACCEPTED */
#define SLERR_PARTIAL       -8  /* 206 Partial Content */
#define SLERR_FORBIDDEN     -9  /* 403 Forbidden */
#define SLERR_TOOLARGE      -10 /* 413 Request Entity Too Large */
#define SLERR_UNAVAILABLE   -11 /* 503 Service Unavailable */
#define SLERR_BUSY          -12 /* 200 OK, but Server Busy */


sint_t hsl_create(SERVLETFUNC_t func, const char *filename);

sint_t hsl_destroy(SERVLETFUNC_t func);

char *hsl_getParameterByName(SERVLET_t *slobj, const char *name);

char *hsl_getOwnName(SERVLET_t *slobj);

sint_t hsl_setStreamBufSize(SERVLET_t *slobj, u32_t bufsize);

sint_t hsl_printf(SERVLET_t *slobj, const char *fmt, ...);

void* hsl_getSession(SERVLET_t *slobj);

void* hsl_newSession(SERVLET_t *slobj, u32_t memsize, u32_t timeout);

sint_t hsl_destroySession(SERVLET_t *slobj);

sint_t hsl_formAddSessionId(SERVLET_t *slobj);


#define HSL_LINK_RAW   0x00000001
#define HSL_LINK_SID   0x00000002
#define HSL_LINK_QM    0x80000000  /* internal, do not use */


sint_t hsl_linkCreate(SERVLET_t *slobj, const char* url, u32_t flags);

sint_t hsl_linkAddStringVal(SERVLET_t *slobj, const char *name,
                            const char* val);

sint_t hsl_linkAddNumberVal(SERVLET_t *slobj, const char *name, u32_t val);

sint_t hsl_linkInsert(SERVLET_t *slobj, const char *linktext);

sint_t hsl_addSessionIdToForm(SERVLET_t *slobj);


#endif


sint_t httpd_start(const char *rootDirectory,
                   u32_t maxServletMem, u32_t maxSessionMem);

sint_t httpd_stop(void);

sint_t httpd_running(void);


#endif /* _HTTPD_H_ */

---