[Wayland-bugs] [Bug 83430] New: Document client threading and event queues

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=83430

          Priority: medium
            Bug ID: 83430
          Assignee: wayland-bugs at lists.freedesktop.org
            Blocks: 83429
           Summary: Document client threading and event queues
          Severity: enhancement
    Classification: Unclassified
                OS: All
          Reporter: ppaalanen at gmail.com
          Hardware: All
            Status: NEW
           Version: unspecified
         Component: wayland
           Product: Wayland

Write a chapter to the "big docs" about client side threading and event queues.

- dispatching a queue from more than one thread is a bad idea; explain why
- therefore, every thread that needs to dispatch should have its own queue
- also every piece of software that needs to dispatch in a controlled context
needs its own queue (e.g. libEGL)
- the client API is not multi-thread-dispatch-safe (wl_display_roundtrip)
- a new wl_proxy inherits its factory's queue
- destroying a queue while wl_proxies on it exist is a mistake and may lead to
use-after-free when events on that wl_proxy arrive
- wl_display contains the default queue

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/wayland-bugs/attachments/20140903/7bba6601/attachment.html>