NAME

       coap_lwip, coap_lwip_dump_memory_pools, coap_lwip_set_input_wait_handler - Work with CoAP
       lwip specific API handler

SYNOPSIS

       #include <coap3/coap.h>

       void coap_lwip_set_input_wait_handler(coap_context_t *context,
       coap_lwip_input_wait_handler_t handler, void *input_arg);

       void coap_lwip_dump_memory_pools(coap_log_t log_level);

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

CALLBACK HANDLER

       Callback Type: 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);

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

SEE ALSO

       coap_context(3) and coap_io(3)

FURTHER INFORMATION

       See

       "RFC7252: The Constrained Application Protocol (CoAP)"

       for further information.

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

AUTHORS

       The libcoap project <libcoap-developers@lists.sourceforge.net>