Low-level core library that forms the basis for projects such as GTK+ and GNOME.
Go to file
Thomas Haller cecbb25eeb gmain: fix race with waitpid() and child watcher sources
GChildWatchSource uses waitpid(), among pidfd and GetExitCodeProcess().
It thus only works for child processes which the user must ensure to
exist and not being reaped yet. Also, the user must not kill() the PID
after the child process is reaped and must not race kill() against
waitpid(). Also, the user must not call waitpid()/kill() after the child
process is reaped.

Previously, GChildWatchSource would call waitpid() already when adding
the source (g_child_watch_source_new()) and from the worker thread
(dispatch_unix_signals_unlocked()). That is racy:

- if a child watcher is attached and did not yet fire, you cannot call
  kill() on the PID without racing against the PID being reaped on the
  worker thread. That would then lead to ESRCH or even worse, killing
  the wrong process.

- if you g_source_destroy() the source that didn't fire yet, the user
  doesn't know whether the PID was reaped in the background. Any
  subsequent kill()/waitpid() may fail with ESRCH/ECHILD or even address
  the wrong process.

The race is most visible on Unix without pidfd support, because then the
process gets reaped on the worker thread or during g_child_watch_source_new().
But it's also with Windows and pidfd, because we would have waited for
the process in g_child_watch_check(), where other callbacks could fire
between reaping the process status and emitting the source's callback.

Fix all that by calling waitpid() right before dispatching the callback.
2023-05-18 11:26:33 +02:00
.gitlab-ci ci: Use Meson 1.0.0 on Windows and macOS CI builds 2023-02-16 13:34:59 +00:00
.reuse docs: Add licensing/copyright data to GVariant specification 2022-11-08 15:46:16 +00:00
docs gstring: add g_string_new_take 2023-05-16 11:27:45 +01:00
fuzzing Add fuzzing harness for g_utf8_normalize() 2023-04-14 15:50:47 +00:00
gio gmain: remove unnecessary initialization of *timeout in prepare() callbacks 2023-05-18 11:26:33 +02:00
glib gmain: fix race with waitpid() and child watcher sources 2023-05-18 11:26:33 +02:00
gmodule gmodule: Define a gmodule include dependency and use it in gio modules 2023-04-19 21:10:29 +02:00
gobject gobject_gdb.py: fix regression caused by bfbe7127d5 2023-05-15 18:04:37 +01:00
gthread meson: Add tests for generated pkg-config files 2023-04-17 14:25:52 +02:00
LICENSES Add a SPDX LicenseRef for the license historically used for tests 2022-11-02 12:34:19 +00:00
m4macros m4macros: Increment serial number of glib-2.0.m4 2021-01-27 11:55:37 +00:00
po Update Galician translation 2023-04-27 09:07:30 +00:00
subprojects meson: Don't accidentally pick up intl fallback in the first test 2022-12-31 05:13:10 +05:30
tests Convert tests/assert-msg-test* to glib/tests/assert-msg-test* 2022-06-28 11:19:21 +01:00
tools Merge branch 'valgrind-variable' into 'main' 2023-04-17 12:52:28 +00:00
.clang-format CI: Code check formating in CI 2019-11-21 14:03:01 -06:00
.dir-locals.el Add .dir-locals.el to tell Emacs users not to use tabs for C 2012-07-30 04:09:08 -04:00
.editorconfig docs: Add .editorconfig file 2021-10-28 14:47:53 +01:00
.gitignore docs: Move INSTALL.in to INSTALL.md 2022-05-11 13:02:49 +01:00
.gitlab-ci.yml ci: Disable the Coverity CI job 2023-04-26 14:30:20 +01:00
.gitmodules ci: Update git paths to reflect new GitLab URI 2022-11-02 16:49:51 +00:00
.lcovrc build: Move lcovrc file to root so it’s picked up by Meson 2022-04-28 11:57:45 +01:00
CODE_OF_CONDUCT.md docs: Add a code of conduct document 2022-05-11 12:30:58 +01:00
CONTRIBUTING.md docs: Update various broken/redirected links 2023-05-02 14:26:52 +01:00
COPYING docs: Add all used licenses in a REUSE-compatible directory 2022-05-17 17:23:34 +01:00
glib.doap Rename GTK+ to GTK (mostly comments and documentation) 2023-05-10 10:56:44 +07:00
INSTALL.md INSTALL.md,README.win32.md: Actualize links 2023-01-04 11:52:07 +02:00
meson_options.txt build: Add runtime_dir option to set runstatedir path 2022-12-02 21:48:03 +00:00
meson.build gfile: Ensure loff_t is defined on FreeBSD 2023-05-15 16:22:35 +01:00
NEWS 2.76.1 2023-03-22 11:28:01 +00:00
README.md docs: Drop section about default branch renaming from README.md 2023-03-22 12:53:05 +00:00
README.win32.md Rename GTK+ to GTK (mostly comments and documentation) 2023-05-10 10:56:44 +07:00
SECURITY.md docs: Update SECURITY to stop mentioning a deprecated mailing list 2022-12-13 19:16:35 +00:00

GLib

GLib is the low-level core library that forms the basis for projects such as GTK and GNOME. It provides data structure handling for C, portability wrappers, and interfaces for such runtime functionality as an event loop, threads, dynamic loading, and an object system.

The official download locations are: https://download.gnome.org/sources/glib

The official web site is: https://www.gtk.org/

Installation

See the file 'INSTALL.md'

Supported versions

Only the most recent unstable and stable release series are supported. All older versions are not supported upstream and may contain bugs, some of which may be exploitable security vulnerabilities.

See SECURITY.md for more details.

Documentation

API documentation is available online for GLib for the:

Discussion

If you have a question about how to use GLib, seek help on GNOMEs Discourse instance. Alternatively, ask a question on StackOverflow and tag it glib.

Reporting bugs

Bugs should be reported to the GNOME issue tracking system. You will need to create an account for yourself. You may also submit bugs by e-mail (without an account) by e-mailing incoming+gnome-glib-658-issue-@gitlab.gnome.org, but this will give you a degraded experience.

Bugs are for reporting problems in GLib itself, not for asking questions about how to use it. To ask questions, use one of our discussion forums.

In bug reports please include:

  • Information about your system. For instance:
    • What operating system and version
    • For Linux, what version of the C library
    • And anything else you think is relevant.
  • How to reproduce the bug.
    • If you can reproduce it with one of the test programs that are built in the tests/ subdirectory, that will be most convenient. Otherwise, please include a short test program that exhibits the behavior. As a last resort, you can also provide a pointer to a larger piece of software that can be downloaded.
  • If the bug was a crash, the exact text that was printed out when the crash occurred.
  • Further information such as stack traces may be useful, but is not necessary.

Contributing to GLib

Please follow the contribution guide to know how to start contributing to GLib.

Patches should be submitted as merge requests to gitlab.gnome.org. If the patch fixes an existing issue, please refer to the issue in your commit message with the following notation (for issue 123):

Closes: #123

Otherwise, create a new merge request that introduces the change. Filing a separate issue is not required.