reactor.h

Go to the documentation of this file.

/* -*- C -*-
 * Serene programming language
 * Copyright (C) 2019-2026 Sameer Rahmani <[email protected]>
 *
 * This library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library.  If not, see <https://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include <stddef.h>
 
typedef struct srn_engine_t srn_engine_t;
typedef struct srn_reactor_backend_t srn_reactor_backend_t;
 
/* typedef struct srn_reactor_t { */
/*   // Just a back ref to the engine */
/*   srn_engine_t *engine; */
 
/*   // The chosen backend based on platfrom and so on. */
/*   // `state` is that backend's private data */
/*   const srn_reactor_backend_t *backend; */
/*   void *backend_state; */
 
/*   // Outstanding ops: submitted, not yet completed. The worker loop reads
 * this */
/*   // to decide what to do when the ready queue drains -- inflight > 0 means
 */
/*   // "poll the reactor and wait for IO," zero means "truly idle, exit." */
/*   size_t inflight; */
/* } srn_reactor_t; */
 
/* // The backend interface */
/* typedef struct srn_reactor_backend { */
/*   const char *name; */
/*   bool (*init)(srn_reactor_t *); // false => unavailable, try the next */
/*   void (*shutdown)(srn_reactor_t *); */
/*   srn_io_status (*submit)(srn_reactor_t *, srn_io_req *); */
/*   void (*poll)(srn_reactor_t *); */
/* } srn_reactor_backend; */
 
/* [[nodiscard]] [[gnu::nonnull(1)]] srn_reactor_t * */
/* srn_reactor_init(srn_engine_t *engine); */