mirror of
https://github.com/RGBCube/serenity
synced 2025-05-31 04:48:14 +00:00
e490c17bde
Like with the ProcFS, description data can change at anytime, so it's wise to ensure that when the userland reads from an Inode, data is consistent unless the userland indicated it wants to refresh the data (by seeking to offset 0, or re-attaching the Inode). Otherwise, if the data changes in the middle of the reading, it can cause silent corruption in output which can lead to random crashes.
61 lines
1.8 KiB
C++
61 lines
1.8 KiB
C++
/*
|
|
* Copyright (c) 2021, Liav A. <liavalb@hotmail.co.il>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <Kernel/Bus/USB/USBDevice.h>
|
|
#include <Kernel/FileSystem/SysFS.h>
|
|
#include <Kernel/KBufferBuilder.h>
|
|
#include <Kernel/Locking/Mutex.h>
|
|
|
|
namespace Kernel::USB {
|
|
|
|
class SysFSUSBDeviceInformation : public SysFSComponent {
|
|
friend class SysFSUSBBusDirectory;
|
|
|
|
public:
|
|
virtual ~SysFSUSBDeviceInformation() override;
|
|
|
|
static NonnullRefPtr<SysFSUSBDeviceInformation> create(USB::Device&);
|
|
|
|
RefPtr<USB::Device> device() const { return m_device; }
|
|
|
|
protected:
|
|
explicit SysFSUSBDeviceInformation(USB::Device& device);
|
|
|
|
virtual KResultOr<size_t> read_bytes(off_t offset, size_t count, UserOrKernelBuffer& buffer, FileDescription*) const override;
|
|
|
|
IntrusiveListNode<SysFSUSBDeviceInformation, RefPtr<SysFSUSBDeviceInformation>> m_list_node;
|
|
|
|
NonnullRefPtr<USB::Device> m_device;
|
|
|
|
private:
|
|
bool output(KBufferBuilder& builder);
|
|
virtual KResult refresh_data(FileDescription& description) const override;
|
|
mutable Mutex m_lock { "SysFSUSBDeviceInformation" };
|
|
};
|
|
|
|
class SysFSUSBBusDirectory final : public SysFSDirectory {
|
|
public:
|
|
static void initialize();
|
|
static SysFSUSBBusDirectory& the();
|
|
|
|
void plug(USB::Device&);
|
|
void unplug(USB::Device&);
|
|
|
|
virtual KResult traverse_as_directory(unsigned, Function<bool(FileSystem::DirectoryEntryView const&)>) const override;
|
|
virtual RefPtr<SysFSComponent> lookup(StringView name) override;
|
|
|
|
private:
|
|
explicit SysFSUSBBusDirectory(SysFSBusDirectory&);
|
|
|
|
RefPtr<SysFSUSBDeviceInformation> device_node_for(USB::Device& device);
|
|
|
|
IntrusiveList<SysFSUSBDeviceInformation, RefPtr<SysFSUSBDeviceInformation>, &SysFSUSBDeviceInformation::m_list_node> m_device_nodes;
|
|
mutable Spinlock<u8> m_lock;
|
|
};
|
|
|
|
}
|