SDL_thread_c.h File Reference

#include "../SDL_internal.h"
#include "SDL_thread.h"
#include "generic/SDL_systhread_c.h"
#include "../SDL_error_c.h"

Include dependency graph for SDL_thread_c.h:

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

Go to the source code of this file.

Data Structures
struct	SDL_Thread
struct	SDL_TLSData

Macros
#define	TLS_ALLOC_CHUNKSIZE   4

Enumerations
enum	SDL_ThreadState {   SDL_THREAD_STATE_ALIVE ,   SDL_THREAD_STATE_DETACHED ,   SDL_THREAD_STATE_ZOMBIE ,   SDL_THREAD_STATE_CLEANED }

Functions
void	SDL_RunThread (SDL_Thread *thread)
SDL_TLSData *	SDL_Generic_GetTLSData (void)
int	SDL_Generic_SetTLSData (SDL_TLSData *data)

Macro Definition Documentation

TLS_ALLOC_CHUNKSIZE

#define TLS_ALLOC_CHUNKSIZE   4

Definition at line 84 of file SDL_thread_c.h.

Enumeration Type Documentation

SDL_ThreadState

enum SDL_ThreadState

Enumerator
SDL_THREAD_STATE_ALIVE
SDL_THREAD_STATE_DETACHED
SDL_THREAD_STATE_ZOMBIE
SDL_THREAD_STATE_CLEANED

Definition at line 47 of file SDL_thread_c.h.

{
    SDL_THREAD_STATE_ALIVE,
    SDL_THREAD_STATE_DETACHED,
    SDL_THREAD_STATE_ZOMBIE,
    SDL_THREAD_STATE_CLEANED,
} SDL_ThreadState;

Function Documentation

SDL_Generic_GetTLSData()

SDL_TLSData* SDL_Generic_GetTLSData

(

void

)

Definition at line 123 of file SDL_thread.c.

{
    SDL_threadID thread = SDL_ThreadID();
    SDL_TLSEntry *entry;
    SDL_TLSData *storage = NULL;
 
#if !SDL_THREADS_DISABLED
    if (!SDL_generic_TLS_mutex) {
        static SDL_SpinLock tls_lock;
        SDL_AtomicLock(&tls_lock);
        if (!SDL_generic_TLS_mutex) {
            SDL_mutex *mutex = SDL_CreateMutex();
            SDL_MemoryBarrierRelease();
            SDL_generic_TLS_mutex = mutex;
            if (!SDL_generic_TLS_mutex) {
                SDL_AtomicUnlock(&tls_lock);
                return NULL;
            }
        }
        SDL_AtomicUnlock(&tls_lock);
    }
#endif /* SDL_THREADS_DISABLED */
 
    SDL_MemoryBarrierAcquire();
    SDL_LockMutex(SDL_generic_TLS_mutex);
    for (entry = SDL_generic_TLS; entry; entry = entry->next) {
        if (entry->thread == thread) {
            storage = entry->storage;
            break;
        }
    }
#if !SDL_THREADS_DISABLED
    SDL_UnlockMutex(SDL_generic_TLS_mutex);
#endif
 
    return storage;
}

References mutex, SDL_TLSEntry::next, NULL, SDL_AtomicLock, SDL_AtomicUnlock, SDL_CreateMutex, SDL_generic_TLS, SDL_generic_TLS_mutex, SDL_LockMutex, SDL_MemoryBarrierAcquire, SDL_MemoryBarrierRelease, SDL_ThreadID, SDL_UnlockMutex, SDL_TLSEntry::storage, and SDL_TLSEntry::thread.

Referenced by SDL_SYS_GetTLSData().

SDL_Generic_SetTLSData()

int SDL_Generic_SetTLSData

(

SDL_TLSData *

data

)

Definition at line 162 of file SDL_thread.c.

{
    SDL_threadID thread = SDL_ThreadID();
    SDL_TLSEntry *prev, *entry;
 
    /* SDL_Generic_GetTLSData() is always called first, so we can assume SDL_generic_TLS_mutex */
    SDL_LockMutex(SDL_generic_TLS_mutex);
    prev = NULL;
    for (entry = SDL_generic_TLS; entry; entry = entry->next) {
        if (entry->thread == thread) {
            if (storage) {
                entry->storage = storage;
            } else {
                if (prev) {
                    prev->next = entry->next;
                } else {
                    SDL_generic_TLS = entry->next;
                }
                SDL_free(entry);
            }
            break;
        }
        prev = entry;
    }
    if (!entry) {
        entry = (SDL_TLSEntry *)SDL_malloc(sizeof(*entry));
        if (entry) {
            entry->thread = thread;
            entry->storage = storage;
            entry->next = SDL_generic_TLS;
            SDL_generic_TLS = entry;
        }
    }
    SDL_UnlockMutex(SDL_generic_TLS_mutex);
 
    if (!entry) {
        return SDL_OutOfMemory();
    }
    return 0;
}

References SDL_TLSEntry::next, NULL, SDL_free, SDL_generic_TLS, SDL_generic_TLS_mutex, SDL_LockMutex, SDL_malloc, SDL_OutOfMemory, SDL_ThreadID, SDL_UnlockMutex, SDL_TLSEntry::storage, and SDL_TLSEntry::thread.

Referenced by SDL_SYS_SetTLSData().

SDL_RunThread()

void SDL_RunThread

(

SDL_Thread *

thread

)

Definition at line 261 of file SDL_thread.c.

{
    void *userdata = thread->userdata;
    int (SDLCALL * userfunc) (void *) = thread->userfunc;
 
    int *statusloc = &thread->status;
 
    /* Perform any system-dependent setup - this function may not fail */
    SDL_SYS_SetupThread(thread->name);
 
    /* Get the thread id */
    thread->threadid = SDL_ThreadID();
 
    /* Run the function */
    *statusloc = userfunc(userdata);
 
    /* Clean up thread-local storage */
    SDL_TLSCleanup();
 
    /* Mark us as ready to be joined (or detached) */
    if (!SDL_AtomicCAS(&thread->state, SDL_THREAD_STATE_ALIVE, SDL_THREAD_STATE_ZOMBIE)) {
        /* Clean up if something already detached us. */
        if (SDL_AtomicCAS(&thread->state, SDL_THREAD_STATE_DETACHED, SDL_THREAD_STATE_CLEANED)) {
            if (thread->name) {
                SDL_free(thread->name);
            }
            SDL_free(thread);
        }
    }
}

References int(), SDL_AtomicCAS, SDL_free, SDL_SYS_SetupThread(), SDL_THREAD_STATE_ALIVE, SDL_THREAD_STATE_CLEANED, SDL_THREAD_STATE_DETACHED, SDL_THREAD_STATE_ZOMBIE, SDL_ThreadID, SDL_TLSCleanup(), SDLCALL, and SDL_TLSEntry::thread.

Referenced by RunThread().