Http API Native API

Extensions

Http Http service object.
HttpAuth Authorization.
HttpCache Cache Control.
HttpConn Http Connections.
HttpDir Directory object for the DirHandler.
HttpEndpoint Listening endpoints.
HttpHost Host Object.
HttpLimits Http limits.
HttpMonitor Monitor control structure.
HttpPacket Packet object.
HttpQueue Queue object.
HttpRange Content range structure.
HttpRoute Route Control.
HttpRx Http Rx.
HttpSession Session state object.
HttpStage Pipeline Stages.
HttpStats HttpStats.
HttpTrace Trace management structure.
HttpTx Http Tx.
HttpUploadFile Upload File.
HttpUri URI management.
HttpWebSocket WebSocket Service to implement the WebSockets RFC 6455 specification for client and server communications.

Functions

HttpConn*httpAcceptConn(HttpEndpoint *endpoint, MprEvent *event)
 Accept a new connection.
inthttpAddBodyParams(HttpConn *conn)
 Add parameters from the request body content.
voidhttpAddCache(struct HttpRoute *route, cchar *methods, cchar *uris, cchar *extensions, cchar *types, MprTicks clientLifespan, MprTicks serverLifespan, int flags)
 Add caching for response content.
HttpParseCallbackhttpAddConfig(cchar *key, HttpParseCallback callback)
 Add a configuration file callback for a property key.
inthttpAddCounter(cchar *name)
 Add a counter to be monitored.
inthttpAddDefense(cchar *name, cchar *remedy, cchar *args)
 Add a defense.
inthttpAddDefenseFromJson(cchar *name, cchar *remedy, MprJson *jargs)
 Add a defense using JSON arguments.
voidhttpAddHeader(HttpConn *conn, cchar *key, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Add a header to the transmission using a format string.
void voidhttpAddHeaderString(HttpConn *conn, cchar *key, cchar *value)
 Add a header to the transmission.
voidhttpAddHostToEndpoint(HttpEndpoint *endpoint, struct HttpHost *host)
 Add a host to an endpoint.
voidhttpAddJsonParams(HttpConn *conn)
 Add parameters from a JSON body.
inthttpAddMonitor(cchar *counter, cchar *expr, uint64 limit, MprTicks period, cchar *defenses)
 Add a monitor.
voidhttpAddOption(MprHash *options, cchar *field, cchar *value)
 Add an option to the options table.
voidhttpAddPermResource(HttpRoute *parent, cchar *resource)
 Add routes for a permanent resource.
voidhttpAddQueryParams(HttpConn *conn)
 Add parameters from the request query string.
inthttpAddRemedy(cchar *name, HttpRemedyProc remedy)
 Add a remedy.
voidhttpAddResource(HttpRoute *parent, cchar *resource)
 Add routes for a resource.
voidhttpAddResourceGroup(HttpRoute *parent, cchar *resource)
 Add routes for a group of resources.
HttpRoute*httpAddRestfulRoute(HttpRoute *parent, cchar *methods, cchar *pattern, cchar *target, cchar *resource)
 Define a RESTful route.
HttpRole*httpAddRole(HttpAuth *auth, cchar *role, cchar *abilities)
 Add a role.
inthttpAddRoute(HttpHost *host, HttpRoute *route)
 Add a route to a host.
inthttpAddRouteCondition(HttpRoute *route, cchar *name, cchar *details, int flags)
 Add a route condition.
voidhttpAddRouteErrorDocument(HttpRoute *route, int status, cchar *uri)
 Add an error document.
inthttpAddRouteFilter(HttpRoute *route, cchar *name, cchar *extensions, int direction)
 Add a route filter.
inthttpAddRouteHandler(HttpRoute *route, cchar *name, cchar *extensions)
 Add a route handler.
voidhttpAddRouteIndex(HttpRoute *route, cchar *path)
 Set the route index document.
inthttpAddRouteLanguageDir(HttpRoute *route, cchar *language, cchar *path)
 Add a route language directory.
inthttpAddRouteLanguageSuffix(HttpRoute *route, cchar *language, cchar *suffix, int flags)
 Add a route language suffix.
voidhttpAddRouteMapping(HttpRoute *route, cchar *extensions, cchar *mappings)
 Add a route mapping.
voidhttpAddRouteMethods(HttpRoute *route, cchar *methods)
 Add HTTP methods for the route.
voidhttpAddRouteParam(HttpRoute *route, cchar *field, cchar *value, int flags)
 Add a route param check.
voidhttpAddRouteRequestHeaderCheck(HttpRoute *route, cchar *header, cchar *value, int flags)
 Add a request header check.
voidhttpAddRouteResponseHeader(HttpRoute *route, int cmd, cchar *header, cchar *value)
 Add a response header.
voidhttpAddRouteSet(HttpRoute *route, cchar *set)
 Add a route set.
inthttpAddRouteUpdate(HttpRoute *route, cchar *name, cchar *details, int flags)
 Add a route update rule.
inthttpAddSecurityToken(HttpConn *conn, bool recreate)
 Add the security token to the response.
HttpUser*httpAddUser(HttpAuth *auth, cchar *user, cchar *password, cchar *abilities)
 Add a user.
HttpRoute*httpAddWebSocketsRoute(HttpRoute *route, cchar *action)
 Add a route using the WebSockets filter.
voidhttpAdjustPacketEnd(HttpPacket *packet, MprOff size)
 Adjust the packet end position.
voidhttpAdjustPacketStart(HttpPacket *packet, MprOff size)
 Adjust the packet starting position.
voidhttpAfterEvent(HttpConn *conn)
 Do setup after an I/O event to receive future events.
HttpSession*httpAllocSession(HttpConn *conn, cchar *id, MprTicks lifespan)
 Allocate a new session state object.
voidhttpAppendHeader(HttpConn *conn, cchar *key, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Append a transmission header.
void voidhttpAppendHeaderString(HttpConn *conn, cchar *key, cchar *value)
 Append a transmission header string.
inthttpApplyChangedGroup()
 Apply the changed group ID.
inthttpApplyChangedUser()
 Apply the changed user ID.
inthttpApplyUserGroup()
 Apply the changed user and group ID.
boolhttpAuthenticate(HttpConn *conn)
 Authenticate a user based on session data.
inthttpBackupTraceLogFile(HttpTrace *trace)
 Backup the request trace log if required.
void voidhttpBadRequestError(HttpConn *conn, int status, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Emit an error message for a badly formatted request.
inthttpBanClient(cchar *ip, MprTicks period, int status, cchar *msg)
 Ban a client IP from service.
voidhttpBorrowConn(HttpConn *conn)
 Borrow a connection.
boolhttpCanUser(HttpConn *conn, cchar *abilities)
 Test if a user has the required abilities.
boolhttpCheckSecurityToken(HttpConn *conn)
 Check a security token.
voidhttpClearRouteStages(HttpRoute *route, int direction)
 Clear the pipeline stages for the route.
boolhttpClientConn(HttpConn *conn)
 Test if the connection is a client-side connection.
HttpHost*httpCloneHost(HttpHost *parent)
 Clone a host.
HttpPacket*httpClonePacket(HttpPacket *orig)
 Clone a packet.
HttpStage*httpCloneStage(HttpStage *stage)
 Create a clone of an existing state.
HttpUri*httpCloneUri(HttpUri *base, int flags)
 Clone a URI.
voidhttpClosePipeline(HttpConn *conn)
 Destroy the request pipeline.
voidhttpCommonTraceFormatter(HttpTrace *trace, struct HttpConn *conn, cchar *event, cchar *type, cchar *values, cchar *buf, ssize len)
 Common Log trace formatter.
HttpUri*httpCompleteUri(HttpUri *uri, HttpUri *other)
 Complete the given URI.
voidhttpComputeAllUserAbilities(HttpAuth *auth)
 Compute all the user abilities for a route using the given auth.
voidhttpComputeUserAbilities(HttpAuth *auth, HttpUser *user)
 Compute the user abilities for a given user in a route using the given auth.
boolhttpConfigure(HttpConfigureProc proc, void *arg, MprTicks timeout)
 Alter the configuration by first quiescing all Http activity.
inthttpConnect(HttpConn *conn, cchar *method, cchar *uri, struct MprSsl *ssl)
 Connect to a server and issue Http client request.
boolhttpContentNotModified(HttpConn *conn)
 Test if the content has not been modified.
Http*httpCreate(int flags)
 Create a Http service object.
HttpRoute*httpCreateActionRoute(HttpRoute *parent, cchar *pattern, HttpAction action)
 Create a route for use with the Action Handler.
HttpRoute*httpCreateAliasRoute(HttpRoute *parent, cchar *pattern, cchar *path, int status)
 Create a route suitable for use as an alias.
HttpAuth*httpCreateAuth()
 Create an authentication object.
HttpAuthStore*httpCreateAuthStore(cchar *name, HttpVerifyUser verifyUser)
 Add an authorization store for password validation.
inthttpCreateAuthType(cchar *name, HttpAskLogin askLogin, HttpParseAuth parse, HttpSetAuth setAuth)
 Create an authorization protocol type.
voidhttpCreateCGIParams(HttpConn *conn)
 Create CGI parameters.
HttpEndpoint*httpCreateConfiguredEndpoint(struct HttpHost *host, cchar *home, cchar *documents, cchar *ip, int port)
 Create and configure a new endpoint.
HttpRoute*httpCreateConfiguredRoute(struct HttpHost *host, int serverSide)
 Create a configured route.
HttpConn*httpCreateConn(struct HttpEndpoint *endpoint, MprDispatcher *dispatcher)
 Create a connection object.
HttpStage*httpCreateConnector(cchar *name, MprModule *module)
 Create a connector stage.
HttpPacket*httpCreateDataPacket(ssize size)
 Create a data packet.
HttpHost*httpCreateDefaultHost()
 Create the default host.
HttpRoute*httpCreateDefaultRoute(struct HttpHost *host)
 Create a default route for a host.
HttpPacket*httpCreateEndPacket()
 Create an end-of-stream packet.
HttpEndpoint*httpCreateEndpoint(cchar *ip, int port, MprDispatcher *dispatcher)
 Create an endpoint object.
HttpPacket*httpCreateEntityPacket(MprOff pos, MprOff size, HttpFillProc fill)
 Create an entity data packet.
inthttpCreateEvent(uint64 seqno, HttpEventProc callback, void *data)
 Invoke a callback on a connection using a connection sequence number.
HttpStage*httpCreateFilter(cchar *name, MprModule *module)
 Create a filter stage.
HttpStage*httpCreateHandler(cchar *name, MprModule *module)
 Create a request handler stage.
HttpPacket*httpCreateHeaderPacket()
 Create a response header packet.
HttpHost*httpCreateHost()
 Create a host.
HttpRoute*httpCreateInheritedRoute(HttpRoute *route)
 Create a route inherited from a parent route.
HttpLimits*httpCreateLimits(int serverSide)
 Create a new limits object.
HttpPacket*httpCreatePacket(ssize size)
 Create a data packet.
voidhttpCreatePipeline(HttpConn *conn)
 Create the pipeline.
HttpRoute*httpCreateRoute(struct HttpHost *host)
 Create a route for a host.
voidhttpCreateRxPipeline(HttpConn *conn, struct HttpRoute *route)
 Create the receive request pipeline.
HttpSession*httpCreateSession(HttpConn *conn)
 Create a session object.
HttpStage*httpCreateStage(cchar *name, int flags, MprModule *module)
 Create a connector stage.
HttpTrace*httpCreateTrace(HttpTrace *parent)
 Create a trace object.
HttpTx*httpCreateTx(HttpConn *conn, MprHash *headers)
 Create the tx object.
voidhttpCreateTxPipeline(HttpConn *conn, struct HttpRoute *route)
 Create the transmit request pipeline.
HttpUri*httpCreateUri(cchar *uri, int flags)
 Create and initialize a URI.
HttpUri*httpCreateUriFromParts(cchar *scheme, cchar *host, int port, cchar *path, cchar *reference, cchar *query, int flags)
 Create a URI from parts.
voidhttpDefaultIncoming(HttpQueue *q, HttpPacket *packet)
 Default incoming put callback.
voidhttpDefaultOutgoingServiceStage(HttpQueue *q)
 Default outgoing data handling.
voidhttpDefineAction(cchar *uri, HttpAction fun)
 Define a function procedure to invoke when the specified URI is requested.
HttpRoute*httpDefineRoute(HttpRoute *parent, cchar *methods, cchar *pattern, cchar *target, cchar *source)
 Define a route.
voidhttpDefineRouteCondition(cchar *name, HttpRouteProc *proc)
 Define a route condition rule.
HttpRouteSetProchttpDefineRouteSet(cchar *name, HttpRouteSetProc fn)
 Define a route set callback.
voidhttpDefineRouteTarget(cchar *name, HttpRouteProc *proc)
 Define a route target rule.
voidhttpDefineRouteUpdate(cchar *name, HttpRouteProc *proc)
 Define a route update rule.
voidhttpDestroy()
 Destroy the Http service.
voidhttpDestroyConn(HttpConn *conn)
 Destroy the connection object.
voidhttpDestroyEndpoint(HttpEndpoint *endpoint)
 Destroy the endpoint.
voidhttpDestroySession(HttpConn *conn)
 Destroy a session state object.
voidhttpDestroyTx(HttpTx *tx)
 Destroy the tx object.
voidhttpDetailTraceFormatter(HttpTrace *trace, struct HttpConn *conn, cchar *event, cchar *type, cchar *values, cchar *buf, ssize len)
 Detailed log trace formatter.
voidhttpDisableQueue(HttpQueue *q)
 Disable a queue.
voidhttpDiscardData(HttpConn *conn, int dir)
 Discard buffered transmit pipeline data.
voidhttpDiscardQueueData(HttpQueue *q, bool removePackets)
 Discard all data from the queue.
voidhttpDisconnect(HttpConn *conn)
 Disconnect the connection's socket.
voidhttpDumpCounters()
 Print the monitor counters to the error log.
voidhttpEaseLimits(HttpLimits *limits)
 Ease the limits.
voidhttpEnableConnEvents(HttpConn *conn)
 Enable connection events.
voidhttpEnableQueue(HttpQueue *q)
 Enable a queue after it has been disabled.
voidhttpEnableUpload(HttpConn *conn)
 Enable Multipart-Mime File Upload for this request.
voidhttpError(HttpConn *conn, int status, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Error handling for the connection.
cchar*httpExpandRouteVars(HttpRoute *route, cchar *str)
 Expand route variables in a string.
voidhttpFinalize(HttpConn *conn)
 Indicate the request is finalized.
voidhttpFinalizeConnector(HttpConn *conn)
 Finalize connector output sending the response.
voidhttpFinalizeOutput(HttpConn *conn)
 Finalize transmission of the http response.
voidhttpFinalizeRoute(HttpRoute *route)
 Finalize a route.
void HttpConn*httpFindConn(uint64 seqno, HttpEventProc proc, void *data)
 Find a connection given a connection sequence number.
voidhttpFlush(HttpConn *conn)
 Flush transmit data.
voidhttpFlushAll(HttpConn *conn)
 Flush transmit data and wait for all the data to be written to the socket.
boolhttpFlushQueue(HttpQueue *q, int flags)
 Flush queue data.
voidhttpFollowRedirects(HttpConn *conn, bool follow)
 Follow redirctions.
voidhttpFormatError(HttpConn *conn, int status, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Format an error transmission.
void ssizehttpFormatResponse(HttpConn *conn, cchar *fmt, ...) PRINTF_ATTRIBUTE(2
 Format an alternate response.
ssizehttpFormatResponseBody(HttpConn *conn, cchar *title, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Format a response body.
void ssize ssizehttpFormatResponsev(HttpConn *conn, cchar *fmt, va_list args)
 Format an alternate response.
voidhttpFormatTrace(HttpTrace *trace, struct HttpConn *conn, cchar *event, cchar *type, cchar *values, cchar *buf, ssize len)
 Convenience routine to format trace via the configured formatter.
char*httpFormatUri(cchar *scheme, cchar *host, int port, cchar *path, cchar *ref, cchar *query, int flags)
 Format a URI.
inthttpGetAsync(HttpConn *conn)
 Get the async mode value for the connection.
cchar*httpGetBodyInput(HttpConn *conn)
 Get the receive body input.
boolhttpGetBoolToken(cchar *tok)
 Parse a boolean token.
ssizehttpGetChunkSize(HttpConn *conn)
 Get the preferred chunked size for transfer chunk encoding.
void*httpGetConnContext(HttpConn *conn)
 Get the connection context object.
inthttpGetConnEventMask(HttpConn *conn)
 Get an IO event mask for events of interest to the connection.
void*httpGetConnHost(HttpConn *conn)
 Get the connection host object.
MprOffhttpGetContentLength(HttpConn *conn)
 Get the receive body content length.
void*httpGetContext()
 Get the http context object.
cchar*httpGetCookie(HttpConn *conn, cchar *name)
 Get a request cookie.
cchar*httpGetCookies(HttpConn *conn)
 Get the request cookies.
char*httpGetDateString(MprPath *sbuf)
 Get the time as an ISO date string.
HttpHost*httpGetDefaultHost()
 Get the default host defined via httpSetDefaultHost.
HttpRoute*httpGetDefaultRoute(HttpHost *host)
 Get the default route for a host.
cchar*httpGetDir(HttpRoute *route, cchar *name)
 Get a route directory variable.
HttpDir*httpGetDirObj(HttpRoute *route)
 Get the HttpDir object for a route.
void*httpGetEndpointContext(HttpEndpoint *endpoint)
 Get the endpoint context object.
cchar*httpGetError(HttpConn *conn)
 Get the error message associated with the last request.
char*httpGetExt(HttpConn *conn)
 Get a URI extension.
cchar*httpGetHeader(HttpConn *conn, cchar *key)
 Get an rx http header.
MprHash*httpGetHeaderHash(HttpConn *conn)
 Get the hash table of rx Http headers.
char*httpGetHeaders(HttpConn *conn)
 Get all the request http headers.
char*httpGetHeadersFromHash(MprHash *hash)
 Get a header string from the given hash.
HttpRoute*httpGetHostDefaultRoute(HttpHost *host)
 Return the default route for a host.
inthttpGetIntParam(HttpConn *conn, cchar *var, int defaultValue)
 Get a form variable as an integer.
inthttpGetKeepAliveCount(HttpConn *conn)
 Get the count of Keep-Alive requests that will be used for this connection object.
HttpLang*httpGetLanguage(HttpConn *conn, MprHash *spoken, cchar *defaultLang)
 Get the language to use for the request.
void*httpGetOption(MprHash *options, cchar *field, cchar *defaultValue)
 Extract a field value from an option string.
MprHash*httpGetOptionHash(MprHash *options, cchar *field)
 Get an option value that is itself an object (hash).
MprHash*httpGetOptions(cchar *options)
 Convert an options string into an options table.
HttpPacket*httpGetPacket(struct HttpQueue *q)
 Get the next packet from a queue.
ssizehttpGetPacketContents(HttpPacket *packet)
 Get the packet data contents.
ssizehttpGetPacketLength(HttpPacket *packet)
 Get the length of the packet data contents.
char*httpGetPacketStart(HttpPacket *packet)
 Get the start of the packet data contents.
char*httpGetPacketString(HttpPacket *packet)
 Get the packet data contents as a string.
cchar*httpGetParam(HttpConn *conn, cchar *var, cchar *defaultValue)
 Get a request param.
MprJson*httpGetParams(HttpConn *conn)
 Get the request params table.
char*httpGetParamsString(HttpConn *conn)
 Get the request params table as a string.
char*httpGetPathExt(cchar *path)
 Get a path extension.
cchar*httpGetQueryString(HttpConn *conn)
 Get the request query string.
void*httpGetQueueData(HttpConn *conn)
 Get the queue data for the connection.
ssizehttpGetQueueRoom(HttpQueue *q)
 Get the room in the queue.
ssizehttpGetReadCount(HttpConn *conn)
 Get the number of bytes that can be read from the read queue.
HttpUri*httpGetRelativeUri(HttpUri *base, HttpUri *target, int clone)
 Get a relative URI from the base to the target.
void*httpGetRouteData(HttpRoute *route, cchar *key)
 Get extra route data.
cchar*httpGetRouteDocuments(HttpRoute *route)
 Get the route documents directory.
cchar*httpGetRouteHome(HttpRoute *route)
 Get the route home directory.
cchar*httpGetRouteMethods(HttpRoute *route)
 Get the route method list.
cchar*httpGetRouteTop(HttpConn *conn)
 Get a URL path to the top of the route from the current request (rx->pathInfo).
cchar*httpGetRouteVar(HttpRoute *route, cchar *key)
 Get a path token variable.
cchar*httpGetSecurityToken(HttpConn *conn, bool recreate)
 Get a unique security token.
HttpSession*httpGetSession(HttpConn *conn, int create)
 Get a session state object.
cchar*httpGetSessionID(HttpConn *conn)
 Get the session ID.
MprHash*httpGetSessionObj(HttpConn *conn, cchar *key)
 Get an object from the session state store.
cchar*httpGetSessionVar(HttpConn *conn, cchar *name, cchar *defaultValue)
 Get a session state variable.
cvoid*httpGetStageData(struct HttpConn *conn, cchar *key)
 Get stage data.
voidhttpGetStats(HttpStats *sp)
 Get the Http performance statistics.
inthttpGetStatus(HttpConn *conn)
 Get the response status.
char*httpGetStatusMessage(HttpConn *conn)
 Get the Http response status message.
boolhttpGetStreaming(struct HttpHost *host, cchar *mime, cchar *uri)
 Determine if input body content should be streamed or buffered for requests with content of a given mime type.
inthttpGetTraceLevel()
 Get the current tracing level.
ssize cchar*httpGetTxHeader(HttpConn *conn, cchar *key)
 Get a tx http header.
voidhttpGetUserGroup()
 Get the user group.
cchar*httpGetWebSocketCloseReason(HttpConn *conn)
 Get the close reason supplied by the peer.
void*httpGetWebSocketData(HttpConn *conn)
 Get the WebSocket private data.
ssizehttpGetWebSocketMessageLength(HttpConn *conn)
 Get the message length for the current message.
char*httpGetWebSocketProtocol(HttpConn *conn)
 Get the selected WebSocket protocol selected by the server.
ssizehttpGetWebSocketState(HttpConn *conn)
 Get the WebSocket state.
ssizehttpGetWriteQueueCount(HttpConn *conn)
 Get the count of bytes buffered on the write queue.
HttpLimits*httpGraduateLimits(HttpRoute *route, HttpLimits *limits)
 Graduate the limits from the parent route.
voidhttpHandleOptions(struct HttpConn *conn)
 Handle a Http Options method request.
voidhttpHideRoute(HttpRoute *route, bool on)
 Hide the route from route tables.
void void voidhttpIO(struct HttpConn *conn, int eventMask)
 Handle I/O on the connection.
voidhttpIOEvent(struct HttpConn *conn, MprEvent *event)
 Respond to a HTTP I/O event.
voidhttpInitConfig(HttpRoute *route)
 Initialize and prepare to load configuration files.
voidhttpInitLimits(HttpLimits *limits, bool serverSide)
 Initialize a limits object with default values.
inthttpInitParser()
 Initialize the Http configuration parser.
voidhttpInsertOption(MprHash *options, cchar *field, cchar *value)
 Add an option to the options table.
boolhttpIsAuthenticated(HttpConn *conn)
 Test if the user is authenticated.
inthttpIsChunked(HttpConn *conn)
 Return whether transfer chunked encoding will be used on this request.
inthttpIsEndpointAsync(HttpEndpoint *endpoint)
 Get if the endpoint is running in asynchronous mode.
boolhttpIsEof(struct HttpConn *conn)
 Test if the connection has received all incoming content.
inthttpIsFinalized(HttpConn *conn)
 Test if request has been finalized.
boolhttpIsLastPacket(HttpPacket *packet)
 Test if the packet is the last in a logical message.
inthttpIsOutputFinalized(HttpConn *conn)
 Test if request response has been fully generated.
boolhttpIsPacketTooBig(struct HttpQueue *q, HttpPacket *packet)
 Test if a packet is too big.
boolhttpIsQueueEmpty(HttpQueue *q)
 Determine if the queue is empty.
boolhttpIsQueueSuspended(HttpQueue *q)
 Test if a queue is suspended.
inthttpJoinPacket(HttpPacket *packet, HttpPacket *other)
 Join two packets.
voidhttpJoinPacketForService(struct HttpQueue *q, HttpPacket *packet, bool serviceQ)
 Join a packet onto the service queue.
voidhttpJoinPackets(HttpQueue *q, ssize size)
 Join packets together.
HttpUri*httpJoinUri(HttpUri *base, int argc, HttpUri **others)
 Join URIs.
HttpUri*httpJoinUriPath(HttpUri *result, HttpUri *base, HttpUri *other)
 Join a URI path.
voidhttpLimitError(HttpConn *conn, int status, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Emit an error message for limit violations.
char*httpLink(struct HttpConn *conn, cchar *target)
 Create a URI link.
char*httpLinkAbs(struct HttpConn *conn, cchar *target)
 Create an absolute link that includes scheme and host.
char*httpLinkEx(struct HttpConn *conn, cchar *target, MprHash *options)
 Extended URI link creation.
inthttpLoadConfig(HttpRoute *route, cchar *path)
 Load a JSON configuration file.
voidhttpLogRoutes(HttpHost *host, bool full)
 Show the current route table to the error log.
boolhttpLogin(HttpConn *conn, cchar *username, cchar *password)
 Log the user in.
voidhttpLogout(HttpConn *conn)
 Logout the user.
struct HttpEndpoint*httpLookupEndpoint(cchar *ip, int port)
 Lookup a listening endpoint.
struct HttpHost*httpLookupHost(cchar *name)
 Lookup a host by name.
struct HttpHost*httpLookupHostOnEndpoint(HttpEndpoint *endpoint, cchar *name)
 Lookup a host name.
cchar*httpLookupMimeType(cchar *ext)
 Get the mime type for an extension.
HttpRole*httpLookupRole(HttpAuth *auth, cchar *name)
 Lookup a role by name.
HttpRoute*httpLookupRoute(HttpHost *host, cchar *pattern)
 Lookup a route by pattern.
cchar*httpLookupRouteErrorDocument(HttpRoute *route, int status)
 Lookup an error document by HTTP status code.
boolhttpLookupSessionID(cchar *id)
 Lookup a session ID.
struct HttpStage*httpLookupStage(cchar *name)
 Lookup a stage by name.
void*httpLookupStageData(cchar *name)
 Lookup stage data.
cchar*httpLookupStatus(int status)
 Lookup a Http status code.
HttpUser*httpLookupUser(HttpAuth *auth, cchar *name)
 Lookup a user by username.
char*httpMakePath(HttpRoute *route, cchar *dir, cchar *path)
 Make a filename path.
HttpUri*httpMakeUriLocal(HttpUri *uri)
 Make a URI local.
cchar*httpMapContent(HttpConn *conn, cchar *filename)
 Map a content filename.
voidhttpMapFile(HttpConn *conn)
 Map the request URI to a filename in physical storage for a handler.
struct HttpHost*httpMatchHost(HttpConn *conn, cchar *hostname)
 Match the HttpHost object that should serve this request.
boolhttpMatchParam(HttpConn *conn, cchar *var, cchar *expected)
 Match a form variable with an expected value.
MprSsl*httpMatchSsl(MprSocket *sp, cchar *hostname)
 Match the HttpHost object that should serve this request.
voidhttpMemoryError(HttpConn *conn)
 Signal a memory allocation error.
int64httpMonitorEvent(struct HttpConn *conn, int counter, int64 adj)
 Monitor an event and validate against defined limits and monitored resources.
boolhttpNeedRetry(HttpConn *conn, char **url)
 Determine if the transmission needs a transparent retry to implement authentication or redirection.
boolhttpNextQueueFull(HttpQueue *q)
 Test if the next queue is full.
HttpUri*httpNormalizeUri(HttpUri *uri)
 Normalize a URI.
char*httpNormalizeUriPath(cchar *uri)
 Normalize a URI.
voidhttpNotify(HttpConn *conn, int event, int arg)
 Inform notifiers of a connection event or state change.
voidhttpOmitBody(HttpConn *conn)
 Tell the tx to omit sending any body.
boolhttpOption(MprHash *options, cchar *field, cchar *value, int useDefault)
 Test a field value from an option string.
voidhttpParseAll(HttpRoute *route, cchar *key, MprJson *prop)
 Parse all the properties under the given key.
inthttpParsePlatform(cchar *platform, cchar **os, cchar **arch, cchar **profile)
 Parse a platform string.
voidhttpPrepClientConn(HttpConn *conn, bool keepHeaders)
 Prepare a client connection for a new request.
voidhttpProtocol(HttpConn *conn)
 HTTP protocol state machine for server-side requests and client-side responses.
boolhttpPumpOutput(HttpConn *conn)
 Get more output by invoking the handler's writable callback.
voidhttpPutBackPacket(struct HttpQueue *q, HttpPacket *packet)
 Put a packet back onto a queue.
voidhttpPutForService(struct HttpQueue *q, HttpPacket *packet, bool serviceQ)
 Put a packet into the service queue for deferred processing.
voidhttpPutPacket(struct HttpQueue *q, HttpPacket *packet)
 Put a packet to the queue.
voidhttpPutPacketToNext(struct HttpQueue *q, HttpPacket *packet)
 Put a packet to the next queue downstream.
boolhttpQueuesNeedService(HttpConn *conn)
 Test if the connection queues need service.
ssizehttpRead(HttpConn *conn, char *buffer, ssize size)
 Read rx body data.
ssizehttpReadBlock(HttpConn *conn, char *buffer, ssize size, MprTicks timeout, int flags)
 Read a block of rx body data.
char*httpReadString(HttpConn *conn)
 Read response data as a string.
voidhttpReadyHandler(HttpConn *conn)
 Run the handler ready callback.
voidhttpRedirect(HttpConn *conn, int status, cchar *uri)
 Redirect the client.
voidhttpRemoveCookie(HttpConn *conn, cchar *name)
 Remove a cookie from the client (browser) This will emit a Set-Cookie response header with the value set to "" and a one second lifespan.
inthttpRemoveHeader(HttpConn *conn, cchar *key)
 Remove a header from the transmission.
voidhttpRemoveOption(MprHash *options, cchar *field)
 Remove an option.
voidhttpRemoveParam(HttpConn *conn, cchar *var)
 Remove a request param.
voidhttpRemoveQueue(HttpQueue *q)
 Remove a queue.
inthttpRemoveRole(HttpAuth *auth, cchar *role)
 Remove a role.
voidhttpRemoveRouteMethods(HttpRoute *route, cchar *methods)
 Remove HTTP methods for the route.
inthttpRemoveSessionVar(HttpConn *conn, cchar *name)
 Remove a session state variable.
inthttpRemoveUser(HttpAuth *auth, cchar *user)
 Remove a user.
HttpConn*httpRequest(cchar *method, cchar *uri, cchar *data, char **err)
 Issue a http request.
boolhttpRequestExpired(HttpConn *conn, MprTicks timeout)
 Test if a request has exceeded its timeout limits.
voidhttpResetCredentials(HttpConn *conn)
 Reset the current security credentials.
voidhttpResetRouteIndexes(HttpRoute *route)
 Reset all defined indexes.
voidhttpResetRoutePipeline(HttpRoute *route)
 Reset the route pipeline.
voidhttpResetRoutes(HttpHost *host)
 Reset the list of routes for the host.
HttpPacket*httpResizePacket(struct HttpQueue *q, HttpPacket *packet, ssize size)
 Resize a packet.
HttpUri*httpResolveUri(struct HttpConn *conn, HttpUri *base, HttpUri *target)
 Resolve URIs relative to a base.
voidhttpResumeQueue(HttpQueue *q)
 Resume a queue.
voidhttpReturnConn(HttpConn *conn)
 Return a borrowed a connection.
voidhttpRouteRequest(HttpConn *conn)
 Route the request and select that matching route and handle to process the request.
voidhttpScheduleConnTimeout(HttpConn *conn)
 Schedule a connection timeout event on a connection.
voidhttpScheduleQueue(HttpQueue *q)
 Schedule a queue.
inthttpSecureEndpoint(HttpEndpoint *endpoint, struct MprSsl *ssl)
 Secure an endpoint.
inthttpSecureEndpointByName(cchar *name, struct MprSsl *ssl)
 Secure an endpoint by name.
ssizehttpSend(HttpConn *conn, cchar *fmt, ...) PRINTF_ATTRIBUTE(2
 Send a UTF-8 text message to the WebSocket peer.
ssizehttpSendBlock(HttpConn *conn, int type, cchar *msg, ssize len, int flags)
 Send a message of a given type to the WebSocket peer.
ssizehttpSendClose(HttpConn *conn, int status, cchar *reason)
 Send a close message to the WebSocket peer.
boolhttpServerConn(HttpConn *conn)
 Test if the connection is a server-side connection.
voidhttpServiceQueue(HttpQueue *q)
 Service a queue.
boolhttpServiceQueues(HttpConn *conn, int flags)
 Service pipeline queues to flow data.
voidhttpSetAsync(HttpConn *conn, int enable)
 Set the async mode value for the connection.
voidhttpSetAuthAllow(HttpAuth *auth, cchar *ip)
 Allow access by a client IP IP address.
voidhttpSetAuthAnyValidUser(HttpAuth *auth)
 Allow access by any valid user.
voidhttpSetAuthDeny(HttpAuth *auth, cchar *ip)
 Deny access by a client IP address.
voidhttpSetAuthFormDetails(struct HttpRoute *route, cchar *loginPage, cchar *loginService, cchar *logoutService, cchar *loggedInPage, cchar *loggedOutPage)
 Define login service URLs for use with "form" authentication.
voidhttpSetAuthLogin(HttpAuth *auth, cchar *uri)
 Define the login page for use with authentication.
voidhttpSetAuthOrder(HttpAuth *auth, int order)
 Set the auth allow/deny order.
voidhttpSetAuthPermittedUsers(HttpAuth *auth, cchar *users)
 Define the set of permitted users.
voidhttpSetAuthQop(HttpAuth *auth, cchar *qop)
 Set the required quality of service for digest authentication.
voidhttpSetAuthRealm(HttpAuth *auth, cchar *realm)
 Set the required realm for basic or digest authentication.
voidhttpSetAuthRequiredAbilities(HttpAuth *auth, cchar *abilities)
 Set the required abilities for access.
voidhttpSetAuthSession(HttpAuth *auth, bool noSession)
 Control whether a session and session cookie will be created for user logins for this authentication route.
inthttpSetAuthStore(HttpAuth *auth, cchar *store)
 Set the authentication password store to use.
voidhttpSetAuthStoreSessions(HttpAuthStore *store, bool noSession)
 Control whether sessions and session cookies are created for user logins.
inthttpSetAuthType(HttpAuth *auth, cchar *proto, cchar *details)
 Set the authentication protocol type to use.
voidhttpSetAuthUsername(HttpAuth *auth, cchar *username)
 Set an automatic login username.
voidhttpSetAuthVerify(HttpAuth *auth, HttpVerifyUser verifyUser)
 Set the verify callback for a authentication store.
voidhttpSetChunkSize(HttpConn *conn, ssize size)
 Set the chunk size for transfer chunked encoding.
voidhttpSetConnContext(HttpConn *conn, void *context)
 Set the connection context object.
voidhttpSetConnData(HttpConn *conn, void *data)
 Set the connection data field.
voidhttpSetConnHost(HttpConn *conn, void *host)
 Set the connection host object.
voidhttpSetConnNotifier(HttpConn *conn, HttpNotifier notifier)
 Define a notifier callback for this connection.
voidhttpSetConnUser(HttpConn *conn, struct HttpUser *user)
 Set the logged in user associated with the connection.
voidhttpSetContentLength(HttpConn *conn, MprOff length)
 Define a content length header in the transmission.
voidhttpSetContentType(HttpConn *conn, cchar *mimeType)
 Set the transmission (response) content mime type.
voidhttpSetContext(void *context)
 Set the http context object.
voidhttpSetCookie(HttpConn *conn, cchar *name, cchar *value, cchar *path, cchar *domain, MprTicks lifespan, int flags)
 Set a transmission cookie.
voidhttpSetCredentials(HttpConn *conn, cchar *user, cchar *password, cchar *authType)
 Set the Http credentials.
voidhttpSetDefaultClientHost(cchar *host)
 Define a default client host.
voidhttpSetDefaultClientPort(int port)
 Define a default client port.
voidhttpSetDefaultHost(HttpHost *host)
 Set the default host for all servers.
voidhttpSetDir(HttpRoute *route, cchar *name, cchar *value)
 Define a route directory path variable.
inthttpSetEndpointAddress(HttpEndpoint *endpoint, cchar *ip, int port)
 Set the endpoint IP address.
voidhttpSetEndpointAsync(HttpEndpoint *endpoint, int enable)
 Control if the endpoint is running in asynchronous mode.
voidhttpSetEndpointContext(HttpEndpoint *endpoint, void *context)
 Set the endpoint context object.
voidhttpSetEndpointNotifier(HttpEndpoint *endpoint, HttpNotifier fn)
 Define a notifier callback for this endpoint.
voidhttpSetEntityLength(HttpConn *conn, MprOff len)
 Define the length of the transmission content.
voidhttpSetEof(HttpConn *conn)
 Set the HttpRx eof condition.
voidhttpSetFileHandler(HttpConn *conn, cchar *path)
 Set the "fileHandler" to process the request.
boolhttpSetFilename(HttpConn *conn, cchar *filename, int flags)
 Set the filename to serve for a request.
voidhttpSetForkCallback(MprForkCallback proc, void *arg)
 Set the fork callback.
inthttpSetGroupAccount(cchar *group)
 Set the group account.
voidhttpSetHandler(HttpConn *conn, HttpStage *handler)
 Set the handler for this request Use this request from the Handler rewrite callback to change the selected handler to process a request.
voidhttpSetHeader(HttpConn *conn, cchar *key, cchar *fmt, ...) PRINTF_ATTRIBUTE(3
 Set a transmission header.
void voidhttpSetHeaderString(HttpConn *conn, cchar *key, cchar *value)
 Set a simple key/value transmission header.
voidhttpSetHeadersCallback(struct HttpConn *conn, HttpHeadersCallback fn, void *arg)
 Define a headers callback.
inthttpSetHostCanonicalName(HttpHost *host, cchar *name)
 Set the host canonical name.
voidhttpSetHostDefaultEndpoint(HttpHost *host, HttpEndpoint *endpoint)
 Set the default endpoint for a host.
voidhttpSetHostDefaultRoute(HttpHost *host, HttpRoute *route)
 Set the default route for a host.
inthttpSetHostName(HttpHost *host, cchar *name)
 Set the host name.
voidhttpSetHostProtocol(HttpHost *host, cchar *protocol)
 Set the host HTTP protocol version.
voidhttpSetHostRoot(HttpHost *host, cchar *root)
 Set the server root for a host.
voidhttpSetHostSecureEndpoint(HttpHost *host, HttpEndpoint *endpoint)
 Set the default secure endpoint for a host.
voidhttpSetIOCallback(struct HttpConn *conn, HttpIOCallback fn)
 Define an I/O callback for connections.
voidhttpSetIntParam(HttpConn *conn, cchar *var, int value)
 Set an integer request param value.
voidhttpSetKeepAliveCount(HttpConn *conn, int count)
 Control Http Keep-Alive for the connection.
voidhttpSetMethod(HttpConn *conn, cchar *method)
 Set a new HTTP method for processing.
voidhttpSetOption(MprHash *options, cchar *field, cchar *value)
 Set an option.
voidhttpSetParam(HttpConn *conn, cchar *var, cchar *value)
 Set a request param value.
inthttpSetPlatform(cchar *platform)
 Set platform description.
inthttpSetPlatformDir(cchar *platform)
 Set platform directory location.
voidhttpSetProtocol(HttpConn *conn, cchar *protocol)
 Set the Http protocol variant for this connection.
voidhttpSetProxy(cchar *host, int port)
 Define a Http proxy host to use for all client connect requests.
voidhttpSetQueueLimits(HttpQueue *q, ssize low, ssize max)
 Set a queue's flow control low and high water marks.
voidhttpSetRequestCallback(HttpRequestCallback callback)
 Define a request completion callback.
voidhttpSetResponded(HttpConn *conn)
 Set the responded flag for the request.
voidhttpSetRetries(HttpConn *conn, int retries)
 Set the Http retry count.
voidhttpSetRouteAuth(HttpRoute *route, HttpAuth *auth)
 Set the route authentication.
voidhttpSetRouteAutoDelete(HttpRoute *route, bool on)
 Control file upload auto delete.
voidhttpSetRouteAutoFinalize(HttpRoute *route, bool on)
 Control auto finalize for a route.
voidhttpSetRouteCompile(HttpRoute *route, bool on)
 Define whether updating a request may compile from source.
inthttpSetRouteConnector(HttpRoute *route, cchar *name)
 Set the connector to use for a route.
voidhttpSetRouteCookie(HttpRoute *route, cchar *cookie)
 Set the route session cookie.
voidhttpSetRouteCookiePersist(HttpRoute *route, int enable)
 Persist the cookie to disk.
voidhttpSetRouteData(HttpRoute *route, cchar *key, void *data)
 Set route data.
voidhttpSetRouteDefaultLanguage(HttpRoute *route, cchar *language)
 Set the default language for the route.
voidhttpSetRouteDocuments(HttpRoute *route, cchar *path)
 Set the route directory.
voidhttpSetRouteEnvEscape(HttpRoute *route, bool on)
 Define whether shell special characters are escaped in environment variables.
voidhttpSetRouteEnvPrefix(HttpRoute *route, cchar *prefix)
 Define a prefix string for environment variables.
voidhttpSetRouteFlags(HttpRoute *route, int flags)
 Update the route flags.
inthttpSetRouteHandler(HttpRoute *route, cchar *name)
 Set the handler to use for a route.
voidhttpSetRouteHome(HttpRoute *route, cchar *home)
 Set the route directory for configuration files.
voidhttpSetRouteIgnoreEncodingErrors(HttpRoute *route, bool on)
 Set the route to ignore UTF encoding errors for WebSocket connections.
voidhttpSetRouteMethods(HttpRoute *route, cchar *methods)
 Define the methods for the route.
voidhttpSetRoutePattern(HttpRoute *route, cchar *pattern, int flags)
 Set the route pattern.
voidhttpSetRoutePrefix(HttpRoute *route, cchar *prefix)
 Set the route prefix.
voidhttpSetRoutePreserveFrames(HttpRoute *route, bool on)
 Set the route to preserve WebSocket frames boundaries.
voidhttpSetRouteRenameUploads(HttpRoute *route, bool enable)
 Control the renaming of uploaded filenames.
voidhttpSetRouteScript(HttpRoute *route, cchar *script, cchar *scriptPath)
 Set the script to service the route.
voidhttpSetRouteSessionVisibility(HttpRoute *route, bool visible)
 Make session cookies that are visible to javascript.
voidhttpSetRouteShowErrors(HttpRoute *route, bool on)
 Define whether to show errors to the client.
voidhttpSetRouteSource(HttpRoute *route, cchar *source)
 Set the source code module for the route.
voidhttpSetRouteStealth(HttpRoute *route, bool on)
 Set stealth mode for the route.
inthttpSetRouteTarget(HttpRoute *route, cchar *name, cchar *details)
 Set a route target.
voidhttpSetRouteTemplate(HttpRoute *route, cchar *tplate)
 Set the route template.
voidhttpSetRouteUpdate(HttpRoute *route, bool on)
 Define whether updating a cached request is required.
voidhttpSetRouteUploadDir(HttpRoute *route, cchar *dir)
 Set the default upload directory for file uploads.
voidhttpSetRouteVar(HttpRoute *route, cchar *token, cchar *value)
 Define a route variable.
voidhttpSetRouteWorkers(HttpRoute *route, int workers)
 Define the maximum number of workers for a route.
voidhttpSetRouteXsrf(HttpRoute *route, bool enable)
 Control whether an XSRF token will be emitted during a user login sequence.
voidhttpSetSendConnector(HttpConn *conn, cchar *path)
 Set the "Send" connector to process the request.
voidhttpSetSessionNotify(MprCacheProc notifyProc)
 Set a notification callback to be invoked for session notification events.
inthttpSetSessionObj(HttpConn *conn, cchar *key, MprHash *value)
 Set an object into the session state store.
inthttpSetSessionVar(HttpConn *conn, cchar *name, cchar *value)
 Set a session variable.
voidhttpSetSoftware(cchar *description)
 Set the software description.
voidhttpSetStageData(struct HttpConn *conn, cchar *key, cvoid *data)
 Set stage data.
voidhttpSetState(HttpConn *conn, int state)
 Set the connection state and invoke notifiers.
voidhttpSetStatus(HttpConn *conn, int status)
 Set a Http response status.
voidhttpSetStreaming(struct HttpHost *host, cchar *mime, cchar *uri, bool streaming)
 Control if input body content should be streamed or buffered for requests with content of a given mime type.
voidhttpSetTimeout(HttpConn *conn, MprTicks requestTimeout, MprTicks inactivityTimeout)
 Set the Http inactivity timeout.
voidhttpSetTimestamp(MprTicks period)
 Define a timestamp in the MPR log file.
voidhttpSetTraceContentSize(HttpTrace *trace, ssize size)
 Set the maximum content size to trace.
voidhttpSetTraceEventLevel(HttpTrace *trace, cchar *type, int level)
 Configure the tracing level for an event type.
voidhttpSetTraceFormat(HttpTrace *trace, cchar *format)
 Set the logging format.
HttpTraceFormatterhttpSetTraceFormatter(HttpTrace *trace, HttpTraceFormatter callback)
 Set the formatter callback to use with a trace object.
voidhttpSetTraceFormatterName(HttpTrace *trace, cchar *name)
 Define the trace formatter by name.
voidhttpSetTraceLevel(int level)
 Set the current tracing verbosity level.
inthttpSetTraceLogFile(HttpTrace *trace, cchar *path, ssize size, int backup, cchar *format, int flags)
 Configure the request trace log.
voidhttpSetTraceLogger(HttpTrace *trace, HttpTraceLogger callback)
 Set the trace callback to use with a trace object.
inthttpSetUri(HttpConn *conn, cchar *uri)
 Set a new URI for processing.
inthttpSetUserAccount(cchar *user)
 Set the user account.
voidhttpSetWebSocketData(HttpConn *conn, void *data)
 Set the WebSocket private data.
voidhttpSetWebSocketPreserveFrames(HttpConn *conn, bool on)
 Preserve frames for incoming messages.
voidhttpSetWebSocketProtocols(HttpConn *conn, cchar *protocols)
 Set a list of application-level protocols supported by the client.
voidhttpSetupWaitHandler(HttpConn *conn, int eventMask)
 Setup a wait handler for the connection to wait for desired events.
boolhttpShouldRenderDirListing(HttpConn *conn)
 Test if a directory listing should be rendered for the request.
voidhttpSocketBlocked(HttpConn *conn)
 Indicate that the transmission socket is blocked.
HttpPacket*httpSplitPacket(HttpPacket *packet, ssize offset)
 Split a data packet.
inthttpStartEndpoint(HttpEndpoint *endpoint)
 Start listening for client connections on an endpoint.
inthttpStartEndpoints()
 Start listening for client connections on all endpoints.
voidhttpStartPipeline(HttpConn *conn)
 Start the pipeline.
inthttpStartTracing(cchar *traceSpec)
 Start tracing for the given trace log file when instructed via a command line switch.
char*httpStatsReport(int flags)
 Get an Http performance report.
MprSocket*httpStealSocket(HttpConn *conn)
 Steal a socket from a connection.
SockethttpStealSocketHandle(HttpConn *conn)
 Steal the O/S socket handle from the connection socket object.
voidhttpStopConnections(void *data)
 Stop all connections owned by the data handle.
voidhttpStopEndpoint(HttpEndpoint *endpoint)
 Stop the server listening for client connections.
voidhttpStopEndpoints()
 Stop listening for client connections on all endpoints.
voidhttpSuspendQueue(HttpQueue *q)
 Suspend a queue.
char*httpTemplate(HttpConn *conn, cchar *tplate, MprHash *options)
 Expand a template string using given options.
inthttpTestParam(HttpConn *conn, cchar *var)
 Test if a request param is defined.
boolhttpTokenize(HttpRoute *route, cchar *str, cchar *fmt, ...)
 Tokenize a string based on route data.
boolhttpTokenizev(HttpRoute *route, cchar *str, cchar *fmt, va_list args)
 Tokenize a string based on route data.
boolhttpTrace(struct HttpConn *conn, cchar *event, cchar *type, cchar *values, ...)
 Trace an event of interest.
bool boolhttpTraceContent(struct HttpConn *conn, cchar *event, cchar *type, cchar *buf, ssize len, cchar *values, ...) PRINTF_ATTRIBUTE(6
 Trace request content.
bool bool,boolhttpTracePacket(struct HttpConn *conn, cchar *event, cchar *type, struct HttpPacket *packet, cchar *values, ...) PRINTF_ATTRIBUTE(5
 Trace request packet.
voidhttpTrimExtraPath(HttpConn *conn)
 Trim extra path from the URI.
ssizehttpUpdateCache(HttpConn *conn, cchar *uri, cchar *data, MprTicks lifespan)
 Update the cached content for a URI.
inthttpUpgradeWebSocket(HttpConn *conn)
 Upgrade a client HTTP connection connection to use WebSockets.
char*httpUriToString(HttpUri *uri, int flags)
 Convert a Uri to a string.
boolhttpValidUriChars(cchar *uri)
 Test if a URI is using only valid characters Note this does not test if the URI is fully legal.
char*httpValidateUriPath(cchar *uri)
 Validate a URI path as expected in a HTTP request line.
boolhttpVerifyWebSocketsHandshake(HttpConn *conn)
 Verify the server handshake.
inthttpWait(HttpConn *conn, int state, MprTicks timeout)
 Wait for the client connection to achieve the requested state.
boolhttpWebSocketOrderlyClosed(HttpConn *conn)
 Test if WebSocket connection was orderly closed by sending an acknowledged close message.
boolhttpWillNextQueueAcceptPacket(HttpQueue *q, HttpPacket *packet)
 Determine if the downstream queue will accept this packet.
boolhttpWillNextQueueAcceptSize(HttpQueue *q, ssize size)
 Determine if the downstream queue will accept a certain amount of data.
boolhttpWillQueueAcceptPacket(HttpQueue *q, HttpPacket *packet, bool split)
 Determine if the given queue will accept this packet.
ssizehttpWrite(HttpQueue *q, cchar *fmt, ...) PRINTF_ATTRIBUTE(2
 Write a formatted string.
ssizehttpWriteBlock(HttpQueue *q, cchar *buf, ssize size, int flags)
 Write a block of data to the queue.
ssizehttpWriteCached(HttpConn *conn)
 Write the cached content for a URI to the client.
voidhttpWriteHeaders(HttpQueue *q, HttpPacket *packet)
 Write the transmission headers into the given packet.
inthttpWriteSession(HttpConn *conn)
 Write the session state to persistent data storage.
ssizehttpWriteString(HttpQueue *q, cchar *s)
 Write a string of data to the queue.
bool bool,bool,voidhttpWriteTrace(HttpTrace *trace, cchar *buf, ssize len)
 Convenience routine to write trace to the trace logger.
voidhttpWriteTraceLogFile(HttpTrace *trace, cchar *buf, ssize len)
 Write a message to the trace file logger.
ssizehttpWriteUploadData(HttpConn *conn, MprList *formData, MprList *fileData)
 Write Http upload body data.

Typedefs

HttpAddressPer-IP address structure.
HttpAskLoginAuthType callback to generate a response requesting the user login This should call httpError if such a response cannot be generated.
HttpAuthStorePassword backend store.
HttpAuthTypeAuthentication Protocol.
HttpConfigureProcCallback procedure for HttpConfigure.
HttpCounterMonitoring counter.
HttpDefenseMonitor defense configuration.
HttpEnvCallbackSet environment vars callback.
HttpEventProcEvent callback function for httpCreateEvent.
HttpFillProcCallback procedure to fill a packet with data.
HttpHeadersCallbackCallback to fill headers.
HttpIOCallbackI/O callback for connections.
HttpLangLanguage definition record for routes.
HttpListenCallbackListen callback.
HttpNotifierConnection Http state change notification callback.
HttpParseAuthAuthType callback to parse the HTTP 'Authorize' (client) and 'www-authenticate' (server) headers.
HttpParseCallbackHttp JSON configuration parse callback.
HttpRemedyProcDefense remedy callback.
HttpRequestCallbackRequest completion callback.
HttpRoleAuthorization Roles.
HttpRouteOpRoute operation record.
HttpRouteProcGeneral route procedure.
HttpRouteSetProcRouteSet callback.
HttpSetAuthAuthType callback to set the necessary HTTP authorization headers for a client request.
HttpTimeoutCallbackTimeout callback.
HttpTraceFormatterTrace formatter callback.
HttpTraceLoggerTrace logger callback.
HttpUserUser Authorization.
HttpVerifyUserAuthStore callback Verify the user credentials.

Defines

#defineHTTP_ADDED_BODY_PARAMS   0x800
 Body data added to params.
#defineHTTP_ADDED_QUERY_PARAMS   0x400
 Query added to params.
#defineHTTP_ALLOW_DENY   0x1
 Run allow checks before deny checks.
#defineHTTP_AUTH_NO_SESSION   0x4
 Do not create a session when authenticated.
#defineHTTP_BLOCK   0x1
 Flag for httpSendBlock and httpWriteBlock to indicate blocking operation.
#defineHTTP_BUFFER   0x4
 Flag for httpSendBlock and httpWriteBlock to always absorb the data without blocking.
#defineHTTP_CACHE_CLIENT   0x1
 Cache on the client side.
#defineHTTP_CACHE_HAS_PARAMS   0x20
 Cache definition has params.
#defineHTTP_CACHE_MANUAL   0x4
 Cache manually.
#defineHTTP_CACHE_RESET   0x8
 Don't inherit cache config from outer routes.
#defineHTTP_CACHE_SERVER   0x2
 Cache on the server side.
#defineHTTP_CACHE_STATIC   0x40
 Cache extensions: css, gif, ico, jpg, js, html, pdf, ttf, txt, xml, woff.
#defineHTTP_CACHE_UNIQUE   0x10
 Uniquely cache request with different params.
#defineHTTP_CHUNK_DATA   2
 Start of chunk data.
#defineHTTP_CHUNK_EOF   3
 End of last chunk.
#defineHTTP_CHUNK_START   1
 Start of a new chunk.
#defineHTTP_CHUNK_UNCHUNKED   0
 Data is not transfer-chunk encoded.
#defineHTTP_CHUNKED   0x200
 Content is chunk encoded.
#defineHTTP_CLIENT_SIDE   0x1
 Initialize the client-side support.
#defineHTTP_CODE_ACCEPTED   202
 The request has been accepted and processing is continuing.
#defineHTTP_CODE_BAD_GATEWAY   502
 The server cannot act as a gateway for the given request.
#defineHTTP_CODE_BAD_HANDSHAKE   551
 The server handsake response is unacceptable.
#defineHTTP_CODE_BAD_METHOD   405
 The request HTTP method was not supported by the resource.
#defineHTTP_CODE_BAD_REQUEST   400
 The request is malformed.
#defineHTTP_CODE_BAD_VERSION   505
 The server does not support the HTTP protocol version.
#defineHTTP_CODE_CERT_ERROR   495
 The peer provided certificate is unacceptable.
#defineHTTP_CODE_COMMS_ERROR   550
 The server had a communicationss error responding to the client.
#defineHTTP_CODE_CONFLICT   409
 The request had a conflict in the request headers and URI.
#defineHTTP_CODE_CONTINUE   100
 Continue with request, only partial content transmitted.
#defineHTTP_CODE_CREATED   201
 The request has completed and a new resource was created.
#defineHTTP_CODE_EXPECTATION_FAILED   417
 The server cannot satisfy the Expect header requirements.
#defineHTTP_CODE_FORBIDDEN   403
 The request was legal, but the server refuses to process.
#defineHTTP_CODE_GATEWAY_TIMEOUT   504
 The server gateway timed out waiting for the upstream server.
#defineHTTP_CODE_GONE   410
 The requested resource is no longer available.
#defineHTTP_CODE_IM_A_TEAPOT   418
 Short and stout error code (RFC 2324).
#defineHTTP_CODE_INSUFFICIENT_STORAGE   507
 The server has insufficient storage to complete the request.
#defineHTTP_CODE_INTERNAL_SERVER_ERROR   500
 Server processing or configuration error.
#defineHTTP_CODE_LENGTH_REQUIRED   411
 The request did not specify a required content length.
#defineHTTP_CODE_MOVED_PERMANENTLY   301
 The requested URI has moved permanently to a new location.
#defineHTTP_CODE_MOVED_TEMPORARILY   302
 The URI has moved temporarily to a new location.
#defineHTTP_CODE_NO_CONTENT   204
 The request has completed and there is no response to send.
#defineHTTP_CODE_NO_RESPONSE   444
 The connection was closed with no response to the client.
#defineHTTP_CODE_NOT_ACCEPTABLE   406
 The requested resource cannot generate the required content.
#defineHTTP_CODE_NOT_AUTHORITATIVE   203
 The request has completed but content may be from another source.
#defineHTTP_CODE_NOT_FOUND   404
 The requested resource was not found.
#defineHTTP_CODE_NOT_IMPLEMENTED   501
 The server does not recognize the request or method.
#defineHTTP_CODE_NOT_MODIFIED   304
 The requested resource has changed since the last request.
#defineHTTP_CODE_OK   200
 The request completed successfully.
#defineHTTP_CODE_PARTIAL   206
 The request has completed and is returning partial content.
#defineHTTP_CODE_PAYMENT_REQUIRED   402
 Reserved for future use.
#defineHTTP_CODE_PRECOND_FAILED   412
 The server cannot satisfy one of the request preconditions.
#defineHTTP_CODE_RANGE_NOT_SATISFIABLE   416
 The request content range does not exist for the resource.
#defineHTTP_CODE_REQUEST_TIMEOUT   408
 The server timed out waiting for the request to complete.
#defineHTTP_CODE_REQUEST_TOO_LARGE   413
 The request is too large for the server to process.
#defineHTTP_CODE_REQUEST_URL_TOO_LARGE   414
 The request URI is too long for the server to process.
#defineHTTP_CODE_RESET   205
 The request has completed with no content.
#defineHTTP_CODE_SEE_OTHER   303
 The requested URI can be found at another URI location.
#defineHTTP_CODE_SERVICE_UNAVAILABLE   503
 The server is currently unavailable or overloaded.
#defineHTTP_CODE_SWITCHING   101
 Switching protocols.
#defineHTTP_CODE_TEMPORARY_REDIRECT   307
 The request should be repeated at another URI location.
#defineHTTP_CODE_UNAUTHORIZED   401
 Authentication for the request has failed.
#defineHTTP_CODE_UNSUPPORTED_MEDIA_TYPE   415
 The request media type is not supported by the server or resource.
#defineHTTP_CODE_USE_PROXY   305
 The requested resource must be accessed via the location proxy.
#defineHTTP_COMPLETE_URI   0x1
 Complete all missing URI fields.
#defineHTTP_COMPLETE_URI_PATH   0x2
 Complete missing URI path.
#defineHTTP_COOKIE_HTTP   0x2
 Flag for Set-Cookie httponly.
#defineHTTP_COOKIE_SECURE   0x1
 Flag for Set-Cookie for SSL only.
#defineHTTP_COUNTER_ACTIVE_CLIENTS   0
 Active unique client IP addresses.
#defineHTTP_COUNTER_ACTIVE_CONNECTIONS   1
 Active connections per client.
#defineHTTP_COUNTER_ACTIVE_PROCESSES   3
 Total processes for server.
#defineHTTP_COUNTER_ACTIVE_REQUESTS   2
 Active requests per client.
#defineHTTP_COUNTER_BAD_REQUEST_ERRORS   4
 Bad request format errors.
#defineHTTP_COUNTER_ERRORS   5
 All errors.
#defineHTTP_COUNTER_LIMIT_ERRORS   6
 Limit violation errors.
#defineHTTP_COUNTER_MEMORY   7
 Total application memory for server.
#defineHTTP_COUNTER_NETWORK_IO   8
 Network I/O.
#defineHTTP_COUNTER_NOT_FOUND_ERRORS   9
 URI not found errors.
#defineHTTP_COUNTER_REQUESTS   10
 Request count.
#defineHTTP_COUNTER_SSL_ERRORS   11
 SSL upgrade errors.
#defineHTTP_CREATE_ENV   0x80
 Must create env for this request.
#defineHTTP_DELAY_SERVICE   0
 Delay servicing the queue.
#defineHTTP_DELETE   0x1
 DELETE method.
#defineHTTP_DENY_ALLOW   0x2
 Run deny checks before allow checks.
#defineHTTP_EVENT_APP_CLOSE   6
 The request is now closed.
#defineHTTP_EVENT_DESTROY   5
 The connection is being closed and destroyed.
#defineHTTP_EVENT_ERROR   4
 The request has an error.
#defineHTTP_EVENT_MAX   8
 Maximum event plus one.
#defineHTTP_EVENT_READABLE   2
 The request has data available for reading.
#defineHTTP_EVENT_STATE   1
 Notifier events.
#defineHTTP_EVENT_WRITABLE   3
 The request is now writable (post / put data).
#defineHTTP_EXPECT_CONTINUE   0x1000
 Client expects an HTTP 100 Continue response.
#defineHTTP_GET   0x2
 GET method.
#defineHTTP_HEAD   0x4
 HEAD method.
#defineHTTP_HOST_ATTACHED   0x100
 Host name attached to an endpoint.
#defineHTTP_HOST_NO_TRACE   0x10
 Host flag to disable the of TRACE HTTP method.
#defineHTTP_HOST_WILD_CONTAINS   0x40
 Host name contains the host name.
#defineHTTP_HOST_WILD_REGEXP   0x80
 Host name is a regular expression.
#defineHTTP_HOST_WILD_STARTS   0x20
 Host name starts with pattern.
#defineHTTP_IF_MODIFIED   0x100
 If-[un]modified-since supplied.
#defineHTTP_LANG_AFTER   0x2
 Insert suffix after extension.
#defineHTTP_LANG_BEFORE   0x1
 Insert suffix before extension.
#defineHTTP_MAX_QUEUE   2
 Number of queue types.
#defineHTTP_MAX_SECRET   16
 Size of secret data for auth.
#defineHTTP_MORE   0x1000
 Flag for httpSendBlock to indicate there are more frames for this message.
#defineHTTP_NEW_DISPATCHER   0x1
 New dispatcher for each connection.
#defineHTTP_NON_BLOCK   0x2
 Flag for httpSendBlock and httpWriteBlock to indicate non-blocking operation.
#defineHTTP_OPTIONS   0x8
 OPTIONS method.
#defineHTTP_PACKET_DATA   0x4
 Packet contains actual content data.
#defineHTTP_PACKET_END   0x8
 End of stream packet.
#defineHTTP_PACKET_HEADER   0x1
 Packet contains HTTP headers.
#defineHTTP_PACKET_RANGE   0x2
 Packet is a range boundary packet.
#defineHTTP_PACKET_SOLO   0x10
 Don't join this packet.
#defineHTTP_POST   0x10
 Post method.
#defineHTTP_PUT   0x20
 PUT method.
#defineHTTP_QUEUE_ALL   0x8
 Queue has all the data there is and will be.
#defineHTTP_QUEUE_EOF   0x20
 Queue at end of data.
#defineHTTP_QUEUE_OPEN_TRIED   0x1
 Queue's open routine has been called.
#defineHTTP_QUEUE_OPENED   0x2
 Queue's open routine has been called.
#defineHTTP_QUEUE_READY   0x80
 Handler stage ready routine called.
#defineHTTP_QUEUE_RESERVICE   0x100
 Queue requires reservicing.
#defineHTTP_QUEUE_RX   1
 Receive (read from client) queue.
#defineHTTP_QUEUE_SERVICED   0x10
 Queue has been serviced at least once.
#defineHTTP_QUEUE_STARTED   0x40
 Handler stage start routine called.
#defineHTTP_QUEUE_SUSPENDED   0x4
 Queue's service routine is suspended due to flow control.
#defineHTTP_QUEUE_TX   0
 Send (transmit to client) queue.
#defineHTTP_RETRIES   3
 Default number of retries for client requests.
#defineHTTP_ROUTE_CORS   0x40
 Cross-Origin resource sharing.
#defineHTTP_ROUTE_DOTNET_DIGEST_FIX   0x2000
 NET digest auth omits query in MD5.
#defineHTTP_ROUTE_ENV_ESCAPE   0x1000
 Escape env vars.
#defineHTTP_ROUTE_FREE   0x2
 Free Route.mdata back to malloc when route is freed.
#defineHTTP_ROUTE_FREE_PATTERN   0x4
 Free Route.patternCompiled back to malloc when route is freed.
#defineHTTP_ROUTE_HIDDEN   0x800
 Hide this route in route tables.
#defineHTTP_ROUTE_HOSTED   0x10000
 Route being hosted (appweb).
#defineHTTP_ROUTE_NO_LISTEN   0x20000
 Not listening on endpoints.
#defineHTTP_ROUTE_NOT   0x1
 Negate the route pattern test result.
#defineHTTP_ROUTE_OK   0
 The route matches the request.
#defineHTTP_ROUTE_OMIT_FILTER   1
 Omit filter.
#defineHTTP_ROUTE_OWN_LISTEN   0x80000
 Override listening endpoints.
#defineHTTP_ROUTE_PERSIST_COOKIE   0x40000
 Persist session cookie to disk.
#defineHTTP_ROUTE_PRESERVE_FRAMES   0x400
 Preserve WebSocket frame boundaries.
#defineHTTP_ROUTE_RAW   0x8
 Don't html encode the write data.
#defineHTTP_ROUTE_REDIRECT   0x4000
 Redirect secureCondition.
#defineHTTP_ROUTE_REJECT   1
 The route does not match the request.
#defineHTTP_ROUTE_REROUTE   2
 Request has been modified and must be re-routed.
#defineHTTP_ROUTE_SHOW_ERRORS   0x100
 Show errors to the client.
#defineHTTP_ROUTE_STARTED   0x10
 Route initialized.
#defineHTTP_ROUTE_STEALTH   0x80
 Stealth mode.
#defineHTTP_ROUTE_STRICT_TLS   0x8000
 Emit Strict-Transport-Security header.
#defineHTTP_ROUTE_UTILITY   0x100000
 Route hosted by a utility.
#defineHTTP_ROUTE_VISIBLE_SESSION   0x200
 Create a session cookie visible to client Javascript.
#defineHTTP_ROUTE_XSRF   0x20
 Generate XSRF tokens.
#defineHTTP_SCHEDULE_QUEUE   1
 Schedule the queue for service.
#defineHTTP_SERVER_SIDE   0x2
 Initialize the server-side support.
#defineHTTP_SESSION_COOKIE   "-http-session-"
 Session cookie name.
#defineHTTP_SESSION_IP   "__IP__"
 Connection IP address - prevents session hijack.
#defineHTTP_SESSION_USERNAME   "__USERNAME__"
 Username variable.
#defineHTTP_STAGE_AUTO_DIR   0x10000
 Want auto directory redirection.
#defineHTTP_STAGE_CONNECTOR   0x1000
 Stage is a connector.
#defineHTTP_STAGE_FILTER   0x4000
 Stage is a filter.
#defineHTTP_STAGE_HANDLER   0x2000
 Stage is a handler.
#defineHTTP_STAGE_INTERNAL   0x100000
 Internal stage - hidden.
#defineHTTP_STAGE_MODULE   0x8000
 Stage is a filter.
#defineHTTP_STAGE_RX   0x40000
 Stage to be used in the Rx direction.
#defineHTTP_STAGE_TX   0x80000
 Stage to be used in the Tx direction.
#defineHTTP_STAGE_UNLOADED   0x20000
 Stage module library has been unloaded.
#defineHTTP_STATE_BEGIN   1
 Ready for a new request.
#defineHTTP_STATE_COMPLETE   9
 Request complete.
#defineHTTP_STATE_CONNECTED   2
 Connection received or made.
#defineHTTP_STATE_CONTENT   5
 Reading posted content.
#defineHTTP_STATE_FINALIZED   8
 Input received, request processed and response transmitted.
#defineHTTP_STATE_FIRST   3
 First request line has been parsed.
#defineHTTP_STATE_PARSED   4
 Headers have been parsed, handler can start.
#defineHTTP_STATE_READY   6
 Handler ready - all body data received.
#defineHTTP_STATE_RUNNING   7
 Handler running.
#defineHTTP_TIMER_PERIOD   1000
 HttpTimer checks ever 1 second.
#defineHTTP_TRACE   0x40
 TRACE method.
#defineHTTP_TRACE_MAX_SIZE   (10 * 1024)
 Default maximum body size to trace.
#defineHTTP_TRACE_MIN_LOG_SIZE   (10 * 1024)
 Minimum log file size.
#defineHTTP_TX_HAS_FILTERS   0x100
 Has output filters.
#defineHTTP_TX_HEADERS_CREATED   0x2
 Response headers have been created.
#defineHTTP_TX_NO_BODY   0x1
 No transmission body, only send headers.
#defineHTTP_TX_NO_CHECK   0x10
 Do not check if the filename is inside the route documents directory.
#defineHTTP_TX_NO_LENGTH   0x20
 Do not emit a content length (used for TRACE).
#defineHTTP_TX_NO_MAP   0x40
 Do not map the filename to compressed or minified alternatives.
#defineHTTP_TX_PIPELINE   0x80
 Created Tx pipeline.
#defineHTTP_TX_SENDFILE   0x4
 Relay output via send connector.
#defineHTTP_TX_USE_OWN_HEADERS   0x8
 Skip adding default headers.
#defineME_HTTP_BAN_PERIOD   (5 * 60 * 1000)
 Default ban IP period.
#defineME_HTTP_DEFAULT_METHODS   "GET,POST"
 Default methods for routes.
#defineME_HTTP_DELAY   (2000)
 2 second delay per request - while delay enforced.
#defineME_HTTP_DELAY_PERIOD   (5 * 60 * 1000)
 Default delay IP period.
#defineME_HTTP_MONITOR_PERIOD   (15 * 1000)
 Monitor prune period.
#defineME_HTTP_REMEDY_TIMEOUT   (60 * 1000)
 Default remedy command timeout.
#defineME_HTTP_SOFTWARE   "Embedthis-http"
 Default Http protocol name used in Http Server header.
#defineME_MAX_CACHE_DURATION   (86400 * 1000)
 Default cache lifespan to 1 day.
#defineME_MAX_CACHE_ITEM   (256 * 1024)
 Maximum cachable item size.
#defineME_MAX_CHUNK   (8 * 1024)
 Maximum chunk size for transfer chunk encoding.
#defineME_MAX_CLIENTS   32
 Maximum unique client IP addresses.
#defineME_MAX_CLIENTS_HASH   131
 Hash table for client IP addresses.
#defineME_MAX_CONNECTIONS   50
 Maximum concurrent client endpoints.
#defineME_MAX_HEADERS   8192
 Maximum size of the headers (8K).
#defineME_MAX_INACTIVITY_DURATION   (30 * 1000)
 Default keep connection alive between requests timeout (30 sec).
#defineME_MAX_IOVEC   16
 Number of fragments in a single socket write.
#defineME_MAX_KEEP_ALIVE   400
 Maximum requests per connection.
#defineME_MAX_NUM_HEADERS   64
 Maximum number of header lines.
#defineME_MAX_PARSE_DURATION   (5 * 1000)
 Default request parse header timeout (5 sec).
#defineME_MAX_PING_DURATION   (30 * 1000)
 WSS ping defeat Keep-Alive timeouts (30 sec).
#defineME_MAX_PROCESSES   10
 Maximum concurrent processes.
#defineME_MAX_REQUEST_DURATION   (5 * 60 * 1000)
 Default request timeout (5 minutes).
#defineME_MAX_REQUESTS_PER_CLIENT   20
 Maximum concurrent requests per client.
#defineME_MAX_REWRITE   20
 Maximum URI rewrites.
#defineME_MAX_ROUTE_MAP_HASH   17
 Size of the route mapping hash.
#defineME_MAX_ROUTE_MATCHES   32
 Maximum number of submatches in routes.
#defineME_MAX_RX_BODY   (512 * 1024)
 Maximum incoming body size (512K).
#defineME_MAX_RX_FORM   (512 * 1024)
 Maximum incoming form size (512K).
#defineME_MAX_SESSION_DURATION   (5 * 60 * 1000)
 Default session inactivity timeout (5 mins).
#defineME_MAX_SESSION_HASH   31
 Hash table for session data.
#defineME_MAX_SESSIONS   100
 Maximum concurrent sessions.
#defineME_MAX_TX_BODY   HTTP_UNLIMITED
 Maximum buffer for response data.
#defineME_MAX_UPLOAD   HTTP_UNLIMITED
 Maximum file upload size.
#defineME_MAX_URI   512
 Reasonable URI size.
#defineME_MAX_WSS_FRAME   (4 * 1024)
 Default max WebSockets message frame size.
#defineME_MAX_WSS_MESSAGE   (2147483647)
 Default max WebSockets message size (2GB).
#defineME_MAX_WSS_PACKET   (8 * 1024)
 Default size to provide to application in one packet.
#defineME_MAX_WSS_SOCKETS   25
 Default max WebSockets.
#defineME_XSRF_COOKIE   "XSRF-TOKEN"
 CSRF token cookie name.
#defineME_XSRF_HEADER   "X-XSRF-TOKEN"
 CSRF token name in Http headers.
#defineME_XSRF_PARAM   "-xsrf-"
 CSRF parameter in form fields.
#defineWS_MAX_CONTROL   125
 Maximum bytes in control message.
#defineWS_MSG_BINARY   0x2
 httpSendBlock type for binary messages.
#defineWS_MSG_CLOSE   0x8
 httpSendBlock type for close message.
#defineWS_MSG_CONT   0x0
 Continuation of WebSocket message.
#defineWS_MSG_CONTROL   0x8
 Start of control messages.
#defineWS_MSG_MAX   0xB
 Max message type for httpSendBlock.
#defineWS_MSG_PING   0x9
 httpSendBlock type for ping messages.
#defineWS_MSG_PONG   0xA
 httpSendBlock type for pong messages.
#defineWS_MSG_TEXT   0x1
 httpSendBlock type for text messages.
#defineWS_STATE_CLOSED   3
 WebSocket is closed.
#defineWS_STATE_CLOSING   2
 WebSocket is closing.
#defineWS_STATE_CONNECTING   0
 WebSocket connection is being established.
#defineWS_STATE_OPEN   1
 WebSocket handsake is complete and ready for communications.
#defineWS_STATUS_COMMS_ERROR   1006
 TCP/IP communications error.
#defineWS_STATUS_FRAME_TOO_LARGE   1004
 Reserved.
#defineWS_STATUS_GOING_AWAY   1001
 Endpoint is going away.
#defineWS_STATUS_INTERNAL_ERROR   1011
 Server terminating due to an internal error.
#defineWS_STATUS_INVALID_UTF8   1007
 Text message has invalid UTF-8.
#defineWS_STATUS_MAX   5000
 Maximum error status (less one).
#defineWS_STATUS_MESSAGE_TOO_LARGE   1009
 Message is too large.
#defineWS_STATUS_MISSING_EXTENSION   1010
 Unsupported WebSockets extension.
#defineWS_STATUS_NO_STATUS   1005
 No status was received from the peer in closing.
#defineWS_STATUS_OK   1000
 Normal closure.
#defineWS_STATUS_POLICY_VIOLATION   1008
 Application level policy violation.
#defineWS_STATUS_PROTOCOL_ERROR   1002
 WebSockets protocol error.
#defineWS_STATUS_TLS_ERROR   1015
 TLS handshake error.
#defineWS_STATUS_UNSUPPORTED_TYPE   1003
 Unsupported message data type.
#defineWS_VERSION   13
 Current WebSocket specification version.

Http

Http

Http service object.

Description:
Configuration is not thread safe and must occur at initialization time when the application is single threaded. If the configuration is modified when the application is multithreaded, all requests must be first be quiesced.
See Also:
HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
API Stability:
Internal.
Fields:
struct HttpStage *actionHandler Action handler.
intactiveProcesses Count of active external processes.
MprHash *addresses Monitored per-IP-address counters.
MprHash *authStores Available password stores.
MprHash *authTypes Available authentication protocol types.
MprTimebooted Time the server started.
struct HttpStage *cacheFilter Cache filter.
struct HttpStage *cacheHandler Cache filter.
struct HttpStage *cgiConnector CGI connector.
struct HttpStage *cgiHandler CGI handler.
struct HttpStage *chunkFilter Chunked transfer encoding filter.
struct HttpStage *clientHandler Client-side handler (dummy).
struct HttpLimits *clientLimits Client resource limits.
struct HttpRoute *clientRoute Default route for clients.
MprList *connections Currently open connection requests.
void *context Embedding context.
MprList *counters List of counters.
char *currentDate Date string for HTTP response headers.
MprTickscurrentTime When currentDate was last calculated (ticks).
MprHash *dateCache Cache of date modified times.
char *defaultClientHost Default ip address.
intdefaultClientPort Default port.
MprHash *defenses List of Defenses.
struct HttpStage *dirHandler Directory listing handler.
struct HttpStage *egiHandler Embedded Gateway Interface (EGI) handler.
struct HttpStage *ejsHandler Ejscript Web Framework handler.
MprList *endpoints Currently configured listening endpoints.
HttpEnvCallbackenvCallback SetEnv callback.
struct HttpStage *espHandler ESP Web Framework handler.
struct HttpStage *fileHandler Static file handler.
intflags Open flags.
MprForkCallbackforkCallback Callback in child after fork().
intgid Group Id.
cchar *group O/S application group name.
intgroupChanged Group name changed.
MprList *hosts List of host objects.
HttpListenCallbacklistenCallback Invoked when creating listeners.
cchar *localPlatform Local (dev) platform os-arch-profile (lower case).
MprTicksmonitorPeriod Minimum monitor period.
MprList *monitors List of monitors.
intmonitorsStarted Monitors are running.
MprMutex *mutex Multithread sync.
struct HttpStage *netConnector Default network connector.
intnextAuth Auth object version vector.
MprTicksnow Current time in ticks.
MprHash *parsers Table config parser callbacks.
struct HttpStage *passHandler Pass through handler.
struct HttpStage *phpHandler PHP through handler.
cchar *platform Target platform os-arch-profile (lower case).
cchar *platformDir Path to platform directory containing binaries.
char *protocol Default client protocol: HTTP/1.0 or HTTP/1.1.
char *proxyHost Proxy ip address.
intproxyPort Proxy port.
struct HttpStage *rangeFilter Ranged requests filter.
MprHash *remedies List of Defense Remedies.
HttpRequestCallbackrequestCallback Request completion callback.
MprHash *routeConditions Http route condition functions.
MprHash *routeSets Http route sets functions.
MprHash *routeTargets Http route target functions.
MprHash *routeUpdates Http route update functions.
char *secret Random bytes for authentication.
struct HttpStage *sendConnector Optimized sendfile connector.
struct HttpLimits *serverLimits Server resource limits.
MprCache *sessionCache Session state cache.
char *software Software name and version.
MprHash *stages Possible stages in connection pipelines.
intstartLevel Start endpoint trace level.
intstaticLink Target platform is using a static linking.
MprHash *statusCodes Http status codes.
MprEvent *timer Admin service timer.
MprEvent *timestamp Timestamp timer.
uint64totalConnections Total connections accepted.
uint64totalRequests Total requests served.
HttpTrace *trace Default tracing configuration.
inttraceLevel Current request trace level.
intuid User Id.
struct HttpStage *uploadFilter Upload filter.
cchar *user O/S application user name.
intuserChanged User name changed.
struct HttpStage *webSocketFilter WebSocket filter.
void httpAddOption (MprHash *options, cchar *field, cchar *value)

Add an option to the options table.

Parameters:
optionsOption table returned from httpGetOptions.
fieldField key name.
valueValue to use for the field.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpApplyChangedGroup ()

Apply the changed group ID.

Description:
Apply configuration changes and actually change the group id.
Returns:
Zero if successful, otherwise a negative Mpr error code. See the Appweb log for diagnostics.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpApplyChangedUser ()

Apply the changed user ID.

Description:
Apply configuration changes and actually change the user id.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpApplyUserGroup ()

Apply the changed user and group ID.

Description:
Apply configuration changes and actually change the user and group id.
Returns:
Zero if successful, otherwise a negative Mpr error code. See the Appweb log for diagnostics.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
bool httpConfigure (HttpConfigureProc proc, void *arg, MprTicks timeout)

Alter the configuration by first quiescing all Http activity.

This waits until there are no open connections and then invokes the configuration callback while blocking further connections. When the callback completes, connections are resumed with the new configuration. This callback is required because configuration of the Http engine must be done when single-threaded
Parameters:
procFunction of the type HttpConfigureProc.
argReference argument to pass to the callback proc. Can be a managed or an unmanaged reference.
timeoutTimeout in milliseconds to wait. Set to -1 to use the default server inactivity timeout. Set to zero to wait forever.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
Http * httpCreate (int flags)

Create a Http service object.

Description:
Create a http service object. One http service object should be created per application.
Parameters:
flagsSet to zero to initialize bo Initialize the client-side support only.
Returns:
The http service object.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpDestroy ()

Destroy the Http service.

Description:
This routine is invoked as the final stage in shutting down the http service. It stops the request timeout timer and releases all http memory.
API Stability:
Internal.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void * httpGetContext ()

Get the http context object.

Returns:
The http context object defined via httpSetContext.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
char * httpGetDateString (MprPath *sbuf)

Get the time as an ISO date string.

Parameters:
sbufOptional path buffer. If supplied, the modified time of the path is used. If NULL, then the current time is used.
Returns:
RFC822 formatted date string.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void * httpGetOption (MprHash *options, cchar *field, cchar *defaultValue)

Extract a field value from an option string.

Parameters:
optionsOption string of the form: "field='value' field='value'...".
fieldField key name.
defaultValueValue to use if "field" is not found in options.
Returns:
Option value.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
MprHash * httpGetOptionHash (MprHash *options, cchar *field)

Get an option value that is itself an object (hash).

Description:
This returns an option value that is an instance of MprHash. When deserializing a JSON option string which contains multiple levels, this routine can be used to extract lower option container values.
Parameters:
optionsOptions object to examine.
fieldProperty to return.
Returns:
An MprHash instance for the given field. This will contain option sub-properties.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
MprHash * httpGetOptions (cchar *options)

Convert an options string into an options table.

Parameters:
optionsOption string of the form: "{field:'value', field:'value'}" This is a sub-set of the JSON syntax. Arrays are not supported.
Returns:
Options table.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpGetUserGroup ()
int httpInitParser ()

Initialize the Http configuration parser.

Returns:
Zero if successful, otherwise a negative Mpr error code. See the Appweb log for diagnostics.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpInsertOption (MprHash *options, cchar *field, cchar *value)

Add an option to the options table.

Description:
If the field already exists, the added value is inserted prior to the existing value.
Parameters:
optionsOption table returned from httpGetOptions.
fieldField key name.
valueValue to use for the field.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
struct HttpEndpoint * HttpEndpoint* httpLookupEndpoint (cchar *ip, int port)

Lookup a listening endpoint.

Parameters:
ipListening IP address to look for.
portListening port number.
Returns:
HttpEndpoint object.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
struct HttpHost * HttpHost* httpLookupHost (cchar *name)

Lookup a host by name.

Parameters:
nameThe name of the host to find.
Returns:
The corresponding host object.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
cchar * httpLookupStatus (int status)

Lookup a Http status code.

Description:
Lookup the code and return the corresponding text message briefly expaining the status.
Parameters:
statusHttp status code.
Returns:
Text message corresponding to the status code.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
bool httpOption (MprHash *options, cchar *field, cchar *value, int useDefault)

Test a field value from an option string.

Parameters:
optionsOption string of the form: "field='value' field='value'...".
fieldField key name.
valueTest if the field is set to this value.
useDefaultIf true and "field" is not found in options, return true.
Returns:
Allocated value string.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpParsePlatform (cchar *platform, cchar **os, cchar **arch, cchar **profile)

Parse a platform string.

Parameters:
platformThe platform string. Must be of the form: os-arch-profile.
osParsed O/S portion.
archParsed architecture portion.
profileParsed profile portion.
Returns:
Zero if successful, otherwise a negative Mpr error code.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpRemoveOption (MprHash *options, cchar *field)

Remove an option.

Description:
Remove a property from an options hash.
Parameters:
optionsOptions table returned from httpGetOptions.
fieldProperty field to remove.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpSetContext (void *context)
void httpSetDefaultClientHost (cchar *host)

Define a default client host.

Description:
Define a default host to use for client connections if the URI does not specify a host.
Parameters:
hostHost or IP address.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpSetDefaultClientPort (int port)

Define a default client port.

Description:
Define a default port to use for client connections if the URI does not define a port.
Parameters:
portInteger port number.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpSetGroupAccount (cchar *group)

Set the group account.

Description:
Define the group account name under which to run the process.
Parameters:
groupGroup name. Must be defined in the system group database.
Returns:
Zero if successful, otherwise a negative Mpr error code.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpSetOption (MprHash *options, cchar *field, cchar *value)

Set an option.

Description:
Set a property in an options hash.
Parameters:
optionsOptions table returned from httpGetOptions.
fieldProperty field to set.
valueProperty value to use.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpSetPlatform (cchar *platform)

Set platform description.

Description:
Some web frameworks need to recompile sources before serving requests (ESP). These need access to the http libraries to link with.
Parameters:
platformPlatform string of the form: OS-ARCH-PROFILE.
Returns:
Zero if the platform string parses, otherwise a negative Mpr error code.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
int httpSetPlatformDir (cchar *platform)

Set platform directory location.

Description:
Set the platform directory location which contains libraries and headers for the application.
Parameters:
platformPath to the platform directory.
Returns:
Zero if successful, otherwise a negative Mpr error code.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpSetProxy (cchar *host, int port)

Define a Http proxy host to use for all client connect requests.

Description:
Define a http proxy host to communicate via when accessing the net.
Parameters:
hostProxy host name or IP address.
portProxy host port number.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetSoftware
void httpSetSoftware (cchar *description)

Set the software description.

Parameters:
descriptionString describing the Http software. By default, this is set to HTTP_NAME.
API Stability:
Stable.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy
int httpSetUserAccount (cchar *user)

Set the user account.

Description:
Define the user account name under which to run the process.
Parameters:
userUser name. Must be defined in the system password database.
Returns:
Zero if successful, otherwise a negative Mpr error code.
API Stability:
Evolving.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware
void httpStopConnections (void *data)

Stop all connections owned by the data handle.

Description:
This routine may be called by services to destory all connections owned by the service. It calls httpDestroyConnection on all owned connections. This call must only be made on the same dispatcher used by ALL the connections.
Parameters:
dataHttpConn data value to search for in current connections.
API Stability:
Internal.
See Also:
Http, HttpConn, HttpEndpoint, httpConfigure, httpCreate, httpGetContext, httpGetDateString, httpLookupEndpoint, httpLookupStatus, httpSetContext, httpSetDefaultClientHost, httpSetDefaultClientPort, httpSetForkCallback, httpSetProxy, httpSetSoftware

HttpAuth

HttpAuth

Authorization.

Description:
HttpAuth is the foundation authorization object and is used by HttpRoute. It stores the authorization configuration information required to determine if a client request should be permitted access to a given resource.
See Also:
HttpAskLogin, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
API Stability:
Internal.
Fields:
MprHash *abilities Set of required abilities (all are required).
MprHash *allow Clients to allow.
char *cipher Encryption cipher.
MprHash *deny Clients to deny.
intflags Authorization flags.
char *loggedInPage Target URI after logging in.
char *loggedOutPage Target URI after logging out.
char *loginPage Web page for user login for 'form' type.
struct HttpAuth *parent Parent auth.
MprHash *permittedUsers Set of valid users.
char *qop Quality of service.
char *realm Realm of access.
MprHash *roles Hash of roles.
HttpAuthStore *store Authorization password backend (system|file|custom).
HttpAuthType *type Authorization protocol type (basic|digest|form|custom).
MprHash *userCache Cache of authenticated users.
char *username Automatic login username. Password not required if defined.
HttpVerifyUserverifyUser Password verification.
HttpRole * httpAddRole (HttpAuth *auth, cchar *role, cchar *abilities)

Add a role.

If the role already exists, the role is updated
Description:
This creates the role with given abilities. Ability words can also be other roles.
Parameters:
authAuth object allocated by httpCreateAuth
roleRole name to add.
abilitiesSpace separated list of abilities.
Returns:
Allocated role object.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
HttpUser * httpAddUser (HttpAuth *auth, cchar *user, cchar *password, cchar *abilities)

Add a user.

If the user already exists, the user is updated
Description:
This creates the user and adds the user to the authentication database.
Parameters:
authAuth object allocated by httpCreateAuth
userUser name to add.
passwordUser password. The password should not be encrypted. The backend will encrypt as required.
abilitiesSpace separated list of abilities.
Returns:
The User object allocated or NULL for an error.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
bool httpCanUser (HttpConn *conn, cchar *abilities)

Test if a user has the required abilities.

Parameters:
connHttpConn connection object created via httpCreateConn object.
abilitiesComma separated list of abilities to test for. If null, then use the required abilities defined for the current request route.
Returns:
True if the user has all the required abilities.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpComputeAllUserAbilities (HttpAuth *auth)
void httpComputeUserAbilities (HttpAuth *auth, HttpUser *user)
HttpAuth * httpCreateAuth ()
HttpAuthStore * httpCreateAuthStore (cchar *name, HttpVerifyUser verifyUser)

Add an authorization store for password validation.

The pre-supplied types are "config" and "system"
Description:
This creates an AuthType object with the defined name and callbacks.
Parameters:
nameUnique authorization type name.
verifyUserCallback to verify the username and password contained in the HttpConn object passed to the callback.
Returns:
Auth store if successful, otherwise zero.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
int httpCreateAuthType (cchar *name, HttpAskLogin askLogin, HttpParseAuth parse, HttpSetAuth setAuth)

Create an authorization protocol type.

The pre-supplied types are 'basic', 'digest' and 'form'
Description:
This creates an AuthType with the defined name and callbacks. The basic and digest types are supported by most browsers. The form type is implemented via web form requests over HTTP.
Parameters:
nameUnique authorization type name.
askLoginCallback to generate a client login response.
parseCallback to parse the HTTP authentication headers.
setAuthCallback to set the HTTP response authentication headers.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
bool httpIsAuthenticated (HttpConn *conn)
bool httpLogin (HttpConn *conn, cchar *username, cchar *password)

Log the user in.

Description:
This will verify the supplied username and password. If the user is successfully logged in, the user identity will be stored in session state for fast authentication on subsequent requests. Note: this does not verify any user abilities.
Parameters:
connHttpConn connection object.
usernameUser name to authenticate.
passwordPassword for the user.
Returns:
True if the username and password have been authenticated.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpLogout (HttpConn *conn)
HttpRole * httpLookupRole (HttpAuth *auth, cchar *name)
HttpUser * httpLookupUser (HttpAuth *auth, cchar *name)

Lookup a user by username.

Description:
This looks up a user in the internal user store. This is only used i.
Parameters:
authHttpAuth object. Stored in HttpConn.rx.route.auth.
nameUsername.
Returns:
User object.
API Stability:
Evolving.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
int httpRemoveRole (HttpAuth *auth, cchar *role)
int httpRemoveUser (HttpAuth *auth, cchar *user)
void httpSetAuthAllow (HttpAuth *auth, cchar *ip)
void httpSetAuthAnyValidUser (HttpAuth *auth)
void httpSetAuthDeny (HttpAuth *auth, cchar *ip)
void httpSetAuthFormDetails (struct HttpRoute *route, cchar *loginPage, cchar *loginService, cchar *logoutService, cchar *loggedInPage, cchar *loggedOutPage)

Define login service URLs for use with "form" authentication.

Description:
This defines the login form URL and login/out service URLs. Set arguments to null if they are not required because the application is implementing its own redirection management during login. This API should not be used for web frameworks like ESP or PHP that define their own login/out services.
Parameters:
routeRoute from which to inherit when creating a route for the login pages and services.
loginPageWeb page URI for the user to enter username and password.
loginServiceURI to use for the internal login service. To use your own login URI, set to this the empty string.
logoutServiceURI to use to log the user out. To use your won logout URI, set this to the empty string.
loggedInPageThe client is redirected to this URI once logged in. Use a "referrer:" prefix to the URI to redirect the user to the referring URI before the loginPage. If the referrer cannot be determined, the base URI is utilized.
loggedOutPageThe client is redirected to this URI once logged in. Use a "referrer:" prefix to the URI to redirect the user to the referring URI before the loginPage. If the referrer cannot be determined, the base URI is utilized.
API Stability:
Evolving.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpSetAuthLogin (HttpAuth *auth, cchar *uri)

Define the login page for use with authentication.

Parameters:
authAuthorization object allocated by httpCreateAuth
uriURI for the login page. Can use "https:///page" to specify the SSL protocol with the current domain.
API Stability:
Evolving.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpSetAuthOrder (HttpAuth *auth, int order)
void httpSetAuthPermittedUsers (HttpAuth *auth, cchar *users)
void httpSetAuthQop (HttpAuth *auth, cchar *qop)

Set the required quality of service for digest authentication.

Description:
This configures the basic or digest authentication for the auth object.
Parameters:
authAuth object allocated by httpCreateAuth
qopQuality of service description.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpSetAuthRealm (HttpAuth *auth, cchar *realm)

Set the required realm for basic or digest authentication.

Description:
This configures the authentication realm. The realm is displayed to the user in the browser login dialog box.
Parameters:
authAuth object allocated by httpCreateAuth
realmAuthentication realm.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
void httpSetAuthRequiredAbilities (HttpAuth *auth, cchar *abilities)
void httpSetAuthSession (HttpAuth *auth, bool noSession)

Control whether a session and session cookie will be created for user logins for this authentication route.

Description:
By default, a session and response cookie are created when a user is authenticated via httpLogin. This boosts performance because subsequent requests can supply the cookie and bypass authentication for each subseqent request. This API permits the default behavior to be suppressed and thus no cookie or session will be created.
Parameters:
authAuth object created via httpCreateAuth
noSessionSet to true to suppress creation of sessions or cookies.
API Stability:
Evolving.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
int httpSetAuthStore (HttpAuth *auth, cchar *store)
void httpSetAuthStoreSessions (HttpAuthStore *store, bool noSession)

Control whether sessions and session cookies are created for user logins.

Description:
By default, a session and response cookie are created when a user is authenticated via httpLogin. This boosts performance because subsequent requests can supply the cookie and bypass authentication for each subseqent request. This API permits the default behavior to be suppressed and thus no cookie or session will be created.
Parameters:
storeAuthStore object created via httpCreateAuthStore
noSessionSet to true to suppress creation of sessions or cookies.
API Stability:
Evolving.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType, httpSetAuthUsername
int httpSetAuthType (HttpAuth *auth, cchar *proto, cchar *details)

Set the authentication protocol type to use.

Parameters:
authAuth object allocated by httpCreateAuth
protoProtocol name to use. Select from: 'basic', 'digest', 'form' or 'none'. Set to NULL or 'none' to disable authentication.
detailsExtra protocol details.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthUsername
void httpSetAuthUsername (HttpAuth *auth, cchar *username)

Set an automatic login username.

Description:
If defined, no password is required and the user will be automatically logged in as this username.
Parameters:
authAuth object allocated by httpCreateAuth
usernameUsername to automatically login with.
API Stability:
Stable.
See Also:
HttpAskLogin, HttpAuth, HttpAuthType, HttpRole, HttpSetAuth, HttpUser, HttpVerifyUser, HttpVerifyUser, httpAddRole, httpAddUser, httpCanUser, httpComputeAllUserAbilities, httpComputeUserAbilities, httpCreateAuth, httpIsAuthenticated, httpLogin, httpRemoveRole, httpRemoveUser, httpSetAuthAllow, httpSetAuthAnyValidUser, httpSetAuthDeny, httpSetAuthLogin, httpSetAuthOrder, httpSetAuthPermittedUsers, httpSetAuthQop, httpSetAuthRealm, httpSetAuthRequiredAbilities, httpSetAuthType
void httpSetAuthVerify (HttpAuth *auth, HttpVerifyUser verifyUser)

HttpCache

HttpCache

Cache Control.

Description:
Configuration is not thread safe and must occur at initialization time when the application is single threaded. If the configuration is modified when the application is multithreaded, all requests must be first be quiesced.
See Also:
httpAddCache, httpUpdateCache
API Stability:
Internal.
Fields:
MprTicksclientLifespan Lifespan for client cached content.
MprHash *extensions Extensions to cache.
intflags Cache control flags.
MprHash *methods Methods to cache.
MprTicksserverLifespan Lifespan for server cached content.
MprHash *types MimeTypes to cache.
MprHash *uris URIs to cache.
void httpAddCache (struct HttpRoute *route, cchar *methods, cchar *uris, cchar *extensions, cchar *types, MprTicks clientLifespan, MprTicks serverLifespan, int flags)

Add caching for response content.

Description:
This call configures caching for request responses. Caching may be used for any HTTP method, though typically it is most useful for state-less GET requests. Output data may be uniquely cached for requests with different request parameters (query, post, and route parameters).

When server-side caching is requested and manual-mode is not enabled, the request response will be automatically cached. Subsequent client requests will revalidate the cached content with the server. If the server-side cached content has not expired, a HTTP Not-Modified (304) response will be sent and the client will use its client-side cached content. This results in a very fast transaction with the client as no response data is sent. Server-side caching will cache both the response headers and content.

If manual server-side caching is requested, the response will be automatically cached, but subsequent requests will require the handler to explicitly send cached content by calling httpWriteCached.

If client-side caching is requested, a 'Cache-Control' Http header will be sent to the client with the caching 'max-age' set to the lifespan argument value (converted to seconds). This causes the client to serve client-cached content and to not contact the server at all until the max-age expires. Alternatively, you can use httpSetHeader to explicitly set a 'Cache-Control' header. For your reference, here are some keywords that can be used in the Cache-Control Http header.

'max-age' Maximum time in seconds the resource is considered fresh. 's-maxage' Maximum time in seconds the resource is considered fresh from a shared cache. 'public' marks authenticated responses as cacheable. 'private' shared caches may not store the response. 'no-cache' cache must re-submit request for validation before using cached copy. 'no-store' response may not be stored in a cache. 'must-revalidate' forces clients to revalidate the request with the server. 'proxy-revalidate' similar to must-revalidate except only for proxy caches.

Use client-side caching for static content that will rarely change or for content for which using 'reload' in the browser is an adequate solution to force a refresh. Use manual server-side caching for situations where you need to explicitly control when and how cached data is returned to the client. For most other situations, use server-side caching.
Parameters:
routeHttpRoute object.
methodsList of methods for which caching should be enabled. Set to a comma or space separated list of method names. Method names can be any case. Set to null or '*' for all methods. Example: 'GET, POST'.
urisSet of URIs to cache. If the URI is set to '*' all URIs for that action are uniquely cached. If the request has POST data, the URI may include such post data in a sorted query format. E.g. {uri: /buy?item=scarf&quantity=1}.
extensionsList of document extensions for which caching should be enabled. Set to a comma or space separated list of extensions. Extensions should not have a period prefix. Set to null, '' or '*' for all extensions. Example: 'html, css, js'. The URI may include request parameters in sorted www-urlencoded format. For example: /example.esp?hobby=sailing&name=john.
typesList of document mime types for which caching should be enabled. Set to a comma or space separated list of types. The mime types are those that correspond to the document extension and NOT the content type defined by the handler serving the document. Set to null or '*' for all types. Example: image/gif, application/x-php.
clientLifespanLifespan of client cache items in milliseconds. If not set to positive integer, the lifespan will default to the route lifespan.
serverLifespanLifespan of server cache items in milliseconds. If not set to positive integer, the lifespan will default to the route lifespan.
flagsCache control flags. Select HTTP_CACHE_MANUAL to enable manual mode. In manual mode, cached content will not be automatically sent. Use httpWriteCached in the request handler to write previously cached content.

Select HTTP_CACHE_CLIENT to enable client-side caching. In this mode a 'Cache-Control' Http header will be sent to the client with the caching 'max-age'. WARNING: the client will not send any request for this URI until the max-age timeout has expired.

Select HTTP_CACHE_RESET to first reset existing caching configuration for this route.

Select HTTP_CACHE_SERVER to define the server-side caching mode.

Select HTTP_CACHE_UNIQUE to uniquely cache requests with different request parameters.
Returns:
A count of the bytes actually written.
API Stability:
Evolving.
See Also:
HttpCache, httpUpdateCache
ssize httpUpdateCache (HttpConn *conn, cchar *uri, cchar *data, MprTicks lifespan)

Update the cached content for a URI.

Parameters:
connHttpConn connection object.
uriThe request URI for which to update the cache. The URI may contain the request parameters in sorted www-urlencoded format. The URI should include any route prefix.
dataData to cache for the URI. If you wish to cache response headers, include those at the start of the data followed by an additional new line.
lifespanLifespan in milliseconds for the cached content.
API Stability:
Evolving.
See Also:
HttpCache, httpAddCache
ssize httpWriteCached (HttpConn *conn)

Write the cached content for a URI to the client.

Description:
This call explicitly writes cached content to the client. It is useful when the caching is configured in manual mode via the HTTP_CACHE_MANUAL flag to httpAddCache
Parameters:
connHttpConn connection object.
API Stability:
Evolving.
See Also:
HttpCache, httpAddCache, httpUpdateCache

HttpConn

HttpConn

Http Connections.

Description:
The HttpConn object represents a TCP/IP connection to the client. A connection object is created for each socket connection initiated by the client. One HttpConn object may service many Http requests due to HTTP/1.1 keep-alive. Each connection has a request timeout and inactivity timeout. These can be set via httpSetTimeout. The set of APIs that block and yield to the garbage collector are:
  • httpFlushQueue(, HTTP_BLOCK)
  • httpWriteBlock(, HTTP_BLOCK)
  • httpSendBlock(, HTTP_BLOCK)
  • httpRead() when in sync mode
  • httpReadBlock(, HTTP_BLOCK)
  • httpWait()
  • httpWriteUploadData
When these APIs block and yield, the garbage collector may reclaim allocated memory that does not have a managed reference. Read Appweb memory allocation at https://www.embedthis.com/appweb/doc/ref/memory.html
See Also:
HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
API Stability:
Internal.
Description:
The Action Handler provides a simple mechanism to bind 'C' callback functions with URIs.
API Stability:
Stable.
Fields:
intactiveRequest Actively servicing a request.
HttpAddress *address Per-client IP address reference.
boolasync Connection is in async mode (non-blocking).
void *authData Authorization state data.
boolauthRequested Authorization requested based on user credentials.
char *authType Type of authentication: set to basic, digest, post or a custom name.
boolborrowed Connection has been borrowed.
char *boundary File upload boundary.
HttpQueue *connectorq Connector write queue.
intconnError A connection error has occurred.
void *context Embedding context (EjsRequest).
struct HttpQueue *currentq Current queue being serviced (just for GC).
void *data Custom data for request - must be a managed reference.
intdelay Delay servicing request due to defense strategy.
booldestroyed Connection has been destroyed.
MprDispatcher *dispatcher Event dispatcher.
void *ejs Embedding VM.
boolencoded True if the password is MD5(username:realm:password).
struct HttpEndpoint *endpoint Endpoint object (if set - indicates server-side).
interror A connection and/or request error has occurred.
boolerrorDoc Processing an error document.
char *errorMsg Error message for the last request (if any).
boolfollowRedirects Follow redirects for client requests.
void *grid Current request database grid for MVC apps.
HttpHeadersCallbackheadersCallback Callback to fill headers.
void *headersCallbackArg Arg to fillHeaders.
struct HttpHost *host Host object (if relevant).
Http *http Http service object.
boolhttp10 Using legacy HTTP/1.0.
HttpPacket *input Header packet.
HttpIOCallbackioCallback I/O event callback.
char *ip Remote client IP address.
intkeepAliveCount Count of remaining Keep-Alive requests for this connection.
MprTickslastActivity Last activity on the connection.
ssizelastRead Length of new data last read into the input packet.
HttpLimits *limits Service limits. Alias to HttpRoute.limits for this request.
void *mark Reference for GC marking.
boolmustClose Peer requested the connection be closed via "Connection: close".
MprDispatcher *newDispatcher New dispatcher if using a worker thread.
HttpNotifiernotifier Connection Http state change notification callback.
MprDispatcher *oldDispatcher Original dispatcher if using a worker thread.
boolownDispatcher Own the dispatcher and should destroy when closing connection.
cchar *password Password for client requests (only).
void *pool Pool of VMs.
intport Remote port.
char *protocol HTTP protocol.
char *protocols Supported WebSocket protocols (clients).
HttpQueue *readq End of the read pipeline.
void *record Current request database record for MVC apps.
void *reqData Extended request data for use by web frameworks.
intretries Client request retries.
struct HttpRx *rx Rx object.
boolsecure Using https.
uint64seqno Unique network sequence number.
struct HttpQueue *serviceq List of queues that require service for request pipeline.
MprSocket *sock Underlying socket handle.
MprTicksstarted When the request started (ticks).
uint64startMark High resolution tick time of request.
intstate Connection state.
void *staticData Custom data for request - must be an unmanaged reference.
boolsuppressTrace Do not trace this connection.
inttimeout Connection timeout indication.
HttpTimeoutCallbacktimeoutCallback Request and inactivity timeout callback.
MprEvent *timeoutEvent Connection or request timeout event.
inttotalRequests Total number of requests serviced.
HttpTrace *trace Tracing configuration.
struct HttpTx *tx Tx object.
boolupgraded Request protocol upgraded.
struct HttpUser *user Authorized User record for access checking.
cchar *username Supplied user name.
boolworker Use worker.
MprEvent *workerEvent Event for running connection via a worker thread (used by ejs).
HttpQueue *writeq Start of the write pipeline.
void httpAfterEvent (HttpConn *conn)
void void void httpBadRequestError (HttpConn *conn, int status, cchar *fmt, ...)
void httpBorrowConn (HttpConn *conn)

Borrow a connection.

Description:
Borrow the connection from Http. This effectively gains an exclusive loan of the connection so that it cannot be destroyed while the loan is active. After the loan is complete, you must call return the connection by calling httpReturnConn. Otherwise the connection will not be freed and memory will leak.

The httpBorrowConn routine is used to stabilize a connection while interacting with some outside service. Without this routine, the connection could be destroyed while waiting. Many things can happen while waiting. For example: the client could disconnect or the connection could timeout. These events will still be serviced while the connection is borrowed, but the connection object will not be destroyed.

While borrowed, you must not access the connection using foreign / non-MPR threads. If you need to do this, use mprCreateEvent to schedule an event to run on the connection's event dispatcher. This is essential to serialize access to the connection object. Inside the event callback, you should first check the connection state via HttpConn.state to ensure the request is still active. If the request has completed, the state will be HTTP_STATE_COMPLETE.

Before returning from the event callback, you must call httpReturnConn to end the exclusive loan. This restores normal processing of the connection and enables any required I/O events.

Parameters:
connHttpConn object created via httpCreateConn
API Stability:
Deprecated.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
bool httpClientConn (HttpConn *conn)
void httpClosePipeline (HttpConn *conn)
HttpConn * httpCreateConn (struct HttpEndpoint *endpoint, MprDispatcher *dispatcher)

Create a connection object.

Description:
Most interactions with the Http library are via a connection object. It is used for server-side communications when responding to client requests and it is used to initiate outbound client requests.
Parameters:
endpointEndpoint object owning the connection.
dispatcherDisptacher to use for I/O events on the connection.
Returns:
A new connection object.
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
int httpCreateEvent (uint64 seqno, HttpEventProc callback, void *data)

Invoke a callback on a connection using a connection sequence number.

Description:
This routine invokes a callback on a connection's event dispatcher in a thread-safe manner. This API is the only safe way to invoke APIs on a connection from foreign threads.
Parameters:
seqnoHttpStream->seqno identifier extracted when running in an MPR (Appweb) thread.
callbackCallback function to invoke. The callback will always be invoked if the call is successful so that you can free any allocated resources. If the connection is destroyed before the event is run, the callback will be invoked and the "conn" argument will be set to NULL.

If is important to check the HttpStream.error and HttpStream.state in the callback to ensure the Stream is in an acceptable state for your logic. Typically you want HttpStream.state to be greater than HTTP_STATE_BEGIN and less than HTTP_STATE_COMPLETE. You may also wish to check HttpStream.error incase the connection request has errored.
dataData to pass to the callback.
Returns:
"Zero" if the connection can be found and the event is scheduled, Otherwise returns MPR_ERR_CANT_FIND.
API Stability:
Prototype.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpCreatePipeline (HttpConn *conn)
void httpCreateRxPipeline (HttpConn *conn, struct HttpRoute *route)
void httpCreateTxPipeline (HttpConn *conn, struct HttpRoute *route)
void httpDestroyConn (HttpConn *conn)

Destroy the connection object.

Description:
This call closes the connection socket, destroys the connection dispatcher, disconnects the HttpTx and HttpRx property objects and removes the connection from the HttpHost list of connections. Thereafter, the garbage collector can reclaim all memory. It may be called by client connections at any time from a top-level event running on the connection's dispatcher. Server-side code should not need to explicitly destroy the connection as it will be done automatically via httpIOEvent. This routine should not be called deep within the stack as it will zero the HttpConn.http property to signify the connection is destroyed.
Parameters:
connHttpConn object created via httpCreateConn
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpDiscardData (HttpConn *conn, int dir)
void httpDisconnect (HttpConn *conn)

Disconnect the connection's socket.

Description:
This call will close the socket and signal a connection error by setting connError. Subsequent use of the connection socket will not be possible. It will also set HttpRx.eof and will finalize the request. Used internally when a connection times out and for abortive errors. This should not be generally used. Rather, httpDestroyConn and httpError should be used in preference.
Parameters:
connHttpConn connection object created via httpCreateConn
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpEnableConnEvents (HttpConn *conn)

Enable connection events.

Description:
Connection events are automatically disabled upon receipt of an I/O event on a connection. This permits a connection to process the I/O without fear of interruption by another I/O event. At the completion of processing of the I/O request, the connection should be re-enabled via httpEnableConnEvents. This call is made for requests in httpIOEvent. Client-side connections may need to enable connection events if the are running in async mode and encounter a blocking condition.
Parameters:
connHttpConn connection object created via httpCreateConn
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpEnableUpload (HttpConn *conn)
void httpError (HttpConn *conn, int status, cchar *fmt, ...)

Error handling for the connection.

Description:
The httpError call is used to flag the current request as failed. If httpError is called multiple times, those calls are ignored and only the first call to httpError has effect. This call will discard all data in the output pipeline queues. If some data has already been written to the client the connection will be aborted so the client can get some indication that an error has occurred after the headers have been transmitted.
Parameters:
connHttpConn connection object created via httpCreateConn
statusHttp status code. The status code can be ored with the flags HTTP_ABORT to immediately abort the connection or HTTP_CLOSE to close the connection at the completion of the request.
fmtPrintf style formatted string.
...Arguments for fmt.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void HttpConn * HttpConn* httpFindConn (uint64 seqno, HttpEventProc proc, void *data)

Find a connection given a connection sequence number.

Description:
Find a connection in a thread-safe manner given a connection sequence number. Each connection has a unique 64-bit sequence number that can be used to retrieve a connection object. When using foreign threads, this is preferable as another thread may disconnect and destroy the connection at any time.

A callback may be provided which will be invoked if the connection is found before returning from the API. This should be used if utilizing this API in a foreign thread. httpFindConn will lock the connection while the callback is invoked.
Parameters:
seqnoHttpConn connection sequence number retrieved from HttpConn.seqno.
procCallback function to invoke with the signature void (*HttpEventProc)(struct HttpConn *conn, void *data);.
dataData to pass to the callback.
Returns:
The steam object reference. Returns NULL if the connection is not found. Only use this value if invoked in an MPR thread. While foreign threads using this API may return a connection reference, the connection may be destroyed before the reference can be used.
API Stability:
Prototype.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
int httpGetAsync (HttpConn *conn)
ssize httpGetChunkSize (HttpConn *conn)
void * httpGetConnContext (HttpConn *conn)
int httpGetConnEventMask (HttpConn *conn)
void * httpGetConnHost (HttpConn *conn)
cchar * httpGetError (HttpConn *conn)
char * httpGetExt (HttpConn *conn)
int httpGetKeepAliveCount (HttpConn *conn)

Get the count of Keep-Alive requests that will be used for this connection object.

Description:
Http Keep-Alive means that the TCP/IP connection is preserved accross multiple requests. This typically means much higher performance and better response. Http Keep-Alive is enabled by default for Http/1.1 (the default). Disable Keep-Alive when talking to old, broken HTTP servers.
Parameters:
connHttpConn connection object created via httpCreateConn
Returns:
The maximum count of Keep-Alive requests.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
ssize httpGetWriteQueueCount (HttpConn *conn)
void void void void void httpIO (struct HttpConn *conn, int eventMask)
void httpIOEvent (struct HttpConn *conn, MprEvent *event)
void httpLimitError (HttpConn *conn, int status, cchar *fmt, ...)
struct HttpHost * HttpHost* httpMatchHost (HttpConn *conn, cchar *hostname)
MprSsl * httpMatchSsl (MprSocket *sp, cchar *hostname)
void httpMemoryError (HttpConn *conn)
void httpNotify (HttpConn *conn, int event, int arg)
void httpPrepClientConn (HttpConn *conn, bool keepHeaders)
bool httpPumpOutput (HttpConn *conn)
bool httpQueuesNeedService (HttpConn *conn)
void httpReadyHandler (HttpConn *conn)
bool httpRequestExpired (HttpConn *conn, MprTicks timeout)

Test if a request has exceeded its timeout limits.

Description:
This tests the request against the HttpLimits.requestTimeout and HttpLimits.inactivityTimeout limits. It uses the HttpConn.started and HttpConn.lastActivity time markers.
Parameters:
connHttpConn object created via httpCreateConn
timeoutOverriding timeout in milliseconds. If timeout is zero, override default limits and wait forever. If timeout is < 0, use default connection inactivity and duration timeouts. If timeout is > 0, then use this timeout as an additional timeout.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpResetCredentials (HttpConn *conn)
void httpReturnConn (HttpConn *conn)

Return a borrowed a connection.

Description:
Returns a borrowed connection back to the Http engine. This ends the exclusive loan of the connection so that the current request can be completed. It also enables I/O events based on the current state of the connection.

While the connection is borrowed, you must not access the connection using foreign / non-MPR threads. Use mprCreateEvent to schedule an event to run on the connection's event dispatcher. This is essential to serialize access to the connection object.

You should only call this routine (once) after calling httpBorrowConn.

Parameters:
connHttpConn object created via httpCreateConn
API Stability:
Deprecated.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpRouteRequest (HttpConn *conn)
void httpScheduleConnTimeout (HttpConn *conn)

Schedule a connection timeout event on a connection.

Description:
This call schedules an event to run serialized on the connection dispatcher. When run, it will cancels the current request, disconnects the socket and issues an error to the error log. This call is normally invoked by the httpTimer which runs regularly to check for timed out requests.
Parameters:
connHttpConn connection object created via httpCreateConn
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
bool httpServerConn (HttpConn *conn)
bool httpServiceQueues (HttpConn *conn, int flags)
void httpSetAsync (HttpConn *conn, int enable)
void httpSetChunkSize (HttpConn *conn, ssize size)
void httpSetConnContext (HttpConn *conn, void *context)
void httpSetConnHost (HttpConn *conn, void *host)
void httpSetConnNotifier (HttpConn *conn, HttpNotifier notifier)

Define a notifier callback for this connection.

Description:
The notifier callback will be invoked for state changes and I/O events as Http requests are processed. The supported events are:
  • HTTP_EVENT_STATE The request is changing state. Valid states are: HTTP_STATE_BEGIN, HTTP_STATE_CONNECTED, HTTP_STATE_FIRST, HTTP_STATE_CONTENT, HTTP_STATE_READY, HTTP_STATE_RUNNING, HTTP_STATE_FINALIZED and HTTP_STATE_COMPLETE. A request will always visit all states and the notifier will be invoked for each and every state. This is true even if the request has no content, the HTTP_STATE_CONTENT will still be visited.
  • HTTP_EVENT_READABLE There is data available to read
  • HTTP_EVENT_WRITABLE The outgoing pipeline can absorb more data. The WRITABLE event is issued when the outgoing pipeline is empties and can absorb more data.
  • HTTP_EVENT_ERROR The request has encountered an error
  • HTTP_EVENT_DESTROY The connection structure is about to be destoyed
  • HTTP_EVENT_APP_OPEN The application layer is now open
  • HTTP_EVENT_APP_CLOSE The application layer is now closed
Parameters:
connHttpConn connection object created via httpCreateConn
notifierNotifier function.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpSetConnUser (HttpConn *conn, struct HttpUser *user)
void httpSetCredentials (HttpConn *conn, cchar *user, cchar *password, cchar *authType)
void httpSetFileHandler (HttpConn *conn, cchar *path)
void httpSetForkCallback (MprForkCallback proc, void *arg)
void httpSetHeadersCallback (struct HttpConn *conn, HttpHeadersCallback fn, void *arg)
void httpSetIOCallback (struct HttpConn *conn, HttpIOCallback fn)
void httpSetKeepAliveCount (HttpConn *conn, int count)

Control Http Keep-Alive for the connection.

Description:
Http Keep-Alive means that the TCP/IP connection is preserved accross multiple requests. This typically means much higher performance and better response. Http Keep-Alive is enabled by default for Http/1.1 (the default). Disable Keep-Alive when talking to old, broken HTTP servers.
Parameters:
connHttpConn connection object created via httpCreateConn
countCount of Keep-Alive transactions to use before closing the connection. Set to zero to disable keep-alive.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpSetProtocol (HttpConn *conn, cchar *protocol)
void httpSetRetries (HttpConn *conn, int retries)
void httpSetSendConnector (HttpConn *conn, cchar *path)
void httpSetState (HttpConn *conn, int state)

Set the connection state and invoke notifiers.

Description:
The connection states are, in order : HTTP_STATE_BEGIN HTTP_STATE_CONNECTED HTTP_STATE_FIRST HTTP_STATE_PARSED HTTP_STATE_CONTENT HTTP_STATE_READY HTTP_STATE_RUNNING HTTP_STATE_FINALIZED HTTP_STATE_COMPLETE. When httpSetState advances the state it will invoke any registered HttpNotifier. If the state is set to a state beyond the next intermediate state, the HttpNotifier will be invoked for all intervening states. This is true even if the request has no content, the HTTP_STATE_CONTENT will still be visited.
Parameters:
connHttpConn object created via httpCreateConn
stateNew state to enter.
API Stability:
Internal.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetTimeout, httpSetTimestamp, httpStartPipeline
void httpSetTimeout (HttpConn *conn, MprTicks requestTimeout, MprTicks inactivityTimeout)

Set the Http inactivity timeout.

Description:
Define an inactivity timeout after which the Http connection will be closed.
Parameters:
connHttpConn object created via httpCreateConn
requestTimeoutRequest timeout in msec. This is the total time for the request. Set to -1 to preserve the existing value.
inactivityTimeoutInactivity timeout in msec. This is maximum connection idle time. Set to -1 to preserve the existing value.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimestamp, httpStartPipeline
void httpSetTimestamp (MprTicks period)
void httpSetupWaitHandler (HttpConn *conn, int eventMask)
bool httpShouldRenderDirListing (HttpConn *conn)
void httpStartPipeline (HttpConn *conn)
MprSocket * httpStealSocket (HttpConn *conn)

Steal a socket from a connection.

Description:
Steal the MprSocket object from a connection so the caller can assume total responsibility for the socket. This routine returns a clone of the connection's socket object with the socket O/S handle. The handle is removed from the connection's socket object. The connection retains ownership of the original socket object. This is done to preserve the HttpConn.sock object but remove the socket handle from its management.

Note: The current request is aborted and queue data is discarded. After calling, the normal Appweb request and inactivity timeouts will not apply to the returned socket object. It is the callers responsibility to call mprCloseSocket on the returned MprSocket when ready.

An alternative to this routine is httpBorrowConn which temporarily loans the connection and secures it from destruction.
Parameters:
connHttpConn object created via httpCreateConn
Returns:
A clone of the connection's MprSocket object with the socket handle.
API Stability:
Evolving.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
Socket httpStealSocketHandle (HttpConn *conn)

Steal the O/S socket handle from the connection socket object.

Description:
This removes the O/S socket handle from active management by the connection. After calling, normal request and inactivity timeouts will apply to the connection, but will not disturb the underlying actual socket handle. It is the callers responsibility to call close() on the socket handle when ready.
Parameters:
connHttpConn object created via httpCreateConn
Returns:
The O/S Socket handle.
API Stability:
Prototype.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline
bool httpVerifyWebSocketsHandshake (HttpConn *conn)
ssize httpWriteUploadData (HttpConn *conn, MprList *formData, MprList *fileData)

Write Http upload body data.

Description:
Write files and form fields as request body data. This will use transfer chunk encoding. This routine will block until all the buffer is written. This routine may invoke mprYield before it blocks to consent for the garbage collector to turn. Callers must ensure they have retained all required temporary memory before invoking this routine.
Parameters:
connHttp connection object created via httpCreateConn
fileDataList of string file names to upload.
formDataList of strings containing "key=value" pairs. The form data should be already www-urlencoded.
Returns:
Number of bytes successfully written.
API Stability:
Stable.
See Also:
HttpConn, HttpEnvCallback, HttpListenCallback, HttpNotifier, HttpQueue, HttpRx, HttpStage, HttpTx, httpAfterEvent, httpClosePipeline, httpCreateConn, httpCreateRxPipeline, httpCreateTxPipeline, httpDestroyConn, httpDiscardData, httpDisconnect, httpEnableUpload, httpError, httpFinalizeConnector, httpGetAsync, httpGetChunkSize, httpGetConnContext, httpGetConnHost, httpGetError, httpGetExt, httpGetKeepAliveCount, httpGetWriteQueueCount, httpIOEvent, httpMatchHost, httpMemoryError, httpPrepClientConn, httpResetCredentials, httpRouteRequest, httpScheduleConnTimeout, httpSetAsync, httpSetChunkSize, httpSetConnContext, httpSetConnHost, httpSetConnNotifier, httpSetCredentials, httpSetFileHandler, httpSetKeepAliveCount, httpSetProtocol, httpSetRetries, httpSetSendConnector, httpSetState, httpSetTimeout, httpSetTimestamp, httpStartPipeline

HttpDir

HttpDir

Directory object for the DirHandler.

API Stability:
Internal.
Fields:
HttpDir * httpGetDirObj (HttpRoute *route)

Get the HttpDir object for a route.

API Stability:
Evolving.
See Also:

HttpEndpoint

HttpEndpoint

Listening endpoints.

See Also:
httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
API Stability:
Internal.
Fields:
intasync Listening is in async mode (non-blocking).
void *context Embedding context.
MprDispatcher *dispatcher Event dispatcher.
intflags Endpoint control flags.
MprList *hosts List of host objects.
Http *http Http service object.
char *ip Listen IP address. May be null if listening on all interfaces.
HttpLimits *limits Alias for first host, default route resource limits.
MprMutex *mutex Multithread sync.
HttpNotifiernotifier Default connection notifier callback.
intport Listen port.
MprSocket *sock Listening socket.
MprSsl *ssl SSL configurations to use.
HttpConn * httpAcceptConn (HttpEndpoint *endpoint, MprEvent *event)

Accept a new connection.

Accept a new client connection on a new socket. If multithreaded, this will come in on a worker thread dedicated to this connection. This is called from the listen wait handler
Parameters:
endpointThe endpoint on which the server was listening.
eventMpr event object.
Returns:
A HttpConn object representing the new connection.
API Stability:
Internal.
See Also:
HttpEndpoint, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
void httpAddHostToEndpoint (HttpEndpoint *endpoint, struct HttpHost *host)

Add a host to an endpoint.

Description:
Add the host to the endpoint's list of hosts. A listening endpoint may have multiple virutal hosts.
Parameters:
endpointEndpoint to which the host will be added.
hostHttpHost object to add.
Returns:
"Zero" if the host can be added.
API Stability:
Internal.
See Also:
HttpEndpoint, httpAcceptConn, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
HttpEndpoint * httpCreateConfiguredEndpoint (struct HttpHost *host, cchar *home, cchar *documents, cchar *ip, int port)

Create and configure a new endpoint.

Description:
Convenience function to create and configure a new endpoint without using a config file. If no host is supplied, a default host and route are created.
Parameters:
hostOptional HttpHost object.
homeHome directory for configuration files for the endpoint.
documentsDirectory containing the.
ipIP address to use for the endpoint. Set to null to listen on all interfaces.
portListening port number to use for the endpoint.
Returns:
A configured HttpEndpoint object instance.
API Stability:
Internal.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
HttpEndpoint * httpCreateEndpoint (cchar *ip, int port, MprDispatcher *dispatcher)

Create an endpoint object.

Description:
Creates a listening endpoint on the given IP:PORT. Use httpStartEndpoint to begin listening for client connections.
Parameters:
ipIP address on which to listen.
portIP port number.
dispatcherDispatcher to use. Can be null.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
void httpDestroyEndpoint (HttpEndpoint *endpoint)

Destroy the endpoint.

Description:
This destroys the endpoint created by httpCreateEndpoint. Calling this routine should not normally be necessary as the garbage collector will invoke as required.
Parameters:
endpointHttpEndpoint object returned from httpCreateEndpoint
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
void * httpGetEndpointContext (HttpEndpoint *endpoint)
int httpIsEndpointAsync (HttpEndpoint *endpoint)
struct HttpHost * HttpHost* httpLookupHostOnEndpoint (HttpEndpoint *endpoint, cchar *name)

Lookup a host name.

Description:
Lookup a host by name in the set of defined hosts for this endpoint.
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
nameHost name to search for.
Returns:
An HttpHost object instance or null if the host cannot be found.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
int httpSecureEndpoint (HttpEndpoint *endpoint, struct MprSsl *ssl)

Secure an endpoint.

Description:
Define the SSL parameters for an endpoint. This must be done before starting listening on the endpoint via httpStartEndpoint
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
sslMprSsl object.
Returns:
"Zero" if successful, otherwise a negative MPR error code.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
int httpSecureEndpointByName (cchar *name, struct MprSsl *ssl)

Secure an endpoint by name.

Description:
Define the SSL parameters for an endpoint that is selected by name. This must be done before starting listening on the endpoint via httpStartEndpoint
Parameters:
nameEndpoint name. The endpoint name is comprised of the IP and port. For example: "127.0.0.1:7777".
sslMprSsl object.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
int httpSetEndpointAddress (HttpEndpoint *endpoint, cchar *ip, int port)

Set the endpoint IP address.

Description:
This call defines the endpoint's IP address and port number. If the endpoint has already been started, this will stop and restart the endpoint. Current requests will not be disturbed. This is useful to modify the endpoints address when using dynamically assigned IP addresses.
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
ipIP address to use for the endpoint. Set to null to listen on all interfaces.
portListening port number to use for the endpoint.
Returns:
"Zero" if successful, otherwise a negative MPR error code.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
void httpSetEndpointAsync (HttpEndpoint *endpoint, int enable)
void httpSetEndpointContext (HttpEndpoint *endpoint, void *context)
void httpSetEndpointNotifier (HttpEndpoint *endpoint, HttpNotifier fn)

Define a notifier callback for this endpoint.

Description:
The notifier callback will be invoked as Http requests are processed.
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
fnNotifier function.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpStartEndpoint, httpStopEndpoint
int httpStartEndpoint (HttpEndpoint *endpoint)

Start listening for client connections on an endpoint.

Description:
Opens the endpoint socket and starts listening for connections.
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
Returns:
"Zero" if successful, otherwise a negative MPR error code.
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStopEndpoint
int httpStartEndpoints ()

Start listening for client connections on all endpoints.

Description:
Opens all endpoints and starts listening for connections.
Returns:
"Zero" if successful, otherwise a negative MPR error code.
API Stability:
Evolving.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint
void httpStopEndpoint (HttpEndpoint *endpoint)

Stop the server listening for client connections.

Description:
Closes the socket endpoint. This preserves connections accepted via the listening endpoint.
Parameters:
endpointHttpEndpoint object created via httpCreateEndpoint
API Stability:
Stable.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint
void httpStopEndpoints ()

Stop listening for client connections on all endpoints.

Description:
Closes all endpoints and stops listening for connections. Does not impact running requests.
Returns:
"Zero" if successful, otherwise a negative MPR error code.
See Also:
HttpEndpoint, httpAcceptConn, httpAddHostToEndpoint, httpCreateConfiguredEndpoint, httpCreateEndpoint, httpDestroyEndpoint, httpGetEndpointContext, httpIsEndpointAsync, httpLookupHostOnEndpoint, httpSecureEndpoint, httpSecureEndpointByName, httpSetEndpointAddress, httpSetEndpointAsync, httpSetEndpointContext, httpSetEndpointNotifier, httpStartEndpoint, httpStopEndpoint

HttpHost

HttpHost

Host Object.

Description:
A Host object represents a logical host. Several logical hosts may share a single HttpEndpoint.
See Also:
httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
API Stability:
Internal.
Fields:
HttpUri *canonical Canonical host name (optional canonial public name for redirections).
HttpEndpoint *defaultEndpoint Default endpoint for host.
HttpRoute *defaultRoute Default route for the host.
intflags Host flags.
cchar *hostname Host name portion only.
cchar *name Full host name with port.
void *nameCompiled Compiled name regular expression (not alloced).
struct HttpHost *parent Parent host to inherit aliases, dirs, routes.
MprCache *responseCache Response content caching store.
MprList *routes List of Route defintions.
HttpEndpoint *secureEndpoint Secure endpoint for host.
MprHash *streams Hash of mime-types to stream record.
int httpAddRoute (HttpHost *host, HttpRoute *route)

Add a route to a host.

Description:
Add the route to the host list of routes. During request route matching, routes are processed in order, so it is important to define routes in the order in which you wish to match them.
Parameters:
hostHttpHost object.
routeRoute to add.
Returns:
"Zero" if the route can be added.
API Stability:
Stable.
See Also:
HttpHost, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
HttpHost * httpCloneHost (HttpHost *parent)

Clone a host.

Description:
The parent host is cloned and a new host returned. The new host inherites the parent's configuration.
Parameters:
parentParent HttpHost object to clone.
Returns:
The new HttpHost object.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
HttpHost * httpCreateDefaultHost ()

Create the default host.

Description:
Create and define a default host. The host is added to the Http service's list of hosts. A default route is created for the host.
Returns:
The new HttpHost object.
API Stability:
Evolving.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
HttpHost * httpCreateHost ()

Create a host.

Description:
Create a new host object. The host is added to the Http service's list of hosts.
Returns:
The new HttpHost object.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
HttpHost * httpGetDefaultHost ()

Get the default host defined via httpSetDefaultHost.

Returns:
The defaul thost object.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
bool httpGetStreaming (struct HttpHost *host, cchar *mime, cchar *uri)

Determine if input body content should be streamed or buffered for requests with content of a given mime type.

Description:
The mime type and URI are used to match the request.
Parameters:
hostHost to modify.
mimeMime type to configure.
uriURI prefix to match with.
Returns:
True if input should be streamed. False if it should be buffered.
API Stability:
Evolving.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
void httpResetRoutes (HttpHost *host)

Reset the list of routes for the host.

Parameters:
hostHttpHost object.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpSetHostName, httpSetHostProtocol
void httpSetDefaultHost (HttpHost *host)

Set the default host for all servers.

Parameters:
hostHost to define as the default host.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
int httpSetHostCanonicalName (HttpHost *host, cchar *name)

Set the host canonical name.

Description:
The host canonical name is the public perferred name to use for the server. This is used when redirecting client requests for directories.
Parameters:
hostHttpHost object.
nameHost canonical name to use.
Returns:
Zero if successful. May return a negative MPR error code if the name is a regular expression and cannot be compiled.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
void httpSetHostDefaultEndpoint (HttpHost *host, HttpEndpoint *endpoint)

Set the default endpoint for a host.

Description:
The host may have a default endpoint that is used when doing redirections to http.
Parameters:
hostHost to examine.
endpointSecure endpoint to use as the default.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
void httpSetHostDefaultRoute (HttpHost *host, HttpRoute *route)

Set the default route for a host.

Description:
The host has a default route which holds default configuration. Typically the default route is not directly used when routing URIs. Rather other routes inherit from the default route and are used to respond to client requests.
Parameters:
hostHost to examine.
routeRoute to define as the default.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
int httpSetHostName (HttpHost *host, cchar *name)

Set the host name.

Description:
The host name is used when matching client requests to virtual hosts using the Http request Host header. If the host name starts with "*", it will match names that contain the name. If the host name ends with "*", it will match names that start with the name. If the host name begins and ends with a "/", the name is assumed to be a regular expression. Regular expressions may match multiple host names by using the "|" character to separate names.
Parameters:
hostHttpHost object.
nameHost name to use.
Returns:
Zero if successful. May return a negative MPR error code if the name is a regular expression and cannot be compiled.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostProtocol
void httpSetHostProtocol (HttpHost *host, cchar *protocol)

Set the host HTTP protocol version.

Description:
Set the host protocol version to either HTTP/1.0 or HTTP/1.1.
Parameters:
hostHttpHost object.
protocolSet to either HTTP/1.0 or HTTP/1.1.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName
void httpSetHostRoot (HttpHost *host, cchar *root)

Set the server root for a host.

Description:
The server root is used as the default directory to locate configuration files for the host.
Parameters:
hostHttpHost object.
rootDirectory path for the host server root.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
void httpSetHostSecureEndpoint (HttpHost *host, HttpEndpoint *endpoint)

Set the default secure endpoint for a host.

Description:
The host may have a default secure endpoint that is used when doing redirections to https.
Parameters:
hostHost to examine.
endpointSecure endpoint to use as the default.
API Stability:
Stable.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol
void httpSetStreaming (struct HttpHost *host, cchar *mime, cchar *uri, bool streaming)

Control if input body content should be streamed or buffered for requests with content of a given mime type.

Parameters:
hostHost to modify.
mimeMime type to configure.
uriURI prefix to match.
streamingSet to true to enable streaming for this mime type.
API Stability:
Evolving.
See Also:
HttpHost, httpAddRoute, httpCloneHost, httpCreateHost, httpResetRoutes, httpSetHostName, httpSetHostProtocol

HttpLimits

HttpLimits

Http limits.

See Also:
httpCreateLimits, httpEaseLimits, httpInitLimits
API Stability:
Internal.
Fields:
ssizebufferSize Maximum buffering by any pipeline stage.
ssizecacheItemSize Maximum size of a cachable item.
ssizechunkSize Maximum chunk size for transfer encoding.
intclientMax Maximum number of unique clients IP addresses.
intconnectionsMax Maximum number of simultaneous client connections.
intheaderMax Maximum number of header lines.
ssizeheaderSize Maximum size of the total header.
MprTicksinactivityTimeout Timeout for keep-alive and idle requests (msec).
intkeepAliveMax Maximum number of Keep-Alive requests to perform per socket.
intprocessMax Maximum number of processes (CGI).
intrequestMax Maximum number of simultaneous concurrent requests.
MprTicksrequestParseTimeout Time a request can take to parse the request headers (msec).
intrequestsPerClientMax Maximum number of requests per client IP.
MprTicksrequestTimeout Time a request can take (msec).
MprOffrxBodySize Maximum size of receive body data.
MprOffrxFormSize Maximum size of form data.
intsessionMax Maximum number of sessions.
MprTickssessionTimeout Time a session can persist (msec).
MprOfftxBodySize Maximum size of transmission body content.
MprOffuploadSize Maximum size of an uploaded file.
ssizeuriSize Maximum size of a uri.
ssizewebSocketsFrameSize Maximum size of sent WebSocket frames. Incoming frames have no limit except message size.
intwebSocketsMax Maximum number of WebSockets.
ssizewebSocketsMessageSize Maximum total size of a WebSocket message including all frames.
ssizewebSocketsPacketSize Maximum size of a WebSocket packet exchanged with the user callback.
MprTickswebSocketsPing Time between pings.
HttpLimits * httpCreateLimits (int serverSide)

Create a new limits object.

Description:
Create and initialize a new limits object with default values.
Parameters:
serverSideSet to "true" for server side limits. Set to "false" for client side default limits.
Returns:
The allocated limits object.
API Stability:
Stable.
See Also:
HttpLimits, httpEaseLimits, httpInitLimits
void httpEaseLimits (HttpLimits *limits)

Ease the limits.

Description:
This increases the receive body size, transmission body size and upload size to the maximum sizes supported by the system. Client side limits are eased by default.
Parameters:
limitsLimits object. This can be either HttpHost.limits HttpConn.limits or HttpEndpoint.limits.
API Stability:
Stable.
See Also:
HttpLimits, httpCreateLimits, httpInitLimits
void httpInitLimits (HttpLimits *limits, bool serverSide)

Initialize a limits object with default values.

Parameters:
limitsLimits object to modify.
serverSideSet to "true" for server side limits. Set to "false" for client side default limits.
API Stability:
Stable.
See Also:
HttpLimits, httpCreateLimits, httpEaseLimits

HttpMonitor

HttpMonitor

Monitor control structure.

API Stability:
Internal.
Fields:
intcounterIndex Counter item index to monitor.
cchar *counterName Name of counter to monitor.
MprList *defenses List of defensive measures.
intexpr Expression. Set to '<' or '>'.
uint64limit Comparison limit value.
MprTicksperiod Frequence of comparison.
MprEvent *timer Monitor timer.
int httpAddCounter (cchar *name)

Add a counter to be monitored.

Parameters:
nameName of the counter.
Returns:
The counter index in HttpAddress.counters[] to use.
API Stability:
Evolving.
See Also:
int httpAddDefense (cchar *name, cchar *remedy, cchar *args)

Add a defense.

Parameters:
nameName of defensive policy.
remedyRemedy action to invoke. Standard remedies include: ban, cmd, delay, email, http and log. This can be null and the remedy can be specified via REMEDY=remedy in the args.
argsArguments to pass to the remedy. These may include ${tokens}.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Evolving.
See Also:
int httpAddDefenseFromJson (cchar *name, cchar *remedy, MprJson *jargs)

Add a defense using JSON arguments.

Parameters:
nameName of defensive policy.
remedyRemedy action to invoke. Standard remedies include: ban, cmd, delay, email, http and log. This can be null and the remedy can be specified via REMEDY=remedy in the args.
jargsArguments to pass to the remedy as a JSON object. These may include ${tokens}.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Evolving.
See Also:
int httpAddMonitor (cchar *counter, cchar *expr, uint64 limit, MprTicks period, cchar *defenses)

Add a monitor.

Parameters:
counterName of counter to monitor. Some of the standard counter names are: ActiveClients, ActiveConnections, ActiveRequests, ActiveProcesses, BadRequestErrors, LimitErrors, Memory, NotFoundErrors, NetworkIO, Requests, SSLErrors, TotalErrors.
exprExpression operator. Select from "<" or ">".
limitLimit value to compare with the counter value.
periodTime period over which to determine the counter value.
defensesList of defenses to invoke if the counter exceeds the limit value over the designated period.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Evolving.
See Also:
int httpAddRemedy (cchar *name, HttpRemedyProc remedy)

Add a remedy.

Parameters:
nameName of the remedy.
remedyRemedy callback function.
Returns:
Zero if successful, otherwise a negative MPR error code.
API Stability:
Evolving.
See Also:
int httpBanClient (cchar *ip, MprTicks period, int status, cchar *msg)

Ban a client IP from service.

Parameters:
ipClient IP address to ban.
periodPeriod in milliseconds to ban the client.
statusIf non-zero, then return a HTTP response to the client with this HTTP status.
msgIf non-null, then return a HTTP response with this message. If both status and msg are zero and null respectively, then do not send a response to the client, rather immediately close the connection.
API Stability:
Evolving.
See Also:
void httpDumpCounters ()

Print the monitor counters to the error log.

API Stability:
Evolving.
See Also:
int64 httpMonitorEvent (struct HttpConn *conn, int counter, int64 adj)

Monitor an event and validate against defined limits and monitored resources.

Description:
The Http library supports a suite of resource limits that restrict the impact of a request on the system. This call validates a processing event for the current request against the server's endpoint limits.
Parameters:
connConnection object.
counterThe counter to adjust.
connHttpConn connection object.
adjValue to adjust the counter by. May be positive or negative.
Returns:
Monitor value after applying the adjustment.
API Stability:
Evolving.
See Also:

HttpPacket

HttpPacket

Packet object.

Description:
The request/response pipeline sends data and control information in HttpPacket objects. The output stream typically consists of a HEADER packet followed by zero or more data packets and terminated by an END packet. If the request has input data, the input stream consists of one or more data packets followed by an END packet.

Packets contain data and optional prefix or suffix headers. Packets can be split, joined, filled, or emptied. The pipeline stages will fill or transform packet data as required.
See Also:
HttpFillProc, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
API Stability:
Internal.
Fields:
MprBuf *content Chunk content.
MprOffepos Data position in entity (file).
MprOffesize Data size in entity (file).
HttpFillProcfill Callback to fill packet with data.
uintflags Packet flags.
uintlast Last packet in a message.
struct HttpPacket *next Next packet in chain.
MprBuf *prefix Prefix message to be emitted before the content.
uinttype Packet type extension.
void httpAdjustPacketEnd (HttpPacket *packet, MprOff size)

Adjust the packet end position.

Description:
This adjusts the packet content by the given size. The packet length (size) is decremented by the requested amount. If the packet describes entity data, the Packet.esize field is reduced by the requested size amount. If the packet has actual data buffered in Packet.content, the content buffer end position is reduced by by the size amount.
Parameters:
packetPacket to modify.
sizeSize to adjust packet end position.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
void httpAdjustPacketStart (HttpPacket *packet, MprOff size)

Adjust the packet starting position.

Description:
This adjusts the packet content by the given size. The packet position is incremented by start and the packet length (size) is decremented. If the packet describes entity data, the given size amount to the Packet.epos and decrements the Packet.esize fields. If the packet has actual data buffered in Packet.content, the content buffer start is incremeneted by the size amount.
Parameters:
packetPacket to modify.
sizeSize to add to the packet current position.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpClonePacket (HttpPacket *orig)
HttpPacket * httpCreateDataPacket (ssize size)

Create a data packet.

Description:
Create a packet and set the HTTP_PACKET_DATA flag Data packets convey data through the response pipeline.
Parameters:
sizeSize of the package data storage.
Returns:
HttpPacket object.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpCreateEndPacket ()

Create an end-of-stream packet.

Description:
Create an end-of-stream packet and set the HTTP_PACKET_END flag. The end pack signifies the end of data. It is used on both incoming and outgoing streams through the request/response pipeline.
Returns:
HttpPacket object.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpCreateEntityPacket (MprOff pos, MprOff size, HttpFillProc fill)

Create an entity data packet.

Description:
Create an entity packet and set the HTTP_PACKET_DATA flag. Entity packets describe the resource (entity) to send to the client and provide a HttpFillProc procedure used to fill packets with data from the entity.
Parameters:
posPosition within the entity for packet data.
sizeSize of the entity data.
fillHttpFillProc callback to supply the entity data.
Returns:
HttpPacket object.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpCreateHeaderPacket ()

Create a response header packet.

Description:
Create a response header packet and set the HTTP_PACKET_HEADER flag. A header packet is used by the pipeline to hold the response headers.
Returns:
HttpPacket object.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpCreatePacket (ssize size)

Create a data packet.

Description:
Create a packet of the required size.
Parameters:
sizeSize of the package data storage.
Returns:
HttpPacket object.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
ssize httpGetPacketContents (HttpPacket *packet)

Get the packet data contents.

Description:
Get the packet content reference. This is an MprBuf object.
Parameters:
packetPacket to examine.
Returns:
MprBuf reference or zero if there are not contents.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
ssize httpGetPacketLength (HttpPacket *packet)

Get the length of the packet data contents.

Description:
Get the content length of a packet. This does not include the prefix or virtual data length just the pure buffered data contents.
Parameters:
packetPacket to examine.
Returns:
Count of bytes contained by the packet.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
char * httpGetPacketStart (HttpPacket *packet)
char * httpGetPacketString (HttpPacket *packet)

Get the packet data contents as a string.

Description:
Get the packet content reference. The packet contents will be null terminated.
Parameters:
packetPacket to examine.
Returns:
A reference to the start of the packet contents.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
bool httpIsLastPacket (HttpPacket *packet)

Test if the packet is the last in a logical message.

Description:
Useful for WebSockets to test if the packet is the last frame in a message.
Parameters:
packetPacket to examine.
Returns:
True if the packet is the last in a message.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
int httpJoinPacket (HttpPacket *packet, HttpPacket *other)

Join two packets.

Description:
Join the contents of one packet to another by copying the data from the other packet into the first packet.
Parameters:
packetDestination packet.
otherOther packet to copy data from.
Returns:
"Zero" if successful, otherwise a negative Mpr error code.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpSplitPacket
HttpPacket * httpSplitPacket (HttpPacket *packet, ssize offset)

Split a data packet.

Description:
Split a data packet at the specified offset. Packets may need to be split so that downstream stages can digest their contents. If a packet is too large for the queue maximum size, it should be split. When the packet is split, a new packet is created containing the data after the offset. Any suffix headers are moved to the new packet. NOTE: when splitting packets, the HttpPacket.content reference may be modified.
Parameters:
packetPacket to split.
offsetRoute in the original packet at which to split.
Returns:
New HttpPacket object containing the data after the offset. No need to free, unless you have a very long running request. Otherwise the packet memory will be released automatically when the request completes.
API Stability:
Stable.
See Also:
HttpFillProc, HttpPacket, HttpQueue, httpAdjustPacketEnd, httpAdjustPacketStart, httpClonePacket, httpCreateDataPacket, httpCreateEndPacket, httpCreateEntityPacket, httpCreateHeaderPacket, httpCreatePacket, httpGetPacket, httpGetPacketLength, httpIsLastPacket, httpJoinPacket, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext

HttpQueue

HttpQueue

Queue object.

Description:
The request pipeline consists of a full-duplex pipeline of stages. Each stage has two queues, one for outgoing data and one for incoming. A HttpQueue object manages the data flow for a request stage and has the ability to queue and process data, manage flow control, and schedule packets for service.

Queue's provide open, close, put, and service methods. These methods manage and respond to incoming packets. A queue can respond immediately to an incoming packet by processing or dispatching a packet in its put() method. Alternatively, the queue can defer processing by queueing the packet on it's service queue and then waiting for it's service() method to be invoked.

If a queue does not define a put() method, the default put() method will be used which queues data onto the service queue. The default incoming put() method joins incoming packets into a single packet on the service queue.

Data flows downstream from one queue to the next queue linked via the nextQ field.
See Also:
HttpConn, HttpPacket, httpDisableQueue, httpDiscardQueueData, httpEnableQueue, httpFlushQueue, httpGetQueueRoom, httpIsEof, httpIsPacketTooBig, httpIsQueueEmpty, httpIsQueueSuspended, httpJoinPacketForService, httpJoinPackets, httpPutBackPacket, httpPutForService, httpPutPacket, httpPutPacketToNext, httpRemoveQueue, httpResizePacket, httpResumeQueue, httpScheduleQueue, httpServiceQueue, httpSetQueueLimits, httpSuspendQueue, httpWillNextQueueAcceptPacket, httpWillNextQueueAcceptSize, httpWrite, httpWriteBlock, httpWriteString
API Stability:
Internal.
Fields:
HttpQueueCloseclose Close the queue.
struct HttpConn *conn Connection owning this queue.
ssizecount Bytes in queue (Does not include virt packet data).
intdirection Flow direction.
HttpPacket *first First packet in queue (singly linked).
intflags Queue flags.
MprOffioCount Count of bytes in iovec including file I/O.
intioFile Sending a file.
intioIndex Next index into iovec.
MprOffioPos Position in file for sendfile.
HttpPacket *last Last packet in queue (tail pointer).
ssizelow Low water mark for flow control.
ssizemax Advisory maxiumum queue size.
cchar *name Queue name for debugging.
struct HttpQueue *nextQ Downstream queue for next stage.
HttpQueueOpenopen Open the queue.
ssizepacketSize Maximum acceptable packet size.
struct HttpQueue *pair Queue for the same stage in the opposite direction.
struct HttpQueue *prevQ Upstream queue for prior stage.
HttpQueueDataput Callback to receive a packet.
void *queueData Stage instance data - must be a managed reference.
struct HttpQueue *scheduleNext Next linkage when queue is on the service queue.
struct HttpQueue *schedulePrev Previous linkage when queue is on the service queue.
HttpQueueServiceservice Service the queue.
intservicing Currently being serviced.
struct HttpStage *stage Stage owning this queue.
HttpQueueStartstart Start the queue.
void *staticData Stage instance data - must be an unmanaged reference.