SoupServer

SoupServer — HTTP server

Synopsis

                    SoupServerContext;
void                (*SoupServerCallbackFn)             (SoupServerContext *context,
                                                         SoupMessage *msg,
                                                         gpointer user_data);
void                (*SoupServerUnregisterFn)           (SoupServer *server,
                                                         SoupServerHandler *handler,
                                                         gpointer user_data);
SoupServer *        soup_server_new                     (const char *optname1,
                                                         ...);
SoupProtocol        soup_server_get_protocol            (SoupServer *serv);
guint               soup_server_get_port                (SoupServer *serv);
SoupSocket *        soup_server_get_listener            (SoupServer *serv);
void                soup_server_run                     (SoupServer *serv);
void                soup_server_run_async               (SoupServer *serv);
void                soup_server_quit                    (SoupServer *serv);

typedef             SoupServerHandler;
void                soup_server_add_handler             (SoupServer *serv,
                                                         const char *path,
                                                         SoupServerAuthContext *auth_ctx,
                                                         SoupServerCallbackFn callback,
                                                         SoupServerUnregisterFn unreg,
                                                         gpointer data);
void                soup_server_remove_handler          (SoupServer *serv,
                                                         const char *path);
SoupServerHandler * soup_server_get_handler             (SoupServer *serv,
                                                         const char *path);
GSList *            soup_server_list_handlers           (SoupServer *serv);
SoupAddress *       soup_server_context_get_client_address
                                                        (SoupServerContext *ctx);
const char *        soup_server_context_get_client_host (SoupServerContext *ctx);

#define             SOUP_SERVER_PORT
#define             SOUP_SERVER_INTERFACE
#define             SOUP_SERVER_SSL_CERT_FILE
#define             SOUP_SERVER_SSL_KEY_FILE
#define             SOUP_SERVER_ASYNC_CONTEXT

Description

SoupServer implements a simple HTTP server.

This API is less stable than the soup client API, and will most likely change in the next release.

Details

SoupServerContext

typedef struct {
	SoupMessage       *msg;
	char              *path;
	SoupMethodId       method_id;
	SoupServerAuth    *auth;
	SoupServer        *server;
	SoupServerHandler *handler;
	SoupSocket        *sock;
} SoupServerContext;


SoupServerCallbackFn ()

void                (*SoupServerCallbackFn)             (SoupServerContext *context,
                                                         SoupMessage *msg,
                                                         gpointer user_data);


SoupServerUnregisterFn ()

void                (*SoupServerUnregisterFn)           (SoupServer *server,
                                                         SoupServerHandler *handler,
                                                         gpointer user_data);


soup_server_new ()

SoupServer *        soup_server_new                     (const char *optname1,
                                                         ...);


soup_server_get_protocol ()

SoupProtocol        soup_server_get_protocol            (SoupServer *serv);


soup_server_get_port ()

guint               soup_server_get_port                (SoupServer *serv);


soup_server_get_listener ()

SoupSocket *        soup_server_get_listener            (SoupServer *serv);


soup_server_run ()

void                soup_server_run                     (SoupServer *serv);


soup_server_run_async ()

void                soup_server_run_async               (SoupServer *serv);


soup_server_quit ()

void                soup_server_quit                    (SoupServer *serv);


SoupServerHandler

typedef struct SoupServerHandler SoupServerHandler;


soup_server_add_handler ()

void                soup_server_add_handler             (SoupServer *serv,
                                                         const char *path,
                                                         SoupServerAuthContext *auth_ctx,
                                                         SoupServerCallbackFn callback,
                                                         SoupServerUnregisterFn unreg,
                                                         gpointer data);


soup_server_remove_handler ()

void                soup_server_remove_handler          (SoupServer *serv,
                                                         const char *path);


soup_server_get_handler ()

SoupServerHandler * soup_server_get_handler             (SoupServer *serv,
                                                         const char *path);


soup_server_list_handlers ()

GSList *            soup_server_list_handlers           (SoupServer *serv);


soup_server_context_get_client_address ()

SoupAddress *       soup_server_context_get_client_address
                                                        (SoupServerContext *ctx);


soup_server_context_get_client_host ()

const char *        soup_server_context_get_client_host (SoupServerContext *ctx);


SOUP_SERVER_PORT

#define SOUP_SERVER_PORT          "port"

An alias for the "port" property.


SOUP_SERVER_INTERFACE

#define SOUP_SERVER_INTERFACE     "interface"

An alias for the "interface" property.


SOUP_SERVER_SSL_CERT_FILE

#define SOUP_SERVER_SSL_CERT_FILE "ssl-cert-file"

An alias for the "ssl-cert-file" property.


SOUP_SERVER_SSL_KEY_FILE

#define SOUP_SERVER_SSL_KEY_FILE  "ssl-key-file"

An alias for the "ssl-key-file" property.


SOUP_SERVER_ASYNC_CONTEXT

#define SOUP_SERVER_ASYNC_CONTEXT "async-context"

An alias for the "async-context" property.