lwp.h

Go to the documentation of this file.

/*-------------------------------------------------------------

lwp.h -- Thread subsystem I

Copyright (C) 2004
Michael Wiedenbauer (shagkur)
Dave Murphy (WinterMute)

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any
damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1.  The origin of this software must not be misrepresented; you
must not claim that you wrote the original software. If you use
this software in a product, an acknowledgment in the product
documentation would be appreciated but is not required.

2.  Altered source versions must be plainly marked as such, and
must not be misrepresented as being the original software.

3.  This notice may not be removed or altered from any source
distribution.



-------------------------------------------------------------*/


#ifndef __LWP_H__
#define __LWP_H__

#include <gctypes.h>

#define LWP_CLOSED                  -1
#define LWP_SUCCESSFUL              0
#define LWP_ALREADY_SUSPENDED       1
#define LWP_NOT_SUSPENDED           2

#define LWP_PRIO_IDLE               0
#define LWP_PRIO_HIGHEST          127

#define LWP_THREAD_NULL             0xffffffff
#define LWP_TQUEUE_NULL             0xffffffff

#ifdef __cplusplus
extern "C" {
#endif


typedef u32 lwp_t;


typedef u32 lwpq_t;

s32 LWP_CreateThread(lwp_t *thethread,void* (*entry)(void *),void *arg,void *stackbase,u32 stack_size,u8 prio);


s32 LWP_SuspendThread(lwp_t thethread);


s32 LWP_ResumeThread(lwp_t thethread);


BOOL LWP_ThreadIsSuspended(lwp_t thethread);


lwp_t LWP_GetSelf();


void LWP_SetThreadPriority(lwp_t thethread,u32 prio);


void LWP_YieldThread();


void LWP_Reschedule(u32 prio);


s32 LWP_JoinThread(lwp_t thethread,void **value_ptr);


s32 LWP_InitQueue(lwpq_t *thequeue);


void LWP_CloseQueue(lwpq_t thequeue);


s32 LWP_ThreadSleep(lwpq_t thequeue);


void LWP_ThreadSignal(lwpq_t thequeue);


void LWP_ThreadBroadcast(lwpq_t thequeue);

#ifdef __cplusplus
    }
#endif

#endif