1 files changed, 108 insertions, 0 deletions
diff --git a/cpukit/score/src/objectget.c b/cpukit/score/src/objectget.c
new file mode 100644
index 0000000000..2abcc389fb
--- /dev/null
+++ b/cpukit/score/src/objectget.c
@@ -0,0 +1,108 @@
+/*
+ *  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
+}