[rtems-docs commit] c-user: Task names

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    40a1e80e6391418450157eb9e69aa8b796123aaa
Changeset: http://git.rtems.org/rtems-docs/commit/?id=40a1e80e6391418450157eb9e69aa8b796123aaa

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue Jan 31 10:10:13 2017 +0100

c-user: Task names

Update #2858.

---

 c-user/configuring_a_system.rst |  2 +-
 c-user/task_manager.rst         | 14 ++++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

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