RTOS/rtems
1
0
Fork 0
forked from Imagelibrary/rtems
Code Pull Requests Activity

Whitespace removal.

Browse Source
This commit is contained in:
Ralf Corsepius
2009-11-28 05:58:54 +00:00
parent 1c9a4c7546
commit 20f02c63a7
34 changed files with 125 additions and 125 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
cpukit/score/include/rtems/score/address.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/address.h
*
* This include file contains the information required to manipulate

2
cpukit/score/include/rtems/score/apimutex.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file
*
* @ingroup ScoreAPIMutex

4
cpukit/score/include/rtems/score/bitfield.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/bitfield.h
*
* This include file contains all bit field manipulation routines.
@@ -37,7 +37,7 @@ extern "C" {
* This table is used by the generic bitfield routines to perform
* a highly optimized bit scan without the use of special CPU
* instructions.
*/
*/
#ifndef SCORE_INIT
extern const unsigned char __log2table[256];
#else

2
cpukit/score/include/rtems/score/chain.h
View File

@@ -146,7 +146,7 @@ Chain_Node *_Chain_Get(
* @brief Insert a node on a chain
*
* This routine inserts @a the_node on a chain immediately following
* @a after_node.
* @a after_node.
*
* @note It disables interrupts to ensure the atomicity
* of the extract operation.

4
cpukit/score/include/rtems/score/context.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/context.h
*
* This include file contains all information about each thread's context.
@@ -57,7 +57,7 @@ SCORE_EXTERN volatile bool _Context_Switch_necessary;
* thread's initial state.
*
* @param[in] _the_context will be initialized
* @param[in] _stack is the lowest physical address of the thread's
* @param[in] _stack is the lowest physical address of the thread's
* context
* @param[in] _size is the size in octets of the thread's context
* @param[in] _isr is the ISR enable level for this thread

2
cpukit/score/include/rtems/score/copyrt.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/copyrt.h
*
* This include file contains the copyright notice for RTEMS

2
cpukit/score/include/rtems/score/corebarrier.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/corebarrier.h
*
* This include file contains all the constants and structures associated

16
cpukit/score/include/rtems/score/coremsg.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/coremsg.h
*
* This include file contains all the constants and structures associated
@@ -106,7 +106,7 @@ typedef enum {
CORE_MESSAGE_QUEUE_DISCIPLINES_PRIORITY
} CORE_message_queue_Disciplines;
/**
/**
* @brief Message Priority for Appending
*
* This is the priority constant used when appending messages onto
@@ -114,7 +114,7 @@ typedef enum {
*/
#define CORE_MESSAGE_QUEUE_SEND_REQUEST INT_MAX
/**
/**
* @brief Message Priority for Prepending
*
* This is the priority constant used when prepending messages onto
@@ -228,7 +228,7 @@ typedef struct {
*/
CORE_message_queue_Buffer *message_buffers;
#if defined(RTEMS_SCORE_COREMSG_ENABLE_NOTIFICATION)
/** This is the routine invoked when the message queue transitions
/** This is the routine invoked when the message queue transitions
* from zero (0) messages pending to one (1) message pending.
*/
CORE_message_queue_Notify_Handler notify_handler;
@@ -255,7 +255,7 @@ typedef struct {
* may be sent to this message queue instance
*
* @return true if the message queue can be initialized. In general,
* false will only be returned if memory for the pending
* false will only be returned if memory for the pending
* messages cannot be allocated.
*/
bool _CORE_message_queue_Initialize(
@@ -337,7 +337,7 @@ uint32_t _CORE_message_queue_Flush_support(
* @param[in] size is the size of the message being broadcast
* @param[in] id is the RTEMS object Id associated with this message queue.
* It is used when unblocking a remote thread.
* @param[in] api_message_queue_mp_support is the routine to invoke if
* @param[in] api_message_queue_mp_support is the routine to invoke if
* a thread that is unblocked is actually a remote thread.
* @param[out] count points to the variable that will contain the
* number of tasks that are sent this message
@@ -368,7 +368,7 @@ CORE_message_queue_Status _CORE_message_queue_Broadcast(
* @param[in] size is the size of the message being send
* @param[in] id is the RTEMS object Id associated with this message queue.
* It is used when unblocking a remote thread.
* @param[in] api_message_queue_mp_support is the routine to invoke if
* @param[in] api_message_queue_mp_support is the routine to invoke if
* a thread that is unblocked is actually a remote thread.
* @param[in] submit_type determines whether the message is prepended,
* appended, or enqueued in priority order.
@@ -408,7 +408,7 @@ CORE_message_queue_Status _CORE_message_queue_Submit(
* if the message queue is empty.
* @param[in] timeout is the maximum number of clock ticks that the calling
* thread is willing to block if the message queue is empty.
*
*
* @return indication of the successful completion or reason for failure
* @note Returns message priority via return are in TCB.
*/

16
cpukit/score/include/rtems/score/coremutex.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/coremutex.h
*
* This include file contains all the constants and structures associated
@@ -71,7 +71,7 @@ typedef enum {
*/
CORE_MUTEX_DISCIPLINES_PRIORITY_CEILING
} CORE_mutex_Disciplines;
/**
* @brief Mutex method return statuses
*
@@ -195,7 +195,7 @@ typedef struct {
#ifdef __RTEMS_STRICT_ORDER_MUTEX__
/*@beief Core Mutex Lock_Chain Struct
*
* The following defines the control block used to manage lock chain of
* The following defines the control block used to manage lock chain of
* priority inheritance mutex.
*/
typedef struct{
@@ -245,7 +245,7 @@ typedef struct {
/** This field is used to manipulate the priority inheritance mutex queue*/
CORE_mutex_order_list queue;
#endif
} CORE_mutex_Control;
/**
@@ -310,7 +310,7 @@ RTEMS_INLINE_ROUTINE int _CORE_mutex_Seize_interrupt_trylock_body(
/**
* The default is to favor speed and inlining this definitely saves
* a few instructions. This is very important for mutex performance.
*
*
* @param[in] _mutex will attempt to lock
* @param[in] _level_p is the interrupt level holder
*/
@@ -349,16 +349,16 @@ void _CORE_mutex_Seize_interrupt_blocking(
*
* @note If the mutex is called from an interrupt service routine,
* with context switching disabled, or before multitasking,
* then a fatal error is generated.
* then a fatal error is generated.
*
* The logic on this routine is as follows:
*
* * If incorrect system state
* return an error
* return an error
* * If mutex is available without any contention or blocking
* obtain it with interrupts disabled and returned
* * If the caller is willing to wait
* then they are blocked.
* then they are blocked.
*/
#define _CORE_mutex_Seize_body( \

2
cpukit/score/include/rtems/score/corerwlock.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/corerwlock.h
*
* This include file contains all the constants and structures associated

2
cpukit/score/include/rtems/score/coresem.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/coresem.h
*
* This include file contains all the constants and structures associated

8
cpukit/score/include/rtems/score/corespinlock.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/corespinlock.h
*
* This include file contains all the constants and structures associated
@@ -50,11 +50,11 @@ typedef enum {
*/
CORE_SPINLOCK_NOT_HOLDER,
/** This status indicates that a thread reached the limit of time it
* was willing to wait on the spin lock.
* was willing to wait on the spin lock.
*/
CORE_SPINLOCK_TIMEOUT,
/** This status indicates that a thread is currently waiting for this
* spin lock.
* spin lock.
*/
CORE_SPINLOCK_IS_BUSY,
/** This status indicates that the spinlock is currently locked and thus
@@ -92,7 +92,7 @@ typedef struct {
*/
typedef struct {
/** XXX may not be needed */
CORE_spinlock_Attributes Attributes;
CORE_spinlock_Attributes Attributes;
/** This field is the lock.
*/

2
cpukit/score/include/rtems/score/interr.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/interr.h
*
* This include file contains constants and prototypes related

4
cpukit/score/include/rtems/score/isr.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/isr.h
*
* This include file contains all the constants and structures associated
@@ -199,7 +199,7 @@ void _ISR_Dispatch( void );
* Invokes the thread dispatcher or signal extension if necessary.
*
* It should be called at the end of interrupt processing. The interrupt nest
* level must be zero before calling this routine.
* level must be zero before calling this routine.
*
* This is a high level replacement of _ISR_Dispatch(). It must be invoked
* within an environment such that a call to _Thread_Dispatch() is allowed.

20
cpukit/score/include/rtems/score/mpci.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/mpci.h
*
* This include file contains all the constants and structures associated
@@ -23,7 +23,7 @@
* @defgroup ScoreMPCI MPCI Handler
*
* The MPCI Handler encapsulates functionality which is related to the
* generation, receipt, and processing of remote operations in a
* generation, receipt, and processing of remote operations in a
* multiprocessor system. This handler contains the message passing
* support for making remote service calls as well as the server thread
* which processes requests from remote nodes.
@@ -67,7 +67,7 @@ typedef MPCI_Entry ( *MPCI_initialization_entry )( void );
/**
* This type defines the prototype for the get packet entry point
* in an Multiprocessor Communications Interface. The single
* in an Multiprocessor Communications Interface. The single
* parameter will point to the packet allocated.
*/
typedef MPCI_Entry ( *MPCI_get_packet_entry )(
@@ -76,7 +76,7 @@ typedef MPCI_Entry ( *MPCI_get_packet_entry )(
/**
* This type defines the prototype for the return packet entry point
* in an Multiprocessor Communications Interface. The single
* in an Multiprocessor Communications Interface. The single
* parameter will point to a packet previously allocated by the
* get packet MPCI entry.
*/
@@ -86,7 +86,7 @@ typedef MPCI_Entry ( *MPCI_return_packet_entry )(
/**
* This type defines the prototype for send get packet entry point
* in an Multiprocessor Communications Interface. The single
* in an Multiprocessor Communications Interface. The single
* parameter will point to a packet previously allocated by the
* get packet entry point that has been filled in by the caller.
*/
@@ -97,7 +97,7 @@ typedef MPCI_Entry ( *MPCI_send_entry )(
/**
* This type defines the prototype for the receive packet entry point
* in an Multiprocessor Communications Interface. The single
* in an Multiprocessor Communications Interface. The single
* parameter will point to a packet allocated and filled in by the
* receive packet handler. The caller will block until a packet is
* received.
@@ -118,7 +118,7 @@ typedef struct {
/** This fields contains the timeout for MPCI operations in ticks. */
uint32_t default_timeout;
/** This field contains the maximum size of a packet supported by this
* MPCI layer. This size places a limit on the size of a message
* MPCI layer. This size places a limit on the size of a message
* which can be transmitted over this interface.
**/
size_t maximum_packet_size;
@@ -161,7 +161,7 @@ typedef struct {
* on all nodes.
*/
uint32_t maximum_nodes;
/** This field is the maximum number of concurrently existent
/** This field is the maximum number of concurrently existent
* globally offered objects.
*/
uint32_t maximum_global_objects;
@@ -221,7 +221,7 @@ void _MPCI_Initialization ( void );
*
* @param[in] the_class is the class indicator for packets which will
* be processed by @a the_packet_processor method.
* @param[in] the_packet_processor is a pointer to a method which is
* @param[in] the_packet_processor is a pointer to a method which is
* invoked when packets with @a the_class are received.
*/
void _MPCI_Register_packet_processor(
@@ -309,7 +309,7 @@ MP_packet_Prefix *_MPCI_Receive_packet ( void );
* @param[in] the_packet is the response packet to be processed.
*
* @return This method returns a pointer to the thread which was if unblocked
* or NULL if the waiting thread no longer exists.
* or NULL if the waiting thread no longer exists.
*/
Thread_Control *_MPCI_Process_response (
MP_packet_Prefix *the_packet

2
cpukit/score/include/rtems/score/mppkt.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/mppkt.h
*
* This package is the specification for the Packet Handler.

18
cpukit/score/include/rtems/score/object.h
View File

@@ -552,7 +552,7 @@ void _Objects_Free(
/**
* This macro is used to build a thirty-two bit style name from
* four characters. The most significant byte will be the
* four characters. The most significant byte will be the
* character @a _C1.
*
* @param[in] _C1 is the first character of the name
@@ -605,7 +605,7 @@ typedef enum {
* @param[in] node is the set of nodes to search.
* @param[in] id will contain the Id if the search is successful.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a id will contain the Id of
* the requested object.
@@ -626,7 +626,7 @@ Objects_Name_or_id_lookup_errors _Objects_Name_to_id_u32(
* @param[in] name is the name of the object to find.
* @param[in] id will contain the Id if the search is successful.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a id will contain the Id of
* the requested object.
@@ -646,7 +646,7 @@ Objects_Name_or_id_lookup_errors _Objects_Name_to_id_string(
* @param[in] id is the Id of the object whose name we are locating.
* @param[in] name will contain the name of the object, if found.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a name will contain the name of
* the requested object.
@@ -672,7 +672,7 @@ Objects_Name_or_id_lookup_errors _Objects_Id_to_name (
* @param[in] id is the Id of the object whose name we are locating.
* @param[in] location will contain an indication of success or failure.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a id will contain the Id of
* the requested object.
@@ -703,7 +703,7 @@ Objects_Control *_Objects_Get (
* @param[in] location will contain an indication of success or failure.
* @param[in] level is the interrupt level being turned.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a name will contain the name of
* the requested object.
@@ -732,7 +732,7 @@ Objects_Control *_Objects_Get_isr_disable(
*
* @return This method returns a pointer to the object associated with ID.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a id will contain the id of
* the requested object.
@@ -762,7 +762,7 @@ Objects_Control *_Objects_Get_by_index (
* @param[in] id is the Id of the object whose name we are locating.
* @param[in] location will contain an indication of success or failure.
*
* @return This method returns one of the values from the
* @return This method returns one of the values from the
* @ref Objects_Name_or_id_lookup_errors enumeration to indicate
* successful or failure. On success @a id will contain the Id of
* the requested object.
@@ -786,7 +786,7 @@ Objects_Control *_Objects_Get_no_protection(
* @param[in] location_p will contain an indication of success or failure.
* @param[in] next_id_p is the Id of the next object we will look at.
*
* @return This method returns the pointer to the object located or
* @return This method returns the pointer to the object located or
* NULL on error.
*/
Objects_Control *_Objects_Get_next(

2
cpukit/score/include/rtems/score/objectmp.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/objectmp.h
*
* This include file contains all the constants and structures associated

6
cpukit/score/include/rtems/score/priority.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/priority.h
*
* This include file contains all thread priority manipulation routines.
@@ -26,8 +26,8 @@
* This handler encapsulates functionality which is used to manage
* thread priorities. At the SuperCore level 256 priority levels
* are supported with lower numbers representing logically more important
* threads. The priority level 0 is reserved for internal RTEMS use.
* Typically it is assigned to threads which defer internal RTEMS
* threads. The priority level 0 is reserved for internal RTEMS use.
* Typically it is assigned to threads which defer internal RTEMS
* actions from an interrupt to thread level to improve interrupt response.
* Priority level 255 is assigned to the IDLE thread and really should not
* be used by application threads. The default IDLE thread implementation

2
cpukit/score/include/rtems/score/stack.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/stack.h
*
* This include file contains all information about the thread

6
cpukit/score/include/rtems/score/states.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/states.h
*
* This include file contains thread execution state information.
@@ -21,7 +21,7 @@
/**
* @defgroup ScoreStates Thread States Handler
*
* This handler encapsulates functionality which relates to the management of
* This handler encapsulates functionality which relates to the management of
* the state bitmap associated with each thread.
*/
/**@{*/
@@ -97,7 +97,7 @@ typedef uint32_t States_Control;
STATES_WAITING_FOR_JOIN_AT_EXIT | \
STATES_WAITING_FOR_SIGNAL | \
STATES_WAITING_FOR_BARRIER | \
STATES_WAITING_FOR_RWLOCK )
STATES_WAITING_FOR_RWLOCK )
/** This macro corresponds to a task waiting which is blocked on
* a thread queue. */

4
cpukit/score/include/rtems/score/sysstate.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file
*
* @ingroup ScoreSysState
@@ -50,7 +50,7 @@ typedef enum {
SYSTEM_STATE_BEFORE_MULTITASKING,
/**
* @brief The system is attempting to initiate multitasking.
* @brief The system is attempting to initiate multitasking.
*/
SYSTEM_STATE_BEGIN_MULTITASKING,

10
cpukit/score/include/rtems/score/thread.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/thread.h
*
* This include file contains all constants and structures associated
@@ -92,7 +92,7 @@ typedef void *Thread;
/**
* @brief Type of the numeric argument of a thread entry function with at
* least one numeric argument.
* least one numeric argument.
*
* This numeric argument type designates an unsigned integer type with the
* property that any valid pointer to void can be converted to this type and
@@ -274,13 +274,13 @@ typedef struct {
/** This field contains any options in effect on this blocking operation. */
uint32_t option;
/** This field will contain the return status from a blocking operation.
*
*
* @note The following assumes that all API return codes can be
* treated as an uint32_t.
*/
uint32_t return_code;
/** This field is the chain header for the second through Nth tasks
/** This field is the chain header for the second through Nth tasks
* of the same priority blocked waiting on the same object.
*/
Chain_Control Block2n;
@@ -377,7 +377,7 @@ struct Thread_Control_struct {
/** This field is true if the thread is offered globally */
bool is_global;
#endif
/** This field is is true if the post task context switch should be
/** This field is is true if the post task context switch should be
* executed for this thread at the next context switch.
*/
bool do_post_task_switch_extension;

4
cpukit/score/include/rtems/score/threadmp.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/threadmp.h
*
* This include file contains the specification for all routines
@@ -22,7 +22,7 @@
/**
* @defgroup ScoreThreadMP Thread Handler Multiprocessing Support
*
* This handler encapsulates functionality which is related to managing
* This handler encapsulates functionality which is related to managing
* threads in a multiprocessor system configuration. This handler must
* manage proxies which represent remote threads blocking on local
* operations.

8
cpukit/score/include/rtems/score/threadq.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/threadq.h
*
* This include file contains all the constants and structures associated
@@ -81,7 +81,7 @@ Thread_Control *_Thread_queue_Dequeue(
_the_thread_queue, \
_timeout, \
_Thread_queue_Timeout )
/** @brief Thread queue Enqueue
*
@@ -192,7 +192,7 @@ Thread_blocking_operation_States _Thread_queue_Enqueue_priority (
void _Thread_queue_Extract_priority_helper(
Thread_queue_Control *the_thread_queue,
Thread_Control *the_thread,
bool requeuing
bool requeuing
);
/**
@@ -273,7 +273,7 @@ void _Thread_queue_Timeout (
/**
* @brief Process Thread Queue Timeout
*
* This is a shared helper routine which makes it easier to have multiple
* This is a shared helper routine which makes it easier to have multiple
* object class specific timeout routines.
*
* @param[in] the_thread is the thread to extract

4
cpukit/score/include/rtems/score/threadsync.h
View File

@@ -1,8 +1,8 @@
/**
/**
* @file rtems/score/threadsync.h
*
* This include file contains all constants and structures associated
* with synchronizing a thread blocking operation with potential
* with synchronizing a thread blocking operation with potential
* actions in an ISR.
*/

16
cpukit/score/include/rtems/score/timespec.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/timespec.h
*
* This include file contains helpers for manipulating timespecs.
@@ -89,7 +89,7 @@ extern "C" {
*
* @param[in] time is the timespec instance to validate.
*
* @return This method returns true if @a time is valid and
* @return This method returns true if @a time is valid and
* false otherwise.
*/
bool _Timespec_Is_valid(
@@ -103,7 +103,7 @@ bool _Timespec_Is_valid(
* @param[in] lhs is the left hand side timespec
* @param[in] rhs is the right hand side timespec
*
* @return This method returns true if @a lhs is less than the @a rhs and
* @return This method returns true if @a lhs is less than the @a rhs and
* false otherwise.
*/
bool _Timespec_Less_than(
@@ -118,7 +118,7 @@ bool _Timespec_Less_than(
* @param[in] lhs is the left hand side timespec
* @param[in] rhs is the right hand side timespec
*
* @return This method returns true if @a lhs is greater than the @a rhs and
* @return This method returns true if @a lhs is greater than the @a rhs and
* false otherwise.
*/
bool _Timespec_Greater_than(
@@ -133,7 +133,7 @@ bool _Timespec_Greater_than(
* @param[in] lhs is the left hand side timespec
* @param[in] rhs is the right hand side timespec
*
* @return This method returns true if @a lhs is equal to @a rhs and
* @return This method returns true if @a lhs is equal to @a rhs and
* false otherwise.
*/
#define _Timespec_Equal_to( lhs, rhs ) \
@@ -147,7 +147,7 @@ bool _Timespec_Greater_than(
* to the first.
*
* @param[in] time is the base time to be added to
* @param[in] add is the timespec to add to the first argument
* @param[in] add is the timespec to add to the first argument
*
* @return This method returns the number of seconds @a time increased by.
*/
@@ -202,7 +202,7 @@ void _Timespec_Subtract(
/** @brief Divide Timespec By Integer
*
* This routine divides a timespec by an integer value. The expected
* use is to assist in benchmark calculations where you typically
* use is to assist in benchmark calculations where you typically
* divide a duration by a number of iterations.
*
* @param[in] time is the total
@@ -219,7 +219,7 @@ void _Timespec_Divide_by_integer(
/** @brief Divide Timespec
*
* This routine divides a timespec by another timespec. The
* This routine divides a timespec by another timespec. The
* intended use is for calculating percentages to three decimal points.
*
* @param[in] lhs is the left hand number

32
cpukit/score/include/rtems/score/timestamp.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/timestamp.h
*
* This include file contains helpers for manipulating timestamps.
@@ -48,7 +48,7 @@ extern "C" {
* NOTE: Eventually each port should select what it should use!!!
*
* These control which implementation of SuperCore Timestamp is used.
*
*
* if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
* struct timespec is used
* else if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_INT64)
@@ -63,26 +63,26 @@ extern "C" {
* Performance of int64_t versus struct timespec
* =============================================
*
* On PowerPC/psim, inlined int64_t saves ~50 instructions on each
* On PowerPC/psim, inlined int64_t saves ~50 instructions on each
* _Thread_Dispatch operation which results in a context switch.
* This works out to be about 10% faster dispatches and 7.5% faster
* blocking semaphore obtains. The following numbers are in instructions
* and from tm02 and tm26.
*
* timespec int64 inlined int64
* timespec int64 inlined int64
* dispatch: 446 446 400
* blocking sem obtain: 627 626 581
*
* On SPARC/sis, inlined int64_t shows the same percentage gains.
* The following numbers are in microseconds and from tm02 and tm26.
*
* timespec int64 inlined int64
* timespec int64 inlined int64
* dispatch: 59 61 53
* blocking sem obtain: 98 100 92
*
* Inlining appears to have a tendency to increase the size of
* some executables.
* Not inlining reduces the execution improvement but does not seem to
* Not inlining reduces the execution improvement but does not seem to
* be an improvement on the PowerPC and SPARC. The struct timespec
* and the executables with int64 not inlined are about the same size.
*
@@ -168,7 +168,7 @@ extern "C" {
*
* @param[in] _time points to the timestamp instance to validate.
*
* @return This method returns true if @a time is valid and
* @return This method returns true if @a time is valid and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
@@ -186,7 +186,7 @@ extern "C" {
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is less than the @a _rhs and
* @return This method returns true if @a _lhs is less than the @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
@@ -204,7 +204,7 @@ extern "C" {
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is greater than the @a _rhs and
* @return This method returns true if @a _lhs is greater than the @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
@@ -222,7 +222,7 @@ extern "C" {
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is equal to @a _rhs and
* @return This method returns true if @a _lhs is equal to @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
@@ -239,7 +239,7 @@ extern "C" {
* to the first.
*
* @param[in] _time points to the base time to be added to
* @param[in] _add points to the timestamp to add to the first argument
* @param[in] _add points to the timestamp to add to the first argument
*
* @return This method returns the number of seconds @a time increased by.
*/
@@ -255,7 +255,7 @@ extern "C" {
*
* This routine adds two timestamps. The second argument is added
* to the first.
*
*
* @node This routine places a special requirement on the addition
* operation. It must return the number of units that the
* seconds field changed as the result of the addition. Since this
@@ -263,7 +263,7 @@ extern "C" {
* it is generally safe to assume that only one second changed.
*
* @param[in] _time points to the base time to be added to
* @param[in] _add points to the timestamp to add to the first argument
* @param[in] _add points to the timestamp to add to the first argument
*
* @return This method returns the number of seconds @a time increased by.
*/
@@ -331,7 +331,7 @@ extern "C" {
/** @brief Divide Timestamp By Integer
*
* This routine divides a timestamp by an integer value. The expected
* use is to assist in benchmark calculations where you typically
* use is to assist in benchmark calculations where you typically
* divide a duration by a number of iterations.
*
* @param[in] _time points to the total
@@ -350,7 +350,7 @@ extern "C" {
/** @brief Divide Timestamp
*
* This routine divides a timestamp by another timestamp. The
* This routine divides a timestamp by another timestamp. The
* intended use is for calculating percentages to three decimal points.
*
* @param[in] _lhs points to the left hand number
@@ -410,7 +410,7 @@ extern "C" {
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC)
/* in this case we know they are the same type so use simple assignment */
#define _Timestamp_To_timespec( _timestamp, _timespec ) \
*(_timespec) = *(_timestamp)
*(_timespec) = *(_timestamp)
#else
#define _Timestamp_To_timespec( _timestamp, _timespec ) \
_Timestamp64_To_timespec( _timestamp, _timespec )

22
cpukit/score/include/rtems/score/timestamp64.h
View File

@@ -1,7 +1,7 @@
/**
/**
* @file rtems/score/timestamp64.h
*
* This include file contains helpers for manipulating
* This include file contains helpers for manipulating
* 64-bit integer timestamps.
*/
@@ -96,7 +96,7 @@ typedef int64_t Timestamp64_Control;
*
* @param[in] _time points to the timestamp instance to validate.
*
* @return This method returns true if @a time is valid and
* @return This method returns true if @a time is valid and
* false otherwise.
*/
#define _Timestamp64_Is_valid( _time ) \
@@ -109,7 +109,7 @@ typedef int64_t Timestamp64_Control;
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is less than the @a _rhs and
* @return This method returns true if @a _lhs is less than the @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE)
@@ -129,7 +129,7 @@ typedef int64_t Timestamp64_Control;
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is greater than the @a _rhs and
* @return This method returns true if @a _lhs is greater than the @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE)
@@ -149,7 +149,7 @@ typedef int64_t Timestamp64_Control;
* @param[in] _lhs points to the left hand side timestamp
* @param[in] _rhs points to the right hand side timestamp
*
* @return This method returns true if @a _lhs is equal to @a _rhs and
* @return This method returns true if @a _lhs is equal to @a _rhs and
* false otherwise.
*/
#if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE)
@@ -168,7 +168,7 @@ typedef int64_t Timestamp64_Control;
* to the first.
*
* @param[in] _time points to the base time to be added to
* @param[in] _add points to the timestamp to add to the first argument
* @param[in] _add points to the timestamp to add to the first argument
*
* @return This method returns the number of seconds @a time increased by.
*/
@@ -186,7 +186,7 @@ typedef int64_t Timestamp64_Control;
*
* This routine adds two timestamps. The second argument is added
* to the first.
*
*
* @node This routine places a special requirement on the addition
* operation. It must return the number of units that the
* seconds field changed as the result of the addition. Since this
@@ -194,7 +194,7 @@ typedef int64_t Timestamp64_Control;
* it is generally safe to assume that only one second changed.
*
* @param[in] _time points to the base time to be added to
* @param[in] _add points to the timestamp to add to the first argument
* @param[in] _add points to the timestamp to add to the first argument
*
* @return This method returns the number of seconds @a time increased by.
*/
@@ -265,7 +265,7 @@ void _Timestamp64_From_ticks(
/** @brief Divide Timestamp By Integer
*
* This routine divides a timestamp by an integer value. The expected
* use is to assist in benchmark calculations where you typically
* use is to assist in benchmark calculations where you typically
* divide a duration by a number of iterations.
*
* @param[in] _time points to the total
@@ -289,7 +289,7 @@ void _Timestamp64_From_ticks(
/** @brief Divide Timestamp
*
* This routine divides a timestamp by another timestamp. The
* This routine divides a timestamp by another timestamp. The
* intended use is for calculating percentages to three decimal points.
*
* @param[in] _lhs points to the left hand number

10
cpukit/score/include/rtems/score/tod.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/tod.h
*
* This include file contains all the constants and structures associated
@@ -112,7 +112,7 @@ extern "C" {
/**
* @defgroup ScoreTOD Time Of Day (TOD) Handler
*
* This handler encapsulates functionality used to manage time of day.
* This handler encapsulates functionality used to manage time of day.
*/
/**@{*/
@@ -158,7 +158,7 @@ void _TOD_Set(
/** @brief _TOD_Get
*
* This routine returns the current time of day with potential accuracy
* to the nanosecond.
* to the nanosecond.
*
* @param[in] time is a pointer to the time to be returned
*/
@@ -169,7 +169,7 @@ void _TOD_Get(
/** @brief _TOD_Get_uptime
*
* This routine returns the system uptime with potential accuracy
* to the nanosecond.
* to the nanosecond.
*
* @param[in] time is a pointer to the uptime to be returned
*/
@@ -180,7 +180,7 @@ void _TOD_Get_uptime(
/** @brief _TOD_Get_uptime_as_timespec
*
* This routine returns the system uptime with potential accuracy
* to the nanosecond.
* to the nanosecond.
*
* @param[in] time is a pointer to the uptime to be returned
*/

2
cpukit/score/include/rtems/score/tqdata.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/tqdata.h
*
* This include file contains all the constants and structures

2
cpukit/score/include/rtems/score/userext.h
View File

@@ -139,7 +139,7 @@ typedef void( *User_extensions_thread_restart_extension )(
* The context switches initiated through _Thread_Start_multitasking() and
* _Thread_Stop_multitasking() are not covered by this extension. The
* executing thread may run with a minimal setup, for example with a freed task
* stack.
* stack.
*/
typedef void( *User_extensions_thread_switch_extension )(
Thread_Control *,

8
cpukit/score/include/rtems/score/watchdog.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/watchdog.h
*
* This include file contains all the constants and structures associated
@@ -58,7 +58,7 @@ typedef uint32_t Watchdog_Interval;
typedef uint32_t (*Watchdog_Nanoseconds_since_last_tick_routine)(void);
/** @brief Watchdog Service Routine Return Type
*
*
* This type defines the return type from a Watchdog Service Routine.
*/
typedef void Watchdog_Service_routine;
@@ -197,7 +197,7 @@ void _Watchdog_Handler_initialization( void );
*
* This routine removes @a the_watchdog from the watchdog chain on which
* it resides and returns the state @a the_watchdog timer was in.
*
*
* @param[in] the_watchdog will be removed
* @return the state in which @a the_watchdog was in when removed
*/
@@ -242,7 +242,7 @@ void _Watchdog_Adjust_to_chain(
/** @brief Watchdog Insert
*
* This routine inserts @a the_watchdog into the @a header watchdog chain
* for a time of @a units.
* for a time of @a units.
*
* @param[in] header is @a the_watchdog list to insert @a the_watchdog on
* @param[in] the_watchdog is the watchdog to insert

4
cpukit/score/include/rtems/score/wkspace.h
View File

@@ -1,4 +1,4 @@
/**
/**
* @file rtems/score/wkspace.h
*
* This include file contains information related to the
@@ -37,7 +37,7 @@ extern "C" {
/** @brief Executive Workspace Control
*
* The is the heap control structure that used to manage the
* The is the heap control structure that used to manage the
* RTEMS Executive Workspace.
*/
SCORE_EXTERN Heap_Control _Workspace_Area; /* executive heap header */