/* * Copyright (c) 2018-2020, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include namespace Kernel { class ProcFS final : public FileSystem { friend class ProcFSInode; friend class ProcFSDirectoryInode; friend class ProcFSProcessDirectoryInode; friend class ProcFSGlobalInode; friend class ProcFSAssociatedProcessInode; friend class ProcFSProcessSubDirectoryInode; public: virtual ~ProcFS() override; static KResultOr> try_create(); virtual KResult initialize() override; virtual StringView class_name() const override { return "ProcFS"sv; } virtual Inode& root_inode() override; private: ProcFS(); RefPtr m_root_inode; }; class ProcFSInode : public Inode { friend class ProcFS; public: virtual ~ProcFSInode() override; protected: ProcFSInode(const ProcFS&, InodeIndex); ProcFS& procfs() { return static_cast(Inode::fs()); } ProcFS const& procfs() const { return static_cast(Inode::fs()); } // ^Inode virtual KResult attach(FileDescription& description) = 0; virtual void did_seek(FileDescription&, off_t) = 0; virtual void flush_metadata() override final; virtual KResultOr> create_child(StringView name, mode_t, dev_t, uid_t, gid_t) override final; virtual KResult add_child(Inode&, const StringView& name, mode_t) override final; virtual KResult remove_child(const StringView& name) override final; virtual KResult chmod(mode_t) override final; virtual KResult chown(uid_t, gid_t) override final; virtual KResult truncate(u64) override final; }; class ProcFSGlobalInode : public ProcFSInode { friend class ProcFS; public: static KResultOr> try_create(const ProcFS&, const ProcFSExposedComponent&); virtual ~ProcFSGlobalInode() override {}; StringView name() const; protected: ProcFSGlobalInode(const ProcFS&, const ProcFSExposedComponent&); // ^Inode virtual KResult attach(FileDescription& description) override final; virtual KResultOr read_bytes(off_t, size_t, UserOrKernelBuffer& buffer, FileDescription*) const override final; virtual KResultOr write_bytes(off_t, size_t, const UserOrKernelBuffer& buffer, FileDescription*) override final; virtual void did_seek(FileDescription&, off_t) override final; virtual InodeMetadata metadata() const override; virtual KResult traverse_as_directory(Function) const override; virtual KResultOr> lookup(StringView) override; NonnullRefPtr m_associated_component; }; class ProcFSLinkInode : public ProcFSGlobalInode { friend class ProcFS; public: static KResultOr> try_create(const ProcFS&, const ProcFSExposedComponent&); protected: ProcFSLinkInode(const ProcFS&, const ProcFSExposedComponent&); virtual InodeMetadata metadata() const override; }; class ProcFSDirectoryInode final : public ProcFSGlobalInode { friend class ProcFS; public: static KResultOr> try_create(const ProcFS&, const ProcFSExposedComponent&); virtual ~ProcFSDirectoryInode() override; protected: ProcFSDirectoryInode(const ProcFS&, const ProcFSExposedComponent&); // ^Inode virtual InodeMetadata metadata() const override; virtual KResult traverse_as_directory(Function) const override; virtual KResultOr> lookup(StringView name) override; }; class ProcFSProcessAssociatedInode : public ProcFSInode { friend class ProcFS; protected: ProcFSProcessAssociatedInode(const ProcFS&, ProcessID, InodeIndex); ProcessID associated_pid() const { return m_pid; } // ^Inode virtual KResultOr write_bytes(off_t, size_t, const UserOrKernelBuffer& buffer, FileDescription*) override final; private: const ProcessID m_pid; }; class ProcFSProcessDirectoryInode final : public ProcFSProcessAssociatedInode { friend class ProcFS; public: static KResultOr> try_create(const ProcFS&, ProcessID); private: ProcFSProcessDirectoryInode(const ProcFS&, ProcessID); // ^Inode virtual KResult attach(FileDescription& description) override; virtual void did_seek(FileDescription&, off_t) override { } virtual InodeMetadata metadata() const override; virtual KResult traverse_as_directory(Function) const override; virtual KResultOr read_bytes(off_t, size_t, UserOrKernelBuffer& buffer, FileDescription*) const override final; virtual KResultOr> lookup(StringView name) override; }; class ProcFSProcessSubDirectoryInode final : public ProcFSProcessAssociatedInode { friend class ProcFS; public: static KResultOr> try_create(const ProcFS&, SegmentedProcFSIndex::ProcessSubDirectory, ProcessID); private: ProcFSProcessSubDirectoryInode(const ProcFS&, SegmentedProcFSIndex::ProcessSubDirectory, ProcessID); // ^Inode virtual KResult attach(FileDescription& description) override; virtual void did_seek(FileDescription&, off_t) override; virtual InodeMetadata metadata() const override; virtual KResult traverse_as_directory(Function) const override; virtual KResultOr read_bytes(off_t, size_t, UserOrKernelBuffer& buffer, FileDescription*) const override final; virtual KResultOr> lookup(StringView name) override; const SegmentedProcFSIndex::ProcessSubDirectory m_sub_directory_type; }; class ProcFSProcessPropertyInode final : public ProcFSProcessAssociatedInode { friend class ProcFS; public: static KResultOr> try_create_for_file_description_link(const ProcFS&, unsigned, ProcessID); static KResultOr> try_create_for_thread_stack(const ProcFS&, ThreadID, ProcessID); static KResultOr> try_create_for_pid_property(const ProcFS&, SegmentedProcFSIndex::MainProcessProperty, ProcessID); private: ProcFSProcessPropertyInode(const ProcFS&, SegmentedProcFSIndex::MainProcessProperty, ProcessID); ProcFSProcessPropertyInode(const ProcFS&, ThreadID, ProcessID); ProcFSProcessPropertyInode(const ProcFS&, unsigned, ProcessID); // ^Inode virtual KResult attach(FileDescription& description) override; virtual void did_seek(FileDescription&, off_t) override; virtual InodeMetadata metadata() const override; virtual KResult traverse_as_directory(Function) const override; virtual KResultOr read_bytes(off_t, size_t, UserOrKernelBuffer& buffer, FileDescription*) const override final; virtual KResultOr> lookup(StringView name) override final; KResult refresh_data(FileDescription& description); KResult try_to_acquire_data(Process& process, KBufferBuilder& builder) const; const SegmentedProcFSIndex::ProcessSubDirectory m_parent_sub_directory_type; union { SegmentedProcFSIndex::MainProcessProperty property_type; unsigned property_index; } m_possible_data; mutable Mutex m_refresh_lock; }; }