source: mainline/uspace/lib/c/generic/private/async.h@ 05208d9

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 05208d9 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: 3.0 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_PRIVATE_ASYNC_H_
36#define LIBC_PRIVATE_ASYNC_H_
37
38#include <async.h>
39#include <adt/list.h>
40#include <fibril.h>
41#include <fibril_synch.h>
42#include <sys/time.h>
43#include <stdbool.h>
44
45/** Session data */
46struct async_sess {
47 /** List of inactive exchanges */
48 list_t exch_list;
49
50 /** Session interface */
51 iface_t iface;
52
53 /** Exchange management style */
54 exch_mgmt_t mgmt;
55
56 /** Session identification */
57 cap_phone_handle_t phone;
58
59 /** First clone connection argument */
60 iface_t arg1;
61
62 /** Second clone connection argument */
63 sysarg_t arg2;
64
65 /** Third clone connection argument */
66 sysarg_t arg3;
67
68 /** Exchange mutex */
69 fibril_mutex_t mutex;
70
71 /** Number of opened exchanges */
72 atomic_t refcnt;
73
74 /** Mutex for stateful connections */
75 fibril_mutex_t remote_state_mtx;
76
77 /** Data for stateful connections */
78 void *remote_state_data;
79};
80
81/** Exchange data */
82struct async_exch {
83 /** Link into list of inactive exchanges */
84 link_t sess_link;
85
86 /** Link into global list of inactive exchanges */
87 link_t global_link;
88
89 /** Session pointer */
90 async_sess_t *sess;
91
92 /** Exchange identification */
93 cap_phone_handle_t phone;
94};
95
96extern void __async_server_init(void);
97extern void __async_client_init(void);
98extern void __async_ports_init(void);
99
100extern errno_t async_create_port_internal(iface_t, async_port_handler_t,
101 void *, port_id_t *);
102extern async_port_handler_t async_get_port_handler(iface_t, port_id_t, void **);
103
104extern void async_reply_received(ipc_call_t *);
105
106#endif
107
108/** @}
109 */
Note: See TracBrowser for help on using the repository browser.