mirror of
https://github.com/obgm/libcoap.git
synced 2026-11-02 07:55:46 +03:00
Carsten Schoenert
0e59edc231
Resume the cleaning of the public header files, no functional changes. Reformatting the infos in the head of the header files, restructure header inclusion check to be more generic. Reorder some include directives in a alphabetical order. Remove including instructions for C++ stuff, it's already done in the coap.h header, and the user only has to include this header file. Dropping the prefixing of the include guarding of uthash.h because it would cause trouble with the macro handling in TinyDLS. Thanks Olaf for reminding this!
112 lines
3.0 KiB
C
112 lines
3.0 KiB
C
/*
|
|
* mem.h -- CoAP memory handling
|
|
*
|
|
* Copyright (C) 2010-2011,2014-2015 Olaf Bergmann <bergmann@tzi.org>
|
|
*
|
|
* This file is part of the CoAP library libcoap. Please see README for terms
|
|
* of use.
|
|
*/
|
|
|
|
#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_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);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
static inline void *coap_malloc(size_t size) {
|
|
return coap_malloc_type(COAP_STRING, size);
|
|
}
|
|
|
|
/**
|
|
* Wrapper function to coap_free_type() for backwards compatibility.
|
|
*/
|
|
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) */
|
|
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.
|
|
*/
|
|
static inline void *coap_malloc(size_t size) {
|
|
LWIP_ASSERT("coap_malloc must not be used in lwIP", 0);
|
|
}
|
|
|
|
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_ */
|