2006-09-25 Joel Sherrill <joel.sherrill@oarcorp.com>

	* rtems/Makefile.am, rtems/preinstall.am, rtems/include/rtems.h,
	rtems/include/rtems/rtems/attr.h, rtems/include/rtems/rtems/config.h,
	rtems/inline/rtems/rtems/attr.inl, rtems/macros/rtems/rtems/attr.inl:
	Add Classic API Barriers.
	* rtems/include/rtems/rtems/barrier.h,
	rtems/include/rtems/rtems/barriermp.h,
	rtems/inline/rtems/rtems/barrier.inl,
	rtems/macros/rtems/rtems/barrier.inl, rtems/src/barrier.c,
	rtems/src/barriercreate.c, rtems/src/barrierdelete.c,
	rtems/src/barrierident.c, rtems/src/barrierrelease.c,
	rtems/src/barriertranslatereturncode.c, rtems/src/barrierwait.c:
	New files.

1 files changed, 195 insertions, 0 deletions

diff --git a/cpukit/rtems/include/rtems/rtems/barrier.h b/cpukit/rtems/include/rtems/rtems/barrier.h
new file mode 100644
index 0000000000..f9c8e909ee
--- /dev/null
+++ b/cpukit/rtems/include/rtems/rtems/barrier.h
@@ -0,0 +1,195 @@
+/**
+ * @file rtems/rtems/barrier.h
+ */
+
+/*
+ *  This include file contains all the constants and structures associated
+ *  with the Barrier Manager.
+ *
+ *  Directives provided are:
+ *
+ *     + create a barrier
+ *     + get an ID of a barrier
+ *     + delete a barrier
+ *     + wait for a barrier
+ *     + signal a barrier
+ *
+ *  COPYRIGHT (c) 1989-2006.
+ *  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$
+ */
+
+#ifndef _RTEMS_RTEMS_BARRIER_H
+#define _RTEMS_RTEMS_BARRIER_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <rtems/rtems/types.h>
+#include <rtems/rtems/support.h>
+#include <rtems/rtems/attr.h>
+#include <rtems/score/object.h>
+#include <rtems/score/corebarrier.h>
+
+/**
+ *  This type defines the control block used to manage each barrier.
+ */
+
+typedef struct {
+  /** This is used to manage a barrier as an object. */
+  Objects_Control          Object;
+  /** This is used to specify the attributes of a barrier. */
+  rtems_attribute          attribute_set;
+  /** This is used to implement the barrier. */
+  CORE_barrier_Control     Barrier;
+}   Barrier_Control;
+
+/**
+ *  The following defines the information control block used to manage
+ *  this class of objects.
+ */
+
+RTEMS_EXTERN Objects_Information  _Barrier_Information;
+
+/**
+ *  @brief _Barrier_Manager_initialization
+ *
+ *  This routine performs the initialization necessary for this manager.
+ *
+ *  @param[in] maximum_barriers is the total number of barriers allowed to
+ *             concurrently be active in the system.
+ */
+
+void _Barrier_Manager_initialization(
+  uint32_t   maximum_barriers
+);
+
+/**
+ *  @brief rtems_barrier_create
+ *
+ *  This routine implements the rtems_barrier_create directive.  The
+ *  barrier will have the name name.  The starting count for
+ *  the barrier is count.  The attribute_set determines if
+ *  the barrier is global or local and the thread queue
+ *  discipline.  It returns the id of the created barrier in ID.
+ *
+ *  @param[in] name is the name of this barrier instance.
+ *  @param[in] attribute_set specifies the attributes of this barrier instance.
+ *  @param[in] maximum_waiters is the maximum number of threads which will
+ *             be allowed to concurrently wait at the barrier.
+ *  @param[out] id will contain the id of this barrier.
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+
+rtems_status_code rtems_barrier_create(
+  rtems_name           name,
+  rtems_attribute      attribute_set,
+  uint32_t             maximum_waiters,
+  rtems_id            *id
+);
+
+/**
+ *  @brief rtems_barrier_ident
+ *
+ *  This routine implements the rtems_barrier_ident directive.
+ *  This directive returns the barrier ID associated with name.
+ *  If more than one barrier is named name, then the barrier
+ *  to which the ID belongs is arbitrary.  node indicates the
+ *  extent of the search for the ID of the barrier named name.
+ *  The search can be limited to a particular node or allowed to
+ *  encompass all nodes.
+ * 
+ *  @param[in] name is the name of this barrier instance.
+ *  @param[out] id will contain the id of this barrier.
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+
+rtems_status_code rtems_barrier_ident(
+  rtems_name    name,
+  rtems_id     *id
+);
+
+/**
+ *  @brief rtems_barrier_delete
+ *
+ *  This routine implements the rtems_barrier_delete directive.  The
+ *  barrier indicated by @a id is deleted.
+ *
+ *  @param[in] id indicates the barrier to delete
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+rtems_status_code rtems_barrier_delete(
+  rtems_id   id
+);
+
+/**
+ *  @brief rtems_barrier_wait
+ *
+ *  This routine implements the rtems_barrier_wait directive.  It
+ *  attempts to wait at the barrier associated with @a id.  The calling task
+ *  may block waiting for the barrier with an optional timeout of @a timeout
+ *  clock ticks.
+ *
+ *  @param[in] id indicates the barrier to wait at.
+ *  @param[in] option_set indicates if the caller is willing to wait.
+ *  @param[in] timeout is the maximum length of time in ticks the calling
+ *             thread is willing to block.
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+rtems_status_code rtems_barrier_wait(
+  rtems_id       id,
+  rtems_interval timeout
+);
+
+/**
+ *  @brief rtems_barrier_release
+ *
+ *  This routine implements the rtems_barrier_release directive.  It
+ *  unblocks all of the threads waiting on the barrier associated with
+ *  @a id.  The number of threads unblocked is returns in @a unblocked.
+ *
+ *
+ *  @param[in] id indicates the barrier to wait at.
+ *  @param[out] unblocked will contain the number of threads unblocked.
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+rtems_status_code rtems_barrier_release(
+  rtems_id  id,
+  uint32_t *unblocked
+);
+
+/**
+ *  @brief Translate SuperCore Barrier Status Code to RTEMS Status Code
+ *
+ *  This function returns a RTEMS status code based on the barrier
+ *  status code specified.
+ *
+ *  @param[in] the_status is the SuperCore Barrier status to translate.
+ *
+ *  @return a status code indicating success or the reason for failure.
+ */
+rtems_status_code _Barrier_Translate_core_barrier_return_code (
+  CORE_barrier_Status  the_status
+);
+
+#ifndef __RTEMS_APPLICATION__
+#include <rtems/rtems/barrier.inl>
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+/*  end of include file */