mirrors/bird
mirrors/bird
0
0
Fork 0
mirror of https://gitlab.nic.cz/labs/bird.git synced 2024-12-22 17:51:53 +00:00
Code Releases Activity
ab0994a10c
bird/lib/coro.h

32 lines
818 B
C
Raw Normal View History

Coroutines: A simple and lightweight parallel execution framework.
2021-02-08 08:51:59 +00:00
/*
* BIRD Coroutines
*
* (c) 2017 Martin Mares <mj@ucw.cz>
Converting the former BFD loop to a universal IO loop and protocol loop. There is a simple universal IO loop, taking care of events, timers and sockets. Primarily, one instance of a protocol should use exactly one IO loop to do all its work, as is now done in BFD. Contrary to previous versions, the loop is now launched and cleaned by the nest/proto.c code, allowing for a protocol to just request its own loop by setting the loop's lock order in config higher than the_bird. It is not supported nor checked if any protocol changed the requested lock order in reconfigure. No protocol should do it at all.
2021-06-19 18:50:18 +00:00
* (c) 2020-2021 Maria Matejka <mq@jmq.cz>
Coroutines: A simple and lightweight parallel execution framework.
2021-02-08 08:51:59 +00:00
*
* Can be freely distributed and used under the terms of the GNU GPL.
*/
#ifndef _BIRD_CORO_H_
#define _BIRD_CORO_H_
#include "lib/resource.h"
/* A completely opaque coroutine handle. */
struct coroutine;
/* Coroutines are independent threads bound to pools.
* You request a coroutine by calling coro_run().
* It is forbidden to free a running coroutine from outside.
* The running coroutine must free itself by rfree() before returning.
*/
struct coroutine *coro_run(pool *, void (*entry)(void *), void *data);
Converting the former BFD loop to a universal IO loop and protocol loop. There is a simple universal IO loop, taking care of events, timers and sockets. Primarily, one instance of a protocol should use exactly one IO loop to do all its work, as is now done in BFD. Contrary to previous versions, the loop is now launched and cleaned by the nest/proto.c code, allowing for a protocol to just request its own loop by setting the loop's lock order in config higher than the_bird. It is not supported nor checked if any protocol changed the requested lock order in reconfigure. No protocol should do it at all.
2021-06-19 18:50:18 +00:00
/* Get self. */
extern _Thread_local struct coroutine *this_coro;
Introducing basic RCU primitives for lock-less shared data structures
2021-11-12 21:58:40 +00:00
/* Just wait for a little while. Not intended for general use; use events if possible. */
void coro_yield(void);
Coroutines: A simple and lightweight parallel execution framework.
2021-02-08 08:51:59 +00:00
#endif
Copy Permalink