include/llvm/System/Mutex.h

   1 //===- llvm/System/Mutex.h - Mutex Operating System Concept -----*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file was developed by Reid Spencer and is distributed under the
   6 // University of Illinois Open Source License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file declares the llvm::sys::Mutex class.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 #ifndef LLVM_SYSTEM_MUTEX_H
  15 #define LLVM_SYSTEM_MUTEX_H
  16
  17 #include "llvm/System/IncludeFile.h"
  18
  19 namespace llvm
  20 {
  21   namespace sys
  22   {
  23     /// @brief Platform agnostic Mutex class.
  24     class Mutex
  25     {
  26     /// @name Constructors
  27     /// @{
  28     public:
  29
  30       /// Initializes the lock but doesn't acquire it. if \p recursive is set
  31       /// to false, the lock will not be recursive which makes it cheaper but
  32       /// also more likely to deadlock (same thread can't acquire more than
  33       /// once).
  34       /// @brief Default Constructor.
  35       Mutex ( bool recursive = true );
  36
  37       /// Releases and removes the lock
  38       /// @brief Destructor
  39       ~Mutex ( void );
  40
  41     /// @}
  42     /// @name Methods
  43     /// @{
  44     public:
  45
  46       /// Attempts to unconditionally acquire the lock. If the lock is held by
  47       /// another thread, this method will wait until it can acquire the lock.
  48       /// @returns false if any kind of error occurs, true otherwise.
  49       /// @brief Unconditionally acquire the lock.
  50       bool acquire();
  51
  52       /// Attempts to release the lock. If the lock is held by the current
  53       /// thread, the lock is released allowing other threads to acquire the
  54       /// lock.
  55       /// @returns false if any kind of error occurs, true otherwise.
  56       /// @brief Unconditionally release the lock.
  57       bool release(void);
  58
  59       /// Attempts to acquire the lock without blocking. If the lock is not
  60       /// available, this function returns false quickly (without blocking). If
  61       /// the lock is available, it is acquired.
  62       /// @returns false if any kind of error occurs or the lock is not
  63       /// available, true otherwise.
  64       /// @brief Try to acquire the lock.
  65       bool tryacquire();
  66
  67     //@}
  68     /// @name Platform Dependent Data
  69     /// @{
  70     private:
  71 #ifdef ENABLE_THREADS
  72       void* data_; ///< We don't know what the data will be
  73 #endif
  74
  75     /// @}
  76     /// @name Do Not Implement
  77     /// @{
  78     private:
  79       Mutex(const Mutex & original);
  80       void operator=(const Mutex &);
  81     /// @}
  82     };
  83   }
  84 }
  85
  86 FORCE_DEFINING_FILE_TO_BE_LINKED(SystemMutex)
  87
  88 #endif