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.
16 #include <rte_compat.h>
18 #include <rte_devargs.h>
20 #include <rte_tailq.h>
21 #include "eal_private.h"
23 /** user device double-linked queue type definition */
24 TAILQ_HEAD(rte_devargs_list, rte_devargs);
26 /** Global list of user devices */
27 struct rte_devargs_list devargs_list =
28 TAILQ_HEAD_INITIALIZER(devargs_list);
31 rte_eal_parse_devargs_str(const char *devargs_str,
32 char **drvname, char **drvargs)
36 if ((devargs_str) == NULL || (drvname) == NULL || (drvargs == NULL))
39 *drvname = strdup(devargs_str);
43 /* set the first ',' to '\0' to split name and arguments */
44 sep = strchr(*drvname, ',');
47 *drvargs = strdup(sep + 1);
49 *drvargs = strdup("");
52 if (*drvargs == NULL) {
61 bus_name_cmp(const struct rte_bus *bus, const void *name)
63 return strncmp(bus->name, name, strlen(bus->name));
66 int __rte_experimental
67 rte_devargs_parse(struct rte_devargs *da, const char *format, ...)
69 struct rte_bus *bus = NULL;
72 char dev[vsnprintf(NULL, 0, format, ap) + 1];
74 const size_t maxlen = sizeof(da->name);
82 vsnprintf(dev, sizeof(dev), format, ap);
84 /* Retrieve eventual bus info */
87 bus = rte_bus_find(bus, bus_name_cmp, dev);
90 devname = dev + strlen(bus->name) + 1;
91 if (rte_bus_find_by_device_name(devname) == bus)
94 /* Store device name */
96 while (devname[i] != '\0' && devname[i] != ',') {
97 da->name[i] = devname[i];
100 RTE_LOG(WARNING, EAL, "Parsing \"%s\": device name should be shorter than %zu\n",
102 da->name[i - 1] = '\0';
108 bus = rte_bus_find_by_device_name(da->name);
110 RTE_LOG(ERR, EAL, "failed to parse device \"%s\"\n",
116 /* Parse eventual device arguments */
117 if (devname[i] == ',')
118 da->args = strdup(&devname[i + 1]);
120 da->args = strdup("");
121 if (da->args == NULL) {
122 RTE_LOG(ERR, EAL, "not enough memory to parse arguments\n");
128 int __rte_experimental
129 rte_devargs_insert(struct rte_devargs *da)
133 ret = rte_devargs_remove(da->bus->name, da->name);
136 TAILQ_INSERT_TAIL(&devargs_list, da, next);
140 /* store a whitelist parameter for later parsing */
143 rte_devargs_add(enum rte_devtype devtype, const char *devargs_str)
145 struct rte_devargs *devargs = NULL;
146 struct rte_bus *bus = NULL;
147 const char *dev = devargs_str;
149 /* use calloc instead of rte_zmalloc as it's called early at init */
150 devargs = calloc(1, sizeof(*devargs));
154 if (rte_devargs_parse(devargs, "%s", dev))
156 devargs->type = devtype;
158 if (devargs->type == RTE_DEVTYPE_BLACKLISTED_PCI)
159 devargs->policy = RTE_DEV_BLACKLISTED;
160 if (bus->conf.scan_mode == RTE_BUS_SCAN_UNDEFINED) {
161 if (devargs->policy == RTE_DEV_WHITELISTED)
162 bus->conf.scan_mode = RTE_BUS_SCAN_WHITELIST;
163 else if (devargs->policy == RTE_DEV_BLACKLISTED)
164 bus->conf.scan_mode = RTE_BUS_SCAN_BLACKLIST;
166 TAILQ_INSERT_TAIL(&devargs_list, devargs, next);
178 int __rte_experimental
179 rte_devargs_remove(const char *busname, const char *devname)
181 struct rte_devargs *d;
184 TAILQ_FOREACH_SAFE(d, &devargs_list, next, tmp) {
185 if (strcmp(d->bus->name, busname) == 0 &&
186 strcmp(d->name, devname) == 0) {
187 TAILQ_REMOVE(&devargs_list, d, next);
196 /* count the number of devices of a specified type */
199 rte_devargs_type_count(enum rte_devtype devtype)
201 struct rte_devargs *devargs;
202 unsigned int count = 0;
204 TAILQ_FOREACH(devargs, &devargs_list, next) {
205 if (devargs->type != devtype)
212 /* dump the user devices on the console */
215 rte_devargs_dump(FILE *f)
217 struct rte_devargs *devargs;
219 fprintf(f, "User device list:\n");
220 TAILQ_FOREACH(devargs, &devargs_list, next) {
221 fprintf(f, " [%s]: %s %s\n",
222 (devargs->bus ? devargs->bus->name : "??"),
223 devargs->name, devargs->args);
227 /* bus-aware rte_devargs iterator. */
230 rte_devargs_next(const char *busname, const struct rte_devargs *start)
232 struct rte_devargs *da;
235 da = TAILQ_NEXT(start, next);
237 da = TAILQ_FIRST(&devargs_list);
239 if (busname == NULL ||
240 (strcmp(busname, da->bus->name) == 0))
242 da = TAILQ_NEXT(da, next);