Differences

This shows you the differences between two versions of the page.

--- ndo_change_carrier [2018/08/04 12:13] – [include/linux/netdevice.h] rpjday
+++ ndo_change_carrier [2018/08/04 17:31] (current) – [Overview] rpjday
@@ Line 1: / Line 1: @@
 ===== Overview =====
-Setting/detecting carrier, and the subsequent implications of setting ''net_device_ops'' ''ndo_change_carrier'' field.
+Setting/detecting carrier, and the subsequent implications of setting ''net_device_ops'' ''ndo_change_carrier'' field (if any implications actually exist):
-===== include/linux/netdevice.h =====
+===== Normal behaviour =====
+==== Net device state ====
+From ''include/linux/netdevice.h'':
 Net device state:
@@ Line 14: / Line 18: @@
 </code>
-State flag bits:
+State flag bits for later testing:
 <code>
@@ Line 26: / Line 30: @@
 </code>
-Check if carrier is present on device:
+==== Checking for state of carrier ====
+Again from ''netdevice.h'':
 <code>
@@ Line 42: / Line 48: @@
 void netif_carrier_on(struct net_device *dev);
 void netif_carrier_off(struct net_device *dev);
+</code>
+==== Test for interface running ====
+Still in ''netdevice.h'':
+<code>
+/**
+ *	netif_running - test if up
+ *	@dev: network device
+ *
+ *	Test if the device has been brought up.
+ */
+static inline bool netif_running(const struct net_device *dev)
+{
+	return test_bit(__LINK_STATE_START, &dev->state);
+}
+</code>
+==== Test if carrier on or off ====
+From ''net/sched/sch_generic.c'':
+<code>
+/**
+ *      netif_carrier_on - set carrier
+ *      @dev: network device
+ *
+ * Device has detected that carrier.
+ */
+void netif_carrier_on(struct net_device *dev)
+{
+        if (test_and_clear_bit(__LINK_STATE_NOCARRIER, &dev->state)) {
+                if (dev->reg_state == NETREG_UNINITIALIZED)
+                        return;
+                atomic_inc(&dev->carrier_up_count);
+                linkwatch_fire_event(dev);
+                if (netif_running(dev))
+                        __netdev_watchdog_up(dev);
+        }
+}
+EXPORT_SYMBOL(netif_carrier_on);
+/**
+ *      netif_carrier_off - clear carrier
+ *      @dev: network device
+ *
+ * Device has detected loss of carrier.
+ */
+void netif_carrier_off(struct net_device *dev)
+{
+        if (!test_and_set_bit(__LINK_STATE_NOCARRIER, &dev->state)) {
+                if (dev->reg_state == NETREG_UNINITIALIZED)
+                        return;
+                atomic_inc(&dev->carrier_down_count);
+                linkwatch_fire_event(dev);
+        }
+}
+EXPORT_SYMBOL(netif_carrier_off);
 </code>