From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.2 required=3.0 tests=BAYES_00,DATE_IN_PAST_06_12, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8E691C433E0 for ; Sun, 28 Feb 2021 06:44:12 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 48FF864DF4 for ; Sun, 28 Feb 2021 06:44:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230476AbhB1GoB (ORCPT ); Sun, 28 Feb 2021 01:44:01 -0500 Received: from mga09.intel.com ([134.134.136.24]:58903 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230481AbhB1GnT (ORCPT ); Sun, 28 Feb 2021 01:43:19 -0500 IronPort-SDR: QO4xzewiJk5svwr3GD5XziLOu48NaW7ZEQPRN02k7N42+iGCOYoiApqLfBubcd26VEH6XjK6Fx 8AKVEfR6q8Uw== X-IronPort-AV: E=McAfee;i="6000,8403,9908"; a="186323913" X-IronPort-AV: E=Sophos;i="5.81,211,1610438400"; d="scan'208";a="186323913" Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Feb 2021 22:33:10 -0800 IronPort-SDR: +T9STUHvLgHVslt36fIQ9N1GTV3VmJPU6OiRU8iSdNDzlrfPpN5eh7OC/N9+5nDbwaEX2Eb53X +8ZVL72C19YA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.81,211,1610438400"; d="scan'208";a="517029746" Received: from otc-wp-03.jf.intel.com ([10.54.39.79]) by orsmga004.jf.intel.com with ESMTP; 27 Feb 2021 22:33:10 -0800 From: Jacob Pan To: LKML , Joerg Roedel , "Lu Baolu" , David Woodhouse , iommu@lists.linux-foundation.org, cgroups@vger.kernel.org, Tejun Heo , Li Zefan , Johannes Weiner , Jean-Philippe Brucker Cc: Alex Williamson , Eric Auger , Jason Gunthorpe , Jonathan Corbet , Raj Ashok , "Tian, Kevin" , Yi Liu , Wu Hao , Dave Jiang , Jacob Pan Subject: [RFC PATCH 17/18] docs: cgroup-v1: Add IOASIDs controller Date: Sat, 27 Feb 2021 14:01:25 -0800 Message-Id: <1614463286-97618-18-git-send-email-jacob.jun.pan@linux.intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1614463286-97618-1-git-send-email-jacob.jun.pan@linux.intel.com> References: <1614463286-97618-1-git-send-email-jacob.jun.pan@linux.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Signed-off-by: Jacob Pan --- Documentation/admin-guide/cgroup-v1/index.rst | 1 + .../admin-guide/cgroup-v1/ioasids.rst | 110 ++++++++++++++++++ 2 files changed, 111 insertions(+) create mode 100644 Documentation/admin-guide/cgroup-v1/ioasids.rst diff --git a/Documentation/admin-guide/cgroup-v1/index.rst b/Documentation/admin-guide/cgroup-v1/index.rst index 226f64473e8e..f5e307dc4dbb 100644 --- a/Documentation/admin-guide/cgroup-v1/index.rst +++ b/Documentation/admin-guide/cgroup-v1/index.rst @@ -15,6 +15,7 @@ Control Groups version 1 devices freezer-subsystem hugetlb + ioasids memcg_test memory net_cls diff --git a/Documentation/admin-guide/cgroup-v1/ioasids.rst b/Documentation/admin-guide/cgroup-v1/ioasids.rst new file mode 100644 index 000000000000..b30eb41bf1be --- /dev/null +++ b/Documentation/admin-guide/cgroup-v1/ioasids.rst @@ -0,0 +1,110 @@ +======================================== +I/O Address Space ID (IOASID) Controller +======================================== + +Acronyms +-------- +PASID: + Process Address Space ID, defined by PCIe +SVA: + Shared Virtual Address + +Introduction +------------ + +IOASIDs are used to associate DMA requests with virtual address spaces. As +a system-wide limited¹ resource, its constraints are managed by the IOASIDs +cgroup subsystem. The specific use cases are: + +1. Some user applications exhaust all the available IOASIDs thus depriving + others of the same host. + +2. System admins need to provision VMs based on their needs for IOASIDs, + e.g. the number of VMs with assigned devices that perform DMA requests + with PASID. + +The IOASID subsystem consists of three components: + +- IOASID core: provides APIs for allocation, pool management, + notifications and refcounting. See Documentation/driver-api/ioasid.rst + for details +- IOASID user: provides user allocation interface via /dev/ioasid +- IOASID cgroup controller: manage resource distribution + +Resource Distribution Model +--------------------------- +IOASID allocation is process-based in that IOASIDs are tied to page tables², +the threaded model is not supported. The allocation is rejected by the +cgroup hierarchy once a limit is reached. However, organizational changes +such as moving processes across cgroups are exempted. Therefore, it is +possible to have ioasids.current > ioasids.max. It is not possible to do +further allocation after the organizational change that exceeds the max. + +The system capacity of the IOASIDs is default to PCIe PASID size of 20 bits. +IOASID core provides API to adjust the system capacity based on platforms. +IOASIDs are used by both user applications (e.g. VMs and userspace drivers) +and kernel (e.g. supervisor SVA). However, only user allocation is subject +to cgroup constraints. Host kernel allocates a pool of IOASIDs where its +quota is subtracted from the system capacity. IOASIDs cgroup consults with +the IOASID core for available capacity when a new cgroup limit is granted. +Upon creation, no IOASID allocation is allowed by the user processes within +the new cgroup. + +Usage +----- +CGroup filesystem has the following IOASIDs controller specific entries: +:: + + ioasids.current + ioasids.events + ioasids.max + +To use the IOASIDs controller, set ioasids.max to the limit of the number +of IOASIDs that can be allocated. The file ioasids.current shows the current +number of IOASIDs allocated within the cgroup. + +Example +-------- +1. Mount the cgroup2 FS :: + + $ mount -t cgroup2 none /mnt/cg2/ + +2. Add ioasids controller :: + + $ echo '+ioasids' > /mnt/cg2/cgroup.subtree_control + +3. Create a hierarchy, set non-zero limit (default 0) :: + + $ mkdir /mnt/cg2/test1 + $ echo 5 > /mnt/cg2/test1/ioasids.max + +4. Allocate IOASIDs within limit should succeed :: + + $echo $$ > /mnt/cg2/test1/cgroup.procs + Do IOASID allocation via /dev/ioasid + ioasids.current:1 + ioasids.max:5 + +5. Attempt to allocate IOASIDs beyond limit should fail :: + + ioasids.current:5 + ioasids.max:5 + +6. Attach a new process with IOASID already allocated to a cgroup could +result in ioasids.current > ioasids.max, e.g. process with PID 1234 under +a cgroup with IOASIDs controller has one IOASID allocated, moving it to +test1 cgroup :: + + $echo 1234 > /mnt/cg2/test1/cgroup.procs + ioasids.current:6 + ioasids.max:5 + +Notes +----- +¹ When IOASID is used for PCI Express PASID, the range is limited to the +PASID size of 20 bits. For a device that its resources can be shared across +the platform, the IOASID namespace must be system-wide in order to uniquely +identify DMA request with PASID inside the device. + +² The primary use case is SVA, where CPU page tables are shared with DMA via +IOMMU. -- 2.25.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.2 required=3.0 tests=BAYES_00,DATE_IN_PAST_06_12, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 34617C433E9 for ; Sun, 28 Feb 2021 06:33:25 +0000 (UTC) Received: from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id E0E1564E55 for ; Sun, 28 Feb 2021 06:33:24 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org E0E1564E55 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linux.intel.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=iommu-bounces@lists.linux-foundation.org Received: from localhost (localhost [127.0.0.1]) by smtp3.osuosl.org (Postfix) with ESMTP id 8CD786F99E; Sun, 28 Feb 2021 06:33:24 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp3.osuosl.org ([127.0.0.1]) by localhost (smtp3.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id zkuKShJt7Hnp; Sun, 28 Feb 2021 06:33:22 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by smtp3.osuosl.org (Postfix) with ESMTP id 521526F943; Sun, 28 Feb 2021 06:33:22 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 822B8C0018; Sun, 28 Feb 2021 06:33:21 +0000 (UTC) Received: from smtp2.osuosl.org (smtp2.osuosl.org [140.211.166.133]) by lists.linuxfoundation.org (Postfix) with ESMTP id 7B473C000E for ; Sun, 28 Feb 2021 06:33:14 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp2.osuosl.org (Postfix) with ESMTP id 69A2341468 for ; Sun, 28 Feb 2021 06:33:13 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp2.osuosl.org ([127.0.0.1]) by localhost (smtp2.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 0Fq-KcdJh3kf for ; Sun, 28 Feb 2021 06:33:12 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.8.0 Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by smtp2.osuosl.org (Postfix) with ESMTPS id B5ACF43150 for ; Sun, 28 Feb 2021 06:33:12 +0000 (UTC) IronPort-SDR: CyQ7yigQ212tG6avFdMi1UGiXHrAbudUqbZhnOzBbOXsRm64FPDRpXN27GCo8OyaVa0gYrgI3k 73L2zbRPq0nw== X-IronPort-AV: E=McAfee;i="6000,8403,9908"; a="247624819" X-IronPort-AV: E=Sophos;i="5.81,211,1610438400"; d="scan'208";a="247624819" Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Feb 2021 22:33:10 -0800 IronPort-SDR: +T9STUHvLgHVslt36fIQ9N1GTV3VmJPU6OiRU8iSdNDzlrfPpN5eh7OC/N9+5nDbwaEX2Eb53X +8ZVL72C19YA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.81,211,1610438400"; d="scan'208";a="517029746" Received: from otc-wp-03.jf.intel.com ([10.54.39.79]) by orsmga004.jf.intel.com with ESMTP; 27 Feb 2021 22:33:10 -0800 From: Jacob Pan To: LKML , Joerg Roedel , "Lu Baolu" , David Woodhouse , iommu@lists.linux-foundation.org, cgroups@vger.kernel.org, Tejun Heo , Li Zefan , Johannes Weiner , Jean-Philippe Brucker Subject: [RFC PATCH 17/18] docs: cgroup-v1: Add IOASIDs controller Date: Sat, 27 Feb 2021 14:01:25 -0800 Message-Id: <1614463286-97618-18-git-send-email-jacob.jun.pan@linux.intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1614463286-97618-1-git-send-email-jacob.jun.pan@linux.intel.com> References: <1614463286-97618-1-git-send-email-jacob.jun.pan@linux.intel.com> MIME-Version: 1.0 Cc: "Tian, Kevin" , Dave Jiang , Raj Ashok , Jonathan Corbet , Alex Williamson , Jason Gunthorpe , Wu Hao X-BeenThere: iommu@lists.linux-foundation.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: Development issues for Linux IOMMU support List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: iommu-bounces@lists.linux-foundation.org Sender: "iommu" U2lnbmVkLW9mZi1ieTogSmFjb2IgUGFuIDxqYWNvYi5qdW4ucGFuQGxpbnV4LmludGVsLmNvbT4K LS0tCiBEb2N1bWVudGF0aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pbmRleC5yc3QgfCAgIDEg KwogLi4uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pb2FzaWRzLnJzdCAgICAgICAgIHwgMTEwICsr KysrKysrKysrKysrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCAxMTEgaW5zZXJ0aW9ucygrKQogY3Jl YXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24vYWRtaW4tZ3VpZGUvY2dyb3VwLXYxL2lvYXNp ZHMucnN0CgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEv aW5kZXgucnN0IGIvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW5kZXgucnN0 CmluZGV4IDIyNmY2NDQ3M2U4ZS4uZjVlMzA3ZGM0ZGJiIDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0 aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pbmRleC5yc3QKKysrIGIvRG9jdW1lbnRhdGlvbi9h ZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW5kZXgucnN0CkBAIC0xNSw2ICsxNSw3IEBAIENvbnRyb2wg R3JvdXBzIHZlcnNpb24gMQogICAgIGRldmljZXMKICAgICBmcmVlemVyLXN1YnN5c3RlbQogICAg IGh1Z2V0bGIKKyAgICBpb2FzaWRzCiAgICAgbWVtY2dfdGVzdAogICAgIG1lbW9yeQogICAgIG5l dF9jbHMKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vYWRtaW4tZ3VpZGUvY2dyb3VwLXYxL2lv YXNpZHMucnN0IGIvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW9hc2lkcy5y c3QKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMDAwMDAwLi5iMzBlYjQxYmYxYmUK LS0tIC9kZXYvbnVsbAorKysgYi9Eb2N1bWVudGF0aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9p b2FzaWRzLnJzdApAQCAtMCwwICsxLDExMCBAQAorPT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PQorSS9PIEFkZHJlc3MgU3BhY2UgSUQgKElPQVNJRCkgQ29udHJvbGxlcgor PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQorCitBY3JvbnltcworLS0t LS0tLS0KK1BBU0lEOgorCVByb2Nlc3MgQWRkcmVzcyBTcGFjZSBJRCwgZGVmaW5lZCBieSBQQ0ll CitTVkE6CisJU2hhcmVkIFZpcnR1YWwgQWRkcmVzcworCitJbnRyb2R1Y3Rpb24KKy0tLS0tLS0t LS0tLQorCitJT0FTSURzIGFyZSB1c2VkIHRvIGFzc29jaWF0ZSBETUEgcmVxdWVzdHMgd2l0aCB2 aXJ0dWFsIGFkZHJlc3Mgc3BhY2VzLiBBcworYSBzeXN0ZW0td2lkZSBsaW1pdGVkwrkgcmVzb3Vy Y2UsIGl0cyBjb25zdHJhaW50cyBhcmUgbWFuYWdlZCBieSB0aGUgSU9BU0lEcworY2dyb3VwIHN1 YnN5c3RlbS4gVGhlIHNwZWNpZmljIHVzZSBjYXNlcyBhcmU6CisKKzEuIFNvbWUgdXNlciBhcHBs aWNhdGlvbnMgZXhoYXVzdCBhbGwgdGhlIGF2YWlsYWJsZSBJT0FTSURzIHRodXMgZGVwcml2aW5n CisgICBvdGhlcnMgb2YgdGhlIHNhbWUgaG9zdC4KKworMi4gU3lzdGVtIGFkbWlucyBuZWVkIHRv IHByb3Zpc2lvbiBWTXMgYmFzZWQgb24gdGhlaXIgbmVlZHMgZm9yIElPQVNJRHMsCisgICBlLmcu IHRoZSBudW1iZXIgb2YgVk1zIHdpdGggYXNzaWduZWQgZGV2aWNlcyB0aGF0IHBlcmZvcm0gRE1B IHJlcXVlc3RzCisgICB3aXRoIFBBU0lELgorCitUaGUgSU9BU0lEIHN1YnN5c3RlbSBjb25zaXN0 cyBvZiB0aHJlZSBjb21wb25lbnRzOgorCistIElPQVNJRCBjb3JlOiBwcm92aWRlcyBBUElzIGZv ciBhbGxvY2F0aW9uLCBwb29sIG1hbmFnZW1lbnQsCisgIG5vdGlmaWNhdGlvbnMgYW5kIHJlZmNv dW50aW5nLiBTZWUgRG9jdW1lbnRhdGlvbi9kcml2ZXItYXBpL2lvYXNpZC5yc3QKKyAgZm9yIGRl dGFpbHMKKy0gSU9BU0lEIHVzZXI6ICBwcm92aWRlcyB1c2VyIGFsbG9jYXRpb24gaW50ZXJmYWNl IHZpYSAvZGV2L2lvYXNpZAorLSBJT0FTSUQgY2dyb3VwIGNvbnRyb2xsZXI6IG1hbmFnZSByZXNv dXJjZSBkaXN0cmlidXRpb24KKworUmVzb3VyY2UgRGlzdHJpYnV0aW9uIE1vZGVsCistLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0KK0lPQVNJRCBhbGxvY2F0aW9uIGlzIHByb2Nlc3MtYmFzZWQg aW4gdGhhdCBJT0FTSURzIGFyZSB0aWVkIHRvIHBhZ2UgdGFibGVzwrIsCit0aGUgdGhyZWFkZWQg bW9kZWwgaXMgbm90IHN1cHBvcnRlZC4gVGhlIGFsbG9jYXRpb24gaXMgcmVqZWN0ZWQgYnkgdGhl CitjZ3JvdXAgaGllcmFyY2h5IG9uY2UgYSBsaW1pdCBpcyByZWFjaGVkLiBIb3dldmVyLCBvcmdh bml6YXRpb25hbCBjaGFuZ2VzCitzdWNoIGFzIG1vdmluZyBwcm9jZXNzZXMgYWNyb3NzIGNncm91 cHMgYXJlIGV4ZW1wdGVkLiBUaGVyZWZvcmUsIGl0IGlzCitwb3NzaWJsZSB0byBoYXZlIGlvYXNp ZHMuY3VycmVudCA+IGlvYXNpZHMubWF4LiBJdCBpcyBub3QgcG9zc2libGUgdG8gZG8KK2Z1cnRo ZXIgYWxsb2NhdGlvbiBhZnRlciB0aGUgb3JnYW5pemF0aW9uYWwgY2hhbmdlIHRoYXQgZXhjZWVk cyB0aGUgbWF4LgorCitUaGUgc3lzdGVtIGNhcGFjaXR5IG9mIHRoZSBJT0FTSURzIGlzIGRlZmF1 bHQgdG8gUENJZSBQQVNJRCBzaXplIG9mIDIwIGJpdHMuCitJT0FTSUQgY29yZSBwcm92aWRlcyBB UEkgdG8gYWRqdXN0IHRoZSBzeXN0ZW0gY2FwYWNpdHkgYmFzZWQgb24gcGxhdGZvcm1zLgorSU9B U0lEcyBhcmUgdXNlZCBieSBib3RoIHVzZXIgYXBwbGljYXRpb25zIChlLmcuIFZNcyBhbmQgdXNl cnNwYWNlIGRyaXZlcnMpCithbmQga2VybmVsIChlLmcuIHN1cGVydmlzb3IgU1ZBKS4gSG93ZXZl ciwgb25seSB1c2VyIGFsbG9jYXRpb24gaXMgc3ViamVjdAordG8gY2dyb3VwIGNvbnN0cmFpbnRz LiBIb3N0IGtlcm5lbCBhbGxvY2F0ZXMgYSBwb29sIG9mIElPQVNJRHMgd2hlcmUgaXRzCitxdW90 YSBpcyBzdWJ0cmFjdGVkIGZyb20gdGhlIHN5c3RlbSBjYXBhY2l0eS4gSU9BU0lEcyBjZ3JvdXAg Y29uc3VsdHMgd2l0aAordGhlIElPQVNJRCBjb3JlIGZvciBhdmFpbGFibGUgY2FwYWNpdHkgd2hl biBhIG5ldyBjZ3JvdXAgbGltaXQgaXMgZ3JhbnRlZC4KK1Vwb24gY3JlYXRpb24sIG5vIElPQVNJ RCBhbGxvY2F0aW9uIGlzIGFsbG93ZWQgYnkgdGhlIHVzZXIgcHJvY2Vzc2VzIHdpdGhpbgordGhl IG5ldyBjZ3JvdXAuCisKK1VzYWdlCistLS0tLQorQ0dyb3VwIGZpbGVzeXN0ZW0gaGFzIHRoZSBm b2xsb3dpbmcgSU9BU0lEcyBjb250cm9sbGVyIHNwZWNpZmljIGVudHJpZXM6Cis6OgorCisgaW9h c2lkcy5jdXJyZW50CisgaW9hc2lkcy5ldmVudHMKKyBpb2FzaWRzLm1heAorCitUbyB1c2UgdGhl IElPQVNJRHMgY29udHJvbGxlciwgc2V0IGlvYXNpZHMubWF4IHRvIHRoZSBsaW1pdCBvZiB0aGUg bnVtYmVyCitvZiBJT0FTSURzIHRoYXQgY2FuIGJlIGFsbG9jYXRlZC4gVGhlIGZpbGUgaW9hc2lk cy5jdXJyZW50IHNob3dzIHRoZSBjdXJyZW50CitudW1iZXIgb2YgSU9BU0lEcyBhbGxvY2F0ZWQg d2l0aGluIHRoZSBjZ3JvdXAuCisKK0V4YW1wbGUKKy0tLS0tLS0tCisxLiBNb3VudCB0aGUgY2dy b3VwMiBGUyA6OgorCisJJCBtb3VudCAtdCBjZ3JvdXAyIG5vbmUgL21udC9jZzIvCisKKzIuIEFk ZCBpb2FzaWRzIGNvbnRyb2xsZXIgOjoKKworCSQgZWNobyAnK2lvYXNpZHMnID4gL21udC9jZzIv Y2dyb3VwLnN1YnRyZWVfY29udHJvbAorCiszLiBDcmVhdGUgYSBoaWVyYXJjaHksIHNldCBub24t emVybyBsaW1pdCAoZGVmYXVsdCAwKSA6OgorCisJJCBta2RpciAvbW50L2NnMi90ZXN0MQorCSQg ZWNobyA1ID4gL21udC9jZzIvdGVzdDEvaW9hc2lkcy5tYXgKKworNC4gQWxsb2NhdGUgSU9BU0lE cyB3aXRoaW4gbGltaXQgc2hvdWxkIHN1Y2NlZWQgOjoKKworCSRlY2hvICQkID4gL21udC9jZzIv dGVzdDEvY2dyb3VwLnByb2NzCisJRG8gSU9BU0lEIGFsbG9jYXRpb24gdmlhIC9kZXYvaW9hc2lk CisJaW9hc2lkcy5jdXJyZW50OjEKKwlpb2FzaWRzLm1heDo1CisKKzUuIEF0dGVtcHQgdG8gYWxs b2NhdGUgSU9BU0lEcyBiZXlvbmQgbGltaXQgc2hvdWxkIGZhaWwgOjoKKworCWlvYXNpZHMuY3Vy cmVudDo1CisJaW9hc2lkcy5tYXg6NQorCis2LiBBdHRhY2ggYSBuZXcgcHJvY2VzcyB3aXRoIElP QVNJRCBhbHJlYWR5IGFsbG9jYXRlZCB0byBhIGNncm91cCBjb3VsZAorcmVzdWx0IGluIGlvYXNp ZHMuY3VycmVudCA+IGlvYXNpZHMubWF4LCBlLmcuIHByb2Nlc3Mgd2l0aCBQSUQgMTIzNCB1bmRl cgorYSBjZ3JvdXAgd2l0aCBJT0FTSURzIGNvbnRyb2xsZXIgaGFzIG9uZSBJT0FTSUQgYWxsb2Nh dGVkLCBtb3ZpbmcgaXQgdG8KK3Rlc3QxIGNncm91cCA6OgorCisJJGVjaG8gMTIzNCA+IC9tbnQv Y2cyL3Rlc3QxL2Nncm91cC5wcm9jcworCWlvYXNpZHMuY3VycmVudDo2CisJaW9hc2lkcy5tYXg6 NQorCitOb3RlcworLS0tLS0KK8K5IFdoZW4gSU9BU0lEIGlzIHVzZWQgZm9yIFBDSSBFeHByZXNz IFBBU0lELCB0aGUgcmFuZ2UgaXMgbGltaXRlZCB0byB0aGUKK1BBU0lEIHNpemUgb2YgMjAgYml0 cy4gRm9yIGEgZGV2aWNlIHRoYXQgaXRzIHJlc291cmNlcyBjYW4gYmUgc2hhcmVkIGFjcm9zcwor dGhlIHBsYXRmb3JtLCB0aGUgSU9BU0lEIG5hbWVzcGFjZSBtdXN0IGJlIHN5c3RlbS13aWRlIGlu IG9yZGVyIHRvIHVuaXF1ZWx5CitpZGVudGlmeSBETUEgcmVxdWVzdCB3aXRoIFBBU0lEIGluc2lk ZSB0aGUgZGV2aWNlLgorCivCsiBUaGUgcHJpbWFyeSB1c2UgY2FzZSBpcyBTVkEsIHdoZXJlIENQ VSBwYWdlIHRhYmxlcyBhcmUgc2hhcmVkIHdpdGggRE1BIHZpYQorSU9NTVUuCi0tIAoyLjI1LjEK Cl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmlvbW11IG1h aWxpbmcgbGlzdAppb21tdUBsaXN0cy5saW51eC1mb3VuZGF0aW9uLm9yZwpodHRwczovL2xpc3Rz LmxpbnV4Zm91bmRhdGlvbi5vcmcvbWFpbG1hbi9saXN0aW5mby9pb21tdQ== From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jacob Pan Subject: [RFC PATCH 17/18] docs: cgroup-v1: Add IOASIDs controller Date: Sat, 27 Feb 2021 14:01:25 -0800 Message-ID: <1614463286-97618-18-git-send-email-jacob.jun.pan@linux.intel.com> References: <1614463286-97618-1-git-send-email-jacob.jun.pan@linux.intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1614463286-97618-1-git-send-email-jacob.jun.pan-VuQAYsv1563Yd54FQh9/CA@public.gmane.org> List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: iommu-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org Sender: "iommu" To: LKML , Joerg Roedel , Lu Baolu , David Woodhouse , iommu-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org, cgroups-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, Tejun Heo , Li Zefan , Johannes Weiner , Jean-Philippe Brucker Cc: "Tian, Kevin" , Dave Jiang , Raj Ashok , Jonathan Corbet , Alex Williamson , Jason Gunthorpe , Wu Hao U2lnbmVkLW9mZi1ieTogSmFjb2IgUGFuIDxqYWNvYi5qdW4ucGFuQGxpbnV4LmludGVsLmNvbT4K LS0tCiBEb2N1bWVudGF0aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pbmRleC5yc3QgfCAgIDEg KwogLi4uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pb2FzaWRzLnJzdCAgICAgICAgIHwgMTEwICsr KysrKysrKysrKysrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCAxMTEgaW5zZXJ0aW9ucygrKQogY3Jl YXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24vYWRtaW4tZ3VpZGUvY2dyb3VwLXYxL2lvYXNp ZHMucnN0CgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEv aW5kZXgucnN0IGIvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW5kZXgucnN0 CmluZGV4IDIyNmY2NDQ3M2U4ZS4uZjVlMzA3ZGM0ZGJiIDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0 aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9pbmRleC5yc3QKKysrIGIvRG9jdW1lbnRhdGlvbi9h ZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW5kZXgucnN0CkBAIC0xNSw2ICsxNSw3IEBAIENvbnRyb2wg R3JvdXBzIHZlcnNpb24gMQogICAgIGRldmljZXMKICAgICBmcmVlemVyLXN1YnN5c3RlbQogICAg IGh1Z2V0bGIKKyAgICBpb2FzaWRzCiAgICAgbWVtY2dfdGVzdAogICAgIG1lbW9yeQogICAgIG5l dF9jbHMKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vYWRtaW4tZ3VpZGUvY2dyb3VwLXYxL2lv YXNpZHMucnN0IGIvRG9jdW1lbnRhdGlvbi9hZG1pbi1ndWlkZS9jZ3JvdXAtdjEvaW9hc2lkcy5y c3QKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMDAwMDAwLi5iMzBlYjQxYmYxYmUK LS0tIC9kZXYvbnVsbAorKysgYi9Eb2N1bWVudGF0aW9uL2FkbWluLWd1aWRlL2Nncm91cC12MS9p b2FzaWRzLnJzdApAQCAtMCwwICsxLDExMCBAQAorPT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PQorSS9PIEFkZHJlc3MgU3BhY2UgSUQgKElPQVNJRCkgQ29udHJvbGxlcgor PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQorCitBY3JvbnltcworLS0t LS0tLS0KK1BBU0lEOgorCVByb2Nlc3MgQWRkcmVzcyBTcGFjZSBJRCwgZGVmaW5lZCBieSBQQ0ll CitTVkE6CisJU2hhcmVkIFZpcnR1YWwgQWRkcmVzcworCitJbnRyb2R1Y3Rpb24KKy0tLS0tLS0t LS0tLQorCitJT0FTSURzIGFyZSB1c2VkIHRvIGFzc29jaWF0ZSBETUEgcmVxdWVzdHMgd2l0aCB2 aXJ0dWFsIGFkZHJlc3Mgc3BhY2VzLiBBcworYSBzeXN0ZW0td2lkZSBsaW1pdGVkwrkgcmVzb3Vy Y2UsIGl0cyBjb25zdHJhaW50cyBhcmUgbWFuYWdlZCBieSB0aGUgSU9BU0lEcworY2dyb3VwIHN1 YnN5c3RlbS4gVGhlIHNwZWNpZmljIHVzZSBjYXNlcyBhcmU6CisKKzEuIFNvbWUgdXNlciBhcHBs aWNhdGlvbnMgZXhoYXVzdCBhbGwgdGhlIGF2YWlsYWJsZSBJT0FTSURzIHRodXMgZGVwcml2aW5n CisgICBvdGhlcnMgb2YgdGhlIHNhbWUgaG9zdC4KKworMi4gU3lzdGVtIGFkbWlucyBuZWVkIHRv IHByb3Zpc2lvbiBWTXMgYmFzZWQgb24gdGhlaXIgbmVlZHMgZm9yIElPQVNJRHMsCisgICBlLmcu IHRoZSBudW1iZXIgb2YgVk1zIHdpdGggYXNzaWduZWQgZGV2aWNlcyB0aGF0IHBlcmZvcm0gRE1B IHJlcXVlc3RzCisgICB3aXRoIFBBU0lELgorCitUaGUgSU9BU0lEIHN1YnN5c3RlbSBjb25zaXN0 cyBvZiB0aHJlZSBjb21wb25lbnRzOgorCistIElPQVNJRCBjb3JlOiBwcm92aWRlcyBBUElzIGZv ciBhbGxvY2F0aW9uLCBwb29sIG1hbmFnZW1lbnQsCisgIG5vdGlmaWNhdGlvbnMgYW5kIHJlZmNv dW50aW5nLiBTZWUgRG9jdW1lbnRhdGlvbi9kcml2ZXItYXBpL2lvYXNpZC5yc3QKKyAgZm9yIGRl dGFpbHMKKy0gSU9BU0lEIHVzZXI6ICBwcm92aWRlcyB1c2VyIGFsbG9jYXRpb24gaW50ZXJmYWNl IHZpYSAvZGV2L2lvYXNpZAorLSBJT0FTSUQgY2dyb3VwIGNvbnRyb2xsZXI6IG1hbmFnZSByZXNv dXJjZSBkaXN0cmlidXRpb24KKworUmVzb3VyY2UgRGlzdHJpYnV0aW9uIE1vZGVsCistLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0KK0lPQVNJRCBhbGxvY2F0aW9uIGlzIHByb2Nlc3MtYmFzZWQg aW4gdGhhdCBJT0FTSURzIGFyZSB0aWVkIHRvIHBhZ2UgdGFibGVzwrIsCit0aGUgdGhyZWFkZWQg bW9kZWwgaXMgbm90IHN1cHBvcnRlZC4gVGhlIGFsbG9jYXRpb24gaXMgcmVqZWN0ZWQgYnkgdGhl CitjZ3JvdXAgaGllcmFyY2h5IG9uY2UgYSBsaW1pdCBpcyByZWFjaGVkLiBIb3dldmVyLCBvcmdh bml6YXRpb25hbCBjaGFuZ2VzCitzdWNoIGFzIG1vdmluZyBwcm9jZXNzZXMgYWNyb3NzIGNncm91 cHMgYXJlIGV4ZW1wdGVkLiBUaGVyZWZvcmUsIGl0IGlzCitwb3NzaWJsZSB0byBoYXZlIGlvYXNp ZHMuY3VycmVudCA+IGlvYXNpZHMubWF4LiBJdCBpcyBub3QgcG9zc2libGUgdG8gZG8KK2Z1cnRo ZXIgYWxsb2NhdGlvbiBhZnRlciB0aGUgb3JnYW5pemF0aW9uYWwgY2hhbmdlIHRoYXQgZXhjZWVk cyB0aGUgbWF4LgorCitUaGUgc3lzdGVtIGNhcGFjaXR5IG9mIHRoZSBJT0FTSURzIGlzIGRlZmF1 bHQgdG8gUENJZSBQQVNJRCBzaXplIG9mIDIwIGJpdHMuCitJT0FTSUQgY29yZSBwcm92aWRlcyBB UEkgdG8gYWRqdXN0IHRoZSBzeXN0ZW0gY2FwYWNpdHkgYmFzZWQgb24gcGxhdGZvcm1zLgorSU9B U0lEcyBhcmUgdXNlZCBieSBib3RoIHVzZXIgYXBwbGljYXRpb25zIChlLmcuIFZNcyBhbmQgdXNl cnNwYWNlIGRyaXZlcnMpCithbmQga2VybmVsIChlLmcuIHN1cGVydmlzb3IgU1ZBKS4gSG93ZXZl ciwgb25seSB1c2VyIGFsbG9jYXRpb24gaXMgc3ViamVjdAordG8gY2dyb3VwIGNvbnN0cmFpbnRz LiBIb3N0IGtlcm5lbCBhbGxvY2F0ZXMgYSBwb29sIG9mIElPQVNJRHMgd2hlcmUgaXRzCitxdW90 YSBpcyBzdWJ0cmFjdGVkIGZyb20gdGhlIHN5c3RlbSBjYXBhY2l0eS4gSU9BU0lEcyBjZ3JvdXAg Y29uc3VsdHMgd2l0aAordGhlIElPQVNJRCBjb3JlIGZvciBhdmFpbGFibGUgY2FwYWNpdHkgd2hl biBhIG5ldyBjZ3JvdXAgbGltaXQgaXMgZ3JhbnRlZC4KK1Vwb24gY3JlYXRpb24sIG5vIElPQVNJ RCBhbGxvY2F0aW9uIGlzIGFsbG93ZWQgYnkgdGhlIHVzZXIgcHJvY2Vzc2VzIHdpdGhpbgordGhl IG5ldyBjZ3JvdXAuCisKK1VzYWdlCistLS0tLQorQ0dyb3VwIGZpbGVzeXN0ZW0gaGFzIHRoZSBm b2xsb3dpbmcgSU9BU0lEcyBjb250cm9sbGVyIHNwZWNpZmljIGVudHJpZXM6Cis6OgorCisgaW9h c2lkcy5jdXJyZW50CisgaW9hc2lkcy5ldmVudHMKKyBpb2FzaWRzLm1heAorCitUbyB1c2UgdGhl IElPQVNJRHMgY29udHJvbGxlciwgc2V0IGlvYXNpZHMubWF4IHRvIHRoZSBsaW1pdCBvZiB0aGUg bnVtYmVyCitvZiBJT0FTSURzIHRoYXQgY2FuIGJlIGFsbG9jYXRlZC4gVGhlIGZpbGUgaW9hc2lk cy5jdXJyZW50IHNob3dzIHRoZSBjdXJyZW50CitudW1iZXIgb2YgSU9BU0lEcyBhbGxvY2F0ZWQg d2l0aGluIHRoZSBjZ3JvdXAuCisKK0V4YW1wbGUKKy0tLS0tLS0tCisxLiBNb3VudCB0aGUgY2dy b3VwMiBGUyA6OgorCisJJCBtb3VudCAtdCBjZ3JvdXAyIG5vbmUgL21udC9jZzIvCisKKzIuIEFk ZCBpb2FzaWRzIGNvbnRyb2xsZXIgOjoKKworCSQgZWNobyAnK2lvYXNpZHMnID4gL21udC9jZzIv Y2dyb3VwLnN1YnRyZWVfY29udHJvbAorCiszLiBDcmVhdGUgYSBoaWVyYXJjaHksIHNldCBub24t emVybyBsaW1pdCAoZGVmYXVsdCAwKSA6OgorCisJJCBta2RpciAvbW50L2NnMi90ZXN0MQorCSQg ZWNobyA1ID4gL21udC9jZzIvdGVzdDEvaW9hc2lkcy5tYXgKKworNC4gQWxsb2NhdGUgSU9BU0lE cyB3aXRoaW4gbGltaXQgc2hvdWxkIHN1Y2NlZWQgOjoKKworCSRlY2hvICQkID4gL21udC9jZzIv dGVzdDEvY2dyb3VwLnByb2NzCisJRG8gSU9BU0lEIGFsbG9jYXRpb24gdmlhIC9kZXYvaW9hc2lk CisJaW9hc2lkcy5jdXJyZW50OjEKKwlpb2FzaWRzLm1heDo1CisKKzUuIEF0dGVtcHQgdG8gYWxs b2NhdGUgSU9BU0lEcyBiZXlvbmQgbGltaXQgc2hvdWxkIGZhaWwgOjoKKworCWlvYXNpZHMuY3Vy cmVudDo1CisJaW9hc2lkcy5tYXg6NQorCis2LiBBdHRhY2ggYSBuZXcgcHJvY2VzcyB3aXRoIElP QVNJRCBhbHJlYWR5IGFsbG9jYXRlZCB0byBhIGNncm91cCBjb3VsZAorcmVzdWx0IGluIGlvYXNp ZHMuY3VycmVudCA+IGlvYXNpZHMubWF4LCBlLmcuIHByb2Nlc3Mgd2l0aCBQSUQgMTIzNCB1bmRl cgorYSBjZ3JvdXAgd2l0aCBJT0FTSURzIGNvbnRyb2xsZXIgaGFzIG9uZSBJT0FTSUQgYWxsb2Nh dGVkLCBtb3ZpbmcgaXQgdG8KK3Rlc3QxIGNncm91cCA6OgorCisJJGVjaG8gMTIzNCA+IC9tbnQv Y2cyL3Rlc3QxL2Nncm91cC5wcm9jcworCWlvYXNpZHMuY3VycmVudDo2CisJaW9hc2lkcy5tYXg6 NQorCitOb3RlcworLS0tLS0KK8K5IFdoZW4gSU9BU0lEIGlzIHVzZWQgZm9yIFBDSSBFeHByZXNz IFBBU0lELCB0aGUgcmFuZ2UgaXMgbGltaXRlZCB0byB0aGUKK1BBU0lEIHNpemUgb2YgMjAgYml0 cy4gRm9yIGEgZGV2aWNlIHRoYXQgaXRzIHJlc291cmNlcyBjYW4gYmUgc2hhcmVkIGFjcm9zcwor dGhlIHBsYXRmb3JtLCB0aGUgSU9BU0lEIG5hbWVzcGFjZSBtdXN0IGJlIHN5c3RlbS13aWRlIGlu IG9yZGVyIHRvIHVuaXF1ZWx5CitpZGVudGlmeSBETUEgcmVxdWVzdCB3aXRoIFBBU0lEIGluc2lk ZSB0aGUgZGV2aWNlLgorCivCsiBUaGUgcHJpbWFyeSB1c2UgY2FzZSBpcyBTVkEsIHdoZXJlIENQ VSBwYWdlIHRhYmxlcyBhcmUgc2hhcmVkIHdpdGggRE1BIHZpYQorSU9NTVUuCi0tIAoyLjI1LjEK Cl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmlvbW11IG1h aWxpbmcgbGlzdAppb21tdUBsaXN0cy5saW51eC1mb3VuZGF0aW9uLm9yZwpodHRwczovL2xpc3Rz LmxpbnV4Zm91bmRhdGlvbi5vcmcvbWFpbG1hbi9saXN0aW5mby9pb21tdQ==