diff options
Diffstat (limited to 'cpukit/libcsupport/include/rtems')
| -rw-r--r-- | cpukit/libcsupport/include/rtems/deviceio.h | 21 | ||||
| -rw-r--r-- | cpukit/libcsupport/include/rtems/libcsupport.h | 39 | ||||
| -rw-r--r-- | cpukit/libcsupport/include/rtems/libio_.h | 74 |
3 files changed, 73 insertions, 61 deletions
diff --git a/cpukit/libcsupport/include/rtems/deviceio.h b/cpukit/libcsupport/include/rtems/deviceio.h index b832942750..df78852bb4 100644 --- a/cpukit/libcsupport/include/rtems/deviceio.h +++ b/cpukit/libcsupport/include/rtems/deviceio.h @@ -1,7 +1,8 @@ /** - * @file rtems/deviceio.h + * @file * - * @brief Map Operations on IMFS Device Nodes to the RTEMS Classic API IO Manager + * @brief Map Operations on IMFS Device Nodes to the RTEMS Classic API + * IO Manager */ /* @@ -18,8 +19,10 @@ /** * @defgroup Device IO Handler + * + * + * @{ */ -/**@{*/ #include <rtems/libio.h> @@ -28,12 +31,12 @@ extern "C" { #endif /* __cplusplus */ /** - * @brief IMFS Device Node Handlers + * @brief IMFS device node handlers. * - * IMFS Device Node Handlers + * IMFS Device Node Handlers * - * This file contains the set of handlers used to map operations on - * IMFS device nodes onto calls to the RTEMS Classic API IO Manager. + * This file contains the set of handlers used to map operations on + * IMFS device nodes onto calls to the RTEMS Classic API IO Manager. */ int rtems_deviceio_errno( rtems_status_code status ); @@ -76,10 +79,12 @@ int rtems_deviceio_control( rtems_device_minor_number minor ); +/** @} */ + #ifdef __cplusplus } #endif -/**@}*/ + /* __cplusplus */ #endif /* _RTEMS_DEVICEIO_H */ diff --git a/cpukit/libcsupport/include/rtems/libcsupport.h b/cpukit/libcsupport/include/rtems/libcsupport.h index 32ed8a8798..808c0fbf43 100644 --- a/cpukit/libcsupport/include/rtems/libcsupport.h +++ b/cpukit/libcsupport/include/rtems/libcsupport.h @@ -30,29 +30,31 @@ extern "C" { #endif /** - * @defgroup libcsupport Standard C Library Support + * @defgroup libcsupport Standard C Library Support * - * @brief RTEMS Specific Support for the Standard C Library + * @brief RTEMS Specific Support for the Standard C Library + * + * @{ */ extern void malloc_dump(void); /** - * @brief Malloc Walk + * @brief Malloc walk. */ extern bool malloc_walk(int source, bool printf_enabled); /** - * @brief RTEMS Malloc Set Heap Pointer + * @brief Set malloc heap pointer. * - * This routine is primarily used for debugging. + * This routine is primarily used for debugging. */ void malloc_set_heap_pointer(Heap_Control *new_heap); /** - * @brief RTEMS Malloc Get Heap Pointer + * @brief Get malloc heap pointer. * - * This routine is primarily used for debugging. + * This routine is primarily used for debugging. */ Heap_Control *malloc_get_heap_pointer( void ); extern void libc_init(void); @@ -60,17 +62,17 @@ extern int host_errno(void); extern void fix_syscall_errno(void); /** - * @brief RTEMS Malloc Get Free Information + * @brief Get free malloc information. * - * Find amount of free heap remaining + * Find amount of free heap remaining */ extern size_t malloc_free_space(void); extern void open_dev_console(void); /** - * @brief RTEMS Malloc Get Status Information + * @brief Get malloc status information. * - * Find amount of free heap remaining. + * Find amount of free heap remaining. */ extern int malloc_info(Heap_Information_block *the_info); @@ -139,7 +141,7 @@ typedef struct { /** * @brief Tasks a snapshot of the resource usage of the system. * - * @param[out] snapshot The snapshot of used resources. + * @param[out] snapshot will contain snapshot of used resources. * * @see rtems_resource_snapshot_equal() and rtems_resource_snapshot_check(). * @@ -165,8 +167,8 @@ void rtems_resource_snapshot_take(rtems_resource_snapshot *snapshot); /** * @brief Compares two resource snapshots for equality. * - * @return Returns true if the resource snapshots are equal, and false - * otherwise. + * @retval true The resource snapshots are equal. + * @retval false The resource snapshots are not equal. * * @see rtems_resource_snapshot_take(). */ @@ -179,15 +181,18 @@ bool rtems_resource_snapshot_equal( * @brief Takes a new resource snapshot and checks that it is equal to the * given snapshot. * - * @param[in] snapshot The snapshot used for comparison with the new snapshot. + * @param[in] snapshot is a pointer to the snapshot used for comparison + * with the new snapshot. * - * @return Returns true if the resource snapshots are equal, and false - * otherwise. + * @retval true The resource snapshots are equal. + * @retval false The resource snapshots are not equal. * * @see rtems_resource_snapshot_take(). */ bool rtems_resource_snapshot_check(const rtems_resource_snapshot *snapshot); +/** @} */ + #ifdef __cplusplus } #endif diff --git a/cpukit/libcsupport/include/rtems/libio_.h b/cpukit/libcsupport/include/rtems/libio_.h index c8e91ded99..80f83f939b 100644 --- a/cpukit/libcsupport/include/rtems/libio_.h +++ b/cpukit/libcsupport/include/rtems/libio_.h @@ -32,11 +32,11 @@ extern "C" { #endif /** - * @defgroup LibIOInternal IO Internal Library + * @defgroup LibIOInternal IO Internal Library * - * @brief Internal IO library API and implementation. + * @brief Internal IO library API and implementation. * - * @{ + * @{ */ #define RTEMS_FILESYSTEM_SYMLOOP_MAX 32 @@ -71,8 +71,8 @@ extern rtems_filesystem_mount_table_entry_t rtems_filesystem_null_mt_entry; * The purpose of this location is to deliver the error return status for a * previous error condition which must set the errno accordingly. * - * The usage of this null location instead of the NULL pointer eliminates a lot - * of branches. + * The usage of this null location instead of the NULL pointer eliminates + * a lot of branches. * * The user environment root and current directory are statically initialized * with the null location. Due to that all file system services are in a @@ -185,8 +185,8 @@ extern rtems_filesystem_global_location_t rtems_filesystem_global_location_null; * * The caller must hold the file system instance lock. * - * @param[out] clone The cloned location. - * @param[in] master The master location. + * @param[out] clone will contain the cloned location. + * @param[in] master is the master location. * * @see rtems_filesystem_instance_lock(). */ @@ -200,9 +200,9 @@ void rtems_filesystem_location_clone( * * This function obtains and releases the file system instance lock. * - * @param[in] loc The location of the node. + * @param[in] loc is the location of the node. * - * @return The node type. + * @retval type The node type. * * @see rtems_filesystem_instance_lock(). */ @@ -215,9 +215,9 @@ rtems_filesystem_node_types_t rtems_filesystem_node_type( * * This function may block on a mutex and may complete an unmount process. * - * @param[in] loc The location to free. + * @param[in] loc is the location to free. * - * @note The file system root location is released by the file system instance + * NOTE: The file system root location is released by the file system instance * destruction handler (see @ref rtems_filesystem_fsunmount_me_t). * * @see rtems_filesystem_freenode_t. @@ -279,24 +279,24 @@ static inline void rtems_filesystem_instance_unlock( */ /** - * This routine searches the IOP Table for an unused entry. If it - * finds one, it returns it. Otherwise, it returns NULL. + * This routine searches the IOP Table for an unused entry. If it + * finds one, it returns it. Otherwise, it returns NULL. */ rtems_libio_t *rtems_libio_allocate(void); /** - * Convert UNIX fnctl(2) flags to ones that RTEMS drivers understand + * Convert UNIX fnctl(2) flags to ones that RTEMS drivers understand */ uint32_t rtems_libio_fcntl_flags( int fcntl_flags ); /** - * Convert RTEMS internal flags to UNIX fnctl(2) flags + * Convert RTEMS internal flags to UNIX fnctl(2) flags */ int rtems_libio_to_fcntl_flags( uint32_t flags ); /** - * This routine frees the resources associated with an IOP (file descriptor) - * and clears the slot in the IOP Table. + * This routine frees the resources associated with an IOP (file descriptor) + * and clears the slot in the IOP Table. */ void rtems_libio_free( rtems_libio_t *iop @@ -360,8 +360,8 @@ void rtems_filesystem_eval_path_cleanup_with_parent( * The function obtains the new start location and clones it to set the new * current location. The previous start and current locations are released. * - * @param[in, out] ctx The path evaluation context. - * @param[in, out] newstartloc_ptr Pointer to new start location. + * @param[in, out] ctx is the path evaluation context. + * @param[in, out] newstartloc_ptr is a pointer to the new start location. */ void rtems_filesystem_eval_path_restart( rtems_filesystem_eval_path_context_t *ctx, @@ -377,8 +377,8 @@ typedef enum { /** * @brief Tests if the current location is a directory. * - * @param[in, out] ctx The path evaluation context. - * @param[in, out] arg The handler argument. + * @param[in, out] ctx is the path evaluation context. + * @param[in, out] arg is the handler argument. * * @retval true The current location is a directory. * @retval false Otherwise. @@ -393,10 +393,10 @@ typedef bool (*rtems_filesystem_eval_path_is_directory)( /** * @brief Evaluates a token. * - * @param[in, out] ctx The path evaluation context. - * @param[in, out] arg The handler argument. - * @param[in] token The token contents. - * @param[in] tokenlen The token length in characters. + * @param[in, out] ctx is the path evaluation context. + * @param[in, out] arg is the handler argument. + * @param[in] token is the token contents. + * @param[in] tokenlen is the token length in characters. * * @retval status The generic path evaluation status. * @@ -416,7 +416,7 @@ typedef struct { } rtems_filesystem_eval_path_generic_config; /** - * @brief RTEMS File System Eval Generic Path + * @brief Evaluates a generic path. */ void rtems_filesystem_eval_path_generic( rtems_filesystem_eval_path_context_t *ctx, @@ -432,8 +432,8 @@ void rtems_filesystem_initialize(void); * A bitwise copy is performed. The destination location will be added to the * corresponding mount entry. * - * @param[out] dst The destination location. - * @param[in] src The source location. + * @param[out] dst is the destination location. + * @param[in] src is the source location. * * @retval dst The destination location. * @@ -463,9 +463,10 @@ rtems_filesystem_location_transform_to_global( /** * @brief Assigns a global file system location. * - * @param[in, out] lhs_global_loc_ptr Pointer to the global left hand side file - * system location. The current left hand side location will be released. - * @param[in] rhs_global_loc The global right hand side file system location. + * @param[in, out] lhs_global_loc_ptr is a pointer to the global + * left hand side file system location. The current left hand side location + * will be released. + * @param[in] rhs_global_loc is the global right hand side file system location. */ void rtems_filesystem_global_location_assign( rtems_filesystem_global_location_t **lhs_global_loc_ptr, @@ -480,7 +481,7 @@ void rtems_filesystem_global_location_assign( * This function must be called from normal thread context and may block on a * mutex. Thread dispatching is disabled to protect some critical sections. * - * @param[in] global_loc_ptr Pointer to the global file system location. + * @param[in] global_loc_ptr is a pointer to the global file system location. * * @return A global file system location. It returns always a valid object. * In case of an error, the global null location will be returned. Each @@ -506,7 +507,8 @@ rtems_filesystem_global_location_t *rtems_filesystem_global_location_obtain( * sections of the operating system. In this case the release will be * deferred. The next obtain call will do the actual release. * - * @param[in] global_loc The global file system location. It must not be NULL. + * @param[in] global_loc is the global file system location. It must not + * be NULL. * * @see rtems_filesystem_global_location_obtain(). */ @@ -555,7 +557,7 @@ static inline void rtems_filesystem_location_error( } } /** - * @brief RTEMS File System Mknod + * @brief Create a file. */ int rtems_filesystem_mknod( const rtems_filesystem_location_info_t *parentloc, @@ -568,7 +570,7 @@ int rtems_filesystem_mknod( int rtems_filesystem_chdir( rtems_filesystem_location_info_t *loc ); /** - * @brief Change Owner and Group of a File + * @brief Change the owner and the group of a file. */ int rtems_filesystem_chown( const char *path, @@ -700,7 +702,7 @@ static inline void rtems_filesystem_eval_path_put_back_token( } /** - * @brief RTEMS File System Eval Eat Delimiter Path + * @brief Evaluates an eat delimiter path. */ void rtems_filesystem_eval_path_eat_delimiter( rtems_filesystem_eval_path_context_t *ctx |