Imagelibrary/rtems
1
0
Fork 1
mirror of https://gitlab.rtems.org/rtems/rtos/rtems.git synced 2025-12-05 15:15:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

2004-05-06 Joel Sherrill <joel@OARcorp.com>

Browse Source 
PR 618/rtems
	* user/clock.t, user/dpmem.t, user/event.t, user/msg.t, user/part.t,
	user/region.t, user/sem.t, user/task.t, user/timer.t: Add NULL
	checks.
This commit is contained in:
Joel Sherrill
2004-05-06 19:21:50 +00:00
parent e980b21979
commit f8892c9bdb
10 changed files with 70 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
doc/ChangeLog
View File

@@ -1,3 +1,10 @@
2004-05-06 Joel Sherrill <joel@OARcorp.com>
PR 618/rtems
* user/clock.t, user/dpmem.t, user/event.t, user/msg.t, user/part.t,
user/region.t, user/sem.t, user/task.t, user/timer.t: Add NULL
checks.
2004-03-31 Ralf Corsepius <ralf_corsepius@rtems.org>
* started/buildc.t: Use tar xjf for bzip'ed files.

6
doc/user/clock.t
View File

@@ -262,6 +262,7 @@ procedure Clock_Set (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - date and time set successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{time_buffer} is NULL@*
@code{@value{RPREFIX}INVALID_TIME_OF_DAY} - invalid time of day
@subheading DESCRIPTION:
@@ -320,7 +321,8 @@ procedure Clock_Get (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - current time obtained successfully@*
@code{@value{RPREFIX}NOT_DEFINED} - system date and time is not set
@code{@value{RPREFIX}NOT_DEFINED} - system date and time is not set@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{time_buffer} is NULL
@subheading DESCRIPTION:
@@ -414,7 +416,7 @@ procedure Clock_Tick (
@end ifset
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - current time obtained successfully
@code{@value{RPREFIX}SUCCESSFUL} - clock tick processed successfully
@subheading DESCRIPTION:

8
doc/user/dpmem.t
View File

@@ -139,6 +139,7 @@ procedure Port_Create (
@code{@value{RPREFIX}SUCCESSFUL} - port created successfully@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_ADDRESS} - address not on four byte boundary@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}TOO_MANY} - too many DP memory areas created
@subheading DESCRIPTION:
@@ -195,6 +196,7 @@ procedure Port_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - port identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - port name not found
@subheading DESCRIPTION:
@@ -291,7 +293,8 @@ procedure Port_External_To_Internal (
@end ifset
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - always successful
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{internal} is NULL@*
@code{@value{RPREFIX}SUCCESSFUL} - successful conversion
@subheading DESCRIPTION:
@@ -341,7 +344,8 @@ procedure Port_Internal_To_External (
@end ifset
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - always successful
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{external} is NULL@*
@code{@value{RPREFIX}SUCCESSFUL} - successful conversion
@subheading DESCRIPTION:

1
doc/user/event.t
View File

@@ -295,6 +295,7 @@ procedure Event_Receive (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - event received successfully@*
@code{@value{RPREFIX}UNSATISFIED} - input event not satisfied (@code{@value{RPREFIX}NO_WAIT})@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{event_out} is NULL@*
@code{@value{RPREFIX}TIMEOUT} - timed out waiting for event
@subheading DESCRIPTION:

10
doc/user/msg.t
View File

@@ -255,6 +255,7 @@ procedure Message_Queue_Create (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - queue created successfully@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NUMBER} - invalid message count@*
@code{@value{RPREFIX}INVALID_SIZE} - invalid message size@*
@code{@value{RPREFIX}TOO_MANY} - too many queues created@*
@@ -341,6 +342,7 @@ procedure Message_Queue_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - queue identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - queue name not found@*
@code{@value{RPREFIX}INVALID_NODE} - invalid node id
@@ -473,6 +475,7 @@ procedure Message_Queue_Send (
@code{@value{RPREFIX}SUCCESSFUL} - message sent successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id@*
@code{@value{RPREFIX}INVALID_SIZE} - invalid message size@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}UNSATISFIED} - out of message buffers@*
@code{@value{RPREFIX}TOO_MANY} - queue's limit has been reached
@@ -537,6 +540,7 @@ procedure Message_Queue_Urgent (
@code{@value{RPREFIX}SUCCESSFUL} - message sent successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id@*
@code{@value{RPREFIX}INVALID_SIZE} - invalid message size@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}UNSATISFIED} - out of message buffers@*
@code{@value{RPREFIX}TOO_MANY} - queue's limit has been reached
@@ -603,6 +607,8 @@ procedure Message_Queue_Broadcast (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - message broadcasted successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{count} is NULL@*
@code{@value{RPREFIX}INVALID_SIZE} - invalid message size
@subheading DESCRIPTION:
@@ -674,6 +680,8 @@ procedure Message_Queue_Receive (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - message received successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{count} is NULL@*
@code{@value{RPREFIX}UNSATISFIED} - queue is empty@*
@code{@value{RPREFIX}TIMEOUT} - timed out waiting for message@*
@code{@value{RPREFIX}OBJECT_WAS_DELETED} - queue deleted while waiting
@@ -759,6 +767,7 @@ procedure Message_Queue_Get_Number_Pending (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - number of messages pending returned successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{count} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id
@subheading DESCRIPTION:
@@ -807,6 +816,7 @@ procedure Message_Queue_Flush (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - message queue flushed successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{count} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid queue id
@subheading DESCRIPTION:

5
doc/user/part.t
View File

@@ -173,6 +173,8 @@ procedure Partition_Create (
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}TOO_MANY} - too many partitions created@*
@code{@value{RPREFIX}INVALID_ADDRESS} - address not on four byte boundary@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{starting_address} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_SIZE} - length or buffer size is 0@*
@code{@value{RPREFIX}INVALID_SIZE} - length is less than the buffer size@*
@code{@value{RPREFIX}INVALID_SIZE} - buffer size not a multiple of 4@*
@@ -257,6 +259,7 @@ procedure Partition_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - partition identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - partition name not found@*
@code{@value{RPREFIX}INVALID_NODE} - invalid node id
@@ -376,6 +379,7 @@ procedure Partition_Get_Buffer (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - buffer obtained successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid partition id@*
@code{@value{RPREFIX}UNSATISFIED} - all buffers are allocated
@@ -430,6 +434,7 @@ procedure Partition_Return_Buffer (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - buffer returned successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{buffer} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid partition id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - buffer address not in partition

8
doc/user/region.t
View File

@@ -263,6 +263,8 @@ procedure Region_Create (
@code{@value{RPREFIX}SUCCESSFUL} - region created successfully@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{starting_address} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - address not on four byte boundary@*
@code{@value{RPREFIX}TOO_MANY} - too many regions created@*
@code{@value{RPREFIX}INVALID_SIZE} - invalid page size
@@ -339,6 +341,7 @@ procedure Region_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - region identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - region name not found
@subheading DESCRIPTION:
@@ -439,6 +442,7 @@ procedure Region_Extend (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - region extended successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{starting_address} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid region id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - invalid address of area to add
@@ -494,6 +498,7 @@ procedure Region_Get_Segment (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - segment obtained successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{segment} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid region id@*
@code{@value{RPREFIX}INVALID_SIZE} - request is for zero bytes or exceeds
the size of maximum segment which is possible for this region@*
@@ -581,6 +586,7 @@ procedure Region_Return_Segment (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - segment returned successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{segment} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid region id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - segment address not in region
@@ -642,6 +648,8 @@ procedure Region_Get_Segment_Size (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - segment obtained successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{segment} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{size} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid region id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - segment address not in region

1
doc/user/sem.t
View File

@@ -409,6 +409,7 @@ procedure Semaphore_Create (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - semaphore created successfully@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}TOO_MANY} - too many semaphores created@*
@code{@value{RPREFIX}NOT_DEFINED} - invalid attribute set@*
@code{@value{RPREFIX}INVALID_NUMBER} - invalid starting count for binary semaphore@*

30
doc/user/task.t
View File

@@ -712,6 +712,7 @@ procedure Task_Create (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - task created successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_SIZE} - stack too small@*
@code{@value{RPREFIX}INVALID_PRIORITY} - invalid task priority@*
@@ -819,6 +820,7 @@ procedure Task_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - task identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - invalid task name@*
@code{@value{RPREFIX}INVALID_NODE} - invalid node id
@@ -1260,7 +1262,7 @@ rtems_status_code rtems_task_mode(
@ifset is-Ada
@example
procedure Task_Delete (
procedure Task_Mode (
Mode_Set : in RTEMS.Mode;
Mask : in RTEMS.Mode;
Previous_Mode_Set : in RTEMS.Mode;
@@ -1270,7 +1272,8 @@ procedure Task_Delete (
@end ifset
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - task mode set successfully
@code{@value{RPREFIX}SUCCESSFUL} - task mode set successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{previous_mode_set} is NULL
@subheading DESCRIPTION:
This directive manipulates the execution mode of the calling
@@ -1431,6 +1434,7 @@ procedure Task_Get_Note (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - note obtained successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{note} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid task id@*
@code{@value{RPREFIX}INVALID_NUMBER} - invalid notepad location
@@ -1589,6 +1593,7 @@ procedure Task_Wake_When (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - awakened at date/time successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{time_buffer} is NULL@*
@code{@value{RPREFIX}INVALID_TIME_OF_DAY} - invalid time buffer@*
@code{@value{RPREFIX}NOT_DEFINED} - system date and time is not set
@@ -1618,7 +1623,7 @@ A clock tick is required to support the functionality of this directive.
@example
rtems_status_code rtems_task_variable_add(
rtems_id tid,
void **ptr,
void **task_variable,
void (*dtor)(void *)
);
@end example
@@ -1641,6 +1646,7 @@ procedure Task_Variable_Add (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - per task variable added successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{task_variable} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid task id@*
@code{@value{RPREFIX}NO_MEMORY} - invalid task id@*
@code{@value{RPREFIX}ILLEGAL_ON_REMOTE_OBJECT} - not supported on remote tasks@*
@@ -1680,8 +1686,8 @@ In this case the destructor function could be `free'.
@example
rtems_status_code rtems_task_variable_get(
rtems_id tid,
void **ptr,
void **result
void **task_variable,
void **task_variable_value
);
@end example
@end ifset
@@ -1699,7 +1705,9 @@ procedure Task_Variable_Get (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - per task variable added successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid task id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{task_variable} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{task_variable_value} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{task_variable} is not found@*
@code{@value{RPREFIX}NO_MEMORY} - invalid task id@*
@code{@value{RPREFIX}ILLEGAL_ON_REMOTE_OBJECT} - not supported on remote tasks@*
@@ -1711,9 +1719,10 @@ task, which can get its private value by directly accessing the variable.
@subheading NOTES:
If you change memory which @code{result} points to, remember to declare that
memory as volatile, so that the compiler will optimize it correctly. In this
case both the pointer @code{result} and data referenced by @code{result}
If you change memory which @code{task_variable_value} points to,
remember to declare that memory as volatile, so that the compiler
will optimize it correctly. In this case both the pointer
@code{task_variable_value} and data referenced by @code{task_variable_value}
should be considered volatile.
@page
@@ -1731,7 +1740,7 @@ should be considered volatile.
@example
rtems_status_code rtems_task_variable_delete(
rtems_id tid,
void **ptr
void **task_variable
);
@end example
@end ifset
@@ -1750,6 +1759,7 @@ procedure Task_Variable_Delete (
@code{@value{RPREFIX}SUCCESSFUL} - per task variable added successfully@*
@code{@value{RPREFIX}INVALID_ID} - invalid task id@*
@code{@value{RPREFIX}NO_MEMORY} - invalid task id@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{task_variable} is NULL@*
@code{@value{RPREFIX}ILLEGAL_ON_REMOTE_OBJECT} - not supported on remote tasks@*
@subheading DESCRIPTION:

8
doc/user/timer.t
View File

@@ -233,6 +233,7 @@ procedure Timer_Create (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer created successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - invalid timer name@*
@code{@value{RPREFIX}TOO_MANY} - too many timers created
@@ -281,6 +282,7 @@ procedure Timer_Ident (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer identified successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{id} is NULL@*
@code{@value{RPREFIX}INVALID_NAME} - timer name not found
@subheading DESCRIPTION:
@@ -422,6 +424,7 @@ procedure Timer_Fire_After (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer initiated successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{routine} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid timer id@*
@code{@value{RPREFIX}INVALID_NUMBER} - invalid interval
@@ -475,6 +478,8 @@ procedure Timer_Fire_When (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer initiated successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{routine} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{wall_time} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid timer id@*
@code{@value{RPREFIX}NOT_DEFINED} - system date and time is not set@*
@code{@value{RPREFIX}INVALID_CLOCK} - invalid time of day
@@ -583,6 +588,7 @@ procedure Timer_Fire_Server_After (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer initiated successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{routine} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid timer id@*
@code{@value{RPREFIX}INVALID_NUMBER} - invalid interval@*
@code{@value{RPREFIX}INCORRECT_STATE} - Timer Server not initiated
@@ -639,6 +645,8 @@ procedure Timer_Fire_Server_When (
@subheading DIRECTIVE STATUS CODES:
@code{@value{RPREFIX}SUCCESSFUL} - timer initiated successfully@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{routine} is NULL@*
@code{@value{RPREFIX}INVALID_ADDRESS} - @code{wall_time} is NULL@*
@code{@value{RPREFIX}INVALID_ID} - invalid timer id@*
@code{@value{RPREFIX}NOT_DEFINED} - system date and time is not set@*
@code{@value{RPREFIX}INVALID_CLOCK} - invalid time of day@*