From 12b5e56f46e4b2b489a088c2ccfb6410c10686ea Mon Sep 17 00:00:00 2001 From: dzzxzz Date: Sat, 17 Mar 2012 06:43:49 +0000 Subject: unify the coding style of kernel git-svn-id: https://rt-thread.googlecode.com/svn/trunk@1998 bbd45198-f89e-11dd-88c7-29a3b14d5316 --- include/rtthread.h | 39 +++++++++++++++++++++++++++++---------- 1 file changed, 29 insertions(+), 10 deletions(-) (limited to 'include/rtthread.h') diff --git a/include/rtthread.h b/include/rtthread.h index 1cf0532627..f0a69c8aac 100644 --- a/include/rtthread.h +++ b/include/rtthread.h @@ -1,7 +1,7 @@ /* * File : rtthread.h * This file is part of RT-Thread RTOS - * COPYRIGHT (C) 2006 - 2011, RT-Thread Development Team + * COPYRIGHT (C) 2006 - 2012, RT-Thread Development Team * * The license and distribution terms for this file may be * found in the file LICENSE in this distribution or at @@ -30,11 +30,12 @@ extern "C" { /** * @addtogroup KernelObject */ + /*@{*/ + /* * kernel object interface */ - void rt_system_object_init(void); struct rt_object_information *rt_object_get_information(enum rt_object_class_type type); void rt_object_init(struct rt_object *object, enum rt_object_class_type type, const char *name); @@ -57,7 +58,9 @@ void rt_object_put_sethook(void (*hook)(struct rt_object *object)); /** * @addtogroup Clock */ + /*@{*/ + /* * clock & timer interface */ @@ -86,12 +89,15 @@ rt_err_t rt_timer_control(rt_timer_t timer, rt_uint8_t cmd, void *arg); #ifdef RT_USING_HOOK void rt_timer_timeout_sethook(void (*hook)(struct rt_timer *timer)); #endif + /*@}*/ /** * @addtogroup Thread */ + /*@{*/ + /* * thread interface */ @@ -142,12 +148,15 @@ void rt_exit_critical(void); #ifdef RT_USING_HOOK void rt_scheduler_sethook(void (*hook)(rt_thread_t from, rt_thread_t to)); #endif + /*@}*/ /** * @addtogroup MM */ + /*@{*/ + /* * memory management interface */ @@ -167,6 +176,7 @@ void rt_mp_free(void *block); void rt_mp_alloc_sethook(void (*hook)(struct rt_mempool *mp, void *block)); void rt_mp_free_sethook(void (*hook)(struct rt_mempool *mp, void *block)); #endif + #endif #ifdef RT_USING_HEAP @@ -179,8 +189,8 @@ void *rt_malloc(rt_size_t nbytes); void rt_free(void *ptr); void *rt_realloc(void *ptr, rt_size_t nbytes); void *rt_calloc(rt_size_t count, rt_size_t size); -void* rt_malloc_align(rt_size_t size, rt_size_t align); -void rt_free_align(void* ptr); +void *rt_malloc_align(rt_size_t size, rt_size_t align); +void rt_free_align(void *ptr); void rt_memory_info(rt_uint32_t *total, rt_uint32_t *used, rt_uint32_t *max_used); @@ -195,12 +205,15 @@ void rt_free_sethook(void (*hook)(void *ptr)); #endif #endif + /*@}*/ /** * @addtogroup IPC */ + /*@{*/ + #ifdef RT_USING_SEMAPHORE /* * semaphore interface @@ -247,7 +260,6 @@ rt_err_t rt_event_control(rt_event_t event, rt_uint8_t cmd, void *arg); #ifdef RT_USING_MAILBOX /* * mailbox interface - * */ rt_err_t rt_mb_init(rt_mailbox_t mb, const char *name, void *msgpool, rt_size_t size, rt_uint8_t flag); rt_err_t rt_mb_detach(rt_mailbox_t mb); @@ -274,17 +286,19 @@ rt_err_t rt_mq_urgent(rt_mq_t mq, void *buffer, rt_size_t size); rt_err_t rt_mq_recv(rt_mq_t mq, void *buffer, rt_size_t size, rt_int32_t timeout); rt_err_t rt_mq_control(rt_mq_t mq, rt_uint8_t cmd, void *arg); #endif + /*@}*/ #ifdef RT_USING_DEVICE /** * @addtogroup Device */ + /*@{*/ + /* * device (I/O) system interface */ - rt_device_t rt_device_find(const char *name); rt_err_t rt_device_register(rt_device_t dev, const char *name, rt_uint16_t flags); @@ -300,6 +314,7 @@ rt_err_t rt_device_close(rt_device_t dev); rt_size_t rt_device_read (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size); rt_size_t rt_device_write(rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size); rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void *arg); + /*@}*/ #endif @@ -307,11 +322,12 @@ rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void *arg); /** * @addtogroup Module */ + /*@{*/ + /* * module interface */ - rt_module_t rt_module_load(const char *name, void *module_ptr); rt_err_t rt_module_unload(rt_module_t module); rt_module_t rt_module_open(const char *filename); @@ -327,8 +343,8 @@ void rt_module_load_sethook(void (*hook)(rt_module_t module)); void rt_module_unload_sethook(void (*hook)(rt_module_t module)); #endif -#endif /*@}*/ +#endif /* * interrupt service @@ -340,6 +356,7 @@ typedef void (*rt_isr_handler_t)(int vector); */ void rt_interrupt_enter(void); void rt_interrupt_leave(void); + /* * the number of nested interrupts. */ @@ -348,10 +365,13 @@ rt_uint8_t rt_interrupt_get_nest(void); /** * @addtogroup KernelService */ + /*@{*/ + /* * general kernel service */ +void rt_kprintf(const char *fmt, ...); rt_int32_t rt_sprintf(char *buf ,const char *format, ...); rt_int32_t rt_vsprintf(char *dest, const char *format, va_list arg_ptr); rt_int32_t rt_sprintf(char *buf ,const char *format, ...); @@ -360,7 +380,6 @@ rt_int32_t rt_snprintf(char *buf, rt_size_t size, const char *format, ...); #ifdef RT_USING_DEVICE rt_device_t rt_console_set_device(const char *name); #endif -void rt_kprintf(const char *fmt, ...); rt_err_t rt_get_errno(void); void rt_set_errno(rt_err_t no); @@ -393,5 +412,5 @@ void rt_show_version(void); #ifdef __cplusplus } #endif -/*@}*/ + #endif -- cgit v1.3.1