ethdev: add Tx preparation
[dpdk.git] / lib / librte_ether / rte_ethdev.h
index 0a32ebb..1c356c1 100644 (file)
@@ -182,6 +182,7 @@ extern "C" {
 #include <rte_pci.h>
 #include <rte_dev.h>
 #include <rte_devargs.h>
+#include <rte_errno.h>
 #include "rte_ether.h"
 #include "rte_eth_ctrl.h"
 #include "rte_dev_info.h"
@@ -190,6 +191,9 @@ struct rte_mbuf;
 
 /**
  * A structure used to retrieve statistics for an Ethernet port.
+ * Not all statistics fields in struct rte_eth_stats are supported
+ * by any type of network interface card (NIC). If any statistics
+ * field is not supported, its value is 0.
  */
 struct rte_eth_stats {
        uint64_t ipackets;  /**< Total number of successfully received packets. */
@@ -699,6 +703,29 @@ struct rte_eth_desc_lim {
        uint16_t nb_max;   /**< Max allowed number of descriptors. */
        uint16_t nb_min;   /**< Min allowed number of descriptors. */
        uint16_t nb_align; /**< Number of descriptors should be aligned to. */
+
+       /**
+        * Max allowed number of segments per whole packet.
+        *
+        * - For TSO packet this is the total number of data descriptors allowed
+        *   by device.
+        *
+        * @see nb_mtu_seg_max
+        */
+       uint16_t nb_seg_max;
+
+       /**
+        * Max number of segments per one MTU.
+        *
+        * - For non-TSO packet, this is the maximum allowed number of segments
+        *   in a single transmit packet.
+        *
+        * - For TSO packet each segment within the TSO may span up to this
+        *   value.
+        *
+        * @see nb_seg_max
+        */
+       uint16_t nb_mtu_seg_max;
 };
 
 /**
@@ -935,23 +962,26 @@ struct rte_eth_txq_info {
 /**
  * An Ethernet device extended statistic structure
  *
- * This structure is used by ethdev->eth_xstats_get() to provide
- * statistics that are not provided in the generic rte_eth_stats
+ * This structure is used by rte_eth_xstats_get() to provide
+ * statistics that are not provided in the generic *rte_eth_stats*
  * structure.
+ * It maps a name id, corresponding to an index in the array returned
+ * by rte_eth_xstats_get_names(), to a statistic value.
  */
 struct rte_eth_xstat {
-       uint64_t id;
-       uint64_t value;
+       uint64_t id;        /**< The index in xstats name array. */
+       uint64_t value;     /**< The statistic counter value. */
 };
 
 /**
- * A name-key lookup element for extended statistics.
+ * A name element for extended statistics.
  *
- * This structure is used to map between names and ID numbers
- * for extended ethernet statistics.
+ * An array of this structure is returned by rte_eth_xstats_get_names().
+ * It lists the names of extended statistics for a PMD. The *rte_eth_xstat*
+ * structure references these names by their array index.
  */
 struct rte_eth_xstat_name {
-       char name[RTE_ETH_XSTATS_NAME_SIZE];
+       char name[RTE_ETH_XSTATS_NAME_SIZE]; /**< The statistic name. */
 };
 
 #define ETH_DCB_NUM_TCS    8
@@ -1188,6 +1218,11 @@ typedef uint16_t (*eth_tx_burst_t)(void *txq,
                                   uint16_t nb_pkts);
 /**< @internal Send output packets on a transmit queue of an Ethernet device. */
 
+typedef uint16_t (*eth_tx_prep_t)(void *txq,
+                                  struct rte_mbuf **tx_pkts,
+                                  uint16_t nb_pkts);
+/**< @internal Prepare output packets on a transmit queue of an Ethernet device. */
+
 typedef int (*flow_ctrl_get_t)(struct rte_eth_dev *dev,
                               struct rte_eth_fc_conf *fc_conf);
 /**< @internal Get current flow control parameter on an Ethernet device */
@@ -1428,11 +1463,18 @@ struct eth_dev_ops {
        eth_dev_set_link_up_t      dev_set_link_up;   /**< Device link up. */
        eth_dev_set_link_down_t    dev_set_link_down; /**< Device link down. */
        eth_dev_close_t            dev_close;     /**< Close device. */
+       eth_link_update_t          link_update;   /**< Get device link state. */
+
        eth_promiscuous_enable_t   promiscuous_enable; /**< Promiscuous ON. */
        eth_promiscuous_disable_t  promiscuous_disable;/**< Promiscuous OFF. */
        eth_allmulticast_enable_t  allmulticast_enable;/**< RX multicast ON. */
        eth_allmulticast_disable_t allmulticast_disable;/**< RX multicast OF. */
-       eth_link_update_t          link_update;   /**< Get device link state. */
+       eth_mac_addr_remove_t      mac_addr_remove; /**< Remove MAC address. */
+       eth_mac_addr_add_t         mac_addr_add;  /**< Add a MAC address. */
+       eth_mac_addr_set_t         mac_addr_set;  /**< Set a MAC address. */
+       eth_set_mc_addr_list_t     set_mc_addr_list; /**< set list of mcast addrs. */
+       mtu_set_t                  mtu_set;       /**< Set MTU. */
+
        eth_stats_get_t            stats_get;     /**< Get generic device statistics. */
        eth_stats_reset_t          stats_reset;   /**< Reset generic device statistics. */
        eth_xstats_get_t           xstats_get;    /**< Get extended device statistics. */
@@ -1441,109 +1483,98 @@ struct eth_dev_ops {
        /**< Get names of extended statistics. */
        eth_queue_stats_mapping_set_t queue_stats_mapping_set;
        /**< Configure per queue stat counter mapping. */
+
        eth_dev_infos_get_t        dev_infos_get; /**< Get device info. */
+       eth_rxq_info_get_t         rxq_info_get; /**< retrieve RX queue information. */
+       eth_txq_info_get_t         txq_info_get; /**< retrieve TX queue information. */
        eth_dev_supported_ptypes_get_t dev_supported_ptypes_get;
-       /**< Get packet types supported and identified by device*/
-       mtu_set_t                  mtu_set; /**< Set MTU. */
-       vlan_filter_set_t          vlan_filter_set;  /**< Filter VLAN Setup. */
-       vlan_tpid_set_t            vlan_tpid_set;      /**< Outer/Inner VLAN TPID Setup. */
+       /**< Get packet types supported and identified by device*/
+
+       vlan_filter_set_t          vlan_filter_set; /**< Filter VLAN Setup. */
+       vlan_tpid_set_t            vlan_tpid_set; /**< Outer/Inner VLAN TPID Setup. */
        vlan_strip_queue_set_t     vlan_strip_queue_set; /**< VLAN Stripping on queue. */
        vlan_offload_set_t         vlan_offload_set; /**< Set VLAN Offload. */
-       vlan_pvid_set_t            vlan_pvid_set; /**< Set port based TX VLAN insertion */
-       eth_queue_start_t          rx_queue_start;/**< Start RX for a queue.*/
-       eth_queue_stop_t           rx_queue_stop;/**< Stop RX for a queue.*/
-       eth_queue_start_t          tx_queue_start;/**< Start TX for a queue.*/
-       eth_queue_stop_t           tx_queue_stop;/**< Stop TX for a queue.*/
-       eth_rx_queue_setup_t       rx_queue_setup;/**< Set up device RX queue.*/
-       eth_queue_release_t        rx_queue_release;/**< Release RX queue.*/
-       eth_rx_queue_count_t       rx_queue_count; /**< Get Rx queue count. */
-       eth_rx_descriptor_done_t   rx_descriptor_done;  /**< Check rxd DD bit */
-       /**< Enable Rx queue interrupt. */
-       eth_rx_enable_intr_t       rx_queue_intr_enable;
-       /**< Disable Rx queue interrupt.*/
-       eth_rx_disable_intr_t      rx_queue_intr_disable;
-       eth_tx_queue_setup_t       tx_queue_setup;/**< Set up device TX queue.*/
-       eth_queue_release_t        tx_queue_release;/**< Release TX queue.*/
+       vlan_pvid_set_t            vlan_pvid_set; /**< Set port based TX VLAN insertion. */
+
+       eth_queue_start_t          rx_queue_start;/**< Start RX for a queue. */
+       eth_queue_stop_t           rx_queue_stop; /**< Stop RX for a queue. */
+       eth_queue_start_t          tx_queue_start;/**< Start TX for a queue. */
+       eth_queue_stop_t           tx_queue_stop; /**< Stop TX for a queue. */
+       eth_rx_queue_setup_t       rx_queue_setup;/**< Set up device RX queue. */
+       eth_queue_release_t        rx_queue_release; /**< Release RX queue. */
+       eth_rx_queue_count_t       rx_queue_count;/**< Get Rx queue count. */
+       eth_rx_descriptor_done_t   rx_descriptor_done; /**< Check rxd DD bit. */
+       eth_rx_enable_intr_t       rx_queue_intr_enable;  /**< Enable Rx queue interrupt. */
+       eth_rx_disable_intr_t      rx_queue_intr_disable; /**< Disable Rx queue interrupt. */
+       eth_tx_queue_setup_t       tx_queue_setup;/**< Set up device TX queue. */
+       eth_queue_release_t        tx_queue_release; /**< Release TX queue. */
+
        eth_dev_led_on_t           dev_led_on;    /**< Turn on LED. */
        eth_dev_led_off_t          dev_led_off;   /**< Turn off LED. */
+
        flow_ctrl_get_t            flow_ctrl_get; /**< Get flow control. */
        flow_ctrl_set_t            flow_ctrl_set; /**< Setup flow control. */
-       priority_flow_ctrl_set_t   priority_flow_ctrl_set; /**< Setup priority flow control.*/
-       eth_mac_addr_remove_t      mac_addr_remove; /**< Remove MAC address */
-       eth_mac_addr_add_t         mac_addr_add;  /**< Add a MAC address */
-       eth_mac_addr_set_t         mac_addr_set;  /**< Set a MAC address */
-       eth_uc_hash_table_set_t    uc_hash_table_set;  /**< Set Unicast Table Array */
-       eth_uc_all_hash_table_set_t uc_all_hash_table_set;  /**< Set Unicast hash bitmap */
-       eth_mirror_rule_set_t      mirror_rule_set;  /**< Add a traffic mirror rule.*/
-       eth_mirror_rule_reset_t    mirror_rule_reset;  /**< reset a traffic mirror rule.*/
-       eth_set_vf_rx_mode_t       set_vf_rx_mode;   /**< Set VF RX mode */
-       eth_set_vf_rx_t            set_vf_rx;  /**< enable/disable a VF receive */
-       eth_set_vf_tx_t            set_vf_tx;  /**< enable/disable a VF transmit */
-       eth_set_vf_vlan_filter_t   set_vf_vlan_filter;  /**< Set VF VLAN filter */
-       /** Add UDP tunnel port. */
-       eth_udp_tunnel_port_add_t udp_tunnel_port_add;
-       /** Del UDP tunnel port. */
-       eth_udp_tunnel_port_del_t udp_tunnel_port_del;
-       eth_set_queue_rate_limit_t set_queue_rate_limit;   /**< Set queue rate limit */
-       eth_set_vf_rate_limit_t    set_vf_rate_limit;   /**< Set VF rate limit */
-       /** Update redirection table. */
-       reta_update_t reta_update;
-       /** Query redirection table. */
-       reta_query_t reta_query;
-
-       eth_get_reg_t get_reg;
-       /**< Get registers */
-       eth_get_eeprom_length_t get_eeprom_length;
-       /**< Get eeprom length */
-       eth_get_eeprom_t get_eeprom;
-       /**< Get eeprom data */
-       eth_set_eeprom_t set_eeprom;
-       /**< Set eeprom */
-  /* bypass control */
+       priority_flow_ctrl_set_t   priority_flow_ctrl_set; /**< Setup priority flow control. */
+
+       eth_uc_hash_table_set_t    uc_hash_table_set; /**< Set Unicast Table Array. */
+       eth_uc_all_hash_table_set_t uc_all_hash_table_set; /**< Set Unicast hash bitmap. */
+
+       eth_mirror_rule_set_t      mirror_rule_set; /**< Add a traffic mirror rule. */
+       eth_mirror_rule_reset_t    mirror_rule_reset; /**< reset a traffic mirror rule. */
+
+       eth_set_vf_rx_mode_t       set_vf_rx_mode;/**< Set VF RX mode. */
+       eth_set_vf_rx_t            set_vf_rx;     /**< enable/disable a VF receive. */
+       eth_set_vf_tx_t            set_vf_tx;     /**< enable/disable a VF transmit. */
+       eth_set_vf_vlan_filter_t   set_vf_vlan_filter; /**< Set VF VLAN filter. */
+       eth_set_vf_rate_limit_t    set_vf_rate_limit; /**< Set VF rate limit. */
+
+       eth_udp_tunnel_port_add_t  udp_tunnel_port_add; /** Add UDP tunnel port. */
+       eth_udp_tunnel_port_del_t  udp_tunnel_port_del; /** Del UDP tunnel port. */
+       eth_l2_tunnel_eth_type_conf_t l2_tunnel_eth_type_conf;
+       /** Config ether type of l2 tunnel. */
+       eth_l2_tunnel_offload_set_t   l2_tunnel_offload_set;
+       /** Enable/disable l2 tunnel offload functions. */
+
+       eth_set_queue_rate_limit_t set_queue_rate_limit; /**< Set queue rate limit. */
+
+       rss_hash_update_t          rss_hash_update; /** Configure RSS hash protocols. */
+       rss_hash_conf_get_t        rss_hash_conf_get; /** Get current RSS hash configuration. */
+       reta_update_t              reta_update;   /** Update redirection table. */
+       reta_query_t               reta_query;    /** Query redirection table. */
+
+       eth_get_reg_t              get_reg;           /**< Get registers. */
+       eth_get_eeprom_length_t    get_eeprom_length; /**< Get eeprom length. */
+       eth_get_eeprom_t           get_eeprom;        /**< Get eeprom data. */
+       eth_set_eeprom_t           set_eeprom;        /**< Set eeprom. */
+
+       /* bypass control */
 #ifdef RTE_NIC_BYPASS
-  bypass_init_t bypass_init;
-  bypass_state_set_t bypass_state_set;
-  bypass_state_show_t bypass_state_show;
-  bypass_event_set_t bypass_event_set;
-  bypass_event_show_t bypass_event_show;
-  bypass_wd_timeout_set_t bypass_wd_timeout_set;
-  bypass_wd_timeout_show_t bypass_wd_timeout_show;
-  bypass_ver_show_t bypass_ver_show;
-  bypass_wd_reset_t bypass_wd_reset;
+       bypass_init_t              bypass_init;
+       bypass_state_set_t         bypass_state_set;
+       bypass_state_show_t        bypass_state_show;
+       bypass_event_set_t         bypass_event_set;
+       bypass_event_show_t        bypass_event_show;
+       bypass_wd_timeout_set_t    bypass_wd_timeout_set;
+       bypass_wd_timeout_show_t   bypass_wd_timeout_show;
+       bypass_ver_show_t          bypass_ver_show;
+       bypass_wd_reset_t          bypass_wd_reset;
 #endif
 
-       /** Configure RSS hash protocols. */
-       rss_hash_update_t rss_hash_update;
-       /** Get current RSS hash configuration. */
-       rss_hash_conf_get_t rss_hash_conf_get;
-       eth_filter_ctrl_t              filter_ctrl;
-       /**< common filter control. */
-       eth_set_mc_addr_list_t set_mc_addr_list; /**< set list of mcast addrs */
-       eth_rxq_info_get_t rxq_info_get;
-       /**< retrieve RX queue information. */
-       eth_txq_info_get_t txq_info_get;
-       /**< retrieve TX queue information. */
+       eth_filter_ctrl_t          filter_ctrl; /**< common filter control. */
+
+       eth_get_dcb_info           get_dcb_info; /** Get DCB information. */
+
+       eth_timesync_enable_t      timesync_enable;
        /** Turn IEEE1588/802.1AS timestamping on. */
-       eth_timesync_enable_t timesync_enable;
+       eth_timesync_disable_t     timesync_disable;
        /** Turn IEEE1588/802.1AS timestamping off. */
-       eth_timesync_disable_t timesync_disable;
-       /** Read the IEEE1588/802.1AS RX timestamp. */
        eth_timesync_read_rx_timestamp_t timesync_read_rx_timestamp;
-       /** Read the IEEE1588/802.1AS TX timestamp. */
+       /** Read the IEEE1588/802.1AS RX timestamp. */
        eth_timesync_read_tx_timestamp_t timesync_read_tx_timestamp;
-
-       /** Get DCB information */
-       eth_get_dcb_info get_dcb_info;
-       /** Adjust the device clock.*/
-       eth_timesync_adjust_time timesync_adjust_time;
-       /** Get the device clock time. */
-       eth_timesync_read_time timesync_read_time;
-       /** Set the device clock time. */
-       eth_timesync_write_time timesync_write_time;
-       /** Config ether type of l2 tunnel */
-       eth_l2_tunnel_eth_type_conf_t l2_tunnel_eth_type_conf;
-       /** Enable/disable l2 tunnel offload functions */
-       eth_l2_tunnel_offload_set_t l2_tunnel_offload_set;
+       /** Read the IEEE1588/802.1AS TX timestamp. */
+       eth_timesync_adjust_time   timesync_adjust_time; /** Adjust the device clock. */
+       eth_timesync_read_time     timesync_read_time; /** Get the device clock time. */
+       eth_timesync_write_time    timesync_write_time; /** Set the device clock time. */
 };
 
 /**
@@ -1622,10 +1653,12 @@ struct rte_eth_rxtx_callback {
 struct rte_eth_dev {
        eth_rx_burst_t rx_pkt_burst; /**< Pointer to PMD receive function. */
        eth_tx_burst_t tx_pkt_burst; /**< Pointer to PMD transmit function. */
+       eth_tx_prep_t tx_pkt_prepare; /**< Pointer to PMD transmit prepare function. */
        struct rte_eth_dev_data *data;  /**< Pointer to device data */
        const struct eth_driver *driver;/**< Driver for this device */
        const struct eth_dev_ops *dev_ops; /**< Functions exported by PMD */
-       struct rte_pci_device *pci_dev; /**< PCI info. supplied by probing */
+       struct rte_device *device; /**< Backing device */
+       struct rte_intr_handle *intr_handle; /**< Device interrupt handle */
        /** User application callbacks for NIC interrupts */
        struct rte_eth_dev_cb_list link_intr_cbs;
        /**
@@ -1771,7 +1804,7 @@ int rte_eth_dev_release_port(struct rte_eth_dev *eth_dev);
  * @param devargs
  *  A pointer to a strings array describing the new device
  *  to be attached. The strings should be a pci address like
- *  '0000:01:00.0' or virtual device name like 'eth_pcap0'.
+ *  '0000:01:00.0' or virtual device name like 'net_pcap0'.
  * @param port_id
  *  A pointer to a port identifier actually attached.
  * @return
@@ -1910,6 +1943,19 @@ uint32_t rte_eth_speed_bitflag(uint32_t speed, int duplex);
 int rte_eth_dev_configure(uint8_t port_id, uint16_t nb_rx_queue,
                uint16_t nb_tx_queue, const struct rte_eth_conf *eth_conf);
 
+/**
+ * @internal
+ * Release device queues and clear its configuration to force the user
+ * application to reconfigure it. It is for internal use only.
+ *
+ * @param dev
+ *  Pointer to struct rte_eth_dev.
+ *
+ * @return
+ *  void
+ */
+void _rte_eth_dev_reset(struct rte_eth_dev *dev);
+
 /**
  * Allocate and set up a receive queue for an Ethernet device.
  *
@@ -2269,18 +2315,19 @@ void rte_eth_stats_reset(uint8_t port_id);
  * @param port_id
  *   The port identifier of the Ethernet device.
  * @param xstats_names
- *  Block of memory to insert names into. Must be at least size in capacity.
- *  If set to NULL, function returns required capacity.
+ *   An rte_eth_xstat_name array of at least *size* elements to
+ *   be filled. If set to NULL, the function returns the required number
+ *   of elements.
  * @param size
- *  Capacity of xstats_names (number of names).
+ *   The size of the xstats_names array (number of elements).
  * @return
- *   - positive value lower or equal to size: success. The return value
+ *   - positive value lower or equal to size: success. The return value
  *     is the number of entries filled in the stats table.
- *   - positive value higher than size: error, the given statistics table
+ *   - positive value higher than size: error, the given statistics table
  *     is too small. The return value corresponds to the size that should
  *     be given to succeed. The entries in the table are not valid and
  *     shall not be used by the caller.
- *   - negative value on error (invalid port id)
+ *   - A negative value on error (invalid port id).
  */
 int rte_eth_xstats_get_names(uint8_t port_id,
                struct rte_eth_xstat_name *xstats_names,
@@ -2293,19 +2340,20 @@ int rte_eth_xstats_get_names(uint8_t port_id,
  *   The port identifier of the Ethernet device.
  * @param xstats
  *   A pointer to a table of structure of type *rte_eth_xstat*
- *   to be filled with device statistics ids and values.
+ *   to be filled with device statistics ids and values: id is the
+ *   index of the name string in xstats_names (see rte_eth_xstats_get_names()),
+ *   and value is the statistic counter.
  *   This parameter can be set to NULL if n is 0.
  * @param n
- *   The size of the stats table, which should be large enough to store
- *   all the statistics of the device.
+ *   The size of the xstats array (number of elements).
  * @return
- *   - positive value lower or equal to n: success. The return value
+ *   - positive value lower or equal to n: success. The return value
  *     is the number of entries filled in the stats table.
- *   - positive value higher than n: error, the given statistics table
+ *   - positive value higher than n: error, the given statistics table
  *     is too small. The return value corresponds to the size that should
  *     be given to succeed. The entries in the table are not valid and
  *     shall not be used by the caller.
- *   - negative value on error (invalid port id)
+ *   - A negative value on error (invalid port id).
  */
 int rte_eth_xstats_get(uint8_t port_id, struct rte_eth_xstat *xstats,
                unsigned n);
@@ -2816,6 +2864,115 @@ rte_eth_tx_burst(uint8_t port_id, uint16_t queue_id,
        return (*dev->tx_pkt_burst)(dev->data->tx_queues[queue_id], tx_pkts, nb_pkts);
 }
 
+/**
+ * @warning
+ * @b EXPERIMENTAL: this API may change without prior notice
+ *
+ * Process a burst of output packets on a transmit queue of an Ethernet device.
+ *
+ * The rte_eth_tx_prepare() function is invoked to prepare output packets to be
+ * transmitted on the output queue *queue_id* of the Ethernet device designated
+ * by its *port_id*.
+ * The *nb_pkts* parameter is the number of packets to be prepared which are
+ * supplied in the *tx_pkts* array of *rte_mbuf* structures, each of them
+ * allocated from a pool created with rte_pktmbuf_pool_create().
+ * For each packet to send, the rte_eth_tx_prepare() function performs
+ * the following operations:
+ *
+ * - Check if packet meets devices requirements for tx offloads.
+ *
+ * - Check limitations about number of segments.
+ *
+ * - Check additional requirements when debug is enabled.
+ *
+ * - Update and/or reset required checksums when tx offload is set for packet.
+ *
+ * Since this function can modify packet data, provided mbufs must be safely
+ * writable (e.g. modified data cannot be in shared segment).
+ *
+ * The rte_eth_tx_prepare() function returns the number of packets ready to be
+ * sent. A return value equal to *nb_pkts* means that all packets are valid and
+ * ready to be sent, otherwise stops processing on the first invalid packet and
+ * leaves the rest packets untouched.
+ *
+ * When this functionality is not implemented in the driver, all packets are
+ * are returned untouched.
+ *
+ * @param port_id
+ *   The port identifier of the Ethernet device.
+ *   The value must be a valid port id.
+ * @param queue_id
+ *   The index of the transmit queue through which output packets must be
+ *   sent.
+ *   The value must be in the range [0, nb_tx_queue - 1] previously supplied
+ *   to rte_eth_dev_configure().
+ * @param tx_pkts
+ *   The address of an array of *nb_pkts* pointers to *rte_mbuf* structures
+ *   which contain the output packets.
+ * @param nb_pkts
+ *   The maximum number of packets to process.
+ * @return
+ *   The number of packets correct and ready to be sent. The return value can be
+ *   less than the value of the *tx_pkts* parameter when some packet doesn't
+ *   meet devices requirements with rte_errno set appropriately:
+ *   - -EINVAL: offload flags are not correctly set
+ *   - -ENOTSUP: the offload feature is not supported by the hardware
+ *
+ */
+
+#ifndef RTE_ETHDEV_TX_PREPARE_NOOP
+
+static inline uint16_t
+rte_eth_tx_prepare(uint8_t port_id, uint16_t queue_id,
+               struct rte_mbuf **tx_pkts, uint16_t nb_pkts)
+{
+       struct rte_eth_dev *dev;
+
+#ifdef RTE_LIBRTE_ETHDEV_DEBUG
+       if (!rte_eth_dev_is_valid_port(port_id)) {
+               RTE_PMD_DEBUG_TRACE("Invalid TX port_id=%d\n", port_id);
+               rte_errno = -EINVAL;
+               return 0;
+       }
+#endif
+
+       dev = &rte_eth_devices[port_id];
+
+#ifdef RTE_LIBRTE_ETHDEV_DEBUG
+       if (queue_id >= dev->data->nb_tx_queues) {
+               RTE_PMD_DEBUG_TRACE("Invalid TX queue_id=%d\n", queue_id);
+               rte_errno = -EINVAL;
+               return 0;
+       }
+#endif
+
+       if (!dev->tx_pkt_prepare)
+               return nb_pkts;
+
+       return (*dev->tx_pkt_prepare)(dev->data->tx_queues[queue_id],
+                       tx_pkts, nb_pkts);
+}
+
+#else
+
+/*
+ * Native NOOP operation for compilation targets which doesn't require any
+ * preparations steps, and functional NOOP may introduce unnecessary performance
+ * drop.
+ *
+ * Generally this is not a good idea to turn it on globally and didn't should
+ * be used if behavior of tx_preparation can change.
+ */
+
+static inline uint16_t
+rte_eth_tx_prepare(__rte_unused uint8_t port_id, __rte_unused uint16_t queue_id,
+               __rte_unused struct rte_mbuf **tx_pkts, uint16_t nb_pkts)
+{
+       return nb_pkts;
+}
+
+#endif
+
 typedef void (*buffer_tx_error_fn)(struct rte_mbuf **unsent, uint16_t count,
                void *userdata);
 
@@ -3030,6 +3187,7 @@ enum rte_eth_event_type {
                                /**< queue state event (enabled/disabled) */
        RTE_ETH_EVENT_INTR_RESET,
                        /**< reset interrupt event, sent to VF on PF reset */
+       RTE_ETH_EVENT_VF_MBOX,  /**< message from the VF received by PF */
        RTE_ETH_EVENT_MAX       /**< max value of this enum */
 };
 
@@ -3051,6 +3209,11 @@ typedef void (*rte_eth_dev_cb_fn)(uint8_t port_id, \
  * @param cb_arg
  *  Pointer to the parameters for the registered callback.
  *
+ *  The user data is overwritten in the case of RTE_ETH_EVENT_VF_MBOX.
+ *     This even occurs when a message from the VF is received by the PF.
+ *     The user data is overwritten with struct rte_pmd_ixgbe_mb_event_param.
+ *     This struct is defined in rte_pmd_ixgbe.h.
+ *
  * @return
  *  - On success, zero.
  *  - On failure, a negative value.
@@ -3089,12 +3252,16 @@ int rte_eth_dev_callback_unregister(uint8_t port_id,
  *  Pointer to struct rte_eth_dev.
  * @param event
  *  Eth device interrupt event type.
+ * @param cb_arg
+ *  Update callback parameter to pass data back to user application.
+ *  This allows the user application to decide if a particular function
+ *  is permitted or not.
  *
  * @return
  *  void
  */
 void _rte_eth_dev_callback_process(struct rte_eth_dev *dev,
-                               enum rte_eth_event_type event);
+                               enum rte_eth_event_type event, void *cb_arg);
 
 /**
  * When there is no rx packet coming in Rx Queue for a long time, we can
@@ -4324,7 +4491,7 @@ rte_eth_dev_l2_tunnel_offload_set(uint8_t port_id,
 
 /**
 * Get the port id from pci adrress or device name
-* Ex: 0000:2:00.0 or vdev name eth_pcap0
+* Ex: 0000:2:00.0 or vdev name net_pcap0
 *
 * @param name
 *  pci address or name of the device