--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/include/xcb/shm.h	Tue Mar 18 17:55:14 2025 -0400
@@ -0,0 +1,792 @@
+/*
+ * This file generated automatically from shm.xml by c_client.py.
+ * Edit at your peril.
+ */
+
+/**
+ * @defgroup XCB_Shm_API XCB Shm API
+ * @brief Shm XCB Protocol Implementation.
+ * @{
+ **/
+
+#ifndef __SHM_H
+#define __SHM_H
+
+#include "xcb.h"
+#include "xproto.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define XCB_SHM_MAJOR_VERSION 1
+#define XCB_SHM_MINOR_VERSION 2
+
+extern xcb_extension_t xcb_shm_id;
+
+typedef uint32_t xcb_shm_seg_t;
+
+/**
+ * @brief xcb_shm_seg_iterator_t
+ **/
+typedef struct xcb_shm_seg_iterator_t {
+    xcb_shm_seg_t *data;
+    int            rem;
+    int            index;
+} xcb_shm_seg_iterator_t;
+
+/** Opcode for xcb_shm_completion. */
+#define XCB_SHM_COMPLETION 0
+
+/**
+ * @brief xcb_shm_completion_event_t
+ **/
+typedef struct xcb_shm_completion_event_t {
+    uint8_t        response_type;
+    uint8_t        pad0;
+    uint16_t       sequence;
+    xcb_drawable_t drawable;
+    uint16_t       minor_event;
+    uint8_t        major_event;
+    uint8_t        pad1;
+    xcb_shm_seg_t  shmseg;
+    uint32_t       offset;
+} xcb_shm_completion_event_t;
+
+/** Opcode for xcb_shm_bad_seg. */
+#define XCB_SHM_BAD_SEG 0
+
+typedef xcb_value_error_t xcb_shm_bad_seg_error_t;
+
+/**
+ * @brief xcb_shm_query_version_cookie_t
+ **/
+typedef struct xcb_shm_query_version_cookie_t {
+    unsigned int sequence;
+} xcb_shm_query_version_cookie_t;
+
+/** Opcode for xcb_shm_query_version. */
+#define XCB_SHM_QUERY_VERSION 0
+
+/**
+ * @brief xcb_shm_query_version_request_t
+ **/
+typedef struct xcb_shm_query_version_request_t {
+    uint8_t  major_opcode;
+    uint8_t  minor_opcode;
+    uint16_t length;
+} xcb_shm_query_version_request_t;
+
+/**
+ * @brief xcb_shm_query_version_reply_t
+ **/
+typedef struct xcb_shm_query_version_reply_t {
+    uint8_t  response_type;
+    uint8_t  shared_pixmaps;
+    uint16_t sequence;
+    uint32_t length;
+    uint16_t major_version;
+    uint16_t minor_version;
+    uint16_t uid;
+    uint16_t gid;
+    uint8_t  pixmap_format;
+    uint8_t  pad0[15];
+} xcb_shm_query_version_reply_t;
+
+/** Opcode for xcb_shm_attach. */
+#define XCB_SHM_ATTACH 1
+
+/**
+ * @brief xcb_shm_attach_request_t
+ **/
+typedef struct xcb_shm_attach_request_t {
+    uint8_t       major_opcode;
+    uint8_t       minor_opcode;
+    uint16_t      length;
+    xcb_shm_seg_t shmseg;
+    uint32_t      shmid;
+    uint8_t       read_only;
+    uint8_t       pad0[3];
+} xcb_shm_attach_request_t;
+
+/** Opcode for xcb_shm_detach. */
+#define XCB_SHM_DETACH 2
+
+/**
+ * @brief xcb_shm_detach_request_t
+ **/
+typedef struct xcb_shm_detach_request_t {
+    uint8_t       major_opcode;
+    uint8_t       minor_opcode;
+    uint16_t      length;
+    xcb_shm_seg_t shmseg;
+} xcb_shm_detach_request_t;
+
+/** Opcode for xcb_shm_put_image. */
+#define XCB_SHM_PUT_IMAGE 3
+
+/**
+ * @brief xcb_shm_put_image_request_t
+ **/
+typedef struct xcb_shm_put_image_request_t {
+    uint8_t        major_opcode;
+    uint8_t        minor_opcode;
+    uint16_t       length;
+    xcb_drawable_t drawable;
+    xcb_gcontext_t gc;
+    uint16_t       total_width;
+    uint16_t       total_height;
+    uint16_t       src_x;
+    uint16_t       src_y;
+    uint16_t       src_width;
+    uint16_t       src_height;
+    int16_t        dst_x;
+    int16_t        dst_y;
+    uint8_t        depth;
+    uint8_t        format;
+    uint8_t        send_event;
+    uint8_t        pad0;
+    xcb_shm_seg_t  shmseg;
+    uint32_t       offset;
+} xcb_shm_put_image_request_t;
+
+/**
+ * @brief xcb_shm_get_image_cookie_t
+ **/
+typedef struct xcb_shm_get_image_cookie_t {
+    unsigned int sequence;
+} xcb_shm_get_image_cookie_t;
+
+/** Opcode for xcb_shm_get_image. */
+#define XCB_SHM_GET_IMAGE 4
+
+/**
+ * @brief xcb_shm_get_image_request_t
+ **/
+typedef struct xcb_shm_get_image_request_t {
+    uint8_t        major_opcode;
+    uint8_t        minor_opcode;
+    uint16_t       length;
+    xcb_drawable_t drawable;
+    int16_t        x;
+    int16_t        y;
+    uint16_t       width;
+    uint16_t       height;
+    uint32_t       plane_mask;
+    uint8_t        format;
+    uint8_t        pad0[3];
+    xcb_shm_seg_t  shmseg;
+    uint32_t       offset;
+} xcb_shm_get_image_request_t;
+
+/**
+ * @brief xcb_shm_get_image_reply_t
+ **/
+typedef struct xcb_shm_get_image_reply_t {
+    uint8_t        response_type;
+    uint8_t        depth;
+    uint16_t       sequence;
+    uint32_t       length;
+    xcb_visualid_t visual;
+    uint32_t       size;
+} xcb_shm_get_image_reply_t;
+
+/** Opcode for xcb_shm_create_pixmap. */
+#define XCB_SHM_CREATE_PIXMAP 5
+
+/**
+ * @brief xcb_shm_create_pixmap_request_t
+ **/
+typedef struct xcb_shm_create_pixmap_request_t {
+    uint8_t        major_opcode;
+    uint8_t        minor_opcode;
+    uint16_t       length;
+    xcb_pixmap_t   pid;
+    xcb_drawable_t drawable;
+    uint16_t       width;
+    uint16_t       height;
+    uint8_t        depth;
+    uint8_t        pad0[3];
+    xcb_shm_seg_t  shmseg;
+    uint32_t       offset;
+} xcb_shm_create_pixmap_request_t;
+
+/** Opcode for xcb_shm_attach_fd. */
+#define XCB_SHM_ATTACH_FD 6
+
+/**
+ * @brief xcb_shm_attach_fd_request_t
+ **/
+typedef struct xcb_shm_attach_fd_request_t {
+    uint8_t       major_opcode;
+    uint8_t       minor_opcode;
+    uint16_t      length;
+    xcb_shm_seg_t shmseg;
+    uint8_t       read_only;
+    uint8_t       pad0[3];
+} xcb_shm_attach_fd_request_t;
+
+/**
+ * @brief xcb_shm_create_segment_cookie_t
+ **/
+typedef struct xcb_shm_create_segment_cookie_t {
+    unsigned int sequence;
+} xcb_shm_create_segment_cookie_t;
+
+/** Opcode for xcb_shm_create_segment. */
+#define XCB_SHM_CREATE_SEGMENT 7
+
+/**
+ * @brief xcb_shm_create_segment_request_t
+ **/
+typedef struct xcb_shm_create_segment_request_t {
+    uint8_t       major_opcode;
+    uint8_t       minor_opcode;
+    uint16_t      length;
+    xcb_shm_seg_t shmseg;
+    uint32_t      size;
+    uint8_t       read_only;
+    uint8_t       pad0[3];
+} xcb_shm_create_segment_request_t;
+
+/**
+ * @brief xcb_shm_create_segment_reply_t
+ **/
+typedef struct xcb_shm_create_segment_reply_t {
+    uint8_t  response_type;
+    uint8_t  nfd;
+    uint16_t sequence;
+    uint32_t length;
+    uint8_t  pad0[24];
+} xcb_shm_create_segment_reply_t;
+
+/**
+ * Get the next element of the iterator
+ * @param i Pointer to a xcb_shm_seg_iterator_t
+ *
+ * Get the next element in the iterator. The member rem is
+ * decreased by one. The member data points to the next
+ * element. The member index is increased by sizeof(xcb_shm_seg_t)
+ */
+void
+xcb_shm_seg_next (xcb_shm_seg_iterator_t *i);
+
+/**
+ * Return the iterator pointing to the last element
+ * @param i An xcb_shm_seg_iterator_t
+ * @return  The iterator pointing to the last element
+ *
+ * Set the current element in the iterator to the last element.
+ * The member rem is set to 0. The member data points to the
+ * last element.
+ */
+xcb_generic_iterator_t
+xcb_shm_seg_end (xcb_shm_seg_iterator_t i);
+
+/**
+ * @brief Query the version of the MIT-SHM extension.
+ *
+ * @param c The connection
+ * @return A cookie
+ *
+ * This is used to determine the version of the MIT-SHM extension supported by the
+ * X server.  Clients MUST NOT make other requests in this extension until a reply
+ * to this requests indicates the X server supports them.
+ *
+ */
+xcb_shm_query_version_cookie_t
+xcb_shm_query_version (xcb_connection_t *c);
+
+/**
+ * @brief Query the version of the MIT-SHM extension.
+ *
+ * @param c The connection
+ * @return A cookie
+ *
+ * This is used to determine the version of the MIT-SHM extension supported by the
+ * X server.  Clients MUST NOT make other requests in this extension until a reply
+ * to this requests indicates the X server supports them.
+ *
+ * This form can be used only if the request will cause
+ * a reply to be generated. Any returned error will be
+ * placed in the event queue.
+ */
+xcb_shm_query_version_cookie_t
+xcb_shm_query_version_unchecked (xcb_connection_t *c);
+
+/**
+ * Return the reply
+ * @param c      The connection
+ * @param cookie The cookie
+ * @param e      The xcb_generic_error_t supplied
+ *
+ * Returns the reply of the request asked by
+ *
+ * The parameter @p e supplied to this function must be NULL if
+ * xcb_shm_query_version_unchecked(). is used.
+ * Otherwise, it stores the error if any.
+ *
+ * The returned value must be freed by the caller using free().
+ */
+xcb_shm_query_version_reply_t *
+xcb_shm_query_version_reply (xcb_connection_t                *c,
+                             xcb_shm_query_version_cookie_t   cookie  /**< */,
+                             xcb_generic_error_t            **e);
+
+/**
+ * @brief Attach a System V shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param shmid The System V shared memory segment the server should map.
+ * @param read_only True if the segment shall be mapped read only by the X11 server, otherwise false.
+ * @return A cookie
+ *
+ * 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.
+ *
+ * This form can be used only if the request will not cause
+ * a reply to be generated. Any returned error will be
+ * saved for handling by xcb_request_check().
+ */
+xcb_void_cookie_t
+xcb_shm_attach_checked (xcb_connection_t *c,
+                        xcb_shm_seg_t     shmseg,
+                        uint32_t          shmid,
+                        uint8_t           read_only);
+
+/**
+ * @brief Attach a System V shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param shmid The System V shared memory segment the server should map.
+ * @param read_only True if the segment shall be mapped read only by the X11 server, otherwise false.
+ * @return A cookie
+ *
+ * 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.
+ *
+ */
+xcb_void_cookie_t
+xcb_shm_attach (xcb_connection_t *c,
+                xcb_shm_seg_t     shmseg,
+                uint32_t          shmid,
+                uint8_t           read_only);
+
+/**
+ * @brief Destroys the specified shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg The segment to be destroyed.
+ * @return A cookie
+ *
+ * Destroys the specified shared memory segment.  This will never fail unless the
+ * segment number is incorrect.
+ *
+ * This form can be used only if the request will not cause
+ * a reply to be generated. Any returned error will be
+ * saved for handling by xcb_request_check().
+ */
+xcb_void_cookie_t
+xcb_shm_detach_checked (xcb_connection_t *c,
+                        xcb_shm_seg_t     shmseg);
+
+/**
+ * @brief Destroys the specified shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg The segment to be destroyed.
+ * @return A cookie
+ *
+ * Destroys the specified shared memory segment.  This will never fail unless the
+ * segment number is incorrect.
+ *
+ */
+xcb_void_cookie_t
+xcb_shm_detach (xcb_connection_t *c,
+                xcb_shm_seg_t     shmseg);
+
+/**
+ * @brief Copy data from the shared memory to the specified drawable.
+ *
+ * @param c The connection
+ * @param drawable The drawable to draw to.
+ * @param gc The graphics context to use.
+ * @param total_width The total width of the source image.
+ * @param total_height The total height of the source image.
+ * @param src_x The source X coordinate of the sub-image to copy.
+ * @param src_y The source Y coordinate of the sub-image to copy.
+ * @param src_width The width, in source image coordinates, of the data to copy from the source.
+ * The X server will use this to determine the amount of data to copy.  The amount
+ * of the destination image that is overwritten is determined automatically.
+ * @param src_height The height, in source image coordinates, of the data to copy from the source.
+ * The X server will use this to determine the amount of data to copy.  The amount
+ * of the destination image that is overwritten is determined automatically.
+ * @param dst_x The X coordinate on the destination drawable to copy to.
+ * @param dst_y The Y coordinate on the destination drawable to copy to.
+ * @param depth The depth to use.
+ * @param format The format of the image being drawn.  If it is XYBitmap, depth must be 1, or a
+ * "BadMatch" error results.  The foreground pixel in the GC determines the source
+ * for the one bits in the image, and the background pixel determines the source
+ * for the zero bits.  For XYPixmap and ZPixmap, the depth must match the depth of
+ * the drawable, or a "BadMatch" error results.
+ * @param send_event True if the server should send an XCB_SHM_COMPLETION event when the blit
+ * completes.
+ * @param offset The offset that the source image starts at.
+ * @return A cookie
+ *
+ * Copy data from the shared memory to the specified drawable.  The amount of bytes
+ * written to the destination image is always equal to the number of bytes read
+ * from the shared memory segment.
+ *
+ * This form can be used only if the request will not cause
+ * a reply to be generated. Any returned error will be
+ * saved for handling by xcb_request_check().
+ */
+xcb_void_cookie_t
+xcb_shm_put_image_checked (xcb_connection_t *c,
+                           xcb_drawable_t    drawable,
+                           xcb_gcontext_t    gc,
+                           uint16_t          total_width,
+                           uint16_t          total_height,
+                           uint16_t          src_x,
+                           uint16_t          src_y,
+                           uint16_t          src_width,
+                           uint16_t          src_height,
+                           int16_t           dst_x,
+                           int16_t           dst_y,
+                           uint8_t           depth,
+                           uint8_t           format,
+                           uint8_t           send_event,
+                           xcb_shm_seg_t     shmseg,
+                           uint32_t          offset);
+
+/**
+ * @brief Copy data from the shared memory to the specified drawable.
+ *
+ * @param c The connection
+ * @param drawable The drawable to draw to.
+ * @param gc The graphics context to use.
+ * @param total_width The total width of the source image.
+ * @param total_height The total height of the source image.
+ * @param src_x The source X coordinate of the sub-image to copy.
+ * @param src_y The source Y coordinate of the sub-image to copy.
+ * @param src_width The width, in source image coordinates, of the data to copy from the source.
+ * The X server will use this to determine the amount of data to copy.  The amount
+ * of the destination image that is overwritten is determined automatically.
+ * @param src_height The height, in source image coordinates, of the data to copy from the source.
+ * The X server will use this to determine the amount of data to copy.  The amount
+ * of the destination image that is overwritten is determined automatically.
+ * @param dst_x The X coordinate on the destination drawable to copy to.
+ * @param dst_y The Y coordinate on the destination drawable to copy to.
+ * @param depth The depth to use.
+ * @param format The format of the image being drawn.  If it is XYBitmap, depth must be 1, or a
+ * "BadMatch" error results.  The foreground pixel in the GC determines the source
+ * for the one bits in the image, and the background pixel determines the source
+ * for the zero bits.  For XYPixmap and ZPixmap, the depth must match the depth of
+ * the drawable, or a "BadMatch" error results.
+ * @param send_event True if the server should send an XCB_SHM_COMPLETION event when the blit
+ * completes.
+ * @param offset The offset that the source image starts at.
+ * @return A cookie
+ *
+ * Copy data from the shared memory to the specified drawable.  The amount of bytes
+ * written to the destination image is always equal to the number of bytes read
+ * from the shared memory segment.
+ *
+ */
+xcb_void_cookie_t
+xcb_shm_put_image (xcb_connection_t *c,
+                   xcb_drawable_t    drawable,
+                   xcb_gcontext_t    gc,
+                   uint16_t          total_width,
+                   uint16_t          total_height,
+                   uint16_t          src_x,
+                   uint16_t          src_y,
+                   uint16_t          src_width,
+                   uint16_t          src_height,
+                   int16_t           dst_x,
+                   int16_t           dst_y,
+                   uint8_t           depth,
+                   uint8_t           format,
+                   uint8_t           send_event,
+                   xcb_shm_seg_t     shmseg,
+                   uint32_t          offset);
+
+/**
+ * @brief Copies data from the specified drawable to the shared memory segment.
+ *
+ * @param c The connection
+ * @param drawable The drawable to copy the image out of.
+ * @param x The X coordinate in the drawable to begin copying at.
+ * @param y The Y coordinate in the drawable to begin copying at.
+ * @param width The width of the image to copy.
+ * @param height The height of the image to copy.
+ * @param plane_mask A mask that determines which planes are used.
+ * @param format The format to use for the copy (???).
+ * @param shmseg The destination shared memory segment.
+ * @param offset The offset in the shared memory segment to copy data to.
+ * @return A cookie
+ *
+ * Copy data from the specified drawable to the shared memory segment.  The amount
+ * of bytes written to the destination image is always equal to the number of bytes
+ * read from the shared memory segment.
+ *
+ */
+xcb_shm_get_image_cookie_t
+xcb_shm_get_image (xcb_connection_t *c,
+                   xcb_drawable_t    drawable,
+                   int16_t           x,
+                   int16_t           y,
+                   uint16_t          width,
+                   uint16_t          height,
+                   uint32_t          plane_mask,
+                   uint8_t           format,
+                   xcb_shm_seg_t     shmseg,
+                   uint32_t          offset);
+
+/**
+ * @brief Copies data from the specified drawable to the shared memory segment.
+ *
+ * @param c The connection
+ * @param drawable The drawable to copy the image out of.
+ * @param x The X coordinate in the drawable to begin copying at.
+ * @param y The Y coordinate in the drawable to begin copying at.
+ * @param width The width of the image to copy.
+ * @param height The height of the image to copy.
+ * @param plane_mask A mask that determines which planes are used.
+ * @param format The format to use for the copy (???).
+ * @param shmseg The destination shared memory segment.
+ * @param offset The offset in the shared memory segment to copy data to.
+ * @return A cookie
+ *
+ * Copy data from the specified drawable to the shared memory segment.  The amount
+ * of bytes written to the destination image is always equal to the number of bytes
+ * read from the shared memory segment.
+ *
+ * This form can be used only if the request will cause
+ * a reply to be generated. Any returned error will be
+ * placed in the event queue.
+ */
+xcb_shm_get_image_cookie_t
+xcb_shm_get_image_unchecked (xcb_connection_t *c,
+                             xcb_drawable_t    drawable,
+                             int16_t           x,
+                             int16_t           y,
+                             uint16_t          width,
+                             uint16_t          height,
+                             uint32_t          plane_mask,
+                             uint8_t           format,
+                             xcb_shm_seg_t     shmseg,
+                             uint32_t          offset);
+
+/**
+ * Return the reply
+ * @param c      The connection
+ * @param cookie The cookie
+ * @param e      The xcb_generic_error_t supplied
+ *
+ * Returns the reply of the request asked by
+ *
+ * The parameter @p e supplied to this function must be NULL if
+ * xcb_shm_get_image_unchecked(). is used.
+ * Otherwise, it stores the error if any.
+ *
+ * The returned value must be freed by the caller using free().
+ */
+xcb_shm_get_image_reply_t *
+xcb_shm_get_image_reply (xcb_connection_t            *c,
+                         xcb_shm_get_image_cookie_t   cookie  /**< */,
+                         xcb_generic_error_t        **e);
+
+/**
+ * @brief Create a pixmap backed by shared memory.
+ *
+ * @param c The connection
+ * @param pid A pixmap ID created with xcb_generate_id().
+ * @param drawable The drawable to create the pixmap in.
+ * @param width The width of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param height The height of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param depth The depth of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param shmseg The shared memory segment to use to create the pixmap.
+ * @param offset The offset in the segment to create the pixmap at.
+ * @return A cookie
+ *
+ * Create a pixmap backed by shared memory.  Writes to the shared memory will be
+ * reflected in the contents of the pixmap, and writes to the pixmap will be
+ * reflected in the contents of the shared memory.
+ *
+ * This form can be used only if the request will not cause
+ * a reply to be generated. Any returned error will be
+ * saved for handling by xcb_request_check().
+ */
+xcb_void_cookie_t
+xcb_shm_create_pixmap_checked (xcb_connection_t *c,
+                               xcb_pixmap_t      pid,
+                               xcb_drawable_t    drawable,
+                               uint16_t          width,
+                               uint16_t          height,
+                               uint8_t           depth,
+                               xcb_shm_seg_t     shmseg,
+                               uint32_t          offset);
+
+/**
+ * @brief Create a pixmap backed by shared memory.
+ *
+ * @param c The connection
+ * @param pid A pixmap ID created with xcb_generate_id().
+ * @param drawable The drawable to create the pixmap in.
+ * @param width The width of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param height The height of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param depth The depth of the pixmap to create.  Must be nonzero, or a Value error results.
+ * @param shmseg The shared memory segment to use to create the pixmap.
+ * @param offset The offset in the segment to create the pixmap at.
+ * @return A cookie
+ *
+ * Create a pixmap backed by shared memory.  Writes to the shared memory will be
+ * reflected in the contents of the pixmap, and writes to the pixmap will be
+ * reflected in the contents of the shared memory.
+ *
+ */
+xcb_void_cookie_t
+xcb_shm_create_pixmap (xcb_connection_t *c,
+                       xcb_pixmap_t      pid,
+                       xcb_drawable_t    drawable,
+                       uint16_t          width,
+                       uint16_t          height,
+                       uint8_t           depth,
+                       xcb_shm_seg_t     shmseg,
+                       uint32_t          offset);
+
+/**
+ * @brief Create a shared memory segment
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param shm_fd The file descriptor the server should mmap().
+ * @param read_only True if the segment shall be mapped read only by the X11 server, otherwise false.
+ * @return A cookie
+ *
+ * Create a shared memory segment.  The file descriptor will be mapped at offset
+ * zero, and the size will be obtained using fstat().  A zero size will result in a
+ * Value error.
+ *
+ * This form can be used only if the request will not cause
+ * a reply to be generated. Any returned error will be
+ * saved for handling by xcb_request_check().
+ */
+xcb_void_cookie_t
+xcb_shm_attach_fd_checked (xcb_connection_t *c,
+                           xcb_shm_seg_t     shmseg,
+                           int32_t           shm_fd,
+                           uint8_t           read_only);
+
+/**
+ * @brief Create a shared memory segment
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param shm_fd The file descriptor the server should mmap().
+ * @param read_only True if the segment shall be mapped read only by the X11 server, otherwise false.
+ * @return A cookie
+ *
+ * Create a shared memory segment.  The file descriptor will be mapped at offset
+ * zero, and the size will be obtained using fstat().  A zero size will result in a
+ * Value error.
+ *
+ */
+xcb_void_cookie_t
+xcb_shm_attach_fd (xcb_connection_t *c,
+                   xcb_shm_seg_t     shmseg,
+                   int32_t           shm_fd,
+                   uint8_t           read_only);
+
+/**
+ * @brief Asks the server to allocate a shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param size The size of the segment to create.
+ * @param read_only True if the server should map the segment read-only; otherwise false.
+ * @return A cookie
+ *
+ * Asks the server to allocate a shared memory segment.  The server’s reply will
+ * include a file descriptor for the client to pass to mmap().
+ *
+ */
+xcb_shm_create_segment_cookie_t
+xcb_shm_create_segment (xcb_connection_t *c,
+                        xcb_shm_seg_t     shmseg,
+                        uint32_t          size,
+                        uint8_t           read_only);
+
+/**
+ * @brief Asks the server to allocate a shared memory segment.
+ *
+ * @param c The connection
+ * @param shmseg A shared memory segment ID created with xcb_generate_id().
+ * @param size The size of the segment to create.
+ * @param read_only True if the server should map the segment read-only; otherwise false.
+ * @return A cookie
+ *
+ * Asks the server to allocate a shared memory segment.  The server’s reply will
+ * include a file descriptor for the client to pass to mmap().
+ *
+ * This form can be used only if the request will cause
+ * a reply to be generated. Any returned error will be
+ * placed in the event queue.
+ */
+xcb_shm_create_segment_cookie_t
+xcb_shm_create_segment_unchecked (xcb_connection_t *c,
+                                  xcb_shm_seg_t     shmseg,
+                                  uint32_t          size,
+                                  uint8_t           read_only);
+
+/**
+ * Return the reply
+ * @param c      The connection
+ * @param cookie The cookie
+ * @param e      The xcb_generic_error_t supplied
+ *
+ * Returns the reply of the request asked by
+ *
+ * The parameter @p e supplied to this function must be NULL if
+ * xcb_shm_create_segment_unchecked(). is used.
+ * Otherwise, it stores the error if any.
+ *
+ * The returned value must be freed by the caller using free().
+ */
+xcb_shm_create_segment_reply_t *
+xcb_shm_create_segment_reply (xcb_connection_t                 *c,
+                              xcb_shm_create_segment_cookie_t   cookie  /**< */,
+                              xcb_generic_error_t             **e);
+
+/**
+ * Return the reply fds
+ * @param c      The connection
+ * @param reply  The reply
+ *
+ * Returns a pointer to the array of reply fds of the reply.
+ *
+ * The returned value points into the reply and must not be free().
+ * The fds are not managed by xcb. You must close() them before freeing the reply.
+ */
+int *
+xcb_shm_create_segment_reply_fds (xcb_connection_t                *c  /**< */,
+                                  xcb_shm_create_segment_reply_t  *reply);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+
+/**
+ * @}
+ */