From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932456AbcFIPHw (ORCPT ); Thu, 9 Jun 2016 11:07:52 -0400 Received: from mail-yw0-f195.google.com ([209.85.161.195]:34868 "EHLO mail-yw0-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932382AbcFIPHu (ORCPT ); Thu, 9 Jun 2016 11:07:50 -0400 From: Gustavo Padovan To: dri-devel@lists.freedesktop.org Cc: linux-kernel@vger.kernel.org, Daniel Stone , Daniel Vetter , Rob Clark , Greg Hackmann , John Harrison , laurent.pinchart@ideasonboard.com, seanpaul@google.com, marcheu@google.com, m.chehab@samsung.com, Sumit Semwal , Maarten Lankhorst , Gustavo Padovan Subject: [PATCH 3/3] Documentation: add doc for sync_file_get_fence() Date: Thu, 9 Jun 2016 12:05:30 -0300 Message-Id: <1465484730-8128-3-git-send-email-gustavo@padovan.org> X-Mailer: git-send-email 2.5.5 In-Reply-To: <1465484730-8128-1-git-send-email-gustavo@padovan.org> References: <1465484730-8128-1-git-send-email-gustavo@padovan.org> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Gustavo Padovan Document the new function added to sync_file.c v2: Adapt to fence_array Signed-off-by: Gustavo Padovan --- Documentation/sync_file.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/Documentation/sync_file.txt b/Documentation/sync_file.txt index eaf8297..46f5769 100644 --- a/Documentation/sync_file.txt +++ b/Documentation/sync_file.txt @@ -64,6 +64,25 @@ The sync_file fd now can be sent to userspace. If the creation process fail, or the sync_file needs to be released by any other reason fput(sync_file->file) should be used. +Receiving Sync Files from Userspace +----------------------------------- + +When userspace needs to send an in-fence to the driver it pass file descriptor +of the Sync File to the kernel. The kernel then can retrieve the sync_file +from it. + +Interface: + struct fence *sync_file_get_fence(int fd); + + +The function return a struct fence pointer referencing the fence(s) in the Sync +File. If the Sync File contains only one fence, this fence is returned. But if +has more than one fence a fence_array[3] is returned. However the callers only +see the arrays' base class which is struct fence. In both cases a reference to +the returned fence is held. + + References: [1] struct sync_file in include/linux/sync_file.h [2] All interfaces mentioned above defined in include/linux/sync_file.h +[1] struct fence_array in include/linux/fence-array.h -- 2.5.5 From mboxrd@z Thu Jan 1 00:00:00 1970 From: Gustavo Padovan Subject: [PATCH 3/3] Documentation: add doc for sync_file_get_fence() Date: Thu, 9 Jun 2016 12:05:30 -0300 Message-ID: <1465484730-8128-3-git-send-email-gustavo@padovan.org> References: <1465484730-8128-1-git-send-email-gustavo@padovan.org> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-yw0-f193.google.com (mail-yw0-f193.google.com [209.85.161.193]) by gabe.freedesktop.org (Postfix) with ESMTPS id 934146EBFC for ; Thu, 9 Jun 2016 15:07:50 +0000 (UTC) Received: by mail-yw0-f193.google.com with SMTP id l126so5070442ywe.3 for ; Thu, 09 Jun 2016 08:07:50 -0700 (PDT) In-Reply-To: <1465484730-8128-1-git-send-email-gustavo@padovan.org> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: dri-devel@lists.freedesktop.org Cc: marcheu@google.com, Daniel Stone , seanpaul@google.com, Daniel Vetter , linux-kernel@vger.kernel.org, laurent.pinchart@ideasonboard.com, Gustavo Padovan , John Harrison , m.chehab@samsung.com List-Id: dri-devel@lists.freedesktop.org RnJvbTogR3VzdGF2byBQYWRvdmFuIDxndXN0YXZvLnBhZG92YW5AY29sbGFib3JhLmNvLnVrPgoK RG9jdW1lbnQgdGhlIG5ldyBmdW5jdGlvbiBhZGRlZCB0byBzeW5jX2ZpbGUuYwoKdjI6IEFkYXB0 IHRvIGZlbmNlX2FycmF5CgpTaWduZWQtb2ZmLWJ5OiBHdXN0YXZvIFBhZG92YW4gPGd1c3Rhdm8u cGFkb3ZhbkBjb2xsYWJvcmEuY28udWs+Ci0tLQogRG9jdW1lbnRhdGlvbi9zeW5jX2ZpbGUudHh0 IHwgMTkgKysrKysrKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDE5IGluc2VydGlvbnMo KykKCmRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL3N5bmNfZmlsZS50eHQgYi9Eb2N1bWVudGF0 aW9uL3N5bmNfZmlsZS50eHQKaW5kZXggZWFmODI5Ny4uNDZmNTc2OSAxMDA2NDQKLS0tIGEvRG9j dW1lbnRhdGlvbi9zeW5jX2ZpbGUudHh0CisrKyBiL0RvY3VtZW50YXRpb24vc3luY19maWxlLnR4 dApAQCAtNjQsNiArNjQsMjUgQEAgVGhlIHN5bmNfZmlsZSBmZCBub3cgY2FuIGJlIHNlbnQgdG8g dXNlcnNwYWNlLgogSWYgdGhlIGNyZWF0aW9uIHByb2Nlc3MgZmFpbCwgb3IgdGhlIHN5bmNfZmls ZSBuZWVkcyB0byBiZSByZWxlYXNlZCBieSBhbnkKIG90aGVyIHJlYXNvbiBmcHV0KHN5bmNfZmls ZS0+ZmlsZSkgc2hvdWxkIGJlIHVzZWQuCiAKK1JlY2VpdmluZyBTeW5jIEZpbGVzIGZyb20gVXNl cnNwYWNlCistLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQorCitXaGVuIHVzZXJz cGFjZSBuZWVkcyB0byBzZW5kIGFuIGluLWZlbmNlIHRvIHRoZSBkcml2ZXIgaXQgcGFzcyBmaWxl IGRlc2NyaXB0b3IKK29mIHRoZSBTeW5jIEZpbGUgdG8gdGhlIGtlcm5lbC4gVGhlIGtlcm5lbCB0 aGVuIGNhbiByZXRyaWV2ZSB0aGUgc3luY19maWxlCitmcm9tIGl0LgorCitJbnRlcmZhY2U6CisJ c3RydWN0IGZlbmNlICpzeW5jX2ZpbGVfZ2V0X2ZlbmNlKGludCBmZCk7CisKKworVGhlIGZ1bmN0 aW9uIHJldHVybiBhIHN0cnVjdCBmZW5jZSBwb2ludGVyIHJlZmVyZW5jaW5nIHRoZSBmZW5jZShz KSBpbiB0aGUgU3luYworRmlsZS4gSWYgdGhlIFN5bmMgRmlsZSBjb250YWlucyBvbmx5IG9uZSBm ZW5jZSwgdGhpcyBmZW5jZSBpcyByZXR1cm5lZC4gQnV0IGlmCitoYXMgbW9yZSB0aGFuIG9uZSBm ZW5jZSBhIGZlbmNlX2FycmF5WzNdIGlzIHJldHVybmVkLiBIb3dldmVyIHRoZSBjYWxsZXJzIG9u bHkKK3NlZSB0aGUgYXJyYXlzJyBiYXNlIGNsYXNzIHdoaWNoIGlzIHN0cnVjdCBmZW5jZS4gSW4g Ym90aCBjYXNlcyBhIHJlZmVyZW5jZSB0bwordGhlIHJldHVybmVkIGZlbmNlIGlzIGhlbGQuCisK KwogUmVmZXJlbmNlczoKIFsxXSBzdHJ1Y3Qgc3luY19maWxlIGluIGluY2x1ZGUvbGludXgvc3lu Y19maWxlLmgKIFsyXSBBbGwgaW50ZXJmYWNlcyBtZW50aW9uZWQgYWJvdmUgZGVmaW5lZCBpbiBp bmNsdWRlL2xpbnV4L3N5bmNfZmlsZS5oCitbMV0gc3RydWN0IGZlbmNlX2FycmF5IGluIGluY2x1 ZGUvbGludXgvZmVuY2UtYXJyYXkuaAotLSAKMi41LjUKCl9fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVs QGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWls bWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=