add libscgi (SCGI Client)

libs/libscgi/Makefile

+PWD=$(shell pwd)
+INCS=-I$(PWD)/src/include
+DEBUG=-g -ggdb
+BASE_FLAGS=$(INCS) $(DEBUG) -fPIC
+PICKY=-O2
+CFLAGS=$(BASE_FLAGS) $(PICKY)
+CXXFLAGS=$(BASE_FLAGS)
+MYLIB=libscgi.a
+LIBS=
+LDFLAGS=-L.
+OBJS=src/scgi.o 
+SRC=src/scgi.c 
+HEADERS=src/include/scgi.h 
+SOLINK=-shared -Xlinker -x
+
+
+all: $(MYLIB) testclient
+
+$(MYLIB): $(OBJS) $(HEADERS) $(SRC)
+	ar rcs $(MYLIB) $(OBJS)
+	ranlib $(MYLIB)
+
+%.o: %.c $(HEADERS)
+	$(CC) $(CC_CFLAGS) $(CFLAGS) -c $< -o $@
+
+testclient: $(MYLIB) testclient.c
+	$(CC) $(CC_CFLAGS) $(CFLAGS) testclient.c -o testclient -lscgi $(LDFLAGS) $(LIBS)
+
+
+
+clean:
+	rm -f *.o src/*.o libscgi.a *~ src/*~ src/include/*~ testclient

libs/libscgi/protocol.txt

+SCGI: A Simple Common Gateway Interface alternative
+Neil Schemenauer <nas@python.ca>
+2008-06-23 
+
+1. Introduction
+
+    The SCGI protocol is a replacement for the Common Gateway Interface
+    (CGI) protocol.  It is a standard for applications to interface with
+    HTTP servers.  It is similar to FastCGI but is designed to be easier
+    to implement.
+
+    In this document, a string of 8-bit bytes may be written in two
+    different forms: as a series of hexadecimal numbers between angle
+    brackets, or as a sequence of ASCII characters between double quotes.
+    For example, <68 65 6c 6c 6f 20 77 6f 72 6c 64 21> is a string of
+    length 12; it is the same as the string "hello world!". Note that
+    these notations are part of this document, not part of the protocol.
+
+
+2. Protocol
+
+    The client connects to a SCGI server over a reliable stream protocol
+    allowing transmission of 8-bit bytes.  The client begins by sending a
+    request.  See section 3 for the format of the request.  When the SCGI
+    server sees the end of the request it sends back a response and closes
+    the connection.  The format of the response is not specified by this
+    protocol.
+
+
+3. Request Format
+
+    A request consists of a number of headers and a body.  The format of
+    the headers is:
+
+        headers ::= header*
+        header ::= name NUL value NUL
+        name ::= notnull+                
+        value ::= notnull*
+        notnull ::= <01> | <02> | <03> | ... | <ff>
+        NUL = <00>
+
+    Duplicate names are not allowed in the headers.  The first header
+    must have the name "CONTENT_LENGTH" and a value that is a nonempty
+    sequence of ASCII digits giving the of the body length in decimal.
+    The "CONTENT_LENGTH" header must always be present, even if its
+    value is "0".  There must also always be a header with the name
+    "SCGI" and a value of "1".  In order to facilitate the transition
+    from CGI, standard CGI environment variables should be provided as
+    SCGI headers.  
+
+    The headers are sent encoded as a netstring.  Netstring encoding is
+    explained in section 4.  The body is sent following the headers and
+    its length is specified by the "CONTENT_LENGTH" header.
+    
+
+4. Netstrings
+
+    Any string of 8-bit bytes may be encoded as [len]":"[string]",".  Here
+    [string] is the string and [len] is a nonempty sequence of ASCII
+    digits giving the length of [string] in decimal. The ASCII digits are
+    <30> for 0, <31> for 1, and so on up through <39> for 9. Extra zeros
+    at the front of [len] are prohibited: [len] begins with <30> exactly
+    when [string] is empty.
+
+    For example, the string "hello world!" is encoded as <31 32 3a 68 65
+    6c 6c 6f 20 77 6f 72 6c 64 21 2c>, i.e., "12:hello world!,". The empty
+    string is encoded as "0:,".
+    
+    [len]":"[string]"," is called a netstring. [string] is called the
+    interpretation of the netstring.
+
+
+5. Example
+
+    The web server (a SCGI client) opens a connection and sends the
+    concatenation of the following strings:
+
+        "70:"
+            "CONTENT_LENGTH" <00> "27" <00>
+            "SCGI" <00> "1" <00>
+            "REQUEST_METHOD" <00> "POST" <00>
+            "REQUEST_URI" <00> "/deepthought" <00>
+        ","
+        "What is the answer to life?"
+
+    The SCGI server sends the following response:
+
+        "Status: 200 OK" <0d 0a>
+        "Content-Type: text/plain" <0d 0a>
+        "" <0d 0a>
+        "42"
+
+    The SCGI server closes the connection. 
+
+
+6. Copyright
+
+    This document has been placed in the public domain.
+
+
+/* vim: set ai tw=74 et sw=4 sts=4: */

libs/libscgi/src/include/scgi.h

+/*
+ * Copyright (c) 2012-2013, Anthony Minessale II
+ * All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 
+ * * 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.
+ * 
+ * * Neither the name of the original author; nor the names of any contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ * 
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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 COPYRIGHT OWNER
+ * OR CONTRIBUTORS 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 _SCGI_H_
+#define _SCGI_H_
+
+#include <stdarg.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* defined(__cplusplus) */
+#if EMACS_BUG
+}
+#endif
+
+#ifdef _MSC_VER
+#define FD_SETSIZE 8192
+#define SCGI_USE_SELECT
+#else 
+#define SCGI_USE_POLL
+#endif
+
+
+
+#ifdef SCGI_USE_POLL
+#include <poll.h>
+#endif
+
+#ifdef WIN32
+#include <winsock2.h>
+#include <windows.h>
+typedef SOCKET scgi_socket_t;
+typedef unsigned __int64 uint64_t;
+typedef unsigned __int32 uint32_t;
+typedef unsigned __int16 uint16_t;
+typedef unsigned __int8 uint8_t;
+typedef __int64 int64_t;
+typedef __int32 int32_t;
+typedef __int16 int16_t;
+typedef __int8 int8_t;
+typedef intptr_t scgi_ssize_t;
+typedef int scgi_filehandle_t;
+#define SCGI_SOCK_INVALID INVALID_SOCKET
+#define strerror_r(num, buf, size) strerror_s(buf, size, num)
+#if defined(SCGI_DECLARE_STATIC)
+#define SCGI_DECLARE(type)			type __stdcall
+#define SCGI_DECLARE_NONSTD(type)		type __cdecl
+#define SCGI_DECLARE_DATA
+#elif defined(SCGI_EXPORTS)
+#define SCGI_DECLARE(type)			__declspec(dllexport) type __stdcall
+#define SCGI_DECLARE_NONSTD(type)		__declspec(dllexport) type __cdecl
+#define SCGI_DECLARE_DATA				__declspec(dllexport)
+#else
+#define SCGI_DECLARE(type)			__declspec(dllimport) type __stdcall
+#define SCGI_DECLARE_NONSTD(type)		__declspec(dllimport) type __cdecl
+#define SCGI_DECLARE_DATA				__declspec(dllimport)
+#endif
+#else
+#define SCGI_DECLARE(type) type
+#define SCGI_DECLARE_NONSTD(type) type
+#define SCGI_DECLARE_DATA
+#include <stdint.h>
+#include <sys/types.h>
+#include <sys/ioctl.h>
+#include <stdarg.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <netdb.h>
+#define SCGI_SOCK_INVALID -1
+typedef int scgi_socket_t;
+typedef ssize_t scgi_ssize_t;
+typedef int scgi_filehandle_t;
+#endif
+
+
+#include <time.h>
+#ifndef WIN32
+#include <sys/time.h>
+#endif
+
+#include <stdarg.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#ifndef WIN32
+#include <sys/types.h>
+#include <sys/select.h>
+#include <netinet/tcp.h>
+#include <sys/signal.h>
+#include <unistd.h>
+#include <ctype.h>
+#endif
+
+#ifdef HAVE_STRINGS_H
+#include <strings.h>
+#endif
+#include <assert.h>
+
+#if (_MSC_VER >= 1400)			// VC8+
+#define scgi_assert(expr) assert(expr);__analysis_assume( expr )
+#endif
+
+#ifndef scgi_assert
+#define scgi_assert(_x) assert(_x)
+#endif
+
+#define scgi_safe_free(_x) if (_x) free(_x); _x = NULL
+#define scgi_strlen_zero(s) (!s || *(s) == '\0')
+#define scgi_strlen_zero_buf(s) (*(s) == '\0')
+#define end_of(_s) *(*_s == '\0' ? _s : _s + strlen(_s) - 1)
+
+
+typedef enum {
+	SCGI_POLL_READ = (1 << 0),
+	SCGI_POLL_WRITE = (1 << 1),
+	SCGI_POLL_ERROR = (1 << 2)
+} scgi_poll_t;
+
+
+typedef struct scgi_param_s {
+	char *name;
+	char *value;
+	struct scgi_param_s *next;
+} scgi_param_t;
+
+typedef struct scgi_handle_s {
+	scgi_param_t *params;
+	char *body;
+	struct sockaddr_in sockaddr;
+	struct hostent hostent;
+	char hostbuf[256];
+	scgi_socket_t sock;
+	char err[256];
+	int errnum;
+	int connected;
+	struct sockaddr_in addr;
+	int destroyed;
+} scgi_handle_t;
+
+
+typedef int16_t scgi_port_t;
+typedef size_t scgi_size_t;
+
+typedef enum {
+	SCGI_SUCCESS,
+	SCGI_FAIL,
+	SCGI_BREAK,
+	SCGI_DISCONNECTED,
+	SCGI_GENERR
+} scgi_status_t;
+
+
+
+SCGI_DECLARE(scgi_status_t) scgi_connect(scgi_handle_t *handle, const char *host, scgi_port_t port, uint32_t timeout);
+SCGI_DECLARE(scgi_status_t) scgi_disconnect(scgi_handle_t *handle);
+SCGI_DECLARE(int) scgi_wait_sock(scgi_socket_t sock, uint32_t ms, scgi_poll_t flags);
+SCGI_DECLARE(ssize_t) scgi_recv(scgi_handle_t *handle, unsigned char *buf, size_t buflen);
+SCGI_DECLARE(scgi_status_t) scgi_send_request(scgi_handle_t *handle);
+SCGI_DECLARE(scgi_status_t) scgi_add_param(scgi_handle_t *handle, const char *name, const char *value);
+SCGI_DECLARE(scgi_status_t) scgi_add_body(scgi_handle_t *handle, const char *value);
+SCGI_DECLARE(size_t) scgi_build_message(scgi_handle_t *handle, char **buffer);
+SCGI_DECLARE(scgi_status_t) scgi_destroy_params(scgi_handle_t *handle);
+
+#ifdef __cplusplus
+}
+#endif /* defined(__cplusplus) */
+
+
+#endif /* defined(_SCGI_H_) */
+
+/* For Emacs:
+ * Local Variables:
+ * mode:c
+ * indent-tabs-mode:t
+ * tab-width:4
+ * c-basic-offset:4
+ * End:
+ * For VIM:
+ * vim:set softtabstop=4 shiftwidth=4 tabstop=4:
+ */

libs/libscgi/testclient.c

+#include <scgi.h>
+
+
+int main(int argc, char *argv[])
+{
+	char buf[16336] = "";
+	ssize_t len;
+	scgi_handle_t handle = { 0 };
+	char *ip;
+	int port = 0;
+
+	if (argc < 2) {
+		fprintf(stderr, "usage: testclient <ip> <port>");
+	}
+
+	ip = argv[1];
+	port = atoi(argv[2]);
+
+
+
+	scgi_add_param(&handle, "REQUEST_METHOD", "POST");
+	scgi_add_param(&handle, "REQUEST_URI", "/deepthought");
+	scgi_add_param(&handle, "TESTING", "TRUE");
+	scgi_add_param(&handle, "TESTING", "TRUE");
+	scgi_add_body(&handle, "What is the answer to life?");
+
+
+	scgi_connect(&handle, ip, port, 10000);
+
+	scgi_send_request(&handle);
+
+	
+	while((len = scgi_recv(&handle, buf, sizeof(buf))) > 0) {
+		printf("READ [%s]\n", buf);
+	}
+
+	scgi_disconnect(&handle);
+
+}