forked from Imagelibrary/rtems
109 lines
2.9 KiB
C
109 lines
2.9 KiB
C
/*
|
|
* Object Handler
|
|
*
|
|
*
|
|
* COPYRIGHT (c) 1989-1999.
|
|
* On-Line Applications Research Corporation (OAR).
|
|
*
|
|
* The license and distribution terms for this file may be
|
|
* found in the file LICENSE in this distribution or at
|
|
* http://www.rtems.com/license/LICENSE.
|
|
*
|
|
* $Id$
|
|
*/
|
|
|
|
#if HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include <rtems/system.h>
|
|
#include <rtems/score/address.h>
|
|
#include <rtems/score/chain.h>
|
|
#include <rtems/score/object.h>
|
|
#if defined(RTEMS_MULTIPROCESSING)
|
|
#include <rtems/score/objectmp.h>
|
|
#endif
|
|
#include <rtems/score/thread.h>
|
|
#include <rtems/score/wkspace.h>
|
|
#include <rtems/score/sysstate.h>
|
|
#include <rtems/score/isr.h>
|
|
|
|
/*PAGE
|
|
*
|
|
* _Objects_Get
|
|
*
|
|
* This routine sets the object pointer for the given
|
|
* object id based on the given object information structure.
|
|
*
|
|
* Input parameters:
|
|
* information - pointer to entry in table for this class
|
|
* id - object id to search for
|
|
* location - address of where to store the location
|
|
*
|
|
* Output parameters:
|
|
* returns - address of object if local
|
|
* location - one of the following:
|
|
* OBJECTS_ERROR - invalid object ID
|
|
* OBJECTS_REMOTE - remote object
|
|
* OBJECTS_LOCAL - local object
|
|
*/
|
|
|
|
Objects_Control *_Objects_Get(
|
|
Objects_Information *information,
|
|
Objects_Id id,
|
|
Objects_Locations *location
|
|
)
|
|
{
|
|
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 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)
|
|
_Objects_MP_Is_remote( information, id, location, &the_object );
|
|
return the_object;
|
|
#else
|
|
return NULL;
|
|
#endif
|
|
}
|