mirror of
https://github.com/obgm/libcoap.git
synced 2026-11-05 17:32:54 +03:00
Jon Shallow
de1bc9f3cb
New demo client app. Update some of the memory sizes. New coap_lwip_dump_memory_pools() to dump LwIP memory pool usage. Add in logic to handle new client sessions. New coap_io_process() to handle LwIP which can invoke a callback handler to wait / timeout for the next input handler. New coap_lwip_set_input_wait_handler() to define this handler. Update coap_io_prepare_io() to handle LwIP. Support re-use of pbuf for PDU re-transmissions. Make sure that NSTART is correctly obeyed. Build the client with client only libcoap code. Build the server with server only libcoap code. Update LwIP source to latest stable release. Reserve memory for a response PDU. New coap_lwip(3) man page. Update directory structures for config files. Update files contained in "make dist" and check lwip rebuilds in the github workflows.
144 lines
3.9 KiB
C
144 lines
3.9 KiB
C
/*
|
|
* mem.h -- CoAP memory handling
|
|
*
|
|
* Copyright (C) 2010-2011,2014-2015 Olaf Bergmann <bergmann@tzi.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*
|
|
* This file is part of the CoAP library libcoap. Please see README for terms
|
|
* of use.
|
|
*/
|
|
|
|
/**
|
|
* @file mem.h
|
|
* @brief CoAP memory handling
|
|
*/
|
|
|
|
#ifndef COAP_MEM_H_
|
|
#define COAP_MEM_H_
|
|
|
|
#include <stdlib.h>
|
|
|
|
#ifndef WITH_LWIP
|
|
/**
|
|
* Initializes libcoap's memory management.
|
|
* This function must be called once before coap_malloc() can be used on
|
|
* constrained devices.
|
|
*/
|
|
void coap_memory_init(void);
|
|
#endif /* WITH_LWIP */
|
|
|
|
/**
|
|
* Type specifiers for coap_malloc_type(). Memory objects can be typed to
|
|
* facilitate arrays of type objects to be used instead of dynamic memory
|
|
* management on constrained devices.
|
|
*/
|
|
typedef enum {
|
|
COAP_STRING,
|
|
COAP_ATTRIBUTE_NAME,
|
|
COAP_ATTRIBUTE_VALUE,
|
|
COAP_PACKET,
|
|
COAP_NODE,
|
|
COAP_CONTEXT,
|
|
COAP_ENDPOINT,
|
|
COAP_PDU,
|
|
COAP_PDU_BUF,
|
|
COAP_RESOURCE,
|
|
COAP_RESOURCEATTR,
|
|
COAP_DTLS_SESSION,
|
|
COAP_SESSION,
|
|
COAP_OPTLIST,
|
|
COAP_CACHE_KEY,
|
|
COAP_CACHE_ENTRY,
|
|
COAP_LG_XMIT,
|
|
COAP_LG_CRCV,
|
|
COAP_LG_SRCV,
|
|
COAP_DIGEST_CTX,
|
|
} coap_memory_tag_t;
|
|
|
|
#ifndef WITH_LWIP
|
|
|
|
/**
|
|
* Allocates a chunk of @p size bytes and returns a pointer to the newly
|
|
* allocated memory. The @p type is used to select the appropriate storage
|
|
* container on constrained devices. The storage allocated by coap_malloc_type()
|
|
* must be released with coap_free_type().
|
|
*
|
|
* @param type The type of object to be stored.
|
|
* @param size The number of bytes requested.
|
|
* @return A pointer to the allocated storage or @c NULL on error.
|
|
*/
|
|
void *coap_malloc_type(coap_memory_tag_t type, size_t size);
|
|
|
|
/**
|
|
* Reallocates a chunk @p p of bytes created by coap_malloc_type() or
|
|
* coap_realloc_type() and returns a pointer to the newly allocated memory of
|
|
* @p size.
|
|
* Only COAP_STRING type is supported.
|
|
*
|
|
* Note: If there is an error, @p p will separately need to be released by
|
|
* coap_free_type().
|
|
*
|
|
* @param type The type of object to be stored.
|
|
* @param p A pointer to memory that was allocated by coap_malloc_type().
|
|
* @param size The number of bytes requested.
|
|
* @return A pointer to the allocated storage or @c NULL on error.
|
|
*/
|
|
void *coap_realloc_type(coap_memory_tag_t type, void *p, size_t size);
|
|
|
|
/**
|
|
* Releases the memory that was allocated by coap_malloc_type(). The type tag @p
|
|
* type must be the same that was used for allocating the object pointed to by
|
|
* @p .
|
|
*
|
|
* @param type The type of the object to release.
|
|
* @param p A pointer to memory that was allocated by coap_malloc_type().
|
|
*/
|
|
void coap_free_type(coap_memory_tag_t type, void *p);
|
|
|
|
/**
|
|
* Wrapper function to coap_malloc_type() for backwards compatibility.
|
|
*/
|
|
COAP_STATIC_INLINE void *coap_malloc(size_t size) {
|
|
return coap_malloc_type(COAP_STRING, size);
|
|
}
|
|
|
|
/**
|
|
* Wrapper function to coap_free_type() for backwards compatibility.
|
|
*/
|
|
COAP_STATIC_INLINE void coap_free(void *object) {
|
|
coap_free_type(COAP_STRING, object);
|
|
}
|
|
|
|
#endif /* not WITH_LWIP */
|
|
|
|
#ifdef WITH_LWIP
|
|
|
|
#include <lwip/memp.h>
|
|
|
|
/* no initialization needed with lwip (or, more precisely: lwip must be
|
|
* completely initialized anyway by the time coap gets active) */
|
|
COAP_STATIC_INLINE void coap_memory_init(void) {}
|
|
|
|
/* It would be nice to check that size equals the size given at the memp
|
|
* declaration, but i currently don't see a standard way to check that without
|
|
* sourcing the custom memp pools and becoming dependent of its syntax
|
|
*/
|
|
#define coap_malloc_type(type, size) memp_malloc(MEMP_ ## type)
|
|
#define coap_free_type(type, p) memp_free(MEMP_ ## type, p)
|
|
|
|
/* Those are just here to make uri.c happy where string allocation has not been
|
|
* made conditional.
|
|
*/
|
|
COAP_STATIC_INLINE void *coap_malloc(size_t size) {
|
|
LWIP_ASSERT("coap_malloc must not be used in lwIP", 0);
|
|
}
|
|
|
|
COAP_STATIC_INLINE void coap_free(void *pointer) {
|
|
LWIP_ASSERT("coap_free must not be used in lwIP", 0);
|
|
}
|
|
|
|
#endif /* WITH_LWIP */
|
|
|
|
#endif /* COAP_MEM_H_ */
|