xref: /linux-6.15/include/linux/async.h (revision 6ed7ffdd)
1 /*
2  * async.h: Asynchronous function calls for boot performance
3  *
4  * (C) Copyright 2009 Intel Corporation
5  * Author: Arjan van de Ven <[email protected]>
6  *
7  * This program is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License
9  * as published by the Free Software Foundation; version 2
10  * of the License.
11  */
12 #ifndef __ASYNC_H__
13 #define __ASYNC_H__
14 
15 #include <linux/types.h>
16 #include <linux/list.h>
17 
18 typedef u64 async_cookie_t;
19 typedef void (async_func_ptr) (void *data, async_cookie_t cookie);
20 struct async_domain {
21 	struct list_head node;
22 	struct list_head pending;
23 	unsigned registered:1;
24 };
25 
26 /*
27  * domain participates in global async_synchronize_full
28  */
29 #define ASYNC_DOMAIN(_name) \
30 	struct async_domain _name = { .node = LIST_HEAD_INIT(_name.node), \
31 				      .pending = LIST_HEAD_INIT(_name.pending), \
32 				      .registered = 1 }
33 
34 /*
35  * domain is free to go out of scope as soon as all pending work is
36  * complete, this domain does not participate in async_synchronize_full
37  */
38 #define ASYNC_DOMAIN_EXCLUSIVE(_name) \
39 	struct async_domain _name = { .node = LIST_HEAD_INIT(_name.node), \
40 				      .pending = LIST_HEAD_INIT(_name.pending), \
41 				      .registered = 0 }
42 
43 extern async_cookie_t async_schedule(async_func_ptr *ptr, void *data);
44 extern async_cookie_t async_schedule_domain(async_func_ptr *ptr, void *data,
45 					    struct async_domain *domain);
46 void async_unregister_domain(struct async_domain *domain);
47 extern void async_synchronize_full(void);
48 extern void async_synchronize_full_domain(struct async_domain *domain);
49 extern void async_synchronize_cookie(async_cookie_t cookie);
50 extern void async_synchronize_cookie_domain(async_cookie_t cookie,
51 					    struct async_domain *domain);
52 extern bool current_is_async(void);
53 #endif
54