source: mainline/uspace/lib/c/include/fibril.h@ 615e83d

Last change on this file since 615e83d was e0a4686, checked in by Jiří Zárevúcky <zarevucky.jiri@…>, 7 years ago

Introduce context_swap() and use it to simplify fibril implementation.

This wraps the use of context_save()/context_restore(), to provide a more
natural (and easier to understand) control flow. The patch also hides the
details of the underlying context, requiring the use of context_get_pc()
to acquire program counter. This might allow context_swap() to only store
one pointer in the context, storing the remaining information in its stack
frame. However, that is not done in this patch.

  • 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 <context.h>
39#include <types/common.h>
40#include <adt/list.h>
41#include <libarch/tls.h>
42
43#define FIBRIL_WRITER 1
44
45struct fibril;
46
47typedef struct {
48 struct fibril *owned_by;
49} fibril_owner_info_t;
50
51typedef enum {
52 FIBRIL_PREEMPT,
53 FIBRIL_TO_MANAGER,
54 FIBRIL_FROM_MANAGER,
55 FIBRIL_FROM_DEAD
56} fibril_switch_type_t;
57
58typedef sysarg_t fid_t;
59
60typedef struct fibril {
61 link_t link;
62 link_t all_link;
63 context_t ctx;
64 void *stack;
65 void *arg;
66 errno_t (*func)(void *);
67 tcb_t *tcb;
68
69 struct fibril *clean_after_me;
70 errno_t retval;
71 int flags;
72
73 fibril_owner_info_t *waits_for;
74
75 unsigned int switches;
76} fibril_t;
77
78/** Fibril-local variable specifier */
79#define fibril_local __thread
80
81#define FIBRIL_DFLT_STK_SIZE 0
82
83extern fid_t fibril_create_generic(errno_t (*func)(void *), void *arg, size_t);
84extern void fibril_destroy(fid_t fid);
85extern fibril_t *fibril_setup(void);
86extern void fibril_teardown(fibril_t *f, bool locked);
87extern int fibril_switch(fibril_switch_type_t stype);
88extern void fibril_add_ready(fid_t fid);
89extern void fibril_add_manager(fid_t fid);
90extern void fibril_remove_manager(void);
91extern fid_t fibril_get_id(void);
92
93static inline fid_t fibril_create(errno_t (*func)(void *), void *arg)
94{
95 return fibril_create_generic(func, arg, FIBRIL_DFLT_STK_SIZE);
96}
97
98static inline int fibril_yield(void)
99{
100 return fibril_switch(FIBRIL_PREEMPT);
101}
102
103#endif
104
105/** @}
106 */
Note: See TracBrowser for help on using the repository browser.