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. /*
  25. * Request the handling of system wakeup events so as to prevent system suspends
  26. * from happening while those events are being processed.
  27. *
  28. * Assuming neither EPOLLET nor EPOLLONESHOT is set, system suspends will not be
  29. * re-allowed until epoll_wait is called again after consuming the wakeup
  30. * event(s).
  31. *
  32. * Requires CAP_BLOCK_SUSPEND
  33. */
  34. #define EPOLLWAKEUP (1 << 29)
  35. /* Set the One Shot behaviour for the target file descriptor */
  36. #define EPOLLONESHOT (1 << 30)
  37. /* Set the Edge Triggered behaviour for the target file descriptor */
  38. #define EPOLLET (1 << 31)
  39. /*
  40. * On x86-64 make the 64bit structure have the same alignment as the
  41. * 32bit structure. This makes 32bit emulation easier.
  42. *
  43. * UML/x86_64 needs the same packing as x86_64
  44. */
  45. #ifdef __x86_64__
  46. #define EPOLL_PACKED __attribute__((packed))
  47. #else
  48. #define EPOLL_PACKED
  49. #endif
  50. struct epoll_event {
  51. __u32 events;
  52. __u64 data;
  53. } EPOLL_PACKED;
  54. #ifdef __KERNEL__
  55. /* Forward declarations to avoid compiler errors */
  56. struct file;
  57. #ifdef CONFIG_EPOLL
  58. /* Used to initialize the epoll bits inside the "struct file" */
  59. static inline void eventpoll_init_file(struct file *file)
  60. {
  61. INIT_LIST_HEAD(&file->f_ep_links);
  62. INIT_LIST_HEAD(&file->f_tfile_llink);
  63. }
  64. /* Used to release the epoll bits inside the "struct file" */
  65. void eventpoll_release_file(struct file *file);
  66. /*
  67. * This is called from inside fs/file_table.c:__fput() to unlink files
  68. * from the eventpoll interface. We need to have this facility to cleanup
  69. * correctly files that are closed without being removed from the eventpoll
  70. * interface.
  71. */
  72. static inline void eventpoll_release(struct file *file)
  73. {
  74. /*
  75. * Fast check to avoid the get/release of the semaphore. Since
  76. * we're doing this outside the semaphore lock, it might return
  77. * false negatives, but we don't care. It'll help in 99.99% of cases
  78. * to avoid the semaphore lock. False positives simply cannot happen
  79. * because the file in on the way to be removed and nobody ( but
  80. * eventpoll ) has still a reference to this file.
  81. */
  82. if (likely(list_empty(&file->f_ep_links)))
  83. return;
  84. /*
  85. * The file is being closed while it is still linked to an epoll
  86. * descriptor. We need to handle this by correctly unlinking it
  87. * from its containers.
  88. */
  89. eventpoll_release_file(file);
  90. }
  91. #else
  92. static inline void eventpoll_init_file(struct file *file) {}
  93. static inline void eventpoll_release(struct file *file) {}
  94. #endif
  95. #endif /* #ifdef __KERNEL__ */
  96. #endif /* #ifndef _LINUX_EVENTPOLL_H */