/* * Copyright (c) 2018-2020, Andreas Kling * Copyright (c) 2023, Liav A. * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include ErrorOr> try_copy_kstring_from_user(Userspace, size_t); template ErrorOr try_copy_string_from_user_into_fixed_string_buffer(Userspace user_str, FixedStringBuffer& buffer, size_t user_str_size) { if (user_str_size > Size) return E2BIG; TRY(buffer.copy_characters_from_user(user_str, user_str_size)); return {}; } template ErrorOr try_copy_name_from_user_into_fixed_string_buffer(Userspace user_str, FixedStringBuffer& buffer, size_t user_str_size) { if (user_str_size > Size) return ENAMETOOLONG; TRY(buffer.copy_characters_from_user(user_str, user_str_size)); return {}; } ErrorOr copy_time_from_user(timespec const*); ErrorOr copy_time_from_user(timeval const*); template ErrorOr copy_time_from_user(Userspace); [[nodiscard]] Optional user_atomic_fetch_add_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_exchange_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_load_relaxed(u32 volatile* var); [[nodiscard]] bool user_atomic_store_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_compare_exchange_relaxed(u32 volatile* var, u32& expected, u32 val); [[nodiscard]] Optional user_atomic_fetch_and_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_fetch_and_not_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_fetch_or_relaxed(u32 volatile* var, u32 val); [[nodiscard]] Optional user_atomic_fetch_xor_relaxed(u32 volatile* var, u32 val); ErrorOr copy_to_user(void*, void const*, size_t); ErrorOr copy_from_user(void*, void const*, size_t); ErrorOr memset_user(void*, int, size_t); extern "C" { void* memcpy(void*, void const*, size_t); [[nodiscard]] int strncmp(char const* s1, char const* s2, size_t n); [[nodiscard]] char* strstr(char const* haystack, char const* needle); [[nodiscard]] int strcmp(char const*, char const*); [[nodiscard]] size_t strlen(char const*); [[nodiscard]] size_t strnlen(char const*, size_t); void* memset(void*, int, size_t); [[nodiscard]] int memcmp(void const*, void const*, size_t); void* memmove(void* dest, void const* src, size_t n); void const* memmem(void const* haystack, size_t, void const* needle, size_t); [[nodiscard]] inline u16 ntohs(u16 w) { return (w & 0xff) << 8 | ((w >> 8) & 0xff); } [[nodiscard]] inline u16 htons(u16 w) { return (w & 0xff) << 8 | ((w >> 8) & 0xff); } } template [[nodiscard]] inline ErrorOr copy_from_user(T* dest, T const* src) { static_assert(IsTriviallyCopyable); return copy_from_user(dest, src, sizeof(T)); } template [[nodiscard]] inline ErrorOr copy_to_user(T* dest, T const* src) { static_assert(IsTriviallyCopyable); return copy_to_user(dest, src, sizeof(T)); } template [[nodiscard]] inline ErrorOr copy_from_user(T* dest, Userspace src) { static_assert(IsTriviallyCopyable); return copy_from_user(dest, src.unsafe_userspace_ptr(), sizeof(T)); } template [[nodiscard]] inline ErrorOr copy_from_user(T* dest, Userspace src) { static_assert(IsTriviallyCopyable); return copy_from_user(dest, src.unsafe_userspace_ptr(), sizeof(T)); } #define DEPRECATE_COPY_FROM_USER_TYPE(T, REPLACEMENT) \ template<> \ [[nodiscard]] inline __attribute__((deprecated("use " #REPLACEMENT " instead"))) ErrorOr copy_from_user(T*, const T*) \ { \ VERIFY_NOT_REACHED(); \ } \ template<> \ [[nodiscard]] inline __attribute__((deprecated("use " #REPLACEMENT " instead"))) ErrorOr copy_from_user(T*, Userspace) \ { \ VERIFY_NOT_REACHED(); \ } \ template<> \ [[nodiscard]] inline __attribute__((deprecated("use " #REPLACEMENT " instead"))) ErrorOr copy_from_user(T*, Userspace) \ { \ VERIFY_NOT_REACHED(); \ } DEPRECATE_COPY_FROM_USER_TYPE(timespec, copy_time_from_user) DEPRECATE_COPY_FROM_USER_TYPE(timeval, copy_time_from_user) template [[nodiscard]] inline ErrorOr copy_to_user(Userspace dest, T const* src) { static_assert(IsTriviallyCopyable); return copy_to_user(dest.unsafe_userspace_ptr(), src, sizeof(T)); } template [[nodiscard]] inline ErrorOr copy_to_user(Userspace dest, void const* src, size_t size) { static_assert(IsTriviallyCopyable); return copy_to_user(dest.unsafe_userspace_ptr(), src, size); } template [[nodiscard]] inline ErrorOr copy_from_user(void* dest, Userspace src, size_t size) { static_assert(IsTriviallyCopyable); return copy_from_user(dest, src.unsafe_userspace_ptr(), size); } template [[nodiscard]] inline ErrorOr copy_n_from_user(T* dest, T const* src, size_t count) { static_assert(IsTriviallyCopyable); Checked size = sizeof(T); size *= count; if (size.has_overflow()) return EOVERFLOW; return copy_from_user(dest, src, size.value()); } template [[nodiscard]] inline ErrorOr copy_n_to_user(T* dest, T const* src, size_t count) { static_assert(IsTriviallyCopyable); Checked size = sizeof(T); size *= count; if (size.has_overflow()) return EOVERFLOW; return copy_to_user(dest, src, size.value()); } template [[nodiscard]] inline ErrorOr copy_n_from_user(T* dest, Userspace src, size_t count) { static_assert(IsTriviallyCopyable); Checked size = sizeof(T); size *= count; if (size.has_overflow()) return EOVERFLOW; return copy_from_user(dest, src.unsafe_userspace_ptr(), size.value()); } template [[nodiscard]] inline ErrorOr copy_n_to_user(Userspace dest, T const* src, size_t count) { static_assert(IsTriviallyCopyable); Checked size = sizeof(T); size *= count; if (size.has_overflow()) return EOVERFLOW; return copy_to_user(dest.unsafe_userspace_ptr(), src, size.value()); } template inline ErrorOr copy_typed_from_user(Userspace user_data) { T data {}; TRY(copy_from_user(&data, user_data)); return data; } template inline ErrorOr copy_typed_from_user(Userspace user_data) { T data {}; TRY(copy_from_user(&data, user_data)); return data; } template ErrorOr copy_fixed_string_buffer_including_null_char_to_user(Userspace dest, size_t buffer_size, FixedStringBuffer const& buffer) { FixedStringBuffer name_with_null_char {}; name_with_null_char.store_characters(buffer.representable_view()); if (name_with_null_char.stored_length() + 1 > buffer_size) return ENAMETOOLONG; auto name_with_null_char_view = name_with_null_char.span_view_ensuring_ending_null_char(); return copy_to_user(dest, name_with_null_char_view.data(), name_with_null_char_view.size()); }