From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 7A465A04DD; Wed, 21 Oct 2020 12:18:54 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 18DEBAA26; Wed, 21 Oct 2020 12:18:53 +0200 (CEST) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id A9DB2A573 for ; Wed, 21 Oct 2020 12:18:50 +0200 (CEST) IronPort-SDR: xAiGPMGcIHw7gUTBfG1G07NkFPy9Dx+wxtD5KNz2Z7i5hodKdJKYVHCR2EyxDILRPJ/LBLTutR odGQ0X8iYJ4g== X-IronPort-AV: E=McAfee;i="6000,8403,9780"; a="146637173" X-IronPort-AV: E=Sophos;i="5.77,401,1596524400"; d="scan'208";a="146637173" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga007.jf.intel.com ([10.7.209.58]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Oct 2020 03:18:47 -0700 IronPort-SDR: Qtgf/wAv4MHjVkq5FvR7c/UO4bJloOUfFi/sRyfSX5+NafGiksVZKh5fVtUWH9qRuUCjTfRBR9 s75B+8XzApog== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.77,401,1596524400"; d="scan'208";a="359458951" Received: from fmsmsx605.amr.corp.intel.com ([10.18.126.85]) by orsmga007.jf.intel.com with ESMTP; 21 Oct 2020 03:18:46 -0700 Received: from fmsmsx608.amr.corp.intel.com (10.18.126.88) by fmsmsx605.amr.corp.intel.com (10.18.126.85) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5; Wed, 21 Oct 2020 03:18:46 -0700 Received: from fmsmsx603.amr.corp.intel.com (10.18.126.83) by fmsmsx608.amr.corp.intel.com (10.18.126.88) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5; Wed, 21 Oct 2020 03:18:45 -0700 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx603.amr.corp.intel.com (10.18.126.83) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5 via Frontend Transport; Wed, 21 Oct 2020 03:18:45 -0700 Received: from NAM02-BL2-obe.outbound.protection.outlook.com (104.47.38.52) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.1713.5; Wed, 21 Oct 2020 03:18:44 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=U3sKMeAcqGZS1K4CIVFUBVQnNCRm/ZgxeUKdZZx0vKU3nQBJCXBqAIrXHC0XdG1DKOfZeaTIUxv5uHpbks/xqgTbkXIWIiom/stvwjBFYOQ5KyE+JC24Qf9JOOvAirJObZEZhy4MosnckDpXh5jwHc1sdladtlJqXyk2HXbEhKaIK3EUXFXNaO7fbmcsGmRoIIae1OFTG8Kh3ljBdAYrrTWhTWPKPt9h6YnseMtlziiuIuU3d2noG3nReT8KDqBvRuXOBzBed0dtB1pam345M2eP5Um0uXECSHJiy3nIKLdjhqctAeZY8eaVDyXFHcoq3kSq2zHWy3fK23VMTdcryQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=yCvAGGyoNozP+6ZHAf1eh0nUM9/pQNMtIunMnIZLeGg=; b=asiueCQ+tUS1FgPGplcR6d6KkNsWod+r7AZkOkEqHK/KKheh1HMkwj1RPWZKqnakb+/5I4rSQ6Wv4CHYe1TrmNm0zQMwKvAoM2N6tg3AGFfBpEb5RbeGCd7EFO1ZjMBCme0v/xoAhyktwoYH7mnU8vvc4YCyxdn4UG1aOaLFPVUbfdNlbh2Q6FsLg0gMUhHsP8yyuyBIrqfF+hYusWxa+eHAO+Cxc8OYA0hEo7ByXqqL34UkpKYSFLyv8MxDH2lvktn/wq1r64fzZgRoGTJpLsD+x3LxpOS9csZF2aQlttu3Apyw/+M56kXQgawg7iG2+2LgW+y0EHxqaxwHsTHQPg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=yCvAGGyoNozP+6ZHAf1eh0nUM9/pQNMtIunMnIZLeGg=; b=jtRJMKnXPWk8jCHdAO27B1CjdSqEsinNd8+iZt7u/aym+LW3zi3MSfBH/5LIqUksf8mBoYjC+e5weCE4Lj67WVSVN79vCVM6xGf5IyanJRCaP53yeZH/6sxslCpVSMhj8sQHt5mJ5/WASTMcu+jIRJzq7gsvgYbhopfjuigtJwA= Received: from BYAPR11MB3301.namprd11.prod.outlook.com (2603:10b6:a03:7f::26) by BYAPR11MB3671.namprd11.prod.outlook.com (2603:10b6:a03:b3::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3499.18; Wed, 21 Oct 2020 10:18:40 +0000 Received: from BYAPR11MB3301.namprd11.prod.outlook.com ([fe80::f5a4:3f6b:ade3:296b]) by BYAPR11MB3301.namprd11.prod.outlook.com ([fe80::f5a4:3f6b:ade3:296b%3]) with mapi id 15.20.3499.018; Wed, 21 Oct 2020 10:18:40 +0000 From: "Ananyev, Konstantin" To: "Yigit, Ferruh" , Ray Kinsella , Neil Horman CC: "dev@dpdk.org" , Thomas Monjalon , Andrew Rybchenko , Matan Azrad , Olivier Matz , Jerin Jacob Thread-Topic: [RFC] doc: announce max Rx packet len field deprecation Thread-Index: AQHWptkGpTzMrifJAE+WQLlw8EW5BKmh175Q Date: Wed, 21 Oct 2020 10:18:40 +0000 Message-ID: References: <20201020120305.1516513-1-ferruh.yigit@intel.com> In-Reply-To: <20201020120305.1516513-1-ferruh.yigit@intel.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-reaction: no-action dlp-version: 11.5.1.3 authentication-results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=intel.com; x-originating-ip: [46.7.39.127] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 12445887-e2a9-49f4-75ba-08d875aaae9d x-ms-traffictypediagnostic: BYAPR11MB3671: x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: hWNot7kkjZW9a2BJUZTbbd/q9NvVsT6XJtJ9CeHkbxPsFojOV4Y7mjhiaF6h98Rupq16w4YckUnfaM6ewD5JUP+bC2BIukwK9hyaqkmmlCc6haxHPJ4X+jWuFA3551gxOjWx11X+o9+HhGR1o3S920X+QvsJQIYww0+a3RUXT6Ltmp6t1uzaWv7YvYMCngM1cgMZHwlLOAfc0S3fL7wUF9X1D/P40b/5D0Yu40S1w8fDa8waevOWYXHIywrtwBFidgg2QqLt+9GpZCSqTdlgKH5BkSIIg90lokr5JYlL0bwwuh5ucs4SS3AfYkBON371rIdavhgs2P+K3eBqPYBvCg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BYAPR11MB3301.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(376002)(136003)(366004)(39860400002)(346002)(86362001)(83380400001)(71200400001)(5660300002)(64756008)(66446008)(2906002)(6506007)(26005)(9686003)(76116006)(66556008)(54906003)(66476007)(52536014)(7696005)(66946007)(186003)(55016002)(33656002)(4326008)(478600001)(8676002)(110136005)(8936002)(316002); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata: QxeUiT71jCJdFT9XSwbGw+xmu8dsLkdJk381CxqH+O1NpY2F75mr65u30EdgkeULa8qfWfe67GiVkkValt/ZFdxLhMViq83XecNwwkMfVs7VHCR7JdTi3U1Yaj0IHk9KoQcAwXc/mqTVxCdP9MPAujCc12t+xdptl+RwzP/u+jchdt5CZyd1UvgdRLZ21w+aZxyb7Am87tEuOsAXbpIlrXK02bSilm/nwsHb+pm2czpXjlPdK4RStlWO/tDc6q0ucOK/B3/iQqOUjaDQPtUZz5tq1AG7kG9ZERf6zQ0D7PLPRlOD1Up5XSitwo2mCaAsGQ3KfZr6D+bSo9/ADJZ0ml9a9C8B7EZ2Vv1/IfNsUjbgdymLSCvqMhegvUUzgWU6/Hv547Mz/glwyy6p0fbKcVW3XtORpeKsO335NrEryggz9AmO0M9BtGr2BLz5BWQxNFR1d/Knph+aBVp0tdu5bAPgPvkacsIvKbizR+fLzJ9x+mzjp7fvb0NVpAc2+JziEDaqj8S9n0mNQnGlm8WcRXh6eO18yBr9QGwB+Xdj3pHBKQz/He/EBSUuW0oFqdm1pmbvbdgfVS58Co9dWhm/JxfklP6t+Bmi6oZzk0GEg7s0V1L0KraT49+r2vi6x7TGy/kU4H7J45SP7VFJo7WvBA== Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: BYAPR11MB3301.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 12445887-e2a9-49f4-75ba-08d875aaae9d X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Oct 2020 10:18:40.5940 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: KmYmshe+1lfffnauPMUYP0ef56GE6+xidJm5QlOWYiJzoPTNBqKbxUhj6XHh7x3TJUsXH3DeP2NvQ7tPOaJBTN/12+pzCqY59cLEYtUtQWs= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR11MB3671 X-OriginatorOrg: intel.com Subject: Re: [dpdk-dev] [RFC] doc: announce max Rx packet len field deprecation 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" >=20 > Signed-off-by: Ferruh Yigit > --- > Cc: Thomas Monjalon > Cc: Andrew Rybchenko > Cc: Konstantin Ananyev > Cc: Matan Azrad > Cc: Olivier Matz > Cc: Jerin Jacob > --- > doc/guides/rel_notes/deprecation.rst | 25 +++++++++++++++++++++++++ > 1 file changed, 25 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 8ceb385141..d4a31392d3 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -149,6 +149,31 @@ Deprecation Notices > will be limited to maximum 256 queues. > Also compile time flag ``RTE_ETHDEV_QUEUE_STAT_CNTRS`` will be removed= . >=20 > +* ethdev: In ``struct rte_eth_rxmode``, ``uint32_t max_rx_pkt_len`` will= be > + replaced by a new ``uint32_t mtu`` in v21.11. Probably no point to keep mtu value in rte_eth_rxmode. Better to move it to rte_eth_conf. Apart from that: +1 for this change. Acked-by: Konstantin Ananyev > + The new ``mtu`` field will be used to configure the initial device MTU= via > + ``rte_eth_dev_configure()`` API. > + Later MTU can be changed by ``rte_eth_dev_set_mtu()`` API as done now. > + The existing ``(struct rte_eth_dev)->data->mtu`` variable will be used= to store > + the configured ``mtu`` value, > + and this new ``(struct rte_eth_dev)->data->dev_conf.rxmode.mtu`` varia= ble will > + be used to store the user configuration request. > + Unlike ``max_rx_pkt_len``, which was valid only when ``JUMBO_FRAME`` e= nabled, > + ``mtu`` field will be always valid. > + When ``mtu`` config is not provided by the application, default ``RTE_= ETHER_MTU`` > + value will be used. > + Driver is responsible from updating ``(struct rte_eth_dev)->data->mtu`= ` after MTU > + set successfully, either by ``rte_eth_dev_configure()`` or ``rte_eth_d= ev_set_mtu()``. > + > + Application may need to configure device for a specific Rx packet size= , like for > + cases ``DEV_RX_OFFLOAD_SCATTER`` is not supported and device received = packet size > + can't be bigger than Rx buffer size. > + To cover these cases application needs to know the device packet overh= ead to be > + able to calculate the ``mtu`` corresponding to a Rx buffer size, for t= his > + ``(struct rte_eth_dev_info).max_rx_pktlen`` will be kept, > + the device packet overhead can be calculated as: > + ``(struct rte_eth_dev_info).max_rx_pktlen - (struct rte_eth_dev_info).= max_mtu`` > + > * cryptodev: support for using IV with all sizes is added, J0 still can > be used but only when IV length in following structs ``rte_crypto_auth= _xform``, > ``rte_crypto_aead_xform`` is set to zero. When IV length is greater or= equal > -- > 2.26.2