#include <stdio.h>
#include <sys/queue.h>
#include <rte_config.h>
#include <rte_compat.h>
#include <rte_log.h>

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_dev_is_probed (const struct rte_device *dev)
int	rte_eal_hotplug_add (const char busname, const char devname, const char *drvargs)
int	rte_dev_probe (const char *devargs)
int	rte_eal_hotplug_remove (const char busname, const char devname)
int	rte_dev_remove (struct rte_device *dev)
__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)
void __rte_experimental	rte_dev_event_callback_process (const char *device_name, enum rte_dev_event_type event)
int __rte_experimental	rte_dev_event_monitor_start (void)
int __rte_experimental	rte_dev_event_monitor_stop (void)
int __rte_experimental	rte_dev_hotplug_handle_enable (void)
int __rte_experimental	rte_dev_hotplug_handle_disable (void)
int __rte_experimental	rte_dev_dma_map (struct rte_device dev, void addr, uint64_t iova, size_t len)
int __rte_experimental	rte_dev_dma_unmap (struct rte_device dev, void addr, uint64_t iova, size_t len)

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 241 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

dev	Device handle.
data	Data 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 202 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

start	Starting iteration context.
devstr	Device description string.
it	Device iterator.

Returns: The address of the current element matching the device description string.

Definition at line 288 of file rte_dev.h.

Enumeration Type Documentation

enum rte_dev_event_type

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.

enum rte_kernel_driver

Device driver.

Definition at line 60 of file rte_dev.h.

enum rte_dev_policy

Device policies.

Definition at line 72 of file rte_dev.h.

Function Documentation

int rte_dev_is_probed ( const struct rte_device * dev )

Query status of a device.

Parameters

dev	Generic device pointer.

Returns: (int)true if already probed successfully, 0 otherwise.

int rte_eal_hotplug_add	(	const char *	busname,
		const char *	devname,
		const char *	drvargs
	)

Hotplug add a given device to a specific bus.

In multi-process, it will request other processes to add the same device. A failure, in any process, will rollback the action

Parameters

busname	The bus name the device is added to.
devname	The device name. Based on this device name, eal will identify a driver capable of handling it and pass it to the driver probing function.
drvargs	Device arguments to be passed to the driver.

Returns: 0 on success, negative on error.

Examples:: examples/multi_process/hotplug_mp/commands.c.

int rte_dev_probe ( const char * devargs )

Add matching devices.

In multi-process, it will request other processes to add the same device. A failure, in any process, will rollback the action

Parameters

devargs Device arguments including bus, class and driver properties.

Returns: 0 on success, negative on error.

int rte_eal_hotplug_remove	(	const char *	busname,
		const char *	devname
	)

Hotplug remove a given device from a specific bus.

In multi-process, it will request other processes to remove the same device. A failure, in any process, will rollback the action

Parameters

busname	The bus name the device is removed from.
devname	The device name being removed.

Returns: 0 on success, negative on error.

Examples:: examples/multi_process/hotplug_mp/commands.c.

int rte_dev_remove ( struct rte_device * dev )

Remove one device.

In multi-process, it will request other processes to remove the same device. A failure, in any process, will rollback the action

Parameters

dev	Data structure of the device to remove.

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

it	Device iterator handle.
str	Device 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

it	Device 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_name	The device name, that is the param name of the struct rte_device, null value means for all devices.
cb_fn	callback address.
cb_arg	address 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_name	The device name, that is the param name of the struct rte_device, null value means for all devices and their callbacks.
cb_fn	callback address.
cb_arg	address 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.

void __rte_experimental rte_dev_event_callback_process	(	const char *	device_name,
		enum rte_dev_event_type	event
	)

Warning: EXPERIMENTAL: this API may change without prior notice

Executes all the user application registered callbacks for the specific device.

Parameters

device_name	The device name.
event	the device event type.

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.

int __rte_experimental rte_dev_hotplug_handle_enable ( void )

Warning: EXPERIMENTAL: this API may change without prior notice

Enable hotplug handling for devices.

Returns

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

int __rte_experimental rte_dev_hotplug_handle_disable ( void )

Warning: EXPERIMENTAL: this API may change without prior notice

Disable hotplug handling for devices.

Returns

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

int __rte_experimental rte_dev_dma_map	(	struct rte_device *	dev,
		void *	addr,
		uint64_t	iova,
		size_t	len
	)

Device level DMA map function. After a successful call, the memory segment will be mapped to the given device.

Note: : Memory must be registered in advance using rte_extmem_* APIs.

Parameters

dev	Device pointer.
addr	Virtual address to map.
iova	IOVA address to map.
len	Length of the memory segment being mapped.

Returns: 0 if mapping was successful. Negative value and rte_errno is set otherwise.

int __rte_experimental rte_dev_dma_unmap	(	struct rte_device *	dev,
		void *	addr,
		uint64_t	iova,
		size_t	len
	)

Device level DMA unmap function. After a successful call, the memory segment will no longer be accessible by the given device.

Note: : Memory must be registered in advance using rte_extmem_* APIs.

Parameters

dev	Device pointer.
addr	Virtual address to unmap.
iova	IOVA address to unmap.
len	Length of the memory segment being mapped.

Returns: 0 if un-mapping was successful. Negative value and rte_errno is set otherwise.

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)

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation