From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 6A18B1B4C9 for ; Thu, 21 Mar 2019 13:50:32 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 21 Mar 2019 05:50:31 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,252,1549958400"; d="scan'208";a="309124110" Received: from istokes-mobl1.ger.corp.intel.com (HELO [10.252.18.62]) ([10.252.18.62]) by orsmga005.jf.intel.com with ESMTP; 21 Mar 2019 05:50:29 -0700 To: Ferruh Yigit , dev@dpdk.org Cc: stephen@networkplumber.org References: <1551303948-19746-1-git-send-email-ian.stokes@intel.com> <1551303948-19746-2-git-send-email-ian.stokes@intel.com> From: Ian Stokes Message-ID: Date: Thu, 21 Mar 2019 12:50:28 +0000 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.5.3 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Subject: Re: [dpdk-dev] [PATCH v1 1/6] ethdev: add min/max MTU to device info 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: Thu, 21 Mar 2019 12:50:34 -0000 On 3/19/2019 4:15 PM, Ferruh Yigit wrote: > On 2/27/2019 9:45 PM, Ian Stokes wrote: >> From: Stephen Hemminger >> >> This addresses the usability issue raised by OVS at DPDK Userspace >> summit. It adds general min/max mtu into device info. For compatiablity, >> and to save space, it fits in a hole in existing structure. >> >> The initial version sets max mtu to normal Ethernet, it is up to >> PMD to set larger value if it supports Jumbo frames. >> >> Also remove the deprecation notice introduced in 18.11 regarding this >> change and bump ethdev ABI version. >> >> Signed-off-by: Stephen Hemminger >> Signed-off-by: Ian Stokes >> Acked-by: Andrew Rybchenko > >> @@ -2524,6 +2524,8 @@ rte_eth_dev_info_get(uint16_t port_id, struct rte_eth_dev_info *dev_info) >> dev_info->rx_desc_lim = lim; >> dev_info->tx_desc_lim = lim; >> dev_info->device = dev->device; >> + dev_info->min_mtu = ETHER_MIN_MTU; >> + dev_info->max_mtu = UINT16_MAX; > > Not only mtu but do you think should we document in 'rte_eth_dev_info_get()' > doxygen documentation, the default values that API sets? > Sure, that would be useful, I can include it in the v2 of this patch. What would you document the values under? They are not @params and not @return, is there a particular label/format that should be used for values set within a function? >> >> RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get); >> (*dev->dev_ops->dev_infos_get)(dev, dev_info); >> @@ -2587,12 +2589,17 @@ int >> rte_eth_dev_set_mtu(uint16_t port_id, uint16_t mtu) >> { >> int ret; >> + struct rte_eth_dev_info dev_info; >> struct rte_eth_dev *dev; >> >> RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); >> dev = &rte_eth_devices[port_id]; >> RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mtu_set, -ENOTSUP); >> >> + rte_eth_dev_info_get(port_id, &dev_info); > > If we rely on 'rte_eth_dev_info_get()', we should add a check if "dev_infos_get" > is supported before calling it, like [1]. Unfortunately 'rte_eth_dev_info_get()' > return type is 'void', so we can't know if the struct has valid values or not > otherwise. > Or perhaps if port doesn't support "dev_infos_get", we can skip the mtu check > instead of returning error. > Hmmm,good point, I assumed rte_eth_dev_info_get() would be implemented for nearly all devices but again, only assumption, could be wrong. I'd prefer to err on the side of caution, so for the moment we can skip the check if dev infos is not available as you suggest. That way it should still work non supported devices. > [1] > RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP); > >> + if (mtu < dev_info.min_mtu || mtu > dev_info.max_mtu) >> + return -EINVAL; >> + > > Should we document this behavior change in the function comment in header file? > Update when -EINVAL returned, etc.. Sure I can take care of that in the v2. Ian > From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id D245EA00E6 for ; Thu, 21 Mar 2019 13:50:36 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 5416F1B4CA; Thu, 21 Mar 2019 13:50:35 +0100 (CET) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 6A18B1B4C9 for ; Thu, 21 Mar 2019 13:50:32 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 21 Mar 2019 05:50:31 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,252,1549958400"; d="scan'208";a="309124110" Received: from istokes-mobl1.ger.corp.intel.com (HELO [10.252.18.62]) ([10.252.18.62]) by orsmga005.jf.intel.com with ESMTP; 21 Mar 2019 05:50:29 -0700 To: Ferruh Yigit , dev@dpdk.org Cc: stephen@networkplumber.org References: <1551303948-19746-1-git-send-email-ian.stokes@intel.com> <1551303948-19746-2-git-send-email-ian.stokes@intel.com> From: Ian Stokes Message-ID: Date: Thu, 21 Mar 2019 12:50:28 +0000 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.5.3 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset="UTF-8"; format="flowed" Content-Language: en-US Content-Transfer-Encoding: 7bit Subject: Re: [dpdk-dev] [PATCH v1 1/6] ethdev: add min/max MTU to device info 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" Message-ID: <20190321125028._MCSGBMnI6scVqR4yPC5B3ktWwXkDcvM6JUEajIsosY@z> On 3/19/2019 4:15 PM, Ferruh Yigit wrote: > On 2/27/2019 9:45 PM, Ian Stokes wrote: >> From: Stephen Hemminger >> >> This addresses the usability issue raised by OVS at DPDK Userspace >> summit. It adds general min/max mtu into device info. For compatiablity, >> and to save space, it fits in a hole in existing structure. >> >> The initial version sets max mtu to normal Ethernet, it is up to >> PMD to set larger value if it supports Jumbo frames. >> >> Also remove the deprecation notice introduced in 18.11 regarding this >> change and bump ethdev ABI version. >> >> Signed-off-by: Stephen Hemminger >> Signed-off-by: Ian Stokes >> Acked-by: Andrew Rybchenko > >> @@ -2524,6 +2524,8 @@ rte_eth_dev_info_get(uint16_t port_id, struct rte_eth_dev_info *dev_info) >> dev_info->rx_desc_lim = lim; >> dev_info->tx_desc_lim = lim; >> dev_info->device = dev->device; >> + dev_info->min_mtu = ETHER_MIN_MTU; >> + dev_info->max_mtu = UINT16_MAX; > > Not only mtu but do you think should we document in 'rte_eth_dev_info_get()' > doxygen documentation, the default values that API sets? > Sure, that would be useful, I can include it in the v2 of this patch. What would you document the values under? They are not @params and not @return, is there a particular label/format that should be used for values set within a function? >> >> RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get); >> (*dev->dev_ops->dev_infos_get)(dev, dev_info); >> @@ -2587,12 +2589,17 @@ int >> rte_eth_dev_set_mtu(uint16_t port_id, uint16_t mtu) >> { >> int ret; >> + struct rte_eth_dev_info dev_info; >> struct rte_eth_dev *dev; >> >> RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); >> dev = &rte_eth_devices[port_id]; >> RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mtu_set, -ENOTSUP); >> >> + rte_eth_dev_info_get(port_id, &dev_info); > > If we rely on 'rte_eth_dev_info_get()', we should add a check if "dev_infos_get" > is supported before calling it, like [1]. Unfortunately 'rte_eth_dev_info_get()' > return type is 'void', so we can't know if the struct has valid values or not > otherwise. > Or perhaps if port doesn't support "dev_infos_get", we can skip the mtu check > instead of returning error. > Hmmm,good point, I assumed rte_eth_dev_info_get() would be implemented for nearly all devices but again, only assumption, could be wrong. I'd prefer to err on the side of caution, so for the moment we can skip the check if dev infos is not available as you suggest. That way it should still work non supported devices. > [1] > RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP); > >> + if (mtu < dev_info.min_mtu || mtu > dev_info.max_mtu) >> + return -EINVAL; >> + > > Should we document this behavior change in the function comment in header file? > Update when -EINVAL returned, etc.. Sure I can take care of that in the v2. Ian >