rte_devargs.h File Reference

#include <stdio.h>
#include <sys/queue.h>
#include <rte_pci.h>

Data Structures
struct	rte_devargs

Enumerations
enum	rte_devtype

Functions
	TAILQ_HEAD (rte_devargs_list, rte_devargs)
int	rte_eal_parse_devargs_str (const char *devargs_str, char **drvname, char **drvargs)
int	rte_eal_devargs_add (enum rte_devtype devtype, const char *devargs_str)
unsigned int	rte_eal_devargs_type_count (enum rte_devtype devtype)
void	rte_eal_devargs_dump (FILE *f)

Variables
struct rte_devargs_list	devargs_list

Detailed Description

RTE devargs: list of devices and their user arguments

This file stores a list of devices and their arguments given by the user when a DPDK application is started. These devices can be PCI devices or virtual devices. These devices are stored at startup in a list of rte_devargs structures.

Enumeration Type Documentation

enum rte_devtype

Type of generic device

Function Documentation

int rte_eal_devargs_add	(	enum rte_devtype	devtype,
		const char *	devargs_str
	)

Add a device to the user device list

For PCI devices, the format of arguments string is "PCI_ADDR" or "PCI_ADDR,key=val,key2=val2,...". Examples: "08:00.1", "0000:5:00.0", "04:00.0,arg=val".

For virtual devices, the format of arguments string is "DRIVER_NAME*" or "DRIVER_NAME*,key=val,key2=val2,...". Examples: "eth_ring", "eth_ring0", "eth_pmdAnything,arg=0:arg2=1". The validity of the driver name is not checked by this function, it is done when probing the drivers.

Parameters

devtype	The type of the device.
devargs_list	The arguments as given by the user.

Returns

• 0 on success
• A negative value on error

void rte_eal_devargs_dump

(

FILE *

f

)

This function dumps the list of user device and their arguments.

Parameters

f	A pointer to a file for output

unsigned int rte_eal_devargs_type_count

(

enum rte_devtype

devtype

)

Count the number of user devices of a specified type

Parameters

devtype

The type of the devices to counted.

Returns

The number of devices.

int rte_eal_parse_devargs_str	(	const char *	devargs_str,
		char **	drvname,
		char **	drvargs
	)

Parse a devargs string.

For PCI devices, the format of arguments string is "PCI_ADDR" or "PCI_ADDR,key=val,key2=val2,...". Examples: "08:00.1", "0000:5:00.0", "04:00.0,arg=val".

For virtual devices, the format of arguments string is "DRIVER_NAME*" or "DRIVER_NAME*,key=val,key2=val2,...". Examples: "eth_ring", "eth_ring0", "eth_pmdAnything,arg=0:arg2=1".

The function parses the arguments string to get driver name and driver arguments.

Parameters

devargs_str	The arguments as given by the user.
drvname	The pointer to the string to store parsed driver name.
drvargs	The pointer to the string to store parsed driver arguments.

Returns

• 0 on success
• A negative value on error

TAILQ_HEAD	(	rte_devargs_list	,
		rte_devargs
	)

user device double-linked queue type definition

Variable Documentation

struct rte_devargs_list devargs_list

Global list of user devices