DPDK patches and discussions
 help / color / mirror / Atom feed
From: Maxime Coquelin <maxime.coquelin@redhat.com>
To: Tom Rix <trix@redhat.com>,
	dev@dpdk.org, akhil.goyal@nxp.com, nicolas.chautru@intel.com,
	ferruh.yigit@intel.com
Subject: Re: [dpdk-dev] [PATCH 1/2] baseband/fpga_5gnr_fec: fix API naming
Date: Mon, 5 Oct 2020 09:11:05 +0200
Message-ID: <4ba62928-0dd6-4d65-4882-d1eb6b21d4d4@redhat.com> (raw)
In-Reply-To: <8b19943c-7430-ab0d-9635-d465d91f1c82@redhat.com>



On 10/3/20 5:26 PM, Tom Rix wrote:
> 
> On 10/2/20 1:59 AM, Maxime Coquelin wrote:
>> DPDK APIs have to be prefixed with "rte_" in order to avoid
>> namespace pollution.
>>
>> Let's fix it while fpga_5gnr_fec API is still experimental.
>>
>> Signed-off-by: Maxime Coquelin <maxime.coquelin@redhat.com>
>> ---
>>  app/test-bbdev/test_bbdev_perf.c                   |  6 +++---
>>  doc/guides/bbdevs/fpga_5gnr_fec.rst                | 14 +++++++-------
>>  drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c | 10 +++++-----
>>  .../rte_pmd_bbdev_fpga_5gnr_fec_version.map        |  2 +-
>>  .../baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h |  6 +++---
>>  5 files changed, 19 insertions(+), 19 deletions(-)
>>
>> diff --git a/app/test-bbdev/test_bbdev_perf.c b/app/test-bbdev/test_bbdev_perf.c
>> index 45c0d62aca..14f150704e 100644
>> --- a/app/test-bbdev/test_bbdev_perf.c
>> +++ b/app/test-bbdev/test_bbdev_perf.c
>> @@ -612,14 +612,14 @@ add_bbdev_dev(uint8_t dev_id, struct rte_bbdev_info *info,
>>  #ifdef RTE_LIBRTE_PMD_BBDEV_FPGA_5GNR_FEC
>>  	if ((get_init_device() == true) &&
>>  		(!strcmp(info->drv.driver_name, FPGA_5GNR_PF_DRIVER_NAME))) {
>> -		struct fpga_5gnr_fec_conf conf;
>> +		struct rte_fpga_5gnr_fec_conf conf;
>>  		unsigned int i;
>>  
>>  		printf("Configure FPGA 5GNR FEC Driver %s with default values\n",
>>  				info->drv.driver_name);
>>  
>>  		/* clear default configuration before initialization */
>> -		memset(&conf, 0, sizeof(struct fpga_5gnr_fec_conf));
>> +		memset(&conf, 0, sizeof(struct rte_fpga_5gnr_fec_conf));
>>  
>>  		/* Set PF mode :
>>  		 * true if PF is used for data plane
>> @@ -647,7 +647,7 @@ add_bbdev_dev(uint8_t dev_id, struct rte_bbdev_info *info,
>>  		conf.flr_time_out = FLR_5G_TIMEOUT;
>>  
>>  		/* setup FPGA PF with configuration information */
>> -		ret = fpga_5gnr_fec_configure(info->dev_name, &conf);
>> +		ret = rte_fpga_5gnr_fec_configure(info->dev_name, &conf);
>>  		TEST_ASSERT_SUCCESS(ret,
>>  				"Failed to configure 5G FPGA PF for bbdev %s",
>>  				info->dev_name);
>> diff --git a/doc/guides/bbdevs/fpga_5gnr_fec.rst b/doc/guides/bbdevs/fpga_5gnr_fec.rst
>> index 6760391e8c..5849b31857 100644
>> --- a/doc/guides/bbdevs/fpga_5gnr_fec.rst
>> +++ b/doc/guides/bbdevs/fpga_5gnr_fec.rst
>> @@ -170,12 +170,12 @@ queues, priorities, load balance, bandwidth and other settings necessary for the
>>  device to perform FEC functions.
>>  
>>  This configuration needs to be executed at least once after reboot or PCI FLR and can
>> -be achieved by using the function ``fpga_5gnr_fec_configure()``, which sets up the
>> -parameters defined in ``fpga_5gnr_fec_conf`` structure:
>> +be achieved by using the function ``rte_fpga_5gnr_fec_configure()``, which sets up the
>> +parameters defined in ``rte_fpga_5gnr_fec_conf`` structure:
>>  
>>  .. code-block:: c
>>  
>> -  struct fpga_5gnr_fec_conf {
>> +  struct rte_fpga_5gnr_fec_conf {
>>        bool pf_mode_en;
>>        uint8_t vf_ul_queues_number[FPGA_5GNR_FEC_NUM_VFS];
>>        uint8_t vf_dl_queues_number[FPGA_5GNR_FEC_NUM_VFS];
>> @@ -214,15 +214,15 @@ parameters defined in ``fpga_5gnr_fec_conf`` structure:
>>    the FLR time out then set this setting to 0x262=610.
>>  
>>  
>> -An example configuration code calling the function ``fpga_5gnr_fec_configure()`` is shown
>> +An example configuration code calling the function ``rte_fpga_5gnr_fec_configure()`` is shown
>>  below:
>>  
>>  .. code-block:: c
>>  
>> -  struct fpga_5gnr_fec_conf conf;
>> +  struct rte_fpga_5gnr_fec_conf conf;
>>    unsigned int i;
>>  
>> -  memset(&conf, 0, sizeof(struct fpga_5gnr_fec_conf));
>> +  memset(&conf, 0, sizeof(struct rte_fpga_5gnr_fec_conf));
>>    conf.pf_mode_en = 1;
>>  
>>    for (i = 0; i < FPGA_5GNR_FEC_NUM_VFS; ++i) {
>> @@ -235,7 +235,7 @@ below:
>>    conf.ul_load_balance = 64;
>>  
>>    /* setup FPGA PF */
>> -  ret = fpga_5gnr_fec_configure(info->dev_name, &conf);
>> +  ret = rte_fpga_5gnr_fec_configure(info->dev_name, &conf);
>>    TEST_ASSERT_SUCCESS(ret,
>>        "Failed to configure 4G FPGA PF for bbdev %s",
> 
> 4G ?
> 
> Consider a future patch to clean this up.
> 
>>        info->dev_name);
>> diff --git a/drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c b/drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c
>> index 61f9c04ba2..1d73f9540e 100644
>> --- a/drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c
>> +++ b/drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c
>> @@ -1944,10 +1944,10 @@ fpga_5gnr_fec_remove(struct rte_pci_device *pci_dev)
>>  }
>>  
>>  static inline void
>> -set_default_fpga_conf(struct fpga_5gnr_fec_conf *def_conf)
>> +set_default_fpga_conf(struct rte_fpga_5gnr_fec_conf *def_conf)
>>  {
>>  	/* clear default configuration before initialization */
>> -	memset(def_conf, 0, sizeof(struct fpga_5gnr_fec_conf));
>> +	memset(def_conf, 0, sizeof(struct rte_fpga_5gnr_fec_conf));
>>  	/* Set pf mode to true */
>>  	def_conf->pf_mode_en = true;
>>  
>> @@ -1962,15 +1962,15 @@ set_default_fpga_conf(struct fpga_5gnr_fec_conf *def_conf)
>>  
>>  /* Initial configuration of FPGA 5GNR FEC device */
>>  int
>> -fpga_5gnr_fec_configure(const char *dev_name,
>> -		const struct fpga_5gnr_fec_conf *conf)
>> +rte_fpga_5gnr_fec_configure(const char *dev_name,
>> +		const struct rte_fpga_5gnr_fec_conf *conf)
>>  {
>>  	uint32_t payload_32, address;
>>  	uint16_t payload_16;
>>  	uint8_t payload_8;
>>  	uint16_t q_id, vf_id, total_q_id, total_ul_q_id, total_dl_q_id;
>>  	struct rte_bbdev *bbdev = rte_bbdev_get_named_dev(dev_name);
>> -	struct fpga_5gnr_fec_conf def_conf;
>> +	struct rte_fpga_5gnr_fec_conf def_conf;
>>  
>>  	if (bbdev == NULL) {
>>  		rte_bbdev_log(ERR,
>> diff --git a/drivers/baseband/fpga_5gnr_fec/rte_pmd_bbdev_fpga_5gnr_fec_version.map b/drivers/baseband/fpga_5gnr_fec/rte_pmd_bbdev_fpga_5gnr_fec_version.map
>> index d723bc9b0e..db43cd8403 100644
>> --- a/drivers/baseband/fpga_5gnr_fec/rte_pmd_bbdev_fpga_5gnr_fec_version.map
>> +++ b/drivers/baseband/fpga_5gnr_fec/rte_pmd_bbdev_fpga_5gnr_fec_version.map
>> @@ -5,6 +5,6 @@ DPDK_21 {
>>  EXPERIMENTAL {
>>  	global:
>>  
>> -	fpga_5gnr_fec_configure;
>> +	rte_fpga_5gnr_fec_configure;
>>  
>>  };
>> diff --git a/drivers/baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h b/drivers/baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h
>> index 70a4acf0b7..c2752fbd52 100644
>> --- a/drivers/baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h
>> +++ b/drivers/baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h
>> @@ -30,7 +30,7 @@ extern "C" {
>>  /**
>>   * Structure to pass FPGA 4G FEC configuration.
> 
> 4G ?
> 
> There are a number of 4G references in this file's comments.
> 
> Consider a future patch to clean this up.

Agree, I noticed that.
It has to be fixed in another series.

>>   */
>> -struct fpga_5gnr_fec_conf {
>> +struct rte_fpga_5gnr_fec_conf {
>>  	/** 1 if PF is used for dataplane, 0 for VFs */
>>  	bool pf_mode_en;
>>  	/** Number of UL queues per VF */
>> @@ -64,8 +64,8 @@ struct fpga_5gnr_fec_conf {
>>   */
>>  __rte_experimental
>>  int
>> -fpga_5gnr_fec_configure(const char *dev_name,
>> -		const struct fpga_5gnr_fec_conf *conf);
>> +rte_fpga_5gnr_fec_configure(const char *dev_name,
>> +		const struct rte_fpga_5gnr_fec_conf *conf);
>>  
>>  #ifdef __cplusplus
>>  }
> 
> Changes look complete.
> 
> Reviewed-by: Tom Rix <trix@redhat.com>
> 

Thanks,
Maxime


  reply	other threads:[~2020-10-05  7:11 UTC|newest]

Thread overview: 18+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-10-02  8:59 [dpdk-dev] [PATCH 0/2] baseband: fix drivers API Maxime Coquelin
2020-10-02  8:59 ` [dpdk-dev] [PATCH 1/2] baseband/fpga_5gnr_fec: fix API naming Maxime Coquelin
2020-10-03 15:26   ` Tom Rix
2020-10-05  7:11     ` Maxime Coquelin [this message]
2020-10-05  7:28       ` Maxime Coquelin
2020-10-02  8:59 ` [dpdk-dev] [PATCH 2/2] baseband/fpga_lte_fec: " Maxime Coquelin
2020-10-03 15:31   ` Tom Rix
2020-10-06 19:42 ` [dpdk-dev] [PATCH 0/2] baseband: fix drivers API Akhil Goyal
2020-10-07  8:22   ` Maxime Coquelin
2020-10-07 10:09     ` Thomas Monjalon
2020-10-07 10:12       ` Maxime Coquelin
2020-10-07 10:29         ` Thomas Monjalon
2020-10-07 10:52           ` Maxime Coquelin
2020-10-07 11:06             ` Thomas Monjalon
2020-10-07 11:07               ` Thomas Monjalon
2020-10-07 12:05                 ` Akhil Goyal
2020-10-07 12:19                   ` Maxime Coquelin
2020-10-07 11:09               ` Maxime Coquelin

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=4ba62928-0dd6-4d65-4882-d1eb6b21d4d4@redhat.com \
    --to=maxime.coquelin@redhat.com \
    --cc=akhil.goyal@nxp.com \
    --cc=dev@dpdk.org \
    --cc=ferruh.yigit@intel.com \
    --cc=nicolas.chautru@intel.com \
    --cc=trix@redhat.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

DPDK patches and discussions

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://inbox.dpdk.org/dev/0 dev/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 dev dev/ https://inbox.dpdk.org/dev \
		dev@dpdk.org
	public-inbox-index dev

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://inbox.dpdk.org/inbox.dpdk.dev


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git