#include "list.h"
#include "shash.h"
+#ifdef __cplusplus
+extern "C" {
+#endif
+
struct arg {
char *key;
char *value;
* implementations. */
struct netdev_dev {
char *name; /* Name of network device. */
- const struct netdev_class *class; /* Functions to control this device. */
+ const struct netdev_class *netdev_class; /* Functions to control
+ this device. */
int ref_cnt; /* Times this devices was opened. */
struct shash_node *node; /* Pointer to element in global map. */
struct arg *args; /* Argument list from last config. */
struct shash *device_list);
static inline void netdev_dev_assert_class(const struct netdev_dev *netdev_dev,
- const struct netdev_class *class)
+ const struct netdev_class *class_)
{
- assert(netdev_dev->class == class);
+ assert(netdev_dev->netdev_class == class_);
}
/* A instance of an open network device.
struct netdev_dev *netdev_get_dev(const struct netdev *);
static inline void netdev_assert_class(const struct netdev *netdev,
- const struct netdev_class *class)
+ const struct netdev_class *netdev_class)
{
- netdev_dev_assert_class(netdev_get_dev(netdev), class);
+ netdev_dev_assert_class(netdev_get_dev(netdev), netdev_class);
}
/* A network device notifier.
* the system. */
const char *type;
- /* Called only once, at program startup. Returning an error from this
- * function will prevent any network device in this class from being
- * opened.
+ /* Called when the netdev provider is registered, typically at program
+ * startup. Returning an error from this function will prevent any network
+ * device in this class from being opened.
*
* This function may be set to null if a network device class needs no
- * initialization at program startup. */
+ * initialization at registration time. */
int (*init)(void);
/* Performs periodic work needed by netdevs of this class. May be null if
/* Attempts to receive a packet from 'netdev' into the 'size' bytes in
* 'buffer'. If successful, returns the number of bytes in the received
* packet, otherwise a negative errno value. Returns -EAGAIN immediately
- * if no packet is ready to be received. */
+ * if no packet is ready to be received.
+ *
+ * May return -EOPNOTSUPP if a network device does not implement packet
+ * reception through this interface. This function may be set to null if
+ * it would always return -EOPNOTSUPP anyhow. (This will disable the OVS
+ * integrated DHCP client and OpenFlow controller discovery, and prevent
+ * the network device from being usefully used by the netdev-based
+ * "userspace datapath".) */
int (*recv)(struct netdev *netdev, void *buffer, size_t size);
/* Registers with the poll loop to wake up from the next call to
* poll_block() when a packet is ready to be received with netdev_recv() on
- * 'netdev'. */
+ * 'netdev'.
+ *
+ * May be null if not needed, such as for a network device that does not
+ * implement packet reception through the 'recv' member function. */
void (*recv_wait)(struct netdev *netdev);
- /* Discards all packets waiting to be received from 'netdev'. */
+ /* Discards all packets waiting to be received from 'netdev'.
+ *
+ * May be null if not needed, such as for a network device that does not
+ * implement packet reception through the 'recv' member function. */
int (*drain)(struct netdev *netdev);
/* Sends the 'size'-byte packet in 'buffer' on 'netdev'. Returns 0 if
*
* The network device is expected to maintain a packet transmission queue,
* so that the caller does not ordinarily have to do additional queuing of
- * packets. */
+ * packets.
+ *
+ * May return EOPNOTSUPP if a network device does not implement packet
+ * transmission through this interface. This function may be set to null
+ * if it would always return EOPNOTSUPP anyhow. (This will disable the OVS
+ * integrated DHCP client and OpenFlow controller discovery, and prevent
+ * the network device from being usefully used by the netdev-based
+ * "userspace datapath".) */
int (*send)(struct netdev *netdev, const void *buffer, size_t size);
/* Registers with the poll loop to wake up from the next call to
*
* The network device is expected to maintain a packet transmission queue,
* so that the caller does not ordinarily have to do additional queuing of
- * packets. Thus, this function is unlikely to ever be useful. */
+ * packets. Thus, this function is unlikely to ever be useful.
+ *
+ * May be null if not needed, such as for a network device that does not
+ * implement packet transmission through the 'send' member function. */
void (*send_wait)(struct netdev *netdev);
/* Sets 'netdev''s Ethernet address to 'mac' */
extern const struct netdev_class netdev_tap_class;
extern const struct netdev_class netdev_gre_class;
+#ifdef __cplusplus
+}
+#endif
+
#endif /* netdev.h */