cp_socket

Section: cp_socket (3)
Updated: OCTOBER 2005
Index Return to Main Contents
 

NAME

cp_http_service - http service descriptor  

SYNOPSIS

#include <cprops/http.h>

cp_http_service *
      cp_http_service_create(char *name, char *path,
                             cp_http_service_callback service);

void cp_http_service_delete(cp_http_service *service);

 

DESCRIPTION

With the libcprops http server socket api, defining services is done by wrapping handler functions for specific uri prefixes in a cp_http_service struct and registered with a cp_httpsocket. The service function should follow this prototype: 

int service(cp_http_request *request, cp_http_response *response);

and return one of the integer values HTTP_CONNECTION_POLICY_CLOSE or HTTP_CONNECTION_POLICY_KEEP_ALIVE as required per request. For each request the service function registered to handle the request uri prefix is invoked with a request wrapper describing the request and an empty response wrapper which will be written to the remote client when the service handler returns.

cp_http_service_create creates a service with the name name, uri prefix path and service handler service. cp_http_service_delete finalizes a service descriptor struct.

cp_httpsocket_register_service associates a service with a cp_httpsocket. Services may be associated with multiple socket instances.  

SEE ALSO

cp_httpsocket(3), cp_http_request(3), cp_http_response(3)

 

Index

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 20:23:44 GMT, January 02, 2006 		SourceForge .net Logo