Coverage Report

Created: 2025-07-18 06:26

/src/glib/glib/gpoll.c
Line
Count
Source (jump to first uncovered line)
1
/* GLIB - Library of useful routines for C programming
2
 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
3
 *
4
 * gpoll.c: poll(2) abstraction
5
 * Copyright 1998 Owen Taylor
6
 * Copyright 2008 Red Hat, Inc.
7
 *
8
 * This library is free software; you can redistribute it and/or
9
 * modify it under the terms of the GNU Lesser General Public
10
 * License as published by the Free Software Foundation; either
11
 * version 2.1 of the License, or (at your option) any later version.
12
 *
13
 * This library is distributed in the hope that it will be useful,
14
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16
 * Lesser General Public License for more details.
17
 *
18
 * You should have received a copy of the GNU Lesser General Public
19
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
20
 */
21
22
/*
23
 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
24
 * file for a list of people on the GLib Team.  See the ChangeLog
25
 * files for a list of changes.  These files are distributed with
26
 * GLib at ftp://ftp.gtk.org/pub/gtk/.
27
 */
28
29
/*
30
 * MT safe
31
 */
32
33
#include "config.h"
34
#include "glibconfig.h"
35
#include "giochannel.h"
36
37
/* Uncomment the next line (and the corresponding line in gmain.c) to
38
 * enable debugging printouts if the environment variable
39
 * G_MAIN_POLL_DEBUG is set to some value.
40
 */
41
/* #define G_MAIN_POLL_DEBUG */
42
43
#ifdef _WIN32
44
/* Always enable debugging printout on Windows, as it is more often
45
 * needed there...
46
 */
47
#define G_MAIN_POLL_DEBUG
48
#endif
49
50
#include <sys/types.h>
51
#include <time.h>
52
#include <stdlib.h>
53
#ifdef HAVE_SYS_TIME_H
54
#include <sys/time.h>
55
#endif /* HAVE_SYS_TIME_H */
56
#ifdef HAVE_POLL
57
#  include <poll.h>
58
59
/* The poll() emulation on OS/X doesn't handle fds=NULL, nfds=0,
60
 * so we prefer our own poll emulation.
61
 */
62
#if defined(_POLL_EMUL_H_) || defined(BROKEN_POLL)
63
#undef HAVE_POLL
64
#endif
65
66
#endif /* GLIB_HAVE_SYS_POLL_H */
67
#ifdef G_OS_UNIX
68
#include <unistd.h>
69
#endif /* G_OS_UNIX */
70
#include <errno.h>
71
72
#ifdef G_OS_WIN32
73
#define STRICT
74
#include <windows.h>
75
#include <process.h>
76
#endif /* G_OS_WIN32 */
77
78
#include "gpoll.h"
79
80
#ifdef G_OS_WIN32
81
#include "gprintf.h"
82
#endif
83
84
#ifdef G_MAIN_POLL_DEBUG
85
extern gboolean _g_main_poll_debug;
86
#endif
87
88
#ifdef HAVE_POLL
89
90
/**
91
 * g_poll:
92
 * @fds: file descriptors to poll
93
 * @nfds: the number of file descriptors in @fds
94
 * @timeout: amount of time to wait, in milliseconds, or -1 to wait forever
95
 *
96
 * Polls @fds, as with the poll() system call, but portably. (On
97
 * systems that don't have poll(), it is emulated using select().)
98
 * This is used internally by #GMainContext, but it can be called
99
 * directly if you need to block until a file descriptor is ready, but
100
 * don't want to run the full main loop.
101
 *
102
 * Each element of @fds is a #GPollFD describing a single file
103
 * descriptor to poll. The @fd field indicates the file descriptor,
104
 * and the @events field indicates the events to poll for. On return,
105
 * the @revents fields will be filled with the events that actually
106
 * occurred.
107
 *
108
 * On POSIX systems, the file descriptors in @fds can be any sort of
109
 * file descriptor, but the situation is much more complicated on
110
 * Windows. If you need to use g_poll() in code that has to run on
111
 * Windows, the easiest solution is to construct all of your
112
 * #GPollFDs with g_io_channel_win32_make_pollfd().
113
 *
114
 * Returns: the number of entries in @fds whose @revents fields
115
 * were filled in, or 0 if the operation timed out, or -1 on error or
116
 * if the call was interrupted.
117
 *
118
 * Since: 2.20
119
 **/
120
gint
121
g_poll (GPollFD *fds,
122
  guint    nfds,
123
  gint     timeout)
124
0
{
125
0
  return poll ((struct pollfd *)fds, nfds, timeout);
126
0
}
127
128
#else /* !HAVE_POLL */
129
130
#ifdef G_OS_WIN32
131
132
static int
133
poll_rest (GPollFD *msg_fd,
134
           GPollFD *stop_fd,
135
           HANDLE  *handles,
136
           GPollFD *handle_to_fd[],
137
           gint     nhandles,
138
           gint     timeout_ms)
139
{
140
  DWORD ready;
141
  GPollFD *f;
142
  int recursed_result;
143
144
  if (msg_fd != NULL)
145
    {
146
      /* Wait for either messages or handles
147
       * -> Use MsgWaitForMultipleObjectsEx
148
       */
149
      if (_g_main_poll_debug)
150
  g_print ("  MsgWaitForMultipleObjectsEx(%d, %d)\n", nhandles, timeout_ms);
151
152
      ready = MsgWaitForMultipleObjectsEx (nhandles, handles, timeout_ms,
153
             QS_ALLINPUT, MWMO_ALERTABLE);
154
155
      if (ready == WAIT_FAILED)
156
  {
157
    gchar *emsg = g_win32_error_message (GetLastError ());
158
    g_warning ("MsgWaitForMultipleObjectsEx failed: %s", emsg);
159
    g_free (emsg);
160
  }
161
    }
162
  else if (nhandles == 0)
163
    {
164
      /* No handles to wait for, just the timeout */
165
      if (timeout_ms == INFINITE)
166
  ready = WAIT_FAILED;
167
      else
168
        {
169
          /* Wait for the current process to die, more efficient than SleepEx(). */
170
          WaitForSingleObjectEx (GetCurrentProcess (), timeout_ms, TRUE);
171
          ready = WAIT_TIMEOUT;
172
        }
173
    }
174
  else
175
    {
176
      /* Wait for just handles
177
       * -> Use WaitForMultipleObjectsEx
178
       */
179
      if (_g_main_poll_debug)
180
  g_print ("  WaitForMultipleObjectsEx(%d, %d)\n", nhandles, timeout_ms);
181
182
      ready = WaitForMultipleObjectsEx (nhandles, handles, FALSE, timeout_ms, TRUE);
183
      if (ready == WAIT_FAILED)
184
  {
185
    gchar *emsg = g_win32_error_message (GetLastError ());
186
    g_warning ("WaitForMultipleObjectsEx failed: %s", emsg);
187
    g_free (emsg);
188
  }
189
    }
190
191
  if (_g_main_poll_debug)
192
    g_print ("  wait returns %ld%s\n",
193
       ready,
194
       (ready == WAIT_FAILED ? " (WAIT_FAILED)" :
195
        (ready == WAIT_TIMEOUT ? " (WAIT_TIMEOUT)" :
196
         (msg_fd != NULL && ready == WAIT_OBJECT_0 + nhandles ? " (msg)" : ""))));
197
198
  if (ready == WAIT_FAILED)
199
    return -1;
200
  else if (ready == WAIT_TIMEOUT ||
201
     ready == WAIT_IO_COMPLETION)
202
    return 0;
203
  else if (msg_fd != NULL && ready == WAIT_OBJECT_0 + nhandles)
204
    {
205
      msg_fd->revents |= G_IO_IN;
206
207
      /* If we have a timeout, or no handles to poll, be satisfied
208
       * with just noticing we have messages waiting.
209
       */
210
      if (timeout_ms != 0 || nhandles == 0)
211
  return 1;
212
213
      /* If no timeout and handles to poll, recurse to poll them,
214
       * too.
215
       */
216
      recursed_result = poll_rest (NULL, stop_fd, handles, handle_to_fd, nhandles, 0);
217
      return (recursed_result == -1) ? -1 : 1 + recursed_result;
218
    }
219
  else if (ready >= WAIT_OBJECT_0 && ready < WAIT_OBJECT_0 + nhandles)
220
    {
221
      int retval;
222
223
      f = handle_to_fd[ready - WAIT_OBJECT_0];
224
      f->revents = f->events;
225
      if (_g_main_poll_debug)
226
        g_print ("  got event %p\n", (HANDLE) f->fd);
227
228
      /* Do not count the stop_fd */
229
      retval = (f != stop_fd) ? 1 : 0;
230
231
      /* If no timeout and polling several handles, recurse to poll
232
       * the rest of them.
233
       */
234
      if (timeout_ms == 0 && nhandles > 1)
235
        {
236
          /* Poll the handles with index > ready */
237
          HANDLE *shorter_handles;
238
          GPollFD **shorter_handle_to_fd;
239
          gint shorter_nhandles;
240
241
          shorter_handles = &handles[ready - WAIT_OBJECT_0 + 1];
242
          shorter_handle_to_fd = &handle_to_fd[ready - WAIT_OBJECT_0 + 1];
243
          shorter_nhandles = nhandles - (ready - WAIT_OBJECT_0 + 1);
244
245
          recursed_result = poll_rest (NULL, stop_fd, shorter_handles, shorter_handle_to_fd, shorter_nhandles, 0);
246
          return (recursed_result == -1) ? -1 : retval + recursed_result;
247
        }
248
      return retval;
249
    }
250
251
  return 0;
252
}
253
254
typedef struct
255
{
256
  HANDLE handles[MAXIMUM_WAIT_OBJECTS];
257
  GPollFD *handle_to_fd[MAXIMUM_WAIT_OBJECTS];
258
  GPollFD *msg_fd;
259
  GPollFD *stop_fd;
260
  gint nhandles;
261
  gint timeout_ms;
262
} GWin32PollThreadData;
263
264
static gint
265
poll_single_thread (GWin32PollThreadData *data)
266
{
267
  int retval;
268
269
  /* Polling for several things? */
270
  if (data->nhandles > 1 || (data->nhandles > 0 && data->msg_fd != NULL))
271
    {
272
      /* First check if one or several of them are immediately
273
       * available
274
       */
275
      retval = poll_rest (data->msg_fd, data->stop_fd, data->handles, data->handle_to_fd, data->nhandles, 0);
276
277
      /* If not, and we have a significant timeout, poll again with
278
       * timeout then. Note that this will return indication for only
279
       * one event, or only for messages.
280
       */
281
      if (retval == 0 && (data->timeout_ms == INFINITE || data->timeout_ms > 0))
282
        retval = poll_rest (data->msg_fd, data->stop_fd, data->handles, data->handle_to_fd, data->nhandles, data->timeout_ms);
283
    }
284
  else
285
    {
286
      /* Just polling for one thing, so no need to check first if
287
       * available immediately
288
       */
289
      retval = poll_rest (data->msg_fd, data->stop_fd, data->handles, data->handle_to_fd, data->nhandles, data->timeout_ms);
290
    }
291
292
  return retval;
293
}
294
295
static void
296
fill_poll_thread_data (GPollFD              *fds,
297
                       guint                 nfds,
298
                       gint                  timeout_ms,
299
                       GPollFD              *stop_fd,
300
                       GWin32PollThreadData *data)
301
{
302
  GPollFD *f;
303
304
  data->timeout_ms = timeout_ms;
305
306
  if (stop_fd != NULL)
307
    {
308
      if (_g_main_poll_debug)
309
        g_print (" Stop FD: %p", (HANDLE) stop_fd->fd);
310
311
      g_assert (data->nhandles < MAXIMUM_WAIT_OBJECTS);
312
313
      data->stop_fd = stop_fd;
314
      data->handle_to_fd[data->nhandles] = stop_fd;
315
      data->handles[data->nhandles++] = (HANDLE) stop_fd->fd;
316
    }
317
318
  for (f = fds; f < &fds[nfds]; ++f)
319
    {
320
      if ((data->nhandles == MAXIMUM_WAIT_OBJECTS) ||
321
          (data->msg_fd != NULL && (data->nhandles == MAXIMUM_WAIT_OBJECTS - 1)))
322
        {
323
          g_warning ("Too many handles to wait for!");
324
          break;
325
        }
326
327
      if (f->fd == G_WIN32_MSG_HANDLE && (f->events & G_IO_IN))
328
        {
329
          if (_g_main_poll_debug && data->msg_fd == NULL)
330
            g_print (" MSG");
331
          data->msg_fd = f;
332
        }
333
      else if (f->fd > 0)
334
        {
335
          if (_g_main_poll_debug)
336
            g_print (" %p", (HANDLE) f->fd);
337
          data->handle_to_fd[data->nhandles] = f;
338
          data->handles[data->nhandles++] = (HANDLE) f->fd;
339
        }
340
341
      f->revents = 0;
342
    }
343
}
344
345
static guint __stdcall
346
poll_thread_run (gpointer user_data)
347
{
348
  GWin32PollThreadData *data = user_data;
349
350
  /* Docs say that it is safer to call _endthreadex by our own:
351
   * https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/endthread-endthreadex
352
   */
353
  _endthreadex (poll_single_thread (data));
354
355
  g_assert_not_reached ();
356
357
  return 0;
358
}
359
360
/* One slot for a possible msg object or the stop event */
361
#define MAXIMUM_WAIT_OBJECTS_PER_THREAD (MAXIMUM_WAIT_OBJECTS - 1)
362
363
gint
364
g_poll (GPollFD *fds,
365
  guint    nfds,
366
  gint     timeout)
367
{
368
  guint nthreads, threads_remain;
369
  HANDLE thread_handles[MAXIMUM_WAIT_OBJECTS];
370
  GWin32PollThreadData *threads_data;
371
  GPollFD stop_event = { 0, };
372
  GPollFD *f;
373
  guint i, fds_idx = 0;
374
  DWORD ready;
375
  DWORD thread_retval;
376
  int retval;
377
  GPollFD *msg_fd = NULL;
378
379
  if (timeout == -1)
380
    timeout = INFINITE;
381
382
  /* Simple case without extra threads */
383
  if (nfds <= MAXIMUM_WAIT_OBJECTS)
384
    {
385
      GWin32PollThreadData data = { 0, };
386
387
      if (_g_main_poll_debug)
388
        g_print ("g_poll: waiting for");
389
390
      fill_poll_thread_data (fds, nfds, timeout, NULL, &data);
391
392
      if (_g_main_poll_debug)
393
        g_print ("\n");
394
395
      retval = poll_single_thread (&data);
396
      if (retval == -1)
397
        for (f = fds; f < &fds[nfds]; ++f)
398
          f->revents = 0;
399
400
      return retval;
401
    }
402
403
  if (_g_main_poll_debug)
404
    g_print ("g_poll: polling with threads\n");
405
406
  nthreads = nfds / MAXIMUM_WAIT_OBJECTS_PER_THREAD;
407
  threads_remain = nfds % MAXIMUM_WAIT_OBJECTS_PER_THREAD;
408
  if (threads_remain > 0)
409
    nthreads++;
410
411
  if (nthreads > MAXIMUM_WAIT_OBJECTS_PER_THREAD)
412
    {
413
      g_warning ("Too many handles to wait for in threads!");
414
      nthreads = MAXIMUM_WAIT_OBJECTS_PER_THREAD;
415
    }
416
417
#if GLIB_SIZEOF_VOID_P == 8
418
  stop_event.fd = (gint64)CreateEventW (NULL, TRUE, FALSE, NULL);
419
#else
420
  stop_event.fd = (gint)CreateEventW (NULL, TRUE, FALSE, NULL);
421
#endif
422
  stop_event.events = G_IO_IN;
423
424
  threads_data = g_new0 (GWin32PollThreadData, nthreads);
425
  for (i = 0; i < nthreads; i++)
426
    {
427
      guint thread_fds;
428
      guint ignore;
429
430
      if (i == (nthreads - 1) && threads_remain > 0)
431
        thread_fds = threads_remain;
432
      else
433
        thread_fds = MAXIMUM_WAIT_OBJECTS_PER_THREAD;
434
435
      fill_poll_thread_data (fds + fds_idx, thread_fds, timeout, &stop_event, &threads_data[i]);
436
      fds_idx += thread_fds;
437
438
      /* We must poll for messages from the same thread, so poll it along with the threads */
439
      if (threads_data[i].msg_fd != NULL)
440
        {
441
          msg_fd = threads_data[i].msg_fd;
442
          threads_data[i].msg_fd = NULL;
443
        }
444
445
      thread_handles[i] = (HANDLE) _beginthreadex (NULL, 0, poll_thread_run, &threads_data[i], 0, &ignore);
446
    }
447
448
  /* Wait for at least one thread to return */
449
  if (msg_fd != NULL)
450
    ready = MsgWaitForMultipleObjectsEx (nthreads, thread_handles, timeout,
451
                                         QS_ALLINPUT, MWMO_ALERTABLE);
452
  else
453
    ready = WaitForMultipleObjects (nthreads, thread_handles, FALSE, timeout);
454
455
  /* Signal the stop in case any of the threads did not stop yet */
456
  if (!SetEvent ((HANDLE)stop_event.fd))
457
    {
458
      gchar *emsg = g_win32_error_message (GetLastError ());
459
      g_warning ("gpoll: failed to signal the stop event: %s", emsg);
460
      g_free (emsg);
461
    }
462
463
  /* Wait for the rest of the threads to finish */
464
  WaitForMultipleObjects (nthreads, thread_handles, TRUE, INFINITE);
465
466
  /* The return value of all the threads give us all the fds that changed state */
467
  retval = 0;
468
  if (msg_fd != NULL && ready == WAIT_OBJECT_0 + nthreads)
469
    {
470
      msg_fd->revents |= G_IO_IN;
471
      retval = 1;
472
    }
473
474
  for (i = 0; i < nthreads; i++)
475
    {
476
      if (GetExitCodeThread (thread_handles[i], &thread_retval))
477
        retval = retval == -1 ? -1 : thread_retval == -1 ? -1 : retval + thread_retval;
478
479
      CloseHandle (thread_handles[i]);
480
    }
481
482
  if (retval == -1)
483
    for (f = fds; f < &fds[nfds]; ++f)
484
      f->revents = 0;
485
486
  g_free (threads_data);
487
  CloseHandle ((HANDLE)stop_event.fd);
488
489
  return retval;
490
}
491
492
#else  /* !G_OS_WIN32 */
493
494
/* The following implementation of poll() comes from the GNU C Library.
495
 * Copyright (C) 1994, 1996, 1997 Free Software Foundation, Inc.
496
 */
497
498
#include <string.h> /* for bzero on BSD systems */
499
500
#ifdef HAVE_SYS_SELECT_H
501
#include <sys/select.h>
502
#endif /* HAVE_SYS_SELECT_H */
503
504
gint
505
g_poll (GPollFD *fds,
506
  guint    nfds,
507
  gint     timeout)
508
{
509
  struct timeval tv;
510
  fd_set rset, wset, xset;
511
  GPollFD *f;
512
  int ready;
513
  int maxfd = 0;
514
515
  FD_ZERO (&rset);
516
  FD_ZERO (&wset);
517
  FD_ZERO (&xset);
518
519
  for (f = fds; f < &fds[nfds]; ++f)
520
    if (f->fd >= 0)
521
      {
522
  if (f->events & G_IO_IN)
523
    FD_SET (f->fd, &rset);
524
  if (f->events & G_IO_OUT)
525
    FD_SET (f->fd, &wset);
526
  if (f->events & G_IO_PRI)
527
    FD_SET (f->fd, &xset);
528
  if (f->fd > maxfd && (f->events & (G_IO_IN|G_IO_OUT|G_IO_PRI)))
529
    maxfd = f->fd;
530
      }
531
532
  tv.tv_sec = timeout / 1000;
533
  tv.tv_usec = (timeout % 1000) * 1000;
534
535
  ready = select (maxfd + 1, &rset, &wset, &xset,
536
      timeout == -1 ? NULL : &tv);
537
  if (ready > 0)
538
    for (f = fds; f < &fds[nfds]; ++f)
539
      {
540
  f->revents = 0;
541
  if (f->fd >= 0)
542
    {
543
      if (FD_ISSET (f->fd, &rset))
544
        f->revents |= G_IO_IN;
545
      if (FD_ISSET (f->fd, &wset))
546
        f->revents |= G_IO_OUT;
547
      if (FD_ISSET (f->fd, &xset))
548
        f->revents |= G_IO_PRI;
549
    }
550
      }
551
552
  return ready;
553
}
554
555
#endif /* !G_OS_WIN32 */
556
557
#endif  /* !HAVE_POLL */