From: Tom Rix <trix@redhat.com>
To: Maxime Coquelin <maxime.coquelin@redhat.com>,
dev@dpdk.org, akhil.goyal@nxp.com, nicolas.chautru@intel.com,
ferruh.yigit@intel.com
Subject: Re: [dpdk-dev] [PATCH 2/2] baseband/fpga_lte_fec: fix API naming
Date: Sat, 3 Oct 2020 08:31:05 -0700 [thread overview]
Message-ID: <2bd74daa-b8de-ea4a-7faf-0e8008cc22a0@redhat.com> (raw)
In-Reply-To: <20201002085931.265699-3-maxime.coquelin@redhat.com>
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_lte_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_lte_fec.rst | 14 +++++++-------
> drivers/baseband/fpga_lte_fec/fpga_lte_fec.c | 10 +++++-----
> drivers/baseband/fpga_lte_fec/fpga_lte_fec.h | 6 +++---
> .../rte_pmd_bbdev_fpga_lte_fec_version.map | 2 +-
> 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 14f150704e..d4a3681344 100644
> --- a/app/test-bbdev/test_bbdev_perf.c
> +++ b/app/test-bbdev/test_bbdev_perf.c
> @@ -568,14 +568,14 @@ add_bbdev_dev(uint8_t dev_id, struct rte_bbdev_info *info,
> #ifdef RTE_LIBRTE_PMD_BBDEV_FPGA_LTE_FEC
> if ((get_init_device() == true) &&
> (!strcmp(info->drv.driver_name, FPGA_LTE_PF_DRIVER_NAME))) {
> - struct fpga_lte_fec_conf conf;
> + struct rte_fpga_lte_fec_conf conf;
> unsigned int i;
>
> printf("Configure FPGA LTE FEC Driver %s with default values\n",
> info->drv.driver_name);
>
> /* clear default configuration before initialization */
> - memset(&conf, 0, sizeof(struct fpga_lte_fec_conf));
> + memset(&conf, 0, sizeof(struct rte_fpga_lte_fec_conf));
>
> /* Set PF mode :
> * true if PF is used for data plane
> @@ -603,7 +603,7 @@ add_bbdev_dev(uint8_t dev_id, struct rte_bbdev_info *info,
> conf.flr_time_out = FLR_4G_TIMEOUT;
>
> /* setup FPGA PF with configuration information */
> - ret = fpga_lte_fec_configure(info->dev_name, &conf);
> + ret = rte_fpga_lte_fec_configure(info->dev_name, &conf);
> TEST_ASSERT_SUCCESS(ret,
> "Failed to configure 4G FPGA PF for bbdev %s",
> info->dev_name);
> diff --git a/doc/guides/bbdevs/fpga_lte_fec.rst b/doc/guides/bbdevs/fpga_lte_fec.rst
> index fdc8a76981..a8cc3c58a8 100644
> --- a/doc/guides/bbdevs/fpga_lte_fec.rst
> +++ b/doc/guides/bbdevs/fpga_lte_fec.rst
> @@ -169,12 +169,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_lte_fec_configure()``, which sets up the
> -parameters defined in ``fpga_lte_fec_conf`` structure:
> +be achieved by using the function ``rte_fpga_lte_fec_configure()``, which sets up the
> +parameters defined in ``rte_fpga_lte_fec_conf`` structure:
>
> .. code-block:: c
>
> - struct fpga_lte_fec_conf {
> + struct rte_fpga_lte_fec_conf {
> bool pf_mode_en;
> uint8_t vf_ul_queues_number[FPGA_LTE_FEC_NUM_VFS];
> uint8_t vf_dl_queues_number[FPGA_LTE_FEC_NUM_VFS];
> @@ -213,15 +213,15 @@ parameters defined in ``fpga_lte_fec_conf`` structure:
> the FLR time out then set this setting to 0x262=610.
>
>
> -An example configuration code calling the function ``fpga_lte_fec_configure()`` is shown
> +An example configuration code calling the function ``rte_fpga_lte_fec_configure()`` is shown
> below:
>
> .. code-block:: c
>
> - struct fpga_lte_fec_conf conf;
> + struct rte_fpga_lte_fec_conf conf;
> unsigned int i;
>
> - memset(&conf, 0, sizeof(struct fpga_lte_fec_conf));
> + memset(&conf, 0, sizeof(struct rte_fpga_lte_fec_conf));
> conf.pf_mode_en = 1;
>
> for (i = 0; i < FPGA_LTE_FEC_NUM_VFS; ++i) {
> @@ -234,7 +234,7 @@ below:
> conf.ul_load_balance = 64;
>
> /* setup FPGA PF */
> - ret = fpga_lte_fec_configure(info->dev_name, &conf);
> + ret = rte_fpga_lte_fec_configure(info->dev_name, &conf);
> TEST_ASSERT_SUCCESS(ret,
> "Failed to configure 4G FPGA PF for bbdev %s",
> info->dev_name);
> diff --git a/drivers/baseband/fpga_lte_fec/fpga_lte_fec.c b/drivers/baseband/fpga_lte_fec/fpga_lte_fec.c
> index 37018b9c7f..71de399eef 100644
> --- a/drivers/baseband/fpga_lte_fec/fpga_lte_fec.c
> +++ b/drivers/baseband/fpga_lte_fec/fpga_lte_fec.c
> @@ -2432,10 +2432,10 @@ fpga_lte_fec_remove(struct rte_pci_device *pci_dev)
> }
>
> static inline void
> -set_default_fpga_conf(struct fpga_lte_fec_conf *def_conf)
> +set_default_fpga_conf(struct rte_fpga_lte_fec_conf *def_conf)
> {
> /* clear default configuration before initialization */
> - memset(def_conf, 0, sizeof(struct fpga_lte_fec_conf));
> + memset(def_conf, 0, sizeof(struct rte_fpga_lte_fec_conf));
> /* Set pf mode to true */
> def_conf->pf_mode_en = true;
>
> @@ -2450,15 +2450,15 @@ set_default_fpga_conf(struct fpga_lte_fec_conf *def_conf)
>
> /* Initial configuration of FPGA LTE FEC device */
> int
> -fpga_lte_fec_configure(const char *dev_name,
> - const struct fpga_lte_fec_conf *conf)
> +rte_fpga_lte_fec_configure(const char *dev_name,
> + const struct rte_fpga_lte_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_lte_fec_conf def_conf;
> + struct rte_fpga_lte_fec_conf def_conf;
>
> if (bbdev == NULL) {
> rte_bbdev_log(ERR,
> diff --git a/drivers/baseband/fpga_lte_fec/fpga_lte_fec.h b/drivers/baseband/fpga_lte_fec/fpga_lte_fec.h
> index b2e423c87c..b35c7a484e 100644
> --- a/drivers/baseband/fpga_lte_fec/fpga_lte_fec.h
> +++ b/drivers/baseband/fpga_lte_fec/fpga_lte_fec.h
> @@ -30,7 +30,7 @@ extern "C" {
> /**
> * Structure to pass FPGA 4G FEC configuration.
> */
> -struct fpga_lte_fec_conf {
> +struct rte_fpga_lte_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_lte_fec_conf {
> */
> __rte_experimental
> int
> -fpga_lte_fec_configure(const char *dev_name,
> - const struct fpga_lte_fec_conf *conf);
> +rte_fpga_lte_fec_configure(const char *dev_name,
> + const struct rte_fpga_lte_fec_conf *conf);
>
> #ifdef __cplusplus
> }
> diff --git a/drivers/baseband/fpga_lte_fec/rte_pmd_bbdev_fpga_lte_fec_version.map b/drivers/baseband/fpga_lte_fec/rte_pmd_bbdev_fpga_lte_fec_version.map
> index a2ab086cd8..b95b7838e8 100644
> --- a/drivers/baseband/fpga_lte_fec/rte_pmd_bbdev_fpga_lte_fec_version.map
> +++ b/drivers/baseband/fpga_lte_fec/rte_pmd_bbdev_fpga_lte_fec_version.map
> @@ -5,6 +5,6 @@ DPDK_21 {
> EXPERIMENTAL {
> global:
>
> - fpga_lte_fec_configure;
> + rte_fpga_lte_fec_configure;
>
> };
Looks fine.
Reviewed-by: Tom Rix <trix@redhat.com>
next prev parent reply other threads:[~2020-10-03 15:31 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
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 [this message]
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=2bd74daa-b8de-ea4a-7faf-0e8008cc22a0@redhat.com \
--to=trix@redhat.com \
--cc=akhil.goyal@nxp.com \
--cc=dev@dpdk.org \
--cc=ferruh.yigit@intel.com \
--cc=maxime.coquelin@redhat.com \
--cc=nicolas.chautru@intel.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
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).