[thirdparty/glibc.git] / sysdeps / unix / sysv / linux / hppa / sys / epoll.h

/* Copyright (C) 2002-2015 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with the GNU C Library.  If not, see
   <http://www.gnu.org/licenses/>.  */

#ifndef	_SYS_EPOLL_H
#define	_SYS_EPOLL_H	1

#include <stdint.h>
#include <sys/types.h>

/* Get __sigset_t.  */
#include <bits/sigset.h>

#ifndef __sigset_t_defined
# define __sigset_t_defined
typedef __sigset_t sigset_t;
#endif


/* Flags to be passed to epoll_create1.  */
enum
  {
    EPOLL_CLOEXEC = 010000000
#define EPOLL_CLOEXEC EPOLL_CLOEXEC
  };


enum EPOLL_EVENTS
  {
    EPOLLIN = 0x001,
#define EPOLLIN EPOLLIN
    EPOLLPRI = 0x002,
#define EPOLLPRI EPOLLPRI
    EPOLLOUT = 0x004,
#define EPOLLOUT EPOLLOUT
    EPOLLRDNORM = 0x040,
#define EPOLLRDNORM EPOLLRDNORM
    EPOLLRDBAND = 0x080,
#define EPOLLRDBAND EPOLLRDBAND
    EPOLLWRNORM = 0x100,
#define EPOLLWRNORM EPOLLWRNORM
    EPOLLWRBAND = 0x200,
#define EPOLLWRBAND EPOLLWRBAND
    EPOLLMSG = 0x400,
#define EPOLLMSG EPOLLMSG
    EPOLLERR = 0x008,
#define EPOLLERR EPOLLERR
    EPOLLHUP = 0x010,
#define EPOLLHUP EPOLLHUP
    EPOLLRDHUP = 0x2000,
#define EPOLLRDHUP EPOLLRDHUP
    EPOLLWAKEUP = 1u << 29,
#define EPOLLWAKEUP EPOLLWAKEUP
    EPOLLONESHOT = 1u << 30,
#define EPOLLONESHOT EPOLLONESHOT
    EPOLLET = 1u << 31
#define EPOLLET EPOLLET
  };


/* Valid opcodes ( "op" parameter ) to issue to epoll_ctl().  */
#define EPOLL_CTL_ADD 1	/* Add a file descriptor to the interface.  */
#define EPOLL_CTL_DEL 2	/* Remove a file descriptor from the interface.  */
#define EPOLL_CTL_MOD 3	/* Change file descriptor epoll_event structure.  */


typedef union epoll_data
{
  void *ptr;
  int fd;
  uint32_t u32;
  uint64_t u64;
} epoll_data_t;

struct epoll_event
{
  uint32_t events;	/* Epoll events */
  epoll_data_t data;	/* User data variable */
};


__BEGIN_DECLS

/* Creates an epoll instance.  Returns an fd for the new instance.
   The "size" parameter is a hint specifying the number of file
   descriptors to be associated with the new instance.  The fd
   returned by epoll_create() should be closed with close().  */
extern int epoll_create (int __size) __THROW;

/* Same as epoll_create but with an FLAGS parameter.  The unused SIZE
   parameter has been dropped.  */
extern int epoll_create1 (int __flags) __THROW;


/* Manipulate an epoll instance "epfd". Returns 0 in case of success,
   -1 in case of error ( the "errno" variable will contain the
   specific error code ) The "op" parameter is one of the EPOLL_CTL_*
   constants defined above. The "fd" parameter is the target of the
   operation. The "event" parameter describes which events the caller
   is interested in and any associated user data.  */
extern int epoll_ctl (int __epfd, int __op, int __fd,
		      struct epoll_event *__event) __THROW;


/* Wait for events on an epoll instance "epfd". Returns the number of
   triggered events returned in "events" buffer. Or -1 in case of
   error with the "errno" variable set to the specific error code. The
   "events" parameter is a buffer that will contain triggered
   events. The "maxevents" is the maximum number of events to be
   returned ( usually size of "events" ). The "timeout" parameter
   specifies the maximum wait time in milliseconds (-1 == infinite).

   This function is a cancellation point and therefore not marked with
   __THROW.  */
extern int epoll_wait (int __epfd, struct epoll_event *__events,
		       int __maxevents, int __timeout);


/* Same as epoll_wait, but the thread's signal mask is temporarily
   and atomically replaced with the one provided as parameter.

   This function is a cancellation point and therefore not marked with
   __THROW.  */
extern int epoll_pwait (int __epfd, struct epoll_event *__events,
			int __maxevents, int __timeout,
			const __sigset_t *__ss);

__END_DECLS

#endif /* sys/epoll.h */
Commit	Line	Data
b168057a	1	/* Copyright (C) 2002-2015 Free Software Foundation, Inc.
db6a567d CD	2	This file is part of the GNU C Library.
	3
	4	The GNU C Library is free software; you can redistribute it and/or
	5	modify it under the terms of the GNU Lesser General Public
	6	License as published by the Free Software Foundation; either
	7	version 2.1 of the License, or (at your option) any later version.
	8
	9	The GNU C Library is distributed in the hope that it will be useful,
	10	but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	12	Lesser General Public License for more details.
	13
	14	You should have received a copy of the GNU Lesser General Public
ab84e3ff PE	15	License along with the GNU C Library. If not, see
ab84e3ff PE	16	<http://www.gnu.org/licenses/>. */
db6a567d CD	17
	18	#ifndef _SYS_EPOLL_H
	19	#define _SYS_EPOLL_H 1
	20
	21	#include <stdint.h>
	22	#include <sys/types.h>
	23
	24	/* Get __sigset_t. */
	25	#include <bits/sigset.h>
	26
	27	#ifndef __sigset_t_defined
	28	# define __sigset_t_defined
	29	typedef __sigset_t sigset_t;
	30	#endif
	31
	32
	33	/* Flags to be passed to epoll_create1. */
	34	enum
	35	{
c40ea3d9	36	EPOLL_CLOEXEC = 010000000
db6a567d	37	#define EPOLL_CLOEXEC EPOLL_CLOEXEC
db6a567d CD	38	};
	39
	40
	41	enum EPOLL_EVENTS
	42	{
	43	EPOLLIN = 0x001,
	44	#define EPOLLIN EPOLLIN
	45	EPOLLPRI = 0x002,
	46	#define EPOLLPRI EPOLLPRI
	47	EPOLLOUT = 0x004,
	48	#define EPOLLOUT EPOLLOUT
	49	EPOLLRDNORM = 0x040,
	50	#define EPOLLRDNORM EPOLLRDNORM
	51	EPOLLRDBAND = 0x080,
	52	#define EPOLLRDBAND EPOLLRDBAND
	53	EPOLLWRNORM = 0x100,
	54	#define EPOLLWRNORM EPOLLWRNORM
	55	EPOLLWRBAND = 0x200,
	56	#define EPOLLWRBAND EPOLLWRBAND
	57	EPOLLMSG = 0x400,
	58	#define EPOLLMSG EPOLLMSG
	59	EPOLLERR = 0x008,
	60	#define EPOLLERR EPOLLERR
	61	EPOLLHUP = 0x010,
	62	#define EPOLLHUP EPOLLHUP
	63	EPOLLRDHUP = 0x2000,
	64	#define EPOLLRDHUP EPOLLRDHUP
f8d44fdc AJ	65	EPOLLWAKEUP = 1u << 29,
f8d44fdc AJ	66	#define EPOLLWAKEUP EPOLLWAKEUP
ad8ae7da	67	EPOLLONESHOT = 1u << 30,
db6a567d	68	#define EPOLLONESHOT EPOLLONESHOT
ad8ae7da	69	EPOLLET = 1u << 31
db6a567d CD	70	#define EPOLLET EPOLLET
	71	};
	72
	73
	74	/* Valid opcodes ( "op" parameter ) to issue to epoll_ctl(). */
	75	#define EPOLL_CTL_ADD 1 /* Add a file descriptor to the interface. */
	76	#define EPOLL_CTL_DEL 2 /* Remove a file descriptor from the interface. */
	77	#define EPOLL_CTL_MOD 3 /* Change file descriptor epoll_event structure. */
	78
	79
	80	typedef union epoll_data
	81	{
	82	void *ptr;
	83	int fd;
	84	uint32_t u32;
	85	uint64_t u64;
	86	} epoll_data_t;
	87
	88	struct epoll_event
	89	{
	90	uint32_t events; /* Epoll events */
	91	epoll_data_t data; /* User data variable */
	92	};
	93
	94
	95	__BEGIN_DECLS
	96
	97	/* Creates an epoll instance. Returns an fd for the new instance.
	98	The "size" parameter is a hint specifying the number of file
	99	descriptors to be associated with the new instance. The fd
	100	returned by epoll_create() should be closed with close(). */
	101	extern int epoll_create (int __size) __THROW;
	102
	103	/* Same as epoll_create but with an FLAGS parameter. The unused SIZE
	104	parameter has been dropped. */
	105	extern int epoll_create1 (int __flags) __THROW;
	106
	107
	108	/* Manipulate an epoll instance "epfd". Returns 0 in case of success,
	109	-1 in case of error ( the "errno" variable will contain the
	110	specific error code ) The "op" parameter is one of the EPOLL_CTL_*
	111	constants defined above. The "fd" parameter is the target of the
	112	operation. The "event" parameter describes which events the caller
	113	is interested in and any associated user data. */
	114	extern int epoll_ctl (int __epfd, int __op, int __fd,
	115	struct epoll_event *__event) __THROW;
	116
	117
	118	/* Wait for events on an epoll instance "epfd". Returns the number of
	119	triggered events returned in "events" buffer. Or -1 in case of
	120	error with the "errno" variable set to the specific error code. The
	121	"events" parameter is a buffer that will contain triggered
	122	events. The "maxevents" is the maximum number of events to be
	123	returned ( usually size of "events" ). The "timeout" parameter
	124	specifies the maximum wait time in milliseconds (-1 == infinite).
	125
	126	This function is a cancellation point and therefore not marked with
	127	__THROW. */
	128	extern int epoll_wait (int __epfd, struct epoll_event *__events,
	129	int __maxevents, int __timeout);
	130
	131
	132	/* Same as epoll_wait, but the thread's signal mask is temporarily
	133	and atomically replaced with the one provided as parameter.
134
135	This function is a cancellation point and therefore not marked with
136	__THROW. */
137	extern int epoll_pwait (int __epfd, struct epoll_event *__events,
138	int __maxevents, int __timeout,
2f4e7894	139	const __sigset_t *__ss);
db6a567d CD	140
	141	__END_DECLS
	142
	143	#endif /* sys/epoll.h */