[deliverable/linux.git] / include / linux / eventpoll.h

/*
 *  include/linux/eventpoll.h ( Efficent event polling implementation )
 *  Copyright (C) 2001,...,2006	 Davide Libenzi
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  Davide Libenzi <davidel@xmailserver.org>
 *
 */

#ifndef _LINUX_EVENTPOLL_H
#define _LINUX_EVENTPOLL_H

/* For O_CLOEXEC */
#include <linux/fcntl.h>
#include <linux/types.h>

/* Flags for epoll_create1.  */
#define EPOLL_CLOEXEC O_CLOEXEC

/* Valid opcodes to issue to sys_epoll_ctl() */
#define EPOLL_CTL_ADD 1
#define EPOLL_CTL_DEL 2
#define EPOLL_CTL_MOD 3

/* Set the One Shot behaviour for the target file descriptor */
#define EPOLLONESHOT (1 << 30)

/* Set the Edge Triggered behaviour for the target file descriptor */
#define EPOLLET (1 << 31)

/* 
 * On x86-64 make the 64bit structure have the same alignment as the
 * 32bit structure. This makes 32bit emulation easier.
 *
 * UML/x86_64 needs the same packing as x86_64
 */
#ifdef __x86_64__
#define EPOLL_PACKED __attribute__((packed))
#else
#define EPOLL_PACKED
#endif

struct epoll_event {
	__u32 events;
	__u64 data;
} EPOLL_PACKED;

#ifdef __KERNEL__

/* Forward declarations to avoid compiler errors */
struct file;


#ifdef CONFIG_EPOLL

/* Used to initialize the epoll bits inside the "struct file" */
static inline void eventpoll_init_file(struct file *file)
{
	INIT_LIST_HEAD(&file->f_ep_links);
	spin_lock_init(&file->f_ep_lock);
}


/* Used to release the epoll bits inside the "struct file" */
void eventpoll_release_file(struct file *file);

/*
 * This is called from inside fs/file_table.c:__fput() to unlink files
 * from the eventpoll interface. We need to have this facility to cleanup
 * correctly files that are closed without being removed from the eventpoll
 * interface.
 */
static inline void eventpoll_release(struct file *file)
{

	/*
	 * Fast check to avoid the get/release of the semaphore. Since
	 * we're doing this outside the semaphore lock, it might return
	 * false negatives, but we don't care. It'll help in 99.99% of cases
	 * to avoid the semaphore lock. False positives simply cannot happen
	 * because the file in on the way to be removed and nobody ( but
	 * eventpoll ) has still a reference to this file.
	 */
	if (likely(list_empty(&file->f_ep_links)))
		return;

	/*
	 * The file is being closed while it is still linked to an epoll
	 * descriptor. We need to handle this by correctly unlinking it
	 * from its containers.
	 */
	eventpoll_release_file(file);
}

#else

static inline void eventpoll_init_file(struct file *file) {}
static inline void eventpoll_release(struct file *file) {}

#endif

#endif /* #ifdef __KERNEL__ */

#endif /* #ifndef _LINUX_EVENTPOLL_H */
Commit	Line	Data
1da177e4 LT	1	/*
1da177e4 LT	2	* include/linux/eventpoll.h ( Efficent event polling implementation )
3419b23a	3	* Copyright (C) 2001,...,2006 Davide Libenzi
1da177e4 LT	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
	14	#ifndef _LINUX_EVENTPOLL_H
	15	#define _LINUX_EVENTPOLL_H
	16
a0998b50 UD	17	/* For O_CLOEXEC */
a0998b50 UD	18	#include <linux/fcntl.h>
1da177e4 LT	19	#include <linux/types.h>
1da177e4 LT	20
9fe5ad9c	21	/* Flags for epoll_create1. */
a0998b50	22	#define EPOLL_CLOEXEC O_CLOEXEC
1da177e4 LT	23
	24	/* Valid opcodes to issue to sys_epoll_ctl() */
	25	#define EPOLL_CTL_ADD 1
	26	#define EPOLL_CTL_DEL 2
	27	#define EPOLL_CTL_MOD 3
	28
	29	/* Set the One Shot behaviour for the target file descriptor */
	30	#define EPOLLONESHOT (1 << 30)
	31
	32	/* Set the Edge Triggered behaviour for the target file descriptor */
	33	#define EPOLLET (1 << 31)
	34
	35	/*
	36	* On x86-64 make the 64bit structure have the same alignment as the
	37	* 32bit structure. This makes 32bit emulation easier.
d75e26a8	38	*
ca5cd877	39	* UML/x86_64 needs the same packing as x86_64
1da177e4 LT	40	*/
	41	#ifdef __x86_64__
	42	#define EPOLL_PACKED __attribute__((packed))
	43	#else
	44	#define EPOLL_PACKED
	45	#endif
	46
	47	struct epoll_event {
	48	__u32 events;
	49	__u64 data;
	50	} EPOLL_PACKED;
	51
	52	#ifdef __KERNEL__
	53
	54	/* Forward declarations to avoid compiler errors */
	55	struct file;
	56
	57
	58	#ifdef CONFIG_EPOLL
	59
	60	/* Used to initialize the epoll bits inside the "struct file" */
5a6b7951 BL	61	static inline void eventpoll_init_file(struct file *file)
	62	{
	63	INIT_LIST_HEAD(&file->f_ep_links);
	64	spin_lock_init(&file->f_ep_lock);
	65	}
	66
1da177e4 LT	67
	68	/* Used to release the epoll bits inside the "struct file" */
	69	void eventpoll_release_file(struct file *file);
	70
	71	/*
	72	* This is called from inside fs/file_table.c:__fput() to unlink files
	73	* from the eventpoll interface. We need to have this facility to cleanup
	74	* correctly files that are closed without being removed from the eventpoll
	75	* interface.
	76	*/
	77	static inline void eventpoll_release(struct file *file)
	78	{
	79
	80	/*
	81	* Fast check to avoid the get/release of the semaphore. Since
	82	* we're doing this outside the semaphore lock, it might return
	83	* false negatives, but we don't care. It'll help in 99.99% of cases
	84	* to avoid the semaphore lock. False positives simply cannot happen
	85	* because the file in on the way to be removed and nobody ( but
	86	* eventpoll ) has still a reference to this file.
	87	*/
	88	if (likely(list_empty(&file->f_ep_links)))
	89	return;
	90
	91	/*
	92	* The file is being closed while it is still linked to an epoll
	93	* descriptor. We need to handle this by correctly unlinking it
	94	* from its containers.
	95	*/
	96	eventpoll_release_file(file);
	97	}
	98
1da177e4 LT	99	#else
	100
	101	static inline void eventpoll_init_file(struct file *file) {}
	102	static inline void eventpoll_release(struct file *file) {}
	103
	104	#endif
	105
	106	#endif /* #ifdef __KERNEL__ */
	107
	108	#endif /* #ifndef _LINUX_EVENTPOLL_H */
	109