rtl-allocator.h

Go to the documentation of this file.

/*
 *  COPYRIGHT (c) 2012, 2018 Chris Johns <chrisj@rtems.org>
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.org/license/LICENSE.
 */
#if !defined (_RTEMS_RTL_ALLOCATOR_H_)
#define _RTEMS_RTL_ALLOCATOR_H_
 
#include <stdbool.h>
 
#include "rtl-indirect-ptr.h"
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
enum rtems_rtl_alloc_tags {
  RTEMS_RTL_ALLOC_OBJECT,     
  RTEMS_RTL_ALLOC_SYMBOL,     
  RTEMS_RTL_ALLOC_EXTERNAL,   
  RTEMS_RTL_ALLOC_READ,       
  RTEMS_RTL_ALLOC_READ_WRITE, 
  RTEMS_RTL_ALLOC_READ_EXEC   
};
 
typedef enum rtems_rtl_alloc_tags rtems_rtl_alloc_tag;
 
enum rtems_rtl_alloc_cmd {
  RTEMS_RTL_ALLOC_NEW,        
  RTEMS_RTL_ALLOC_DEL,        
  RTEMS_RTL_ALLOC_LOCK,       
  RTEMS_RTL_ALLOC_UNLOCK,     
  RTEMS_RTL_ALLOC_WR_ENABLE,  
  RTEMS_RTL_ALLOC_WR_DISABLE, 
};
 
typedef enum rtems_rtl_alloc_cmd rtems_rtl_alloc_cmd;
 
#define RTEMS_RTL_ALLOC_TAGS ((size_t) (RTEMS_RTL_ALLOC_READ_EXEC + 1))
 
typedef void (*rtems_rtl_allocator)(rtems_rtl_alloc_cmd cmd,
                                    rtems_rtl_alloc_tag tag,
                                    void**              address,
                                    size_t              size);
 
struct rtems_rtl_alloc_data {
  rtems_rtl_allocator allocator;
  rtems_chain_control indirects[RTEMS_RTL_ALLOC_TAGS];
};
 
typedef struct rtems_rtl_alloc_data rtems_rtl_alloc_data;
 
void rtems_rtl_alloc_initialise (rtems_rtl_alloc_data* data);
 
void* rtems_rtl_alloc_new (rtems_rtl_alloc_tag tag, size_t size, bool zero);
 
void rtems_rtl_alloc_del (rtems_rtl_alloc_tag tag, void* address);
 
void rtems_rtl_alloc_lock (void);
 
void rtems_rtl_alloc_unlock (void);
 
void rtems_rtl_alloc_wr_enable (rtems_rtl_alloc_tag tag, void* address);
 
void rtems_rtl_alloc_wr_disable (rtems_rtl_alloc_tag tag, void* address);
 
rtems_rtl_allocator rtems_rtl_alloc_hook (rtems_rtl_allocator handler);
 
void rtems_rtl_alloc_indirect_new (rtems_rtl_alloc_tag tag,
                                   rtems_rtl_ptr*      handle,
                                   size_t              size);
 
void rtems_rtl_alloc_indirect_del (rtems_rtl_alloc_tag tag,
                                   rtems_rtl_ptr*      handle);
 
rtems_rtl_alloc_tag rtems_rtl_alloc_text_tag (void);
 
rtems_rtl_alloc_tag rtems_rtl_alloc_const_tag (void);
 
rtems_rtl_alloc_tag rtems_rtl_alloc_eh_tag (void);
 
rtems_rtl_alloc_tag rtems_rtl_alloc_data_tag (void);
 
rtems_rtl_alloc_tag rtems_rtl_alloc_bss_tag (void);
 
bool rtems_rtl_alloc_module_new (void** text_base, size_t text_size,
                                 void** const_base, size_t const_size,
                                 void** eh_base, size_t eh_size,
                                 void** data_base, size_t data_size,
                                 void** bss_base, size_t bss_size);
 
void rtems_rtl_alloc_module_del (void** text_base, void** const_base,
                                 void** eh_base, void** data_base,
                                 void** bss_base);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif