mirror of
https://github.com/RGBCube/serenity
synced 2025-07-25 17:07:34 +00:00
Kernel/Devices: Introduce the LoopDevice device
This device is a block device that allows a user to effectively treat an Inode as a block device. The static construction method is given an OpenFileDescription reference but validates that: - The description has a valid custody (so it's not some arbitrary file). Failing this requirement will yield EINVAL. - The description custody points to an Inode which is a regular file, as we only support (seekable) regular files. Failing this requirement will yield ENOTSUP. LoopDevice can be used to mount a regular file on the filesystem like other supported types of (physical) block devices.
This commit is contained in:
parent
a9d240c647
commit
5dcf03ad9a
12 changed files with 254 additions and 4 deletions
62
Kernel/Devices/Loop/LoopDevice.h
Normal file
62
Kernel/Devices/Loop/LoopDevice.h
Normal file
|
@ -0,0 +1,62 @@
|
|||
/*
|
||||
* Copyright (c) 2024, Liav A. <liavalb@hotmail.co.il>
|
||||
*
|
||||
* SPDX-License-Identifier: BSD-2-Clause
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include <AK/Badge.h>
|
||||
#include <AK/IntrusiveList.h>
|
||||
#include <Kernel/Devices/BlockDevice.h>
|
||||
#include <Kernel/FileSystem/Inode.h>
|
||||
#include <Kernel/Forward.h>
|
||||
#include <Kernel/Library/ListedRefCounted.h>
|
||||
|
||||
namespace Kernel {
|
||||
|
||||
class LoopDevice final : public BlockDevice {
|
||||
friend class DeviceManagement;
|
||||
|
||||
public:
|
||||
virtual bool unref() const override;
|
||||
virtual ~LoopDevice() = default;
|
||||
|
||||
void remove(Badge<DeviceControlDevice>);
|
||||
static ErrorOr<NonnullRefPtr<LoopDevice>> create_with_file_description(OpenFileDescription&);
|
||||
|
||||
virtual StringView class_name() const override { return "LoopDevice"sv; }
|
||||
|
||||
virtual ErrorOr<size_t> read(OpenFileDescription&, u64, UserOrKernelBuffer&, size_t) override;
|
||||
virtual ErrorOr<size_t> write(OpenFileDescription&, u64, UserOrKernelBuffer const&, size_t) override;
|
||||
virtual bool can_read(OpenFileDescription const&, u64) const override;
|
||||
virtual bool can_write(OpenFileDescription const&, u64) const override;
|
||||
virtual ErrorOr<void> ioctl(OpenFileDescription&, unsigned request, Userspace<void*> arg) override;
|
||||
|
||||
virtual bool is_loop_device() const override { return true; }
|
||||
|
||||
unsigned index() const { return m_index; }
|
||||
|
||||
Inode const& inode() const { return m_backing_custody->inode(); }
|
||||
Inode& inode() { return m_backing_custody->inode(); }
|
||||
|
||||
Custody const& custody() const { return *m_backing_custody; }
|
||||
Custody& custody() { return *m_backing_custody; }
|
||||
|
||||
private:
|
||||
virtual void start_request(AsyncBlockDeviceRequest&) override;
|
||||
|
||||
LoopDevice(NonnullRefPtr<Custody>, unsigned index);
|
||||
|
||||
NonnullRefPtr<Custody> const m_backing_custody;
|
||||
unsigned const m_index { 0 };
|
||||
|
||||
mutable IntrusiveListNode<LoopDevice, NonnullRefPtr<LoopDevice>> m_list_node;
|
||||
|
||||
public:
|
||||
using List = IntrusiveList<&LoopDevice::m_list_node>;
|
||||
|
||||
static SpinlockProtected<LoopDevice::List, LockRank::None>& all_instances();
|
||||
};
|
||||
|
||||
}
|
Loading…
Add table
Add a link
Reference in a new issue