[apple/xnu.git] / bsd / sys / event.h

/*
 * Copyright (c) 2003-2006 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. The rights granted to you under the License
 * may not be used to create, or enable the creation or redistribution of,
 * unlawful or unlicensed copies of an Apple operating system, or to
 * circumvent, violate, or enable the circumvention or violation of, any
 * terms of an Apple operating system software license agreement.
 * 
 * Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this file.
 * 
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */
/*-
 * Copyright (c) 1999,2000,2001 Jonathan Lemon <jlemon@FreeBSD.org>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *	$FreeBSD: src/sys/sys/event.h,v 1.5.2.5 2001/12/14 19:21:22 jlemon Exp $
 */

#ifndef _SYS_EVENT_H_
#define _SYS_EVENT_H_

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

#define EVFILT_READ		(-1)
#define EVFILT_WRITE		(-2)
#define EVFILT_AIO		(-3)	/* attached to aio requests */
#define EVFILT_VNODE		(-4)	/* attached to vnodes */
#define EVFILT_PROC		(-5)	/* attached to struct proc */
#define EVFILT_SIGNAL		(-6)	/* attached to struct proc */
#define EVFILT_TIMER		(-7)	/* timers */
#define EVFILT_MACHPORT         (-8)	/* Mach portsets */
#define EVFILT_FS		(-9)	/* Filesystem events */
#define EVFILT_USER             (-10)   /* User events */
#define	EVFILT_SESSION		(-11)	/* Audit session events */

#define EVFILT_SYSCOUNT		11
#define EVFILT_THREADMARKER	EVFILT_SYSCOUNT /* Internal use only */

#pragma pack(4)

struct kevent {
	uintptr_t	ident;		/* identifier for this event */
	int16_t		filter;		/* filter for event */
	uint16_t	flags;		/* general flags */
	uint32_t	fflags;		/* filter-specific flags */
	intptr_t	data;		/* filter-specific data */
	void		*udata;		/* opaque user data identifier */
};

#ifdef KERNEL_PRIVATE

struct user64_kevent {
	uint64_t	ident;		/* identifier for this event */
	int16_t		filter;		/* filter for event */
	uint16_t	flags;		/* general flags */
	uint32_t	fflags;		/* filter-specific flags */
	int64_t		data;		/* filter-specific data */
	user_addr_t	udata;		/* opaque user data identifier */
};

struct user32_kevent {
	uint32_t	ident;		/* identifier for this event */
	int16_t		filter;		/* filter for event */
	uint16_t	flags;		/* general flags */
	uint32_t	fflags;		/* filter-specific flags */
	int32_t		data;		/* filter-specific data */
	user32_addr_t	udata;		/* opaque user data identifier */
};

#endif

#pragma pack()

struct kevent64_s {
	uint64_t	ident;		/* identifier for this event */
	int16_t		filter;		/* filter for event */
	uint16_t	flags;		/* general flags */
	uint32_t	fflags;		/* filter-specific flags */
	int64_t		data;		/* filter-specific data */
	uint64_t	udata;		/* opaque user data identifier */
	uint64_t	ext[2];		/* filter-specific extensions */
};

#define EV_SET(kevp, a, b, c, d, e, f) do {	\
	struct kevent *__kevp__ = (kevp);	\
	__kevp__->ident = (a);			\
	__kevp__->filter = (b);			\
	__kevp__->flags = (c);			\
	__kevp__->fflags = (d);			\
	__kevp__->data = (e);			\
	__kevp__->udata = (f);			\
} while(0)

#define EV_SET64(kevp, a, b, c, d, e, f, g, h) do {	\
	struct kevent64_s *__kevp__ = (kevp);		\
	__kevp__->ident = (a);				\
	__kevp__->filter = (b);				\
	__kevp__->flags = (c);				\
	__kevp__->fflags = (d);				\
	__kevp__->data = (e);				\
	__kevp__->udata = (f);				\
	__kevp__->ext[0] = (g);				\
	__kevp__->ext[1] = (h);				\
} while(0)

/* actions */
#define EV_ADD		0x0001		/* add event to kq (implies enable) */
#define EV_DELETE	0x0002		/* delete event from kq */
#define EV_ENABLE	0x0004		/* enable event */
#define EV_DISABLE	0x0008		/* disable event (not reported) */
#define EV_RECEIPT	0x0040		/* force EV_ERROR on success, data == 0 */

/* flags */
#define EV_ONESHOT	0x0010		/* only report one occurrence */
#define EV_CLEAR	0x0020		/* clear event state after reporting */
#define EV_DISPATCH     0x0080          /* disable event after reporting */

#define EV_SYSFLAGS	0xF000		/* reserved by system */
#define EV_FLAG0	0x1000		/* filter-specific flag */
#define EV_FLAG1	0x2000		/* filter-specific flag */

/* returned values */
#define EV_EOF		0x8000		/* EOF detected */
#define EV_ERROR	0x4000		/* error, data contains errno */

/*
 * Filter specific flags for EVFILT_READ
 *
 * The default behavior for EVFILT_READ is to make the "read" determination
 * relative to the current file descriptor read pointer. The EV_POLL
 * flag indicates the determination should be made via poll(2) semantics
 * (which always returns true for regular files - regardless of the amount
 * of unread data in the file).
 *
 * On input, EV_OOBAND specifies that only OOB data should be looked for.
 * The returned data count is the number of bytes beyond the current OOB marker.
 *
 * On output, EV_OOBAND indicates that OOB data is present
 * If it was not specified as an input parameter, then the data count is the
 * number of bytes before the current OOB marker. If at the marker, the
 * data count indicates the number of bytes available after it.  In either
 * case, it's the amount of data one could expect to receive next.
 */
#define EV_POLL	EV_FLAG0
#define EV_OOBAND	EV_FLAG1

/*
 * data/hint fflags for EVFILT_USER, shared with userspace
 */

/*
 * On input, NOTE_TRIGGER causes the event to be triggered for output.
 */
#define NOTE_TRIGGER	0x01000000
#define EV_TRIGGER      0x0100 /*deprecated--for backwards compatibility only*/

/*
 * On input, the top two bits of fflags specifies how the lower twenty four 
 * bits should be applied to the stored value of fflags.
 *
 * On output, the top two bits will always be set to NOTE_FFNOP and the
 * remaining twenty four bits will contain the stored fflags value.
 */
#define NOTE_FFNOP      0x00000000              /* ignore input fflags */
#define NOTE_FFAND      0x40000000              /* and fflags */
#define NOTE_FFOR       0x80000000              /* or fflags */
#define NOTE_FFCOPY     0xc0000000              /* copy fflags */
#define NOTE_FFCTRLMASK 0xc0000000              /* mask for operations */
#define NOTE_FFLAGSMASK	0x00ffffff 

/*
 * data/hint fflags for EVFILT_{READ|WRITE}, shared with userspace
 *
 * The default behavior for EVFILT_READ is to make the determination
 * realtive to the current file descriptor read pointer.
 */
#define NOTE_LOWAT	0x00000001		/* low water mark */
/*
 * data/hint fflags for EVFILT_VNODE, shared with userspace
 */
#define	NOTE_DELETE	0x00000001		/* vnode was removed */
#define	NOTE_WRITE	0x00000002		/* data contents changed */
#define	NOTE_EXTEND	0x00000004		/* size increased */
#define	NOTE_ATTRIB	0x00000008		/* attributes changed */
#define	NOTE_LINK	0x00000010		/* link count changed */
#define	NOTE_RENAME	0x00000020		/* vnode was renamed */
#define	NOTE_REVOKE	0x00000040		/* vnode access was revoked */
#define NOTE_NONE	0x00000080		/* No specific vnode event: to test for EVFILT_READ activation*/

/*
 * data/hint fflags for EVFILT_PROC, shared with userspace
 *
 * Please note that EVFILT_PROC and EVFILT_SIGNAL share the same knote list
 * that hangs off the proc structure. They also both play games with the hint
 * passed to KNOTE(). If NOTE_SIGNAL is passed as a hint, then the lower bits
 * of the hint contain the signal. IF NOTE_FORK is passed, then the lower bits
 * contain the PID of the child.
 */
#define	NOTE_EXIT	0x80000000		/* process exited */
#define	NOTE_FORK	0x40000000		/* process forked */
#define	NOTE_EXEC	0x20000000		/* process exec'd */
#define	NOTE_REAP	0x10000000		/* process reaped */
#define	NOTE_SIGNAL	0x08000000		/* shared with EVFILT_SIGNAL */
#define	NOTE_PDATAMASK	0x000fffff		/* mask for pid/signal */
#define	NOTE_PCTRLMASK	(~NOTE_PDATAMASK)

/*
 * data/hint fflags for EVFILT_TIMER, shared with userspace.
 * The default is a (repeating) interval timer with the data
 * specifying the timeout interval in milliseconds.
 *
 * All timeouts are implicitly EV_CLEAR events.
 */
#define NOTE_SECONDS	0x00000001		/* data is seconds         */
#define NOTE_USECONDS	0x00000002		/* data is microseconds    */
#define NOTE_NSECONDS	0x00000004		/* data is nanoseconds     */
#define NOTE_ABSOLUTE	0x00000008		/* absolute timeout        */
						/* ... implicit EV_ONESHOT */
/*
 * data/hint fflags for EVFILT_MACHPORT, shared with userspace.
 *
 * Only portsets are support at this time.
 *
 * The fflags field can optionally contain the MACH_RCV_MSG, MACH_RCV_LARGE,
 * and related trailer receive options as defined in <mach/message.h>.
 * The presence of these flags directs the kevent64() call to attempt to receive
 * the message during kevent delivery, rather than just indicate that a message exists.
 * On setup, The ext[0] field contains the receive buffer pointer and ext[1] contains
 * the receive buffer length.  Upon event delivery, the actual received message size
 * is returned in ext[1].  As with mach_msg(), the buffer must be large enough to
 * receive the message and the requested (or default) message trailers.  In addition,
 * the fflags field contains the return code normally returned by mach_msg().
 *
 * If no message receipt options were provided in the fflags field on setup, no
 * message is received by this call. Instead, on output, the data field simply
 * contains the name of the actual port detected with a message waiting.
 */

/*
 * data/hint fflags for EVFILT_SESSION, shared with userspace.
 *
 * The kevent ident field should be set to AU_SESSION_ANY_ASID if interested
 * in events for any session.
 *
 * NOTE_AS_UPDATE may be going away since struct auditinfo_addr may become 
 * immutable once initially set.
 */
#define	NOTE_AS_START	0x00000001		/* start of new session */
#define	NOTE_AS_END	0x00000002		/* start of new session */
#define	NOTE_AS_ERR	0x00000004		/* error tracking new session */
#define	NOTE_AS_CLOSE	0x00000008		/* currently unsupported */
#define	NOTE_AS_UPDATE	0x00000010		/* session data updated */

/*
 * Kevent ident value for any session.
 */
#define	AS_ANY_ASID	0xFFFFFFFF

struct au_sentry;	/* Audit session entry */


/*
 * DEPRECATED!!!!!!!!!
 * NOTE_TRACK, NOTE_TRACKERR, and NOTE_CHILD are no longer supported as of 10.5
 */
/* additional flags for EVFILT_PROC */
#define	NOTE_TRACK	0x00000001		/* follow across forks */
#define	NOTE_TRACKERR	0x00000002		/* could not track child */
#define	NOTE_CHILD	0x00000004		/* am a child process */


#ifndef KERNEL
/* Temporay solution for BootX to use inode.h till kqueue moves to vfs layer */
#include <sys/queue.h> 
struct knote;
SLIST_HEAD(klist, knote);
#endif

#ifdef KERNEL

#ifdef KERNEL_PRIVATE
#include <sys/queue.h> 

#ifdef MALLOC_DECLARE
MALLOC_DECLARE(M_KQUEUE);
#endif

TAILQ_HEAD(kqtailq, knote);	/* a list of "queued" events */

struct knote {
	int		kn_inuse;	/* inuse count */
	struct kqtailq	*kn_tq;		/* pointer to tail queue */
	TAILQ_ENTRY(knote)	kn_tqe;		/* linkage for tail queue */
	struct kqueue	*kn_kq;	/* which kqueue we are on */
	SLIST_ENTRY(knote)	kn_link;	/* linkage for search list */
	SLIST_ENTRY(knote)	kn_selnext;	/* klist element chain */
	union {
		struct		fileproc *p_fp;	/* file data pointer */
		struct		proc *p_proc;	/* proc pointer */
		struct          ipc_pset *p_pset;       /* pset pointer */
		struct		au_sentry *p_se; 	/* Audit session ptr */
	} kn_ptr;
	struct			filterops *kn_fop;
	int			kn_status;	/* status bits */
	int			kn_sfflags;	/* saved filter flags */
	struct 			kevent64_s kn_kevent;
	void			*kn_hook;
	int			kn_hookid;
	int64_t			kn_sdata;	/* saved data field */

#define KN_ACTIVE	0x01			/* event has been triggered */
#define KN_QUEUED	0x02			/* event is on queue */
#define KN_DISABLED	0x04			/* event is disabled */
#define KN_DROPPING	0x08			/* knote is being dropped */
#define KN_USEWAIT	0x10			/* wait for knote use */
#define KN_ATTACHING	0x20			/* event is pending attach */
#define KN_STAYQUEUED	0x40			/* force event to stay on queue */

#define kn_id		kn_kevent.ident
#define kn_filter	kn_kevent.filter
#define kn_flags	kn_kevent.flags
#define kn_fflags	kn_kevent.fflags
#define kn_data		kn_kevent.data
#define kn_udata	kn_kevent.udata
#define kn_ext		kn_kevent.ext
#define kn_fp		kn_ptr.p_fp
};

/* Hint values for f_touch filter operation */
#define EVENT_REGISTER  1
#define EVENT_PROCESS   2

struct filterops {
	int	f_isfd;		/* true if ident == filedescriptor */
	int	(*f_attach)(struct knote *kn);
	void	(*f_detach)(struct knote *kn);
	int	(*f_event)(struct knote *kn, long hint);
	/* Optional f_touch operation, called only if !f_isfd && non-NULL */
	void    (*f_touch)(struct knote *kn, struct kevent64_s *kev, long type);
	/* Optional f_peek operation, called only if KN_STAYQUEUED is set */
	int	(*f_peek)(struct knote *kn);
};

struct proc;
struct wait_queue;

SLIST_HEAD(klist, knote);
extern void	knote_init(void) __attribute__((section("__TEXT, initcode")));
extern void	klist_init(struct klist *list);

#define KNOTE(list, hint)	knote(list, hint)
#define KNOTE_ATTACH(list, kn)	knote_attach(list, kn)
#define KNOTE_DETACH(list, kn)	knote_detach(list, kn)


extern void	knote(struct klist *list, long hint);
extern int	knote_attach(struct klist *list, struct knote *kn);
extern int	knote_detach(struct klist *list, struct knote *kn);
extern int	knote_link_wait_queue(struct knote *kn, struct wait_queue *wq);	
extern void	knote_unlink_wait_queue(struct knote *kn, struct wait_queue *wq);
extern void	knote_fdclose(struct proc *p, int fd);

#endif /* !KERNEL_PRIVATE */

#else 	/* KERNEL */


struct timespec;

__BEGIN_DECLS
int     kqueue(void);
int     kevent(int kq, const struct kevent *changelist, int nchanges,
		    struct kevent *eventlist, int nevents,
		    const struct timespec *timeout);
int     kevent64(int kq, const struct kevent64_s *changelist, 
		    int nchanges, struct kevent64_s *eventlist, 
		    int nevents, unsigned int flags, 
		    const struct timespec *timeout);
__END_DECLS


#endif /* KERNEL */


#endif /* !_SYS_EVENT_H_ */
Commit	Line	Data
55e303ae	1	/*
2d21ac55	2	* Copyright (c) 2003-2006 Apple Computer, Inc. All rights reserved.
55e303ae	3	*
2d21ac55	4	* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
55e303ae	5	*
2d21ac55 A	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. The rights granted to you under the License
	10	* may not be used to create, or enable the creation or redistribution of,
	11	* unlawful or unlicensed copies of an Apple operating system, or to
	12	* circumvent, violate, or enable the circumvention or violation of, any
	13	* terms of an Apple operating system software license agreement.
8f6c56a5	14	*
2d21ac55 A	15	* Please obtain a copy of the License at
	16	* http://www.opensource.apple.com/apsl/ and read it before using this file.
	17	*
	18	* The Original Code and all software distributed under the License are
	19	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
8f6c56a5 A	20	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
8f6c56a5 A	21	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55 A	22	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	23	* Please see the License for the specific language governing rights and
	24	* limitations under the License.
8f6c56a5	25	*
2d21ac55	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
55e303ae A	27	*/
	28	/*-
	29	* Copyright (c) 1999,2000,2001 Jonathan Lemon <jlemon@FreeBSD.org>
	30	* All rights reserved.
	31	*
	32	* Redistribution and use in source and binary forms, with or without
	33	* modification, are permitted provided that the following conditions
	34	* are met:
	35	* 1. Redistributions of source code must retain the above copyright
	36	* notice, this list of conditions and the following disclaimer.
	37	* 2. Redistributions in binary form must reproduce the above copyright
	38	* notice, this list of conditions and the following disclaimer in the
	39	* documentation and/or other materials provided with the distribution.
	40	*
	41	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
	42	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	43	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	44	* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
	45	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	46	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	47	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	48	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	49	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	50	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	51	* SUCH DAMAGE.
	52	*
	53	* $FreeBSD: src/sys/sys/event.h,v 1.5.2.5 2001/12/14 19:21:22 jlemon Exp $
	54	*/
	55
	56	#ifndef _SYS_EVENT_H_
	57	#define _SYS_EVENT_H_
	58
91447636 A	59	#include <machine/types.h>
	60	#include <sys/cdefs.h>
	61	#include <stdint.h>
	62
55e303ae A	63	#define EVFILT_READ (-1)
	64	#define EVFILT_WRITE (-2)
	65	#define EVFILT_AIO (-3) /* attached to aio requests */
	66	#define EVFILT_VNODE (-4) /* attached to vnodes */
	67	#define EVFILT_PROC (-5) /* attached to struct proc */
	68	#define EVFILT_SIGNAL (-6) /* attached to struct proc */
	69	#define EVFILT_TIMER (-7) /* timers */
b0d623f7	70	#define EVFILT_MACHPORT (-8) /* Mach portsets */
55e303ae	71	#define EVFILT_FS (-9) /* Filesystem events */
b0d623f7 A	72	#define EVFILT_USER (-10) /* User events */
b0d623f7 A	73	#define EVFILT_SESSION (-11) /* Audit session events */
55e303ae	74
b0d623f7	75	#define EVFILT_SYSCOUNT 11
91447636 A	76	#define EVFILT_THREADMARKER EVFILT_SYSCOUNT /* Internal use only */
91447636 A	77
0c530ab8	78	#pragma pack(4)
55e303ae A	79
	80	struct kevent {
	81	uintptr_t ident; /* identifier for this event */
b0d623f7 A	82	int16_t filter; /* filter for event */
	83	uint16_t flags; /* general flags */
	84	uint32_t fflags; /* filter-specific flags */
91447636	85	intptr_t data; /* filter-specific data */
55e303ae	86	void udata; / opaque user data identifier */
91447636 A	87	};
	88
	89	#ifdef KERNEL_PRIVATE
	90
b0d623f7	91	struct user64_kevent {
91447636	92	uint64_t ident; /* identifier for this event */
b0d623f7 A	93	int16_t filter; /* filter for event */
	94	uint16_t flags; /* general flags */
	95	uint32_t fflags; /* filter-specific flags */
91447636 A	96	int64_t data; /* filter-specific data */
91447636 A	97	user_addr_t udata; /* opaque user data identifier */
55e303ae A	98	};
55e303ae A	99
b0d623f7 A	100	struct user32_kevent {
	101	uint32_t ident; /* identifier for this event */
	102	int16_t filter; /* filter for event */
	103	uint16_t flags; /* general flags */
	104	uint32_t fflags; /* filter-specific flags */
	105	int32_t data; /* filter-specific data */
	106	user32_addr_t udata; /* opaque user data identifier */
	107	};
	108
91447636 A	109	#endif
91447636 A	110
0c530ab8	111	#pragma pack()
91447636	112
b0d623f7 A	113	struct kevent64_s {
	114	uint64_t ident; /* identifier for this event */
	115	int16_t filter; /* filter for event */
	116	uint16_t flags; /* general flags */
	117	uint32_t fflags; /* filter-specific flags */
	118	int64_t data; /* filter-specific data */
	119	uint64_t udata; /* opaque user data identifier */
	120	uint64_t ext[2]; /* filter-specific extensions */
	121	};
	122
55e303ae A	123	#define EV_SET(kevp, a, b, c, d, e, f) do { \
	124	struct kevent *__kevp__ = (kevp); \
	125	__kevp__->ident = (a); \
	126	__kevp__->filter = (b); \
	127	__kevp__->flags = (c); \
	128	__kevp__->fflags = (d); \
	129	__kevp__->data = (e); \
	130	__kevp__->udata = (f); \
	131	} while(0)
	132
b0d623f7 A	133	#define EV_SET64(kevp, a, b, c, d, e, f, g, h) do { \
	134	struct kevent64_s *__kevp__ = (kevp); \
	135	__kevp__->ident = (a); \
	136	__kevp__->filter = (b); \
	137	__kevp__->flags = (c); \
	138	__kevp__->fflags = (d); \
	139	__kevp__->data = (e); \
	140	__kevp__->udata = (f); \
	141	__kevp__->ext[0] = (g); \
	142	__kevp__->ext[1] = (h); \
	143	} while(0)
	144
55e303ae A	145	/* actions */
	146	#define EV_ADD 0x0001 /* add event to kq (implies enable) */
	147	#define EV_DELETE 0x0002 /* delete event from kq */
	148	#define EV_ENABLE 0x0004 /* enable event */
	149	#define EV_DISABLE 0x0008 /* disable event (not reported) */
2d21ac55	150	#define EV_RECEIPT 0x0040 /* force EV_ERROR on success, data == 0 */
55e303ae A	151
	152	/* flags */
	153	#define EV_ONESHOT 0x0010 /* only report one occurrence */
	154	#define EV_CLEAR 0x0020 /* clear event state after reporting */
b0d623f7	155	#define EV_DISPATCH 0x0080 /* disable event after reporting */
55e303ae A	156
55e303ae A	157	#define EV_SYSFLAGS 0xF000 /* reserved by system */
91447636	158	#define EV_FLAG0 0x1000 /* filter-specific flag */
55e303ae A	159	#define EV_FLAG1 0x2000 /* filter-specific flag */
	160
	161	/* returned values */
	162	#define EV_EOF 0x8000 /* EOF detected */
	163	#define EV_ERROR 0x4000 /* error, data contains errno */
	164
	165	/*
91447636 A	166	* Filter specific flags for EVFILT_READ
	167	*
	168	* The default behavior for EVFILT_READ is to make the "read" determination
	169	* relative to the current file descriptor read pointer. The EV_POLL
	170	* flag indicates the determination should be made via poll(2) semantics
	171	* (which always returns true for regular files - regardless of the amount
	172	* of unread data in the file).
	173	*
	174	* On input, EV_OOBAND specifies that only OOB data should be looked for.
	175	* The returned data count is the number of bytes beyond the current OOB marker.
	176	*
	177	* On output, EV_OOBAND indicates that OOB data is present
	178	* If it was not specified as an input parameter, then the data count is the
	179	* number of bytes before the current OOB marker. If at the marker, the
	180	* data count indicates the number of bytes available after it. In either
	181	* case, it's the amount of data one could expect to receive next.
55e303ae	182	*/
91447636 A	183	#define EV_POLL EV_FLAG0
91447636 A	184	#define EV_OOBAND EV_FLAG1
55e303ae	185
b0d623f7 A	186	/*
	187	* data/hint fflags for EVFILT_USER, shared with userspace
	188	*/
	189
	190	/*
	191	* On input, NOTE_TRIGGER causes the event to be triggered for output.
	192	*/
	193	#define NOTE_TRIGGER 0x01000000
	194	#define EV_TRIGGER 0x0100 /deprecated--for backwards compatibility only/
	195
	196	/*
	197	* On input, the top two bits of fflags specifies how the lower twenty four
	198	* bits should be applied to the stored value of fflags.
	199	*
	200	* On output, the top two bits will always be set to NOTE_FFNOP and the
	201	* remaining twenty four bits will contain the stored fflags value.
	202	*/
	203	#define NOTE_FFNOP 0x00000000 /* ignore input fflags */
	204	#define NOTE_FFAND 0x40000000 /* and fflags */
	205	#define NOTE_FFOR 0x80000000 /* or fflags */
	206	#define NOTE_FFCOPY 0xc0000000 /* copy fflags */
	207	#define NOTE_FFCTRLMASK 0xc0000000 /* mask for operations */
	208	#define NOTE_FFLAGSMASK 0x00ffffff
	209
55e303ae	210	/*
91447636 A	211	* data/hint fflags for EVFILT_{READ\|WRITE}, shared with userspace
	212	*
	213	* The default behavior for EVFILT_READ is to make the determination
	214	* realtive to the current file descriptor read pointer.
	215	*/
	216	#define NOTE_LOWAT 0x00000001 /* low water mark */
	217	/*
	218	* data/hint fflags for EVFILT_VNODE, shared with userspace
55e303ae	219	*/
91447636 A	220	#define NOTE_DELETE 0x00000001 /* vnode was removed */
	221	#define NOTE_WRITE 0x00000002 /* data contents changed */
	222	#define NOTE_EXTEND 0x00000004 /* size increased */
	223	#define NOTE_ATTRIB 0x00000008 /* attributes changed */
	224	#define NOTE_LINK 0x00000010 /* link count changed */
	225	#define NOTE_RENAME 0x00000020 /* vnode was renamed */
	226	#define NOTE_REVOKE 0x00000040 /* vnode access was revoked */
b0d623f7	227	#define NOTE_NONE 0x00000080 /* No specific vnode event: to test for EVFILT_READ activation*/
55e303ae A	228
55e303ae A	229	/*
91447636	230	* data/hint fflags for EVFILT_PROC, shared with userspace
2d21ac55 A	231	*
	232	* Please note that EVFILT_PROC and EVFILT_SIGNAL share the same knote list
	233	* that hangs off the proc structure. They also both play games with the hint
	234	* passed to KNOTE(). If NOTE_SIGNAL is passed as a hint, then the lower bits
	235	* of the hint contain the signal. IF NOTE_FORK is passed, then the lower bits
	236	* contain the PID of the child.
55e303ae A	237	*/
	238	#define NOTE_EXIT 0x80000000 /* process exited */
	239	#define NOTE_FORK 0x40000000 /* process forked */
	240	#define NOTE_EXEC 0x20000000 /* process exec'd */
2d21ac55 A	241	#define NOTE_REAP 0x10000000 /* process reaped */
	242	#define NOTE_SIGNAL 0x08000000 /* shared with EVFILT_SIGNAL */
	243	#define NOTE_PDATAMASK 0x000fffff /* mask for pid/signal */
	244	#define NOTE_PCTRLMASK (~NOTE_PDATAMASK)
55e303ae	245
91447636 A	246	/*
	247	* data/hint fflags for EVFILT_TIMER, shared with userspace.
	248	* The default is a (repeating) interval timer with the data
	249	* specifying the timeout interval in milliseconds.
	250	*
	251	* All timeouts are implicitly EV_CLEAR events.
	252	*/
	253	#define NOTE_SECONDS 0x00000001 /* data is seconds */
	254	#define NOTE_USECONDS 0x00000002 /* data is microseconds */
	255	#define NOTE_NSECONDS 0x00000004 /* data is nanoseconds */
	256	#define NOTE_ABSOLUTE 0x00000008 /* absolute timeout */
	257	/* ... implicit EV_ONESHOT */
b0d623f7 A	258	/*
	259	* data/hint fflags for EVFILT_MACHPORT, shared with userspace.
	260	*
	261	* Only portsets are support at this time.
	262	*
	263	* The fflags field can optionally contain the MACH_RCV_MSG, MACH_RCV_LARGE,
	264	* and related trailer receive options as defined in <mach/message.h>.
	265	* The presence of these flags directs the kevent64() call to attempt to receive
	266	* the message during kevent delivery, rather than just indicate that a message exists.
	267	* On setup, The ext[0] field contains the receive buffer pointer and ext[1] contains
	268	* the receive buffer length. Upon event delivery, the actual received message size
	269	* is returned in ext[1]. As with mach_msg(), the buffer must be large enough to
	270	* receive the message and the requested (or default) message trailers. In addition,
	271	* the fflags field contains the return code normally returned by mach_msg().
	272	*
	273	* If no message receipt options were provided in the fflags field on setup, no
	274	* message is received by this call. Instead, on output, the data field simply
	275	* contains the name of the actual port detected with a message waiting.
	276	*/
	277
	278	/*
	279	* data/hint fflags for EVFILT_SESSION, shared with userspace.
	280	*
	281	* The kevent ident field should be set to AU_SESSION_ANY_ASID if interested
	282	* in events for any session.
	283	*
	284	* NOTE_AS_UPDATE may be going away since struct auditinfo_addr may become
	285	* immutable once initially set.
	286	*/
	287	#define NOTE_AS_START 0x00000001 /* start of new session */
	288	#define NOTE_AS_END 0x00000002 /* start of new session */
	289	#define NOTE_AS_ERR 0x00000004 /* error tracking new session */
	290	#define NOTE_AS_CLOSE 0x00000008 /* currently unsupported */
	291	#define NOTE_AS_UPDATE 0x00000010 /* session data updated */
	292
	293	/*
	294	* Kevent ident value for any session.
	295	*/
	296	#define AS_ANY_ASID 0xFFFFFFFF
	297
	298	struct au_sentry; /* Audit session entry */
	299
	300
2d21ac55 A	301	/*
	302	* DEPRECATED!!!!!!!!!
	303	* NOTE_TRACK, NOTE_TRACKERR, and NOTE_CHILD are no longer supported as of 10.5
	304	*/
55e303ae A	305	/* additional flags for EVFILT_PROC */
	306	#define NOTE_TRACK 0x00000001 /* follow across forks */
	307	#define NOTE_TRACKERR 0x00000002 /* could not track child */
	308	#define NOTE_CHILD 0x00000004 /* am a child process */
	309
	310
55e303ae	311
91447636 A	312	#ifndef KERNEL
	313	/* Temporay solution for BootX to use inode.h till kqueue moves to vfs layer */
	314	#include <sys/queue.h>
	315	struct knote;
	316	SLIST_HEAD(klist, knote);
	317	#endif
	318
	319	#ifdef KERNEL
	320
	321	#ifdef KERNEL_PRIVATE
55e303ae A	322	#include <sys/queue.h>
	323
	324	#ifdef MALLOC_DECLARE
	325	MALLOC_DECLARE(M_KQUEUE);
	326	#endif
	327
91447636 A	328	TAILQ_HEAD(kqtailq, knote); /* a list of "queued" events */
91447636 A	329
55e303ae	330	struct knote {
91447636 A	331	int kn_inuse; /* inuse count */
	332	struct kqtailq kn_tq; / pointer to tail queue */
	333	TAILQ_ENTRY(knote) kn_tqe; /* linkage for tail queue */
	334	struct kqueue kn_kq; / which kqueue we are on */
	335	SLIST_ENTRY(knote) kn_link; /* linkage for search list */
55e303ae	336	SLIST_ENTRY(knote) kn_selnext; /* klist element chain */
55e303ae	337	union {
91447636	338	struct fileproc p_fp; / file data pointer */
55e303ae	339	struct proc p_proc; / proc pointer */
b0d623f7 A	340	struct ipc_pset p_pset; / pset pointer */
b0d623f7 A	341	struct au_sentry p_se; / Audit session ptr */
55e303ae A	342	} kn_ptr;
55e303ae A	343	struct filterops *kn_fop;
91447636	344	int kn_status; /* status bits */
55e303ae	345	int kn_sfflags; /* saved filter flags */
b0d623f7 A	346	struct kevent64_s kn_kevent;
b0d623f7 A	347	void *kn_hook;
91447636 A	348	int kn_hookid;
	349	int64_t kn_sdata; /* saved data field */
	350
55e303ae A	351	#define KN_ACTIVE 0x01 /* event has been triggered */
	352	#define KN_QUEUED 0x02 /* event is on queue */
	353	#define KN_DISABLED 0x04 /* event is disabled */
91447636 A	354	#define KN_DROPPING 0x08 /* knote is being dropped */
91447636 A	355	#define KN_USEWAIT 0x10 /* wait for knote use */
b0d623f7 A	356	#define KN_ATTACHING 0x20 /* event is pending attach */
b0d623f7 A	357	#define KN_STAYQUEUED 0x40 /* force event to stay on queue */
55e303ae A	358
	359	#define kn_id kn_kevent.ident
	360	#define kn_filter kn_kevent.filter
	361	#define kn_flags kn_kevent.flags
	362	#define kn_fflags kn_kevent.fflags
	363	#define kn_data kn_kevent.data
b0d623f7 A	364	#define kn_udata kn_kevent.udata
b0d623f7 A	365	#define kn_ext kn_kevent.ext
55e303ae A	366	#define kn_fp kn_ptr.p_fp
	367	};
	368
b0d623f7 A	369	/* Hint values for f_touch filter operation */
	370	#define EVENT_REGISTER 1
	371	#define EVENT_PROCESS 2
	372
55e303ae A	373	struct filterops {
55e303ae A	374	int f_isfd; /* true if ident == filedescriptor */
91447636 A	375	int (f_attach)(struct knote kn);
	376	void (f_detach)(struct knote kn);
	377	int (f_event)(struct knote kn, long hint);
b0d623f7 A	378	/* Optional f_touch operation, called only if !f_isfd && non-NULL */
	379	void (f_touch)(struct knote kn, struct kevent64_s *kev, long type);
	380	/* Optional f_peek operation, called only if KN_STAYQUEUED is set */
	381	int (f_peek)(struct knote kn);
55e303ae A	382	};
	383
	384	struct proc;
b0d623f7	385	struct wait_queue;
55e303ae A	386
55e303ae A	387	SLIST_HEAD(klist, knote);
2d21ac55	388	extern void knote_init(void) __attribute__((section("__TEXT, initcode")));
55e303ae A	389	extern void klist_init(struct klist *list);
	390
	391	#define KNOTE(list, hint) knote(list, hint)
	392	#define KNOTE_ATTACH(list, kn) knote_attach(list, kn)
	393	#define KNOTE_DETACH(list, kn) knote_detach(list, kn)
	394
	395
	396	extern void knote(struct klist *list, long hint);
	397	extern int knote_attach(struct klist list, struct knote kn);
	398	extern int knote_detach(struct klist list, struct knote kn);
b0d623f7 A	399	extern int knote_link_wait_queue(struct knote kn, struct wait_queue wq);
b0d623f7 A	400	extern void knote_unlink_wait_queue(struct knote kn, struct wait_queue wq);
55e303ae	401	extern void knote_fdclose(struct proc *p, int fd);
55e303ae	402
91447636 A	403	#endif /* !KERNEL_PRIVATE */
	404
	405	#else /* KERNEL */
55e303ae	406
55e303ae	407
55e303ae A	408	struct timespec;
	409
	410	__BEGIN_DECLS
91447636 A	411	int kqueue(void);
91447636 A	412	int kevent(int kq, const struct kevent *changelist, int nchanges,
55e303ae	413	struct kevent *eventlist, int nevents,
91447636	414	const struct timespec *timeout);
b0d623f7 A	415	int kevent64(int kq, const struct kevent64_s *changelist,
	416	int nchanges, struct kevent64_s *eventlist,
	417	int nevents, unsigned int flags,
	418	const struct timespec *timeout);
55e303ae A	419	__END_DECLS
55e303ae A	420
55e303ae	421
91447636	422	#endif /* KERNEL */
55e303ae	423
55e303ae A	424
55e303ae A	425	#endif /* !_SYS_EVENT_H_ */