06_request_term.c File Reference

#include <stdatomic.h>
#include <stdio.h>
#include <serene/runtime.h>

Include dependency graph for 06_request_term.c:

Go to the source code of this file.

Macros
#define	TASK_COUNT   16

Functions
static srn_fiber_result_t	task (srn_context_t *ctx, void *arg)
static srn_fiber_result_t	controller (srn_context_t *ctx, void *arg)
int	main (void)

Variables
static atomic_int	tasks_ran

Macro Definition Documentation

TASK_COUNT

#define TASK_COUNT   16

Definition at line 44 of file 06_request_term.c.

Function Documentation

controller()

srn_fiber_result_t controller ( srn_context_t * ctx, void * arg )

static

Definition at line 55 of file 06_request_term.c.

                                                                    {
  (void)ctx;
  // The scheduler arrives through the argument, so the controller can act on
  // it.
  srn_scheduler_t *sched = arg;
  printf("controller: stopping the scheduler before the tasks run\n");
  srn_sched_stop(sched);
  // Returning normally is the clean boundary the worker stops on.
  return nullptr;
}

Here is the call graph for this function:

Here is the caller graph for this function:

main()

int main

(

void

)

Definition at line 66 of file 06_request_term.c.

               {
  SERENE_RUNTIME_INIT_WITH_SCHED(engine, sched, nullptr);
  srn_context_t *ctx = srn_context_make(engine);
 
  atomic_store(&tasks_ran, 0);
 
  // The controller is created first so it reaches the front of the ready queue
  // first and requests the stop before any task is dequeued.
  (void)srn_fiber_spawn(ctx, controller, sched);
  for (int i = 0; i < TASK_COUNT; i++) {
    (void)srn_fiber_spawn(ctx, task, nullptr);
  }
 
  // One worker keeps the order deterministic: the controller runs, stops the
  // scheduler, and the worker exits at the top of its next loop with the tasks
  // still queued.
  srn_sched_run(sched, 1);
 
  int ran = atomic_load(&tasks_ran);
  printf("%d of %d tasks ran before termination\n", ran, TASK_COUNT);
  printf("the rest were left queued and are reclaimed at shutdown\n");
 
  // Teardown order matters once a run stops with work still queued. The unrun
  // tasks are still on the scheduler's registry, yet their fiber structs live
  // in this context's blocks, so the context must not be released while they
  // are unreaped. SERENE_RUNTIME_SHUTDOWN reaps the scheduler first and the
  // memory manager then reclaims every context chain, this one included.
  SERENE_RUNTIME_SHUTDOWN(engine);
  return 0;
}

Here is the call graph for this function:

task()

srn_fiber_result_t task ( srn_context_t * ctx, void * arg )

static

Definition at line 48 of file 06_request_term.c.

                                                              {
  (void)ctx;
  (void)arg;
  atomic_fetch_add(&tasks_ran, 1);
  return nullptr;
}

Here is the caller graph for this function:

Variable Documentation

tasks_ran

atomic_int tasks_ran

static

Definition at line 46 of file 06_request_term.c.