DPDK: Data Plane Development Kit

18.08.0-rc1
rte_dev.h File Reference
#include <stdio.h>
#include <sys/queue.h>
#include <rte_config.h>
#include <rte_compat.h>
#include <rte_log.h>

Go to the source code of this file.

Data Structures

struct  rte_mem_resource
struct  rte_driver
struct  rte_device
struct  rte_dev_iterator

Macros

#define RTE_PMD_REGISTER_KMOD_DEP(name, str)

Typedefs

typedef int(* rte_dev_cmp_t )(const struct rte_device *dev, const void *data)
typedef void *(* rte_dev_iterate_t )(const void *start, const char *devstr, const struct rte_dev_iterator *it)

Enumerations

enum  rte_dev_event_type { RTE_DEV_EVENT_ADD, RTE_DEV_EVENT_REMOVE, RTE_DEV_EVENT_MAX }
enum  rte_kernel_driver
enum  rte_dev_policy

Functions

int rte_eal_dev_attach (const char *name, const char *devargs)
int rte_eal_dev_detach (struct rte_device *dev)
int __rte_experimental rte_eal_hotplug_add (const char *busname, const char *devname, const char *devargs)
int __rte_experimental rte_eal_hotplug_remove (const char *busname, const char *devname)
__rte_experimental int rte_dev_iterator_init (struct rte_dev_iterator *it, const char *str)
__rte_experimental struct
rte_device
rte_dev_iterator_next (struct rte_dev_iterator *it)
int __rte_experimental rte_dev_event_callback_register (const char *device_name, rte_dev_event_cb_fn cb_fn, void *cb_arg)
int __rte_experimental rte_dev_event_callback_unregister (const char *device_name, rte_dev_event_cb_fn cb_fn, void *cb_arg)
int __rte_experimental rte_dev_event_monitor_start (void)
int __rte_experimental rte_dev_event_monitor_stop (void)

Detailed Description

RTE PMD Driver Registration Interface

This file manages the list of device drivers.

Definition in file rte_dev.h.

Macro Definition Documentation

#define RTE_PMD_REGISTER_KMOD_DEP (   name,
  str 
)
Value:
static const char DRV_EXP_TAG(name, kmod_dep_export)[] \
__attribute__((used)) = str

Advertise the list of kernel modules required to run this driver

This string lists the kernel modules required for the devices associated to a PMD. The format of each line of the string is: "<device-pattern> <kmod-expression>".

The possible formats for the device pattern are: "*" all devices supported by this driver "pci:*" all PCI devices supported by this driver "pci:v8086:d*:sv*:sd*" all PCI devices supported by this driver whose vendor id is 0x8086.

The format of the kernel modules list is a parenthesed expression containing logical-and (&) and logical-or (|).

The device pattern and the kmod expression are separated by a space.

Example:

  • "* igb_uio | uio_pci_generic | vfio"

Definition at line 282 of file rte_dev.h.

Typedef Documentation

typedef int(* rte_dev_cmp_t)(const struct rte_device *dev, const void *data)

Device comparison function.

This type of function is used to compare an rte_device with arbitrary data.

Parameters
devDevice handle.
dataData to compare against. The type of this parameter is determined by the kind of comparison performed by the function.
Returns
0 if the device matches the data. !0 if the device does not match. <0 if ordering is possible and the device is lower than the data. >0 if ordering is possible and the device is greater than the data.

Definition at line 243 of file rte_dev.h.

typedef void*(* rte_dev_iterate_t)(const void *start, const char *devstr, const struct rte_dev_iterator *it)

Device iteration function.

Find the next device matching properties passed in parameters. The function takes an additional start parameter, that is used as starting context when relevant.

The function returns the current element in the iteration. This return value will potentially be used as a start parameter in subsequent calls to the function.

The additional iterator parameter is only there if a specific implementation needs additional context. It must not be modified by the iteration function itself.

Parameters
startStarting iteration context.
devstrDevice description string.
itDevice iterator.
Returns
The address of the current element matching the device description string.

Definition at line 329 of file rte_dev.h.

Enumeration Type Documentation

The device event type.

Enumerator:
RTE_DEV_EVENT_ADD 

device being added

RTE_DEV_EVENT_REMOVE 

device being removed

RTE_DEV_EVENT_MAX 

max value of this enum

Definition at line 30 of file rte_dev.h.

Device driver.

Definition at line 112 of file rte_dev.h.

Device policies.

Definition at line 124 of file rte_dev.h.

Function Documentation

int rte_eal_dev_attach ( const char *  name,
const char *  devargs 
)

Attach a device to a registered driver.

Parameters
nameThe device name, that refers to a pci device (or some private way of designating a vdev device). Based on this device name, eal will identify a driver capable of handling it and pass it to the driver probing function.
devargsDevice arguments to be passed to the driver.
Returns
0 on success, negative on error.
int rte_eal_dev_detach ( struct rte_device dev)

Detach a device from its driver.

Parameters
devA pointer to a rte_device structure.
Returns
0 on success, negative on error.
int __rte_experimental rte_eal_hotplug_add ( const char *  busname,
const char *  devname,
const char *  devargs 
)
Warning
EXPERIMENTAL: this API may change without prior notice

Hotplug add a given device to a specific bus.

Parameters
busnameThe bus name the device is added to.
devnameThe device name. Based on this device name, eal will identify a driver capable of handling it and pass it to the driver probing function.
devargsDevice arguments to be passed to the driver.
Returns
0 on success, negative on error.
int __rte_experimental rte_eal_hotplug_remove ( const char *  busname,
const char *  devname 
)
Warning
EXPERIMENTAL: this API may change without prior notice

Hotplug remove a given device from a specific bus.

Parameters
busnameThe bus name the device is removed from.
devnameThe device name being removed.
Returns
0 on success, negative on error.
__rte_experimental int rte_dev_iterator_init ( struct rte_dev_iterator it,
const char *  str 
)

Initializes a device iterator.

This iterator allows accessing a list of devices matching a criteria. The device matching is made among all buses and classes currently registered, filtered by the device description given as parameter.

This function will not allocate any memory. It is safe to stop the iteration at any moment and let the iterator go out of context.

Parameters
itDevice iterator handle.
strDevice description string.
Returns
0 on successful initialization. <0 on error.
__rte_experimental struct rte_device* rte_dev_iterator_next ( struct rte_dev_iterator it)
read

Iterates on a device iterator.

Generates a new rte_device handle corresponding to the next element in the list described in comprehension by the iterator.

The next object is returned, and the iterator is updated.

Parameters
itDevice iterator handle.
Returns
An rte_device handle if found. NULL if an error occurred (rte_errno is set). NULL if no device could be found (rte_errno is not set).
int __rte_experimental rte_dev_event_callback_register ( const char *  device_name,
rte_dev_event_cb_fn  cb_fn,
void *  cb_arg 
)
Warning
EXPERIMENTAL: this API may change without prior notice

It registers the callback for the specific device. Multiple callbacks cal be registered at the same time.

Parameters
device_nameThe device name, that is the param name of the struct rte_device, null value means for all devices.
cb_fncallback address.
cb_argaddress of parameter for callback.
Returns
  • On success, zero.
  • On failure, a negative value.
int __rte_experimental rte_dev_event_callback_unregister ( const char *  device_name,
rte_dev_event_cb_fn  cb_fn,
void *  cb_arg 
)
Warning
EXPERIMENTAL: this API may change without prior notice

It unregisters the callback according to the specified device.

Parameters
device_nameThe device name, that is the param name of the struct rte_device, null value means for all devices and their callbacks.
cb_fncallback address.
cb_argaddress of parameter for callback, (void *)-1 means to remove all registered which has the same callback address.
Returns
  • On success, return the number of callback entities removed.
  • On failure, a negative value.
int __rte_experimental rte_dev_event_monitor_start ( void  )
Warning
EXPERIMENTAL: this API may change without prior notice

Start the device event monitoring.

Returns
  • On success, zero.
  • On failure, a negative value.
int __rte_experimental rte_dev_event_monitor_stop ( void  )
Warning
EXPERIMENTAL: this API may change without prior notice

Stop the device event monitoring.

Returns
  • On success, zero.
  • On failure, a negative value.