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));
68 rte_devargs_parse(struct rte_devargs *da, const char *dev)
70 struct rte_bus *bus = NULL;
72 const size_t maxlen = sizeof(da->name);
78 /* Retrieve eventual bus info */
81 bus = rte_bus_find(bus, bus_name_cmp, dev);
84 devname = dev + strlen(bus->name) + 1;
85 if (rte_bus_find_by_device_name(devname) == bus)
88 /* Store device name */
90 while (devname[i] != '\0' && devname[i] != ',') {
91 da->name[i] = devname[i];
94 RTE_LOG(WARNING, EAL, "Parsing \"%s\": device name should be shorter than %zu\n",
96 da->name[i - 1] = '\0';
102 bus = rte_bus_find_by_device_name(da->name);
104 RTE_LOG(ERR, EAL, "failed to parse device \"%s\"\n",
110 /* Parse eventual device arguments */
111 if (devname[i] == ',')
112 da->args = strdup(&devname[i + 1]);
114 da->args = strdup("");
115 if (da->args == NULL) {
116 RTE_LOG(ERR, EAL, "not enough memory to parse arguments\n");
124 rte_devargs_parsef(struct rte_devargs *da, const char *format, ...)
133 va_start(ap, format);
134 len = vsnprintf(NULL, 0, format, ap);
137 dev = calloc(1, len + 1);
139 RTE_LOG(ERR, EAL, "not enough memory to parse device\n");
143 va_start(ap, format);
144 vsnprintf(dev, len, format, ap);
147 return rte_devargs_parse(da, dev);
150 int __rte_experimental
151 rte_devargs_insert(struct rte_devargs *da)
155 ret = rte_devargs_remove(da->bus->name, da->name);
158 TAILQ_INSERT_TAIL(&devargs_list, da, next);
162 /* store a whitelist parameter for later parsing */
165 rte_devargs_add(enum rte_devtype devtype, const char *devargs_str)
167 struct rte_devargs *devargs = NULL;
168 struct rte_bus *bus = NULL;
169 const char *dev = devargs_str;
171 /* use calloc instead of rte_zmalloc as it's called early at init */
172 devargs = calloc(1, sizeof(*devargs));
176 if (rte_devargs_parse(devargs, dev))
178 devargs->type = devtype;
180 if (devargs->type == RTE_DEVTYPE_BLACKLISTED_PCI)
181 devargs->policy = RTE_DEV_BLACKLISTED;
182 if (bus->conf.scan_mode == RTE_BUS_SCAN_UNDEFINED) {
183 if (devargs->policy == RTE_DEV_WHITELISTED)
184 bus->conf.scan_mode = RTE_BUS_SCAN_WHITELIST;
185 else if (devargs->policy == RTE_DEV_BLACKLISTED)
186 bus->conf.scan_mode = RTE_BUS_SCAN_BLACKLIST;
188 TAILQ_INSERT_TAIL(&devargs_list, devargs, next);
200 int __rte_experimental
201 rte_devargs_remove(const char *busname, const char *devname)
203 struct rte_devargs *d;
206 TAILQ_FOREACH_SAFE(d, &devargs_list, next, tmp) {
207 if (strcmp(d->bus->name, busname) == 0 &&
208 strcmp(d->name, devname) == 0) {
209 TAILQ_REMOVE(&devargs_list, d, next);
218 /* count the number of devices of a specified type */
221 rte_devargs_type_count(enum rte_devtype devtype)
223 struct rte_devargs *devargs;
224 unsigned int count = 0;
226 TAILQ_FOREACH(devargs, &devargs_list, next) {
227 if (devargs->type != devtype)
234 /* dump the user devices on the console */
237 rte_devargs_dump(FILE *f)
239 struct rte_devargs *devargs;
241 fprintf(f, "User device list:\n");
242 TAILQ_FOREACH(devargs, &devargs_list, next) {
243 fprintf(f, " [%s]: %s %s\n",
244 (devargs->bus ? devargs->bus->name : "??"),
245 devargs->name, devargs->args);
249 /* bus-aware rte_devargs iterator. */
252 rte_devargs_next(const char *busname, const struct rte_devargs *start)
254 struct rte_devargs *da;
257 da = TAILQ_NEXT(start, next);
259 da = TAILQ_FIRST(&devargs_list);
261 if (busname == NULL ||
262 (strcmp(busname, da->bus->name) == 0))
264 da = TAILQ_NEXT(da, next);