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