coap_lwip, coap_lwip_dump_memory_pools, coap_lwip_set_input_wait_handler - Work with CoAP lwip specific
Contents
Bugs
Please report bugs on the mailing list for libcoap: libcoap-developers@lists.sourceforge.net or raise an
issue on GitHub at https://github.com/obgm/libcoap/issues
Callback Handler
CallbackType:coap_lwip_input_wait_handler_t
/**
* LwIP callback handler that can be used to wait / timeout for the
* next input packet.
*
* @param arg The argument passed to the coap_lwip_set_input_wait_handler()
* function.
* @param milli_secs Suggested number of milli secs to wait before returning
* if no input.
*
* @return @c 1 if packet received, @c 0 for timeout, else @c -1 on error.
*/
typedef int (*coap_lwip_input_wait_handler_t)(void* arg, uint32_t milli_secs);
Description
This man page describes the additional libcoap functions that are available for working with LwIP
implementations.
NOTE: If the following line is defined in lwipopts.h, then libcoap will reserve space for one response
PDU when allocating coap_pdu_t structures.
#define MEMP_STATS 1
Functions
Function:coap_lwip_set_input_wait_handler()
The coap_lwip_set_input_wait_handler() function is used to define a callback handler that is invoked by
coap_io_process(3) which passes in the input_arg parameter along with a suggested milli-sec wait time
parameter in case there is no input. This callback handler is used to wait for (and probably times out)
the next input packet. This allows the application to define whatever mechanism it wants use for this
process.
Function:coap_lwip_dump_memory_pools()
The coap_lwip_dump_memory_pools() function is used to dump out the current state of the LwIP memory pools
at logging level log_level.
This function is always invoked by coap_free_context(3) with a log_level of COAP_LOG_DEBUG.
NOTE: For information to be printed out, you need the following two lines in lwipopts.h
#define MEMP_STATS 1
#define LWIP_STATS_DISPLAY 1
Further Information
See
"RFC7252: The Constrained Application Protocol (CoAP)"
for further information.
Name
coap_lwip, coap_lwip_dump_memory_pools, coap_lwip_set_input_wait_handler - Work with CoAP lwip specific
API handler
See Also
coap_context(3) and coap_io(3)
Synopsis
#include<coap3/coap.h>voidcoap_lwip_set_input_wait_handler(coap_context_t*context,coap_lwip_input_wait_handler_thandler,void*input_arg);voidcoap_lwip_dump_memory_pools(coap_log_tlog_level);
