async.h revision 1.5 1 1.5 riastrad /* $NetBSD: async.h,v 1.5 2021/12/19 11:39:38 riastradh Exp $ */
2 1.4 riastrad
3 1.4 riastrad /*-
4 1.4 riastrad * Copyright (c) 2018 The NetBSD Foundation, Inc.
5 1.4 riastrad * All rights reserved.
6 1.4 riastrad *
7 1.4 riastrad * This code is derived from software contributed to The NetBSD Foundation
8 1.4 riastrad * by Taylor R. Campbell.
9 1.4 riastrad *
10 1.4 riastrad * Redistribution and use in source and binary forms, with or without
11 1.4 riastrad * modification, are permitted provided that the following conditions
12 1.4 riastrad * are met:
13 1.4 riastrad * 1. Redistributions of source code must retain the above copyright
14 1.4 riastrad * notice, this list of conditions and the following disclaimer.
15 1.4 riastrad * 2. Redistributions in binary form must reproduce the above copyright
16 1.4 riastrad * notice, this list of conditions and the following disclaimer in the
17 1.4 riastrad * documentation and/or other materials provided with the distribution.
18 1.4 riastrad *
19 1.4 riastrad * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 1.4 riastrad * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 1.4 riastrad * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 1.4 riastrad * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 1.4 riastrad * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 1.4 riastrad * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 1.4 riastrad * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 1.4 riastrad * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 1.4 riastrad * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 1.4 riastrad * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 1.4 riastrad * POSSIBILITY OF SUCH DAMAGE.
30 1.4 riastrad */
31 1.4 riastrad
32 1.2 riastrad #ifndef _LINUX_ASYNC_H_
33 1.2 riastrad #define _LINUX_ASYNC_H_
34 1.2 riastrad
35 1.4 riastrad typedef unsigned long async_cookie_t;
36 1.3 riastrad
37 1.4 riastrad /*
38 1.4 riastrad * async_schedule(fn, arg)
39 1.4 riastrad *
40 1.4 riastrad * Schedule the kernel to run fn(arg, cookie) at some point to
41 1.4 riastrad * avoid slowing down boot, or call it synchronously if memory is
42 1.4 riastrad * short. Returns a cookie that can be used to wait for the
43 1.4 riastrad * function to have been called.
44 1.4 riastrad */
45 1.4 riastrad static inline async_cookie_t
46 1.4 riastrad async_schedule(void (*fn)(void *, async_cookie_t), void *arg)
47 1.4 riastrad {
48 1.1 riastrad
49 1.4 riastrad (*fn)(arg, 1);
50 1.4 riastrad return 1;
51 1.4 riastrad }
52 1.3 riastrad
53 1.4 riastrad /*
54 1.4 riastrad * async_synchronize_full()
55 1.4 riastrad *
56 1.4 riastrad * Wait for all outstanding asynchronous actions to have completed
57 1.4 riastrad * before returning.
58 1.4 riastrad */
59 1.3 riastrad static inline void
60 1.4 riastrad async_synchronize_full(void)
61 1.3 riastrad {
62 1.3 riastrad }
63 1.3 riastrad
64 1.5 riastrad /*
65 1.5 riastrad * async_synchronize_cookie(cookie)
66 1.5 riastrad *
67 1.5 riastrad * Wait until the function passed to the async_schedule call that
68 1.5 riastrad * returned cookie has completed.
69 1.5 riastrad */
70 1.5 riastrad static inline void
71 1.5 riastrad async_synchronize_cookie(unsigned long cookie)
72 1.5 riastrad {
73 1.5 riastrad }
74 1.5 riastrad
75 1.2 riastrad #endif /* _LINUX_ASYNC_H_ */
76