2014-05-20 23:03:45 -04:00
|
|
|
// Copyright 2014 Citra Emulator Project
|
2014-12-17 00:38:14 -05:00
|
|
|
// Licensed under GPLv2 or any later version
|
2014-11-19 03:49:13 -05:00
|
|
|
// Refer to the license.txt file included.
|
2014-05-20 23:03:45 -04:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2015-01-22 20:12:19 -05:00
|
|
|
#include <string>
|
2014-05-20 23:03:45 -04:00
|
|
|
#include "common/common_types.h"
|
|
|
|
#include "core/hle/kernel/kernel.h"
|
|
|
|
|
|
|
|
namespace Kernel {
|
|
|
|
|
2015-01-22 20:12:19 -05:00
|
|
|
class Thread;
|
|
|
|
|
2015-01-26 23:40:21 -05:00
|
|
|
class Mutex final : public WaitObject {
|
2015-01-22 20:12:19 -05:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Creates a mutex.
|
|
|
|
* @param initial_locked Specifies if the mutex should be locked initially
|
|
|
|
* @param name Optional name of mutex
|
|
|
|
* @return Pointer to new Mutex object
|
|
|
|
*/
|
2015-01-31 21:14:40 -05:00
|
|
|
static SharedPtr<Mutex> Create(bool initial_locked, std::string name = "Unknown");
|
2015-01-22 20:12:19 -05:00
|
|
|
|
2016-09-17 20:38:01 -04:00
|
|
|
std::string GetTypeName() const override {
|
|
|
|
return "Mutex";
|
|
|
|
}
|
|
|
|
std::string GetName() const override {
|
|
|
|
return name;
|
|
|
|
}
|
2015-01-22 20:12:19 -05:00
|
|
|
|
|
|
|
static const HandleType HANDLE_TYPE = HandleType::Mutex;
|
2016-09-17 20:38:01 -04:00
|
|
|
HandleType GetHandleType() const override {
|
|
|
|
return HANDLE_TYPE;
|
|
|
|
}
|
2015-01-22 20:12:19 -05:00
|
|
|
|
2016-09-17 20:38:01 -04:00
|
|
|
int lock_count; ///< Number of times the mutex has been acquired
|
2017-01-01 16:59:30 -05:00
|
|
|
u32 priority; ///< The priority of the mutex, used for priority inheritance.
|
2016-09-17 20:38:01 -04:00
|
|
|
std::string name; ///< Name of mutex (optional)
|
|
|
|
SharedPtr<Thread> holding_thread; ///< Thread that has acquired the mutex
|
2015-01-22 20:12:19 -05:00
|
|
|
|
2017-01-01 16:53:22 -05:00
|
|
|
bool ShouldWait(Thread* thread) const override;
|
|
|
|
void Acquire(Thread* thread) override;
|
|
|
|
|
2017-01-01 16:59:30 -05:00
|
|
|
void AddWaitingThread(SharedPtr<Thread> thread) override;
|
2015-01-22 20:12:19 -05:00
|
|
|
|
|
|
|
void Release();
|
|
|
|
|
|
|
|
private:
|
2015-01-31 19:56:59 -05:00
|
|
|
Mutex();
|
|
|
|
~Mutex() override;
|
2015-01-22 20:12:19 -05:00
|
|
|
};
|
2014-05-20 23:03:45 -04:00
|
|
|
|
2014-12-07 15:44:21 -05:00
|
|
|
/**
|
|
|
|
* Releases all the mutexes held by the specified thread
|
|
|
|
* @param thread Thread that is holding the mutexes
|
|
|
|
*/
|
2015-01-20 18:33:23 -05:00
|
|
|
void ReleaseThreadMutexes(Thread* thread);
|
2014-12-07 15:44:21 -05:00
|
|
|
|
2014-05-20 23:03:45 -04:00
|
|
|
} // namespace
|