From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S941086AbcIHWD2 (ORCPT ); Thu, 8 Sep 2016 18:03:28 -0400 Received: from mx0a-00082601.pphosted.com ([67.231.145.42]:60706 "EHLO mx0a-00082601.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932233AbcIHWD0 (ORCPT ); Thu, 8 Sep 2016 18:03:26 -0400 Date: Thu, 8 Sep 2016 15:01:20 -0700 From: Shaohua Li To: Fenghua Yu CC: Thomas Gleixner , "H. Peter Anvin" , Ingo Molnar , Tony Luck , Peter Zijlstra , Tejun Heo , Borislav Petkov , Stephane Eranian , Marcelo Tosatti , "David Carrillo-Cisneros" , Ravi V Shankar , Vikas Shivappa , Sai Prakhya , linux-kernel , x86 Subject: Re: [PATCH v2 06/33] Documentation, x86: Documentation for Intel resource allocation user interface Message-ID: <20160908220119.GA64153@shli-mbp.local> References: <1473328647-33116-1-git-send-email-fenghua.yu@intel.com> <1473328647-33116-7-git-send-email-fenghua.yu@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <1473328647-33116-7-git-send-email-fenghua.yu@intel.com> User-Agent: Mutt/1.6.1 (2016-04-27) X-Originating-IP: [2620:10d:c090:200::e:4cd0] X-ClientProxiedBy: DM3PR14CA0069.namprd14.prod.outlook.com (10.166.156.165) To SN2PR15MB0944.namprd15.prod.outlook.com (10.169.191.146) X-MS-Office365-Filtering-Correlation-Id: 13fd577c-4fbc-4078-50cf-08d3d833b157 X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB0944;2:gdLA5R/kSsdTstEiVfWJY/k9IROX+2zOWb3TRqXSU2oZpCDl+ra3bMAYmgXhuSZHWWmIoKRNEShsHH8odgQ0AI9y5TZkCG3hOZGtNdFeH982qXCGumZZia27AQt5H+ASR/0ocqCGWeHS90pg0QBn9GvU5kUcvM2ZN1UDIIqelpdwoGSDCcGMz+3kU8TB0QlT;3:uc2vXoguW97z0VHlQ2mcWZAO/xTdPvTwDlHfTI+3EVLLPKX4Anngao/GzRsogCBvO5OeGdlC3Uw/1syRpaRbjaPSRD6Nk35pfp6HLpjkNLciOr7FU5mDavMrcSP33GsO X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:SN2PR15MB0944; X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB0944;25:ag9xvcdF5ez/1JoVZiEWcynIVpyxgNso+O6RLm/lvyq4wib8pt7t2yPPam2rJ64wFy2inzMCgwNVSqUyJOiO4DP2sfZox8k6bCl7CDa/2HimGIypAe/W6iKreEb+ETEsi3Dd31kUT/yfP7vXXDpmCfT0L7lWJ/Ib1px111uQ61YU2ZGEc8octYw1naaqgmcFSegW2KJMHnAHfSM2o/AM34q7xRmtpxIh/bBWGwA/XGzT/K5uEh0Vp3omA3x3efTj05dGZQo9fCAzqZzM1BPXBk7SPqiG7mc8nQxuq3UHuzlOHd1g+mM1SkK/FhtQLSaBdvrASVqWA9Hqz0ta/yLWiTR2DbFekqGZS4TIVmLyr1BXvh28H6kCHEZxx4FgMzrGydnSKBmRfp0I6RxGO98AqBwmU3nY20BQTEiMfg8mY5q8qIiFslMTr6Ar5eLoO9EL0nAv9QQFBfaY+RWgYjMxG8VTqKYOD6Ttw/fokBskQy32lpGW9dkcgt+v860iucUtUH+WJMIOBanaQxBSv6g9G13F2PHz6Q++AlsuMaWUgkfemtqmjuRKkzKOrh8e2DM0HzGclM85ZCjQd5AihKGO8X9FLN39G/IWJ90FNzvrrXD4hFiXx2fOSJdbB50NQA+J4gGjd+1mam4L+s6+UocQEXoB+8XJRNY3DH1yoOmfC/bh1Su43wrOo0NQG52EJeBaGjDV/SWqqCTHu6W1uAy22ZkWmgjd3KOxo/RcM5CjIhQ= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB0944;31:pXkTkW+8E46PIImIHMFSmXIrFS/vLRQmjDx2ieeCk5Mpe21bfI4bTi2juCHg567LLmrXVcVNVz2AF+tkY7AIl8bNBwqsBOfasYpC/fgoIYKCuZNoYbbqYntOgzQVhiB4TLaidjKQUpbVWZS1s2WP/obUZtghrwmEP0AAqGANgOgiVdYJnLJZE7Ef0gtmb4NnKanHiMxBrZRLi+19wJsbdcrf0aRfspVvUYyRER29rhY=;20:XZ/8ZkiZ4NCZeq3BNjJjT329h1YyTq8/XHw0KdjaIXWJquOfGTQFn/kg0/ihsMOI2mlJRBtVhDCjcYkJOWkO++cYf60AwJMdhDL+4M8iecS/lzuN4mBU0pqaMecFxxvLZCue9ivLXd/8+qGcZhgKdejQQqqngQaBCYpaaCOVXZg=;4:Q6SxLoo4L81Pt//14lrLXYJEECz00maBLERdgCFUE/7GhZczt32XB/sqXOD2oh8a0P4OAhZrKwgQYOLPF1ENEHPDeLUF6TWwjaChZZ3nW1D+ATk2T/Ocou5hsgFlmqj3eUcudotn7jYKSJcqqTK/4GIOGEdZcTykk6Olgls5XS3+k1vVlrDAUKRj4enRqjUNSBcxAnYWDWu219SL7PeAhNmGqFeoL9+lFR0L8Z4jDrW4CIA6zEirHrVko/glLTp2fSFK35CBq+czLF1rjkqcDAJB78vpc3putU1WIs4tEKQ04VBOWD3oIGr3tzA3ORCURhWh9Cgkrry91kcX69g2T4R3/CxSWhRP0AKxLIkv5yL8h4l/iwFTZ9Nk+0JwPmC+EwpUT27xbdBbfcobhO2CZG7HRc8qhTJ0dhCcQWJiusCHjiSGtbqJF5RbomzNCsy6 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040176)(601004)(2401047)(8121501046)(5005006)(10201501046)(3002001);SRVR:SN2PR15MB0944;BCL:0;PCL:0;RULEID:;SRVR:SN2PR15MB0944; X-Forefront-PRVS: 00594E8DBA X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10019020)(4630300001)(6009001)(7916002)(189002)(199003)(24454002)(6116002)(86362001)(101416001)(54356999)(76176999)(110136002)(83506001)(98436002)(7846002)(92566002)(47776003)(33656002)(305945005)(50986999)(189998001)(50466002)(4001350100001)(46406003)(1076002)(5660300001)(23726003)(77096005)(586003)(42186005)(105586002)(8676002)(2906002)(81156014)(9686002)(97756001)(97736004)(81166006)(106356001)(68736007)(4326007)(19580405001)(19580395003)(2950100001)(7736002)(7416002)(18370500001)(3826002);DIR:OUT;SFP:1102;SCL:1;SRVR:SN2PR15MB0944;H:shli-mbp.local;FPR:;SPF:None;PTR:InfoNoRecords;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SN2PR15MB0944;23:uejQJTfKnhkEY0bJHo5zLAcjt8hxl4IMbYCS8rfG/?= =?us-ascii?Q?N7dK404GS/vrr4yyiiqekvEDpznhFke/qywsTvSrtwUBG1kPCc4d5tod46Iy?= =?us-ascii?Q?4RPmEZFniDJ8h0u9X+zrgS9nXWlnBh4i+AwJpI38+cAyQDJX+Emr0VYwEaf5?= =?us-ascii?Q?hAn1WiCdvoxaCMqBX6jZOUW8HVMb+yuBIdhMYQOvbEA2gbCKGuWakQ+VxNHs?= =?us-ascii?Q?Pmd7muG54xbv98CHaOxqWk4ud3H2Z664f046TV18NMSNuONm8ZBlKes/6SoN?= =?us-ascii?Q?EteanqyLSer+3c8TDFvzhjfJ0NsXgnN3tekCrUF/EENwF3FzkzTy1wS7kOhF?= =?us-ascii?Q?1vJECnhN/8vWamhZBMHErOA2pWGMEroxFE0ylz/ooh4b+UlquCVw/jfPiczT?= =?us-ascii?Q?hs0HaP3gTQ4At7cNxvhm8kIAyWz+lqWh4R//fPXbzhiaBwtfBNy4Zbq5ZSkI?= =?us-ascii?Q?xZNp0qgV+DZl2nFOMOu/y2AOC/K+u31hkyFcJ5SggUsxjnFzi3QUXYkoWl0n?= =?us-ascii?Q?pgEN8RGxg2wKXzmkHVS1Qjy+CuR9VjaDXO57mja8aRPAViO92f/hSFaXmRlK?= =?us-ascii?Q?QkFe4FFCOvsyANrBLLBtgKBgkqeOdipwq5rX7raMNUnf9bSU+54AXi71X0Xh?= =?us-ascii?Q?dFcQBR/CFntVVT/FXTKw1c3FbOcThvLQiNY3eGo9NDO/r13qOxACx50xRKQE?= =?us-ascii?Q?4pB5W350rOibgUqIaJJHAUsCky0fTIw59QQkuSUZxAcAE9AKWnMCJ9EzGfDY?= =?us-ascii?Q?Nskv55feIYd4IXbdPzp/De/bjv7jtPHN/zvtuhVttDwwIsG+qov/Qj/eLLc2?= =?us-ascii?Q?Y9VjINID/T9ylc45GKYbYwvAHhbk7nr0xS6kKCNSVADxm7Qqgs8i5VaJ3uPH?= =?us-ascii?Q?z4ppQURXksWh+mgjRgX++dJnwp1TqQrlr26OJdLZYPhueStPvJCTVAHHZ/lp?= =?us-ascii?Q?crrPH8GhW+rVONeb7McpD0vGoF9TervBWXrYnT8v3UEWBNrDqjf8qXQtWwBN?= =?us-ascii?Q?k8Oi4OZIej54WS06iV0ZJ5345X1Pzhh5QUv58+al/ezMLHp51dMtR4b6vNGW?= =?us-ascii?Q?Gyy96+sq0n5cWIKMhx3z1Ai3FNdfcC/Wq7OqgdQn52NT/ZhZXofvbPsGm1Ja?= =?us-ascii?Q?+s6b093ozF0DDiji1pC25A/9rqoV7LxYYjrtpzk0n6mWE7kc0AyR+5HdTiQ4?= =?us-ascii?Q?KFtTZr6Lr8vesMKipSF5Jx7FyXGPCz5yGpp?= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB0944;6:r9THRZ2tVOX8u0g2kST70389Jz8CLnYD6mNQs/MS4VcJbzNQFWiN3MTGGI7YLZi9Bd/OoymlygX5eLPXJn5LRO7NKnSYJCq1AnSEvi/7TrLR98Pcd1FehLYtq6/xzDmeONBeioeSKb0CDuxLOqjiePtsK2jbQNvqE+mZl8DoU4OuJ3Wkdmausj4qbumD+q0ewwJ+CxJ70mUQ2LXT176Ll4czhtTMqI3flhAPV9qMNK1UAzqMvf/WcDEBbozlyOtGxa0HPCTeNDJTDkfQOS2PoABwDcPcBAUzL4JOdDew66w=;5:JprMQMzRlljeeZC8WvJqva0x12Lo7uIFiM+cab3pwfph4obA96y6bwNEAJxfD0u0dhR4EGkkuXgGi2sw2GCw9xqpW1ueb4L9HHmsSWffOHJlCLO8EmqqiDoi45wtRnNmgjgYYngboxtOaDd59ku5qA==;24:PmVzl+YL9GHUFz9s1lRT4FTzXCpR7PfF/q04MzSVe6S5vH94kFWs0QPQxp7xeW/9uEus5rkpBut+g5I9DR9vKe20vnZedPV+xEcrbumJII4=;7:rjOj0QBQvblaOe0xlbavk0JR57Xf9xxSrmmrQawTEidKoojiq8sMhO3Ch5xpHvSf82M7/KodW7uj5RzGyCDcdPBfHqKDOhyLRs7eRiAIastbiS8lhgoPjWfRlBzBcFOc7Fh4qRZOVCLZFj6Why6FwmUI9s58XDvh/Dc13L2lDiPTxzqyrBw0/3WspW0DBafONJJbiZNKCvw4LSLS4EvUp+HNrjb6rtXoOhGfaWt9IBRNhWuaH0D71p1v3vzpDAee SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB0944;20:rgOFbIAV3RhXEXqXAtTt5U0VItx2ozxEY21U0Nq24o/vOgG5T3kf+pVXdwg9QlC24zLswm/my5+y7QQ4nNtAR+dUcY/RssoZRPIjcqEFnIm2qknmRS6Wn2dgzfXdQQFI8Y04mEIHfqDvBPQ+u6ynPIfnLmjpWwA23HZvLsJ/0ec= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Sep 2016 22:01:29.7035 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN2PR15MB0944 X-OriginatorOrg: fb.com X-Proofpoint-Spam-Reason: safe X-FB-Internal: Safe X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2016-09-08_11:,, signatures=0 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, Sep 08, 2016 at 02:57:00AM -0700, Fenghua Yu wrote: > From: Fenghua Yu > > The documentation describes user interface of how to allocate resource > in Intel RDT. > > Please note that the documentation covers generic user interface. Current > patch set code only implemente CAT L3. CAT L2 code will be sent later. > > Signed-off-by: Fenghua Yu > Reviewed-by: Tony Luck > --- > Documentation/x86/intel_rdt_ui.txt | 164 +++++++++++++++++++++++++++++++++++++ > 1 file changed, 164 insertions(+) > create mode 100644 Documentation/x86/intel_rdt_ui.txt > > diff --git a/Documentation/x86/intel_rdt_ui.txt b/Documentation/x86/intel_rdt_ui.txt > new file mode 100644 > index 0000000..27de386 > --- /dev/null > +++ b/Documentation/x86/intel_rdt_ui.txt > @@ -0,0 +1,164 @@ > +User Interface for Resource Allocation in Intel Resource Director Technology > + > +Copyright (C) 2016 Intel Corporation > + > +Fenghua Yu > +Tony Luck > + > +This feature is enabled by the CONFIG_INTEL_RDT Kconfig and the > +X86 /proc/cpuinfo flag bits "rdt", "cat_l3" and "cdp_l3". > + > +To use the feature mount the file system: > + > + # mount -t resctrl resctrl [-o cdp,verbose] /sys/fs/resctrl > + > +mount options are: > + > +"cdp": Enable code/data prioritization in L3 cache allocations. > + > +"verbose": Output more info in the "info" file under info directory > + and in dmesg. This is mainly for debug. > + > + > +Resource groups > +--------------- > +Resource groups are represented as directories in the resctrl file > +system. The default group is the root directory. Other groups may be > +created as desired by the system administrator using the "mkdir(1)" > +command, and removed using "rmdir(1)". > + > +There are three files associated with each group: > + > +"tasks": A list of tasks that belongs to this group. Tasks can be > + added to a group by writing the task ID to the "tasks" file > + (which will automatically remove them from the previous > + group to which they belonged). New tasks created by fork(2) > + and clone(2) are added to the same group as their parent. > + If a pid is not in any sub partition, it is in root partition > + (i.e. default partition). Hi Fenghua, Will you add a 'procs' interface to allow move a process into a group? Using the 'tasks' interface to move process is inconvenient and has race conditions (eg, some new threads could be escaped). Thanks, Shaohua