4 * Copyright (C) 2007 Davide Libenzi <davidel@xmailserver.org>
8 #include <linux/file.h>
9 #include <linux/poll.h>
10 #include <linux/init.h>
12 #include <linux/sched.h>
13 #include <linux/kernel.h>
14 #include <linux/slab.h>
15 #include <linux/list.h>
16 #include <linux/spinlock.h>
17 #include <linux/anon_inodes.h>
18 #include <linux/syscalls.h>
19 #include <linux/export.h>
20 #include <linux/kref.h>
21 #include <linux/eventfd.h>
25 wait_queue_head_t wqh
;
27 * Every time that a write(2) is performed on an eventfd, the
28 * value of the __u64 being written is added to "count" and a
29 * wakeup is performed on "wqh". A read(2) will return the "count"
30 * value to userspace, and will reset "count" to zero. The kernel
31 * side eventfd_signal() also, adds to the "count" counter and
39 * eventfd_signal - Adds @n to the eventfd counter.
40 * @ctx: [in] Pointer to the eventfd context.
41 * @n: [in] Value of the counter to be added to the eventfd internal counter.
42 * The value cannot be negative.
44 * This function is supposed to be called by the kernel in paths that do not
45 * allow sleeping. In this function we allow the counter to reach the ULLONG_MAX
46 * value, and we signal this as overflow condition by returining a POLLERR
49 * Returns the amount by which the counter was incrememnted. This will be less
50 * than @n if the counter has overflowed.
52 __u64
eventfd_signal(struct eventfd_ctx
*ctx
, __u64 n
)
56 spin_lock_irqsave(&ctx
->wqh
.lock
, flags
);
57 if (ULLONG_MAX
- ctx
->count
< n
)
58 n
= ULLONG_MAX
- ctx
->count
;
60 if (waitqueue_active(&ctx
->wqh
))
61 wake_up_locked_poll(&ctx
->wqh
, POLLIN
);
62 spin_unlock_irqrestore(&ctx
->wqh
.lock
, flags
);
66 EXPORT_SYMBOL_GPL(eventfd_signal
);
68 static void eventfd_free_ctx(struct eventfd_ctx
*ctx
)
73 static void eventfd_free(struct kref
*kref
)
75 struct eventfd_ctx
*ctx
= container_of(kref
, struct eventfd_ctx
, kref
);
77 eventfd_free_ctx(ctx
);
81 * eventfd_ctx_get - Acquires a reference to the internal eventfd context.
82 * @ctx: [in] Pointer to the eventfd context.
84 * Returns: In case of success, returns a pointer to the eventfd context.
86 struct eventfd_ctx
*eventfd_ctx_get(struct eventfd_ctx
*ctx
)
91 EXPORT_SYMBOL_GPL(eventfd_ctx_get
);
94 * eventfd_ctx_put - Releases a reference to the internal eventfd context.
95 * @ctx: [in] Pointer to eventfd context.
97 * The eventfd context reference must have been previously acquired either
98 * with eventfd_ctx_get() or eventfd_ctx_fdget().
100 void eventfd_ctx_put(struct eventfd_ctx
*ctx
)
102 kref_put(&ctx
->kref
, eventfd_free
);
104 EXPORT_SYMBOL_GPL(eventfd_ctx_put
);
106 static int eventfd_release(struct inode
*inode
, struct file
*file
)
108 struct eventfd_ctx
*ctx
= file
->private_data
;
110 wake_up_poll(&ctx
->wqh
, POLLHUP
);
111 eventfd_ctx_put(ctx
);
115 static unsigned int eventfd_poll(struct file
*file
, poll_table
*wait
)
117 struct eventfd_ctx
*ctx
= file
->private_data
;
118 unsigned int events
= 0;
121 poll_wait(file
, &ctx
->wqh
, wait
);
123 spin_lock_irqsave(&ctx
->wqh
.lock
, flags
);
126 if (ctx
->count
== ULLONG_MAX
)
128 if (ULLONG_MAX
- 1 > ctx
->count
)
130 spin_unlock_irqrestore(&ctx
->wqh
.lock
, flags
);
135 static void eventfd_ctx_do_read(struct eventfd_ctx
*ctx
, __u64
*cnt
)
137 *cnt
= (ctx
->flags
& EFD_SEMAPHORE
) ? 1 : ctx
->count
;
142 * eventfd_ctx_remove_wait_queue - Read the current counter and removes wait queue.
143 * @ctx: [in] Pointer to eventfd context.
144 * @wait: [in] Wait queue to be removed.
145 * @cnt: [out] Pointer to the 64-bit counter value.
147 * Returns %0 if successful, or the following error codes:
149 * -EAGAIN : The operation would have blocked.
151 * This is used to atomically remove a wait queue entry from the eventfd wait
152 * queue head, and read/reset the counter value.
154 int eventfd_ctx_remove_wait_queue(struct eventfd_ctx
*ctx
, wait_queue_t
*wait
,
159 spin_lock_irqsave(&ctx
->wqh
.lock
, flags
);
160 eventfd_ctx_do_read(ctx
, cnt
);
161 __remove_wait_queue(&ctx
->wqh
, wait
);
162 if (*cnt
!= 0 && waitqueue_active(&ctx
->wqh
))
163 wake_up_locked_poll(&ctx
->wqh
, POLLOUT
);
164 spin_unlock_irqrestore(&ctx
->wqh
.lock
, flags
);
166 return *cnt
!= 0 ? 0 : -EAGAIN
;
168 EXPORT_SYMBOL_GPL(eventfd_ctx_remove_wait_queue
);
171 * eventfd_ctx_read - Reads the eventfd counter or wait if it is zero.
172 * @ctx: [in] Pointer to eventfd context.
173 * @no_wait: [in] Different from zero if the operation should not block.
174 * @cnt: [out] Pointer to the 64-bit counter value.
176 * Returns %0 if successful, or the following error codes:
178 * -EAGAIN : The operation would have blocked but @no_wait was non-zero.
179 * -ERESTARTSYS : A signal interrupted the wait operation.
181 * If @no_wait is zero, the function might sleep until the eventfd internal
182 * counter becomes greater than zero.
184 ssize_t
eventfd_ctx_read(struct eventfd_ctx
*ctx
, int no_wait
, __u64
*cnt
)
187 DECLARE_WAITQUEUE(wait
, current
);
189 spin_lock_irq(&ctx
->wqh
.lock
);
195 __add_wait_queue(&ctx
->wqh
, &wait
);
197 set_current_state(TASK_INTERRUPTIBLE
);
198 if (ctx
->count
> 0) {
202 if (signal_pending(current
)) {
206 spin_unlock_irq(&ctx
->wqh
.lock
);
208 spin_lock_irq(&ctx
->wqh
.lock
);
210 __remove_wait_queue(&ctx
->wqh
, &wait
);
211 __set_current_state(TASK_RUNNING
);
213 if (likely(res
== 0)) {
214 eventfd_ctx_do_read(ctx
, cnt
);
215 if (waitqueue_active(&ctx
->wqh
))
216 wake_up_locked_poll(&ctx
->wqh
, POLLOUT
);
218 spin_unlock_irq(&ctx
->wqh
.lock
);
222 EXPORT_SYMBOL_GPL(eventfd_ctx_read
);
224 static ssize_t
eventfd_read(struct file
*file
, char __user
*buf
, size_t count
,
227 struct eventfd_ctx
*ctx
= file
->private_data
;
231 if (count
< sizeof(cnt
))
233 res
= eventfd_ctx_read(ctx
, file
->f_flags
& O_NONBLOCK
, &cnt
);
237 return put_user(cnt
, (__u64 __user
*) buf
) ? -EFAULT
: sizeof(cnt
);
240 static ssize_t
eventfd_write(struct file
*file
, const char __user
*buf
, size_t count
,
243 struct eventfd_ctx
*ctx
= file
->private_data
;
246 DECLARE_WAITQUEUE(wait
, current
);
248 if (count
< sizeof(ucnt
))
250 if (copy_from_user(&ucnt
, buf
, sizeof(ucnt
)))
252 if (ucnt
== ULLONG_MAX
)
254 spin_lock_irq(&ctx
->wqh
.lock
);
256 if (ULLONG_MAX
- ctx
->count
> ucnt
)
258 else if (!(file
->f_flags
& O_NONBLOCK
)) {
259 __add_wait_queue(&ctx
->wqh
, &wait
);
261 set_current_state(TASK_INTERRUPTIBLE
);
262 if (ULLONG_MAX
- ctx
->count
> ucnt
) {
266 if (signal_pending(current
)) {
270 spin_unlock_irq(&ctx
->wqh
.lock
);
272 spin_lock_irq(&ctx
->wqh
.lock
);
274 __remove_wait_queue(&ctx
->wqh
, &wait
);
275 __set_current_state(TASK_RUNNING
);
277 if (likely(res
> 0)) {
279 if (waitqueue_active(&ctx
->wqh
))
280 wake_up_locked_poll(&ctx
->wqh
, POLLIN
);
282 spin_unlock_irq(&ctx
->wqh
.lock
);
287 static const struct file_operations eventfd_fops
= {
288 .release
= eventfd_release
,
289 .poll
= eventfd_poll
,
290 .read
= eventfd_read
,
291 .write
= eventfd_write
,
292 .llseek
= noop_llseek
,
296 * eventfd_fget - Acquire a reference of an eventfd file descriptor.
297 * @fd: [in] Eventfd file descriptor.
299 * Returns a pointer to the eventfd file structure in case of success, or the
300 * following error pointer:
302 * -EBADF : Invalid @fd file descriptor.
303 * -EINVAL : The @fd file descriptor is not an eventfd file.
305 struct file
*eventfd_fget(int fd
)
311 return ERR_PTR(-EBADF
);
312 if (file
->f_op
!= &eventfd_fops
) {
314 return ERR_PTR(-EINVAL
);
319 EXPORT_SYMBOL_GPL(eventfd_fget
);
322 * eventfd_ctx_fdget - Acquires a reference to the internal eventfd context.
323 * @fd: [in] Eventfd file descriptor.
325 * Returns a pointer to the internal eventfd context, otherwise the error
326 * pointers returned by the following functions:
330 struct eventfd_ctx
*eventfd_ctx_fdget(int fd
)
333 struct eventfd_ctx
*ctx
;
335 file
= eventfd_fget(fd
);
337 return (struct eventfd_ctx
*) file
;
338 ctx
= eventfd_ctx_get(file
->private_data
);
343 EXPORT_SYMBOL_GPL(eventfd_ctx_fdget
);
346 * eventfd_ctx_fileget - Acquires a reference to the internal eventfd context.
347 * @file: [in] Eventfd file pointer.
349 * Returns a pointer to the internal eventfd context, otherwise the error
352 * -EINVAL : The @fd file descriptor is not an eventfd file.
354 struct eventfd_ctx
*eventfd_ctx_fileget(struct file
*file
)
356 if (file
->f_op
!= &eventfd_fops
)
357 return ERR_PTR(-EINVAL
);
359 return eventfd_ctx_get(file
->private_data
);
361 EXPORT_SYMBOL_GPL(eventfd_ctx_fileget
);
364 * eventfd_file_create - Creates an eventfd file pointer.
365 * @count: Initial eventfd counter value.
366 * @flags: Flags for the eventfd file.
368 * This function creates an eventfd file pointer, w/out installing it into
369 * the fd table. This is useful when the eventfd file is used during the
370 * initialization of data structures that require extra setup after the eventfd
371 * creation. So the eventfd creation is split into the file pointer creation
372 * phase, and the file descriptor installation phase.
373 * In this way races with userspace closing the newly installed file descriptor
375 * Returns an eventfd file pointer, or a proper error pointer.
377 struct file
*eventfd_file_create(unsigned int count
, int flags
)
380 struct eventfd_ctx
*ctx
;
382 /* Check the EFD_* constants for consistency. */
383 BUILD_BUG_ON(EFD_CLOEXEC
!= O_CLOEXEC
);
384 BUILD_BUG_ON(EFD_NONBLOCK
!= O_NONBLOCK
);
386 if (flags
& ~EFD_FLAGS_SET
)
387 return ERR_PTR(-EINVAL
);
389 ctx
= kmalloc(sizeof(*ctx
), GFP_KERNEL
);
391 return ERR_PTR(-ENOMEM
);
393 kref_init(&ctx
->kref
);
394 init_waitqueue_head(&ctx
->wqh
);
398 file
= anon_inode_getfile("[eventfd]", &eventfd_fops
, ctx
,
399 O_RDWR
| (flags
& EFD_SHARED_FCNTL_FLAGS
));
401 eventfd_free_ctx(ctx
);
406 SYSCALL_DEFINE2(eventfd2
, unsigned int, count
, int, flags
)
411 error
= get_unused_fd_flags(flags
& EFD_SHARED_FCNTL_FLAGS
);
416 file
= eventfd_file_create(count
, flags
);
418 error
= PTR_ERR(file
);
419 goto err_put_unused_fd
;
421 fd_install(fd
, file
);
431 SYSCALL_DEFINE1(eventfd
, unsigned int, count
)
433 return sys_eventfd2(count
, 0);