xref: /illumos-gate/usr/src/uts/common/sys/poll.h (revision 581cede61ac9c14d8d4ea452562a567189eead78)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
23 /*	  All Rights Reserved  	*/
24 
25 
26 /*
27  * Copyright (c) 1995, 1998 by Sun Microsystems, Inc.
28  * All rights reserved.
29  */
30 
31 #ifndef _SYS_POLL_H
32 #define	_SYS_POLL_H
33 
34 #pragma ident	"%Z%%M%	%I%	%E% SMI"	/* SVr4.0 11.9 */
35 
36 #ifdef	__cplusplus
37 extern "C" {
38 #endif
39 
40 /*
41  * Structure of file descriptor/event pairs supplied in
42  * the poll arrays.
43  */
44 typedef struct pollfd {
45 	int fd;				/* file desc to poll */
46 	short events;			/* events of interest on fd */
47 	short revents;			/* events that occurred on fd */
48 } pollfd_t;
49 
50 typedef unsigned long	nfds_t;
51 
52 /*
53  * Testable select events
54  */
55 #define	POLLIN		0x0001		/* fd is readable */
56 #define	POLLPRI		0x0002		/* high priority info at fd */
57 #define	POLLOUT		0x0004		/* fd is writeable (won't block) */
58 #define	POLLRDNORM	0x0040		/* normal data is readable */
59 #define	POLLWRNORM	POLLOUT
60 #define	POLLRDBAND	0x0080		/* out-of-band data is readable */
61 #define	POLLWRBAND	0x0100		/* out-of-band data is writeable */
62 
63 #define	POLLNORM	POLLRDNORM
64 
65 /*
66  * Non-testable poll events (may not be specified in events field,
67  * but may be returned in revents field).
68  */
69 #define	POLLERR		0x0008		/* fd has error condition */
70 #define	POLLHUP		0x0010		/* fd has been hung up on */
71 #define	POLLNVAL	0x0020		/* invalid pollfd entry */
72 
73 #define	POLLREMOVE	0x0800	/* remove a cached poll fd from /dev/poll */
74 
75 #ifdef _KERNEL
76 
77 /*
78  * Additional private poll flags supported only by strpoll().
79  * Must be bit-wise distinct from the above POLL flags.
80  */
81 #define	POLLRDDATA	0x0200	/* Wait for M_DATA; ignore M_PROTO only msgs */
82 #define	POLLNOERR	0x0400	/* Ignore POLLERR conditions */
83 
84 #define	POLLCLOSED	0x8000	/* a (cached) poll fd has been closed */
85 
86 #endif /* _KERNEL */
87 
88 #if defined(_KERNEL) || defined(_KMEMUSER)
89 
90 #include <sys/thread.h>
91 
92 /*
93  * XXX We are forced to use a forward reference here because including
94  * file.h here will break i386 build. The real solution is to fix the
95  * broken parts in usr/src/stand/lib/fs.
96  */
97 struct fpollinfo;
98 
99 /*
100  * Poll list head structure.  A pointer to this is passed to
101  * pollwakeup() from the caller indicating an event has occurred.
102  * Only the ph_list field is used, but for DDI compliance, we can't
103  * change the size of the structure.
104  */
105 typedef struct pollhead {
106 	struct polldat		*ph_list;	/* list of pollers */
107 	void			*ph_pad1;	/* unused -- see above */
108 	short			ph_pad2;	/* unused -- see above */
109 } pollhead_t;
110 
111 #if defined(_KERNEL)
112 
113 /*
114  * Routine called to notify a process of the occurrence
115  * of an event.
116  */
117 extern void pollwakeup(pollhead_t *, short);
118 
119 /*
120  * Internal routines.
121  */
122 extern void polllock(pollhead_t *, kmutex_t *);
123 extern int pollunlock(void);
124 extern void pollrelock(int);
125 extern void pollcleanup(void);
126 extern void pollblockexit(struct fpollinfo *);
127 extern void pollcacheclean(struct fpollinfo *, int);
128 
129 /*
130  * public poll head interface:
131  *
132  *  pollhead_clean      clean up all polldats on a pollhead list
133  */
134 extern void pollhead_clean(pollhead_t *);
135 
136 #endif /* defined(_KERNEL) */
137 
138 #endif /* defined(_KERNEL) || defined(_KMEMUSER) */
139 
140 #if !defined(_KERNEL)
141 #if defined(__STDC__)
142 int poll(struct pollfd *, nfds_t, int);
143 #else
144 int poll();
145 #endif /* __STDC__ */
146 #endif /* !_KERNEL */
147 
148 #ifdef	__cplusplus
149 }
150 #endif
151 
152 #endif	/* _SYS_POLL_H */
153