netdev: Document use for get_etheraddr member of struct netdev_class.
authorBen Pfaff <blp@nicira.com>
Mon, 30 Apr 2012 18:23:38 +0000 (11:23 -0700)
committerBen Pfaff <blp@nicira.com>
Tue, 1 May 2012 21:29:35 +0000 (14:29 -0700)
This has confused developers adding hardware support, e.g.:
http://openvswitch.org/pipermail/dev/2012-April/016350.html

Signed-off-by: Ben Pfaff <blp@nicira.com>
lib/netdev-provider.h

index daf46adee92d4fb1215bf6f9165cb1a3e2d5e64a..6daae5e6ca5932bd22ed211f0021e62a103ac645 100644 (file)
@@ -231,7 +231,10 @@ struct netdev_class {
     /* Sets 'netdev''s Ethernet address to 'mac' */
     int (*set_etheraddr)(struct netdev *netdev, const uint8_t mac[6]);
 
-    /* Retrieves 'netdev''s Ethernet address into 'mac'. */
+    /* Retrieves 'netdev''s Ethernet address into 'mac'.
+     *
+     * This address will be advertised as 'netdev''s MAC address through the
+     * OpenFlow protocol, among other uses. */
     int (*get_etheraddr)(const struct netdev *netdev, uint8_t mac[6]);
 
     /* Retrieves 'netdev''s MTU into '*mtup'.