From patchwork Wed Mar 25 12:10:24 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Link Mauve X-Patchwork-Id: 6090651 Return-Path: X-Original-To: patchwork-dri-devel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 06BAE9F318 for ; Wed, 25 Mar 2015 12:19:55 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D6436202C8 for ; Wed, 25 Mar 2015 12:19:53 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id DF315202AE for ; Wed, 25 Mar 2015 12:19:51 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 0078B6E836; Wed, 25 Mar 2015 05:19:51 -0700 (PDT) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org X-Greylist: delayed 517 seconds by postgrey-1.34 at gabe; Wed, 25 Mar 2015 05:19:48 PDT Received: from linkmauve.fr (dns.linkmauve.fr [82.226.255.187]) by gabe.freedesktop.org (Postfix) with ESMTP id AA2986E836 for ; Wed, 25 Mar 2015 05:19:48 -0700 (PDT) Received: by linkmauve.fr (Postfix, from userid 1000) id 2A7CA40469; Wed, 25 Mar 2015 13:10:46 +0100 (CET) From: Emmanuel Gil Peyrot To: dri-devel@lists.freedesktop.org Subject: [PATCH] wayland-drm: add a description for every item. Date: Wed, 25 Mar 2015 13:10:24 +0100 Message-Id: <1427285424-12452-1-git-send-email-linkmauve@linkmauve.fr> X-Mailer: git-send-email 2.3.4 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This makes the generated protocol headers a lot more readable. --- src/egl/wayland/wayland-drm/wayland-drm.xml | 159 +++++++++++++++++----------- 1 file changed, 100 insertions(+), 59 deletions(-) diff --git a/src/egl/wayland/wayland-drm/wayland-drm.xml b/src/egl/wayland/wayland-drm/wayland-drm.xml index 5e64622..7cf06d9 100644 --- a/src/egl/wayland/wayland-drm/wayland-drm.xml +++ b/src/egl/wayland/wayland-drm/wayland-drm.xml @@ -27,19 +27,31 @@ THIS SOFTWARE. - + + This object is created by the server and published using the + display's global event. + + - - - + + These errors can be emitted in response to wl_drm requests. + + + + - + + The drm format codes match the #defines in drm_fourcc.h. + + The formats actually supported by the compositor will be + reported by the format event. + @@ -100,84 +112,113 @@ - - + + Call this request with the magic received from drmGetMagic(). + + It will be passed on to the drmAuthMagic() or + DRIAuthConnection() call. This authentication must be + completed before create_buffer could be used. + + - - - - - - - + + Create a wayland buffer for the named DRM buffer. + + The DRM surface must have a name using the flink ioctl. + + + + + + + - - - - - - - - - - - - + + Create a wayland buffer for the named planar DRM buffer. + + The DRM surface must have a name using the flink ioctl. + + + + + + + + + + + + - - + + Notification of the path of the drm device which is used by the + server. + + The client should use this device for creating local buffers. + Only buffers created from this device should be be passed to + the server using this drm object's create_buffer request. + + - + + Informs the client about a valid pixel format that can be used + for buffers. + + - - + + + Raised if the authenticate request succeeded. + + - - Bitmask of capabilities. + + Lists the available capabilities the server can expose. - + + Bitmask of capabilities supported by the server. + + - - - - - - - - - - - - + + Create a wayland buffer for the prime fd. + + Use for regular and planar buffers. Pass 0 for offset and + stride for unused planes. + + + + + + + + + + + +