pthread_tls.h File Reference

RIOT POSIX thread local storage. More...

Detailed Description

RIOT POSIX thread local storage.

Author

Martin Landsmann marti.nosp@m.n.la.nosp@m.ndsma.nosp@m.nn@h.nosp@m.aw-ha.nosp@m.mbur.nosp@m.g.de

René Kijewski rene..nosp@m.kije.nosp@m.wski@.nosp@m.fu-b.nosp@m.erlin.nosp@m..de

Definition in file pthread_tls.h.

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

typedef struct __pthread_tls_key *	pthread_key_t
	A thread-specific key.
void *	pthread_getspecific (pthread_key_t key)
	Returns the requested tls.
int	pthread_setspecific (pthread_key_t key, const void *value)
	Set and binds a specific tls to a key.
int	pthread_key_create (pthread_key_t *key, void(*destructor)(void *))
	Creates a new key to be used to identify a specific tls.
int	pthread_key_delete (pthread_key_t key)
	Deletes a pthread_key_t that was previously created with pthread_key_create.
void	__pthread_keys_exit (int self_id)
	Destroys all thread-specific keys for pthread self_id.
struct __pthread_tls_datum **	__pthread_get_tls_head (int self_id) PURE
	Returns the pointer to the head of the list of thread-specific data.

Typedef Documentation

pthread_key_t

typedef struct __pthread_tls_key* pthread_key_t

A thread-specific key.

Definition at line 40 of file pthread_tls.h.

Function Documentation

__pthread_keys_exit()

void __pthread_keys_exit

(

int

self_id

)

Destroys all thread-specific keys for pthread self_id.

Parameters

[in]

self_id

the result of pthread_self().

pthread_getspecific()

void * pthread_getspecific

(

pthread_key_t

key

)

Returns the requested tls.

Parameters

[in]

key

the identifier for the requested tls

Returns

returns pointer to the storage on success, a 0 value otherwise

pthread_key_create()

int pthread_key_create	(	pthread_key_t *	key,
		void(*)(void *)	destructor
	)

Creates a new key to be used to identify a specific tls.

Parameters

[out]	key	the created key is scribed to the given pointer
[in]	destructor	function pointer called when non NULL just before the pthread exits

Returns

returns 0 on success, an errorcode otherwise

pthread_key_delete()

int pthread_key_delete

(

pthread_key_t

key

)

Deletes a pthread_key_t that was previously created with pthread_key_create.

does not call the destructor of the key

Parameters

[in]

key

the identifier of the key to be deleted

Returns

returns 0 on success, an errorcode otherwise

pthread_setspecific()

int pthread_setspecific	(	pthread_key_t	key,
		const void *	value
	)

Set and binds a specific tls to a key.

Parameters

[in]	key	the identifier for the tls
[in]	value	pointer to the location of the tls

Returns

returns 0 on success, an errorcode otherwise