git.gag.com Git - debian/gnuradio/blob - gcell/ibm/sync/ppu_source/atomic_dec_return.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_ATOMIC_DEC_RETURN_H_
  42 #define _PPU_ATOMIC_DEC_RETURN_H_
  43
  44 #include "sync_utils.h"
  45 #include "atomic.h"
  46
  47 /**
  48  * atomic_dec_return - atomically decrement a counter and return previous value.
  49  * @v: handle to effective address of counter.
  50  *
  51  * Atomically decrement a counter in system memory and return its
  52  * previous value. The only restriction is that @v must be word
  53  * aligned.
  54  *
  55  * This routine implements the "fetch and decrement"
  56  * primitive that is described in "Book I PowerPC User
  57  * Instruction Set Architecture".
  58  *
  59  * Returns the previous value from system memory.
  60  */
  61 static __inline int _atomic_dec_return(atomic_ea_t v)
  62 {
  63   return _atomic_modify (v, -1);
  64 }
  65
  66
  67
  68 #endif /* _PPU_ATOMIC_DEC_RETURN_H_ */