/* * 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 { enum class ShouldBlock { No = 0, Yes = 1 }; class FileDescription; class Socket : public File { public: static KResultOr> create(int domain, int type, int protocol); virtual ~Socket() override; int domain() const { return m_domain; } int type() const { return m_type; } int protocol() const { return m_protocol; } bool is_shut_down_for_writing() const { return m_shut_down_for_writing; } bool is_shut_down_for_reading() const { return m_shut_down_for_reading; } enum class SetupState { Unstarted, // we haven't tried to set the socket up yet InProgress, // we're in the process of setting things up - for TCP maybe we've sent a SYN packet Completed, // the setup process is complete, but not necessarily successful }; enum class Role : u8 { None, Listener, Accepted, Connected, Connecting }; static StringView to_string(SetupState setup_state) { switch (setup_state) { case SetupState::Unstarted: return "Unstarted"sv; case SetupState::InProgress: return "InProgress"sv; case SetupState::Completed: return "Completed"sv; default: return "None"sv; } } SetupState setup_state() const { return m_setup_state; } void set_setup_state(SetupState setup_state); virtual Role role(const FileDescription&) const { return m_role; } bool is_connected() const { return m_connected; } void set_connected(bool); bool can_accept() const { return !m_pending.is_empty(); } RefPtr accept(); KResult shutdown(int how); virtual KResult bind(Userspace, socklen_t) = 0; virtual KResult connect(FileDescription&, Userspace, socklen_t, ShouldBlock) = 0; virtual KResult listen(size_t) = 0; virtual void get_local_address(sockaddr*, socklen_t*) = 0; virtual void get_peer_address(sockaddr*, socklen_t*) = 0; virtual bool is_local() const { return false; } virtual bool is_ipv4() const { return false; } virtual KResultOr sendto(FileDescription&, const UserOrKernelBuffer&, size_t, int flags, Userspace, socklen_t) = 0; virtual KResultOr recvfrom(FileDescription&, UserOrKernelBuffer&, size_t, int flags, Userspace, Userspace, Time&) = 0; virtual KResult setsockopt(int level, int option, Userspace, socklen_t); virtual KResult getsockopt(FileDescription&, int level, int option, Userspace, Userspace); pid_t origin_pid() const { return m_origin.pid; } uid_t origin_uid() const { return m_origin.uid; } gid_t origin_gid() const { return m_origin.gid; } pid_t acceptor_pid() const { return m_acceptor.pid; } uid_t acceptor_uid() const { return m_acceptor.uid; } gid_t acceptor_gid() const { return m_acceptor.gid; } const RefPtr bound_interface() const { return m_bound_interface; } Mutex& lock() { return m_lock; } // ^File virtual KResultOr read(FileDescription&, u64, UserOrKernelBuffer&, size_t) override final; virtual KResultOr write(FileDescription&, u64, const UserOrKernelBuffer&, size_t) override final; virtual KResult stat(::stat&) const override; virtual String absolute_path(const FileDescription&) const override = 0; bool has_receive_timeout() const { return m_receive_timeout != Time::zero(); } const Time& receive_timeout() const { return m_receive_timeout; } bool has_send_timeout() const { return m_send_timeout != Time::zero(); } const Time& send_timeout() const { return m_send_timeout; } bool wants_timestamp() const { return m_timestamp; } protected: Socket(int domain, int type, int protocol); KResult queue_connection_from(NonnullRefPtr); size_t backlog() const { return m_backlog; } void set_backlog(size_t backlog) { m_backlog = backlog; } virtual StringView class_name() const override { return "Socket"; } virtual void shut_down_for_reading() { } virtual void shut_down_for_writing() { } Role m_role { Role::None }; KResult so_error() const { return m_so_error; } KResult set_so_error(KResult error) { m_so_error = error; return error; } protected: ucred m_origin { 0, 0, 0 }; ucred m_acceptor { 0, 0, 0 }; private: virtual bool is_socket() const final { return true; } Mutex m_lock { "Socket" }; int m_domain { 0 }; int m_type { 0 }; int m_protocol { 0 }; size_t m_backlog { 0 }; SetupState m_setup_state { SetupState::Unstarted }; bool m_connected { false }; bool m_shut_down_for_reading { false }; bool m_shut_down_for_writing { false }; RefPtr m_bound_interface { nullptr }; Time m_receive_timeout {}; Time m_send_timeout {}; int m_timestamp { 0 }; KResult m_so_error { KSuccess }; NonnullRefPtrVector m_pending; }; template class SocketHandle { public: SocketHandle() = default; SocketHandle(NonnullRefPtr&& socket) : m_socket(move(socket)) { if (m_socket) m_socket->lock().lock(); } SocketHandle(SocketHandle&& other) : m_socket(move(other.m_socket)) { } ~SocketHandle() { if (m_socket) m_socket->lock().unlock(); } SocketHandle(const SocketHandle&) = delete; SocketHandle& operator=(const SocketHandle&) = delete; operator bool() const { return m_socket; } SocketType* operator->() { return &socket(); } const SocketType* operator->() const { return &socket(); } SocketType& socket() { return *m_socket; } const SocketType& socket() const { return *m_socket; } private: RefPtr m_socket; }; }