include/native/heap.h

Go to the documentation of this file.

#ifndef _XENO_HEAP_H
#define _XENO_HEAP_H

#include <nucleus/synch.h>
#include <nucleus/heap.h>
#include <native/types.h>

/* Creation flags. */
#define H_PRIO     XNSYNCH_PRIO /* Pend by task priority order. */
#define H_FIFO     XNSYNCH_FIFO /* Pend by FIFO order. */
#define H_DMA      0x100        /* Use memory suitable for DMA. */
#define H_MAPPABLE 0x200        /* Memory is mappable to user-space. */
#define H_SINGLE   0x400        /* Manage as single-block area. */
#define H_SHARED   (H_MAPPABLE|H_SINGLE) /* I.e. shared memory segment. */

typedef struct rt_heap_info {

    int nwaiters;               /* !< Number of pending tasks. */

    int mode;                   /* !< Creation mode. */

    size_t heapsize;            /* !< Size of heap memory. */

    char name[XNOBJECT_NAME_LEN]; /* !< Symbolic name. */

} RT_HEAP_INFO;

typedef struct rt_heap_placeholder {

    xnhandle_t opaque;

    void *opaque2;

    caddr_t mapbase;

    size_t mapsize;

} RT_HEAP_PLACEHOLDER;

#if defined(__KERNEL__) || defined(__XENO_SIM__)

#define XENO_HEAP_MAGIC 0x55550808

typedef struct rt_heap {

    unsigned magic;   /* !< Magic code - must be first */

    xnsynch_t synch_base; /* !< Base synchronization object. */

    xnheap_t heap_base; /* !< Internal heap object. */

    int mode;           /* !< Creation mode. */

    size_t csize;       /* !< Original size at creation. */

    void *sba;          /* !< Single block ara (H_SINGLE only) */

    xnhandle_t handle;  /* !< Handle in registry -- zero if unregistered. */

    char name[XNOBJECT_NAME_LEN]; /* !< Symbolic name. */

#if defined(__KERNEL__) && defined(CONFIG_XENO_OPT_PERVASIVE)
    pid_t cpid;                 /* !< Creator's pid. */
#endif /* __KERNEL__ && CONFIG_XENO_OPT_PERVASIVE */

} RT_HEAP;

#ifdef __cplusplus
extern "C" {
#endif

int __native_heap_pkg_init(void);

void __native_heap_pkg_cleanup(void);

#ifdef __cplusplus
}
#endif

#else /* !(__KERNEL__ || __XENO_SIM__) */

typedef RT_HEAP_PLACEHOLDER RT_HEAP;

#ifdef __cplusplus
extern "C" {
#endif

int rt_heap_bind(RT_HEAP *heap,
                 const char *name,
                 RTIME timeout);

int rt_heap_unbind(RT_HEAP *heap);

#ifdef __cplusplus
}
#endif

#endif /* __KERNEL__ || __XENO_SIM__ */

#ifdef __cplusplus
extern "C" {
#endif

/* Public interface. */

int rt_heap_create(RT_HEAP *heap,
                   const char *name,
                   size_t heapsize,
                   int mode);

int rt_heap_delete(RT_HEAP *heap);

int rt_heap_alloc(RT_HEAP *heap,
                  size_t size,
                  RTIME timeout,
                  void **blockp);

int rt_heap_free(RT_HEAP *heap,
                 void *block);

int rt_heap_inquire(RT_HEAP *heap,
                    RT_HEAP_INFO *info);

#ifdef __cplusplus
}
#endif

#endif /* !_XENO_HEAP_H */

---