4 * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
5 * Copyright(c) 2014 6WIND S.A.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * * Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
18 * * Neither the name of Intel Corporation nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
50 #include <rte_debug.h>
51 #include <rte_string_fns.h>
55 #ifdef RTE_LIBRTE_XEN_DOM0
56 #define DEFAULT_MEM_SIZE "30"
58 #define DEFAULT_MEM_SIZE "18"
60 #define mp_flag "--proc-type=secondary"
61 #define no_hpet "--no-hpet"
62 #define no_huge "--no-huge"
63 #define no_shconf "--no-shconf"
64 #define pci_whitelist "--pci-whitelist"
66 #define memtest "memtest"
67 #define memtest1 "memtest1"
68 #define memtest2 "memtest2"
69 #define SOCKET_MEM_STRLEN (RTE_MAX_NUMA_NODES * 10)
70 #define launch_proc(ARGV) process_dup(ARGV, \
71 sizeof(ARGV)/(sizeof(ARGV[0])), __func__)
73 enum hugepage_action {
74 HUGEPAGE_CHECK_EXISTS = 0,
75 HUGEPAGE_CHECK_LOCKED,
80 /* if string contains a hugepage path */
82 get_hugepage_path(char * src, int src_len, char * dst, int dst_len)
85 char *tokens[NUM_TOKENS];
87 /* if we couldn't properly split the string */
88 if (rte_strsplit(src, src_len, tokens, NUM_TOKENS, ' ') < NUM_TOKENS)
91 if (strncmp(tokens[2], "hugetlbfs", sizeof("hugetlbfs")) == 0) {
92 snprintf(dst, dst_len, "%s", tokens[1]);
99 * Cycles through hugepage directories and looks for hugepage
100 * files associated with a given prefix. Depending on value of
101 * action, the hugepages are checked if they exist, checked if
102 * they can be locked, or are simply deleted.
104 * Returns 1 if it finds at least one hugepage matching the action
105 * Returns 0 if no matching hugepages were found
106 * Returns -1 if it encounters an error
109 process_hugefiles(const char * prefix, enum hugepage_action action)
111 FILE * hugedir_handle = NULL;
112 DIR * hugepage_dir = NULL;
113 struct dirent *dirent = NULL;
115 char hugefile_prefix[PATH_MAX] = {0};
116 char hugedir[PATH_MAX] = {0};
117 char line[PATH_MAX] = {0};
119 int fd, lck_result, result = 0;
121 const int prefix_len = snprintf(hugefile_prefix,
122 sizeof(hugefile_prefix), "%smap_", prefix);
123 if (prefix_len <= 0 || prefix_len >= (int)sizeof(hugefile_prefix)
124 || prefix_len >= (int)sizeof(dirent->d_name)) {
125 printf("Error creating hugefile filename prefix\n");
129 /* get hugetlbfs mountpoints from /proc/mounts */
130 hugedir_handle = fopen("/proc/mounts", "r");
132 if (hugedir_handle == NULL) {
133 printf("Error parsing /proc/mounts!\n");
137 /* read and parse script output */
138 while (fgets(line, sizeof(line), hugedir_handle) != NULL) {
140 /* check if we have a hugepage filesystem path */
141 if (!get_hugepage_path(line, sizeof(line), hugedir, sizeof(hugedir)))
144 /* check if directory exists */
145 if ((hugepage_dir = opendir(hugedir)) == NULL) {
146 fclose(hugedir_handle);
147 printf("Error reading %s: %s\n", hugedir, strerror(errno));
151 while ((dirent = readdir(hugepage_dir)) != NULL) {
152 if (memcmp(dirent->d_name, hugefile_prefix, prefix_len) != 0)
156 case HUGEPAGE_CHECK_EXISTS:
158 /* file exists, return */
163 case HUGEPAGE_DELETE:
165 char file_path[PATH_MAX] = {0};
167 snprintf(file_path, sizeof(file_path),
168 "%s/%s", hugedir, dirent->d_name);
171 if (remove(file_path) < 0) {
172 printf("Error deleting %s - %s!\n",
173 dirent->d_name, strerror(errno));
174 closedir(hugepage_dir);
181 case HUGEPAGE_CHECK_LOCKED:
183 /* try and lock the file */
184 fd = openat(dirfd(hugepage_dir), dirent->d_name, O_RDONLY);
186 /* this shouldn't happen */
188 printf("Error opening %s - %s!\n",
189 dirent->d_name, strerror(errno));
190 closedir(hugepage_dir);
195 /* non-blocking lock */
196 lck_result = flock(fd, LOCK_EX | LOCK_NB);
198 /* if lock succeeds, there's something wrong */
199 if (lck_result != -1) {
202 /* unlock the resulting lock */
205 closedir(hugepage_dir);
212 /* shouldn't happen */
217 } /* read hugepage directory */
218 closedir(hugepage_dir);
219 } /* read /proc/mounts */
221 fclose(hugedir_handle);
225 #ifdef RTE_EXEC_ENV_LINUXAPP
227 * count the number of "node*" files in /sys/devices/system/node/
230 get_number_of_sockets(void)
232 struct dirent *dirent = NULL;
233 const char * nodedir = "/sys/devices/system/node/";
237 /* check if directory exists */
238 if ((dir = opendir(nodedir)) == NULL) {
239 /* if errno==ENOENT this means we don't have NUMA support */
240 if (errno == ENOENT) {
241 printf("No NUMA nodes detected: assuming 1 available socket\n");
244 printf("Error opening %s: %s\n", nodedir, strerror(errno));
248 while ((dirent = readdir(dir)) != NULL)
249 if (strncmp(dirent->d_name, "node", sizeof("node") - 1) == 0)
258 get_current_prefix(char * prefix, int size)
260 char path[PATH_MAX] = {0};
261 char buf[PATH_MAX] = {0};
263 /* get file for config (fd is always 3) */
264 snprintf(path, sizeof(path), "/proc/self/fd/%d", 3);
266 /* return NULL on error */
267 if (readlink(path, buf, sizeof(buf)) == -1)
270 /* get the basename */
271 snprintf(buf, sizeof(buf), "%s", basename(buf));
273 /* copy string all the way from second char up to start of _config */
274 snprintf(prefix, size, "%.*s",
275 (int)(strnlen(buf, sizeof(buf)) - sizeof("_config")),
282 * Test that the app doesn't run with invalid whitelist option.
283 * Final tests ensures it does run with valid options as sanity check (one
284 * test for with Domain+BDF, second for just with BDF)
287 test_whitelist_flag(void)
290 #ifdef RTE_EXEC_ENV_BSDAPP
291 /* BSD target doesn't support prefixes at this point */
292 const char * prefix = "";
294 char prefix[PATH_MAX], tmp[PATH_MAX];
295 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
296 printf("Error - unable to get current prefix!\n");
299 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
302 const char *wlinval[][11] = {
303 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
304 pci_whitelist, "error", "", ""},
305 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
306 pci_whitelist, "0:0:0", "", ""},
307 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
308 pci_whitelist, "0:error:0.1", "", ""},
309 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
310 pci_whitelist, "0:0:0.1error", "", ""},
311 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
312 pci_whitelist, "error0:0:0.1", "", ""},
313 {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
314 pci_whitelist, "0:0:0.1.2", "", ""},
316 /* Test with valid whitelist option */
317 const char *wlval1[] = {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
318 pci_whitelist, "00FF:09:0B.3"};
319 const char *wlval2[] = {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
320 pci_whitelist, "09:0B.3", pci_whitelist, "0a:0b.1"};
321 const char *wlval3[] = {prgname, prefix, mp_flag, "-n", "1", "-c", "1",
322 pci_whitelist, "09:0B.3,type=test",
323 pci_whitelist, "08:00.1,type=normal",
326 for (i = 0; i < sizeof(wlinval) / sizeof(wlinval[0]); i++) {
327 if (launch_proc(wlinval[i]) == 0) {
328 printf("Error - process did run ok with invalid "
329 "whitelist parameter\n");
333 if (launch_proc(wlval1) != 0 ) {
334 printf("Error - process did not run ok with valid whitelist\n");
337 if (launch_proc(wlval2) != 0 ) {
338 printf("Error - process did not run ok with valid whitelist value set\n");
341 if (launch_proc(wlval3) != 0 ) {
342 printf("Error - process did not run ok with valid whitelist + args\n");
350 * Test that the app doesn't run with invalid blacklist option.
351 * Final test ensures it does run with valid options as sanity check
354 test_invalid_b_flag(void)
356 #ifdef RTE_EXEC_ENV_BSDAPP
357 /* BSD target doesn't support prefixes at this point */
358 const char * prefix = "";
360 char prefix[PATH_MAX], tmp[PATH_MAX];
361 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
362 printf("Error - unable to get current prefix!\n");
365 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
368 const char *blinval[][9] = {
369 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "error"},
370 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "0:0:0"},
371 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "0:error:0.1"},
372 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "0:0:0.1error"},
373 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "error0:0:0.1"},
374 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "0:0:0.1.2"},
376 /* Test with valid blacklist option */
377 const char *blval[] = {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-b", "FF:09:0B.3"};
381 for (i = 0; i != sizeof (blinval) / sizeof (blinval[0]); i++) {
382 if (launch_proc(blinval[i]) == 0) {
383 printf("Error - process did run ok with invalid "
384 "blacklist parameter\n");
388 if (launch_proc(blval) != 0) {
389 printf("Error - process did not run ok with valid blacklist value\n");
396 * Test that the app doesn't run with invalid vdev option.
397 * Final test ensures it does run with valid options as sanity check
399 #ifdef RTE_LIBRTE_PMD_RING
401 test_invalid_vdev_flag(void)
403 #ifdef RTE_EXEC_ENV_BSDAPP
404 /* BSD target doesn't support prefixes at this point, and we also need to
405 * run another primary process here */
406 const char * prefix = no_shconf;
408 const char * prefix = "--file-prefix=vdev";
411 /* Test with invalid vdev option */
412 const char *vdevinval[] = {prgname, prefix, "-n", "1",
413 "-c", "1", vdev, "eth_dummy"};
415 /* Test with valid vdev option */
416 const char *vdevval1[] = {prgname, prefix, "-n", "1",
417 "-c", "1", vdev, "eth_ring0"};
419 const char *vdevval2[] = {prgname, prefix, "-n", "1",
420 "-c", "1", vdev, "eth_ring0,args=test"};
422 const char *vdevval3[] = {prgname, prefix, "-n", "1",
423 "-c", "1", vdev, "eth_ring0,nodeaction=r1:0:CREATE"};
425 if (launch_proc(vdevinval) == 0) {
426 printf("Error - process did run ok with invalid "
431 if (launch_proc(vdevval1) != 0) {
432 printf("Error - process did not run ok with valid vdev value\n");
436 if (launch_proc(vdevval2) != 0) {
437 printf("Error - process did not run ok with valid vdev value,"
438 "with dummy args\n");
442 if (launch_proc(vdevval3) != 0) {
443 printf("Error - process did not run ok with valid vdev value,"
444 "with valid args\n");
452 * Test that the app doesn't run with invalid -r option.
455 test_invalid_r_flag(void)
457 #ifdef RTE_EXEC_ENV_BSDAPP
458 /* BSD target doesn't support prefixes at this point */
459 const char * prefix = "";
461 char prefix[PATH_MAX], tmp[PATH_MAX];
462 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
463 printf("Error - unable to get current prefix!\n");
466 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
469 const char *rinval[][9] = {
470 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-r", "error"},
471 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-r", "0"},
472 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-r", "-1"},
473 {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-r", "17"},
475 /* Test with valid blacklist option */
476 const char *rval[] = {prgname, prefix, mp_flag, "-n", "1", "-c", "1", "-r", "16"};
480 for (i = 0; i != sizeof (rinval) / sizeof (rinval[0]); i++) {
481 if (launch_proc(rinval[i]) == 0) {
482 printf("Error - process did run ok with invalid "
483 "-r (rank) parameter\n");
487 if (launch_proc(rval) != 0) {
488 printf("Error - process did not run ok with valid -r (rank) value\n");
495 * Test that the app doesn't run without the coremask/corelist flags. In all cases
496 * should give an error and fail to run
499 test_missing_c_flag(void)
501 #ifdef RTE_EXEC_ENV_BSDAPP
502 /* BSD target doesn't support prefixes at this point */
503 const char * prefix = "";
505 char prefix[PATH_MAX], tmp[PATH_MAX];
506 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
507 printf("Error - unable to get current prefix!\n");
510 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
513 /* -c flag but no coremask value */
514 const char *argv1[] = { prgname, prefix, mp_flag, "-n", "3", "-c"};
515 /* No -c, -l or --lcores flag at all */
516 const char *argv2[] = { prgname, prefix, mp_flag, "-n", "3"};
517 /* bad coremask value */
518 const char *argv3[] = { prgname, prefix, mp_flag,
519 "-n", "3", "-c", "error" };
520 /* sanity check of tests - valid coremask value */
521 const char *argv4[] = { prgname, prefix, mp_flag,
522 "-n", "3", "-c", "1" };
523 /* -l flag but no corelist value */
524 const char *argv5[] = { prgname, prefix, mp_flag,
526 const char *argv6[] = { prgname, prefix, mp_flag,
527 "-n", "3", "-l", " " };
528 /* bad corelist values */
529 const char *argv7[] = { prgname, prefix, mp_flag,
530 "-n", "3", "-l", "error" };
531 const char *argv8[] = { prgname, prefix, mp_flag,
532 "-n", "3", "-l", "1-" };
533 const char *argv9[] = { prgname, prefix, mp_flag,
534 "-n", "3", "-l", "1," };
535 const char *argv10[] = { prgname, prefix, mp_flag,
536 "-n", "3", "-l", "1#2" };
537 /* sanity check test - valid corelist value */
538 const char *argv11[] = { prgname, prefix, mp_flag,
539 "-n", "3", "-l", "1-2,3" };
541 /* --lcores flag but no lcores value */
542 const char *argv12[] = { prgname, prefix, mp_flag,
543 "-n", "3", "--lcores" };
544 const char *argv13[] = { prgname, prefix, mp_flag,
545 "-n", "3", "--lcores", " " };
546 /* bad lcores value */
547 const char *argv14[] = { prgname, prefix, mp_flag,
548 "-n", "3", "--lcores", "1-3-5" };
549 const char *argv15[] = { prgname, prefix, mp_flag,
550 "-n", "3", "--lcores", "0-1,,2" };
551 const char *argv16[] = { prgname, prefix, mp_flag,
552 "-n", "3", "--lcores", "0-,1" };
553 const char *argv17[] = { prgname, prefix, mp_flag,
554 "-n", "3", "--lcores", "(0-,2-4)" };
555 const char *argv18[] = { prgname, prefix, mp_flag,
556 "-n", "3", "--lcores", "(-1,2)" };
557 const char *argv19[] = { prgname, prefix, mp_flag,
558 "-n", "3", "--lcores", "(2-4)@(2-4-6)" };
559 const char *argv20[] = { prgname, prefix, mp_flag,
560 "-n", "3", "--lcores", "(a,2)" };
561 const char *argv21[] = { prgname, prefix, mp_flag,
562 "-n", "3", "--lcores", "1-3@(1,3)" };
563 const char *argv22[] = { prgname, prefix, mp_flag,
564 "-n", "3", "--lcores", "3@((1,3)" };
565 const char *argv23[] = { prgname, prefix, mp_flag,
566 "-n", "3", "--lcores", "(4-7)=(1,3)" };
567 const char *argv24[] = { prgname, prefix, mp_flag,
568 "-n", "3", "--lcores", "[4-7]@(1,3)" };
569 /* sanity check of tests - valid lcores value */
570 const char *argv25[] = { prgname, prefix, mp_flag,
571 "-n", "3", "--lcores",
572 "0-1,2@(5-7),(3-5)@(0,2),(0,6),7"};
574 if (launch_proc(argv1) == 0
575 || launch_proc(argv2) == 0
576 || launch_proc(argv3) == 0) {
578 "process ran without error when missing -c flag\n");
581 if (launch_proc(argv4) != 0) {
583 "process did not run ok with valid coremask value\n");
588 if (launch_proc(argv5) == 0
589 || launch_proc(argv6) == 0
590 || launch_proc(argv7) == 0
591 || launch_proc(argv8) == 0
592 || launch_proc(argv9) == 0
593 || launch_proc(argv10) == 0) {
595 "process ran without error with invalid -l flag\n");
598 if (launch_proc(argv11) != 0) {
600 "process did not run ok with valid corelist value\n");
604 /* start --lcores tests */
605 if (launch_proc(argv12) == 0 || launch_proc(argv13) == 0 ||
606 launch_proc(argv14) == 0 || launch_proc(argv15) == 0 ||
607 launch_proc(argv16) == 0 || launch_proc(argv17) == 0 ||
608 launch_proc(argv18) == 0 || launch_proc(argv19) == 0 ||
609 launch_proc(argv20) == 0 || launch_proc(argv21) == 0 ||
610 launch_proc(argv21) == 0 || launch_proc(argv22) == 0 ||
611 launch_proc(argv23) == 0 || launch_proc(argv24) == 0) {
613 "process ran without error with invalid --lcore flag\n");
617 if (launch_proc(argv25) != 0) {
619 "process did not run ok with valid corelist value\n");
627 * Test --master-lcore option with matching coremask
630 test_master_lcore_flag(void)
632 #ifdef RTE_EXEC_ENV_BSDAPP
633 /* BSD target doesn't support prefixes at this point */
634 const char *prefix = "";
636 char prefix[PATH_MAX], tmp[PATH_MAX];
637 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
638 printf("Error - unable to get current prefix!\n");
641 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
644 /* --master-lcore flag but no value */
645 const char *argv1[] = { prgname, prefix, mp_flag, "-n", "1", "-c", "3", "--master-lcore"};
646 /* --master-lcore flag with invalid value */
647 const char *argv2[] = { prgname, prefix, mp_flag, "-n", "1", "-c", "3", "--master-lcore", "-1"};
648 const char *argv3[] = { prgname, prefix, mp_flag, "-n", "1", "-c", "3", "--master-lcore", "X"};
649 /* master lcore not in coremask */
650 const char *argv4[] = { prgname, prefix, mp_flag, "-n", "1", "-c", "3", "--master-lcore", "2"};
652 const char *argv5[] = { prgname, prefix, mp_flag, "-n", "1", "-c", "3", "--master-lcore", "1"};
653 /* valid value set before coremask */
654 const char *argv6[] = { prgname, prefix, mp_flag, "-n", "1", "--master-lcore", "1", "-c", "3"};
656 if (launch_proc(argv1) == 0
657 || launch_proc(argv2) == 0
658 || launch_proc(argv3) == 0
659 || launch_proc(argv4) == 0) {
660 printf("Error - process ran without error with wrong --master-lcore\n");
663 if (launch_proc(argv5) != 0
664 || launch_proc(argv6) != 0) {
665 printf("Error - process did not run ok with valid --master-lcore\n");
672 * Test that the app doesn't run without the -n flag. In all cases
673 * should give an error and fail to run.
674 * Since -n is not compulsory for MP, we instead use --no-huge and --no-shconf
678 test_missing_n_flag(void)
680 #ifdef RTE_EXEC_ENV_BSDAPP
681 /* BSD target doesn't support prefixes at this point */
682 const char * prefix = "";
684 char prefix[PATH_MAX], tmp[PATH_MAX];
685 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
686 printf("Error - unable to get current prefix!\n");
689 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
692 /* -n flag but no value */
693 const char *argv1[] = { prgname, prefix, no_huge, no_shconf, "-c", "1", "-n"};
694 /* No -n flag at all */
695 const char *argv2[] = { prgname, prefix, no_huge, no_shconf, "-c", "1"};
696 /* bad numeric value */
697 const char *argv3[] = { prgname, prefix, no_huge, no_shconf, "-c", "1", "-n", "e" };
698 /* out-of-range value */
699 const char *argv4[] = { prgname, prefix, no_huge, no_shconf, "-c", "1", "-n", "9" };
700 /* sanity test - check with good value */
701 const char *argv5[] = { prgname, prefix, no_huge, no_shconf, "-c", "1", "-n", "2" };
703 if (launch_proc(argv1) == 0
704 || launch_proc(argv2) == 0
705 || launch_proc(argv3) == 0
706 || launch_proc(argv4) == 0) {
707 printf("Error - process ran without error when missing -n flag\n");
710 if (launch_proc(argv5) != 0) {
711 printf("Error - process did not run ok with valid num-channel value\n");
718 * Test that the app runs with HPET, and without HPET
721 test_no_hpet_flag(void)
723 char prefix[PATH_MAX], tmp[PATH_MAX];
725 #ifdef RTE_EXEC_ENV_BSDAPP
728 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
729 printf("Error - unable to get current prefix!\n");
732 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
735 const char *argv1[] = {prgname, prefix, mp_flag, no_hpet, "-c", "1", "-n", "2"};
736 /* Without --no-hpet */
737 const char *argv2[] = {prgname, prefix, mp_flag, "-c", "1", "-n", "2"};
739 if (launch_proc(argv1) != 0) {
740 printf("Error - process did not run ok with --no-hpet flag\n");
743 if (launch_proc(argv2) != 0) {
744 printf("Error - process did not run ok without --no-hpet flag\n");
751 * Test that the app runs with --no-huge and doesn't run when either
752 * -m or --socket-mem are specified with --no-huge.
755 test_no_huge_flag(void)
757 #ifdef RTE_EXEC_ENV_BSDAPP
758 /* BSD target doesn't support prefixes at this point, and we also need to
759 * run another primary process here */
760 const char * prefix = no_shconf;
762 const char * prefix = "--file-prefix=nohuge";
766 const char *argv1[] = {prgname, prefix, no_huge, "-c", "1", "-n", "2"};
767 /* With --no-huge and -m */
768 const char *argv2[] = {prgname, prefix, no_huge, "-c", "1", "-n", "2",
769 "-m", DEFAULT_MEM_SIZE};
771 /* With --no-huge and --socket-mem */
772 const char *argv3[] = {prgname, prefix, no_huge, "-c", "1", "-n", "2",
773 "--socket-mem=" DEFAULT_MEM_SIZE};
774 /* With --no-huge, -m and --socket-mem */
775 const char *argv4[] = {prgname, prefix, no_huge, "-c", "1", "-n", "2",
776 "-m", DEFAULT_MEM_SIZE, "--socket-mem=" DEFAULT_MEM_SIZE};
777 if (launch_proc(argv1) != 0) {
778 printf("Error - process did not run ok with --no-huge flag\n");
781 if (launch_proc(argv2) == 0) {
782 printf("Error - process run ok with --no-huge and -m flags\n");
785 #ifdef RTE_EXEC_ENV_BSDAPP
786 /* BSD target does not support NUMA, hence no --socket-mem tests */
790 if (launch_proc(argv3) == 0) {
791 printf("Error - process run ok with --no-huge and --socket-mem "
795 if (launch_proc(argv4) == 0) {
796 printf("Error - process run ok with --no-huge, -m and "
797 "--socket-mem flags\n");
803 #ifdef RTE_LIBRTE_XEN_DOM0
805 test_dom0_misc_flags(void)
807 char prefix[PATH_MAX], tmp[PATH_MAX];
809 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
810 printf("Error - unable to get current prefix!\n");
813 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
815 /* check that some general flags don't prevent things from working.
816 * All cases, apart from the first, app should run.
817 * No futher testing of output done.
819 /* sanity check - failure with invalid option */
820 const char *argv0[] = {prgname, prefix, mp_flag, "-c", "1", "--invalid-opt"};
823 const char *argv1[] = {prgname, prefix, mp_flag, "-c", "1", "--no-pci"};
825 const char *argv2[] = {prgname, prefix, mp_flag, "-c", "1", "-v"};
826 /* With valid --syslog */
827 const char *argv3[] = {prgname, prefix, mp_flag, "-c", "1",
828 "--syslog", "syslog"};
829 /* With empty --syslog (should fail) */
830 const char *argv4[] = {prgname, prefix, mp_flag, "-c", "1", "--syslog"};
831 /* With invalid --syslog */
832 const char *argv5[] = {prgname, prefix, mp_flag, "-c", "1", "--syslog", "error"};
833 /* With no-sh-conf */
834 const char *argv6[] = {prgname, "-c", "1", "-n", "2", "-m", "20",
835 "--no-shconf", "--file-prefix=noshconf" };
837 if (launch_proc(argv0) == 0) {
838 printf("Error - process ran ok with invalid flag\n");
841 if (launch_proc(argv1) != 0) {
842 printf("Error - process did not run ok with --no-pci flag\n");
845 if (launch_proc(argv2) != 0) {
846 printf("Error - process did not run ok with -v flag\n");
849 if (launch_proc(argv3) != 0) {
850 printf("Error - process did not run ok with --syslog flag\n");
853 if (launch_proc(argv4) == 0) {
854 printf("Error - process run ok with empty --syslog flag\n");
857 if (launch_proc(argv5) == 0) {
858 printf("Error - process run ok with invalid --syslog flag\n");
861 if (launch_proc(argv6) != 0) {
862 printf("Error - process did not run ok with --no-shconf flag\n");
870 test_misc_flags(void)
872 char hugepath[PATH_MAX] = {0};
873 #ifdef RTE_EXEC_ENV_BSDAPP
874 /* BSD target doesn't support prefixes at this point */
875 const char * prefix = "";
876 const char * nosh_prefix = "";
878 char prefix[PATH_MAX], tmp[PATH_MAX];
879 const char * nosh_prefix = "--file-prefix=noshconf";
880 FILE * hugedir_handle = NULL;
881 char line[PATH_MAX] = {0};
882 unsigned i, isempty = 1;
883 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
884 printf("Error - unable to get current prefix!\n");
887 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
890 * get first valid hugepage path
893 /* get hugetlbfs mountpoints from /proc/mounts */
894 hugedir_handle = fopen("/proc/mounts", "r");
896 if (hugedir_handle == NULL) {
897 printf("Error opening /proc/mounts!\n");
901 /* read /proc/mounts */
902 while (fgets(line, sizeof(line), hugedir_handle) != NULL) {
904 /* find first valid hugepath */
905 if (get_hugepage_path(line, sizeof(line), hugepath, sizeof(hugepath)))
909 fclose(hugedir_handle);
911 /* check if path is not empty */
912 for (i = 0; i < sizeof(hugepath); i++)
913 if (hugepath[i] != '\0')
917 printf("No mounted hugepage dir found!\n");
923 /* check that some general flags don't prevent things from working.
924 * All cases, apart from the first, app should run.
925 * No futher testing of output done.
927 /* sanity check - failure with invalid option */
928 const char *argv0[] = {prgname, prefix, mp_flag, "-c", "1", "--invalid-opt"};
931 const char *argv1[] = {prgname, prefix, mp_flag, "-c", "1", "--no-pci"};
933 const char *argv2[] = {prgname, prefix, mp_flag, "-c", "1", "-v"};
934 /* With valid --syslog */
935 const char *argv3[] = {prgname, prefix, mp_flag, "-c", "1",
936 "--syslog", "syslog"};
937 /* With empty --syslog (should fail) */
938 const char *argv4[] = {prgname, prefix, mp_flag, "-c", "1", "--syslog"};
939 /* With invalid --syslog */
940 const char *argv5[] = {prgname, prefix, mp_flag, "-c", "1", "--syslog", "error"};
941 /* With no-sh-conf */
942 const char *argv6[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
943 no_shconf, nosh_prefix };
945 #ifdef RTE_EXEC_ENV_BSDAPP
948 /* With --huge-dir */
949 const char *argv7[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
950 "--file-prefix=hugedir", "--huge-dir", hugepath};
951 /* With empty --huge-dir (should fail) */
952 const char *argv8[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
953 "--file-prefix=hugedir", "--huge-dir"};
954 /* With invalid --huge-dir */
955 const char *argv9[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
956 "--file-prefix=hugedir", "--huge-dir", "invalid"};
957 /* Secondary process with invalid --huge-dir (should run as flag has no
958 * effect on secondary processes) */
959 const char *argv10[] = {prgname, prefix, mp_flag, "-c", "1", "--huge-dir", "invalid"};
961 /* try running with base-virtaddr param */
962 const char *argv11[] = {prgname, "--file-prefix=virtaddr",
963 "-c", "1", "-n", "2", "--base-virtaddr=0x12345678"};
965 /* try running with --vfio-intr INTx flag */
966 const char *argv12[] = {prgname, "--file-prefix=intr",
967 "-c", "1", "-n", "2", "--vfio-intr=legacy"};
969 /* try running with --vfio-intr MSI flag */
970 const char *argv13[] = {prgname, "--file-prefix=intr",
971 "-c", "1", "-n", "2", "--vfio-intr=msi"};
973 /* try running with --vfio-intr MSI-X flag */
974 const char *argv14[] = {prgname, "--file-prefix=intr",
975 "-c", "1", "-n", "2", "--vfio-intr=msix"};
977 /* try running with --vfio-intr invalid flag */
978 const char *argv15[] = {prgname, "--file-prefix=intr",
979 "-c", "1", "-n", "2", "--vfio-intr=invalid"};
982 if (launch_proc(argv0) == 0) {
983 printf("Error - process ran ok with invalid flag\n");
986 if (launch_proc(argv1) != 0) {
987 printf("Error - process did not run ok with --no-pci flag\n");
990 if (launch_proc(argv2) != 0) {
991 printf("Error - process did not run ok with -v flag\n");
994 if (launch_proc(argv3) != 0) {
995 printf("Error - process did not run ok with --syslog flag\n");
998 if (launch_proc(argv4) == 0) {
999 printf("Error - process run ok with empty --syslog flag\n");
1002 if (launch_proc(argv5) == 0) {
1003 printf("Error - process run ok with invalid --syslog flag\n");
1006 if (launch_proc(argv6) != 0) {
1007 printf("Error - process did not run ok with --no-shconf flag\n");
1010 #ifdef RTE_EXEC_ENV_BSDAPP
1013 if (launch_proc(argv7) != 0) {
1014 printf("Error - process did not run ok with --huge-dir flag\n");
1017 if (launch_proc(argv8) == 0) {
1018 printf("Error - process run ok with empty --huge-dir flag\n");
1021 if (launch_proc(argv9) == 0) {
1022 printf("Error - process run ok with invalid --huge-dir flag\n");
1025 if (launch_proc(argv10) != 0) {
1026 printf("Error - secondary process did not run ok with invalid --huge-dir flag\n");
1029 if (launch_proc(argv11) != 0) {
1030 printf("Error - process did not run ok with --base-virtaddr parameter\n");
1033 if (launch_proc(argv12) != 0) {
1034 printf("Error - process did not run ok with "
1035 "--vfio-intr INTx parameter\n");
1038 if (launch_proc(argv13) != 0) {
1039 printf("Error - process did not run ok with "
1040 "--vfio-intr MSI parameter\n");
1043 if (launch_proc(argv14) != 0) {
1044 printf("Error - process did not run ok with "
1045 "--vfio-intr MSI-X parameter\n");
1048 if (launch_proc(argv15) == 0) {
1049 printf("Error - process run ok with "
1050 "--vfio-intr invalid parameter\n");
1058 test_file_prefix(void)
1061 * 1. check if current process hugefiles are locked
1062 * 2. try to run secondary process without a corresponding primary process
1063 * (while failing to run, it will also remove any unused hugepage files)
1064 * 3. check if current process hugefiles are still in place and are locked
1065 * 4. run a primary process with memtest1 prefix
1066 * 5. check if memtest1 hugefiles are created
1067 * 6. run a primary process with memtest2 prefix
1068 * 7. check that only memtest2 hugefiles are present in the hugedir
1071 #ifdef RTE_EXEC_ENV_BSDAPP
1075 /* this should fail unless the test itself is run with "memtest" prefix */
1076 const char *argv0[] = {prgname, mp_flag, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
1077 "--file-prefix=" memtest };
1079 /* primary process with memtest1 */
1080 const char *argv1[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
1081 "--file-prefix=" memtest1 };
1083 /* primary process with memtest2 */
1084 const char *argv2[] = {prgname, "-c", "1", "-n", "2", "-m", DEFAULT_MEM_SIZE,
1085 "--file-prefix=" memtest2 };
1088 if (get_current_prefix(prefix, sizeof(prefix)) == NULL) {
1089 printf("Error - unable to get current prefix!\n");
1092 #ifdef RTE_LIBRTE_XEN_DOM0
1096 /* check if files for current prefix are present */
1097 if (process_hugefiles(prefix, HUGEPAGE_CHECK_EXISTS) != 1) {
1098 printf("Error - hugepage files for %s were not created!\n", prefix);
1102 /* checks if files for current prefix are locked */
1103 if (process_hugefiles(prefix, HUGEPAGE_CHECK_LOCKED) != 1) {
1104 printf("Error - hugepages for current process aren't locked!\n");
1108 /* check if files for secondary process are present */
1109 if (process_hugefiles(memtest, HUGEPAGE_CHECK_EXISTS) == 1) {
1110 /* check if they are not locked */
1111 if (process_hugefiles(memtest, HUGEPAGE_CHECK_LOCKED) == 1) {
1112 printf("Error - hugepages for current process are locked!\n");
1115 /* they aren't locked, delete them */
1117 if (process_hugefiles(memtest, HUGEPAGE_DELETE) != 1) {
1118 printf("Error - deleting hugepages failed!\n");
1124 if (launch_proc(argv0) == 0) {
1125 printf("Error - secondary process ran ok without primary process\n");
1129 /* check if files for current prefix are present */
1130 if (process_hugefiles(prefix, HUGEPAGE_CHECK_EXISTS) != 1) {
1131 printf("Error - hugepage files for %s were not created!\n", prefix);
1135 /* checks if files for current prefix are locked */
1136 if (process_hugefiles(prefix, HUGEPAGE_CHECK_LOCKED) != 1) {
1137 printf("Error - hugepages for current process aren't locked!\n");
1141 if (launch_proc(argv1) != 0) {
1142 printf("Error - failed to run with --file-prefix=%s\n", memtest);
1146 /* check if memtest1_map0 is present */
1147 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 1) {
1148 printf("Error - hugepage files for %s were not created!\n", memtest1);
1152 if (launch_proc(argv2) != 0) {
1153 printf("Error - failed to run with --file-prefix=%s\n", memtest2);
1157 /* check if hugefiles for memtest2 are present */
1158 if (process_hugefiles(memtest2, HUGEPAGE_CHECK_EXISTS) != 1) {
1159 printf("Error - hugepage files for %s were not created!\n", memtest2);
1163 /* check if hugefiles for memtest1 are present */
1164 if (process_hugefiles(memtest1, HUGEPAGE_CHECK_EXISTS) != 0) {
1165 printf("Error - hugepage files for %s were not deleted!\n", memtest1);
1173 * Tests for correct handling of -m and --socket-mem flags
1176 test_memory_flags(void)
1178 #ifdef RTE_EXEC_ENV_BSDAPP
1179 /* BSD target doesn't support prefixes at this point */
1180 const char * prefix = "";
1182 char prefix[PATH_MAX], tmp[PATH_MAX];
1183 if (get_current_prefix(tmp, sizeof(tmp)) == NULL) {
1184 printf("Error - unable to get current prefix!\n");
1187 snprintf(prefix, sizeof(prefix), "--file-prefix=%s", tmp);
1190 /* valid -m flag and mp flag */
1191 const char *argv0[] = {prgname, prefix, mp_flag, "-c", "10",
1192 "-n", "2", "-m", DEFAULT_MEM_SIZE};
1195 const char *argv1[] = {prgname, "-c", "10", "-n", "2",
1196 "--file-prefix=" memtest, "-m", DEFAULT_MEM_SIZE};
1198 /* invalid (zero) --socket-mem flag */
1199 const char *argv2[] = {prgname, "-c", "10", "-n", "2",
1200 "--file-prefix=" memtest, "--socket-mem=0,0,0,0"};
1202 /* invalid (incomplete) --socket-mem flag */
1203 const char *argv3[] = {prgname, "-c", "10", "-n", "2",
1204 "--file-prefix=" memtest, "--socket-mem=2,2,"};
1206 /* invalid (mixed with invalid data) --socket-mem flag */
1207 const char *argv4[] = {prgname, "-c", "10", "-n", "2",
1208 "--file-prefix=" memtest, "--socket-mem=2,2,Fred"};
1210 /* invalid (with numeric value as last character) --socket-mem flag */
1211 const char *argv5[] = {prgname, "-c", "10", "-n", "2",
1212 "--file-prefix=" memtest, "--socket-mem=2,2,Fred0"};
1214 /* invalid (with empty socket) --socket-mem flag */
1215 const char *argv6[] = {prgname, "-c", "10", "-n", "2",
1216 "--file-prefix=" memtest, "--socket-mem=2,,2"};
1218 /* invalid (null) --socket-mem flag */
1219 const char *argv7[] = {prgname, "-c", "10", "-n", "2",
1220 "--file-prefix=" memtest, "--socket-mem="};
1222 /* valid --socket-mem specified together with -m flag */
1223 const char *argv8[] = {prgname, "-c", "10", "-n", "2",
1224 "--file-prefix=" memtest, "-m", DEFAULT_MEM_SIZE, "--socket-mem=2,2"};
1226 /* construct an invalid socket mask with 2 megs on each socket plus
1227 * extra 2 megs on socket that doesn't exist on current system */
1228 char invalid_socket_mem[SOCKET_MEM_STRLEN];
1229 char buf[SOCKET_MEM_STRLEN]; /* to avoid copying string onto itself */
1231 #ifdef RTE_EXEC_ENV_BSDAPP
1232 int i, num_sockets = 1;
1234 int i, num_sockets = get_number_of_sockets();
1237 if (num_sockets <= 0 || num_sockets > RTE_MAX_NUMA_NODES) {
1238 printf("Error - cannot get number of sockets!\n");
1242 snprintf(invalid_socket_mem, sizeof(invalid_socket_mem), "--socket-mem=");
1244 /* add one extra socket */
1245 for (i = 0; i < num_sockets + 1; i++) {
1246 snprintf(buf, sizeof(buf), "%s%s", invalid_socket_mem, DEFAULT_MEM_SIZE);
1247 snprintf(invalid_socket_mem, sizeof(invalid_socket_mem), "%s", buf);
1249 if (num_sockets + 1 - i > 1) {
1250 snprintf(buf, sizeof(buf), "%s,", invalid_socket_mem);
1251 snprintf(invalid_socket_mem, sizeof(invalid_socket_mem), "%s", buf);
1255 /* construct a valid socket mask with 2 megs on each existing socket */
1256 char valid_socket_mem[SOCKET_MEM_STRLEN];
1258 snprintf(valid_socket_mem, sizeof(valid_socket_mem), "--socket-mem=");
1260 /* add one extra socket */
1261 for (i = 0; i < num_sockets; i++) {
1262 snprintf(buf, sizeof(buf), "%s%s", valid_socket_mem, DEFAULT_MEM_SIZE);
1263 snprintf(valid_socket_mem, sizeof(valid_socket_mem), "%s", buf);
1265 if (num_sockets - i > 1) {
1266 snprintf(buf, sizeof(buf), "%s,", valid_socket_mem);
1267 snprintf(valid_socket_mem, sizeof(valid_socket_mem), "%s", buf);
1271 /* invalid --socket-mem flag (with extra socket) */
1272 const char *argv9[] = {prgname, "-c", "10", "-n", "2",
1273 "--file-prefix=" memtest, invalid_socket_mem};
1275 /* valid --socket-mem flag */
1276 const char *argv10[] = {prgname, "-c", "10", "-n", "2",
1277 "--file-prefix=" memtest, valid_socket_mem};
1279 if (launch_proc(argv0) != 0) {
1280 printf("Error - secondary process failed with valid -m flag !\n");
1284 #ifdef RTE_EXEC_ENV_BSDAPP
1285 /* no other tests are applicable to BSD */
1289 if (launch_proc(argv1) != 0) {
1290 printf("Error - process failed with valid -m flag!\n");
1293 #ifdef RTE_LIBRTE_XEN_DOM0
1296 if (launch_proc(argv2) == 0) {
1297 printf("Error - process run ok with invalid (zero) --socket-mem!\n");
1301 if (launch_proc(argv3) == 0) {
1302 printf("Error - process run ok with invalid "
1303 "(incomplete) --socket-mem!\n");
1307 if (launch_proc(argv4) == 0) {
1308 printf("Error - process run ok with invalid "
1309 "(mixed with invalid input) --socket-mem!\n");
1313 if (launch_proc(argv5) == 0) {
1314 printf("Error - process run ok with invalid "
1315 "(mixed with invalid input with a numeric value as "
1316 "last character) --socket-mem!\n");
1320 if (launch_proc(argv6) == 0) {
1321 printf("Error - process run ok with invalid "
1322 "(with empty socket) --socket-mem!\n");
1326 if (launch_proc(argv7) == 0) {
1327 printf("Error - process run ok with invalid (null) --socket-mem!\n");
1331 if (launch_proc(argv8) == 0) {
1332 printf("Error - process run ok with --socket-mem and -m specified!\n");
1336 if (launch_proc(argv9) == 0) {
1337 printf("Error - process run ok with extra socket in --socket-mem!\n");
1341 if (launch_proc(argv10) != 0) {
1342 printf("Error - process failed with valid --socket-mem!\n");
1350 test_eal_flags(void)
1354 ret = test_missing_c_flag();
1356 printf("Error in test_missing_c_flag()\n");
1360 ret = test_master_lcore_flag();
1362 printf("Error in test_master_lcore_flag()\n");
1366 ret = test_missing_n_flag();
1368 printf("Error in test_missing_n_flag()\n");
1372 ret = test_no_hpet_flag();
1374 printf("Error in test_no_hpet_flag()\n");
1378 ret = test_no_huge_flag();
1380 printf("Error in test_no_huge_flag()\n");
1384 ret = test_whitelist_flag();
1386 printf("Error in test_invalid_whitelist_flag()\n");
1390 ret = test_invalid_b_flag();
1392 printf("Error in test_invalid_b_flag()\n");
1396 #ifdef RTE_LIBRTE_PMD_RING
1397 ret = test_invalid_vdev_flag();
1399 printf("Error in test_invalid_vdev_flag()\n");
1403 ret = test_invalid_r_flag();
1405 printf("Error in test_invalid_r_flag()\n");
1409 ret = test_memory_flags();
1411 printf("Error in test_memory_flags()\n");
1415 ret = test_file_prefix();
1417 printf("Error in test_file_prefix()\n");
1421 #ifdef RTE_LIBRTE_XEN_DOM0
1422 ret = test_dom0_misc_flags();
1424 ret = test_misc_flags();
1427 printf("Error in test_misc_flags()");
1434 static struct test_command eal_flags_cmd = {
1435 .command = "eal_flags_autotest",
1436 .callback = test_eal_flags,
1438 REGISTER_TEST_COMMAND(eal_flags_cmd);