lib/librte_ethdev/rte_ethdev_vdev.h

   1 /*-
   2  *   BSD LICENSE
   3  *
   4  *   Copyright(c) 2017 Brocade Communications Systems, Inc.
   5  *   Author: Jan Blunck <jblunck@infradead.org>
   6  *
   7  *   Redistribution and use in source and binary forms, with or without
   8  *   modification, are permitted provided that the following conditions
   9  *   are met:
  10  *
  11  *     * Redistributions of source code must retain the above copyright
  12  *       notice, this list of conditions and the following disclaimer.
  13  *     * Redistributions in binary form must reproduce the above copyright
  14  *       notice, this list of conditions and the following disclaimer in
  15  *       the documentation and/or other materials provided with the
  16  *       distribution.
  17  *     * Neither the name of the copyright holder nor the names of its
  18  *       contributors may be used to endorse or promote products derived
  19  *       from this software without specific prior written permission.
  20  *
  21  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  24  *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  25  *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  26  *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  27  *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28  *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29  *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30  *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32  */
  33
  34 #ifndef _RTE_ETHDEV_VDEV_H_
  35 #define _RTE_ETHDEV_VDEV_H_
  36
  37 #include <rte_config.h>
  38 #include <rte_malloc.h>
  39 #include <rte_bus_vdev.h>
  40 #include <rte_ethdev_driver.h>
  41
  42 /**
  43  * @internal
  44  * Allocates a new ethdev slot for an ethernet device and returns the pointer
  45  * to that slot for the driver to use.
  46  *
  47  * @param dev
  48  *      Pointer to virtual device
  49  *
  50  * @param private_data_size
  51  *      Size of private data structure
  52  *
  53  * @return
  54  *      A pointer to a rte_eth_dev or NULL if allocation failed.
  55  */
  56 static inline struct rte_eth_dev *
  57 rte_eth_vdev_allocate(struct rte_vdev_device *dev, size_t private_data_size)
  58 {
  59         struct rte_eth_dev *eth_dev;
  60         const char *name = rte_vdev_device_name(dev);
  61
  62         eth_dev = rte_eth_dev_allocate(name);
  63         if (!eth_dev)
  64                 return NULL;
  65
  66         if (private_data_size) {
  67                 eth_dev->data->dev_private = rte_zmalloc_socket(name,
  68                         private_data_size, RTE_CACHE_LINE_SIZE,
  69                         dev->device.numa_node);
  70                 if (!eth_dev->data->dev_private) {
  71                         rte_eth_dev_release_port(eth_dev);
  72                         return NULL;
  73                 }
  74         }
  75
  76         eth_dev->device = &dev->device;
  77         eth_dev->intr_handle = NULL;
  78
  79         eth_dev->data->kdrv = RTE_KDRV_NONE;
  80         eth_dev->data->numa_node = dev->device.numa_node;
  81         return eth_dev;
  82 }
  83
  84 #endif /* _RTE_ETHDEV_VDEV_H_ */