eventpoll.h 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. /*
  2. * include/linux/eventpoll.h ( Efficient event polling implementation )
  3. * Copyright (C) 2001,...,2006 Davide Libenzi
  4. *
  5. * This program is free software; you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License as published by
  7. * the Free Software Foundation; either version 2 of the License, or
  8. * (at your option) any later version.
  9. *
  10. * Davide Libenzi <davidel@xmailserver.org>
  11. *
  12. */
  13. #ifndef _LINUX_EVENTPOLL_H
  14. #define _LINUX_EVENTPOLL_H
  15. /* For O_CLOEXEC */
  16. #include <linux/fcntl.h>
  17. #include <linux/types.h>
  18. /* Flags for epoll_create1. */
  19. #define EPOLL_CLOEXEC O_CLOEXEC
  20. /* Valid opcodes to issue to sys_epoll_ctl() */
  21. #define EPOLL_CTL_ADD 1
  22. #define EPOLL_CTL_DEL 2
  23. #define EPOLL_CTL_MOD 3
  24. #define EPOLL_CTL_DISABLE 4
  25. /*
  26. * Request the handling of system wakeup events so as to prevent system suspends
  27. * from happening while those events are being processed.
  28. *
  29. * Assuming neither EPOLLET nor EPOLLONESHOT is set, system suspends will not be
  30. * re-allowed until epoll_wait is called again after consuming the wakeup
  31. * event(s).
  32. *
  33. * Requires CAP_BLOCK_SUSPEND
  34. */
  35. #define EPOLLWAKEUP (1 << 29)
  36. /* Set the One Shot behaviour for the target file descriptor */
  37. #define EPOLLONESHOT (1 << 30)
  38. /* Set the Edge Triggered behaviour for the target file descriptor */
  39. #define EPOLLET (1 << 31)
  40. /*
  41. * On x86-64 make the 64bit structure have the same alignment as the
  42. * 32bit structure. This makes 32bit emulation easier.
  43. *
  44. * UML/x86_64 needs the same packing as x86_64
  45. */
  46. #ifdef __x86_64__
  47. #define EPOLL_PACKED __attribute__((packed))
  48. #else
  49. #define EPOLL_PACKED
  50. #endif
  51. struct epoll_event {
  52. __u32 events;
  53. __u64 data;
  54. } EPOLL_PACKED;
  55. #ifdef __KERNEL__
  56. /* Forward declarations to avoid compiler errors */
  57. struct file;
  58. #ifdef CONFIG_EPOLL
  59. /* Used to initialize the epoll bits inside the "struct file" */
  60. static inline void eventpoll_init_file(struct file *file)
  61. {
  62. INIT_LIST_HEAD(&file->f_ep_links);
  63. INIT_LIST_HEAD(&file->f_tfile_llink);
  64. }
  65. /* Used to release the epoll bits inside the "struct file" */
  66. void eventpoll_release_file(struct file *file);
  67. /*
  68. * This is called from inside fs/file_table.c:__fput() to unlink files
  69. * from the eventpoll interface. We need to have this facility to cleanup
  70. * correctly files that are closed without being removed from the eventpoll
  71. * interface.
  72. */
  73. static inline void eventpoll_release(struct file *file)
  74. {
  75. /*
  76. * Fast check to avoid the get/release of the semaphore. Since
  77. * we're doing this outside the semaphore lock, it might return
  78. * false negatives, but we don't care. It'll help in 99.99% of cases
  79. * to avoid the semaphore lock. False positives simply cannot happen
  80. * because the file in on the way to be removed and nobody ( but
  81. * eventpoll ) has still a reference to this file.
  82. */
  83. if (likely(list_empty(&file->f_ep_links)))
  84. return;
  85. /*
  86. * The file is being closed while it is still linked to an epoll
  87. * descriptor. We need to handle this by correctly unlinking it
  88. * from its containers.
  89. */
  90. eventpoll_release_file(file);
  91. }
  92. #else
  93. static inline void eventpoll_init_file(struct file *file) {}
  94. static inline void eventpoll_release(struct file *file) {}
  95. #endif
  96. #endif /* #ifdef __KERNEL__ */
  97. #endif /* #ifndef _LINUX_EVENTPOLL_H */