runtime_options.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "condy/condy_uring.hpp"
#include <cstddef>
#include <cstdint>
#include <optional>
#include <stdexcept>
 
namespace condy {
 
class Runtime;

struct RuntimeOptions {
public:
    using Self = RuntimeOptions;

    Self &event_interval(size_t v) {
        event_interval_ = v;
        return *this;
    }

    Self &disable_register_ring_fd() {
        disable_register_ring_fd_ = true;
        return *this;
    }

    [[deprecated("Use enable_iopoll() and enable_hybrid_iopoll() instead")]]
    Self &enable_iopoll([[maybe_unused]] bool hybrid) {
        enable_iopoll();
#if !IO_URING_CHECK_VERSION(2, 9) // >= 2.9
        if (hybrid) {
            enable_hybrid_iopoll();
        }
#endif
        return *this;
    }

    Self &enable_iopoll() {
        enable_iopoll_ = true;
        return *this;
    }
 
#if !IO_URING_CHECK_VERSION(2, 9) // >= 2.9
    Self &enable_hybrid_iopoll() {
        if (!enable_iopoll_) {
            throw std::logic_error(
                "hybrid_iopoll cannot be enabled without iopoll");
        }
        enable_hybrid_iopoll_ = true;
        return *this;
    }
#endif

    Self &enable_sqpoll(size_t idle_time_ms = 1000,
                        std::optional<uint32_t> cpu = std::nullopt) {
        if (enable_defer_taskrun_) {
            throw std::logic_error(
                "sqpoll cannot be enabled with defer_taskrun");
        }
        if (enable_coop_taskrun_) {
            throw std::logic_error(
                "sqpoll cannot be enabled with coop_taskrun");
        }
        if (enable_sq_rewind_) {
            throw std::logic_error("sqpoll cannot be enabled with sq_rewind");
        }
        enable_sqpoll_ = true;
        sqpoll_idle_time_ms_ = idle_time_ms;
        sqpoll_thread_cpu_ = cpu;
        return *this;
    }

    Self &enable_defer_taskrun() {
        if (enable_sqpoll_) {
            throw std::logic_error(
                "defer_taskrun cannot be enabled with sqpoll");
        }
        if (enable_coop_taskrun_) {
            throw std::logic_error(
                "defer_taskrun cannot be enabled with coop_taskrun");
        }
        enable_defer_taskrun_ = true;
        return *this;
    }

    Self &sq_size(size_t v) {
        sq_size_ = v;
        return *this;
    }

    Self &cq_size(size_t v) {
        cq_size_ = v;
        return *this;
    }

    Self &enable_attach_wq(Runtime &other) {
        attach_wq_target_ = &other;
        return *this;
    }

    Self &enable_coop_taskrun() {
        if (enable_sqpoll_) {
            throw std::logic_error(
                "coop_taskrun cannot be enabled with sqpoll");
        }
        if (enable_defer_taskrun_) {
            throw std::logic_error(
                "coop_taskrun cannot be enabled with defer_taskrun");
        }
        enable_coop_taskrun_ = true;
        return *this;
    }

    [[deprecated("Use enable_coop_taskrun() without parameters instead")]]
    Self &enable_coop_taskrun([[maybe_unused]] bool taskrun_flag) {
        enable_coop_taskrun();
        return *this;
    }

    Self &enable_sqe128() {
        if (enable_sqe_mixed_) {
            throw std::logic_error("sqe128 cannot be enabled with sqe_mixed");
        }
        enable_sqe128_ = true;
        return *this;
    }

    Self &enable_cqe32() {
        if (enable_cqe_mixed_) {
            throw std::logic_error("cqe32 cannot be enabled with cqe_mixed");
        }
        enable_cqe32_ = true;
        return *this;
    }
 
#if !IO_URING_CHECK_VERSION(2, 13) // >= 2.13
    Self &enable_sqe_mixed() {
        if (enable_sqe128_) {
            throw std::logic_error("sqe_mixed cannot be enabled with sqe128");
        }
        enable_sqe_mixed_ = true;
        return *this;
    }
#endif
 
#if !IO_URING_CHECK_VERSION(2, 13) // >= 2.13
    Self &enable_cqe_mixed() {
        if (enable_cqe32_) {
            throw std::logic_error("cqe_mixed cannot be enabled with cqe32");
        }
        enable_cqe_mixed_ = true;
        return *this;
    }
#endif
 
#if !IO_URING_CHECK_VERSION(2, 5) // >= 2.5
    Self &enable_no_mmap(void *buf = nullptr, size_t buf_size = 0) {
        enable_no_mmap_ = true;
        no_mmap_buf_ = buf;
        no_mmap_buf_size_ = buf_size;
        return *this;
    }
#endif
 
#if !IO_URING_CHECK_VERSION(2, 14) // >= 2.14
    Self &enable_sq_rewind() {
        if (enable_sqpoll_) {
            throw std::logic_error("sq_rewind cannot be enabled with sqpoll");
        }
        enable_sq_rewind_ = true;
        return *this;
    }
#endif
 
protected:
    size_t event_interval_ = 61;
    bool disable_register_ring_fd_ = false;
    bool enable_iopoll_ = false;
    bool enable_hybrid_iopoll_ = false;
    bool enable_sqpoll_ = false;
    size_t sqpoll_idle_time_ms_ = 1000;
    std::optional<uint32_t> sqpoll_thread_cpu_ = std::nullopt;
    bool enable_defer_taskrun_ = false;
    size_t sq_size_ = 128;
    size_t cq_size_ = 0; // 0 means default
    Runtime *attach_wq_target_ = nullptr;
    bool enable_coop_taskrun_ = false;
    bool enable_sqe128_ = false;
    bool enable_cqe32_ = false;
    bool enable_sqe_mixed_ = false;
    bool enable_cqe_mixed_ = false;
    bool enable_no_mmap_ = false;
    void *no_mmap_buf_ = nullptr;
    size_t no_mmap_buf_size_ = 0;
    bool enable_sq_rewind_ = false;
 
    friend class Runtime;
};
 
} // namespace condy