1
/* -------------------------------------------------------------- */
2
/* (C)Copyright 2001,2007, */
3
/* International Business Machines Corporation, */
4
/* Sony Computer Entertainment, Incorporated, */
5
/* Toshiba Corporation, */
7
/* All Rights Reserved. */
9
/* Redistribution and use in source and binary forms, with or */
10
/* without modification, are permitted provided that the */
11
/* following conditions are met: */
13
/* - Redistributions of source code must retain the above copyright*/
14
/* notice, this list of conditions and the following disclaimer. */
16
/* - Redistributions in binary form must reproduce the above */
17
/* copyright notice, this list of conditions and the following */
18
/* disclaimer in the documentation and/or other materials */
19
/* provided with the distribution. */
21
/* - Neither the name of IBM Corporation nor the names of its */
22
/* contributors may be used to endorse or promote products */
23
/* derived from this software without specific prior written */
26
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND */
27
/* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, */
28
/* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF */
29
/* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE */
30
/* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR */
31
/* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, */
32
/* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT */
33
/* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; */
34
/* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) */
35
/* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN */
36
/* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR */
37
/* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, */
38
/* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
39
/* -------------------------------------------------------------- */
40
/* PROLOG END TAG zYx */
41
#ifndef _SPU_LIB_SYNC_H_
42
#define _SPU_LIB_SYNC_H_
43
#include "sync_utils.h"
49
typedef unsigned long long atomic_ea_t;
51
extern void atomic_set(atomic_ea_t v, int val);
52
extern void atomic_add(int a, atomic_ea_t v);
53
extern void atomic_sub(int a, atomic_ea_t v);
54
extern void atomic_inc(atomic_ea_t v);
55
extern void atomic_dec(atomic_ea_t v);
57
extern int atomic_read(atomic_ea_t v);
58
extern int atomic_add_return(int a, atomic_ea_t v);
59
extern int atomic_sub_return(int a, atomic_ea_t v);
60
extern int atomic_inc_return(atomic_ea_t v);
61
extern int atomic_dec_return(atomic_ea_t v);
62
extern int atomic_sub_and_test(int a, atomic_ea_t v);
63
extern int atomic_dec_and_test(atomic_ea_t v);
64
extern int atomic_dec_if_positive(atomic_ea_t v);
66
typedef unsigned long long mutex_ea_t;
68
extern void mutex_init(mutex_ea_t lock);
69
extern void mutex_lock(mutex_ea_t lock);
70
extern int mutex_trylock(mutex_ea_t ea);
71
extern void mutex_unlock(mutex_ea_t lock);
76
int num_threads_signal; /* the number of threads that are going to be waken up.
77
* There are 3 values possible for this parameter, 0, 1,
78
* or num_threads_waiting
80
int num_threads_waiting; /* the number of threads that are waiting to be awaken
82
} condition_variable_t __attribute__ ((aligned (128)));
84
typedef eaddr_t cond_ea_t; /* a system memory 64 bit address that points to
85
* a valid condition_variable_t
89
extern void cond_init (cond_ea_t cond);
90
extern void cond_signal (cond_ea_t cond);
91
extern void cond_broadcast (cond_ea_t cond);
92
extern void cond_wait (cond_ea_t cond, mutex_ea_t mutex);
94
typedef unsigned long long completion_ea_t;
96
extern void init_completion(completion_ea_t completion);
97
extern void wait_for_completion(completion_ea_t completion);
98
extern void complete(completion_ea_t completion);
99
extern void complete_all(completion_ea_t completion);
102
/* Function only implemented for the SPU
104
extern void read_lock(eaddr_t ea);
105
extern void read_unlock(eaddr_t ea);
106
extern int read_trylock(eaddr_t ea);
107
extern void write_lock(eaddr_t ea);
108
extern void write_unlock(eaddr_t ea);
109
extern int write_trylock(eaddr_t ea);
116
#endif /* _SPU_LIB_SYNC_H_ */