2018-01-13 16:22:39 -05:00
|
|
|
// Copyright 2018 yuzu emulator team
|
2018-01-07 21:25:57 -05:00
|
|
|
// Licensed under GPLv2 or any later version
|
|
|
|
// Refer to the license.txt file included.
|
|
|
|
|
2018-02-14 00:51:42 -05:00
|
|
|
#include <cinttypes>
|
2018-01-07 21:25:57 -05:00
|
|
|
#include "common/logging/log.h"
|
2018-08-28 12:30:33 -04:00
|
|
|
#include "core/core.h"
|
2018-01-07 21:25:57 -05:00
|
|
|
#include "core/hle/ipc_helpers.h"
|
2018-11-26 18:34:07 -05:00
|
|
|
#include "core/hle/kernel/kernel.h"
|
|
|
|
#include "core/hle/kernel/readable_event.h"
|
2019-06-16 11:43:41 -04:00
|
|
|
#include "core/hle/kernel/thread.h"
|
2018-11-26 18:34:07 -05:00
|
|
|
#include "core/hle/kernel/writable_event.h"
|
2018-01-15 18:30:49 -05:00
|
|
|
#include "core/hle/service/nvdrv/interface.h"
|
2019-06-07 18:41:55 -04:00
|
|
|
#include "core/hle/service/nvdrv/nvdata.h"
|
2018-01-07 21:25:57 -05:00
|
|
|
#include "core/hle/service/nvdrv/nvdrv.h"
|
|
|
|
|
2018-04-19 21:41:44 -04:00
|
|
|
namespace Service::Nvidia {
|
2018-01-07 21:25:57 -05:00
|
|
|
|
2019-06-12 07:52:49 -04:00
|
|
|
void NVDRV::SignalGPUInterruptSyncpt(const u32 syncpoint_id, const u32 value) {
|
|
|
|
nvdrv->SignalSyncpt(syncpoint_id, value);
|
2019-06-07 18:41:55 -04:00
|
|
|
}
|
|
|
|
|
2018-01-15 18:30:49 -05:00
|
|
|
void NVDRV::Open(Kernel::HLERequestContext& ctx) {
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
2018-01-07 21:25:57 -05:00
|
|
|
|
2018-02-13 23:16:19 -05:00
|
|
|
const auto& buffer = ctx.ReadBuffer();
|
|
|
|
std::string device_name(buffer.begin(), buffer.end());
|
2018-01-07 21:25:57 -05:00
|
|
|
|
2018-01-15 17:39:00 -05:00
|
|
|
u32 fd = nvdrv->Open(device_name);
|
2018-01-23 19:52:18 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 4};
|
2018-01-07 21:25:57 -05:00
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
rb.Push<u32>(fd);
|
|
|
|
rb.Push<u32>(0);
|
|
|
|
}
|
|
|
|
|
2019-09-19 01:37:25 -04:00
|
|
|
void NVDRV::IoctlBase(Kernel::HLERequestContext& ctx, IoctlVersion version) {
|
2018-01-07 21:25:57 -05:00
|
|
|
IPC::RequestParser rp{ctx};
|
|
|
|
u32 fd = rp.Pop<u32>();
|
|
|
|
u32 command = rp.Pop<u32>();
|
|
|
|
|
2019-09-19 01:37:25 -04:00
|
|
|
/// Ioctl 3 has 2 outputs, first in the input params, second is the result
|
|
|
|
std::vector<u8> output(ctx.GetWriteBufferSize(0));
|
|
|
|
std::vector<u8> output2;
|
|
|
|
if (version == IoctlVersion::Version3) {
|
|
|
|
output2.resize((ctx.GetWriteBufferSize(1)));
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Ioctl2 has 2 inputs. It's used to pass data directly instead of providing a pointer.
|
|
|
|
/// KickOfPB uses this
|
|
|
|
auto input = ctx.ReadBuffer(0);
|
|
|
|
|
|
|
|
std::vector<u8> input2;
|
|
|
|
if (version == IoctlVersion::Version2) {
|
|
|
|
input2 = ctx.ReadBuffer(1);
|
|
|
|
}
|
2018-02-13 22:21:17 -05:00
|
|
|
|
2019-06-16 11:43:41 -04:00
|
|
|
IoctlCtrl ctrl{};
|
|
|
|
|
2019-09-19 01:37:25 -04:00
|
|
|
u32 result = nvdrv->Ioctl(fd, command, input, input2, output, output2, ctrl, version);
|
2019-06-16 11:43:41 -04:00
|
|
|
|
2019-07-04 10:19:25 -04:00
|
|
|
if (ctrl.must_delay) {
|
|
|
|
ctrl.fresh_call = false;
|
2020-08-03 11:28:18 -04:00
|
|
|
ctx.SleepClientThread(
|
2020-10-20 22:07:39 -04:00
|
|
|
"NVServices::DelayedResponse", ctrl.timeout,
|
|
|
|
[=, this](std::shared_ptr<Kernel::Thread> thread, Kernel::HLERequestContext& ctx_,
|
|
|
|
Kernel::ThreadWakeupReason reason) {
|
2020-08-03 11:28:18 -04:00
|
|
|
IoctlCtrl ctrl2{ctrl};
|
|
|
|
std::vector<u8> tmp_output = output;
|
|
|
|
std::vector<u8> tmp_output2 = output2;
|
|
|
|
const u32 ioctl_result = nvdrv->Ioctl(fd, command, input, input2, tmp_output,
|
|
|
|
tmp_output2, ctrl2, version);
|
|
|
|
ctx_.WriteBuffer(tmp_output, 0);
|
|
|
|
if (version == IoctlVersion::Version3) {
|
|
|
|
ctx_.WriteBuffer(tmp_output2, 1);
|
|
|
|
}
|
|
|
|
IPC::ResponseBuilder rb{ctx_, 3};
|
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
rb.Push(ioctl_result);
|
|
|
|
},
|
2020-10-20 22:07:39 -04:00
|
|
|
nvdrv->GetEventWriteable(ctrl.event_id));
|
2019-07-04 10:19:25 -04:00
|
|
|
} else {
|
2019-06-16 11:43:41 -04:00
|
|
|
ctx.WriteBuffer(output);
|
2019-09-19 01:37:25 -04:00
|
|
|
if (version == IoctlVersion::Version3) {
|
|
|
|
ctx.WriteBuffer(output2, 1);
|
|
|
|
}
|
2019-06-16 11:43:41 -04:00
|
|
|
}
|
2019-07-04 10:19:25 -04:00
|
|
|
IPC::ResponseBuilder rb{ctx, 3};
|
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
rb.Push(result);
|
2018-01-07 21:25:57 -05:00
|
|
|
}
|
|
|
|
|
2019-09-19 01:37:25 -04:00
|
|
|
void NVDRV::Ioctl(Kernel::HLERequestContext& ctx) {
|
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
|
|
|
IoctlBase(ctx, IoctlVersion::Version1);
|
|
|
|
}
|
|
|
|
|
|
|
|
void NVDRV::Ioctl2(Kernel::HLERequestContext& ctx) {
|
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
|
|
|
IoctlBase(ctx, IoctlVersion::Version2);
|
|
|
|
}
|
|
|
|
|
|
|
|
void NVDRV::Ioctl3(Kernel::HLERequestContext& ctx) {
|
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
|
|
|
IoctlBase(ctx, IoctlVersion::Version3);
|
|
|
|
}
|
|
|
|
|
2018-01-17 11:08:46 -05:00
|
|
|
void NVDRV::Close(Kernel::HLERequestContext& ctx) {
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
2018-01-17 11:08:46 -05:00
|
|
|
|
|
|
|
IPC::RequestParser rp{ctx};
|
|
|
|
u32 fd = rp.Pop<u32>();
|
|
|
|
|
|
|
|
auto result = nvdrv->Close(fd);
|
|
|
|
|
2018-01-23 19:52:18 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 2};
|
2018-01-17 11:08:46 -05:00
|
|
|
rb.Push(result);
|
|
|
|
}
|
|
|
|
|
2018-01-15 18:30:49 -05:00
|
|
|
void NVDRV::Initialize(Kernel::HLERequestContext& ctx) {
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_WARNING(Service_NVDRV, "(STUBBED) called");
|
2018-11-26 01:06:13 -05:00
|
|
|
|
2018-01-23 19:52:18 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 3};
|
2018-01-07 21:25:57 -05:00
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
rb.Push<u32>(0);
|
|
|
|
}
|
|
|
|
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
void NVDRV::QueryEvent(Kernel::HLERequestContext& ctx) {
|
|
|
|
IPC::RequestParser rp{ctx};
|
|
|
|
u32 fd = rp.Pop<u32>();
|
2019-06-07 18:41:55 -04:00
|
|
|
// TODO(Blinkhawk): Figure the meaning of the flag at bit 16
|
|
|
|
u32 event_id = rp.Pop<u32>() & 0x000000FF;
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_WARNING(Service_NVDRV, "(STUBBED) called, fd={:X}, event_id={:X}", fd, event_id);
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
|
2018-02-09 00:56:45 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 3, 1};
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
rb.Push(RESULT_SUCCESS);
|
2019-07-01 11:10:27 -04:00
|
|
|
if (event_id < MaxNvEvents) {
|
2019-09-26 18:11:27 -04:00
|
|
|
auto event = nvdrv->GetEvent(event_id);
|
|
|
|
event->Clear();
|
|
|
|
rb.PushCopyObjects(event);
|
2019-06-07 18:41:55 -04:00
|
|
|
rb.Push<u32>(NvResult::Success);
|
|
|
|
} else {
|
|
|
|
rb.Push<u32>(0);
|
|
|
|
rb.Push<u32>(NvResult::BadParameter);
|
|
|
|
}
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
}
|
|
|
|
|
2020-06-28 22:01:34 -04:00
|
|
|
void NVDRV::SetAruid(Kernel::HLERequestContext& ctx) {
|
2018-01-18 23:50:18 -05:00
|
|
|
IPC::RequestParser rp{ctx};
|
2018-01-21 17:59:50 -05:00
|
|
|
pid = rp.Pop<u64>();
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_WARNING(Service_NVDRV, "(STUBBED) called, pid=0x{:X}", pid);
|
2018-11-26 01:06:13 -05:00
|
|
|
|
2018-01-23 19:52:18 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 3};
|
2018-01-18 23:50:18 -05:00
|
|
|
rb.Push(RESULT_SUCCESS);
|
2018-01-21 17:59:50 -05:00
|
|
|
rb.Push<u32>(0);
|
2018-01-18 23:50:18 -05:00
|
|
|
}
|
|
|
|
|
2020-06-28 22:01:34 -04:00
|
|
|
void NVDRV::SetGraphicsFirmwareMemoryMarginEnabled(Kernel::HLERequestContext& ctx) {
|
2018-07-02 12:13:26 -04:00
|
|
|
LOG_WARNING(Service_NVDRV, "(STUBBED) called");
|
2018-11-26 01:06:13 -05:00
|
|
|
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 2};
|
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
}
|
|
|
|
|
2018-11-23 14:55:41 -05:00
|
|
|
void NVDRV::GetStatus(Kernel::HLERequestContext& ctx) {
|
|
|
|
LOG_WARNING(Service_NVDRV, "(STUBBED) called");
|
2018-11-26 01:06:13 -05:00
|
|
|
|
2018-11-23 14:55:41 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 2};
|
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
}
|
|
|
|
|
|
|
|
void NVDRV::DumpGraphicsMemoryInfo(Kernel::HLERequestContext& ctx) {
|
|
|
|
// According to SwitchBrew, this has no inputs and no outputs, so effectively does nothing on
|
|
|
|
// retail hardware.
|
|
|
|
LOG_DEBUG(Service_NVDRV, "called");
|
2018-11-26 01:06:13 -05:00
|
|
|
|
2018-11-23 14:55:41 -05:00
|
|
|
IPC::ResponseBuilder rb{ctx, 2};
|
|
|
|
rb.Push(RESULT_SUCCESS);
|
|
|
|
}
|
|
|
|
|
2018-01-15 18:30:49 -05:00
|
|
|
NVDRV::NVDRV(std::shared_ptr<Module> nvdrv, const char* name)
|
|
|
|
: ServiceFramework(name), nvdrv(std::move(nvdrv)) {
|
2018-01-07 21:25:57 -05:00
|
|
|
static const FunctionInfo functions[] = {
|
2018-01-15 18:30:49 -05:00
|
|
|
{0, &NVDRV::Open, "Open"},
|
|
|
|
{1, &NVDRV::Ioctl, "Ioctl"},
|
2018-01-17 11:08:46 -05:00
|
|
|
{2, &NVDRV::Close, "Close"},
|
2018-01-15 18:30:49 -05:00
|
|
|
{3, &NVDRV::Initialize, "Initialize"},
|
Extra nvdrv support (#162)
* FinishInitalize needed for 3.0.1+ games
* nvdrv:s and nvdrv:t both use NVDRV
* Most settings return 0 on hardware, disabled NV_MEMORY_PROFILER for now.
NVN_THROUGH_OPENGL & NVRM_GPU_PREVENT_USE are a few interesting settings to look at. Carefully choosing settings can help with drawing graphics later on
* Initial /dev/nvhost-gpu support
* ZCullBind
* Stubbed SetErrorNotifier
* Fixed SetErrorNotifier log, Added SetChannelPriority
* Allocate GPFIFO Ex2, Allocate Obj Ctx, Submit GPFIFO
* oops
* Fixed up naming/structs/enums. Used vector instead of array for "gpfifo_entry"
* Added missing fixes
* /dev/nvhost-ctrl-gpu
* unneeded struct
* Forgot u32 in enum class
* Automatic descriptor swapping for ioctls, fixed nvgpu_gpu_get_tpc_masks_args being incorrect size
* nvdrv#QueryEvent
* Renamed logs for nvdrv
* Refactor ioctl so nv_result isn't needed
* /dev/nvhost-as-gpu
* Fixed Log service naming, CtxObjects now u32, renamed all structs, added static_asserts to structs, used INSERT_PADDING_WORDS instead of u32s
* nvdevices now uses "Ioctl" union,
* IoctlGpfifoEntry now uses bit field
* final changes
2018-02-05 21:19:31 -05:00
|
|
|
{4, &NVDRV::QueryEvent, "QueryEvent"},
|
2018-04-10 13:26:49 -04:00
|
|
|
{5, nullptr, "MapSharedMem"},
|
2018-11-23 14:55:41 -05:00
|
|
|
{6, &NVDRV::GetStatus, "GetStatus"},
|
2020-06-28 22:01:34 -04:00
|
|
|
{7, nullptr, "SetAruidForTest"},
|
|
|
|
{8, &NVDRV::SetAruid, "SetAruid"},
|
2018-11-23 14:55:41 -05:00
|
|
|
{9, &NVDRV::DumpGraphicsMemoryInfo, "DumpGraphicsMemoryInfo"},
|
2018-04-10 13:26:49 -04:00
|
|
|
{10, nullptr, "InitializeDevtools"},
|
2019-09-19 01:37:25 -04:00
|
|
|
{11, &NVDRV::Ioctl2, "Ioctl2"},
|
|
|
|
{12, &NVDRV::Ioctl3, "Ioctl3"},
|
2020-06-28 22:01:34 -04:00
|
|
|
{13, &NVDRV::SetGraphicsFirmwareMemoryMarginEnabled,
|
|
|
|
"SetGraphicsFirmwareMemoryMarginEnabled"},
|
2018-01-07 21:25:57 -05:00
|
|
|
};
|
|
|
|
RegisterHandlers(functions);
|
|
|
|
}
|
|
|
|
|
hle/service: Default constructors and destructors in the cpp file where applicable
When a destructor isn't defaulted into a cpp file, it can cause the use
of forward declarations to seemingly fail to compile for non-obvious
reasons. It also allows inlining of the construction/destruction logic
all over the place where a constructor or destructor is invoked, which
can lead to code bloat. This isn't so much a worry here, given the
services won't be created and destroyed frequently.
The cause of the above mentioned non-obvious errors can be demonstrated
as follows:
------- Demonstrative example, if you know how the described error happens, skip forwards -------
Assume we have the following in the header, which we'll call "thing.h":
\#include <memory>
// Forward declaration. For example purposes, assume the definition
// of Object is in some header named "object.h"
class Object;
class Thing {
public:
// assume no constructors or destructors are specified here,
// or the constructors/destructors are defined as:
//
// Thing() = default;
// ~Thing() = default;
//
// ... Some interface member functions would be defined here
private:
std::shared_ptr<Object> obj;
};
If this header is included in a cpp file, (which we'll call "main.cpp"),
this will result in a compilation error, because even though no
destructor is specified, the destructor will still need to be generated by
the compiler because std::shared_ptr's destructor is *not* trivial (in
other words, it does something other than nothing), as std::shared_ptr's
destructor needs to do two things:
1. Decrement the shared reference count of the object being pointed to,
and if the reference count decrements to zero,
2. Free the Object instance's memory (aka deallocate the memory it's
pointing to).
And so the compiler generates the code for the destructor doing this inside main.cpp.
Now, keep in mind, the Object forward declaration is not a complete type. All it
does is tell the compiler "a type named Object exists" and allows us to
use the name in certain situations to avoid a header dependency. So the
compiler needs to generate destruction code for Object, but the compiler
doesn't know *how* to destruct it. A forward declaration doesn't tell
the compiler anything about Object's constructor or destructor. So, the
compiler will issue an error in this case because it's undefined
behavior to try and deallocate (or construct) an incomplete type and
std::shared_ptr and std::unique_ptr make sure this isn't the case
internally.
Now, if we had defaulted the destructor in "thing.cpp", where we also
include "object.h", this would never be an issue, as the destructor
would only have its code generated in one place, and it would be in a
place where the full class definition of Object would be visible to the
compiler.
---------------------- End example ----------------------------
Given these service classes are more than certainly going to change in
the future, this defaults the constructors and destructors into the
relevant cpp files to make the construction and destruction of all of
the services consistent and unlikely to run into cases where forward
declarations are indirectly causing compilation errors. It also has the
plus of avoiding the need to rebuild several services if destruction
logic changes, since it would only be necessary to recompile the single
cpp file.
2018-09-10 21:20:52 -04:00
|
|
|
NVDRV::~NVDRV() = default;
|
|
|
|
|
2018-04-19 21:41:44 -04:00
|
|
|
} // namespace Service::Nvidia
|