[PATCH v2] rtems: Add rtems_task_create_from_config()

Sebastian Huber sebastian.huber at embedded-brains.de
Wed Sep 9 05:14:40 UTC 2020

On 09/09/2020 03:37, Chris Johns wrote:
> On 9/9/20 8:43 am, Joel Sherrill wrote:
>> On Wed, Sep 2, 2020 at 11:09 AM Sebastian Huber
>> <sebastian.huber at embedded-brains.de <mailto:sebastian.huber at embedded-brains.de>>
>> wrote:
>>      +/**
>>      + * @brief Returns the recommended task storage area size for the specified size
>>      + *   and task attributes.
>>      + *
>>      + * @param _size is the size dedicated to the task stack and thread-local
>>      + *   storage.
>> How does the user get the TLS size?
>> Need advice on that. Seems hard to get at compile time since it is a link
>> time aggregation.
> I had not noticed this. Thank you for raising it.

The TLS size is only known after linking. The symbol _TLS_Size is 
defined by the linker script. The rtems_task_create_from_config() 
directives is for users who want to have full control over their memory 
allocation. These users have to know what they are doing. It is not for 

Knowing the task size is also not an easy thing. It depends an what you 
call and what the compiler did.

> Does the API call check this new size value against the size actually needed?

I think we should add a sanity check. We could for example check that 
after allocating the FP context and the TLS area, the size for the stack 
is greater than or equal to rtems_minimum_stack_size.

> I thought the TLS size was set by the linker based on the declared TLS variables
> in the code and that value is feed into the calculation of the memory when
> dynamically allocating the task's space. I am now wondering if this is accounted
> for if the allocation is from the workspace (sizeof(TLS) * tasks)? 

Yes, it is, see rtems_configuration_get_stack_space_size().

> A linker
> controlled size is fine for the statically linked only class of application
> however it is broken for applications that dynamically load code with TLS
> variables. There is a growing number of important applications dynamically
> loading code so we need to consider it.
> I would like to see us resolve how we manage TLS allocation for this case and
> dynamic loading before I am OK with this change. I do not think it is fair to
> have dynamic loading fit in or work around a change in this area.
> FreeBSD and Linux dynamically allocate the TLS blocks and Linux resizes the
> blocks when dynamically loaded code contains TLS variables. That approach is not
> as easy on RTEMS for a range of reasons that are not important here.
> A single allocation for all the data a task needs is attractive. It allows this
> API to work and it saves the heap block overheads when using an allocator. It
> however means the TLS size needs to be set to the maximum for an application
> including all dynamically loaded code.
> Maybe the ability to set the size in confdefs.h at the system level would be
> sufficient. Defining it at the task level is misleading because it implies tasks
> can have different TLS sizes and they cannot. A system level TLS size of 0 could
> be used to have the linker size be the size used, this would be compatible to
> what we currently have. 

I think this TLS issue with dynamic linking is independent of the 

It would be easy to add a


application configuration option. If the TLS size defined by the linker 
is greater, then we would have a fatal system initialization error.  An 
extra space can be used by the dynamic linker.

> A system level size of 0 for this new API call would be
> a fatal error the there are TLS variables.

No, it don't think this should be an error. I think it would be enough 
to check that after allocating the FP context and the TLS area, the size 
for the stack is greater than or equal to rtems_minimum_stack_size.

> TLS management in RTEMS is similar to the SDATA area the PowerPC has. The only
> difference is the TLS size can be varied and the SDATA size is fixed in
> hardware. If a system level TLS size is supported and that value has a suitable
> interface libdl can support dynamically loaded TLS variables the same way SDATA
> is handled on the PowerPC. Libdl uses a bit-allocator to track 32bit blocks of
> SDATA. The statically linked usage is known and initialised and libdl assumes
> ownership of the remaining space. The TLS block can be handled the same way. The
> RTL lock handles the runtime set up without effecting scheduling and the same
> can happen for TLS data.

Yes, this sounds good.

Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at embedded-brains.de
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.

More information about the devel mailing list