From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by dpdk.org (Postfix) with ESMTP id 6550868A8 for ; Thu, 22 May 2014 08:11:21 +0200 (CEST) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP; 21 May 2014 23:06:23 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.98,885,1392192000"; d="scan'208";a="544710747" Received: from shilc102.sh.intel.com ([10.239.39.44]) by orsmga002.jf.intel.com with ESMTP; 21 May 2014 23:11:24 -0700 Received: from shecgisg004.sh.intel.com (shecgisg004.sh.intel.com [10.239.29.89]) by shilc102.sh.intel.com (8.13.6/8.13.6/SuSE Linux 0.8) with ESMTP id s4M6BJ5w026769; Thu, 22 May 2014 14:11:21 +0800 Received: from shecgisg004.sh.intel.com (localhost [127.0.0.1]) by shecgisg004.sh.intel.com (8.13.6/8.13.6/SuSE Linux 0.8) with ESMTP id s4M6BHqD032119; Thu, 22 May 2014 14:11:19 +0800 Received: (from couyang@localhost) by shecgisg004.sh.intel.com (8.13.6/8.13.6/Submit) id s4M6BHqZ032115; Thu, 22 May 2014 14:11:17 +0800 From: Ouyang Changchun To: dev@dpdk.org Date: Thu, 22 May 2014 14:11:11 +0800 Message-Id: <1400739073-32011-2-git-send-email-changchun.ouyang@intel.com> X-Mailer: git-send-email 1.7.0.7 In-Reply-To: <1400739073-32011-1-git-send-email-changchun.ouyang@intel.com> References: <1400739073-32011-1-git-send-email-changchun.ouyang@intel.com> Subject: [dpdk-dev] [PATCH 1/3] ether: Add API to support administrative link up and down X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2014 06:11:21 -0000 This patch addes API to support administrative link up and down. Signed-off-by: Ouyang Changchun --- lib/librte_ether/rte_ethdev.c | 38 ++++++++++++++++++++++++++++++++++++++ lib/librte_ether/rte_ethdev.h | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 72 insertions(+) diff --git a/lib/librte_ether/rte_ethdev.c b/lib/librte_ether/rte_ethdev.c index 0ddedfb..06a0896 100644 --- a/lib/librte_ether/rte_ethdev.c +++ b/lib/librte_ether/rte_ethdev.c @@ -796,6 +796,44 @@ rte_eth_dev_stop(uint8_t port_id) (*dev->dev_ops->dev_stop)(dev); } +int +rte_eth_dev_admin_link_up(uint8_t port_id) +{ + struct rte_eth_dev *dev; + + /* This function is only safe when called from the primary process + * in a multi-process setup*/ + PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY); + + if (port_id >= nb_ports) { + PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id); + return (-EINVAL); + } + dev = &rte_eth_devices[port_id]; + + FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_admin_link_up, -ENOTSUP); + return (*dev->dev_ops->dev_admin_link_up)(dev); +} + +int +rte_eth_dev_admin_link_down(uint8_t port_id) +{ + struct rte_eth_dev *dev; + + /* This function is only safe when called from the primary process + * in a multi-process setup*/ + PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY); + + if (port_id >= nb_ports) { + PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id); + return (-EINVAL); + } + dev = &rte_eth_devices[port_id]; + + FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_admin_link_down, -ENOTSUP); + return (*dev->dev_ops->dev_admin_link_down)(dev); +} + void rte_eth_dev_close(uint8_t port_id) { diff --git a/lib/librte_ether/rte_ethdev.h b/lib/librte_ether/rte_ethdev.h index 2be6e4f..d33ff93 100644 --- a/lib/librte_ether/rte_ethdev.h +++ b/lib/librte_ether/rte_ethdev.h @@ -891,6 +891,12 @@ typedef int (*eth_dev_start_t)(struct rte_eth_dev *dev); typedef void (*eth_dev_stop_t)(struct rte_eth_dev *dev); /**< @internal Function used to stop a configured Ethernet device. */ +typedef int (*eth_dev_admin_link_up_t)(struct rte_eth_dev *dev); +/**< @internal Function used to link up a configured Ethernet device administratively. */ + +typedef int (*eth_dev_admin_link_down_t)(struct rte_eth_dev *dev); +/**< @internal Function used to link down a configured Ethernet device administratively. */ + typedef void (*eth_dev_close_t)(struct rte_eth_dev *dev); /**< @internal Function used to close a configured Ethernet device. */ @@ -1223,6 +1229,8 @@ struct eth_dev_ops { eth_dev_configure_t dev_configure; /**< Configure device. */ eth_dev_start_t dev_start; /**< Start device. */ eth_dev_stop_t dev_stop; /**< Stop device. */ + eth_dev_admin_link_up_t dev_admin_link_up; /**< Device link up administratively. */ + eth_dev_admin_link_down_t dev_admin_link_down; /**< device link down admininstratively. */ eth_dev_close_t dev_close; /**< Close device. */ eth_promiscuous_enable_t promiscuous_enable; /**< Promiscuous ON. */ eth_promiscuous_disable_t promiscuous_disable;/**< Promiscuous OFF. */ @@ -1696,6 +1704,32 @@ extern int rte_eth_dev_start(uint8_t port_id); */ extern void rte_eth_dev_stop(uint8_t port_id); + +/** + * Link up an Ethernet device administratively. + * + * The administrative device link up will re-enable the device rx/tx functionality + * after it is previously administrative device linked down. + * + * @param port_id + * The port identifier of the Ethernet device. + * @return + * - 0: Success, Ethernet device linked up administratively. + * - <0: Error code of the driver device link up function. + */ +extern int rte_eth_dev_admin_link_up(uint8_t port_id); + +/** + * Link down an Ethernet device administratively. + * The device rx/tx functionality will be disabled if success, + * and it can be re-enabled with a call to + * rte_eth_dev_admin_link_up() + * + * @param port_id + * The port identifier of the Ethernet device. + */ +extern int rte_eth_dev_admin_link_down(uint8_t port_id); + /** * Close an Ethernet device. The device cannot be restarted! * -- 1.9.0