summaryrefslogtreecommitdiffstats
path: root/doc/user/smp.t
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2014-04-16 15:10:10 +0200
committerSebastian Huber <sebastian.huber@embedded-brains.de>2014-04-17 08:06:38 +0200
commit6809383d76966a01ef48642943a910f2c6bb6ea9 (patch)
tree3381fb5334fa34d0508ab8d73ef6651482419fe2 /doc/user/smp.t
parentsapi: Fix CONFIGURE_UNLIMITED_OBJECTS (diff)
downloadrtems-6809383d76966a01ef48642943a910f2c6bb6ea9.tar.bz2
doc: rtems_get_processor_count()
Diffstat (limited to '')
-rw-r--r--doc/user/smp.t25
1 files changed, 14 insertions, 11 deletions
diff --git a/doc/user/smp.t b/doc/user/smp.t
index 449987a6e1..d16df0e7d6 100644
--- a/doc/user/smp.t
+++ b/doc/user/smp.t
@@ -14,7 +14,7 @@ provided by RTEMS.
The application level services currently provided are:
@itemize @bullet
-@item @code{rtems_smp_get_processor_count} - Obtain Number of CPUs
+@item @code{rtems_get_processor_count} - Get processor count
@item @code{rtems_task_get_affinity} - Obtain Task Affinity
@item @code{rtems_task_set_affinity} - Set Task Affinity
@end itemize
@@ -223,36 +223,39 @@ is dedicated to each of these services and describes the calling sequence,
related constants, usage, and status codes.
@c
-@c rtems_smp_get_processor_count
+@c rtems_get_processor_count
@c
@page
-@subsection rtems_smp_get_processor_count - Obtain Number of CPUs
+@subsection GET_PROCESSOR_COUNT - Get processor count
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-#include <rtems.h>
-
-int rtems_smp_get_processor_count(void);
+uint32_t rtems_get_processor_count(void);
@end example
@end ifset
@ifset is-Ada
@end ifset
-@subheading STATUS CODES:
+@subheading DIRECTIVE STATUS CODES:
-Returns the number of processors being utilized.
+The count of processors in the system.
@subheading DESCRIPTION:
-The @code{rtems_smp_get_processor_count} routine is used to obtain the
-number of processor cores being utilized.
+On uni-processor configurations a value of one will be returned.
+
+On SMP configurations this returns the value of a global variable set during
+system initialization to indicate the count of utilized processors. The
+processor count depends on the physically or virtually available processors and
+application configuration. The value will always be less than or equal to the
+maximum count of application configured processors.
@subheading NOTES:
-NONE
+None.
@c
@c rtems_task_get_affinity