0cb52ee74a
Corrects a few issues with regards to Doxygen documentation, for example: - Incorrect parameter referencing. - Missing @param tags. - Typos in @param tags. and a few minor other issues.
97 lines
3.5 KiB
C++
97 lines
3.5 KiB
C++
// Copyright 2014 Citra Emulator Project
|
|
// Licensed under GPLv2 or any later version
|
|
// Refer to the license.txt file included.
|
|
|
|
#pragma once
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
#include "common/assert.h"
|
|
#include "common/common_types.h"
|
|
#include "core/hle/kernel/kernel.h"
|
|
#include "core/hle/kernel/thread.h"
|
|
#include "core/hle/result.h"
|
|
#include "core/hle/service/service.h"
|
|
#include "core/memory.h"
|
|
|
|
namespace Kernel {
|
|
|
|
class ClientSession;
|
|
|
|
/**
|
|
* Kernel object representing the server endpoint of an IPC session. Sessions are the basic CTR-OS
|
|
* primitive for communication between different processes, and are used to implement service calls
|
|
* to the various system services.
|
|
*
|
|
* To make a service call, the client must write the command header and parameters to the buffer
|
|
* located at offset 0x80 of the TLS (Thread-Local Storage) area, then execute a SendSyncRequest
|
|
* SVC call with its ClientSession handle. The kernel will read the command header, using it to
|
|
* marshall the parameters to the process at the server endpoint of the session.
|
|
* After the server replies to the request, the response is marshalled back to the caller's
|
|
* TLS buffer and control is transferred back to it.
|
|
*/
|
|
class ServerSession final : public WaitObject {
|
|
public:
|
|
std::string GetTypeName() const override {
|
|
return "ServerSession";
|
|
}
|
|
|
|
static const HandleType HANDLE_TYPE = HandleType::ServerSession;
|
|
HandleType GetHandleType() const override {
|
|
return HANDLE_TYPE;
|
|
}
|
|
|
|
using SessionPair = std::tuple<SharedPtr<ServerSession>, SharedPtr<ClientSession>>;
|
|
|
|
/**
|
|
* Creates a pair of ServerSession and an associated ClientSession.
|
|
* @param name Optional name of the ports.
|
|
* @param hle_handler Optional HLE handler for this server session.
|
|
* @return The created session tuple
|
|
*/
|
|
static SessionPair CreateSessionPair(
|
|
const std::string& name = "Unknown",
|
|
std::shared_ptr<Service::SessionRequestHandler> hle_handler = nullptr);
|
|
|
|
/**
|
|
* Handle a sync request from the emulated application.
|
|
* @returns ResultCode from the operation.
|
|
*/
|
|
ResultCode HandleSyncRequest();
|
|
|
|
bool ShouldWait(Thread* thread) const override;
|
|
|
|
void Acquire(Thread* thread) override;
|
|
|
|
std::string name; ///< The name of this session (optional)
|
|
bool signaled; ///< Whether there's new data available to this ServerSession
|
|
std::shared_ptr<Service::SessionRequestHandler>
|
|
hle_handler; ///< This session's HLE request handler (optional)
|
|
|
|
private:
|
|
ServerSession();
|
|
~ServerSession() override;
|
|
|
|
/**
|
|
* Creates a server session. The server session can have an optional HLE handler,
|
|
* which will be invoked to handle the IPC requests that this session receives.
|
|
* @param name Optional name of the server session.
|
|
* @param hle_handler Optional HLE handler for this server session.
|
|
* @return The created server session
|
|
*/
|
|
static ResultVal<SharedPtr<ServerSession>> Create(
|
|
std::string name = "Unknown",
|
|
std::shared_ptr<Service::SessionRequestHandler> hle_handler = nullptr);
|
|
};
|
|
|
|
/**
|
|
* Performs command buffer translation for an HLE IPC request.
|
|
* The command buffer from the ServerSession thread's TLS is copied into a
|
|
* buffer and all descriptors in the buffer are processed.
|
|
* TODO(Subv): Implement this function, currently we do not support multiple processes running at
|
|
* once, but once that is implemented we'll need to properly translate all descriptors
|
|
* in the command buffer.
|
|
*/
|
|
ResultCode TranslateHLERequest(ServerSession* server_session);
|
|
}
|