1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright 2014 6WIND S.A.
5 /* This file manages the list of devices and their arguments, as given
6 * by the user at startup
8 * Code here should not call rte_log since the EAL environment
9 * may not be initialized.
15 #include <rte_compat.h>
17 #include <rte_devargs.h>
18 #include <rte_tailq.h>
19 #include "eal_private.h"
21 /** user device double-linked queue type definition */
22 TAILQ_HEAD(rte_devargs_list, rte_devargs);
24 /** Global list of user devices */
25 struct rte_devargs_list devargs_list =
26 TAILQ_HEAD_INITIALIZER(devargs_list);
29 rte_eal_parse_devargs_str(const char *devargs_str,
30 char **drvname, char **drvargs)
34 if ((devargs_str) == NULL || (drvname) == NULL || (drvargs == NULL))
37 *drvname = strdup(devargs_str);
41 /* set the first ',' to '\0' to split name and arguments */
42 sep = strchr(*drvname, ',');
45 *drvargs = strdup(sep + 1);
47 *drvargs = strdup("");
50 if (*drvargs == NULL) {
59 bus_name_cmp(const struct rte_bus *bus, const void *name)
61 return strncmp(bus->name, name, strlen(bus->name));
64 int __rte_experimental
65 rte_eal_devargs_parse(const char *dev, struct rte_devargs *da)
67 struct rte_bus *bus = NULL;
69 const size_t maxlen = sizeof(da->name);
72 if (dev == NULL || da == NULL)
74 /* Retrieve eventual bus info */
77 bus = rte_bus_find(bus, bus_name_cmp, dev);
80 devname = dev + strlen(bus->name) + 1;
81 if (rte_bus_find_by_device_name(devname) == bus)
84 /* Store device name */
86 while (devname[i] != '\0' && devname[i] != ',') {
87 da->name[i] = devname[i];
90 fprintf(stderr, "WARNING: Parsing \"%s\": device name should be shorter than %zu\n",
92 da->name[i - 1] = '\0';
98 bus = rte_bus_find_by_device_name(da->name);
100 fprintf(stderr, "ERROR: failed to parse device \"%s\"\n",
106 /* Parse eventual device arguments */
107 if (devname[i] == ',')
108 da->args = strdup(&devname[i + 1]);
110 da->args = strdup("");
111 if (da->args == NULL) {
112 fprintf(stderr, "ERROR: not enough memory to parse arguments\n");
118 int __rte_experimental
119 rte_eal_devargs_insert(struct rte_devargs *da)
123 ret = rte_eal_devargs_remove(da->bus->name, da->name);
126 TAILQ_INSERT_TAIL(&devargs_list, da, next);
130 /* store a whitelist parameter for later parsing */
132 rte_eal_devargs_add(enum rte_devtype devtype, const char *devargs_str)
134 struct rte_devargs *devargs = NULL;
135 struct rte_bus *bus = NULL;
136 const char *dev = devargs_str;
138 /* use calloc instead of rte_zmalloc as it's called early at init */
139 devargs = calloc(1, sizeof(*devargs));
143 if (rte_eal_devargs_parse(dev, devargs))
145 devargs->type = devtype;
147 if (devargs->type == RTE_DEVTYPE_BLACKLISTED_PCI)
148 devargs->policy = RTE_DEV_BLACKLISTED;
149 if (bus->conf.scan_mode == RTE_BUS_SCAN_UNDEFINED) {
150 if (devargs->policy == RTE_DEV_WHITELISTED)
151 bus->conf.scan_mode = RTE_BUS_SCAN_WHITELIST;
152 else if (devargs->policy == RTE_DEV_BLACKLISTED)
153 bus->conf.scan_mode = RTE_BUS_SCAN_BLACKLIST;
155 TAILQ_INSERT_TAIL(&devargs_list, devargs, next);
167 int __rte_experimental
168 rte_eal_devargs_remove(const char *busname, const char *devname)
170 struct rte_devargs *d;
173 TAILQ_FOREACH_SAFE(d, &devargs_list, next, tmp) {
174 if (strcmp(d->bus->name, busname) == 0 &&
175 strcmp(d->name, devname) == 0) {
176 TAILQ_REMOVE(&devargs_list, d, next);
185 /* count the number of devices of a specified type */
187 rte_eal_devargs_type_count(enum rte_devtype devtype)
189 struct rte_devargs *devargs;
190 unsigned int count = 0;
192 TAILQ_FOREACH(devargs, &devargs_list, next) {
193 if (devargs->type != devtype)
200 /* dump the user devices on the console */
202 rte_eal_devargs_dump(FILE *f)
204 struct rte_devargs *devargs;
206 fprintf(f, "User device list:\n");
207 TAILQ_FOREACH(devargs, &devargs_list, next) {
208 fprintf(f, " [%s]: %s %s\n",
209 (devargs->bus ? devargs->bus->name : "??"),
210 devargs->name, devargs->args);
214 /* bus-aware rte_devargs iterator. */
217 rte_eal_devargs_next(const char *busname, const struct rte_devargs *start)
219 struct rte_devargs *da;
222 da = TAILQ_NEXT(start, next);
224 da = TAILQ_FIRST(&devargs_list);
226 if (busname == NULL ||
227 (strcmp(busname, da->bus->name) == 0))
229 da = TAILQ_NEXT(da, next);