perf-test.txt 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. perf-test(1)
  2. ============
  3. NAME
  4. ----
  5. perf-test - Runs sanity tests.
  6. SYNOPSIS
  7. --------
  8. [verse]
  9. 'perf test [<options>] [{list <test-name-fragment>|[<test-name-fragments>|<test-numbers>]}]'
  10. DESCRIPTION
  11. -----------
  12. This command does assorted sanity tests, initially through linked routines but
  13. also will look for a directory with more tests in the form of scripts.
  14. To get a list of available tests use 'perf test list', specifying a test name
  15. fragment will show all tests that have it.
  16. To run just specific tests, inform test name fragments or the numbers obtained
  17. from 'perf test list'.
  18. OPTIONS
  19. -------
  20. -s::
  21. --skip::
  22. Tests to skip (comma separated numeric list).
  23. -v::
  24. -vv::
  25. -vvv::
  26. --verbose::
  27. With a single '-v', verbose level 1, only failing test output
  28. is displayed. With '-vv' and higher all test output is shown.
  29. -S::
  30. --sequential::
  31. Run all tests one after the other. By default "exclusive"
  32. tests are run sequentially, but other tests are run in
  33. parallel to speed execution.
  34. -r::
  35. --runs-per-test::
  36. Run each test the given number of times, by default once. This
  37. option can be useful to determine if a test is flaky.
  38. -F::
  39. --dont-fork::
  40. Do not fork child for each test, run all tests within single process, this
  41. sets sequential mode.
  42. --dso::
  43. Specify a DSO for the "Symbols" test.
  44. -w::
  45. --workload=::
  46. Run a built-in workload, to list them use '--list-workloads', current ones include:
  47. noploop, thloop, leafloop, sqrtloop, brstack, datasym and landlock.
  48. Used with the shell script regression tests.
  49. Some accept an extra parameter:
  50. seconds: leafloop, noploop, sqrtloop, thloop
  51. nrloops: brstack
  52. The datasym and landlock workloads don't accept any.
  53. --list-workloads::
  54. List the available workloads to use with -w/--workload.