ubiclib heap API More...

#include <ubinos_config.h>
#include <ubinos/type.h>

Classes
struct	__heap_tip_t

Macros
#define	HEAP_ERR__POLLUTED_TOP -21

#define	HEAP_ERR__POLLUTED_BOTTOM -22

#define	HEAP_ERR__POLLUTED_HEADER -23

#define	HEAP_ERR__UNSUPPORTED -24

#define	HEAP_FLAG_NO__TFL_PERSISTENT 0

#define	HEAP_FLAG_NO__TFL_TEMP 1

#define	HEAP_FLAG_NO__TFL_RESIZABLE 2

Typedefs
typedef struct __heap_tip_t	_heap_tip_t

typedef _heap_tip_t *	heap_pt

Functions
int	ubiclib_heap_comp_init (void)

int	ubiclib_heap_comp_init_reent (void)

int	heap_create (heap_pt *heap_p, unsigned int addr, unsigned int size)

int	heap_create_ext (heap_pt *heap_p, unsigned int addr, unsigned int size, int algorithm0, int locktype0, unsigned int m0, unsigned int fblcount0, int algorithm1, int locktype1, unsigned int m1, unsigned int fblcount1)

int	heap_delete (heap_pt *heap_p)

void *	heap_malloc (heap_pt heap, unsigned int size, int dir)

int	heap_free (heap_pt heap, void *ptr)

void *	heap_resize (heap_pt heap, void *ptr, unsigned int size)

int	heap_power_off (heap_pt heap, int dir)

int	heap_power_on (heap_pt heap, int dir)

int	heap_checkblockboundary (heap_pt heap, void *ptr)

int	heap_checkblockboundaryall (heap_pt heap)

void *	heap_get_addr (heap_pt heap)

void *	heap_get_end (heap_pt heap)

int	heap_get_block_allocated_size_min (heap_pt heap)

int	heap_get_block_overhead (heap_pt heap)

int	heap_set_flag (heap_pt heap, void *ptr, int flag_no, int flag)

int	heap_get_flag (heap_pt heap, void *ptr, int flag_no)

void *	heap_get_first_allocated_block (heap_pt heap, int dir)

void *	heap_get_last_allocated_block (heap_pt heap, int dir)

void *	heap_get_next_allocated_block (heap_pt heap, void *ptr)

void *	heap_get_prev_allocated_block (heap_pt heap, void *ptr)

int	heap_getblocksize (heap_pt heap, void ptr, unsigned int size_p)

int	heap_getblock_usable_size (heap_pt heap, void ptr, unsigned int size_p)

int	heap_getblock_allocated_size (heap_pt heap, void ptr, unsigned int size_p)

int	heap_getsize (heap_pt heap, unsigned int *size_p)

int	heap_getexpandablesize (heap_pt heap, unsigned int *size_p)

int	heap_getrequestedsize (heap_pt heap, unsigned int *size_p)

int	heap_getrequestedsize_ext (heap_pt heap, unsigned int size_p, unsigned int nsize_p, unsigned int *rsize_p)

int	heap_getrequestedsizemax (heap_pt heap, unsigned int *size_p)

int	heap_getrequestedsizemax_ext (heap_pt heap, unsigned int size_p, unsigned int nsize_p, unsigned int *rsize_p)

int	heap_getallocatedcount (heap_pt heap, unsigned int *count_p)

int	heap_getallocatedcount_ext (heap_pt heap, unsigned int count_p, unsigned int ncount_p, unsigned int *rcount_p)

int	heap_getallocatedcountmax (heap_pt heap, unsigned int *count_p)

int	heap_getallocatedcountmax_ext (heap_pt heap, unsigned int count_p, unsigned int ncount_p, unsigned int *rcount_p)

int	heap_getallocatedsize (heap_pt heap, unsigned int *size_p)

int	heap_getallocatedsize_ext (heap_pt heap, unsigned int size_p, unsigned int nsize_p, unsigned int *rsize_p)

int	heap_getallocatedsizemax (heap_pt heap, unsigned int *size_p)

int	heap_getallocatedsizemax_ext (heap_pt heap, unsigned int size_p, unsigned int nsize_p, unsigned int *rsize_p)

int	heap_getfreeblockcount (heap_pt heap, unsigned int *count_p)

int	heap_getfreeblockcount_ext (heap_pt heap, unsigned int count_p, unsigned int ncount_p, unsigned int *rcount_p)

int	heap_getblockoverhead (heap_pt heap, unsigned int *overhead_p)

int	heap_printheapinfo (heap_pt heap)

unsigned int	heap_group_calc_fblcount (unsigned int size, unsigned int m)

unsigned int	heap_group_calc_fblcount_raw (unsigned int size, unsigned int m)

unsigned int	heap_wbuddy_calc_fblcount (unsigned int size, unsigned int m)

unsigned int	heap_wbuddy_calc_fblcount_raw (unsigned int size, unsigned int m)

unsigned int	heap_pgroup_calc_fblcount (unsigned int size, unsigned int m)

unsigned int	heap_pgroup_calc_fblcount_raw (unsigned int size, unsigned int m)

Detailed Description

ubiclib heap API

ubiclib 힙 API를 정의합니다.

Macro Definition Documentation

◆ HEAP_ERR__POLLUTED_BOTTOM

#define HEAP_ERR__POLLUTED_BOTTOM -22

하위 경계 영역이 오염되었음

◆ HEAP_ERR__POLLUTED_HEADER

#define HEAP_ERR__POLLUTED_HEADER -23

헤더 경계 영역이 오염되었음

◆ HEAP_ERR__POLLUTED_TOP

#define HEAP_ERR__POLLUTED_TOP -21

상위 경계 영역이 오염되었음

◆ HEAP_ERR__UNSUPPORTED

#define HEAP_ERR__UNSUPPORTED -24

지원하지 않는 기능임

◆ HEAP_FLAG_NO__TFL_PERSISTENT

#define HEAP_FLAG_NO__TFL_PERSISTENT 0

TensorFlow Lite persistent buffer

◆ HEAP_FLAG_NO__TFL_RESIZABLE

#define HEAP_FLAG_NO__TFL_RESIZABLE 2

TensorFlow Lite resizable buffer

◆ HEAP_FLAG_NO__TFL_TEMP

#define HEAP_FLAG_NO__TFL_TEMP 1

TensorFlow Lite temp buffer

Typedef Documentation

◆ _heap_tip_t

typedef struct __heap_tip_t _heap_tip_t

API용 힙 구조체 정의

◆ heap_pt

typedef _heap_tip_t* heap_pt

API용 힙 포인터 형 정의

Function Documentation

◆ heap_checkblockboundary()

int heap_checkblockboundary	(	heap_pt	heap,
		void *	ptr
	)

메모리 블록의 경계 영역이 오염되었는지 여부를 검사하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소

Returns: 0: 정상

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음
HEAP_ERR__POLLUTED_TOP : top boundary 영역이 오염되었음
HEAP_ERR__POLLUTED_BOTTOM : bottom boundary 영역이 오염되었음
HEAP_ERR__POLLUTED_HEADER : header boundary 영역이 오염되었음

메모리 블럭 구조

#if !(UBINOS__UBICLIB__EXCLUDE_HEAP_BOUNDARY_CHECK == 1)
         -----------------------------------
         | header boundary                 |
         |        --------                 |
         |        tag                      |
         |        --------                 |
         |        ...                      |
         -----------------------------------
         | top boundary                    |
         -----------------------------------  <---- memory address
         | memory                          |
         |                                 |
         |                                 |
         -----------------------------------
         | tag                             |
         -----------------------------------
         | bottom boundary                 |
         -----------------------------------
#else
         -----------------------------------
         | header tag                      |
         |        --------                 |
         |        ...                      |
         -----------------------------------  <---- memory address
         | memory                          |
         |                                 |
         |                                 |
         -----------------------------------
         | tag                             |
         -----------------------------------
#endif

◆ heap_checkblockboundaryall()

int heap_checkblockboundaryall ( heap_pt heap )

힙의 모든 메모리 블록들의 경계 영역이 오염되었는지 여부를 검사하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 0: 정상

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_create()

int heap_create	(	heap_pt *	heap_p,
		unsigned int	addr,
		unsigned int	size
	)

힙을 생성하는 함수

Parameters

heap_p	생성한 힙의 주소를 저장할 포인터의 주소
addr	힙으로 사용할 메모리의 주소
size	힙으로 사용할 메모리의 크기

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_create_ext()

int heap_create_ext	(	heap_pt *	heap_p,
		unsigned int	addr,
		unsigned int	size,
		int	algorithm0,
		int	locktype0,
		unsigned int	m0,
		unsigned int	fblcount0,
		int	algorithm1,
		int	locktype1,
		unsigned int	m1,
		unsigned int	fblcount1
	)

힙을 생성하는 함수의 확장형

Parameters

heap_p	생성한 힙의 주소를 저장할 포인터의 주소
addr	힙으로 사용할 메모리의 주소
size	힙으로 사용할 메모리의 크기
algorithm0	정방향 힙의 알고리즘 (UBINOS__UBICLIB__HEAP_ALGORITHM__...)
locktype0	정방향 힙의 잠금 방식 (UBINOS__UBICLIB__HEAP_LOCK_TYPE__...)
m0	정방향 힙의 그룹 시스템 M 값
fblcount0	정방향 힙의 사용가능 블록 리스트의 수
algorithm1	역방향 힙의 알고리즘 (UBINOS__UBICLIB__HEAP_ALGORITHM__...)
locktype1	역방향 힙의 잠금 방식 (UBINOS__UBICLIB__HEAP_LOCK_TYPE__...)
m1	역방향 힙의 그룹 시스템 M 값
fblcount1	역방향 힙의 사용가능 블록 리스트의 수

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_delete()

int heap_delete ( heap_pt * heap_p )

힙을 제거하는 함수

Parameters

heap_p 제거할 힙의 주소가 저장된 포인터의 주소
제거에 성공하면 *heap_p는 NULL이 됨

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_free()

int heap_free	(	heap_pt	heap,
		void *	ptr
	)

메모리 블록을 해제하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_get_addr()

void* heap_get_addr ( heap_pt heap )

힙 시작 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 힙 시작 주소

NULL: 오류

◆ heap_get_block_allocated_size_min()

int heap_get_block_allocated_size_min ( heap_pt heap )

메모리 블록의 실제 크기 최소값 돌려주는 함수 (해드 등의 오버해드 포함)

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 메모리 블록의 실제 크기 최소값

-1: 오류

◆ heap_get_block_overhead()

int heap_get_block_overhead ( heap_pt heap )

힙 블록 오버헤드 크기를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 힙 블록 오버헤드 크기

-1: 오류

◆ heap_get_end()

void* heap_get_end ( heap_pt heap )

힙 끝 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 힙 끝 주소

NULL: 오류

◆ heap_get_first_allocated_block()

void* heap_get_first_allocated_block	(	heap_pt	heap,
		int	dir
	)

할당된 첫 번째 메모리 블록 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
dir	힙 성장 방향

Returns: 할당된 첫 번째 메모리 블록의 주소

NULL: 오류

◆ heap_get_flag()

int heap_get_flag	(	heap_pt	heap,
		void *	ptr,
		int	flag_no
	)

대상 블록의 flag 정보를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
flag_no	flag 번호

Returns: 0, 1: 대상 블록의 flag 정보

-1: 오류

◆ heap_get_last_allocated_block()

void* heap_get_last_allocated_block	(	heap_pt	heap,
		int	dir
	)

할당된 마지막 메모리 블록 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
dir	힙 성장 방향

Returns: 할당된 마지막 메모리 블록의 주소

NULL: 오류

◆ heap_get_next_allocated_block()

void* heap_get_next_allocated_block	(	heap_pt	heap,
		void *	ptr
	)

대상 메모리 블록 다음 할당된 메모리 블록 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소

Returns: 대상 블록 다음 할당된 메모리 블록의 주소

NULL: 오류

◆ heap_get_prev_allocated_block()

void* heap_get_prev_allocated_block	(	heap_pt	heap,
		void *	ptr
	)

대상 메모리 블록 이전 할당된 메모리 블록 주소를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소

Returns: 대상 블록 이전 할당된 메모리 블록의 주소

NULL: 오류

◆ heap_getallocatedcount()

int heap_getallocatedcount	(	heap_pt	heap,
		unsigned int *	count_p
	)

힙의 할당된 메모리 블록들의 총 수를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 수를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

Examples: condvtest04.c, msgqtest04.c, mutextest04.c, semtest04.c, signaltest04.c, stimertest03.c, and tasktest06.c.

◆ heap_getallocatedcount_ext()

int heap_getallocatedcount_ext	(	heap_pt	heap,
		unsigned int *	count_p,
		unsigned int *	ncount_p,
		unsigned int *	rcount_p
	)

힙의 할당된 메모리 블록들의 총 수를 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 수를 저장할 변수의 주소 NULL이면 무시함
ncount_p	정방향으로 할당된 메모리 블록들의 총 수를 저장할 변수의 주소 NULL이면 무시함
rcount_p	역방향으로 할당된 메모리 블록들의 총 수를 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getallocatedcountmax()

int heap_getallocatedcountmax	(	heap_pt	heap,
		unsigned int *	count_p
	)

힙의 할당된 메모리 블록들의 총 수의 최고 기록을 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 수의 최고 기록을 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getallocatedcountmax_ext()

int heap_getallocatedcountmax_ext	(	heap_pt	heap,
		unsigned int *	count_p,
		unsigned int *	ncount_p,
		unsigned int *	rcount_p
	)

힙의 할당된 메모리 블록들의 총 수의 최고 기록을 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 수의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
ncount_p	정방향으로 할당된 메모리 블록들의 총 수의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
rcount_p	역방향으로 할당된 메모리 블록들의 총 수의 최고 기록을 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getallocatedsize()

int heap_getallocatedsize	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 할당된 메모리 블록들의 총 크기를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	힙의 할당된 메모리 블록들의 총 크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

Examples: condvtest04.c, msgqtest04.c, mutextest04.c, semtest04.c, signaltest04.c, stimertest03.c, and tasktest06.c.

◆ heap_getallocatedsize_ext()

int heap_getallocatedsize_ext	(	heap_pt	heap,
		unsigned int *	size_p,
		unsigned int *	nsize_p,
		unsigned int *	rsize_p
	)

힙의 할당된 메모리 블록들의 총 크기를 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	힙의 할당된 메모리 블록들의 총 크기를 저장할 변수의 주소 NULL이면 무시함
nsize_p	정방향으로 할당된 메모리 블록들의 총 크기를 저장할 변수의 주소 NULL이면 무시함
rsize_p	역방향으로 할당된 메모리 블록들의 총 크기를 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getallocatedsizemax()

int heap_getallocatedsizemax	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 할당된 메모리 블록들의 총 크기의 최고 기록을 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	총 크기의 최고 기록을 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getallocatedsizemax_ext()

int heap_getallocatedsizemax_ext	(	heap_pt	heap,
		unsigned int *	size_p,
		unsigned int *	nsize_p,
		unsigned int *	rsize_p
	)

힙의 할당된 메모리 블록들의 총 크기의 최고 기록을 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	총 크기의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
nsize_p	정방향으로 할당된 메모리 블록들의 총 크기의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
rsize_p	역방향으로 할당된 메모리 블록들의 총 크기의 최고 기록을 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getblock_allocated_size()

int heap_getblock_allocated_size	(	heap_pt	heap,
		void *	ptr,
		unsigned int *	size_p
	)

메모리 블록의 실제 크기 돌려주는 함수 (해드 등의 오버해드 포함)

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
size_p	실제 크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getblock_usable_size()

int heap_getblock_usable_size	(	heap_pt	heap,
		void *	ptr,
		unsigned int *	size_p
	)

메모리 블록의 사용 가능한 크기 돌려주는 함수 (할당 시 요청한 크기 보다 크거나 같음)

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
size_p	사용 가능한 크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getblockoverhead()

int heap_getblockoverhead	(	heap_pt	heap,
		unsigned int *	overhead_p
	)

힙의 메모리 블록 당 부담(overhead)를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
overhead_p	메모리 블럭 당 부담(overhead)를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getblocksize()

int heap_getblocksize	(	heap_pt	heap,
		void *	ptr,
		unsigned int *	size_p
	)

메모리 블록의 크기를 돌려주는 함수 (할당 시 요청한 크기)

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
size_p	크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getexpandablesize()

int heap_getexpandablesize	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 확장 가능 크기를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	확장 가능 크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getfreeblockcount()

int heap_getfreeblockcount	(	heap_pt	heap,
		unsigned int *	count_p
	)

힙의 사용가능 블록의 수를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 사용가능 블록의 수를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getfreeblockcount_ext()

int heap_getfreeblockcount_ext	(	heap_pt	heap,
		unsigned int *	count_p,
		unsigned int *	ncount_p,
		unsigned int *	rcount_p
	)

힙의 사용가능 블록의 수를 돌려주는 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
count_p	총 사용가능 블록의 수를 저장할 변수의 주소 NULL이면 무시함
ncount_p	정방향 영역의 사용가능 블록의 수를 저장할 변수의 주소 NULL이면 무시함
rcount_p	역방향 영역의 사용가능 블록의 수를 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getrequestedsize()

int heap_getrequestedsize	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 메모리 블록들의 요청 크기의 총 합을 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	요청 크기의 총 합을 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getrequestedsize_ext()

int heap_getrequestedsize_ext	(	heap_pt	heap,
		unsigned int *	size_p,
		unsigned int *	nsize_p,
		unsigned int *	rsize_p
	)

힙의 메모리 블록들의 요청 크기 총 합을 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	요청 크기의 총 합을 저장할 변수의 주소 NULL이면 무시함
nsize_p	정방향으로 할당된 메모리 블록들의 요청 크기의 총 합을 저장할 변수의 주소 NULL이면 무시함
rsize_p	역방향으로 할당된 메모리 블록들의 요청 크기의 총 합을 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getrequestedsizemax()

int heap_getrequestedsizemax	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 메모리 블록들의 요청 크기의 총 합의 최고 기록을 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	요청 크기의 총 합의 최고 기록을 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getrequestedsizemax_ext()

int heap_getrequestedsizemax_ext	(	heap_pt	heap,
		unsigned int *	size_p,
		unsigned int *	nsize_p,
		unsigned int *	rsize_p
	)

힙의 메모리 블록들의 요청 크기의 총 합의 최고 기록을 돌려주는 함수의 확장형

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	요청 크기의 총 합의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
nsize_p	정방향으로 할당된 메모리 블록들의 요청 크기의 총 합의 최고 기록을 저장할 변수의 주소 NULL이면 무시함
rsize_p	역방향으로 할당된 메모리 블록들의 요청 크기의 총 합의 최고 기록을 저장할 변수의 주소 NULL이면 무시함

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_getsize()

int heap_getsize	(	heap_pt	heap,
		unsigned int *	size_p
	)

힙의 크기를 돌려주는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size_p	크기를 저장할 변수의 주소

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

◆ heap_group_calc_fblcount()

unsigned int heap_group_calc_fblcount	(	unsigned int	size,
		unsigned int	m
	)

그룹 시스템의 사용 가능 블록 리스트 수를 개산하는 함수

Parameters

size	최대 멤버 수
m	최대 멤버 수

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ heap_group_calc_fblcount_raw()

unsigned int heap_group_calc_fblcount_raw	(	unsigned int	size,
		unsigned int	m
	)

그룹 시스템의 사용 가능 블록 리스트 수를 개산하는 함수 (최소 크기 offset을 반영하지 않고 계산)

Parameters

size	최대 멤버 수
m	최대 멤버 수

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ heap_malloc()

void* heap_malloc	(	heap_pt	heap,
		unsigned int	size,
		int	dir
	)

메모리 블록을 할당하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
size	요청 크기
dir	힙 성장 방향

Returns: 할당된 메모리 블록의 주소

NULL: 오류

◆ heap_pgroup_calc_fblcount()

unsigned int heap_pgroup_calc_fblcount	(	unsigned int	size,
		unsigned int	m
	)

테일링을 하지 않는 순수 그룹 시스템의 사용 가능 블록 리스트 수를 개산하는 함수

Parameters

size	최대 멤버 수
m	최대 멤버 수

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ heap_pgroup_calc_fblcount_raw()

unsigned int heap_pgroup_calc_fblcount_raw	(	unsigned int	size,
		unsigned int	m
	)

테일링을 하지 않는 순수 그룹 시스템의 사용 가능 블록 리스트 수를 개산하는 함수 (최소 크기 offset을 반영하지 않고 계산)

Parameters

size	최대 멤버 수
m	최대 멤버 수

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ heap_power_off()

int heap_power_off	(	heap_pt	heap,
		int	dir
	)

지정한 성장 방향의 힙 메모리의 전원을 끄는 함수 (현재는 기본 힙만 지원함)

Parameters

heap	대상 힙 NULL이면 기본 힙
dir	힙 성장 방향

Returns: 0: 성공

-1: 오류

◆ heap_power_on()

int heap_power_on	(	heap_pt	heap,
		int	dir
	)

지정한 성장 방향의 힙 메모리의 전원을 키는 함수 (현재는 기본 힙만 지원함)

Parameters

heap	대상 힙 NULL이면 기본 힙
dir	힙 성장 방향

Returns: 0: 성공

-1: 오류

◆ heap_printheapinfo()

int heap_printheapinfo ( heap_pt heap )

힙의 정보를 출력하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙

Returns: 0: 성공

-1: 오류
-n: n-1 번째 매개변수가 잘못되었음

Examples: misctest01.c.

◆ heap_resize()

void* heap_resize	(	heap_pt	heap,
		void *	ptr,
		unsigned int	size
	)

메모리 블록의 크기를 변경하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
size	요청 크기

Returns: 크기가 변경된 메모리 블록의 주소

NULL: 오류

◆ heap_set_flag()

int heap_set_flag	(	heap_pt	heap,
		void *	ptr,
		int	flag_no,
		int	flag
	)

대상 블록의 flag 정보를 설정하는 함수

Parameters

heap	대상 힙 NULL이면 기본 힙
ptr	대상 메모리 블록의 주소
flag_no	flag 번호
flag	flag 값 [0 \| 1]

Returns: 0: 성공

-1: 오류

◆ heap_wbuddy_calc_fblcount()

unsigned int heap_wbuddy_calc_fblcount	(	unsigned int	size,
		unsigned int	m
	)

가중치 버디 시스템의 사용 가능 블록 리스트 수를 개산하는 함수

Parameters

size	최대 멤버 수
m	의미 없음

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ heap_wbuddy_calc_fblcount_raw()

unsigned int heap_wbuddy_calc_fblcount_raw	(	unsigned int	size,
		unsigned int	m
	)

가중치 버디 시스템의 사용 가능 블록 리스트 수를 개산하는 함수 (최소 크기 offset을 반영하지 않고 계산)

Parameters

size	최대 멤버 수
m	의미 없음

Returns: 사용 가능 블록 리스트 수

0: 오류

◆ ubiclib_heap_comp_init()

int ubiclib_heap_comp_init ( void )

힙 컴포넌트를 초기화하는 함수

이 함수는 시스템 시작시 bsp 컴포넌트의 main 함수에서 자동적으로 호출됩니다.

Returns: 0: 성공

-1: 오류
HEAP_ERR__UNSUPPORTED: 지원하지 않음

◆ ubiclib_heap_comp_init_reent()

int ubiclib_heap_comp_init_reent ( void )

힙 컴포넌트를 재진입(reenterance)이 가능하도록 초기화하는 함수

이 함수는 ubiclib_heap_comp_init 함수가 호출된 다음에 호출되어야 하며, 시스템 시작시 bsp 컴포넌트의 main 함수에서 자동적으로 호출됩니다.

Returns: 0: 성공

-1: 오류
HEAP_ERR__UNSUPPORTED: 지원하지 않음

Classes

Macros

Typedefs

Functions

Detailed Description

Macro Definition Documentation

◆ HEAP_ERR__POLLUTED_BOTTOM

◆ HEAP_ERR__POLLUTED_HEADER

◆ HEAP_ERR__POLLUTED_TOP

◆ HEAP_ERR__UNSUPPORTED

◆ HEAP_FLAG_NO__TFL_PERSISTENT

◆ HEAP_FLAG_NO__TFL_RESIZABLE

◆ HEAP_FLAG_NO__TFL_TEMP

Typedef Documentation

◆ _heap_tip_t

◆ heap_pt

Function Documentation

◆ heap_checkblockboundary()

◆ heap_checkblockboundaryall()

◆ heap_create()

◆ heap_create_ext()

◆ heap_delete()

◆ heap_free()

◆ heap_get_addr()

◆ heap_get_block_allocated_size_min()

◆ heap_get_block_overhead()

◆ heap_get_end()

◆ heap_get_first_allocated_block()

◆ heap_get_flag()

◆ heap_get_last_allocated_block()

◆ heap_get_next_allocated_block()

◆ heap_get_prev_allocated_block()

◆ heap_getallocatedcount()

◆ heap_getallocatedcount_ext()

◆ heap_getallocatedcountmax()

◆ heap_getallocatedcountmax_ext()

◆ heap_getallocatedsize()

◆ heap_getallocatedsize_ext()

◆ heap_getallocatedsizemax()

◆ heap_getallocatedsizemax_ext()

◆ heap_getblock_allocated_size()

◆ heap_getblock_usable_size()

◆ heap_getblockoverhead()

◆ heap_getblocksize()

◆ heap_getexpandablesize()

◆ heap_getfreeblockcount()

◆ heap_getfreeblockcount_ext()

◆ heap_getrequestedsize()

◆ heap_getrequestedsize_ext()

◆ heap_getrequestedsizemax()

◆ heap_getrequestedsizemax_ext()

◆ heap_getsize()

◆ heap_group_calc_fblcount()

◆ heap_group_calc_fblcount_raw()

◆ heap_malloc()

◆ heap_pgroup_calc_fblcount()

◆ heap_pgroup_calc_fblcount_raw()

◆ heap_power_off()

◆ heap_power_on()

◆ heap_printheapinfo()

◆ heap_resize()

◆ heap_set_flag()

◆ heap_wbuddy_calc_fblcount()

◆ heap_wbuddy_calc_fblcount_raw()

◆ ubiclib_heap_comp_init()

◆ ubiclib_heap_comp_init_reent()