From f8892c9bdb2f4022bc52f39f2a1f4256b2832f11 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Thu, 6 May 2004 19:21:50 +0000 Subject: 2004-05-06 Joel Sherrill 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. --- doc/ChangeLog | 7 +++++++ doc/user/clock.t | 6 ++++-- doc/user/dpmem.t | 8 ++++++-- doc/user/event.t | 1 + doc/user/msg.t | 10 ++++++++++ doc/user/part.t | 5 +++++ doc/user/region.t | 8 ++++++++ doc/user/sem.t | 1 + doc/user/task.t | 30 ++++++++++++++++++++---------- doc/user/timer.t | 8 ++++++++ 10 files changed, 70 insertions(+), 14 deletions(-) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index 9d65b9685d..9e7ee4e848 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2004-05-06 Joel Sherrill + + 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 * started/buildc.t: Use tar xjf for bzip'ed files. diff --git a/doc/user/clock.t b/doc/user/clock.t index 0d4306a28d..24721ebe8c 100644 --- a/doc/user/clock.t +++ b/doc/user/clock.t @@ -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: diff --git a/doc/user/dpmem.t b/doc/user/dpmem.t index 8b9d3da6e0..b842b519b2 100644 --- a/doc/user/dpmem.t +++ b/doc/user/dpmem.t @@ -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: diff --git a/doc/user/event.t b/doc/user/event.t index c8664b09a3..13d5af980f 100644 --- a/doc/user/event.t +++ b/doc/user/event.t @@ -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: diff --git a/doc/user/msg.t b/doc/user/msg.t index 481810ffe1..03d2150e3c 100644 --- a/doc/user/msg.t +++ b/doc/user/msg.t @@ -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: diff --git a/doc/user/part.t b/doc/user/part.t index 950c29c4f4..eef41e6308 100644 --- a/doc/user/part.t +++ b/doc/user/part.t @@ -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 diff --git a/doc/user/region.t b/doc/user/region.t index 5f7a2a9e35..4b90443049 100644 --- a/doc/user/region.t +++ b/doc/user/region.t @@ -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 diff --git a/doc/user/sem.t b/doc/user/sem.t index 1f9b7553b9..dd51266892 100644 --- a/doc/user/sem.t +++ b/doc/user/sem.t @@ -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@* diff --git a/doc/user/task.t b/doc/user/task.t index 30344e17d2..78a4970de7 100644 --- a/doc/user/task.t +++ b/doc/user/task.t @@ -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: diff --git a/doc/user/timer.t b/doc/user/timer.t index 0049c138d8..421fc4f032 100644 --- a/doc/user/timer.t +++ b/doc/user/timer.t @@ -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@* -- cgit v1.2.3