include/linux/async.h

   1 /*
   2  * async.h: Asynchronous function calls for boot performance
   3  *
   4  * (C) Copyright 2009 Intel Corporation
   5  * Author: Arjan van de Ven <arjan@linux.intel.com>
   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