From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-CO1-obe.outbound.protection.outlook.com (mail-co1nam03on0064.outbound.protection.outlook.com [104.47.40.64]) by dpdk.org (Postfix) with ESMTP id 2021711A4 for ; Mon, 10 Sep 2018 15:20:57 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=7+Rd8aFRtMmOShzbKALuvsQcQMclHNZOJeq3KVT/7HY=; b=H2pLQtaVVr7T9GXCejbIbQ8K1EE1UCE175HSUaZBunUqhsPhe+XH8Kvv4i6+StoNSm07AM1mMRhDTpLsjKiVuLiV3vAUDLsgWLML6lJRCICUStpSq5QqBJqd4RtrvkSSCyeRpgsZ0Os0hm0xS3xVwuiXNuUr5ht6eNniuQeHhTo= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Jerin.JacobKollanukkaran@cavium.com; Received: from jerin (115.113.156.3) by DM6PR07MB5002.namprd07.prod.outlook.com (2603:10b6:5:25::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1101.18; Mon, 10 Sep 2018 13:20:52 +0000 Date: Mon, 10 Sep 2018 18:50:37 +0530 From: Jerin Jacob To: Mattias =?iso-8859-1?Q?R=F6nnblom?= Cc: bruce.richardson@intel.com, dev@dpdk.org Message-ID: <20180910132036.GA19085@jerin> References: <20180830142719.28569-1-mattias.ronnblom@ericsson.com> <20180830142719.28569-11-mattias.ronnblom@ericsson.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.10.1 (2018-07-13) X-Originating-IP: [115.113.156.3] X-ClientProxiedBy: BM1PR0101CA0023.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00:18::33) To DM6PR07MB5002.namprd07.prod.outlook.com (2603:10b6:5:25::23) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 82866738-2e0e-490f-71de-08d617203ced X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989137)(4534165)(7168020)(4627221)(201703031133081)(201702281549075)(8990107)(5600074)(711020)(2017052603328)(7153060)(7193020); SRVR:DM6PR07MB5002; X-Microsoft-Exchange-Diagnostics: 1; DM6PR07MB5002; 3:bxG0iTUrtRO/8HSuIoqWoxYYsFUlsLqNwrwc3yxRpdzLfTgF16fWV4czzTLJCv3mjm+KRtpCD+xalJLgW/a0zBlJoAqgekg4ArpwFmviSYnoctz8ZyDYjf+dFGjJzdN0reb12Nf3GzvN9l3n0EqQbh7kLOV/0MJyiu5291OZPkZLxxD3T1B9qANpDhjhm9PzNOesgCat3jcp7RGCUHfeFlt7mlpEWnuJ/pXAcL71Ut4EiXHCXsDpXisBYk/u+Rsj; 25:T1y2RA094zGTmd6pkwPkS4UXX9K0gMW2W3/misU3E3lNKyQeq+xplPjbzUbaKbFo/T2CfIhVQW4ZsPvZWzJCflXux/Fq+p7tR8zA3tAU/AO6g066aOu1eKM5I7vGdcqVKN2ggUqp5P7oqJyMyE43Mo56mufojbdVhXozSIgKg+a+GxB48yn2hQPHK1p1zk8ZrcFtRVBkNv48bNBk3/haR3qmvnLjaWGFDddP27aLTcC7wLw1t3H6dDysgUTlo8Nrf37+iA4mn3vKsCrqrZbTydVBlLMC/npzTu6x8RK8l93Yl3LrTpVFnbK1rEqyGuwBXJH/KV4CrkobiZ/NfQY8Eg==; 31:U5slGQMVpm724jZVVMpkSKXtSNB6qE/UWfVmBMChuiUmfqtPhl1fgFTaxI0OaU/29Rz1mpD4vIobXuBZPD3ynzjDPq9ko9JDzjXJup+gwAnd/HmfkIcaaKQUp4nANMhS5RAHnLm6Iha9q/yxW+6wKm99uIFBN4Ez+B7s1bE80etOVC1WyHqwiJ+q8cphdEWpe/qH4j4I+NUPc3ZpuYkO6pYSKnBzRWgOOZLPKWLVLUI= X-MS-TrafficTypeDiagnostic: DM6PR07MB5002: X-Microsoft-Exchange-Diagnostics: 1; DM6PR07MB5002; 20:iqPt/Wy1TDCvXvswjCnEkMZMXqa9XaJHXMtfb1O9R0d1SW/MEC6t3PmeRdYMYvW4kBzf7c+jGVTAtSHwTRFBiE6VNdWFVEGhT9cDXpJkvv5ye2yH62ROhtgNec9SvxEWlvTKXr6EmlfMFCbS7zxr7xvsG7BOUteD4CdlEvkfy1xjZcZkjnaecFEmIXmI2crXCE1mDjxSUeTMASzTyCD5jVjg4Za68VaIG1LiTzoftywNVUWAacZwsAhHqtNd2cezJi6S47aNCw3w6D/Mv1QwtqkkOT1Rnpz6XQR3yHlkHkfF5CBzhmo82DUjOrycc0UQm2DH5LOy8sRmvLkBzXKyf4+z2SKQuSbeEtxhR3ZDpHAfJ6m0wFj8FcU2mAR3KUeBVMHDe2aYo8FxijY/yUVcpJ2n43vdSZ7YT/2JX1Pjlt6HKVTb6thTCb0R87aJ4et7twYlNsYIErLJeua8Rtz9U6GbpIyO2VS/sE2vts0czIisYfPKkBoyktiCf7A/hS9ZK/umI0fduFWwNxa0kdzF+BdkbyFigQ92o+37U9ugpO5qN2uClR44KTQTlT/0kPnGWfp+m/fOJyCNijev497lOKXBsS56m3avL/7xxVW1q90= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(37575265505322)(248295561703944)(228905959029699); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(93006095)(10201501046)(3231311)(944501410)(52105095)(3002001)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123562045)(20161123558120)(20161123564045)(201708071742011)(7699050); SRVR:DM6PR07MB5002; BCL:0; PCL:0; RULEID:; SRVR:DM6PR07MB5002; X-Microsoft-Exchange-Diagnostics: 1; DM6PR07MB5002; 4:qeoHtSf5mGb/vvqOXTT/1Bz5UuMHr9IGsGgCpmWAibuoVjBK5nvc1rTjUo/87xfH+nXOt9PFcg7+Jdvb+68QO3s7mph9UMYtbLHDcHZ4H3vrIJAv06tUOcCIPPh0te96NEM7SV0O/L+EAcoQyw96TisFtw96G1Ipl2VRy8PP6KXGNAn0fNeDzKcXMBGhzTYShVRU2FXWgTPoKyOpwqb1G6fh3F0Kg+furDVz9AsVe8jSdOaU/hiRlZS/z4oesPitnp0qxnN7Yy9mxL6oXSkvCBYmntsM48Clk3KGpwEgHukldgrmu1ZwzFqcd3jYIVHQBFuX8jkxiCUPXlGG5z/ufS8SIhB4dhZCoZjBrA3IAJWuV0wpt8I2VsJSV57zavqg X-Forefront-PRVS: 07915F544A X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(39860400002)(136003)(376002)(346002)(366004)(13464003)(189003)(199004)(33716001)(44832011)(81166006)(6246003)(14444005)(5660300001)(55016002)(42882007)(81156014)(23756003)(8936002)(106356001)(476003)(486006)(53546011)(956004)(386003)(53936002)(33656002)(50466002)(446003)(55236004)(11346002)(105586002)(9686003)(2870700001)(2906002)(186003)(316002)(3846002)(16526019)(6116002)(66066001)(478600001)(6666003)(68736007)(58126008)(305945005)(1076002)(26005)(4326008)(229853002)(6916009)(97736004)(72206003)(25786009)(52116002)(6496006)(7736002)(33896004)(47776003)(8676002)(76176011)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:DM6PR07MB5002; H:jerin; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?iso-8859-1?Q?1; DM6PR07MB5002; 23:3uS+r/PkfYyN8sSgy8EW2jqit/ynuU8uQKOmb/K?= =?iso-8859-1?Q?/6SwnNzUAp6L+vCoFLTaa/hYTGVcZ9oYWbHtV9i8MhZ1kSHEAGKjZb9fo/?= =?iso-8859-1?Q?hkc0BjY10UvgMBtl2iRt1Q/4pCRKm33o8ZHvkqD6bqOoAB4VhMUuhOPjV3?= =?iso-8859-1?Q?aaxWsQHSOy2gD6mTIGaoLCIgzyinra8mPNsS5zTiPC9OrPGQq4uFTfot/z?= =?iso-8859-1?Q?vtV29TMDI91OBWKcLkyGPIqYj+TEEDZe+8E9hK2wgPcgPAFQww88jbPNz4?= =?iso-8859-1?Q?uPkd5aCUAWhv9m48RpmSsrfuhQ1/pEkQ1WsAh3R2DbTChycAuwpkFpp+L3?= =?iso-8859-1?Q?72JkdqemQxDLWuUcJzNWum7rXae+ZXhFm4jzTlR9/4BVC0EXapphkkLFJr?= =?iso-8859-1?Q?VWWsMmjjWTPcPOHrkz8JIqDO6F2nzm9YgrObqTXaFieRnbq2Cp4sYBAFFe?= =?iso-8859-1?Q?p5vxKlM+axHlfGY0Ll1a6HfJxdm905xSzHwzN2bBLIZm5rYZthFDd2ORyw?= =?iso-8859-1?Q?R/K2xrwbpjXV2nQCwWlOauf85ghLArk+tQVEVoc7YtN5mHzswyVs42daJu?= =?iso-8859-1?Q?ukvaXj21Gw6EezMe9qHDL8C95c3Jm/bDlRcge0uALYB6E4iUWYDsKDayw3?= =?iso-8859-1?Q?g2FbQDMgJnDSi5gz3+K4FUqlxTIN7yH/aZzPruWdONhMsRRSQ3979pEFzY?= =?iso-8859-1?Q?E8CjRLCmHDDwQwQzJfpG5opGdlj5a7Z1xZQ2HSGxux7cCD28+kgDF3DmSk?= =?iso-8859-1?Q?UvKGTbMjaT0J6ZYLlz2M2zG9tVp0lxfIQ8OFvg/gH6uqHiC5OOmCbFRYCj?= =?iso-8859-1?Q?tX4+Dlik5QMyzqqzlT7nBBCyRmf2YB4Mstf3HqEtCEet4YhzXGC/TfWwvY?= =?iso-8859-1?Q?akhwccDkGzN29X/Yc+okfKfS43mo97vwPp4yzYDO0rw+w/Zz0kVCDk8KH6?= =?iso-8859-1?Q?tFxQ0Fu7J9STMOfAF9+l5D4cbE4W+KAl+VdiAYJN8Nlqpe9JK2I8lytozP?= =?iso-8859-1?Q?FcGi+i60RJGwQ2EW40geWw17S6q51WJcjkgEP2mOEQ6tuu4KBD2UpdmkqT?= =?iso-8859-1?Q?EcoTtORXeH6opH/brM47sPRDlj5y8iXOzBzwIK9YaaCsF+QeuDCyqCZZMd?= =?iso-8859-1?Q?RuCBvcOYTJ8xQwSbE18yQJRtJ7JPWl4nDSRsaS9lAZ48dAXwEHNl1nBbVI?= =?iso-8859-1?Q?+sDVj571w1Z2Og58Om8VDY9EGO26jTRg4/kxhOWqsTp0F6ilg3qsHyTlhN?= =?iso-8859-1?Q?eBBLKN+4V9Soxf0OsX3QZwCEBZqzUYEefG+so3Y5zbgQde2+ZFRRQ/dkfv?= =?iso-8859-1?Q?rPf4gE8XB+kX9J2Zn1wVNJkrvHhyUDhXkKL6Gs7Vbi102926cLiNWJwtHJ?= =?iso-8859-1?Q?s/vaTMcVmHsgr7m7xxEAFZgPt3DR8641F8C3Lo5tfYjqjp2oi5e/hmYND9?= =?iso-8859-1?Q?sdq/vzzvin1P1w=3D?= X-Microsoft-Antispam-Message-Info: 5yTrOsSUn0UgAk/GzdaWJODNdHynbwpb5nJkYIDrWxWnKGBbXKPvJ9Ezrcsw574VWIy7YjNzv8j5cFtQ0djNLBdQN/vzDBJFcAZbyFR8cvEvSGODNxXDAZWAllZXOlb5hp1ggej78XTZziaJ5IpceBiXTE39UF/J3dsAS9AO9x6LFq101HFpiXFZKcqdMCY3helTbSQCT2nuE5DLwgQXHB3iTHJnHINy9yPiRTKfPmOVsoil0mnaK11yXQAWEdPkz/JevcC5V9zXMsEIrwPGWfZmK8BUviqzvVljdLrtb3bTuqu+taxakS4dBds/7qkL+kx6A29OWiScItwU5Ojhin+uD0wBoupG056d9knv/YI= X-Microsoft-Exchange-Diagnostics: 1; DM6PR07MB5002; 6:bn+2WMpp+aBlxGjNb1z1rKooeAC5PqQKisWQguLMzrp0nL1bUJ21md+VBOX878Zp+RY79uKcwcjnpekvu5yeGpMTqEVl/+EvV+gFcZ512tgvxrBbI+1PnEAgQdVH7yytzn+ccHQXbmBxLtubZe+4+yjSF15Cxp7Tr7kLz13qEaYvhQfcOgnSLNQzRQtf/E/jipuOuXSkGP97nQJqVbRjHmYY1PFIA4QNm2SqEYkqYAjNjhE+2HH78F4Diof7sE8sP2jGDkbJwJQ6FYc2IQRTVyJs6ooXpR6XrZ9fiQS6+hegXKQhkRNEIJ6J4TONum3a7FUogqoZ1qptMvdjxgzGaViRmZCEVFpElOahRX5KUUuYEEO2XgLeu3rvDaLqX8MTIAsaHxDaAkz5BZAu3Od+HrtyuKov/h0qRU4cv1ZGxtq5QCA3fqtmy/D8kIrG1i3EuYBufGs5OFW8dQX1Y5563g==; 5:+f6Ir+ILaQlBWr7s/0Vx30yzgcaZT5iFNSMov3bLYSFtRd0NSkVPxjgDPefANcW/uJOSptHpnn88m6OErifahz0i0lUJN4x1NWZVl0U+s/tGlAj/L7FBcgbKmLKKeRZJNBooO8Ap4CnQjTLw49bZTkoLF0D+U7ryqkfoUUp4I4Y=; 7:r83jHDkjttp985W1xqxAeCS72L73cKnEQnB/TaLyIM6M5DyMLZwOA1K6YDR7eMSwGxCueiyDP+aJlLaBNWYUU9XeFGRQFwT4aorRbX1ROufQbzydLFPwPMz5v1h3OloczETxoD50817bdccWJPawxGnVxUMYoiXDZnRGPyX5QCaOJJ+akWZ1CFv6K9UnXTcUyX1ZIBNOO5vSXIf6IEqyMYQKpQ++I6seTwFHQPZ6P14kydAkFTACpW3Im7Jm01dn SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Sep 2018 13:20:52.5121 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 82866738-2e0e-490f-71de-08d617203ced X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR07MB5002 Subject: Re: [dpdk-dev] [PATCH 10/10] eventdev: include DSW event device documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Sep 2018 13:20:57 -0000 -----Original Message----- > Date: Mon, 10 Sep 2018 14:59:51 +0200 > From: Mattias Rönnblom > To: jerin.jacob@caviumnetworks.com > CC: bruce.richardson@intel.com, dev@dpdk.org > Subject: Re: [dpdk-dev] [PATCH 10/10] eventdev: include DSW event device > documentation > User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 > Thunderbird/52.9.1 > > > Will DSW be included in 18.11? Yes. I may have minor comments on individual patches. But overall the patches looks good. Please fix the following check-git-log.sh issues [dpdk-next-eventdev] $ ./devtools/check-git-log.sh Wrong headline prefix: eventdev: add DSW device and queue configuration eventdev: add DSW port configuration eventdev: add support in DSW for linking/unlinking ports eventdev: add DSW event scheduling and device start/stop eventdev: add DSW port load measurements eventdev: add load balancing to the DSW event device eventdev: let DSW event device sort events on dequeue eventdev: implement eventdev 'xstats' counters in DSW > > /M > > On 2018-08-30 16:27, Mattias Rönnblom wrote: > > The DSW event device is documented in DPDK Programmer's Guide. > > > > Signed-off-by: Mattias Rönnblom > > --- > > doc/guides/eventdevs/dsw.rst | 97 ++++++++++++++++++++++++++++++++++ > > doc/guides/eventdevs/index.rst | 1 + > > 2 files changed, 98 insertions(+) > > create mode 100644 doc/guides/eventdevs/dsw.rst > > > > diff --git a/doc/guides/eventdevs/dsw.rst b/doc/guides/eventdevs/dsw.rst > > new file mode 100644 > > index 000000000..de41ae9d3 > > --- /dev/null > > +++ b/doc/guides/eventdevs/dsw.rst > > @@ -0,0 +1,97 @@ > > +.. SPDX-License-Identifier: BSD-3-Clause > > + Copyright(c) 2017 Intel Corporation. > > + Copyright(c) 2018 Ericsson AB > > + > > +Distributed Software Eventdev Poll Mode Driver > > +============================================== > > + > > +The distributed software eventdev is a parallel implementation of the > > +eventdev API, which distributes the task of scheduling events among > > +all the eventdev ports and the lcore threads using them. > > + > > +Features > > +-------- > > + > > +Queues > > + * Atomic > > + * Parallel > > + * Single-Link > > + > > +Ports > > + * Load balanced (for Atomic, Ordered, Parallel queues) > > + * Single Link (for single-link queues) > > + > > +Configuration and Options > > +------------------------- > > + > > +The distributed software eventdev is a vdev device, and as such can be > > +created from the application code, or from the EAL command line: > > + > > +* Call ``rte_vdev_init("event_dsw0")`` from the application > > + > > +* Use ``--vdev="event_dsw0"`` in the EAL options, which will call > > + rte_vdev_init() internally > > + > > +Example: > > + > > +.. code-block:: console > > + > > + ./your_eventdev_application --vdev="event_dsw0" > > + > > +Limitations > > +----------- > > + > > +Unattended Ports > > +~~~~~~~~~~~~~~~~ > > + > > +The distributed software eventdev uses an internal signaling schema > > +between the ports to achieve load balancing. In order for this to > > +work, the application must perform enqueue and/or dequeue operations > > +on all ports. > > + > > +Producer-only ports which currently have no events to enqueue should > > +periodically call rte_event_enqueue_burst() with a zero-sized burst. > > + > > +Ports left unattended for longer periods of time will prevent load > > +balancing, and also cause traffic interruptions on the flows which > > +are in the process of being migrated. > > + > > +Output Buffering > > +~~~~~~~~~~~~~~~~ > > + > > +For efficiency reasons, the distributed software eventdev might not > > +send enqueued events immediately to the destination port, but instead > > +store them in an internal buffer in the source port. > > + > > +In case no more events are enqueued on a port with buffered events, > > +these events will be sent after the application has performed a number > > +of enqueue and/or dequeue operations. > > + > > +For explicit flushing, an application may call > > +rte_event_enqueue_burst() with a zero-sized burst. > > + > > + > > +Priorities > > +~~~~~~~~~~ > > + > > +The distributed software eventdev does not support event priorities. > > + > > +Ordered Queues > > +~~~~~~~~~~~~~~ > > + > > +The distributed software eventdev does not support the ordered queue type. > > + > > + > > +"All Types" Queues > > +~~~~~~~~~~~~~~~~~~ > > + > > +The distributed software eventdev does not support queues of type > > +RTE_EVENT_QUEUE_CFG_ALL_TYPES, which allow both atomic, ordered, and > > +parallel events on the same queue. > > + > > +Dynamic Link/Unlink > > +~~~~~~~~~~~~~~~~~~~ > > + > > +The distributed software eventdev does not support calls to > > +rte_event_port_link() or rte_event_port_unlink() after > > +rte_event_dev_start() has been called. > > diff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst > > index 18ec8e462..984eea5f4 100644 > > --- a/doc/guides/eventdevs/index.rst > > +++ b/doc/guides/eventdevs/index.rst > > @@ -14,5 +14,6 @@ application trough the eventdev API. > > dpaa > > dpaa2 > > sw > > + dsw > > octeontx > > opdl > >