Support handing off socket write permission to external code.
authorJosh Triplett <josh@freedesktop.org>
Mon, 17 Mar 2008 06:16:31 +0000 (23:16 -0700)
committerJamey Sharp <jamey@minilop.net>
Wed, 29 Oct 2008 22:40:41 +0000 (15:40 -0700)
commitfa452cc9b2bb69fa0603dfd97e00e540b6b52840
tree0bdcf268ea0c55b37e595fe1d7ee3a87debda9af
parentbaff35a04b0e8d21821850a405a550d86a8aeb6f
Support handing off socket write permission to external code.

Libraries like Xlib, some XCB language bindings, and potentially others
have a common problem: they want to share the X connection with XCB. This
requires coordination of request sequence numbers.  Previously, XCB had an
Xlib-specific lock, and allowed Xlib to block XCB from making requests.
Now we've replaced that lock with a handoff mechanism, xcb_take_socket,
allowing external code to ask XCB for permission to take over the write
side of the socket and send raw data with xcb_writev.  The caller of
xcb_take_socket must supply a callback which XCB can call when it wants
the write side of the socket back to make a request.  This callback
synchronizes with the external socket owner, flushes any output queues if
appropriate, and then returns the sequence number of the last request sent
over the socket.

Commit by Josh Triplett and Jamey Sharp.
Handoff mechanism inspired by Keith Packard.
src/Makefile.am
src/xcb_in.c
src/xcb_out.c
src/xcbext.h
src/xcbint.h