Runtime Trace and Record

Runtime Trace and Record 的协作图:

void	rt_malloc_sethook (void(*hook)(void **ptr, rt_size_t size))
void	rt_realloc_set_entry_hook (void(*hook)(void **ptr, rt_size_t size))
void	rt_realloc_set_exit_hook (void(*hook)(void **ptr, rt_size_t size))
void	rt_free_sethook (void(*hook)(void **ptr))

详细描述

the hook function set in runtime

In order to trace and record RT-Thread activity in runtime, a hook mechanism is introduced.

The hooks are a series of routines, which are invoked in some special checkpoints. The hook routines include:

• object hook, invoked at object created, deleted, taken and put etc.
• scheduler hook, invoked at thread switch and idle thread loop.
• memory hook, invoked when allocate or free memory block.
• timer hook, invoked when timer is timeout.

函数说明

rt_malloc_sethook()

void rt_malloc_sethook

(

void(*

hook )(void **ptr, rt_size_t size)

)

This function will set a hook function, which will be invoked when a memory block is allocated from heap memory.

参数

hook	the hook function.

在文件 kservice.c 第 602 行定义.

{
    rt_malloc_hook = hook;
}

rt_realloc_set_entry_hook()

void rt_realloc_set_entry_hook

(

void(*

hook )(void **ptr, rt_size_t size)

)

This function will set a hook function, which will be invoked when a memory block is allocated from heap memory.

参数

hook	the hook function.

在文件 kservice.c 第 613 行定义.

{
    rt_realloc_entry_hook = hook;
}

rt_realloc_set_exit_hook()

void rt_realloc_set_exit_hook

(

void(*

hook )(void **ptr, rt_size_t size)

)

This function will set a hook function, which will be invoked when a memory block is allocated from heap memory.

参数

hook	the hook function.

在文件 kservice.c 第 624 行定义.

{
    rt_realloc_exit_hook = hook;
}

rt_free_sethook()

void rt_free_sethook

(

void(*

hook )(void **ptr)

)

This function will set a hook function, which will be invoked when a memory block is released to heap memory.

参数

hook	the hook function

在文件 kservice.c 第 635 行定义.

{
    rt_free_hook = hook;
}