Improve documentation of query-replace-from-to-separator
[emacs.git] / lib / sys_select.in.h
blob616e77dd4cf66b19b393884189e2bd03b41ef317
1 /* Substitute for <sys/select.h>.
2 Copyright (C) 2007-2017 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 3, or (at your option)
7 any later version.
9 This program 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
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, see <http://www.gnu.org/licenses/>. */
17 # if __GNUC__ >= 3
18 @PRAGMA_SYSTEM_HEADER@
19 # endif
20 @PRAGMA_COLUMNS@
22 /* On OSF/1 and Solaris 2.6, <sys/types.h> and <sys/time.h>
23 both include <sys/select.h>.
24 On Cygwin, <sys/time.h> includes <sys/select.h>.
25 Simply delegate to the system's header in this case. */
26 #if (@HAVE_SYS_SELECT_H@ \
27 && !defined _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TYPES_H \
28 && ((defined __osf__ && defined _SYS_TYPES_H_ \
29 && defined _OSF_SOURCE) \
30 || (defined __sun && defined _SYS_TYPES_H \
31 && (! (defined _XOPEN_SOURCE || defined _POSIX_C_SOURCE) \
32 || defined __EXTENSIONS__))))
34 # define _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TYPES_H
35 # @INCLUDE_NEXT@ @NEXT_SYS_SELECT_H@
37 #elif (@HAVE_SYS_SELECT_H@ \
38 && (defined _CYGWIN_SYS_TIME_H \
39 || (!defined _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TIME_H \
40 && ((defined __osf__ && defined _SYS_TIME_H_ \
41 && defined _OSF_SOURCE) \
42 || (defined __sun && defined _SYS_TIME_H \
43 && (! (defined _XOPEN_SOURCE \
44 || defined _POSIX_C_SOURCE) \
45 || defined __EXTENSIONS__))))))
47 # define _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TIME_H
48 # @INCLUDE_NEXT@ @NEXT_SYS_SELECT_H@
50 /* On IRIX 6.5, <sys/timespec.h> includes <sys/types.h>, which includes
51 <sys/bsd_types.h>, which includes <sys/select.h>. At this point we cannot
52 include <signal.h>, because that includes <internal/signal_core.h>, which
53 gives a syntax error because <sys/timespec.h> has not been completely
54 processed. Simply delegate to the system's header in this case. */
55 #elif @HAVE_SYS_SELECT_H@ && defined __sgi && (defined _SYS_BSD_TYPES_H && !defined _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_BSD_TYPES_H)
57 # define _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_BSD_TYPES_H
58 # @INCLUDE_NEXT@ @NEXT_SYS_SELECT_H@
60 /* On OpenBSD 5.0, <pthread.h> includes <sys/types.h>, which includes
61 <sys/select.h>. At this point we cannot include <signal.h>, because that
62 includes gnulib's pthread.h override, which gives a syntax error because
63 /usr/include/pthread.h has not been completely processed. Simply delegate
64 to the system's header in this case. */
65 #elif @HAVE_SYS_SELECT_H@ && defined __OpenBSD__ && (defined _PTHREAD_H_ && !defined PTHREAD_MUTEX_INITIALIZER)
67 # @INCLUDE_NEXT@ @NEXT_SYS_SELECT_H@
69 #else
71 #ifndef _@GUARD_PREFIX@_SYS_SELECT_H
73 /* On many platforms, <sys/select.h> assumes prior inclusion of
74 <sys/types.h>. Also, mingw defines sigset_t there, instead of
75 in <signal.h> where it belongs. */
76 #include <sys/types.h>
78 #if @HAVE_SYS_SELECT_H@
80 /* On OSF/1 4.0, <sys/select.h> provides only a forward declaration
81 of 'struct timeval', and no definition of this type.
82 Also, Mac OS X, AIX, HP-UX, IRIX, Solaris, Interix declare select()
83 in <sys/time.h>.
84 But avoid namespace pollution on glibc systems and "unknown type
85 name" problems on Cygwin. */
86 # if !(defined __GLIBC__ || defined __CYGWIN__)
87 # include <sys/time.h>
88 # endif
90 /* On AIX 7 and Solaris 10, <sys/select.h> provides an FD_ZERO implementation
91 that relies on memset(), but without including <string.h>.
92 But in any case avoid namespace pollution on glibc systems. */
93 # if (defined __OpenBSD__ || defined _AIX || defined __sun || defined __osf__ || defined __BEOS__) \
94 && ! defined __GLIBC__
95 # include <string.h>
96 # endif
98 /* The include_next requires a split double-inclusion guard. */
99 # @INCLUDE_NEXT@ @NEXT_SYS_SELECT_H@
101 #endif
103 /* Get definition of 'sigset_t'.
104 But avoid namespace pollution on glibc systems and "unknown type
105 name" problems on Cygwin.
106 Do this after the include_next (for the sake of OpenBSD 5.0) but before
107 the split double-inclusion guard (for the sake of Solaris). */
108 #if !((defined __GLIBC__ || defined __CYGWIN__) && !defined __UCLIBC__)
109 # include <signal.h>
110 #endif
112 #ifndef _@GUARD_PREFIX@_SYS_SELECT_H
113 #define _@GUARD_PREFIX@_SYS_SELECT_H
115 #if !@HAVE_SYS_SELECT_H@
116 /* A platform that lacks <sys/select.h>. */
117 /* Get the 'struct timeval' and 'fd_set' types and the FD_* macros
118 on most platforms. */
119 # include <sys/time.h>
120 /* On HP-UX 11, <sys/time.h> provides an FD_ZERO implementation
121 that relies on memset(), but without including <string.h>. */
122 # if defined __hpux
123 # include <string.h>
124 # endif
125 /* On native Windows platforms:
126 Get the 'fd_set' type.
127 Get the close() declaration before we override it. */
128 # if @HAVE_WINSOCK2_H@
129 # if !defined _GL_INCLUDING_WINSOCK2_H
130 # define _GL_INCLUDING_WINSOCK2_H
131 # include <winsock2.h>
132 # undef _GL_INCLUDING_WINSOCK2_H
133 # endif
134 # include <io.h>
135 # endif
136 #endif
138 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
140 /* The definition of _GL_WARN_ON_USE is copied here. */
143 /* Fix some definitions from <winsock2.h>. */
145 #if @HAVE_WINSOCK2_H@
147 # if !GNULIB_defined_rpl_fd_isset
149 /* Re-define FD_ISSET to avoid a WSA call while we are not using
150 network sockets. */
151 static int
152 rpl_fd_isset (SOCKET fd, fd_set * set)
154 u_int i;
155 if (set == NULL)
156 return 0;
158 for (i = 0; i < set->fd_count; i++)
159 if (set->fd_array[i] == fd)
160 return 1;
162 return 0;
165 # define GNULIB_defined_rpl_fd_isset 1
166 # endif
168 # undef FD_ISSET
169 # define FD_ISSET(fd, set) rpl_fd_isset(fd, set)
171 #endif
173 /* Hide some function declarations from <winsock2.h>. */
175 #if @HAVE_WINSOCK2_H@
176 # if !defined _@GUARD_PREFIX@_UNISTD_H
177 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
178 # undef close
179 # define close close_used_without_including_unistd_h
180 # else
181 _GL_WARN_ON_USE (close,
182 "close() used without including <unistd.h>");
183 # endif
184 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
185 # undef gethostname
186 # define gethostname gethostname_used_without_including_unistd_h
187 # else
188 _GL_WARN_ON_USE (gethostname,
189 "gethostname() used without including <unistd.h>");
190 # endif
191 # endif
192 # if !defined _@GUARD_PREFIX@_SYS_SOCKET_H
193 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
194 # undef socket
195 # define socket socket_used_without_including_sys_socket_h
196 # undef connect
197 # define connect connect_used_without_including_sys_socket_h
198 # undef accept
199 # define accept accept_used_without_including_sys_socket_h
200 # undef bind
201 # define bind bind_used_without_including_sys_socket_h
202 # undef getpeername
203 # define getpeername getpeername_used_without_including_sys_socket_h
204 # undef getsockname
205 # define getsockname getsockname_used_without_including_sys_socket_h
206 # undef getsockopt
207 # define getsockopt getsockopt_used_without_including_sys_socket_h
208 # undef listen
209 # define listen listen_used_without_including_sys_socket_h
210 # undef recv
211 # define recv recv_used_without_including_sys_socket_h
212 # undef send
213 # define send send_used_without_including_sys_socket_h
214 # undef recvfrom
215 # define recvfrom recvfrom_used_without_including_sys_socket_h
216 # undef sendto
217 # define sendto sendto_used_without_including_sys_socket_h
218 # undef setsockopt
219 # define setsockopt setsockopt_used_without_including_sys_socket_h
220 # undef shutdown
221 # define shutdown shutdown_used_without_including_sys_socket_h
222 # else
223 _GL_WARN_ON_USE (socket,
224 "socket() used without including <sys/socket.h>");
225 _GL_WARN_ON_USE (connect,
226 "connect() used without including <sys/socket.h>");
227 _GL_WARN_ON_USE (accept,
228 "accept() used without including <sys/socket.h>");
229 _GL_WARN_ON_USE (bind,
230 "bind() used without including <sys/socket.h>");
231 _GL_WARN_ON_USE (getpeername,
232 "getpeername() used without including <sys/socket.h>");
233 _GL_WARN_ON_USE (getsockname,
234 "getsockname() used without including <sys/socket.h>");
235 _GL_WARN_ON_USE (getsockopt,
236 "getsockopt() used without including <sys/socket.h>");
237 _GL_WARN_ON_USE (listen,
238 "listen() used without including <sys/socket.h>");
239 _GL_WARN_ON_USE (recv,
240 "recv() used without including <sys/socket.h>");
241 _GL_WARN_ON_USE (send,
242 "send() used without including <sys/socket.h>");
243 _GL_WARN_ON_USE (recvfrom,
244 "recvfrom() used without including <sys/socket.h>");
245 _GL_WARN_ON_USE (sendto,
246 "sendto() used without including <sys/socket.h>");
247 _GL_WARN_ON_USE (setsockopt,
248 "setsockopt() used without including <sys/socket.h>");
249 _GL_WARN_ON_USE (shutdown,
250 "shutdown() used without including <sys/socket.h>");
251 # endif
252 # endif
253 #endif
256 #if @GNULIB_PSELECT@
257 # if @REPLACE_PSELECT@
258 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
259 # undef pselect
260 # define pselect rpl_pselect
261 # endif
262 _GL_FUNCDECL_RPL (pselect, int,
263 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
264 struct timespec const *restrict, const sigset_t *restrict));
265 _GL_CXXALIAS_RPL (pselect, int,
266 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
267 struct timespec const *restrict, const sigset_t *restrict));
268 # else
269 # if !@HAVE_PSELECT@
270 _GL_FUNCDECL_SYS (pselect, int,
271 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
272 struct timespec const *restrict, const sigset_t *restrict));
273 # endif
274 _GL_CXXALIAS_SYS (pselect, int,
275 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
276 struct timespec const *restrict, const sigset_t *restrict));
277 # endif
278 _GL_CXXALIASWARN (pselect);
279 #elif defined GNULIB_POSIXCHECK
280 # undef pselect
281 # if HAVE_RAW_DECL_PSELECT
282 _GL_WARN_ON_USE (pselect, "pselect is not portable - "
283 "use gnulib module pselect for portability");
284 # endif
285 #endif
287 #if @GNULIB_SELECT@
288 # if @REPLACE_SELECT@
289 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
290 # undef select
291 # define select rpl_select
292 # endif
293 _GL_FUNCDECL_RPL (select, int,
294 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
295 struct timeval *restrict));
296 _GL_CXXALIAS_RPL (select, int,
297 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
298 struct timeval *restrict));
299 # else
300 _GL_CXXALIAS_SYS (select, int,
301 (int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
302 struct timeval *restrict));
303 # endif
304 _GL_CXXALIASWARN (select);
305 #elif @HAVE_WINSOCK2_H@
306 # undef select
307 # define select select_used_without_requesting_gnulib_module_select
308 #elif defined GNULIB_POSIXCHECK
309 # undef select
310 # if HAVE_RAW_DECL_SELECT
311 _GL_WARN_ON_USE (select, "select is not always POSIX compliant - "
312 "use gnulib module select for portability");
313 # endif
314 #endif
317 #endif /* _@GUARD_PREFIX@_SYS_SELECT_H */
318 #endif /* _@GUARD_PREFIX@_SYS_SELECT_H */
319 #endif /* OSF/1 */