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

* score/src/objectget.c: Improve comments and readability.
This commit is contained in:
Joel Sherrill
2008-05-06 20:31:33 +00:00
parent 76deaf0c64
commit e06b6b0a09
2 changed files with 33 additions and 1 deletions
+4
View File
@@ -1,3 +1,7 @@
2008-05-06 Joel Sherrill <joel.sherrill@OARcorp.com>
* score/src/objectget.c: Improve comments and readability.
2008-05-06 Joel Sherrill <joel.sherrill@OARcorp.com>
* rtems/include/rtems/rtems/message.h, sapi/include/confdefs.h,
+29 -1
View File
@@ -57,18 +57,46 @@ Objects_Control *_Objects_Get(
Objects_Control *the_object;
uint32_t index;
/*
* Extract the index portion of an Id in a way that produces a valid
* index for objects within this class and an invalid value for objects
* outside this class.
*
* If the Id matches the api, class, and node but index portion is 0,
* then the subtraction will underflow and the addition of 1 will
* result in a 0 index. The zeroth element in the local_table is
* always NULL.
*
* If the Id is valid but the object has not been created yet, then
* the local_table entry will be NULL.
*/
index = id - information->minimum_id + 1;
if ( information->maximum >= index ) {
/*
* If the index is less than maximum, then it is OK to use it to
* index into the local_table array.
*/
if ( index <= information->maximum ) {
_Thread_Disable_dispatch();
if ( (the_object = information->local_table[ index ]) != NULL ) {
*location = OBJECTS_LOCAL;
return the_object;
}
/*
* Valid Id for this API, Class and Node but the object has not
* been allocated yet.
*/
_Thread_Enable_dispatch();
*location = OBJECTS_ERROR;
return NULL;
}
/*
* Object Id is not within this API and Class on this node. So
* it may be global in a multiprocessing system. But it is clearly
* invalid on a single processor system.
*/
*location = OBJECTS_ERROR;
#if defined(RTEMS_MULTIPROCESSING)