Imported Upstream version 3.2.2
[debian/gnuradio] / gcell / ibm / sync / ppu_source / mutex_trylock.h
1 /* --------------------------------------------------------------  */
2 /* (C)Copyright 2001,2007,                                         */
3 /* International Business Machines Corporation,                    */
4 /* Sony Computer Entertainment, Incorporated,                      */
5 /* Toshiba Corporation,                                            */
6 /*                                                                 */
7 /* All Rights Reserved.                                            */
8 /*                                                                 */
9 /* Redistribution and use in source and binary forms, with or      */
10 /* without modification, are permitted provided that the           */
11 /* following conditions are met:                                   */
12 /*                                                                 */
13 /* - Redistributions of source code must retain the above copyright*/
14 /*   notice, this list of conditions and the following disclaimer. */
15 /*                                                                 */
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.                               */
20 /*                                                                 */
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     */
24 /*   permission.                                                   */
25 /*                                                                 */
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 _PPU_MUTEX_TRYLOCK_H_
42 #define _PPU_MUTEX_TRYLOCK_H_
43
44 #include <ppu_intrinsics.h>
45 #include "sync_utils.h"
46 #include "mutex.h"
47 #include "trace_libsync.h"
48
49 /**
50  * mutex_trylock - acquire a lock, or return immediately.
51  * @lock: handle to effective address of lock variable.
52  *
53  * Description: Acquire a lock, or return immediately 
54  * without polling for availability.
55  *
56  * Context: The application should not call this interface 
57  * from a tight loop!!  Use spin_lock() instead.
58  *
59  * Attempt to immediately aquire a lock at a location in system memory,
60  * and return 1 if the lock was aquired or 0 otherwise.
61  */
62 static __inline int _mutex_trylock (mutex_ea_t lock)
63 {
64   int val;
65   int ret = 0;
66   void *p;
67
68   SYNC_ULL_TO_PTR(lock, p);
69
70   do {
71     val = (int)__lwarx(p);
72     if (val) break;
73   } while ((ret = __stwcx(p, (unsigned int)1)) == 0);
74   __isync();
75
76   TRACE_MUTEX_TRYLOCK(lock,ret);
77
78   return (ret);
79 }
80
81 #endif /* _PPU_MUTEX_TRYLOCK_H_ */