1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2014 Intel Corporation.
3 * Copyright(c) 2014 6WIND S.A.
22 #include <rte_lcore.h>
23 #include <rte_debug.h>
24 #include <rte_string_fns.h>
28 #define DEFAULT_MEM_SIZE "18"
29 #define mp_flag "--proc-type=secondary"
30 #define no_hpet "--no-hpet"
31 #define no_huge "--no-huge"
32 #define no_shconf "--no-shconf"
33 #define pci_whitelist "--pci-whitelist"
35 #define memtest "memtest"
36 #define memtest1 "memtest1"
37 #define memtest2 "memtest2"
38 #define SOCKET_MEM_STRLEN (RTE_MAX_NUMA_NODES * 20)
39 #define launch_proc(ARGV) process_dup(ARGV, \
40 sizeof(ARGV)/(sizeof(ARGV[0])), __func__)
42 enum hugepage_action {
43 HUGEPAGE_CHECK_EXISTS = 0,
44 HUGEPAGE_CHECK_LOCKED,
49 /* if string contains a hugepage path */
51 get_hugepage_path(char * src, int src_len, char * dst, int dst_len)
54 char *tokens[NUM_TOKENS];
56 /* if we couldn't properly split the string */
57 if (rte_strsplit(src, src_len, tokens, NUM_TOKENS, ' ') < NUM_TOKENS)
60 if (strncmp(tokens[2], "hugetlbfs", sizeof("hugetlbfs")) == 0) {
61 strlcpy(dst, tokens[1], dst_len);
68 * Cycles through hugepage directories and looks for hugepage
69 * files associated with a given prefix. Depending on value of
70 * action, the hugepages are checked if they exist, checked if
71 * they can be locked, or are simply deleted.
73 * Returns 1 if it finds at least one hugepage matching the action
74 * Returns 0 if no matching hugepages were found
75 * Returns -1 if it encounters an error
78 process_hugefiles(const char * prefix, enum hugepage_action action)
80 FILE * hugedir_handle = NULL;
81 DIR * hugepage_dir = NULL;
82 struct dirent *dirent = NULL;
84 char hugefile_prefix[PATH_MAX] = {0};
85 char hugedir[PATH_MAX] = {0};
86 char line[PATH_MAX] = {0};
88 int fd, lck_result, result = 0;
90 const int prefix_len = snprintf(hugefile_prefix,
91 sizeof(hugefile_prefix), "%smap_", prefix);
92 if (prefix_len <= 0 || prefix_len >= (int)sizeof(hugefile_prefix)
93 || prefix_len >= (int)sizeof(dirent->d_name)) {
94 printf("Error creating hugefile filename prefix\n");
98 /* get hugetlbfs mountpoints from /proc/mounts */
99 hugedir_handle = fopen("/proc/mounts", "r");
101 if (hugedir_handle == NULL) {
102 printf("Error parsing /proc/mounts!\n");
106 /* read and parse script output */
107 while (fgets(line, sizeof(line), hugedir_handle) != NULL) {
109 /* check if we have a hugepage filesystem path */
110 if (!get_hugepage_path(line, sizeof(line), hugedir, sizeof(hugedir)))
113 /* check if directory exists */
114 if ((hugepage_dir = opendir(hugedir)) == NULL) {
115 fclose(hugedir_handle);
116 printf("Error reading %s: %s\n", hugedir, strerror(errno));
120 while ((dirent = readdir(hugepage_dir)) != NULL) {
121 if (memcmp(dirent->d_name, hugefile_prefix, prefix_len) != 0)
125 case HUGEPAGE_CHECK_EXISTS:
127 /* file exists, return */
132 case HUGEPAGE_DELETE:
134 char file_path[PATH_MAX] = {0};
136 snprintf(file_path, sizeof(file_path),
137 "%s/%s", hugedir, dirent->d_name);
140 if (remove(file_path) < 0) {
141 printf("Error deleting %s - %s!\n",
142 dirent->d_name, strerror(errno));
143 closedir(hugepage_dir);
150 case HUGEPAGE_CHECK_LOCKED:
152 /* try and lock the file */
153 fd = openat(dirfd(hugepage_dir), dirent->d_name, O_RDONLY);
155 /* this shouldn't happen */
157 printf("Error opening %s - %s!\n",
158 dirent->d_name, strerror(errno));
159 closedir(hugepage_dir);
164 /* non-blocking lock */
165 lck_result = flock(fd, LOCK_EX | LOCK_NB);
167 /* if lock succeeds, there's something wrong */
168 if (lck_result != -1) {
171 /* unlock the resulting lock */
174 closedir(hugepage_dir);
181 /* shouldn't happen */
186 } /* read hugepage directory */
187 closedir(hugepage_dir);
188 } /* read /proc/mounts */
190 fclose(hugedir_handle);
194 #ifdef RTE_EXEC_ENV_LINUX
196 * count the number of "node*" files in /sys/devices/system/node/
199 get_number_of_sockets(void)
201 struct dirent *dirent = NULL;
202 const char * nodedir = "/sys/devices/system/node/";
206 /* check if directory exists */
207 if ((dir = opendir(nodedir)) == NULL) {
208 /* if errno==ENOENT this means we don't have NUMA support */
209 if (errno == ENOENT) {
210 printf("No NUMA nodes detected: assuming 1 available socket\n");
213 printf("Error opening %s: %s\n", nodedir, strerror(errno));
217 while ((dirent = readdir(dir)) != NULL)
218 if (strncmp(dirent->d_name, "node", sizeof("node") - 1) == 0)
227 * Test that the app doesn't run with invalid whitelist option.
228 * Final tests ensures it does run with valid options as sanity check (one
229 * test for with Domain+BDF, second for just with BDF)
232 test_whitelist_flag(void)
235 #ifdef RTE_EXEC_ENV_FREEBSD
236 /* BSD target doesn't support prefixes at this point */
237 const char * prefix = "";
239 char prefix[PATH_MAX], tmp[PATH_MAX];
240 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
241 printf("Error - unable to get current prefix!\n");
244 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
247 const char *wlinval[][11] = {
248 {prgname, prefix, mp_flag,
249 pci_whitelist, "error", "", ""},
250 {prgname, prefix, mp_flag,
251 pci_whitelist, "0:0:0", "", ""},
252 {prgname, prefix, mp_flag,
253 pci_whitelist, "0:error:0.1", "", ""},
254 {prgname, prefix, mp_flag,
255 pci_whitelist, "0:0:0.1error", "", ""},
256 {prgname, prefix, mp_flag,
257 pci_whitelist, "error0:0:0.1", "", ""},
258 {prgname, prefix, mp_flag,
259 pci_whitelist, "0:0:0.1.2", "", ""},
261 /* Test with valid whitelist option */
262 const char *wlval1[] = {prgname, prefix, mp_flag,
263 pci_whitelist, "00FF:09:0B.3"};
264 const char *wlval2[] = {prgname, prefix, mp_flag,
265 pci_whitelist, "09:0B.3", pci_whitelist, "0a:0b.1"};
266 const char *wlval3[] = {prgname, prefix, mp_flag,
267 pci_whitelist, "09:0B.3,type=test",
268 pci_whitelist, "08:00.1,type=normal",
271 for (i = 0; i < sizeof(wlinval) / sizeof(wlinval[0]); i++) {
272 if (launch_proc(wlinval[i]) == 0) {
273 printf("Error - process did run ok with invalid "
274 "whitelist parameter\n");
278 if (launch_proc(wlval1) != 0 ) {
279 printf("Error - process did not run ok with valid whitelist\n");
282 if (launch_proc(wlval2) != 0 ) {
283 printf("Error - process did not run ok with valid whitelist value set\n");
286 if (launch_proc(wlval3) != 0 ) {
287 printf("Error - process did not run ok with valid whitelist + args\n");
295 * Test that the app doesn't run with invalid blacklist option.
296 * Final test ensures it does run with valid options as sanity check
299 test_invalid_b_flag(void)
301 #ifdef RTE_EXEC_ENV_FREEBSD
302 /* BSD target doesn't support prefixes at this point */
303 const char * prefix = "";
305 char prefix[PATH_MAX], tmp[PATH_MAX];
306 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
307 printf("Error - unable to get current prefix!\n");
310 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
313 const char *blinval[][9] = {
314 {prgname, prefix, mp_flag, "-b", "error"},
315 {prgname, prefix, mp_flag, "-b", "0:0:0"},
316 {prgname, prefix, mp_flag, "-b", "0:error:0.1"},
317 {prgname, prefix, mp_flag, "-b", "0:0:0.1error"},
318 {prgname, prefix, mp_flag, "-b", "error0:0:0.1"},
319 {prgname, prefix, mp_flag, "-b", "0:0:0.1.2"},
321 /* Test with valid blacklist option */
322 const char *blval[] = {prgname, prefix, mp_flag,
327 for (i = 0; i != sizeof (blinval) / sizeof (blinval[0]); i++) {
328 if (launch_proc(blinval[i]) == 0) {
329 printf("Error - process did run ok with invalid "
330 "blacklist parameter\n");
334 if (launch_proc(blval) != 0) {
335 printf("Error - process did not run ok with valid blacklist value\n");
342 * Test that the app doesn't run with invalid vdev option.
343 * Final test ensures it does run with valid options as sanity check
346 test_invalid_vdev_flag(void)
348 #ifdef RTE_LIBRTE_PMD_RING
349 #ifdef RTE_EXEC_ENV_FREEBSD
350 /* BSD target doesn't support prefixes at this point, and we also need to
351 * run another primary process here */
352 const char * prefix = no_shconf;
354 const char * prefix = "--file-prefix=vdev";
357 /* Test with invalid vdev option */
358 const char *vdevinval[] = {prgname, prefix, no_huge,
361 /* Test with valid vdev option */
362 const char *vdevval1[] = {prgname, prefix, no_huge,
365 const char *vdevval2[] = {prgname, prefix, no_huge,
366 vdev, "net_ring0,args=test"};
368 const char *vdevval3[] = {prgname, prefix, no_huge,
369 vdev, "net_ring0,nodeaction=r1:0:CREATE"};
371 if (launch_proc(vdevinval) == 0) {
372 printf("Error - process did run ok with invalid "
377 if (launch_proc(vdevval1) != 0) {
378 printf("Error - process did not run ok with valid vdev value\n");
382 if (launch_proc(vdevval2) != 0) {
383 printf("Error - process did not run ok with valid vdev value,"
384 "with dummy args\n");
388 if (launch_proc(vdevval3) != 0) {
389 printf("Error - process did not run ok with valid vdev value,"
390 "with valid args\n");
400 * Test that the app doesn't run with invalid -r option.
403 test_invalid_r_flag(void)
405 #ifdef RTE_EXEC_ENV_FREEBSD
406 /* BSD target doesn't support prefixes at this point */
407 const char * prefix = "";
409 char prefix[PATH_MAX], tmp[PATH_MAX];
410 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
411 printf("Error - unable to get current prefix!\n");
414 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
417 const char *rinval[][9] = {
418 {prgname, prefix, mp_flag, "-r", "error"},
419 {prgname, prefix, mp_flag, "-r", "0"},
420 {prgname, prefix, mp_flag, "-r", "-1"},
421 {prgname, prefix, mp_flag, "-r", "17"},
423 /* Test with valid blacklist option */
424 const char *rval[] = {prgname, prefix, mp_flag, "-r", "16"};
428 for (i = 0; i != sizeof (rinval) / sizeof (rinval[0]); i++) {
429 if (launch_proc(rinval[i]) == 0) {
430 printf("Error - process did run ok with invalid "
431 "-r (rank) parameter\n");
435 if (launch_proc(rval) != 0) {
436 printf("Error - process did not run ok with valid -r (rank) value\n");
443 * Test that the app doesn't run without the coremask/corelist flags. In all cases
444 * should give an error and fail to run
447 test_missing_c_flag(void)
449 #ifdef RTE_EXEC_ENV_FREEBSD
450 /* BSD target doesn't support prefixes at this point */
451 const char * prefix = "";
453 char prefix[PATH_MAX], tmp[PATH_MAX];
454 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
455 printf("Error - unable to get current prefix!\n");
458 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
461 /* -c flag but no coremask value */
462 const char *argv1[] = { prgname, prefix, mp_flag, "-c"};
463 /* No -c, -l or --lcores flag at all */
464 const char *argv2[] = { prgname, prefix, mp_flag};
465 /* bad coremask value */
466 const char *argv3[] = { prgname, prefix, mp_flag,
468 /* sanity check of tests - valid coremask value */
469 const char *argv4[] = { prgname, prefix, mp_flag,
471 /* -l flag but no corelist value */
472 const char *argv5[] = { prgname, prefix, mp_flag,
474 const char *argv6[] = { prgname, prefix, mp_flag,
476 /* bad corelist values */
477 const char *argv7[] = { prgname, prefix, mp_flag,
479 const char *argv8[] = { prgname, prefix, mp_flag,
481 const char *argv9[] = { prgname, prefix, mp_flag,
483 const char *argv10[] = { prgname, prefix, mp_flag,
485 /* core number is negative value */
486 const char * const argv11[] = { prgname, prefix, mp_flag,
488 const char * const argv12[] = { prgname, prefix, mp_flag,
490 /* core number is maximum value */
491 const char * const argv13[] = { prgname, prefix, mp_flag,
492 "-l", RTE_STR(RTE_MAX_LCORE) };
493 const char * const argv14[] = { prgname, prefix, mp_flag,
494 "-l", "1-"RTE_STR(RTE_MAX_LCORE) };
495 /* sanity check test - valid corelist value */
496 const char * const argv15[] = { prgname, prefix, mp_flag,
499 /* --lcores flag but no lcores value */
500 const char * const argv16[] = { prgname, prefix, mp_flag,
502 const char * const argv17[] = { prgname, prefix, mp_flag,
504 /* bad lcores value */
505 const char * const argv18[] = { prgname, prefix, mp_flag,
506 "--lcores", "1-3-5" };
507 const char * const argv19[] = { prgname, prefix, mp_flag,
508 "--lcores", "0-1,,2" };
509 const char * const argv20[] = { prgname, prefix, mp_flag,
510 "--lcores", "0-,1" };
511 const char * const argv21[] = { prgname, prefix, mp_flag,
512 "--lcores", "(0-,2-4)" };
513 const char * const argv22[] = { prgname, prefix, mp_flag,
514 "--lcores", "(-1,2)" };
515 const char * const argv23[] = { prgname, prefix, mp_flag,
516 "--lcores", "(2-4)@(2-4-6)" };
517 const char * const argv24[] = { prgname, prefix, mp_flag,
518 "--lcores", "(a,2)" };
519 const char * const argv25[] = { prgname, prefix, mp_flag,
520 "--lcores", "1-3@(1,3)" };
521 const char * const argv26[] = { prgname, prefix, mp_flag,
522 "--lcores", "3@((1,3)" };
523 const char * const argv27[] = { prgname, prefix, mp_flag,
524 "--lcores", "(4-7)=(1,3)" };
525 const char * const argv28[] = { prgname, prefix, mp_flag,
526 "--lcores", "[4-7]@(1,3)" };
527 /* sanity check of tests - valid lcores value */
528 const char * const argv29[] = { prgname, prefix, mp_flag,
530 "0-1,2@(5-7),(3-5)@(0,2),(0,6),7"};
532 if (launch_proc(argv2) != 0) {
534 "process did not run ok when missing -c flag\n");
538 if (launch_proc(argv1) == 0
539 || launch_proc(argv3) == 0) {
541 "process ran without error with invalid -c flag\n");
544 if (launch_proc(argv4) != 0) {
546 "process did not run ok with valid coremask value\n");
551 if (launch_proc(argv5) == 0
552 || launch_proc(argv6) == 0
553 || launch_proc(argv7) == 0
554 || launch_proc(argv8) == 0
555 || launch_proc(argv9) == 0
556 || launch_proc(argv10) == 0
557 || launch_proc(argv11) == 0
558 || launch_proc(argv12) == 0
559 || launch_proc(argv13) == 0
560 || launch_proc(argv14) == 0) {
562 "process ran without error with invalid -l flag\n");
565 if (rte_lcore_is_enabled(0) && rte_lcore_is_enabled(1) &&
566 rte_lcore_is_enabled(2) && rte_lcore_is_enabled(3) &&
567 launch_proc(argv15) != 0) {
569 "process did not run ok with valid corelist value\n");
573 /* start --lcores tests */
574 if (launch_proc(argv16) == 0 || launch_proc(argv17) == 0 ||
575 launch_proc(argv18) == 0 || launch_proc(argv19) == 0 ||
576 launch_proc(argv20) == 0 || launch_proc(argv21) == 0 ||
577 launch_proc(argv22) == 0 || launch_proc(argv23) == 0 ||
578 launch_proc(argv24) == 0 || launch_proc(argv25) == 0 ||
579 launch_proc(argv26) == 0 || launch_proc(argv27) == 0 ||
580 launch_proc(argv28) == 0) {
582 "process ran without error with invalid --lcore flag\n");
586 if (rte_lcore_is_enabled(0) && rte_lcore_is_enabled(1) &&
587 rte_lcore_is_enabled(2) && rte_lcore_is_enabled(3) &&
588 rte_lcore_is_enabled(3) && rte_lcore_is_enabled(5) &&
589 rte_lcore_is_enabled(4) && rte_lcore_is_enabled(7) &&
590 launch_proc(argv29) != 0) {
592 "process did not run ok with valid corelist value\n");
600 * Test --master-lcore option with matching coremask
603 test_master_lcore_flag(void)
605 #ifdef RTE_EXEC_ENV_FREEBSD
606 /* BSD target doesn't support prefixes at this point */
607 const char *prefix = "";
609 char prefix[PATH_MAX], tmp[PATH_MAX];
610 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
611 printf("Error - unable to get current prefix!\n");
614 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
617 if (!rte_lcore_is_enabled(0) || !rte_lcore_is_enabled(1))
620 /* --master-lcore flag but no value */
621 const char *argv1[] = { prgname, prefix, mp_flag,
622 "-c", "3", "--master-lcore"};
623 /* --master-lcore flag with invalid value */
624 const char *argv2[] = { prgname, prefix, mp_flag,
625 "-c", "3", "--master-lcore", "-1"};
626 const char *argv3[] = { prgname, prefix, mp_flag,
627 "-c", "3", "--master-lcore", "X"};
628 /* master lcore not in coremask */
629 const char *argv4[] = { prgname, prefix, mp_flag,
630 "-c", "3", "--master-lcore", "2"};
632 const char *argv5[] = { prgname, prefix, mp_flag,
633 "-c", "3", "--master-lcore", "1"};
634 /* valid value set before coremask */
635 const char *argv6[] = { prgname, prefix, mp_flag,
636 "--master-lcore", "1", "-c", "3"};
638 if (launch_proc(argv1) == 0
639 || launch_proc(argv2) == 0
640 || launch_proc(argv3) == 0
641 || launch_proc(argv4) == 0) {
642 printf("Error - process ran without error with wrong --master-lcore\n");
645 if (launch_proc(argv5) != 0
646 || launch_proc(argv6) != 0) {
647 printf("Error - process did not run ok with valid --master-lcore\n");
654 * Test that the app doesn't run with invalid -n flag option.
655 * Final test ensures it does run with valid options as sanity check
656 * Since -n is not compulsory for MP, we instead use --no-huge and --no-shconf
660 test_invalid_n_flag(void)
662 #ifdef RTE_EXEC_ENV_FREEBSD
663 /* BSD target doesn't support prefixes at this point */
664 const char * prefix = "";
666 char prefix[PATH_MAX], tmp[PATH_MAX];
667 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
668 printf("Error - unable to get current prefix!\n");
671 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
674 /* -n flag but no value */
675 const char *argv1[] = { prgname, prefix, no_huge, no_shconf,
677 /* bad numeric value */
678 const char *argv2[] = { prgname, prefix, no_huge, no_shconf,
680 /* zero is invalid */
681 const char *argv3[] = { prgname, prefix, no_huge, no_shconf,
683 /* sanity test - check with good value */
684 const char *argv4[] = { prgname, prefix, no_huge, no_shconf,
686 /* sanity test - check with no -n flag */
687 const char *argv5[] = { prgname, prefix, no_huge, no_shconf};
689 if (launch_proc(argv1) == 0
690 || launch_proc(argv2) == 0
691 || launch_proc(argv3) == 0) {
692 printf("Error - process ran without error when"
693 "invalid -n flag\n");
696 if (launch_proc(argv4) != 0) {
697 printf("Error - process did not run ok with valid num-channel value\n");
700 if (launch_proc(argv5) != 0) {
701 printf("Error - process did not run ok without -n flag\n");
709 * Test that the app runs with HPET, and without HPET
712 test_no_hpet_flag(void)
714 char prefix[PATH_MAX] = "";
716 #ifdef RTE_EXEC_ENV_FREEBSD
720 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
721 printf("Error - unable to get current prefix!\n");
724 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
728 const char *argv1[] = {prgname, prefix, mp_flag, no_hpet};
729 /* Without --no-hpet */
730 const char *argv2[] = {prgname, prefix, mp_flag};
732 if (launch_proc(argv1) != 0) {
733 printf("Error - process did not run ok with --no-hpet flag\n");
736 if (launch_proc(argv2) != 0) {
737 printf("Error - process did not run ok without --no-hpet flag\n");
744 * Test that the app runs with --no-huge and doesn't run when --socket-mem are
745 * specified with --no-huge.
748 test_no_huge_flag(void)
750 #ifdef RTE_EXEC_ENV_FREEBSD
751 /* BSD target doesn't support prefixes at this point, and we also need to
752 * run another primary process here */
753 const char * prefix = no_shconf;
755 const char * prefix = "--file-prefix=nohuge";
759 const char *argv1[] = {prgname, prefix, no_huge};
760 /* With --no-huge and -m */
761 const char *argv2[] = {prgname, prefix, no_huge,
762 "-m", DEFAULT_MEM_SIZE};
764 /* With --no-huge and --socket-mem */
765 const char *argv3[] = {prgname, prefix, no_huge,
766 "--socket-mem=" DEFAULT_MEM_SIZE};
767 /* With --no-huge, -m and --socket-mem */
768 const char *argv4[] = {prgname, prefix, no_huge,
769 "-m", DEFAULT_MEM_SIZE, "--socket-mem=" DEFAULT_MEM_SIZE};
770 if (launch_proc(argv1) != 0) {
771 printf("Error - process did not run ok with --no-huge flag\n");
774 if (launch_proc(argv2) != 0) {
775 printf("Error - process did not run ok with --no-huge and -m flags\n");
778 #ifdef RTE_EXEC_ENV_FREEBSD
779 /* BSD target does not support NUMA, hence no --socket-mem tests */
783 if (launch_proc(argv3) == 0) {
784 printf("Error - process run ok with --no-huge and --socket-mem "
788 if (launch_proc(argv4) == 0) {
789 printf("Error - process run ok with --no-huge, -m and "
790 "--socket-mem flags\n");
797 test_misc_flags(void)
799 char hugepath[PATH_MAX] = {0};
800 #ifdef RTE_EXEC_ENV_FREEBSD
801 /* BSD target doesn't support prefixes at this point */
802 const char * prefix = "";
803 const char * nosh_prefix = "";
805 char prefix[PATH_MAX], tmp[PATH_MAX];
806 const char * nosh_prefix = "--file-prefix=noshconf";
807 FILE * hugedir_handle = NULL;
808 char line[PATH_MAX] = {0};
809 unsigned i, isempty = 1;
810 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
811 printf("Error - unable to get current prefix!\n");
814 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
817 * get first valid hugepage path
820 /* get hugetlbfs mountpoints from /proc/mounts */
821 hugedir_handle = fopen("/proc/mounts", "r");
823 if (hugedir_handle == NULL) {
824 printf("Error opening /proc/mounts!\n");
828 /* read /proc/mounts */
829 while (fgets(line, sizeof(line), hugedir_handle) != NULL) {
831 /* find first valid hugepath */
832 if (get_hugepage_path(line, sizeof(line), hugepath, sizeof(hugepath)))
836 fclose(hugedir_handle);
838 /* check if path is not empty */
839 for (i = 0; i < sizeof(hugepath); i++)
840 if (hugepath[i] != '\0')
844 printf("No mounted hugepage dir found!\n");
850 /* check that some general flags don't prevent things from working.
851 * All cases, apart from the first, app should run.
852 * No further testing of output done.
854 /* sanity check - failure with invalid option */
855 const char *argv0[] = {prgname, prefix, mp_flag, "--invalid-opt"};
858 const char *argv1[] = {prgname, prefix, mp_flag, "--no-pci"};
860 const char *argv2[] = {prgname, prefix, mp_flag, "-v"};
861 /* With valid --syslog */
862 const char *argv3[] = {prgname, prefix, mp_flag,
863 "--syslog", "syslog"};
864 /* With empty --syslog (should fail) */
865 const char *argv4[] = {prgname, prefix, mp_flag, "--syslog"};
866 /* With invalid --syslog */
867 const char *argv5[] = {prgname, prefix, mp_flag, "--syslog", "error"};
868 /* With no-sh-conf, also use no-huge to ensure this test runs on BSD */
869 const char *argv6[] = {prgname, "-m", DEFAULT_MEM_SIZE,
870 no_shconf, nosh_prefix, no_huge};
872 /* With --huge-dir */
873 const char *argv7[] = {prgname, "-m", DEFAULT_MEM_SIZE,
874 "--file-prefix=hugedir", "--huge-dir", hugepath};
875 /* With empty --huge-dir (should fail) */
876 const char *argv8[] = {prgname, "-m", DEFAULT_MEM_SIZE,
877 "--file-prefix=hugedir", "--huge-dir"};
878 /* With invalid --huge-dir */
879 const char *argv9[] = {prgname, "-m", DEFAULT_MEM_SIZE,
880 "--file-prefix=hugedir", "--huge-dir", "invalid"};
881 /* Secondary process with invalid --huge-dir (should run as flag has no
882 * effect on secondary processes) */
883 const char *argv10[] = {prgname, prefix, mp_flag,
884 "--huge-dir", "invalid"};
886 /* try running with base-virtaddr param */
887 const char *argv11[] = {prgname, "--file-prefix=virtaddr",
888 "--base-virtaddr=0x12345678"};
890 /* try running with --vfio-intr INTx flag */
891 const char *argv12[] = {prgname, "--file-prefix=intr",
892 "--vfio-intr=legacy"};
894 /* try running with --vfio-intr MSI flag */
895 const char *argv13[] = {prgname, "--file-prefix=intr",
898 /* try running with --vfio-intr MSI-X flag */
899 const char *argv14[] = {prgname, "--file-prefix=intr",
902 /* try running with --vfio-intr invalid flag */
903 const char *argv15[] = {prgname, "--file-prefix=intr",
904 "--vfio-intr=invalid"};
906 /* run all tests also applicable to FreeBSD first */
908 if (launch_proc(argv0) == 0) {
909 printf("Error - process ran ok with invalid flag\n");
912 if (launch_proc(argv1) != 0) {
913 printf("Error - process did not run ok with --no-pci flag\n");
916 if (launch_proc(argv2) != 0) {
917 printf("Error - process did not run ok with -v flag\n");
920 if (launch_proc(argv6) != 0) {
921 printf("Error - process did not run ok with --no-shconf flag\n");
925 #ifdef RTE_EXEC_ENV_FREEBSD
926 /* no more tests to be done on FreeBSD */
930 if (launch_proc(argv3) != 0) {
931 printf("Error - process did not run ok with --syslog flag\n");
934 if (launch_proc(argv4) == 0) {
935 printf("Error - process run ok with empty --syslog flag\n");
938 if (launch_proc(argv5) == 0) {
939 printf("Error - process run ok with invalid --syslog flag\n");
942 if (launch_proc(argv7) != 0) {
943 printf("Error - process did not run ok with --huge-dir flag\n");
946 if (launch_proc(argv8) == 0) {
947 printf("Error - process run ok with empty --huge-dir flag\n");
950 if (launch_proc(argv9) == 0) {
951 printf("Error - process run ok with invalid --huge-dir flag\n");
954 if (launch_proc(argv10) != 0) {
955 printf("Error - secondary process did not run ok with invalid --huge-dir flag\n");
958 if (launch_proc(argv11) != 0) {
959 printf("Error - process did not run ok with --base-virtaddr parameter\n");
962 if (launch_proc(argv12) != 0) {
963 printf("Error - process did not run ok with "
964 "--vfio-intr INTx parameter\n");
967 if (launch_proc(argv13) != 0) {
968 printf("Error - process did not run ok with "
969 "--vfio-intr MSI parameter\n");
972 if (launch_proc(argv14) != 0) {
973 printf("Error - process did not run ok with "
974 "--vfio-intr MSI-X parameter\n");
977 if (launch_proc(argv15) == 0) {
978 printf("Error - process run ok with "
979 "--vfio-intr invalid parameter\n");
986 test_file_prefix(void)
989 * 1. check if current process hugefiles are locked
990 * 2. try to run secondary process without a corresponding primary process
991 * (while failing to run, it will also remove any unused hugepage files)
992 * 3. check if current process hugefiles are still in place and are locked
993 * 4. run a primary process with memtest1 prefix in default and legacy
995 * 5. check if memtest1 hugefiles are created in case of legacy mem
996 * mode, and deleted in case of default mem mode
997 * 6. run a primary process with memtest2 prefix in default and legacy
999 * 7. check that memtest2 hugefiles are present in the hugedir after a
1000 * run in legacy mode, and not present at all after run in default
1003 char prefix[PATH_MAX] = "";
1005 #ifdef RTE_EXEC_ENV_FREEBSD
1008 if (get_current_prefix(prefix, sizeof(prefix)) == NULL) {
1009 printf("Error - unable to get current prefix!\n");
1014 /* this should fail unless the test itself is run with "memtest" prefix */
1015 const char *argv0[] = {prgname, mp_flag, "-m",
1016 DEFAULT_MEM_SIZE, "--file-prefix=" memtest };
1018 /* primary process with memtest1 and default mem mode */
1019 const char *argv1[] = {prgname, "-m",
1020 DEFAULT_MEM_SIZE, "--file-prefix=" memtest1 };
1022 /* primary process with memtest1 and legacy mem mode */
1023 const char *argv2[] = {prgname, "-m",
1024 DEFAULT_MEM_SIZE, "--file-prefix=" memtest1,
1027 /* primary process with memtest2 and legacy mem mode */
1028 const char *argv3[] = {prgname, "-m",
1029 DEFAULT_MEM_SIZE, "--file-prefix=" memtest2,
1032 /* primary process with memtest2 and default mem mode */
1033 const char *argv4[] = {prgname, "-m",
1034 DEFAULT_MEM_SIZE, "--file-prefix=" memtest2 };
1036 /* primary process with --in-memory mode */
1037 const char * const argv5[] = {prgname, "-m",
1038 DEFAULT_MEM_SIZE, "--in-memory" };
1040 /* primary process with memtest1 and --in-memory mode */
1041 const char * const argv6[] = {prgname, "-m",
1042 DEFAULT_MEM_SIZE, "--in-memory",
1043 "--file-prefix=" memtest1 };
1045 /* primary process with parent file-prefix and --in-memory mode */
1046 const char * const argv7[] = {prgname, "-m",
1047 DEFAULT_MEM_SIZE, "--in-memory", "--file-prefix", prefix };
1049 /* primary process with memtest1 and --single-file-segments mode */
1050 const char * const argv8[] = {prgname, "-m",
1051 DEFAULT_MEM_SIZE, "--single-file-segments",
1052 "--file-prefix=" memtest1 };
1054 /* check if files for current prefix are present */
1055 if (process_hugefiles(prefix, HUGEPAGE_CHECK_EXISTS) != 1) {
1056 printf("Error - hugepage files for %s were not created!\n", prefix);
1060 /* checks if files for current prefix are locked */
1061 if (process_hugefiles(prefix, HUGEPAGE_CHECK_LOCKED) != 1) {
1062 printf("Error - hugepages for current process aren't locked!\n");
1066 /* check if files for secondary process are present */
1067 if (process_hugefiles(memtest, HUGEPAGE_CHECK_EXISTS) == 1) {
1068 /* check if they are not locked */
1069 if (process_hugefiles(memtest, HUGEPAGE_CHECK_LOCKED) == 1) {
1070 printf("Error - hugepages for current process are locked!\n");
1073 /* they aren't locked, delete them */
1075 if (process_hugefiles(memtest, HUGEPAGE_DELETE) != 1) {
1076 printf("Error - deleting hugepages failed!\n");
1082 if (launch_proc(argv0) == 0) {
1083 printf("Error - secondary process ran ok without primary process\n");
1087 /* check if files for current prefix are present */
1088 if (process_hugefiles(prefix, HUGEPAGE_CHECK_EXISTS) != 1) {
1089 printf("Error - hugepage files for %s were not created!\n", prefix);
1093 /* checks if files for current prefix are locked */
1094 if (process_hugefiles(prefix, HUGEPAGE_CHECK_LOCKED) != 1) {
1095 printf("Error - hugepages for current process aren't locked!\n");
1099 /* we're running this process in default memory mode, which means it
1100 * should clean up after itself on exit and leave no hugepages behind.
1102 if (launch_proc(argv1) != 0) {
1103 printf("Error - failed to run with --file-prefix=%s\n",
1108 /* check if memtest1_map0 is present */
1109 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1110 printf("Error - hugepage files for %s were not deleted!\n",
1115 /* now, we're running a process under the same prefix, but with legacy
1116 * mem mode - this should leave behind hugepage files.
1118 if (launch_proc(argv2) != 0) {
1119 printf("Error - failed to run with --file-prefix=%s\n",
1124 /* check if memtest1_map0 is present */
1125 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 1) {
1126 printf("Error - hugepage files for %s were not created!\n",
1131 if (launch_proc(argv3) != 0) {
1132 printf("Error - failed to run with --file-prefix=%s\n",
1137 /* check if hugefiles for memtest2 are present */
1138 if (process_hugefiles(memtest2, HUGEPAGE_CHECK_EXISTS) != 1) {
1139 printf("Error - hugepage files for %s were not created!\n",
1144 /* check if hugefiles for memtest1 are present */
1145 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1146 printf("Error - hugepage files for %s were not deleted!\n",
1151 /* this process will run in default mem mode, so it should not leave any
1152 * hugepage files behind.
1154 if (launch_proc(argv4) != 0) {
1155 printf("Error - failed to run with --file-prefix=%s\n",
1160 /* check if hugefiles for memtest2 are present */
1161 if (process_hugefiles(memtest2, HUGEPAGE_CHECK_EXISTS) != 0) {
1162 printf("Error - hugepage files for %s were not deleted!\n",
1167 /* check if hugefiles for memtest1 are present */
1168 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1169 printf("Error - hugepage files for %s were not deleted!\n",
1174 /* this process will run in --in-memory mode, so it should not leave any
1175 * hugepage files behind.
1178 /* test case to check eal-options with --in-memory mode */
1179 if (launch_proc(argv5) != 0) {
1180 printf("Error - failed to run with --in-memory mode\n");
1184 /*test case to check eal-options with --in-memory mode with
1185 * custom file-prefix.
1187 if (launch_proc(argv6) != 0) {
1188 printf("Error - failed to run with --in-memory mode\n");
1192 /* check if hugefiles for memtest1 are present */
1193 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1194 printf("Error - hugepage files for %s were created and not deleted!\n",
1199 /* test case to check eal-options with --in-memory mode with
1200 * parent file-prefix.
1202 if (launch_proc(argv7) != 0) {
1203 printf("Error - failed to run with --file-prefix=%s\n", prefix);
1207 /* this process will run in --single-file-segments mode,
1208 * so it should not leave any hugepage files behind.
1210 if (launch_proc(argv8) != 0) {
1211 printf("Error - failed to run with --single-file-segments mode\n");
1215 /* check if hugefiles for memtest1 are present */
1216 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1217 printf("Error - hugepage files for %s were not deleted!\n",
1226 * Tests for correct handling of -m and --socket-mem flags
1229 test_memory_flags(void)
1231 #ifdef RTE_EXEC_ENV_FREEBSD
1232 /* BSD target doesn't support prefixes at this point */
1233 const char * prefix = "";
1235 char prefix[PATH_MAX], tmp[PATH_MAX];
1236 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
1237 printf("Error - unable to get current prefix!\n");
1240 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
1243 /* valid -m flag and mp flag */
1244 const char *argv0[] = {prgname, prefix, mp_flag,
1245 "-m", DEFAULT_MEM_SIZE};
1248 const char *argv1[] = {prgname,
1249 "--file-prefix=" memtest, "-m", DEFAULT_MEM_SIZE};
1251 /* valid (zero) --socket-mem flag */
1252 const char *argv2[] = {prgname,
1253 "--file-prefix=" memtest, "--socket-mem=0,0,0,0"};
1255 /* invalid (incomplete) --socket-mem flag */
1256 const char *argv3[] = {prgname,
1257 "--file-prefix=" memtest, "--socket-mem=2,2,"};
1259 /* invalid (mixed with invalid data) --socket-mem flag */
1260 const char *argv4[] = {prgname,
1261 "--file-prefix=" memtest, "--socket-mem=2,2,Fred"};
1263 /* invalid (with numeric value as last character) --socket-mem flag */
1264 const char *argv5[] = {prgname,
1265 "--file-prefix=" memtest, "--socket-mem=2,2,Fred0"};
1267 /* invalid (with empty socket) --socket-mem flag */
1268 const char *argv6[] = {prgname,
1269 "--file-prefix=" memtest, "--socket-mem=2,,2"};
1271 /* invalid (null) --socket-mem flag */
1272 const char *argv7[] = {prgname,
1273 "--file-prefix=" memtest, "--socket-mem="};
1275 /* valid --socket-mem specified together with -m flag */
1276 const char *argv8[] = {prgname,
1277 "--file-prefix=" memtest, "-m", DEFAULT_MEM_SIZE, "--socket-mem=2,2"};
1279 /* construct an invalid socket mask with 2 megs on each socket plus
1280 * extra 2 megs on socket that doesn't exist on current system */
1281 char invalid_socket_mem[SOCKET_MEM_STRLEN];
1282 char buf[SOCKET_MEM_STRLEN]; /* to avoid copying string onto itself */
1284 #ifdef RTE_EXEC_ENV_FREEBSD
1285 int i, num_sockets = 1;
1287 int i, num_sockets = RTE_MIN(get_number_of_sockets(),
1288 RTE_MAX_NUMA_NODES);
1291 if (num_sockets <= 0) {
1292 printf("Error - cannot get number of sockets!\n");
1296 snprintf(invalid_socket_mem, sizeof(invalid_socket_mem), "--socket-mem=");
1298 /* add one extra socket */
1299 for (i = 0; i < num_sockets + 1; i++) {
1300 snprintf(buf, sizeof(buf), "%s%s", invalid_socket_mem, DEFAULT_MEM_SIZE);
1301 strlcpy(invalid_socket_mem, buf, sizeof(invalid_socket_mem));
1303 if (num_sockets + 1 - i > 1) {
1304 snprintf(buf, sizeof(buf), "%s,", invalid_socket_mem);
1305 strlcpy(invalid_socket_mem, buf,
1306 sizeof(invalid_socket_mem));
1310 /* construct a valid socket mask with 2 megs on each existing socket */
1311 char valid_socket_mem[SOCKET_MEM_STRLEN];
1313 snprintf(valid_socket_mem, sizeof(valid_socket_mem), "--socket-mem=");
1315 /* add one extra socket */
1316 for (i = 0; i < num_sockets; i++) {
1317 snprintf(buf, sizeof(buf), "%s%s", valid_socket_mem, DEFAULT_MEM_SIZE);
1318 strlcpy(valid_socket_mem, buf, sizeof(valid_socket_mem));
1320 if (num_sockets - i > 1) {
1321 snprintf(buf, sizeof(buf), "%s,", valid_socket_mem);
1322 strlcpy(valid_socket_mem, buf,
1323 sizeof(valid_socket_mem));
1327 /* invalid --socket-mem flag (with extra socket) */
1328 const char *argv9[] = {prgname,
1329 "--file-prefix=" memtest, invalid_socket_mem};
1331 /* valid --socket-mem flag */
1332 const char *argv10[] = {prgname,
1333 "--file-prefix=" memtest, valid_socket_mem};
1335 if (launch_proc(argv0) != 0) {
1336 printf("Error - secondary process failed with valid -m flag !\n");
1340 #ifdef RTE_EXEC_ENV_FREEBSD
1341 /* no other tests are applicable to BSD */
1345 if (launch_proc(argv1) != 0) {
1346 printf("Error - process failed with valid -m flag!\n");
1349 if (launch_proc(argv2) != 0) {
1350 printf("Error - process failed with valid (zero) --socket-mem!\n");
1354 if (launch_proc(argv3) == 0) {
1355 printf("Error - process run ok with invalid "
1356 "(incomplete) --socket-mem!\n");
1360 if (launch_proc(argv4) == 0) {
1361 printf("Error - process run ok with invalid "
1362 "(mixed with invalid input) --socket-mem!\n");
1366 if (launch_proc(argv5) == 0) {
1367 printf("Error - process run ok with invalid "
1368 "(mixed with invalid input with a numeric value as "
1369 "last character) --socket-mem!\n");
1373 if (launch_proc(argv6) == 0) {
1374 printf("Error - process run ok with invalid "
1375 "(with empty socket) --socket-mem!\n");
1379 if (launch_proc(argv7) == 0) {
1380 printf("Error - process run ok with invalid (null) --socket-mem!\n");
1384 if (launch_proc(argv8) == 0) {
1385 printf("Error - process run ok with --socket-mem and -m specified!\n");
1389 if (launch_proc(argv9) == 0) {
1390 printf("Error - process run ok with extra socket in --socket-mem!\n");
1394 if (launch_proc(argv10) != 0) {
1395 printf("Error - process failed with valid --socket-mem!\n");
1403 test_eal_flags(void)
1407 ret = test_missing_c_flag();
1409 printf("Error in test_missing_c_flag()\n");
1413 ret = test_master_lcore_flag();
1415 printf("Error in test_master_lcore_flag()\n");
1419 ret = test_invalid_n_flag();
1421 printf("Error in test_invalid_n_flag()\n");
1425 ret = test_no_hpet_flag();
1427 printf("Error in test_no_hpet_flag()\n");
1431 ret = test_no_huge_flag();
1433 printf("Error in test_no_huge_flag()\n");
1437 ret = test_whitelist_flag();
1439 printf("Error in test_invalid_whitelist_flag()\n");
1443 ret = test_invalid_b_flag();
1445 printf("Error in test_invalid_b_flag()\n");
1449 #ifdef RTE_LIBRTE_PMD_RING
1450 ret = test_invalid_vdev_flag();
1452 printf("Error in test_invalid_vdev_flag()\n");
1456 ret = test_invalid_r_flag();
1458 printf("Error in test_invalid_r_flag()\n");
1462 ret = test_memory_flags();
1464 printf("Error in test_memory_flags()\n");
1468 ret = test_file_prefix();
1470 printf("Error in test_file_prefix()\n");
1474 ret = test_misc_flags();
1476 printf("Error in test_misc_flags()");
1483 REGISTER_TEST_COMMAND(eal_flags_autotest, test_eal_flags);
1485 /* subtests used in meson for CI */
1486 REGISTER_TEST_COMMAND(eal_flags_c_opt_autotest, test_missing_c_flag);
1487 REGISTER_TEST_COMMAND(eal_flags_master_opt_autotest, test_master_lcore_flag);
1488 REGISTER_TEST_COMMAND(eal_flags_n_opt_autotest, test_invalid_n_flag);
1489 REGISTER_TEST_COMMAND(eal_flags_hpet_autotest, test_no_hpet_flag);
1490 REGISTER_TEST_COMMAND(eal_flags_no_huge_autotest, test_no_huge_flag);
1491 REGISTER_TEST_COMMAND(eal_flags_w_opt_autotest, test_whitelist_flag);
1492 REGISTER_TEST_COMMAND(eal_flags_b_opt_autotest, test_invalid_b_flag);
1493 REGISTER_TEST_COMMAND(eal_flags_vdev_opt_autotest, test_invalid_vdev_flag);
1494 REGISTER_TEST_COMMAND(eal_flags_r_opt_autotest, test_invalid_r_flag);
1495 REGISTER_TEST_COMMAND(eal_flags_mem_autotest, test_memory_flags);
1496 REGISTER_TEST_COMMAND(eal_flags_file_prefix_autotest, test_file_prefix);
1497 REGISTER_TEST_COMMAND(eal_flags_misc_autotest, test_misc_flags);