
In some cases, reparenting a window with its frame may fail; this seems to happen especially during initialization of a window that may be unmapped and re-mapped quickly and multiple times. If this happens, we're never going to receive a remove event on the stack tracker and so we may end up adding it twice to the list of the windows to synchronize with the compositor, breaking its assumption that the stack list is unique, and eventually leading to a crash because we do not end up removing all the instances of a window on its destruction. In particular we may end up in this situation: Syncing Window 10485927: 0x555558863540 (actual xid is 10485927), user time is 10485928 frame is 0x5555588715c0, frame xid 6291591 Syncing Window 14680081: 0x5555588664b0 (actual xid is 14680081), user time is 14680082 frame is 0x555558871d80, frame xid 6291595 Syncing Window 6291460: 0x55555796dc80 (actual xid is 10485763), user time is 10485764 frame is 0x555557a6f630, frame xid 6291460 Syncing Window 6291465: 0x555557a68af0 (actual xid is 14680067), user time is 14680068 frame is 0x555557a73e80, frame xid 6291465 Syncing Window 6291509: 0x555557f9d830 (actual xid is 8388623), user time is 0 frame is 0x555557fac780, frame xid 6291509 Syncing Window 6291586: 0x5555586e1690 (actual xid is 4194363), user time is 0 frame is 0x55555886e550, frame xid 6291586 Syncing Window 6291591: 0x555558863540 (actual xid is 10485927), user time is 10485928 frame is 0x5555588715c0, frame xid 6291591 Where the same meta window 0x555558863540 is added twice because that's both mapped by the window itself (10485927) and by its frame (6291591). This happens because for historical reasons the xids hash table managed by the x11-display maps both the X11 windows, their frames and their user time windows as the meta-window, and so if we don't filter out them properly we end up duplicating the entries in the compositor list. Such duplicates finally end up making mutter to crash in meta_compositor_sync_stack() because we could end up trying to access to an invalid window, given its actor has been destroyed but not all the instances have been removed from the compositor windows list: 0x00007ffff71059 in meta_compositor_sync_stack (compositor=0x555555b8, stack=0x555558701b80) at ../../mutter/src/compositor/compositor.c:773 773 if ((old_window->hidden || old_window->unmanaging) && (gdb) print old_window $1 = (MetaWindow *) 0x0 So, in order to prevent this, check that XReparentWindow does not fail, and in case of failure, reset the window state to the one it had before we failed and more importantly, remove the association between the frame X11 window and the MetaWindow, since this is not true anymore and so that at the next stack synchronization there won't be any meta window associated to that frame XID (unless there aren't further stack changes impacting on that). Without this we would have instead waited for the remove event that we predicted, but that could never happen because no ReparentNotify is emitted in such case. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3732>
Mutter
Mutter is a Wayland display server and X11 window manager and compositor library.
When used as a Wayland display server, it runs on top of KMS and libinput. It implements the compositor side of the Wayland core protocol as well as various protocol extensions. It also has functionality related to running X11 applications using Xwayland.
When used on top of Xorg it acts as a X11 window manager and compositing manager.
It contains functionality related to, among other things, window management, window compositing, focus tracking, workspace management, keybindings and monitor configuration.
Internally it uses a fork of Cogl, a hardware acceleration abstraction library used to simplify usage of OpenGL pipelines, as well as a fork of Clutter, a scene graph and user interface toolkit.
Mutter is used by, for example, GNOME Shell, the GNOME core user interface, and by Gala, elementary OS's window manager. It can also be run standalone, using the command "mutter", but just running plain mutter is only intended for debugging purposes.
Contributing
To contribute, open merge requests at https://gitlab.gnome.org/GNOME/mutter.
It can be useful to first look at the GNOME Handbook and the documentation and API references below first.
Documentation
- Coding style and conventions
- Git conventions
- Code overview
- Building and Running
- Debugging
- Monitor configuration
API Reference
- Meta: https://mutter.gnome.org/meta/
- Clutter: https://mutter.gnome.org/clutter/
- Cally: https://mutter.gnome.org/cally/
- Cogl: https://mutter.gnome.org/cogl/
- CoglPango: https://mutter.gnome.org/cogl-pango/
- Mtk: https://mutter.gnome.org/mtk/
License
Mutter is distributed under the terms of the GNU General Public License, version 2 or later. See the COPYING file for detalis.