summaryrefslogtreecommitdiff
path: root/gcell/ibm/sync/spu_source/libsync.h
blob: 48cc722bd58fccaba35704e6b273b4748f8954b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
/* --------------------------------------------------------------  */
/* (C)Copyright 2001,2007,                                         */
/* International Business Machines Corporation,                    */
/* Sony Computer Entertainment, Incorporated,                      */
/* Toshiba Corporation,                                            */
/*                                                                 */
/* All Rights Reserved.                                            */
/*                                                                 */
/* Redistribution and use in source and binary forms, with or      */
/* without modification, are permitted provided that the           */
/* following conditions are met:                                   */
/*                                                                 */
/* - Redistributions of source code must retain the above copyright*/
/*   notice, this list of conditions and the following disclaimer. */
/*                                                                 */
/* - Redistributions in binary form must reproduce the above       */
/*   copyright notice, this list of conditions and the following   */
/*   disclaimer in the documentation and/or other materials        */
/*   provided with the distribution.                               */
/*                                                                 */
/* - Neither the name of IBM Corporation nor the names of its      */
/*   contributors may be used to endorse or promote products       */
/*   derived from this software without specific prior written     */
/*   permission.                                                   */
/*                                                                 */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND          */
/* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,     */
/* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF        */
/* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE        */
/* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR            */
/* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,    */
/* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT    */
/* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;    */
/* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)        */
/* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN       */
/* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR    */
/* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,  */
/* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.              */
/* --------------------------------------------------------------  */
/* PROLOG END TAG zYx                                              */
#ifndef _SPU_LIB_SYNC_H_
#define _SPU_LIB_SYNC_H_
#include "sync_utils.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef unsigned long long atomic_ea_t;

extern void atomic_set(atomic_ea_t v, int val);
extern void atomic_add(int a, atomic_ea_t v);
extern void atomic_sub(int a, atomic_ea_t v);
extern void atomic_inc(atomic_ea_t v);
extern void atomic_dec(atomic_ea_t v);

extern int atomic_read(atomic_ea_t v);
extern int atomic_add_return(int a, atomic_ea_t v);
extern int atomic_sub_return(int a, atomic_ea_t v);
extern int atomic_inc_return(atomic_ea_t v);
extern int atomic_dec_return(atomic_ea_t v);
extern int atomic_sub_and_test(int a, atomic_ea_t v);
extern int atomic_dec_and_test(atomic_ea_t v);
extern int atomic_dec_if_positive(atomic_ea_t v);

typedef unsigned long long mutex_ea_t;

extern void mutex_init(mutex_ea_t lock);
extern void mutex_lock(mutex_ea_t lock);
extern int mutex_trylock(mutex_ea_t ea);
extern void mutex_unlock(mutex_ea_t lock);


typedef struct
{
  int num_threads_signal;       /* the number of threads that are going to be waken up.
				 * There are 3 values possible for this parameter, 0, 1, 
                                 * or num_threads_waiting
				 */
  int num_threads_waiting;      /* the number of threads that are waiting to be awaken 
				 */ 
} condition_variable_t __attribute__ ((aligned (128)));  

typedef eaddr_t cond_ea_t;	/* a system memory 64 bit address that points to
				 * a valid condition_variable_t 
				 */


extern void cond_init (cond_ea_t  cond);
extern void cond_signal (cond_ea_t cond);
extern void cond_broadcast (cond_ea_t cond);
extern void cond_wait (cond_ea_t cond, mutex_ea_t  mutex);

typedef unsigned long long completion_ea_t;

extern void init_completion(completion_ea_t completion);
extern void wait_for_completion(completion_ea_t completion);
extern void complete(completion_ea_t completion);
extern void complete_all(completion_ea_t completion);

#ifdef __SPU__
  /* Function only implemented for the SPU
   */
  extern void read_lock(eaddr_t ea);
  extern void read_unlock(eaddr_t ea);
  extern int  read_trylock(eaddr_t ea);
  extern void write_lock(eaddr_t ea);
  extern void write_unlock(eaddr_t ea);
  extern int  write_trylock(eaddr_t ea);
#endif

#ifdef __cplusplus
}
#endif

#endif /* _SPU_LIB_SYNC_H_ */