1 /* Copyright (c) 2006-2021. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
6 #include <simgrid/mutex.h>
7 #include <simgrid/s4u/Mutex.hpp>
8 #include <src/kernel/activity/MutexImpl.hpp>
9 #include <src/kernel/actor/SimcallObserver.hpp>
14 /** @brief Blocks the calling actor until the mutex can be obtained */
17 kernel::actor::ActorImpl* issuer = kernel::actor::ActorImpl::self();
18 kernel::actor::MutexLockSimcall observer{issuer, pimpl_};
19 kernel::actor::simcall_blocking([&observer] { observer.get_mutex()->lock(observer.get_issuer()); }, &observer);
22 /** @brief Release the ownership of the mutex, unleashing a blocked actor (if any)
24 * Will fail if the calling actor does not own the mutex.
28 kernel::actor::ActorImpl* issuer = kernel::actor::ActorImpl::self();
29 kernel::actor::MutexUnlockSimcall observer{issuer, pimpl_};
30 kernel::actor::simcall([this, issuer] { this->pimpl_->unlock(issuer); }, &observer);
33 /** @brief Acquire the mutex if it's free, and return false (without blocking) if not */
34 bool Mutex::try_lock()
36 kernel::actor::ActorImpl* issuer = kernel::actor::ActorImpl::self();
37 kernel::actor::MutexLockSimcall observer{issuer, pimpl_, false};
38 return kernel::actor::simcall([&observer] { return observer.get_mutex()->try_lock(observer.get_issuer()); },
42 /** @brief Create a new mutex
46 MutexPtr Mutex::create()
48 auto* mutex = new kernel::activity::MutexImpl();
49 return MutexPtr(&mutex->mutex(), false);
52 /* refcounting of the intrusive_ptr is delegated to the implementation object */
53 void intrusive_ptr_add_ref(const Mutex* mutex)
58 void intrusive_ptr_release(const Mutex* mutex)
61 mutex->pimpl_->unref();
65 } // namespace simgrid
67 /* **************************** Public C interface *************************** */
68 sg_mutex_t sg_mutex_init()
70 return simgrid::s4u::Mutex::create().detach();
73 void sg_mutex_lock(sg_mutex_t mutex)
78 void sg_mutex_unlock(sg_mutex_t mutex)
83 int sg_mutex_try_lock(sg_mutex_t mutex)
85 return mutex->try_lock();
88 void sg_mutex_destroy(const_sg_mutex_t mutex)
90 intrusive_ptr_release(mutex);