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 A21671B1C5 for ; Mon, 8 Jan 2018 15:37:30 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 08 Jan 2018 06:37:30 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,330,1511856000"; d="scan'208";a="17580481" Received: from rhorton-mobl1.ger.corp.intel.com (HELO FC23.ir.intel.com) ([163.33.230.198]) by FMSMGA003.fm.intel.com with ESMTP; 08 Jan 2018 06:37:29 -0800 From: Remy Horton To: dev@dpdk.org Cc: John McNamara , Wenzhuo Lu , Jingjing Wu Date: Mon, 8 Jan 2018 14:37:20 +0000 Message-Id: <20180108143720.7994-6-remy.horton@intel.com> X-Mailer: git-send-email 2.9.5 In-Reply-To: <20180108143720.7994-1-remy.horton@intel.com> References: <20180108143720.7994-1-remy.horton@intel.com> Subject: [dpdk-dev] [PATCH v4 5/5] app/test-pmd: add Port Representor commands 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, 08 Jan 2018 14:37:31 -0000 Port Representors provide a logical presentation in DPDK of VF (virtual function) ports for the purposes of control and monitoring. Each port representor device represents a single VF and is associated with it's parent physical function (PF) PMD which provides the back-end hooks for the representor device ops and defines the control domain to which that port belongs. This allows to use existing DPDK APIs to monitor and control the port without the need to create and maintain VF specific APIs. This patch adds the 'add representor' and 'del representor' commands to test-pmd, which respectively allow the adding and removing of port representors. Signed-off-by: Remy Horton --- app/test-pmd/cmdline.c | 88 +++++++++++++++++++++++++++++ doc/guides/testpmd_app_ug/testpmd_funcs.rst | 25 ++++++++ 2 files changed, 113 insertions(+) diff --git a/app/test-pmd/cmdline.c b/app/test-pmd/cmdline.c index f71d963..1a831ba 100644 --- a/app/test-pmd/cmdline.c +++ b/app/test-pmd/cmdline.c @@ -76,6 +76,7 @@ #include #include #include +#include #include #include @@ -15535,6 +15536,91 @@ cmdline_parse_inst_t cmd_load_from_file = { }, }; +struct cmd_add_representor_result { + cmdline_fixed_string_t cmd; + cmdline_fixed_string_t representor; + cmdline_fixed_string_t pf; + uint16_t vport; +}; + +cmdline_parse_token_string_t cmd_addrepresentor_add = +TOKEN_STRING_INITIALIZER(struct cmd_add_representor_result, + cmd, "add"); +cmdline_parse_token_string_t cmd_addrepresentor_del = +TOKEN_STRING_INITIALIZER(struct cmd_add_representor_result, + cmd, "del"); +cmdline_parse_token_string_t cmd_addrepresentor_rep = +TOKEN_STRING_INITIALIZER(struct cmd_add_representor_result, + representor, "representor"); +cmdline_parse_token_string_t cmd_addrepresentor_pf = +TOKEN_STRING_INITIALIZER(struct cmd_add_representor_result, + pf, NULL); +cmdline_parse_token_num_t cmd_addrepresentor_vport = +TOKEN_NUM_INITIALIZER(struct cmd_add_representor_result, + vport, UINT16); + +static void cmd_add_representor_callback(void *parsed_result, + __attribute__((unused)) struct cmdline *cl, + __attribute__((unused)) void *data) +{ + struct cmd_add_representor_result *res = parsed_result; + uint16_t port_id; + int ret; + + rte_log(RTE_LOG_INFO, RTE_LOGTYPE_USER1, "%s(): addr:%s vport:%i\n", + __func__, res->pf, res->vport); + + ret = rte_representor_port_register(res->pf, res->vport, &port_id); + if (ret != 0) + printf("Registering port representor failed\n"); + else + printf("Port Representor registered with port id %i\n", + port_id); +} + +static void cmd_del_representor_callback(void *parsed_result, + __attribute__((unused)) struct cmdline *cl, + __attribute__((unused)) void *data) +{ + struct cmd_add_representor_result *res = parsed_result; + int ret; + + rte_log(RTE_LOG_INFO, RTE_LOGTYPE_USER1, "%s(): port:%i\n", __func__, + res->vport); + ret = rte_representor_port_unregister(res->pf, res->vport); + if (ret != 0) + printf("Port %i is not a valid port representor.\n", + res->vport); +} + +cmdline_parse_inst_t cmd_add_representor = { + .f = cmd_add_representor_callback, + .help_str = "add representor " + "Add a Port Representor", + .data = NULL, + .tokens = { + (void *)&cmd_addrepresentor_add, + (void *)&cmd_addrepresentor_rep, + (void *)&cmd_addrepresentor_pf, + (void *)&cmd_addrepresentor_vport, + NULL + } +}; + +cmdline_parse_inst_t cmd_del_representor = { + .f = cmd_del_representor_callback, + .help_str = "del representor " + "Delete a Port Representor", + .data = NULL, + .tokens = { + (void *)&cmd_addrepresentor_del, + (void *)&cmd_addrepresentor_rep, + (void *)&cmd_addrepresentor_pf, + (void *)&cmd_addrepresentor_vport, + NULL + } +}; + /* ******************************************************************************** */ /* list of instructions */ @@ -15576,6 +15662,8 @@ cmdline_parse_ctx_t main_ctx[] = { (cmdline_parse_inst_t *) &cmd_show_bonding_config, (cmdline_parse_inst_t *) &cmd_set_bonding_primary, (cmdline_parse_inst_t *) &cmd_add_bonding_slave, + (cmdline_parse_inst_t *) &cmd_add_representor, + (cmdline_parse_inst_t *) &cmd_del_representor, (cmdline_parse_inst_t *) &cmd_remove_bonding_slave, (cmdline_parse_inst_t *) &cmd_create_bonded_device, (cmdline_parse_inst_t *) &cmd_set_bond_mac_addr, diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index 9789139..0eaeb38 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -3481,3 +3481,28 @@ Validate and create a QinQ rule on port 0 to steer traffic to a queue on the hos ID Group Prio Attr Rule 0 0 0 i- ETH VLAN VLAN=>VF QUEUE 1 0 0 i- ETH VLAN VLAN=>PF QUEUE + +Port Representors +----------------- + +Adding and removal of port representors (*rte_representor*) is done via the +``add representor`` and ``del representor`` commands. Once created these +can take the same control commands as the underlying VF (Virtual Function). + + +Adding a representor +~~~~~~~~~~~~~~~~~~~~ + +Adding a representor for a VF requires specifying the PF in +``Bus_DomBDF`` format alongside the index number of the VF:: + + testpmd> add representor pci_0000:81:00.0 0 + + +Removing a representor +~~~~~~~~~~~~~~~~~~~~~~ + +To remove a representor, the same parameters are required as were used to +create it:: + + testpmd> del representor pci_0000:81:00.0 0 -- 2.9.5