source: mainline/uspace/lib/c/include/fibril.h@ 514d561

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 514d561 was 514d561, checked in by Jiří Zárevúcky <jiri.zarevucky@…>, 7 years ago

Fibril/async implementation overhaul.

This commit marks the move towards treating the fibril library as a mere
implementation of a generic threading interface. Understood as a layer that
wraps the kernel threads, we not only have to wrap threading itself, but also
every syscall that blocks the kernel thread (by blocking, we mean thread not
doing useful work until an external event happens — e.g. locking a kernel
mutex or thread sleep is understood as blocking, but an as_area_create() is not,
despite potentially taking a long time to complete).

Consequently, we implement fibril_ipc_wait() as a fibril-native wrapper for
kernel's ipc_wait(), and also implement timer functionality like timeouts
as part of the fibril library. This removes the interdependency between fibril
implementation and the async framework — in theory, the fibril API could be
reimplemented as a simple 1:1 shim, and the async framework would continue
working normally (note that the current implementation of loader complicates
this).

To better isolate the fibril internals from the implementation of high-level
synchronization, a fibril_event_t is added. This object conceptually acts
like a single slot wait queue. All other synchronization is implemented in
terms of this primitive.
  • Property mode set to 100644
File size: 2.9 KB
Line 
1/*
2 * Copyright (c) 2006 Ondrej Palkovsky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef LIBC_FIBRIL_H_
36#define LIBC_FIBRIL_H_
37
38#include <types/common.h>
39#include <time.h>
40#include <_bits/__noreturn.h>
41#include <ipc/common.h>
42
43typedef struct fibril fibril_t;
44
45typedef struct {
46 fibril_t *owned_by;
47} fibril_owner_info_t;
48
49typedef fibril_t *fid_t;
50
51typedef struct {
52 fibril_t *fibril;
53} fibril_event_t;
54
55#define FIBRIL_EVENT_INIT ((fibril_event_t) {0})
56
57/** Fibril-local variable specifier */
58#define fibril_local __thread
59
60#define FIBRIL_DFLT_STK_SIZE 0
61
62extern fid_t fibril_create_generic(errno_t (*)(void *), void *, size_t);
63extern void fibril_destroy(fid_t);
64extern void fibril_add_ready(fid_t);
65extern fid_t fibril_get_id(void);
66extern void fibril_yield(void);
67
68extern void fibril_usleep(suseconds_t);
69extern void fibril_sleep(unsigned int);
70
71extern void fibril_enable_multithreaded(void);
72extern int fibril_test_spawn_runners(int);
73
74extern void fibril_detach(fid_t fid);
75
76static inline fid_t fibril_create(errno_t (*func)(void *), void *arg)
77{
78 return fibril_create_generic(func, arg, FIBRIL_DFLT_STK_SIZE);
79}
80
81extern void fibril_start(fid_t);
82extern __noreturn void fibril_exit(long);
83
84extern void fibril_wait_for(fibril_event_t *);
85extern errno_t fibril_wait_timeout(fibril_event_t *, const struct timeval *);
86extern void fibril_notify(fibril_event_t *);
87
88extern errno_t fibril_ipc_wait(ipc_call_t *, const struct timeval *);
89extern void fibril_ipc_poke(void);
90
91#endif
92
93/** @}
94 */
Note: See TracBrowser for help on using the repository browser.