/* * 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 OpenFileDescriptionData { public: virtual ~OpenFileDescriptionData() = default; }; class OpenFileDescription : public RefCounted { public: static ErrorOr> try_create(Custody&); static ErrorOr> try_create(File&); ~OpenFileDescription(); Thread::FileBlocker::BlockFlags should_unblock(Thread::FileBlocker::BlockFlags) const; bool is_readable() const { return m_readable; } bool is_writable() const { return m_writable; } void set_readable(bool b) { m_readable = b; } void set_writable(bool b) { m_writable = b; } void set_rw_mode(int options) { set_readable((options & O_RDONLY) == O_RDONLY); set_writable((options & O_WRONLY) == O_WRONLY); } ErrorOr close(); ErrorOr seek(off_t, int whence); ErrorOr read(UserOrKernelBuffer&, size_t); ErrorOr write(const UserOrKernelBuffer& data, size_t); ErrorOr stat(); // NOTE: These ignore the current offset of this file description. ErrorOr read(UserOrKernelBuffer&, u64 offset, size_t); ErrorOr write(u64 offset, UserOrKernelBuffer const&, size_t); ErrorOr chmod(mode_t); bool can_read() const; bool can_write() const; ErrorOr get_dir_entries(UserOrKernelBuffer& buffer, size_t); ErrorOr> read_entire_file(); ErrorOr> original_absolute_path() const; ErrorOr> pseudo_path() const; bool is_direct() const { return m_direct; } bool is_directory() const { return m_is_directory; } File& file() { return *m_file; } const File& file() const { return *m_file; } bool is_device() const; const Device* device() const; Device* device(); bool is_tty() const; const TTY* tty() const; TTY* tty(); bool is_inode_watcher() const; const InodeWatcher* inode_watcher() const; InodeWatcher* inode_watcher(); bool is_master_pty() const; const MasterPTY* master_pty() const; MasterPTY* master_pty(); InodeMetadata metadata() const; Inode* inode() { return m_inode.ptr(); } const Inode* inode() const { return m_inode.ptr(); } Custody* custody() { return m_custody.ptr(); } const Custody* custody() const { return m_custody.ptr(); } ErrorOr mmap(Process&, Memory::VirtualRange const&, u64 offset, int prot, bool shared); bool is_blocking() const { return m_is_blocking; } void set_blocking(bool b) { m_is_blocking = b; } bool should_append() const { return m_should_append; } void set_should_append(bool s) { m_should_append = s; } u32 file_flags() const { return m_file_flags; } void set_file_flags(u32); bool is_socket() const; Socket* socket(); const Socket* socket() const; bool is_fifo() const; FIFO* fifo(); FIFO::Direction fifo_direction() const { return m_fifo_direction; } void set_fifo_direction(Badge, FIFO::Direction direction) { m_fifo_direction = direction; } OwnPtr& data() { return m_data; } void set_original_inode(Badge, NonnullRefPtr&& inode) { m_inode = move(inode); } void set_original_custody(Badge, Custody& custody); ErrorOr truncate(u64); ErrorOr sync(); off_t offset() const { return m_current_offset; } ErrorOr chown(UserID, GroupID); FileBlockerSet& blocker_set(); ErrorOr apply_flock(Process const&, Userspace); ErrorOr get_flock(Userspace) const; private: friend class VirtualFileSystem; explicit OpenFileDescription(File&); ErrorOr attach(); void evaluate_block_conditions() { blocker_set().unblock_all_blockers_whose_conditions_are_met(); } RefPtr m_custody; RefPtr m_inode; NonnullRefPtr m_file; off_t m_current_offset { 0 }; OwnPtr m_data; u32 m_file_flags { 0 }; bool m_readable : 1 { false }; bool m_writable : 1 { false }; bool m_is_blocking : 1 { true }; bool m_is_directory : 1 { false }; bool m_should_append : 1 { false }; bool m_direct : 1 { false }; FIFO::Direction m_fifo_direction { FIFO::Direction::Neither }; Mutex m_lock { "OpenFileDescription" }; }; }