/* * Copyright (c) 2018-2021, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include // FIXME: Make this a bit prettier. #define DEFAULT_PATH "/usr/local/sbin:/usr/local/bin:/usr/bin:/bin" #define DEFAULT_PATH_SV "/usr/local/sbin:/usr/local/bin:/usr/bin:/bin"sv namespace Core { /// /// Use of Core::File for reading/writing data is deprecated. /// Please use Core::Stream::File and Core::Stream::BufferedFile instead. /// class File final : public IODevice { C_OBJECT(File) public: virtual ~File() override; static ErrorOr> open(String filename, OpenMode, mode_t = 0644); String filename() const { return m_filename; } void set_filename(const String filename) { m_filename = move(filename); } bool is_directory() const; static bool is_directory(String const& filename); bool is_device() const; static bool is_device(String const& filename); bool is_block_device() const; static bool is_block_device(String const& filename); bool is_char_device() const; static bool is_char_device(String const& filename); bool is_link() const; static bool is_link(String const& filename); bool looks_like_shared_library() const; static bool looks_like_shared_library(String const& filename); static bool exists(String const& filename); static ErrorOr size(String const& filename); static String current_working_directory(); static String absolute_path(String const& path); enum class RecursionMode { Allowed, Disallowed }; enum class LinkMode { Allowed, Disallowed }; enum class AddDuplicateFileMarker { Yes, No, }; enum class PreserveMode { Nothing = 0, Permissions = (1 << 0), Ownership = (1 << 1), Timestamps = (1 << 2), }; struct CopyError : public Error { CopyError(int error_code, bool t) : Error(error_code) , tried_recursing(t) { } bool tried_recursing; }; static ErrorOr copy_file(String const& dst_path, struct stat const& src_stat, File& source, PreserveMode = PreserveMode::Nothing); static ErrorOr copy_directory(String const& dst_path, String const& src_path, struct stat const& src_stat, LinkMode = LinkMode::Disallowed, PreserveMode = PreserveMode::Nothing); static ErrorOr copy_file_or_directory(String const& dst_path, String const& src_path, RecursionMode = RecursionMode::Allowed, LinkMode = LinkMode::Disallowed, AddDuplicateFileMarker = AddDuplicateFileMarker::Yes, PreserveMode = PreserveMode::Nothing); static String real_path_for(String const& filename); static ErrorOr read_link(String const& link_path); static ErrorOr link_file(String const& dst_path, String const& src_path); struct RemoveError : public Error { RemoveError(String f, int error_code) : Error(error_code) , file(move(f)) { } String file; }; static ErrorOr remove(String const& path, RecursionMode, bool force); virtual bool open(OpenMode) override; enum class ShouldCloseFileDescriptor { No = 0, Yes }; bool open(int fd, OpenMode, ShouldCloseFileDescriptor); [[nodiscard]] int leak_fd(); static NonnullRefPtr standard_input(); static NonnullRefPtr standard_output(); static NonnullRefPtr standard_error(); static Optional resolve_executable_from_environment(StringView filename); private: File(Object* parent = nullptr) : IODevice(parent) { } explicit File(String filename, Object* parent = nullptr); bool open_impl(OpenMode, mode_t); String m_filename; ShouldCloseFileDescriptor m_should_close_file_descriptor { ShouldCloseFileDescriptor::Yes }; }; AK_ENUM_BITWISE_OPERATORS(File::PreserveMode); }