PMDK C++ bindings  1.13.0-git107.g7e59f08f
This is the C++ bindings documentation for PMDK's libpmemobj.
pmem::obj::mutex Class Reference

Persistent memory resident mutex implementation. More...

#include <libpmemobj++/mutex.hpp>

Public Types

typedef PMEMmutex * native_handle_type
 Implementation defined handle to the native type.
 

Public Member Functions

 mutex ()
 Default constructor. More...
 
 ~mutex ()=default
 Defaulted destructor.
 
void lock ()
 Locks the mutex, blocks if already locked. More...
 
bool try_lock ()
 Tries to lock the mutex, returns regardless if the lock succeeds. More...
 
void unlock ()
 Unlocks a previously locked mutex. More...
 
native_handle_type native_handle () noexcept
 Access a native handle to this condition variable. More...
 
enum pobj_tx_param lock_type () const noexcept
 The type of lock needed for the transaction API. More...
 
mutexoperator= (const mutex &)=delete
 Deleted assignment operator.
 
 mutex (const mutex &)=delete
 Deleted copy constructor.
 

Detailed Description

Persistent memory resident mutex implementation.

This class is an implementation of a PMEM-resident mutex which mimics in behavior the C++11 std::mutex. This class satisfies all requirements of the Mutex and StandardLayoutType concepts. The typical usage example would be:

#include <mutex>
void
unique_guard_example()
{
/* pool root structure */
struct root {
};
/* create a pmemobj pool */
auto pop = pmem::obj::pool<root>::create("poolfile", "layout",
PMEMOBJ_MIN_POOL);
auto proot = pop.root();
/* typical usage schemes */
std::lock_guard<pmem::obj::mutex> guard(proot->pmutex);
std::unique_lock<pmem::obj::mutex> other_guard(proot->pmutex);
}
Persistent memory resident mutex implementation.
Definition: mutex.hpp:33
static pool< T > create(const std::string &path, const std::string &layout, std::size_t size=PMEMOBJ_MIN_POOL, mode_t mode=DEFAULT_MODE)
Creates a new transactional object store pool.
Definition: pool.hpp:694
Pmem-resident mutex.
Persistent smart pointer.
C++ pmemobj pool.

Constructor & Destructor Documentation

◆ mutex()

pmem::obj::mutex::mutex ( )
inline

Default constructor.

Exceptions
lock_errorwhen the mutex is not from persistent memory.

Member Function Documentation

◆ lock()

void pmem::obj::mutex::lock ( )
inline

Locks the mutex, blocks if already locked.

If a different thread already locked this mutex, the calling thread will block. If the same thread tries to lock a mutex it already owns, the behavior is undefined.

Exceptions
lock_errorwhen an error occurs, this includes all system related errors with the underlying implementation of the mutex.

◆ lock_type()

enum pobj_tx_param pmem::obj::mutex::lock_type ( ) const
inlinenoexcept

The type of lock needed for the transaction API.

Returns
TX_PARAM_MUTEX

◆ native_handle()

native_handle_type pmem::obj::mutex::native_handle ( )
inlinenoexcept

Access a native handle to this condition variable.

Returns
a pointer to PMEMmutex.

◆ try_lock()

bool pmem::obj::mutex::try_lock ( )
inline

Tries to lock the mutex, returns regardless if the lock succeeds.

If the same thread tries to lock a mutex it already owns, the behavior is undefined.

Returns
true on successful lock acquisition, false otherwise.
Exceptions
lock_errorwhen an error occurs, this includes all system related errors with the underlying implementation of the mutex.

◆ unlock()

void pmem::obj::mutex::unlock ( )
inline

Unlocks a previously locked mutex.

Unlocking a mutex that has not been locked by the current thread results in undefined behavior. Unlocking a mutex that has not been lock also results in undefined behavior.


The documentation for this class was generated from the following file: