mirror of
https://github.com/jart/cosmopolitan.git
synced 2025-02-07 15:03:34 +00:00
2ec413b5a9
poll() and select() now delegate to ppoll() and pselect() for assurances
that both polyfill implementations are correct and well-tested. Poll now
polyfills XNU and BSD quirks re: the hanndling of POLLNVAL and the other
similar status flags. This change resolves a misunderstanding concerning
how select(exceptfds) is intended to map to POLPRI. We now use E2BIG for
bouncing requests that exceed the 64 handle limit on Windows. With pipes
and consoles on Windows our poll impl will now report POLLHUP correctly.
Issues with Windows path generation have been fixed. For example, it was
problematic on Windows to say: posix_spawn_file_actions_addchdir_np("/")
due to the need to un-UNC paths in some additional places. Calling fstat
on UNC style volume path handles will now work. posix_spawn now supports
simulating the opening of /dev/null and other special paths on Windows.
Cosmopolitan no longer defines epoll(). I think wepoll is a nice project
for using epoll() on Windows socket handles. However we need generalized
file descriptor support to make epoll() for Windows work well enough for
inclusion in a C library. It's also not worth having epoll() if we can't
get it to work on XNU and BSD OSes which provide different abstractions.
Even epoll() on Linux isn't that great of an abstraction since it's full
of footguns. Last time I tried to get it to be useful I had little luck.
Considering how long it took to get poll() and select() to be consistent
across platforms, we really have no business claiming to have epoll too.
While it'd be nice to have fully implemented, the only software that use
epoll() are event i/o libraries used by things like nodejs. Event i/o is
not the best paradigm for handling i/o; threads make so much more sense.
80 lines
4.5 KiB
C
80 lines
4.5 KiB
C
/*-*- mode:c;indent-tabs-mode:nil;c-basic-offset:2;tab-width:8;coding:utf-8 -*-│
|
||
│ vi: set et ft=c ts=2 sts=2 sw=2 fenc=utf-8 :vi │
|
||
╞══════════════════════════════════════════════════════════════════════════════╡
|
||
│ Copyright 2020 Justine Alexandra Roberts Tunney │
|
||
│ │
|
||
│ Permission to use, copy, modify, and/or distribute this software for │
|
||
│ any purpose with or without fee is hereby granted, provided that the │
|
||
│ above copyright notice and this permission notice appear in all copies. │
|
||
│ │
|
||
│ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL │
|
||
│ WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED │
|
||
│ WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE │
|
||
│ AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL │
|
||
│ DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR │
|
||
│ PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER │
|
||
│ TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR │
|
||
│ PERFORMANCE OF THIS SOFTWARE. │
|
||
╚─────────────────────────────────────────────────────────────────────────────*/
|
||
#include "libc/calls/struct/timespec.h"
|
||
#include "libc/sock/struct/pollfd.h"
|
||
|
||
/**
|
||
* Checks status on multiple file descriptors at once.
|
||
*
|
||
* Servers that need to handle an unbounded number of client connections
|
||
* should just create a separate thread for each client. poll() isn't a
|
||
* scalable i/o solution on any platform.
|
||
*
|
||
* On Windows it's only possible to poll 64 file descriptors at a time.
|
||
* This is a limitation imposed by WSAPoll(). Cosmopolitan Libc's poll()
|
||
* polyfill can go higher in some cases. For example, you can actually
|
||
* poll 64 sockets and 64 pipes/terminals at the same time. Furthermore,
|
||
* elements whose fd field is set to a negative number are ignored and
|
||
* will not count against this limit.
|
||
*
|
||
* One of the use cases for poll() is to quickly check if a number of
|
||
* file descriptors are valid. The canonical way to do this is to set
|
||
* events to 0 which prevents blocking and causes only the invalid,
|
||
* hangup, and error statuses to be checked.
|
||
*
|
||
* On XNU, the POLLHUP and POLLERR statuses aren't checked unless either
|
||
* POLLIN, POLLOUT, or POLLPRI are specified in the events field. Cosmo
|
||
* will however polyfill the checking of POLLNVAL on XNU with the events
|
||
* doesn't specify any of the above i/o events.
|
||
*
|
||
* When XNU and BSD OSes report POLLHUP, they will always set POLLIN too
|
||
* when POLLIN is requested, even in cases when there isn't unread data.
|
||
*
|
||
* @param fds[𝑖].fd should be a socket, input pipe, or conosle input
|
||
* and if it's a negative number then the entry is ignored, plus
|
||
* revents will be set to zero
|
||
* @param fds[𝑖].events flags can have POLLIN, POLLOUT, POLLPRI,
|
||
* POLLRDNORM, POLLWRNORM, POLLRDBAND, POLLWRBAND as well as
|
||
* POLLERR, POLLHUP, and POLLNVAL although the latter are
|
||
* always implied (assuming fd≥0) so they're ignored here
|
||
* @param timeout_ms if 0 means don't wait and negative waits forever
|
||
* @return number of `fds` whose revents field has been set to a nonzero
|
||
* number, 0 if the timeout elapsed without events, or -1 w/ errno
|
||
* @return fds[𝑖].revents is always zero initializaed and then will
|
||
* be populated with POLL{IN,OUT,PRI,HUP,ERR,NVAL} if something
|
||
* was determined about the file descriptor
|
||
* @raise E2BIG if we exceeded the 64 socket limit on Windows
|
||
* @raise ECANCELED if thread was cancelled in masked mode
|
||
* @raise EINTR if signal was delivered
|
||
* @cancelationpoint
|
||
* @asyncsignalsafe
|
||
* @norestart
|
||
*/
|
||
int poll(struct pollfd *fds, size_t nfds, int timeout_ms) {
|
||
struct timespec ts;
|
||
struct timespec *tsp;
|
||
if (timeout_ms >= 0) {
|
||
ts.tv_sec = timeout_ms / 1000;
|
||
ts.tv_nsec = timeout_ms % 1000 * 1000000;
|
||
tsp = &ts;
|
||
} else {
|
||
tsp = 0;
|
||
}
|
||
return ppoll(fds, nfds, tsp, 0);
|
||
}
|