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