c-user: Task names

Update #2858.
This commit is contained in:
Sebastian Huber 2017-01-31 10:10:13 +01:00
parent e07e376c1f
commit 40a1e80e63
2 changed files with 15 additions and 1 deletions

View File

@ -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
---------------------------------------

View File

@ -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