lib/librte_eal/linux/eal.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2010-2018 Intel Corporation.
   3  * Copyright(c) 2012-2014 6WIND S.A.
   4  */
   5
   6 #include <stdio.h>
   7 #include <stdlib.h>
   8 #include <stdint.h>
   9 #include <string.h>
  10 #include <stdarg.h>
  11 #include <unistd.h>
  12 #include <pthread.h>
  13 #include <syslog.h>
  14 #include <getopt.h>
  15 #include <sys/file.h>
  16 #include <dirent.h>
  17 #include <fcntl.h>
  18 #include <fnmatch.h>
  19 #include <stddef.h>
  20 #include <errno.h>
  21 #include <limits.h>
  22 #include <sys/mman.h>
  23 #include <sys/queue.h>
  24 #include <sys/stat.h>
  25 #if defined(RTE_ARCH_X86)
  26 #include <sys/io.h>
  27 #endif
  28 #include <linux/version.h>
  29
  30 #include <rte_compat.h>
  31 #include <rte_common.h>
  32 #include <rte_debug.h>
  33 #include <rte_memory.h>
  34 #include <rte_launch.h>
  35 #include <rte_eal.h>
  36 #include <rte_errno.h>
  37 #include <rte_per_lcore.h>
  38 #include <rte_lcore.h>
  39 #include <rte_service_component.h>
  40 #include <rte_log.h>
  41 #include <rte_random.h>
  42 #include <rte_cycles.h>
  43 #include <rte_string_fns.h>
  44 #include <rte_cpuflags.h>
  45 #include <rte_interrupts.h>
  46 #include <rte_bus.h>
  47 #include <rte_dev.h>
  48 #include <rte_devargs.h>
  49 #include <rte_version.h>
  50 #include <rte_atomic.h>
  51 #include <malloc_heap.h>
  52 #include <rte_vfio.h>
  53 #include <rte_telemetry.h>
  54
  55 #include "eal_private.h"
  56 #include "eal_thread.h"
  57 #include "eal_internal_cfg.h"
  58 #include "eal_filesystem.h"
  59 #include "eal_hugepages.h"
  60 #include "eal_memcfg.h"
  61 #include "eal_trace.h"
  62 #include "eal_options.h"
  63 #include "eal_vfio.h"
  64 #include "hotplug_mp.h"
  65
  66 #define MEMSIZE_IF_NO_HUGE_PAGE (64ULL * 1024ULL * 1024ULL)
  67
  68 #define SOCKET_MEM_STRLEN (RTE_MAX_NUMA_NODES * 10)
  69
  70 #define KERNEL_IOMMU_GROUPS_PATH "/sys/kernel/iommu_groups"
  71
  72 /* define fd variable here, because file needs to be kept open for the
  73  * duration of the program, as we hold a write lock on it in the primary proc */
  74 static int mem_cfg_fd = -1;
  75
  76 static struct flock wr_lock = {
  77                 .l_type = F_WRLCK,
  78                 .l_whence = SEEK_SET,
  79                 .l_start = offsetof(struct rte_mem_config, memsegs),
  80                 .l_len = RTE_SIZEOF_FIELD(struct rte_mem_config, memsegs),
  81 };
  82
  83 /* internal configuration (per-core) */
  84 struct lcore_config lcore_config[RTE_MAX_LCORE];
  85
  86 /* used by rte_rdtsc() */
  87 int rte_cycles_vmware_tsc_map;
  88
  89 static const char *default_runtime_dir = "/var/run";
  90
  91 int
  92 eal_create_runtime_dir(void)
  93 {
  94         const char *directory = default_runtime_dir;
  95         const char *xdg_runtime_dir = getenv("XDG_RUNTIME_DIR");
  96         const char *fallback = "/tmp";
  97         char run_dir[PATH_MAX];
  98         char tmp[PATH_MAX];
  99         int ret;
 100
 101         if (getuid() != 0) {
 102                 /* try XDG path first, fall back to /tmp */
 103                 if (xdg_runtime_dir != NULL)
 104                         directory = xdg_runtime_dir;
 105                 else
 106                         directory = fallback;
 107         }
 108         /* create DPDK subdirectory under runtime dir */
 109         ret = snprintf(tmp, sizeof(tmp), "%s/dpdk", directory);
 110         if (ret < 0 || ret == sizeof(tmp)) {
 111                 RTE_LOG(ERR, EAL, "Error creating DPDK runtime path name\n");
 112                 return -1;
 113         }
 114
 115         /* create prefix-specific subdirectory under DPDK runtime dir */
 116         ret = snprintf(run_dir, sizeof(run_dir), "%s/%s",
 117                         tmp, eal_get_hugefile_prefix());
 118         if (ret < 0 || ret == sizeof(run_dir)) {
 119                 RTE_LOG(ERR, EAL, "Error creating prefix-specific runtime path name\n");
 120                 return -1;
 121         }
 122
 123         /* create the path if it doesn't exist. no "mkdir -p" here, so do it
 124          * step by step.
 125          */
 126         ret = mkdir(tmp, 0700);
 127         if (ret < 0 && errno != EEXIST) {
 128                 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
 129                         tmp, strerror(errno));
 130                 return -1;
 131         }
 132
 133         ret = mkdir(run_dir, 0700);
 134         if (ret < 0 && errno != EEXIST) {
 135                 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
 136                         run_dir, strerror(errno));
 137                 return -1;
 138         }
 139
 140         if (eal_set_runtime_dir(run_dir, sizeof(run_dir)))
 141                 return -1;
 142
 143         return 0;
 144 }
 145
 146 int
 147 eal_clean_runtime_dir(void)
 148 {
 149         const char *runtime_dir = rte_eal_get_runtime_dir();
 150         DIR *dir;
 151         struct dirent *dirent;
 152         int dir_fd, fd, lck_result;
 153         static const char * const filters[] = {
 154                 "fbarray_*",
 155                 "mp_socket_*"
 156         };
 157
 158         /* open directory */
 159         dir = opendir(runtime_dir);
 160         if (!dir) {
 161                 RTE_LOG(ERR, EAL, "Unable to open runtime directory %s\n",
 162                                 runtime_dir);
 163                 goto error;
 164         }
 165         dir_fd = dirfd(dir);
 166
 167         /* lock the directory before doing anything, to avoid races */
 168         if (flock(dir_fd, LOCK_EX) < 0) {
 169                 RTE_LOG(ERR, EAL, "Unable to lock runtime directory %s\n",
 170                         runtime_dir);
 171                 goto error;
 172         }
 173
 174         dirent = readdir(dir);
 175         if (!dirent) {
 176                 RTE_LOG(ERR, EAL, "Unable to read runtime directory %s\n",
 177                                 runtime_dir);
 178                 goto error;
 179         }
 180
 181         while (dirent != NULL) {
 182                 unsigned int f_idx;
 183                 bool skip = true;
 184
 185                 /* skip files that don't match the patterns */
 186                 for (f_idx = 0; f_idx < RTE_DIM(filters); f_idx++) {
 187                         const char *filter = filters[f_idx];
 188
 189                         if (fnmatch(filter, dirent->d_name, 0) == 0) {
 190                                 skip = false;
 191                                 break;
 192                         }
 193                 }
 194                 if (skip) {
 195                         dirent = readdir(dir);
 196                         continue;
 197                 }
 198
 199                 /* try and lock the file */
 200                 fd = openat(dir_fd, dirent->d_name, O_RDONLY);
 201
 202                 /* skip to next file */
 203                 if (fd == -1) {
 204                         dirent = readdir(dir);
 205                         continue;
 206                 }
 207
 208                 /* non-blocking lock */
 209                 lck_result = flock(fd, LOCK_EX | LOCK_NB);
 210
 211                 /* if lock succeeds, remove the file */
 212                 if (lck_result != -1)
 213                         unlinkat(dir_fd, dirent->d_name, 0);
 214                 close(fd);
 215                 dirent = readdir(dir);
 216         }
 217
 218         /* closedir closes dir_fd and drops the lock */
 219         closedir(dir);
 220         return 0;
 221
 222 error:
 223         if (dir)
 224                 closedir(dir);
 225
 226         RTE_LOG(ERR, EAL, "Error while clearing runtime dir: %s\n",
 227                 strerror(errno));
 228
 229         return -1;
 230 }
 231
 232 /* parse a sysfs (or other) file containing one integer value */
 233 int
 234 eal_parse_sysfs_value(const char *filename, unsigned long *val)
 235 {
 236         FILE *f;
 237         char buf[BUFSIZ];
 238         char *end = NULL;
 239
 240         if ((f = fopen(filename, "r")) == NULL) {
 241                 RTE_LOG(ERR, EAL, "%s(): cannot open sysfs value %s\n",
 242                         __func__, filename);
 243                 return -1;
 244         }
 245
 246         if (fgets(buf, sizeof(buf), f) == NULL) {
 247                 RTE_LOG(ERR, EAL, "%s(): cannot read sysfs value %s\n",
 248                         __func__, filename);
 249                 fclose(f);
 250                 return -1;
 251         }
 252         *val = strtoul(buf, &end, 0);
 253         if ((buf[0] == '\0') || (end == NULL) || (*end != '\n')) {
 254                 RTE_LOG(ERR, EAL, "%s(): cannot parse sysfs value %s\n",
 255                                 __func__, filename);
 256                 fclose(f);
 257                 return -1;
 258         }
 259         fclose(f);
 260         return 0;
 261 }
 262
 263
 264 /* create memory configuration in shared/mmap memory. Take out
 265  * a write lock on the memsegs, so we can auto-detect primary/secondary.
 266  * This means we never close the file while running (auto-close on exit).
 267  * We also don't lock the whole file, so that in future we can use read-locks
 268  * on other parts, e.g. memzones, to detect if there are running secondary
 269  * processes. */
 270 static int
 271 rte_eal_config_create(void)
 272 {
 273         struct rte_config *config = rte_eal_get_configuration();
 274         size_t page_sz = sysconf(_SC_PAGE_SIZE);
 275         size_t cfg_len = sizeof(*config->mem_config);
 276         size_t cfg_len_aligned = RTE_ALIGN(cfg_len, page_sz);
 277         void *rte_mem_cfg_addr, *mapped_mem_cfg_addr;
 278         int retval;
 279         const struct internal_config *internal_conf =
 280                 eal_get_internal_configuration();
 281
 282         const char *pathname = eal_runtime_config_path();
 283
 284         if (internal_conf->no_shconf)
 285                 return 0;
 286
 287         /* map the config before hugepage address so that we don't waste a page */
 288         if (internal_conf->base_virtaddr != 0)
 289                 rte_mem_cfg_addr = (void *)
 290                         RTE_ALIGN_FLOOR(internal_conf->base_virtaddr -
 291                         sizeof(struct rte_mem_config), page_sz);
 292         else
 293                 rte_mem_cfg_addr = NULL;
 294
 295         if (mem_cfg_fd < 0){
 296                 mem_cfg_fd = open(pathname, O_RDWR | O_CREAT, 0600);
 297                 if (mem_cfg_fd < 0) {
 298                         RTE_LOG(ERR, EAL, "Cannot open '%s' for rte_mem_config\n",
 299                                 pathname);
 300                         return -1;
 301                 }
 302         }
 303
 304         retval = ftruncate(mem_cfg_fd, cfg_len);
 305         if (retval < 0){
 306                 close(mem_cfg_fd);
 307                 mem_cfg_fd = -1;
 308                 RTE_LOG(ERR, EAL, "Cannot resize '%s' for rte_mem_config\n",
 309                         pathname);
 310                 return -1;
 311         }
 312
 313         retval = fcntl(mem_cfg_fd, F_SETLK, &wr_lock);
 314         if (retval < 0){
 315                 close(mem_cfg_fd);
 316                 mem_cfg_fd = -1;
 317                 RTE_LOG(ERR, EAL, "Cannot create lock on '%s'. Is another primary "
 318                         "process running?\n", pathname);
 319                 return -1;
 320         }
 321
 322         /* reserve space for config */
 323         rte_mem_cfg_addr = eal_get_virtual_area(rte_mem_cfg_addr,
 324                         &cfg_len_aligned, page_sz, 0, 0);
 325         if (rte_mem_cfg_addr == NULL) {
 326                 RTE_LOG(ERR, EAL, "Cannot mmap memory for rte_config\n");
 327                 close(mem_cfg_fd);
 328                 mem_cfg_fd = -1;
 329                 return -1;
 330         }
 331
 332         /* remap the actual file into the space we've just reserved */
 333         mapped_mem_cfg_addr = mmap(rte_mem_cfg_addr,
 334                         cfg_len_aligned, PROT_READ | PROT_WRITE,
 335                         MAP_SHARED | MAP_FIXED, mem_cfg_fd, 0);
 336         if (mapped_mem_cfg_addr == MAP_FAILED) {
 337                 munmap(rte_mem_cfg_addr, cfg_len);
 338                 close(mem_cfg_fd);
 339                 mem_cfg_fd = -1;
 340                 RTE_LOG(ERR, EAL, "Cannot remap memory for rte_config\n");
 341                 return -1;
 342         }
 343
 344         memcpy(rte_mem_cfg_addr, config->mem_config, sizeof(struct rte_mem_config));
 345         config->mem_config = rte_mem_cfg_addr;
 346
 347         /* store address of the config in the config itself so that secondary
 348          * processes could later map the config into this exact location
 349          */
 350         config->mem_config->mem_cfg_addr = (uintptr_t) rte_mem_cfg_addr;
 351         config->mem_config->dma_maskbits = 0;
 352
 353         return 0;
 354 }
 355
 356 /* attach to an existing shared memory config */
 357 static int
 358 rte_eal_config_attach(void)
 359 {
 360         struct rte_config *config = rte_eal_get_configuration();
 361         struct rte_mem_config *mem_config;
 362         const struct internal_config *internal_conf =
 363                 eal_get_internal_configuration();
 364
 365         const char *pathname = eal_runtime_config_path();
 366
 367         if (internal_conf->no_shconf)
 368                 return 0;
 369
 370         if (mem_cfg_fd < 0){
 371                 mem_cfg_fd = open(pathname, O_RDWR);
 372                 if (mem_cfg_fd < 0) {
 373                         RTE_LOG(ERR, EAL, "Cannot open '%s' for rte_mem_config\n",
 374                                 pathname);
 375                         return -1;
 376                 }
 377         }
 378
 379         /* map it as read-only first */
 380         mem_config = (struct rte_mem_config *) mmap(NULL, sizeof(*mem_config),
 381                         PROT_READ, MAP_SHARED, mem_cfg_fd, 0);
 382         if (mem_config == MAP_FAILED) {
 383                 close(mem_cfg_fd);
 384                 mem_cfg_fd = -1;
 385                 RTE_LOG(ERR, EAL, "Cannot mmap memory for rte_config! error %i (%s)\n",
 386                         errno, strerror(errno));
 387                 return -1;
 388         }
 389
 390         config->mem_config = mem_config;
 391
 392         return 0;
 393 }
 394
 395 /* reattach the shared config at exact memory location primary process has it */
 396 static int
 397 rte_eal_config_reattach(void)
 398 {
 399         struct rte_config *config = rte_eal_get_configuration();
 400         struct rte_mem_config *mem_config;
 401         void *rte_mem_cfg_addr;
 402         const struct internal_config *internal_conf =
 403                 eal_get_internal_configuration();
 404
 405         if (internal_conf->no_shconf)
 406                 return 0;
 407
 408         /* save the address primary process has mapped shared config to */
 409         rte_mem_cfg_addr =
 410                 (void *) (uintptr_t) config->mem_config->mem_cfg_addr;
 411
 412         /* unmap original config */
 413         munmap(config->mem_config, sizeof(struct rte_mem_config));
 414
 415         /* remap the config at proper address */
 416         mem_config = (struct rte_mem_config *) mmap(rte_mem_cfg_addr,
 417                         sizeof(*mem_config), PROT_READ | PROT_WRITE, MAP_SHARED,
 418                         mem_cfg_fd, 0);
 419
 420         close(mem_cfg_fd);
 421         mem_cfg_fd = -1;
 422
 423         if (mem_config == MAP_FAILED || mem_config != rte_mem_cfg_addr) {
 424                 if (mem_config != MAP_FAILED) {
 425                         /* errno is stale, don't use */
 426                         RTE_LOG(ERR, EAL, "Cannot mmap memory for rte_config at [%p], got [%p]"
 427                                 " - please use '--" OPT_BASE_VIRTADDR
 428                                 "' option\n", rte_mem_cfg_addr, mem_config);
 429                         munmap(mem_config, sizeof(struct rte_mem_config));
 430                         return -1;
 431                 }
 432                 RTE_LOG(ERR, EAL, "Cannot mmap memory for rte_config! error %i (%s)\n",
 433                         errno, strerror(errno));
 434                 return -1;
 435         }
 436
 437         config->mem_config = mem_config;
 438
 439         return 0;
 440 }
 441
 442 /* Detect if we are a primary or a secondary process */
 443 enum rte_proc_type_t
 444 eal_proc_type_detect(void)
 445 {
 446         enum rte_proc_type_t ptype = RTE_PROC_PRIMARY;
 447         const char *pathname = eal_runtime_config_path();
 448         const struct internal_config *internal_conf =
 449                 eal_get_internal_configuration();
 450
 451         /* if there no shared config, there can be no secondary processes */
 452         if (!internal_conf->no_shconf) {
 453                 /* if we can open the file but not get a write-lock we are a
 454                  * secondary process. NOTE: if we get a file handle back, we
 455                  * keep that open and don't close it to prevent a race condition
 456                  * between multiple opens.
 457                  */
 458                 if (((mem_cfg_fd = open(pathname, O_RDWR)) >= 0) &&
 459                                 (fcntl(mem_cfg_fd, F_SETLK, &wr_lock) < 0))
 460                         ptype = RTE_PROC_SECONDARY;
 461         }
 462
 463         RTE_LOG(INFO, EAL, "Auto-detected process type: %s\n",
 464                         ptype == RTE_PROC_PRIMARY ? "PRIMARY" : "SECONDARY");
 465
 466         return ptype;
 467 }
 468
 469 /* Sets up rte_config structure with the pointer to shared memory config.*/
 470 static int
 471 rte_config_init(void)
 472 {
 473         struct rte_config *config = rte_eal_get_configuration();
 474         const struct internal_config *internal_conf =
 475                 eal_get_internal_configuration();
 476
 477         config->process_type = internal_conf->process_type;
 478
 479         switch (config->process_type) {
 480         case RTE_PROC_PRIMARY:
 481                 if (rte_eal_config_create() < 0)
 482                         return -1;
 483                 eal_mcfg_update_from_internal();
 484                 break;
 485         case RTE_PROC_SECONDARY:
 486                 if (rte_eal_config_attach() < 0)
 487                         return -1;
 488                 eal_mcfg_wait_complete();
 489                 if (eal_mcfg_check_version() < 0) {
 490                         RTE_LOG(ERR, EAL, "Primary and secondary process DPDK version mismatch\n");
 491                         return -1;
 492                 }
 493                 if (rte_eal_config_reattach() < 0)
 494                         return -1;
 495                 eal_mcfg_update_internal();
 496                 break;
 497         case RTE_PROC_AUTO:
 498         case RTE_PROC_INVALID:
 499                 RTE_LOG(ERR, EAL, "Invalid process type %d\n",
 500                         config->process_type);
 501                 return -1;
 502         }
 503
 504         return 0;
 505 }
 506
 507 /* Unlocks hugepage directories that were locked by eal_hugepage_info_init */
 508 static void
 509 eal_hugedirs_unlock(void)
 510 {
 511         int i;
 512         struct internal_config *internal_conf =
 513                 eal_get_internal_configuration();
 514
 515         for (i = 0; i < MAX_HUGEPAGE_SIZES; i++)
 516         {
 517                 /* skip uninitialized */
 518                 if (internal_conf->hugepage_info[i].lock_descriptor < 0)
 519                         continue;
 520                 /* unlock hugepage file */
 521                 flock(internal_conf->hugepage_info[i].lock_descriptor, LOCK_UN);
 522                 close(internal_conf->hugepage_info[i].lock_descriptor);
 523                 /* reset the field */
 524                 internal_conf->hugepage_info[i].lock_descriptor = -1;
 525         }
 526 }
 527
 528 /* display usage */
 529 static void
 530 eal_usage(const char *prgname)
 531 {
 532         rte_usage_hook_t hook = eal_get_application_usage_hook();
 533
 534         printf("\nUsage: %s ", prgname);
 535         eal_common_usage();
 536         printf("EAL Linux options:\n"
 537                "  --"OPT_SOCKET_MEM"        Memory to allocate on sockets (comma separated values)\n"
 538                "  --"OPT_SOCKET_LIMIT"      Limit memory allocation on sockets (comma separated values)\n"
 539                "  --"OPT_HUGE_DIR"          Directory where hugetlbfs is mounted\n"
 540                "  --"OPT_FILE_PREFIX"       Prefix for hugepage filenames\n"
 541                "  --"OPT_CREATE_UIO_DEV"    Create /dev/uioX (usually done by hotplug)\n"
 542                "  --"OPT_VFIO_INTR"         Interrupt mode for VFIO (legacy|msi|msix)\n"
 543                "  --"OPT_LEGACY_MEM"        Legacy memory mode (no dynamic allocation, contiguous segments)\n"
 544                "  --"OPT_SINGLE_FILE_SEGMENTS" Put all hugepage memory in single files\n"
 545                "  --"OPT_MATCH_ALLOCATIONS" Free hugepages exactly as allocated\n"
 546                "\n");
 547         /* Allow the application to print its usage message too if hook is set */
 548         if (hook) {
 549                 printf("===== Application Usage =====\n\n");
 550                 (hook)(prgname);
 551         }
 552 }
 553
 554 static int
 555 eal_parse_socket_arg(char *strval, volatile uint64_t *socket_arg)
 556 {
 557         char * arg[RTE_MAX_NUMA_NODES];
 558         char *end;
 559         int arg_num, i, len;
 560         uint64_t total_mem = 0;
 561
 562         len = strnlen(strval, SOCKET_MEM_STRLEN);
 563         if (len == SOCKET_MEM_STRLEN) {
 564                 RTE_LOG(ERR, EAL, "--socket-mem is too long\n");
 565                 return -1;
 566         }
 567
 568         /* all other error cases will be caught later */
 569         if (!isdigit(strval[len-1]))
 570                 return -1;
 571
 572         /* split the optarg into separate socket values */
 573         arg_num = rte_strsplit(strval, len,
 574                         arg, RTE_MAX_NUMA_NODES, ',');
 575
 576         /* if split failed, or 0 arguments */
 577         if (arg_num <= 0)
 578                 return -1;
 579
 580         /* parse each defined socket option */
 581         errno = 0;
 582         for (i = 0; i < arg_num; i++) {
 583                 uint64_t val;
 584                 end = NULL;
 585                 val = strtoull(arg[i], &end, 10);
 586
 587                 /* check for invalid input */
 588                 if ((errno != 0)  ||
 589                                 (arg[i][0] == '\0') || (end == NULL) || (*end != '\0'))
 590                         return -1;
 591                 val <<= 20;
 592                 total_mem += val;
 593                 socket_arg[i] = val;
 594         }
 595
 596         return 0;
 597 }
 598
 599 static int
 600 eal_parse_vfio_intr(const char *mode)
 601 {
 602         struct internal_config *internal_conf =
 603                 eal_get_internal_configuration();
 604         unsigned i;
 605         static struct {
 606                 const char *name;
 607                 enum rte_intr_mode value;
 608         } map[] = {
 609                 { "legacy", RTE_INTR_MODE_LEGACY },
 610                 { "msi", RTE_INTR_MODE_MSI },
 611                 { "msix", RTE_INTR_MODE_MSIX },
 612         };
 613
 614         for (i = 0; i < RTE_DIM(map); i++) {
 615                 if (!strcmp(mode, map[i].name)) {
 616                         internal_conf->vfio_intr_mode = map[i].value;
 617                         return 0;
 618                 }
 619         }
 620         return -1;
 621 }
 622
 623 /* Parse the arguments for --log-level only */
 624 static void
 625 eal_log_level_parse(int argc, char **argv)
 626 {
 627         int opt;
 628         char **argvopt;
 629         int option_index;
 630         const int old_optind = optind;
 631         const int old_optopt = optopt;
 632         char * const old_optarg = optarg;
 633         struct internal_config *internal_conf =
 634                 eal_get_internal_configuration();
 635
 636         argvopt = argv;
 637         optind = 1;
 638
 639         while ((opt = getopt_long(argc, argvopt, eal_short_options,
 640                                   eal_long_options, &option_index)) != EOF) {
 641
 642                 int ret;
 643
 644                 /* getopt is not happy, stop right now */
 645                 if (opt == '?')
 646                         break;
 647
 648                 ret = (opt == OPT_LOG_LEVEL_NUM) ?
 649                         eal_parse_common_option(opt, optarg, internal_conf) : 0;
 650
 651                 /* common parser is not happy */
 652                 if (ret < 0)
 653                         break;
 654         }
 655
 656         /* restore getopt lib */
 657         optind = old_optind;
 658         optopt = old_optopt;
 659         optarg = old_optarg;
 660 }
 661
 662 /* Parse the argument given in the command line of the application */
 663 static int
 664 eal_parse_args(int argc, char **argv)
 665 {
 666         int opt, ret;
 667         char **argvopt;
 668         int option_index;
 669         char *prgname = argv[0];
 670         const int old_optind = optind;
 671         const int old_optopt = optopt;
 672         char * const old_optarg = optarg;
 673         struct internal_config *internal_conf =
 674                 eal_get_internal_configuration();
 675
 676         argvopt = argv;
 677         optind = 1;
 678
 679         while ((opt = getopt_long(argc, argvopt, eal_short_options,
 680                                   eal_long_options, &option_index)) != EOF) {
 681
 682                 /* getopt didn't recognise the option */
 683                 if (opt == '?') {
 684                         eal_usage(prgname);
 685                         ret = -1;
 686                         goto out;
 687                 }
 688
 689                 ret = eal_parse_common_option(opt, optarg, internal_conf);
 690                 /* common parser is not happy */
 691                 if (ret < 0) {
 692                         eal_usage(prgname);
 693                         ret = -1;
 694                         goto out;
 695                 }
 696                 /* common parser handled this option */
 697                 if (ret == 0)
 698                         continue;
 699
 700                 switch (opt) {
 701                 case 'h':
 702                         eal_usage(prgname);
 703                         exit(EXIT_SUCCESS);
 704
 705                 case OPT_HUGE_DIR_NUM:
 706                 {
 707                         char *hdir = strdup(optarg);
 708                         if (hdir == NULL)
 709                                 RTE_LOG(ERR, EAL, "Could not store hugepage directory\n");
 710                         else {
 711                                 /* free old hugepage dir */
 712                                 if (internal_conf->hugepage_dir != NULL)
 713                                         free(internal_conf->hugepage_dir);
 714                                 internal_conf->hugepage_dir = hdir;
 715                         }
 716                         break;
 717                 }
 718                 case OPT_FILE_PREFIX_NUM:
 719                 {
 720                         char *prefix = strdup(optarg);
 721                         if (prefix == NULL)
 722                                 RTE_LOG(ERR, EAL, "Could not store file prefix\n");
 723                         else {
 724                                 /* free old prefix */
 725                                 if (internal_conf->hugefile_prefix != NULL)
 726                                         free(internal_conf->hugefile_prefix);
 727                                 internal_conf->hugefile_prefix = prefix;
 728                         }
 729                         break;
 730                 }
 731                 case OPT_SOCKET_MEM_NUM:
 732                         if (eal_parse_socket_arg(optarg,
 733                                         internal_conf->socket_mem) < 0) {
 734                                 RTE_LOG(ERR, EAL, "invalid parameters for --"
 735                                                 OPT_SOCKET_MEM "\n");
 736                                 eal_usage(prgname);
 737                                 ret = -1;
 738                                 goto out;
 739                         }
 740                         internal_conf->force_sockets = 1;
 741                         break;
 742
 743                 case OPT_SOCKET_LIMIT_NUM:
 744                         if (eal_parse_socket_arg(optarg,
 745                                         internal_conf->socket_limit) < 0) {
 746                                 RTE_LOG(ERR, EAL, "invalid parameters for --"
 747                                                 OPT_SOCKET_LIMIT "\n");
 748                                 eal_usage(prgname);
 749                                 ret = -1;
 750                                 goto out;
 751                         }
 752                         internal_conf->force_socket_limits = 1;
 753                         break;
 754
 755                 case OPT_VFIO_INTR_NUM:
 756                         if (eal_parse_vfio_intr(optarg) < 0) {
 757                                 RTE_LOG(ERR, EAL, "invalid parameters for --"
 758                                                 OPT_VFIO_INTR "\n");
 759                                 eal_usage(prgname);
 760                                 ret = -1;
 761                                 goto out;
 762                         }
 763                         break;
 764
 765                 case OPT_CREATE_UIO_DEV_NUM:
 766                         internal_conf->create_uio_dev = 1;
 767                         break;
 768
 769                 case OPT_MBUF_POOL_OPS_NAME_NUM:
 770                 {
 771                         char *ops_name = strdup(optarg);
 772                         if (ops_name == NULL)
 773                                 RTE_LOG(ERR, EAL, "Could not store mbuf pool ops name\n");
 774                         else {
 775                                 /* free old ops name */
 776                                 if (internal_conf->user_mbuf_pool_ops_name !=
 777                                                 NULL)
 778                                         free(internal_conf->user_mbuf_pool_ops_name);
 779
 780                                 internal_conf->user_mbuf_pool_ops_name =
 781                                                 ops_name;
 782                         }
 783                         break;
 784                 }
 785                 case OPT_MATCH_ALLOCATIONS_NUM:
 786                         internal_conf->match_allocations = 1;
 787                         break;
 788
 789                 default:
 790                         if (opt < OPT_LONG_MIN_NUM && isprint(opt)) {
 791                                 RTE_LOG(ERR, EAL, "Option %c is not supported "
 792                                         "on Linux\n", opt);
 793                         } else if (opt >= OPT_LONG_MIN_NUM &&
 794                                    opt < OPT_LONG_MAX_NUM) {
 795                                 RTE_LOG(ERR, EAL, "Option %s is not supported "
 796                                         "on Linux\n",
 797                                         eal_long_options[option_index].name);
 798                         } else {
 799                                 RTE_LOG(ERR, EAL, "Option %d is not supported "
 800                                         "on Linux\n", opt);
 801                         }
 802                         eal_usage(prgname);
 803                         ret = -1;
 804                         goto out;
 805                 }
 806         }
 807
 808         /* create runtime data directory */
 809         if (internal_conf->no_shconf == 0 &&
 810                         eal_create_runtime_dir() < 0) {
 811                 RTE_LOG(ERR, EAL, "Cannot create runtime directory\n");
 812                 ret = -1;
 813                 goto out;
 814         }
 815
 816         if (eal_adjust_config(internal_conf) != 0) {
 817                 ret = -1;
 818                 goto out;
 819         }
 820
 821         /* sanity checks */
 822         if (eal_check_common_options(internal_conf) != 0) {
 823                 eal_usage(prgname);
 824                 ret = -1;
 825                 goto out;
 826         }
 827
 828         if (optind >= 0)
 829                 argv[optind-1] = prgname;
 830         ret = optind-1;
 831
 832 out:
 833         /* restore getopt lib */
 834         optind = old_optind;
 835         optopt = old_optopt;
 836         optarg = old_optarg;
 837
 838         return ret;
 839 }
 840
 841 static int
 842 check_socket(const struct rte_memseg_list *msl, void *arg)
 843 {
 844         int *socket_id = arg;
 845
 846         if (msl->external)
 847                 return 0;
 848
 849         return *socket_id == msl->socket_id;
 850 }
 851
 852 static void
 853 eal_check_mem_on_local_socket(void)
 854 {
 855         int socket_id;
 856         const struct rte_config *config = rte_eal_get_configuration();
 857
 858         socket_id = rte_lcore_to_socket_id(config->master_lcore);
 859
 860         if (rte_memseg_list_walk(check_socket, &socket_id) == 0)
 861                 RTE_LOG(WARNING, EAL, "WARNING: Master core has no memory on local socket!\n");
 862 }
 863
 864 static int
 865 sync_func(__rte_unused void *arg)
 866 {
 867         return 0;
 868 }
 869
 870 /*
 871  * Request iopl privilege for all RPL, returns 0 on success
 872  * iopl() call is mostly for the i386 architecture. For other architectures,
 873  * return -1 to indicate IO privilege can't be changed in this way.
 874  */
 875 int
 876 rte_eal_iopl_init(void)
 877 {
 878 #if defined(RTE_ARCH_X86)
 879         if (iopl(3) != 0)
 880                 return -1;
 881 #endif
 882         return 0;
 883 }
 884
 885 #ifdef VFIO_PRESENT
 886 static int rte_eal_vfio_setup(void)
 887 {
 888         if (rte_vfio_enable("vfio"))
 889                 return -1;
 890
 891         return 0;
 892 }
 893 #endif
 894
 895 static void rte_eal_init_alert(const char *msg)
 896 {
 897         fprintf(stderr, "EAL: FATAL: %s\n", msg);
 898         RTE_LOG(ERR, EAL, "%s\n", msg);
 899 }
 900
 901 /*
 902  * On Linux 3.6+, even if VFIO is not loaded, whenever IOMMU is enabled in the
 903  * BIOS and in the kernel, /sys/kernel/iommu_groups path will contain kernel
 904  * IOMMU groups. If IOMMU is not enabled, that path would be empty.
 905  * Therefore, checking if the path is empty will tell us if IOMMU is enabled.
 906  */
 907 static bool
 908 is_iommu_enabled(void)
 909 {
 910         DIR *dir = opendir(KERNEL_IOMMU_GROUPS_PATH);
 911         struct dirent *d;
 912         int n = 0;
 913
 914         /* if directory doesn't exist, assume IOMMU is not enabled */
 915         if (dir == NULL)
 916                 return false;
 917
 918         while ((d = readdir(dir)) != NULL) {
 919                 /* skip dot and dot-dot */
 920                 if (++n > 2)
 921                         break;
 922         }
 923         closedir(dir);
 924
 925         return n > 2;
 926 }
 927
 928 /* Launch threads, called at application init(). */
 929 int
 930 rte_eal_init(int argc, char **argv)
 931 {
 932         int i, fctret, ret;
 933         pthread_t thread_id;
 934         static rte_atomic32_t run_once = RTE_ATOMIC32_INIT(0);
 935         const char *p;
 936         static char logid[PATH_MAX];
 937         char cpuset[RTE_CPU_AFFINITY_STR_LEN];
 938         char thread_name[RTE_MAX_THREAD_NAME_LEN];
 939         bool phys_addrs;
 940         const struct rte_config *config = rte_eal_get_configuration();
 941         struct internal_config *internal_conf =
 942                 eal_get_internal_configuration();
 943
 944         /* checks if the machine is adequate */
 945         if (!rte_cpu_is_supported()) {
 946                 rte_eal_init_alert("unsupported cpu type.");
 947                 rte_errno = ENOTSUP;
 948                 return -1;
 949         }
 950
 951         if (!rte_atomic32_test_and_set(&run_once)) {
 952                 rte_eal_init_alert("already called initialization.");
 953                 rte_errno = EALREADY;
 954                 return -1;
 955         }
 956
 957         p = strrchr(argv[0], '/');
 958         strlcpy(logid, p ? p + 1 : argv[0], sizeof(logid));
 959         thread_id = pthread_self();
 960
 961         eal_reset_internal_config(internal_conf);
 962
 963         /* set log level as early as possible */
 964         eal_log_level_parse(argc, argv);
 965
 966         /* clone argv to report out later in telemetry */
 967         eal_save_args(argc, argv);
 968
 969         if (rte_eal_cpu_init() < 0) {
 970                 rte_eal_init_alert("Cannot detect lcores.");
 971                 rte_errno = ENOTSUP;
 972                 return -1;
 973         }
 974
 975         fctret = eal_parse_args(argc, argv);
 976         if (fctret < 0) {
 977                 rte_eal_init_alert("Invalid 'command line' arguments.");
 978                 rte_errno = EINVAL;
 979                 rte_atomic32_clear(&run_once);
 980                 return -1;
 981         }
 982
 983         if (eal_plugins_init() < 0) {
 984                 rte_eal_init_alert("Cannot init plugins");
 985                 rte_errno = EINVAL;
 986                 rte_atomic32_clear(&run_once);
 987                 return -1;
 988         }
 989
 990         if (eal_trace_init() < 0) {
 991                 rte_eal_init_alert("Cannot init trace");
 992                 rte_errno = EFAULT;
 993                 return -1;
 994         }
 995
 996         if (eal_option_device_parse()) {
 997                 rte_errno = ENODEV;
 998                 rte_atomic32_clear(&run_once);
 999                 return -1;
1000         }
1001
1002         if (rte_config_init() < 0) {
1003                 rte_eal_init_alert("Cannot init config");
1004                 return -1;
1005         }
1006
1007         if (rte_eal_intr_init() < 0) {
1008                 rte_eal_init_alert("Cannot init interrupt-handling thread");
1009                 return -1;
1010         }
1011
1012         if (rte_eal_alarm_init() < 0) {
1013                 rte_eal_init_alert("Cannot init alarm");
1014                 /* rte_eal_alarm_init sets rte_errno on failure. */
1015                 return -1;
1016         }
1017
1018         /* Put mp channel init before bus scan so that we can init the vdev
1019          * bus through mp channel in the secondary process before the bus scan.
1020          */
1021         if (rte_mp_channel_init() < 0 && rte_errno != ENOTSUP) {
1022                 rte_eal_init_alert("failed to init mp channel");
1023                 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1024                         rte_errno = EFAULT;
1025                         return -1;
1026                 }
1027         }
1028
1029         /* register multi-process action callbacks for hotplug */
1030         if (eal_mp_dev_hotplug_init() < 0) {
1031                 rte_eal_init_alert("failed to register mp callback for hotplug");
1032                 return -1;
1033         }
1034
1035         if (rte_bus_scan()) {
1036                 rte_eal_init_alert("Cannot scan the buses for devices");
1037                 rte_errno = ENODEV;
1038                 rte_atomic32_clear(&run_once);
1039                 return -1;
1040         }
1041
1042         phys_addrs = rte_eal_using_phys_addrs() != 0;
1043
1044         /* if no EAL option "--iova-mode=<pa|va>", use bus IOVA scheme */
1045         if (internal_conf->iova_mode == RTE_IOVA_DC) {
1046                 /* autodetect the IOVA mapping mode */
1047                 enum rte_iova_mode iova_mode = rte_bus_get_iommu_class();
1048
1049                 if (iova_mode == RTE_IOVA_DC) {
1050                         RTE_LOG(DEBUG, EAL, "Buses did not request a specific IOVA mode.\n");
1051
1052                         if (!phys_addrs) {
1053                                 /* if we have no access to physical addresses,
1054                                  * pick IOVA as VA mode.
1055                                  */
1056                                 iova_mode = RTE_IOVA_VA;
1057                                 RTE_LOG(DEBUG, EAL, "Physical addresses are unavailable, selecting IOVA as VA mode.\n");
1058 #if defined(RTE_LIBRTE_KNI) && LINUX_VERSION_CODE >= KERNEL_VERSION(4, 10, 0)
1059                         } else if (rte_eal_check_module("rte_kni") == 1) {
1060                                 iova_mode = RTE_IOVA_PA;
1061                                 RTE_LOG(DEBUG, EAL, "KNI is loaded, selecting IOVA as PA mode for better KNI performance.\n");
1062 #endif
1063                         } else if (is_iommu_enabled()) {
1064                                 /* we have an IOMMU, pick IOVA as VA mode */
1065                                 iova_mode = RTE_IOVA_VA;
1066                                 RTE_LOG(DEBUG, EAL, "IOMMU is available, selecting IOVA as VA mode.\n");
1067                         } else {
1068                                 /* physical addresses available, and no IOMMU
1069                                  * found, so pick IOVA as PA.
1070                                  */
1071                                 iova_mode = RTE_IOVA_PA;
1072                                 RTE_LOG(DEBUG, EAL, "IOMMU is not available, selecting IOVA as PA mode.\n");
1073                         }
1074                 }
1075 #if defined(RTE_LIBRTE_KNI) && LINUX_VERSION_CODE < KERNEL_VERSION(4, 10, 0)
1076                 /* Workaround for KNI which requires physical address to work
1077                  * in kernels < 4.10
1078                  */
1079                 if (iova_mode == RTE_IOVA_VA &&
1080                                 rte_eal_check_module("rte_kni") == 1) {
1081                         if (phys_addrs) {
1082                                 iova_mode = RTE_IOVA_PA;
1083                                 RTE_LOG(WARNING, EAL, "Forcing IOVA as 'PA' because KNI module is loaded\n");
1084                         } else {
1085                                 RTE_LOG(DEBUG, EAL, "KNI can not work since physical addresses are unavailable\n");
1086                         }
1087                 }
1088 #endif
1089                 rte_eal_get_configuration()->iova_mode = iova_mode;
1090         } else {
1091                 rte_eal_get_configuration()->iova_mode =
1092                         internal_conf->iova_mode;
1093         }
1094
1095         if (rte_eal_iova_mode() == RTE_IOVA_PA && !phys_addrs) {
1096                 rte_eal_init_alert("Cannot use IOVA as 'PA' since physical addresses are not available");
1097                 rte_errno = EINVAL;
1098                 return -1;
1099         }
1100
1101         RTE_LOG(INFO, EAL, "Selected IOVA mode '%s'\n",
1102                 rte_eal_iova_mode() == RTE_IOVA_PA ? "PA" : "VA");
1103
1104         if (internal_conf->no_hugetlbfs == 0) {
1105                 /* rte_config isn't initialized yet */
1106                 ret = internal_conf->process_type == RTE_PROC_PRIMARY ?
1107                                 eal_hugepage_info_init() :
1108                                 eal_hugepage_info_read();
1109                 if (ret < 0) {
1110                         rte_eal_init_alert("Cannot get hugepage information.");
1111                         rte_errno = EACCES;
1112                         rte_atomic32_clear(&run_once);
1113                         return -1;
1114                 }
1115         }
1116
1117         if (internal_conf->memory == 0 && internal_conf->force_sockets == 0) {
1118                 if (internal_conf->no_hugetlbfs)
1119                         internal_conf->memory = MEMSIZE_IF_NO_HUGE_PAGE;
1120         }
1121
1122         if (internal_conf->vmware_tsc_map == 1) {
1123 #ifdef RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT
1124                 rte_cycles_vmware_tsc_map = 1;
1125                 RTE_LOG (DEBUG, EAL, "Using VMWARE TSC MAP, "
1126                                 "you must have monitor_control.pseudo_perfctr = TRUE\n");
1127 #else
1128                 RTE_LOG (WARNING, EAL, "Ignoring --vmware-tsc-map because "
1129                                 "RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT is not set\n");
1130 #endif
1131         }
1132
1133         if (rte_eal_log_init(logid, internal_conf->syslog_facility) < 0) {
1134                 rte_eal_init_alert("Cannot init logging.");
1135                 rte_errno = ENOMEM;
1136                 rte_atomic32_clear(&run_once);
1137                 return -1;
1138         }
1139
1140 #ifdef VFIO_PRESENT
1141         if (rte_eal_vfio_setup() < 0) {
1142                 rte_eal_init_alert("Cannot init VFIO");
1143                 rte_errno = EAGAIN;
1144                 rte_atomic32_clear(&run_once);
1145                 return -1;
1146         }
1147 #endif
1148         /* in secondary processes, memory init may allocate additional fbarrays
1149          * not present in primary processes, so to avoid any potential issues,
1150          * initialize memzones first.
1151          */
1152         if (rte_eal_memzone_init() < 0) {
1153                 rte_eal_init_alert("Cannot init memzone");
1154                 rte_errno = ENODEV;
1155                 return -1;
1156         }
1157
1158         if (rte_eal_memory_init() < 0) {
1159                 rte_eal_init_alert("Cannot init memory");
1160                 rte_errno = ENOMEM;
1161                 return -1;
1162         }
1163
1164         /* the directories are locked during eal_hugepage_info_init */
1165         eal_hugedirs_unlock();
1166
1167         if (rte_eal_malloc_heap_init() < 0) {
1168                 rte_eal_init_alert("Cannot init malloc heap");
1169                 rte_errno = ENODEV;
1170                 return -1;
1171         }
1172
1173         if (rte_eal_tailqs_init() < 0) {
1174                 rte_eal_init_alert("Cannot init tail queues for objects");
1175                 rte_errno = EFAULT;
1176                 return -1;
1177         }
1178
1179         if (rte_eal_timer_init() < 0) {
1180                 rte_eal_init_alert("Cannot init HPET or TSC timers");
1181                 rte_errno = ENOTSUP;
1182                 return -1;
1183         }
1184
1185         eal_check_mem_on_local_socket();
1186
1187         eal_thread_init_master(config->master_lcore);
1188
1189         ret = eal_thread_dump_affinity(cpuset, sizeof(cpuset));
1190
1191         RTE_LOG(DEBUG, EAL, "Master lcore %u is ready (tid=%zx;cpuset=[%s%s])\n",
1192                 config->master_lcore, (uintptr_t)thread_id, cpuset,
1193                 ret == 0 ? "" : "...");
1194
1195         RTE_LCORE_FOREACH_SLAVE(i) {
1196
1197                 /*
1198                  * create communication pipes between master thread
1199                  * and children
1200                  */
1201                 if (pipe(lcore_config[i].pipe_master2slave) < 0)
1202                         rte_panic("Cannot create pipe\n");
1203                 if (pipe(lcore_config[i].pipe_slave2master) < 0)
1204                         rte_panic("Cannot create pipe\n");
1205
1206                 lcore_config[i].state = WAIT;
1207
1208                 /* create a thread for each lcore */
1209                 ret = pthread_create(&lcore_config[i].thread_id, NULL,
1210                                      eal_thread_loop, NULL);
1211                 if (ret != 0)
1212                         rte_panic("Cannot create thread\n");
1213
1214                 /* Set thread_name for aid in debugging. */
1215                 snprintf(thread_name, sizeof(thread_name),
1216                         "lcore-slave-%d", i);
1217                 ret = rte_thread_setname(lcore_config[i].thread_id,
1218                                                 thread_name);
1219                 if (ret != 0)
1220                         RTE_LOG(DEBUG, EAL,
1221                                 "Cannot set name for lcore thread\n");
1222         }
1223
1224         /*
1225          * Launch a dummy function on all slave lcores, so that master lcore
1226          * knows they are all ready when this function returns.
1227          */
1228         rte_eal_mp_remote_launch(sync_func, NULL, SKIP_MASTER);
1229         rte_eal_mp_wait_lcore();
1230
1231         /* initialize services so vdevs register service during bus_probe. */
1232         ret = rte_service_init();
1233         if (ret) {
1234                 rte_eal_init_alert("rte_service_init() failed");
1235                 rte_errno = ENOEXEC;
1236                 return -1;
1237         }
1238
1239         /* Probe all the buses and devices/drivers on them */
1240         if (rte_bus_probe()) {
1241                 rte_eal_init_alert("Cannot probe devices");
1242                 rte_errno = ENOTSUP;
1243                 return -1;
1244         }
1245
1246 #ifdef VFIO_PRESENT
1247         /* Register mp action after probe() so that we got enough info */
1248         if (rte_vfio_is_enabled("vfio") && vfio_mp_sync_setup() < 0)
1249                 return -1;
1250 #endif
1251
1252         /* initialize default service/lcore mappings and start running. Ignore
1253          * -ENOTSUP, as it indicates no service coremask passed to EAL.
1254          */
1255         ret = rte_service_start_with_defaults();
1256         if (ret < 0 && ret != -ENOTSUP) {
1257                 rte_errno = ENOEXEC;
1258                 return -1;
1259         }
1260
1261         /*
1262          * Clean up unused files in runtime directory. We do this at the end of
1263          * init and not at the beginning because we want to clean stuff up
1264          * whether we are primary or secondary process, but we cannot remove
1265          * primary process' files because secondary should be able to run even
1266          * if primary process is dead.
1267          *
1268          * In no_shconf mode, no runtime directory is created in the first
1269          * place, so no cleanup needed.
1270          */
1271         if (!internal_conf->no_shconf && eal_clean_runtime_dir() < 0) {
1272                 rte_eal_init_alert("Cannot clear runtime directory");
1273                 return -1;
1274         }
1275         if (!internal_conf->no_telemetry) {
1276                 const char *error_str = NULL;
1277                 if (rte_telemetry_init(rte_eal_get_runtime_dir(),
1278                                 &internal_conf->ctrl_cpuset, &error_str)
1279                                 != 0) {
1280                         rte_eal_init_alert(error_str);
1281                         return -1;
1282                 }
1283                 if (error_str != NULL)
1284                         RTE_LOG(NOTICE, EAL, "%s\n", error_str);
1285         }
1286
1287         eal_mcfg_complete();
1288
1289         return fctret;
1290 }
1291
1292 static int
1293 mark_freeable(const struct rte_memseg_list *msl, const struct rte_memseg *ms,
1294                 void *arg __rte_unused)
1295 {
1296         /* ms is const, so find this memseg */
1297         struct rte_memseg *found;
1298
1299         if (msl->external)
1300                 return 0;
1301
1302         found = rte_mem_virt2memseg(ms->addr, msl);
1303
1304         found->flags &= ~RTE_MEMSEG_FLAG_DO_NOT_FREE;
1305
1306         return 0;
1307 }
1308
1309 int
1310 rte_eal_cleanup(void)
1311 {
1312         /* if we're in a primary process, we need to mark hugepages as freeable
1313          * so that finalization can release them back to the system.
1314          */
1315         struct internal_config *internal_conf =
1316                 eal_get_internal_configuration();
1317
1318         if (rte_eal_process_type() == RTE_PROC_PRIMARY)
1319                 rte_memseg_walk(mark_freeable, NULL);
1320         rte_service_finalize();
1321         rte_mp_channel_cleanup();
1322         rte_trace_save();
1323         eal_trace_fini();
1324         eal_cleanup_config(internal_conf);
1325         return 0;
1326 }
1327
1328 int rte_eal_create_uio_dev(void)
1329 {
1330         const struct internal_config *internal_conf =
1331                 eal_get_internal_configuration();
1332
1333         return internal_conf->create_uio_dev;
1334 }
1335
1336 enum rte_intr_mode
1337 rte_eal_vfio_intr_mode(void)
1338 {
1339         const struct internal_config *internal_conf =
1340                 eal_get_internal_configuration();
1341
1342         return internal_conf->vfio_intr_mode;
1343 }
1344
1345 int
1346 rte_eal_check_module(const char *module_name)
1347 {
1348         char sysfs_mod_name[PATH_MAX];
1349         struct stat st;
1350         int n;
1351
1352         if (NULL == module_name)
1353                 return -1;
1354
1355         /* Check if there is sysfs mounted */
1356         if (stat("/sys/module", &st) != 0) {
1357                 RTE_LOG(DEBUG, EAL, "sysfs is not mounted! error %i (%s)\n",
1358                         errno, strerror(errno));
1359                 return -1;
1360         }
1361
1362         /* A module might be built-in, therefore try sysfs */
1363         n = snprintf(sysfs_mod_name, PATH_MAX, "/sys/module/%s", module_name);
1364         if (n < 0 || n > PATH_MAX) {
1365                 RTE_LOG(DEBUG, EAL, "Could not format module path\n");
1366                 return -1;
1367         }
1368
1369         if (stat(sysfs_mod_name, &st) != 0) {
1370                 RTE_LOG(DEBUG, EAL, "Module %s not found! error %i (%s)\n",
1371                         sysfs_mod_name, errno, strerror(errno));
1372                 return 0;
1373         }
1374
1375         /* Module has been found */
1376         return 1;
1377 }