summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2017-01-31 10:10:13 +0100
committerSebastian Huber <sebastian.huber@embedded-brains.de>2017-01-31 10:10:13 +0100
commit40a1e80e6391418450157eb9e69aa8b796123aaa (patch)
tree033703444d72a670dfcfa81ed8703b5171b4365d
parente07e376c1f0031d6113cfdf27536283c2de19bd7 (diff)
downloadrtems-docs-40a1e80e6391418450157eb9e69aa8b796123aaa.tar.bz2
c-user: Task names
Update #2858.
-rw-r--r--c-user/configuring_a_system.rst2
-rw-r--r--c-user/task_manager.rst14
2 files changed, 15 insertions, 1 deletions
diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index c7bc8d3..dceec7b 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1773,7 +1773,7 @@ NOTES:
.. COMMENT: === CONFIGURE_MAXIMUM_THREAD_NAME_SIZE ===
-.. _Specifying the Maximum Thread Name Size
+.. _CONFIGURE_MAXIMUM_THREAD_NAME_SIZE:
Specifying the Maximum Thread Name Size
---------------------------------------
diff --git a/c-user/task_manager.rst b/c-user/task_manager.rst
index 0a95f81..176e565 100644
--- a/c-user/task_manager.rst
+++ b/c-user/task_manager.rst
@@ -94,6 +94,20 @@ regains control of the processor, its context is restored from the TCB. When a
task is restarted, the initial state of the task is restored from the starting
context area in the task's TCB.
+Task Name
+---------
+.. index:: task name
+
+By default, the task name is defined by the task object name given to
+:ref:`rtems_task_create() <rtems_task_create>`. The task name can be obtained
+with the `pthread_getname_np()
+<http://man7.org/linux/man-pages/man3/pthread_setname_np.3.html>`_ function.
+Optionally, a new task name may be set with the `pthread_setname_np()
+<http://man7.org/linux/man-pages/man3/pthread_setname_np.3.html>`_ function.
+The maximum size of a task name is defined by the application configuration
+option :ref:`CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
+<CONFIGURE_MAXIMUM_THREAD_NAME_SIZE>`.
+
Task States
-----------
.. index:: task states