From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tvrtko Ursulin Subject: [PATCH 3/4] lib/scatterlist: Introduce and export __sg_alloc_table_from_pages Date: Thu, 4 May 2017 16:54:04 +0100 Message-ID: <20170504155405.7425-3-tvrtko.ursulin@linux.intel.com> References: <20170504155405.7425-1-tvrtko.ursulin@linux.intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wm0-x244.google.com (mail-wm0-x244.google.com [IPv6:2a00:1450:400c:c09::244]) by gabe.freedesktop.org (Postfix) with ESMTPS id C102C6E09F for ; Thu, 4 May 2017 15:54:17 +0000 (UTC) Received: by mail-wm0-x244.google.com with SMTP id d79so4255599wmi.2 for ; Thu, 04 May 2017 08:54:17 -0700 (PDT) In-Reply-To: <20170504155405.7425-1-tvrtko.ursulin@linux.intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Intel-gfx@lists.freedesktop.org Cc: linux-kernel@vger.kernel.org, Masahiro Yamada List-Id: intel-gfx@lists.freedesktop.org RnJvbTogVHZydGtvIFVyc3VsaW4gPHR2cnRrby51cnN1bGluQGludGVsLmNvbT4KCkRyaXZlcnMg bGlrZSBpOTE1IGJlbmVmaXQgZnJvbSBiZWluZyBhYmxlIHRvIGNvbnRyb2wgdGhlIG1heGl1bQpz aXplIG9mIHRoZSBzZyBjb2FsbGVzY2VkIHNlZ21lbnQgd2hpbGUgYnVpbGRpbmcgdGhlIHNjYXR0 ZXItCmdhdGhlciBsaXN0LgoKSW50cm9kdWNlIGFuZCBleHBvcnQgdGhlIF9fc2dfYWxsb2NfdGFi bGVfZnJvbV9wYWdlcyBmdW5jdGlvbgp3aGljaCB3aWxsIGFsbG93IGl0IHRoYXQgY29udHJvbC4K CnYyOiBSZW9yZGVyIHBhcmFtZXRlcnMuIChDaHJpcyBXaWxzb24pCnYzOiBGaXggaW5jb21wbGV0 ZSByZW9yZGVyaW5nIGluIHYyLgp2NDogbWF4X3NlZ21lbnQgbmVlZHMgdG8gYmUgcGFnZSBhbGln bmVkLgp2NTogUmViYXNlLgp2NjogUmViYXNlLgoKU2lnbmVkLW9mZi1ieTogVHZydGtvIFVyc3Vs aW4gPHR2cnRrby51cnN1bGluQGludGVsLmNvbT4KQ2M6IE1hc2FoaXJvIFlhbWFkYSA8eWFtYWRh Lm1hc2FoaXJvQHNvY2lvbmV4dC5jb20+CkNjOiBsaW51eC1rZXJuZWxAdmdlci5rZXJuZWwub3Jn CkNjOiBDaHJpcyBXaWxzb24gPGNocmlzQGNocmlzLXdpbHNvbi5jby51az4KUmV2aWV3ZWQtYnk6 IENocmlzIFdpbHNvbiA8Y2hyaXNAY2hyaXMtd2lsc29uLmNvLnVrPiAodjIpCkNjOiBKb29uYXMg TGFodGluZW4gPGpvb25hcy5sYWh0aW5lbkBsaW51eC5pbnRlbC5jb20+Ci0tLQogaW5jbHVkZS9s aW51eC9zY2F0dGVybGlzdC5oIHwgMTEgKysrKystLS0tCiBsaWIvc2NhdHRlcmxpc3QuYyAgICAg ICAgICAgfCA1OCArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0tLS0tLS0tLS0K IDIgZmlsZXMgY2hhbmdlZCwgNTIgaW5zZXJ0aW9ucygrKSwgMTcgZGVsZXRpb25zKC0pCgpkaWZm IC0tZ2l0IGEvaW5jbHVkZS9saW51eC9zY2F0dGVybGlzdC5oIGIvaW5jbHVkZS9saW51eC9zY2F0 dGVybGlzdC5oCmluZGV4IDQ3NjhlZWViNzA1NC4uNGQ2N2E5NjUyYzdkIDEwMDY0NAotLS0gYS9p bmNsdWRlL2xpbnV4L3NjYXR0ZXJsaXN0LmgKKysrIGIvaW5jbHVkZS9saW51eC9zY2F0dGVybGlz dC5oCkBAIC0yNjcsMTAgKzI2NywxMyBAQCB2b2lkIHNnX2ZyZWVfdGFibGUoc3RydWN0IHNnX3Rh YmxlICopOwogaW50IF9fc2dfYWxsb2NfdGFibGUoc3RydWN0IHNnX3RhYmxlICosIHVuc2lnbmVk IGludCwgdW5zaWduZWQgaW50LAogCQkgICAgIHN0cnVjdCBzY2F0dGVybGlzdCAqLCBnZnBfdCwg c2dfYWxsb2NfZm4gKik7CiBpbnQgc2dfYWxsb2NfdGFibGUoc3RydWN0IHNnX3RhYmxlICosIHVu c2lnbmVkIGludCwgZ2ZwX3QpOwotaW50IHNnX2FsbG9jX3RhYmxlX2Zyb21fcGFnZXMoc3RydWN0 IHNnX3RhYmxlICpzZ3QsCi0Jc3RydWN0IHBhZ2UgKipwYWdlcywgdW5zaWduZWQgaW50IG5fcGFn ZXMsCi0JdW5zaWduZWQgaW50IG9mZnNldCwgdW5zaWduZWQgbG9uZyBzaXplLAotCWdmcF90IGdm cF9tYXNrKTsKK2ludCBfX3NnX2FsbG9jX3RhYmxlX2Zyb21fcGFnZXMoc3RydWN0IHNnX3RhYmxl ICpzZ3QsIHN0cnVjdCBwYWdlICoqcGFnZXMsCisJCQkJdW5zaWduZWQgaW50IG5fcGFnZXMsIHVu c2lnbmVkIGludCBvZmZzZXQsCisJCQkJdW5zaWduZWQgbG9uZyBzaXplLCB1bnNpZ25lZCBpbnQg bWF4X3NlZ21lbnQsCisJCQkJZ2ZwX3QgZ2ZwX21hc2spOworaW50IHNnX2FsbG9jX3RhYmxlX2Zy b21fcGFnZXMoc3RydWN0IHNnX3RhYmxlICpzZ3QsIHN0cnVjdCBwYWdlICoqcGFnZXMsCisJCQkg ICAgICB1bnNpZ25lZCBpbnQgbl9wYWdlcywgdW5zaWduZWQgaW50IG9mZnNldCwKKwkJCSAgICAg IHVuc2lnbmVkIGxvbmcgc2l6ZSwgZ2ZwX3QgZ2ZwX21hc2spOwogCiBzaXplX3Qgc2dfY29weV9i dWZmZXIoc3RydWN0IHNjYXR0ZXJsaXN0ICpzZ2wsIHVuc2lnbmVkIGludCBuZW50cywgdm9pZCAq YnVmLAogCQkgICAgICBzaXplX3QgYnVmbGVuLCBvZmZfdCBza2lwLCBib29sIHRvX2J1ZmZlcik7 CmRpZmYgLS1naXQgYS9saWIvc2NhdHRlcmxpc3QuYyBiL2xpYi9zY2F0dGVybGlzdC5jCmluZGV4 IGNhNGNjZDhjODBiOS4uNzNkYWNlMWJkNWJiIDEwMDY0NAotLS0gYS9saWIvc2NhdHRlcmxpc3Qu YworKysgYi9saWIvc2NhdHRlcmxpc3QuYwpAQCAtMzcwLDE0ICszNzAsMTUgQEAgaW50IHNnX2Fs bG9jX3RhYmxlKHN0cnVjdCBzZ190YWJsZSAqdGFibGUsIHVuc2lnbmVkIGludCBuZW50cywgZ2Zw X3QgZ2ZwX21hc2spCiBFWFBPUlRfU1lNQk9MKHNnX2FsbG9jX3RhYmxlKTsKIAogLyoqCi0gKiBz Z19hbGxvY190YWJsZV9mcm9tX3BhZ2VzIC0gQWxsb2NhdGUgYW5kIGluaXRpYWxpemUgYW4gc2cg dGFibGUgZnJvbQotICoJCQkgICAgICAgYW4gYXJyYXkgb2YgcGFnZXMKLSAqIEBzZ3Q6CVRoZSBz ZyB0YWJsZSBoZWFkZXIgdG8gdXNlCi0gKiBAcGFnZXM6CVBvaW50ZXIgdG8gYW4gYXJyYXkgb2Yg cGFnZSBwb2ludGVycwotICogQG5fcGFnZXM6CU51bWJlciBvZiBwYWdlcyBpbiB0aGUgcGFnZXMg YXJyYXkKLSAqIEBvZmZzZXQ6ICAgICBPZmZzZXQgZnJvbSBzdGFydCBvZiB0aGUgZmlyc3QgcGFn ZSB0byB0aGUgc3RhcnQgb2YgYSBidWZmZXIKLSAqIEBzaXplOiAgICAgICBOdW1iZXIgb2YgdmFs aWQgYnl0ZXMgaW4gdGhlIGJ1ZmZlciAoYWZ0ZXIgb2Zmc2V0KQotICogQGdmcF9tYXNrOglHRlAg YWxsb2NhdGlvbiBtYXNrCisgKiBfX3NnX2FsbG9jX3RhYmxlX2Zyb21fcGFnZXMgLSBBbGxvY2F0 ZSBhbmQgaW5pdGlhbGl6ZSBhbiBzZyB0YWJsZSBmcm9tCisgKgkJCSAgICAgICAgIGFuIGFycmF5 IG9mIHBhZ2VzCisgKiBAc2d0OgkgVGhlIHNnIHRhYmxlIGhlYWRlciB0byB1c2UKKyAqIEBwYWdl czoJIFBvaW50ZXIgdG8gYW4gYXJyYXkgb2YgcGFnZSBwb2ludGVycworICogQG5fcGFnZXM6CSBO dW1iZXIgb2YgcGFnZXMgaW4gdGhlIHBhZ2VzIGFycmF5CisgKiBAb2Zmc2V0OiAgICAgIE9mZnNl dCBmcm9tIHN0YXJ0IG9mIHRoZSBmaXJzdCBwYWdlIHRvIHRoZSBzdGFydCBvZiBhIGJ1ZmZlcgor ICogQHNpemU6ICAgICAgICBOdW1iZXIgb2YgdmFsaWQgYnl0ZXMgaW4gdGhlIGJ1ZmZlciAoYWZ0 ZXIgb2Zmc2V0KQorICogQG1heF9zZWdtZW50OiBNYXhpbXVtIHNpemUgb2YgYSBzY2F0dGVybGlz dCBub2RlIGluIGJ5dGVzIChwYWdlIGFsaWduZWQpCisgKiBAZ2ZwX21hc2s6CSBHRlAgYWxsb2Nh dGlvbiBtYXNrCiAgKgogICogIERlc2NyaXB0aW9uOgogICogICAgQWxsb2NhdGUgYW5kIGluaXRp YWxpemUgYW4gc2cgdGFibGUgZnJvbSBhIGxpc3Qgb2YgcGFnZXMuIENvbnRpZ3VvdXMKQEAgLTM4 OSwxNiArMzkwLDE4IEBAIEVYUE9SVF9TWU1CT0woc2dfYWxsb2NfdGFibGUpOwogICogUmV0dXJu czoKICAqICAgMCBvbiBzdWNjZXNzLCBuZWdhdGl2ZSBlcnJvciBvbiBmYWlsdXJlCiAgKi8KLWlu dCBzZ19hbGxvY190YWJsZV9mcm9tX3BhZ2VzKHN0cnVjdCBzZ190YWJsZSAqc2d0LAotCXN0cnVj dCBwYWdlICoqcGFnZXMsIHVuc2lnbmVkIGludCBuX3BhZ2VzLAotCXVuc2lnbmVkIGludCBvZmZz ZXQsIHVuc2lnbmVkIGxvbmcgc2l6ZSwKLQlnZnBfdCBnZnBfbWFzaykKK2ludCBfX3NnX2FsbG9j X3RhYmxlX2Zyb21fcGFnZXMoc3RydWN0IHNnX3RhYmxlICpzZ3QsIHN0cnVjdCBwYWdlICoqcGFn ZXMsCisJCQkJdW5zaWduZWQgaW50IG5fcGFnZXMsIHVuc2lnbmVkIGludCBvZmZzZXQsCisJCQkJ dW5zaWduZWQgbG9uZyBzaXplLCB1bnNpZ25lZCBpbnQgbWF4X3NlZ21lbnQsCisJCQkJZ2ZwX3Qg Z2ZwX21hc2spCiB7Ci0JY29uc3QgdW5zaWduZWQgaW50IG1heF9zZWdtZW50ID0gU0NBVFRFUkxJ U1RfTUFYX1NFR01FTlQ7CiAJdW5zaWduZWQgaW50IGNodW5rcywgY3VyX3BhZ2UsIHNlZ19sZW4s IGk7CiAJaW50IHJldDsKIAlzdHJ1Y3Qgc2NhdHRlcmxpc3QgKnM7CiAKKwlpZiAoV0FSTl9PTigh bWF4X3NlZ21lbnQgfHwgb2Zmc2V0X2luX3BhZ2UobWF4X3NlZ21lbnQpKSkKKwkJcmV0dXJuIC1F SU5WQUw7CisKIAkvKiBjb21wdXRlIG51bWJlciBvZiBjb250aWd1b3VzIGNodW5rcyAqLwogCWNo dW5rcyA9IDE7CiAJc2VnX2xlbiA9IDA7CkBAIC00NDAsNiArNDQzLDM1IEBAIGludCBzZ19hbGxv Y190YWJsZV9mcm9tX3BhZ2VzKHN0cnVjdCBzZ190YWJsZSAqc2d0LAogCiAJcmV0dXJuIDA7CiB9 CitFWFBPUlRfU1lNQk9MKF9fc2dfYWxsb2NfdGFibGVfZnJvbV9wYWdlcyk7CisKKy8qKgorICog c2dfYWxsb2NfdGFibGVfZnJvbV9wYWdlcyAtIEFsbG9jYXRlIGFuZCBpbml0aWFsaXplIGFuIHNn IHRhYmxlIGZyb20KKyAqCQkJICAgICAgIGFuIGFycmF5IG9mIHBhZ2VzCisgKiBAc2d0OgkgVGhl IHNnIHRhYmxlIGhlYWRlciB0byB1c2UKKyAqIEBwYWdlczoJIFBvaW50ZXIgdG8gYW4gYXJyYXkg b2YgcGFnZSBwb2ludGVycworICogQG5fcGFnZXM6CSBOdW1iZXIgb2YgcGFnZXMgaW4gdGhlIHBh Z2VzIGFycmF5CisgKiBAb2Zmc2V0OiAgICAgIE9mZnNldCBmcm9tIHN0YXJ0IG9mIHRoZSBmaXJz dCBwYWdlIHRvIHRoZSBzdGFydCBvZiBhIGJ1ZmZlcgorICogQHNpemU6ICAgICAgICBOdW1iZXIg b2YgdmFsaWQgYnl0ZXMgaW4gdGhlIGJ1ZmZlciAoYWZ0ZXIgb2Zmc2V0KQorICogQGdmcF9tYXNr OgkgR0ZQIGFsbG9jYXRpb24gbWFzaworICoKKyAqICBEZXNjcmlwdGlvbjoKKyAqICAgIEFsbG9j YXRlIGFuZCBpbml0aWFsaXplIGFuIHNnIHRhYmxlIGZyb20gYSBsaXN0IG9mIHBhZ2VzLiBDb250 aWd1b3VzCisgKiAgICByYW5nZXMgb2YgdGhlIHBhZ2VzIGFyZSBzcXVhc2hlZCBpbnRvIGEgc2lu Z2xlIHNjYXR0ZXJsaXN0IG5vZGUuIEEgdXNlcgorICogICAgbWF5IHByb3ZpZGUgYW4gb2Zmc2V0 IGF0IGEgc3RhcnQgYW5kIGEgc2l6ZSBvZiB2YWxpZCBkYXRhIGluIGEgYnVmZmVyCisgKiAgICBz cGVjaWZpZWQgYnkgdGhlIHBhZ2UgYXJyYXkuIFRoZSByZXR1cm5lZCBzZyB0YWJsZSBpcyByZWxl YXNlZCBieQorICogICAgc2dfZnJlZV90YWJsZS4KKyAqCisgKiBSZXR1cm5zOgorICogICAwIG9u IHN1Y2Nlc3MsIG5lZ2F0aXZlIGVycm9yIG9uIGZhaWx1cmUKKyAqLworaW50IHNnX2FsbG9jX3Rh YmxlX2Zyb21fcGFnZXMoc3RydWN0IHNnX3RhYmxlICpzZ3QsIHN0cnVjdCBwYWdlICoqcGFnZXMs CisJCQkgICAgICB1bnNpZ25lZCBpbnQgbl9wYWdlcywgdW5zaWduZWQgaW50IG9mZnNldCwKKwkJ CSAgICAgIHVuc2lnbmVkIGxvbmcgc2l6ZSwgZ2ZwX3QgZ2ZwX21hc2spCit7CisJcmV0dXJuIF9f c2dfYWxsb2NfdGFibGVfZnJvbV9wYWdlcyhzZ3QsIHBhZ2VzLCBuX3BhZ2VzLCBvZmZzZXQsIHNp emUsCisJCQkJCSAgIFNDQVRURVJMSVNUX01BWF9TRUdNRU5ULCBnZnBfbWFzayk7Cit9CiBFWFBP UlRfU1lNQk9MKHNnX2FsbG9jX3RhYmxlX2Zyb21fcGFnZXMpOwogCiB2b2lkIF9fc2dfcGFnZV9p dGVyX3N0YXJ0KHN0cnVjdCBzZ19wYWdlX2l0ZXIgKnBpdGVyLAotLSAKMi45LjMKCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCkludGVsLWdmeCBtYWlsaW5n IGxpc3QKSW50ZWwtZ2Z4QGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVk ZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2ludGVsLWdmeAo= From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754602AbdEDPzB (ORCPT ); Thu, 4 May 2017 11:55:01 -0400 Received: from mail-wm0-f66.google.com ([74.125.82.66]:36498 "EHLO mail-wm0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751746AbdEDPyR (ORCPT ); Thu, 4 May 2017 11:54:17 -0400 From: Tvrtko Ursulin X-Google-Original-From: Tvrtko Ursulin To: Intel-gfx@lists.freedesktop.org Cc: tursulin@ursulin.net, Tvrtko Ursulin , Masahiro Yamada , linux-kernel@vger.kernel.org, Chris Wilson , Joonas Lahtinen Subject: [PATCH 3/4] lib/scatterlist: Introduce and export __sg_alloc_table_from_pages Date: Thu, 4 May 2017 16:54:04 +0100 Message-Id: <20170504155405.7425-3-tvrtko.ursulin@linux.intel.com> X-Mailer: git-send-email 2.9.3 In-Reply-To: <20170504155405.7425-1-tvrtko.ursulin@linux.intel.com> References: <20170504155405.7425-1-tvrtko.ursulin@linux.intel.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Tvrtko Ursulin Drivers like i915 benefit from being able to control the maxium size of the sg coallesced segment while building the scatter- gather list. Introduce and export the __sg_alloc_table_from_pages function which will allow it that control. v2: Reorder parameters. (Chris Wilson) v3: Fix incomplete reordering in v2. v4: max_segment needs to be page aligned. v5: Rebase. v6: Rebase. Signed-off-by: Tvrtko Ursulin Cc: Masahiro Yamada Cc: linux-kernel@vger.kernel.org Cc: Chris Wilson Reviewed-by: Chris Wilson (v2) Cc: Joonas Lahtinen --- include/linux/scatterlist.h | 11 +++++---- lib/scatterlist.c | 58 +++++++++++++++++++++++++++++++++++---------- 2 files changed, 52 insertions(+), 17 deletions(-) diff --git a/include/linux/scatterlist.h b/include/linux/scatterlist.h index 4768eeeb7054..4d67a9652c7d 100644 --- a/include/linux/scatterlist.h +++ b/include/linux/scatterlist.h @@ -267,10 +267,13 @@ void sg_free_table(struct sg_table *); int __sg_alloc_table(struct sg_table *, unsigned int, unsigned int, struct scatterlist *, gfp_t, sg_alloc_fn *); int sg_alloc_table(struct sg_table *, unsigned int, gfp_t); -int sg_alloc_table_from_pages(struct sg_table *sgt, - struct page **pages, unsigned int n_pages, - unsigned int offset, unsigned long size, - gfp_t gfp_mask); +int __sg_alloc_table_from_pages(struct sg_table *sgt, struct page **pages, + unsigned int n_pages, unsigned int offset, + unsigned long size, unsigned int max_segment, + gfp_t gfp_mask); +int sg_alloc_table_from_pages(struct sg_table *sgt, struct page **pages, + unsigned int n_pages, unsigned int offset, + unsigned long size, gfp_t gfp_mask); size_t sg_copy_buffer(struct scatterlist *sgl, unsigned int nents, void *buf, size_t buflen, off_t skip, bool to_buffer); diff --git a/lib/scatterlist.c b/lib/scatterlist.c index ca4ccd8c80b9..73dace1bd5bb 100644 --- a/lib/scatterlist.c +++ b/lib/scatterlist.c @@ -370,14 +370,15 @@ int sg_alloc_table(struct sg_table *table, unsigned int nents, gfp_t gfp_mask) EXPORT_SYMBOL(sg_alloc_table); /** - * sg_alloc_table_from_pages - Allocate and initialize an sg table from - * an array of pages - * @sgt: The sg table header to use - * @pages: Pointer to an array of page pointers - * @n_pages: Number of pages in the pages array - * @offset: Offset from start of the first page to the start of a buffer - * @size: Number of valid bytes in the buffer (after offset) - * @gfp_mask: GFP allocation mask + * __sg_alloc_table_from_pages - Allocate and initialize an sg table from + * an array of pages + * @sgt: The sg table header to use + * @pages: Pointer to an array of page pointers + * @n_pages: Number of pages in the pages array + * @offset: Offset from start of the first page to the start of a buffer + * @size: Number of valid bytes in the buffer (after offset) + * @max_segment: Maximum size of a scatterlist node in bytes (page aligned) + * @gfp_mask: GFP allocation mask * * Description: * Allocate and initialize an sg table from a list of pages. Contiguous @@ -389,16 +390,18 @@ EXPORT_SYMBOL(sg_alloc_table); * Returns: * 0 on success, negative error on failure */ -int sg_alloc_table_from_pages(struct sg_table *sgt, - struct page **pages, unsigned int n_pages, - unsigned int offset, unsigned long size, - gfp_t gfp_mask) +int __sg_alloc_table_from_pages(struct sg_table *sgt, struct page **pages, + unsigned int n_pages, unsigned int offset, + unsigned long size, unsigned int max_segment, + gfp_t gfp_mask) { - const unsigned int max_segment = SCATTERLIST_MAX_SEGMENT; unsigned int chunks, cur_page, seg_len, i; int ret; struct scatterlist *s; + if (WARN_ON(!max_segment || offset_in_page(max_segment))) + return -EINVAL; + /* compute number of contiguous chunks */ chunks = 1; seg_len = 0; @@ -440,6 +443,35 @@ int sg_alloc_table_from_pages(struct sg_table *sgt, return 0; } +EXPORT_SYMBOL(__sg_alloc_table_from_pages); + +/** + * sg_alloc_table_from_pages - Allocate and initialize an sg table from + * an array of pages + * @sgt: The sg table header to use + * @pages: Pointer to an array of page pointers + * @n_pages: Number of pages in the pages array + * @offset: Offset from start of the first page to the start of a buffer + * @size: Number of valid bytes in the buffer (after offset) + * @gfp_mask: GFP allocation mask + * + * Description: + * Allocate and initialize an sg table from a list of pages. Contiguous + * ranges of the pages are squashed into a single scatterlist node. A user + * may provide an offset at a start and a size of valid data in a buffer + * specified by the page array. The returned sg table is released by + * sg_free_table. + * + * Returns: + * 0 on success, negative error on failure + */ +int sg_alloc_table_from_pages(struct sg_table *sgt, struct page **pages, + unsigned int n_pages, unsigned int offset, + unsigned long size, gfp_t gfp_mask) +{ + return __sg_alloc_table_from_pages(sgt, pages, n_pages, offset, size, + SCATTERLIST_MAX_SEGMENT, gfp_mask); +} EXPORT_SYMBOL(sg_alloc_table_from_pages); void __sg_page_iter_start(struct sg_page_iter *piter, -- 2.9.3