Thread name support

[Chris Johns]

On 16/1/17 5:52 pm, Sebastian Huber wrote:
> On 13/01/17 18:59, Gedare Bloom wrote:
>> On Fri, Jan 13, 2017 at 3:25 AM, Sebastian Huber
>> <sebastian.huber at embedded-brains.de> wrote:
>>> Hello,
>>>
>>> I added optional user-defined thread names.
>>>
>>> https://devel.rtems.org/ticket/2858
>>>
>>> The GNU pthread extensions pthread_getname_np() and
>>> pthread_setname_np() are
>>> now available in RTEMS and work for all threads (internal, Classic,
>>> POSIX,
>>> FreeBSD).
>>>
>>> http://man7.org/linux/man-pages/man3/pthread_setname_np.3.html
>>>
>>> The maximum thread name size is a configuration option
>>> (CONFIGURE_MAXIMUM_THREAD_NAME_SIZE).
>>>
>>> Where should this new feature be documented in the C user manual?
>>>
>> I guess at posix-users/thread.rst? I don't know if we have a list of
>> function calls that work across the APIs, but I know quite a few do.
> 
> It think the POSIX API manual should be replaced by a simple list of
> POSIX functions implemented by RTEMS. Each with a link to The Open Group
> documentation and optionally RTEMS-specific things.

What happens with PDF or epub format? Currently the PDF documentation is
fully contained. Doing this means the users has to have internet access
to use it.

> 
> The thread names are available for every API. It should be documented
> somewhere in the user manual.
> 

The C user manual? The RTEMS User Manual does not contain any API
related doco.

Chris