.TH xcb_shm_attach 3  "libxcb 1.17.0" "X Version 11" "XCB Requests"
.ad l
.SH NAME
xcb_shm_attach \- Attach a System V shared memory segment.
.SH SYNOPSIS
.hy 0
.B #include <xcb/shm.h>
.SS Request function
.HP
xcb_void_cookie_t \fBxcb_shm_attach\fP(xcb_connection_t\ *\fIconn\fP, xcb_shm_seg_t\ \fIshmseg\fP, uint32_t\ \fIshmid\fP, uint8_t\ \fIread_only\fP);
.br
.hy 1
.SH REQUEST ARGUMENTS
.IP \fIconn\fP 1i
The XCB connection to X11.
.IP \fIshmseg\fP 1i
A shared memory segment ID created with xcb_generate_id().
.IP \fIshmid\fP 1i
The System V shared memory segment the server should map.
.IP \fIread_only\fP 1i
True if the segment shall be mapped read only by the X11 server, otherwise false.
.SH DESCRIPTION
Attach a System V shared memory segment to the server.  This will fail unless
the server has permission to map the segment.  The client may destroy the segment
as soon as it receives a XCB_SHM_COMPLETION event with the shmseg value in this
request and with the appropriate serial number.
.SH RETURN VALUE
Returns an \fIxcb_void_cookie_t\fP. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with \fIxcb_request_check\fP instead, use \fIxcb_shm_attach_checked\fP. See \fBxcb-requests(3)\fP for details.
.SH ERRORS
This request does never generate any errors.
.SH SEE ALSO
.BR xcb-requests (3)
.SH AUTHOR
Generated from shm.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.