ethdev: add link status get/set helper functions

[dpdk.git] / lib / librte_ether / rte_ethdev_driver.h

diff --git a/lib/librte_ether/rte_ethdev_driver.h b/lib/librte_ether/rte_ethdev_driver.h
index 45f08c6..a406ef1 100644 (file)
--- a/lib/librte_ether/rte_ethdev_driver.h
+++ b/lib/librte_ether/rte_ethdev_driver.h
@@ -125,6 +125,69 @@ rte_eth_dma_zone_reserve(const struct rte_eth_dev *eth_dev, const char *name,
                         uint16_t queue_id, size_t size,
                         unsigned align, int socket_id);
 
+/**
+ * @internal
+ * Atomically set the link status for the specific device.
+ * It is for use by DPDK device driver use only.
+ * User applications should not call it
+ *
+ * @param dev
+ *  Pointer to struct rte_eth_dev.
+ * @param link
+ *  New link status value.
+ * @return
+ *  Same convention as eth_link_update operation.
+ *  0   if link up status has changed
+ *  -1  if link up status was unchanged
+ */
+static inline int
+rte_eth_linkstatus_set(struct rte_eth_dev *dev,
+                      const struct rte_eth_link *new_link)
+{
+       volatile uint64_t *dev_link
+                = (volatile uint64_t *)&(dev->data->dev_link);
+       union {
+               uint64_t val64;
+               struct rte_eth_link link;
+       } orig;
+
+       RTE_BUILD_BUG_ON(sizeof(*new_link) != sizeof(uint64_t));
+
+       orig.val64 = rte_atomic64_exchange(dev_link,
+                                          *(const uint64_t *)new_link);
+
+       return (orig.link.link_status == new_link->link_status) ? -1 : 0;
+}
+
+/**
+ * @internal
+ * Atomically get the link speed and status.
+ *
+ * @param dev
+ *  Pointer to struct rte_eth_dev.
+ * @param link
+ *  link status value.
+ */
+static inline void
+rte_eth_linkstatus_get(const struct rte_eth_dev *dev,
+                      struct rte_eth_link *link)
+{
+       volatile uint64_t *src = (uint64_t *)&(dev->data->dev_link);
+       uint64_t *dst = (uint64_t *)link;
+
+       RTE_BUILD_BUG_ON(sizeof(*link) != sizeof(uint64_t));
+
+#ifdef __LP64__
+       /* if cpu arch has 64 bit unsigned lon then implicitly atomic */
+       *dst = *src;
+#else
+       /* can't use rte_atomic64_read because it returns signed int */
+       do {
+               *dst = *src;
+       } while (!rte_atomic64_cmpset(src, *dst, *dst));
+#endif
+}
+
 #ifdef __cplusplus
 }
 #endif