summaryrefslogtreecommitdiffstats
path: root/cpukit/rtems/src/regiongetfreeinfo.c
diff options
context:
space:
mode:
Diffstat (limited to 'cpukit/rtems/src/regiongetfreeinfo.c')
-rw-r--r--cpukit/rtems/src/regiongetfreeinfo.c88
1 files changed, 88 insertions, 0 deletions
diff --git a/cpukit/rtems/src/regiongetfreeinfo.c b/cpukit/rtems/src/regiongetfreeinfo.c
new file mode 100644
index 0000000000..fcfa3bc8b2
--- /dev/null
+++ b/cpukit/rtems/src/regiongetfreeinfo.c
@@ -0,0 +1,88 @@
+/*
+ * Region Manager
+ *
+ *
+ * COPYRIGHT (c) 1989-2007.
+ * 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/rtems/status.h>
+#include <rtems/rtems/support.h>
+#include <rtems/score/object.h>
+#include <rtems/rtems/options.h>
+#include <rtems/rtems/region.h>
+#include <rtems/score/states.h>
+#include <rtems/score/apimutex.h>
+#include <rtems/score/thread.h>
+
+/*PAGE
+ *
+ * rtems_region_get_free_information
+ *
+ * This directive will return information about the free blocks
+ * in the region specified. Information about the used blocks
+ * will be returned as zero.
+ *
+ * Input parameters:
+ * id - region id
+ * the_info - pointer to region information block
+ *
+ * Output parameters:
+ * *the_info - region information block filled in
+ * RTEMS_SUCCESSFUL - if successful
+ * error code - if unsuccessful
+ */
+
+rtems_status_code rtems_region_get_free_information(
+ rtems_id id,
+ Heap_Information_block *the_info
+)
+{
+ Objects_Locations location;
+ rtems_status_code return_status;
+ register Region_Control *the_region;
+
+ if ( !the_info )
+ return RTEMS_INVALID_ADDRESS;
+
+ _RTEMS_Lock_allocator();
+
+ the_region = _Region_Get( id, &location );
+ switch ( location ) {
+
+ case OBJECTS_LOCAL:
+
+ the_info->Used.number = 0;
+ the_info->Used.total = 0;
+ the_info->Used.largest = 0;
+
+ _Heap_Get_free_information( &the_region->Memory, &the_info->Free );
+
+ return_status = RTEMS_SUCCESSFUL;
+ break;
+
+#if defined(RTEMS_MULTIPROCESSING)
+ case OBJECTS_REMOTE: /* this error cannot be returned */
+ break;
+#endif
+
+ case OBJECTS_ERROR:
+ default:
+ return_status = RTEMS_INVALID_ID;
+ break;
+ }
+
+ _RTEMS_Unlock_allocator();
+ return return_status;
+}