futex.h 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * Glibc independent futex library for testing kernel functionality.
  4. * Shamelessly stolen from Darren Hart <dvhltc@us.ibm.com>
  5. * http://git.kernel.org/cgit/linux/kernel/git/dvhart/futextest.git/
  6. */
  7. #ifndef _FUTEX_H
  8. #define _FUTEX_H
  9. #include <unistd.h>
  10. #include <sys/syscall.h>
  11. #include <sys/types.h>
  12. #include <linux/futex.h>
  13. /**
  14. * futex() - SYS_futex syscall wrapper
  15. * @uaddr: address of first futex
  16. * @op: futex op code
  17. * @val: typically expected value of uaddr, but varies by op
  18. * @timeout: typically an absolute struct timespec (except where noted
  19. * otherwise). Overloaded by some ops
  20. * @uaddr2: address of second futex for some ops\
  21. * @val3: varies by op
  22. * @opflags: flags to be bitwise OR'd with op, such as FUTEX_PRIVATE_FLAG
  23. *
  24. * futex() is used by all the following futex op wrappers. It can also be
  25. * used for misuse and abuse testing. Generally, the specific op wrappers
  26. * should be used instead. It is a macro instead of an static inline function as
  27. * some of the types over overloaded (timeout is used for nr_requeue for
  28. * example).
  29. *
  30. * These argument descriptions are the defaults for all
  31. * like-named arguments in the following wrappers except where noted below.
  32. */
  33. #define futex(uaddr, op, val, timeout, uaddr2, val3, opflags) \
  34. syscall(SYS_futex, uaddr, op | opflags, val, timeout, uaddr2, val3)
  35. /**
  36. * futex_wait() - block on uaddr with optional timeout
  37. * @timeout: relative timeout
  38. */
  39. static inline int
  40. futex_wait(u_int32_t *uaddr, u_int32_t val, struct timespec *timeout, int opflags)
  41. {
  42. return futex(uaddr, FUTEX_WAIT, val, timeout, NULL, 0, opflags);
  43. }
  44. /**
  45. * futex_wake() - wake one or more tasks blocked on uaddr
  46. * @nr_wake: wake up to this many tasks
  47. */
  48. static inline int
  49. futex_wake(u_int32_t *uaddr, int nr_wake, int opflags)
  50. {
  51. return futex(uaddr, FUTEX_WAKE, nr_wake, NULL, NULL, 0, opflags);
  52. }
  53. /**
  54. * futex_lock_pi() - block on uaddr as a PI mutex
  55. */
  56. static inline int
  57. futex_lock_pi(u_int32_t *uaddr, struct timespec *timeout, int opflags)
  58. {
  59. return futex(uaddr, FUTEX_LOCK_PI, 0, timeout, NULL, 0, opflags);
  60. }
  61. /**
  62. * futex_unlock_pi() - release uaddr as a PI mutex, waking the top waiter
  63. */
  64. static inline int
  65. futex_unlock_pi(u_int32_t *uaddr, int opflags)
  66. {
  67. return futex(uaddr, FUTEX_UNLOCK_PI, 0, NULL, NULL, 0, opflags);
  68. }
  69. /**
  70. * futex_cmp_requeue() - requeue tasks from uaddr to uaddr2
  71. * @nr_wake: wake up to this many tasks
  72. * @nr_requeue: requeue up to this many tasks
  73. */
  74. static inline int
  75. futex_cmp_requeue(u_int32_t *uaddr, u_int32_t val, u_int32_t *uaddr2, int nr_wake,
  76. int nr_requeue, int opflags)
  77. {
  78. return futex(uaddr, FUTEX_CMP_REQUEUE, nr_wake, nr_requeue, uaddr2,
  79. val, opflags);
  80. }
  81. #ifndef HAVE_PTHREAD_ATTR_SETAFFINITY_NP
  82. #include <pthread.h>
  83. #include <linux/compiler.h>
  84. static inline int pthread_attr_setaffinity_np(pthread_attr_t *attr __maybe_unused,
  85. size_t cpusetsize __maybe_unused,
  86. cpu_set_t *cpuset __maybe_unused)
  87. {
  88. return 0;
  89. }
  90. #endif
  91. #endif /* _FUTEX_H */