Embedded TCP/IP stack: fnet_http_ssi_send_t

FNET

typedef fnet_size_t(* fnet_http_ssi_send_t) (fnet_uint8_t *buffer, fnet_size_t buffer_size, fnet_bool_t *eof, fnet_uint32_t *cookie)

Callback function prototype of the SSI include function.

Parameters
bufferOutput buffer where SSI content will be copied to.
buffer_sizeSize of the output buffer.
eofCondition flag:
  • FNET_FALSE = there is still more data to include. The fnet_http_ssi_send_t function will be called during the next iteration again.
  • FNET_TRUE = no more data is available for the SSI to include. It was the last call of the fnet_http_ssi_send_t function for the current SSI.
cookieThis parameter points to the value, which can be used to associate a custom information with a connection instance. If application store context information in the cookie, it will be preserved for future calls for this request. This allows the application to associate some request-specific state.
Returns
This function returns the number of bytes actually written to the buffer, pointed to by buffer.
The condition flag eof indicates, if the SSI end condition has occurred.
See also
fnet_http_ssi, fnet_http_ssi_handle_t

This function creates SSI dynamic content.
An application should use the buffer as output buffer for the dynamic content and set eof flag to 1 if no data are available to include.
The SSI parser invokes this callback function after successful call of the fnet_http_ssi_handle_t function and continues to call this function repeatedly, till the eof will be set to 1 or the return result is set to 0.

Definition at line 107 of file fnet_http_ssi.h.


© 2005-2018 by Andrey Butok. http://fnet.sourceforge.net