2014-07-06 20:15:40 -07:00
|
|
|
// Copyright 2014 Citra Emulator Project
|
2014-12-16 21:38:14 -08:00
|
|
|
// Licensed under GPLv2 or any later version
|
2014-07-06 20:15:40 -07:00
|
|
|
// Refer to the license.txt file included.
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include "common/common_types.h"
|
|
|
|
#include "core/hle/kernel/kernel.h"
|
2017-05-29 16:45:42 -07:00
|
|
|
#include "core/hle/result.h"
|
2014-07-06 20:15:40 -07:00
|
|
|
|
|
|
|
// Address arbiters are an underlying kernel synchronization object that can be created/used via
|
|
|
|
// supervisor calls (SVCs). They function as sort of a global lock. Typically, games/other CTR
|
|
|
|
// applications use them as an underlying mechanism to implement thread-safe barriers, events, and
|
2014-11-19 00:49:13 -08:00
|
|
|
// semphores.
|
2014-07-06 20:15:40 -07:00
|
|
|
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Kernel namespace
|
|
|
|
|
|
|
|
namespace Kernel {
|
|
|
|
|
|
|
|
enum class ArbitrationType : u32 {
|
|
|
|
Signal,
|
|
|
|
WaitIfLessThan,
|
|
|
|
DecrementAndWaitIfLessThan,
|
|
|
|
WaitIfLessThanWithTimeout,
|
|
|
|
DecrementAndWaitIfLessThanWithTimeout,
|
|
|
|
};
|
|
|
|
|
2015-01-26 20:40:21 -08:00
|
|
|
class AddressArbiter final : public Object {
|
2015-01-11 08:46:49 -08:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Creates an address arbiter.
|
|
|
|
*
|
|
|
|
* @param name Optional name used for debugging.
|
|
|
|
* @returns The created AddressArbiter.
|
|
|
|
*/
|
2015-01-31 18:14:40 -08:00
|
|
|
static SharedPtr<AddressArbiter> Create(std::string name = "Unknown");
|
2014-07-06 20:15:40 -07:00
|
|
|
|
2016-09-17 17:38:01 -07:00
|
|
|
std::string GetTypeName() const override {
|
|
|
|
return "Arbiter";
|
|
|
|
}
|
|
|
|
std::string GetName() const override {
|
|
|
|
return name;
|
|
|
|
}
|
2015-01-11 08:46:49 -08:00
|
|
|
|
|
|
|
static const HandleType HANDLE_TYPE = HandleType::AddressArbiter;
|
2016-09-17 17:38:01 -07:00
|
|
|
HandleType GetHandleType() const override {
|
|
|
|
return HANDLE_TYPE;
|
|
|
|
}
|
2015-01-11 08:46:49 -08:00
|
|
|
|
2016-09-17 17:38:01 -07:00
|
|
|
std::string name; ///< Name of address arbiter object (optional)
|
2015-01-11 08:46:49 -08:00
|
|
|
|
|
|
|
ResultCode ArbitrateAddress(ArbitrationType type, VAddr address, s32 value, u64 nanoseconds);
|
|
|
|
|
|
|
|
private:
|
2015-01-31 16:56:59 -08:00
|
|
|
AddressArbiter();
|
|
|
|
~AddressArbiter() override;
|
2015-01-11 08:46:49 -08:00
|
|
|
};
|
2014-07-06 20:15:40 -07:00
|
|
|
|
|
|
|
} // namespace FileSys
|