<html> <head> <Title>Configuration</Title> </head> <body> <h1>User Files & Folders</h1> <p><strong>~/.phoronix-test-suite/user-config.xml</strong></p> <p>This is a per-user configuration file. Among the information stored here is the test options, locations for storing files, and batch mode options. This file is formatted in XML.</p> <p><strong>~/.phoronix-test-suite/graph-config.json</strong></p> <p>This is a per-user configuration file for storing graph attributes. The adjustable options include HTML hex color codes for different areas of the graph, dimensions of the graph, and font sizes. This file is formatted in JSON.</p> <p><strong>~/.phoronix-test-suite/download-cache/</strong></p> <p>This directory contains test packages that have been downloaded for test profiles. For more information on the download cache.</p> <p><strong>~/.phoronix-test-suite/installed-tests/</strong></p> <p>This directory is where tests are installed by default. Each test has its own directory within a sub-directory of <em>installed-tests/</em> based upon its OpenBenchmarking.org repository. In the test's folder is a <em>pts-install.xml</em> file used for managing the installation.</p> <p><strong>~/.phoronix-test-suite/test-results/</strong></p> <p>This directory is where tests results are saved by default. Each saved file has its own directory. In the saved directory is then a <em>composite.xml</em> file containing the useful results while in the <em>test-X.xml</em> files are back-ups of the results.</p> <p><strong>~/.phoronix-test-suite/modules-data/</strong></p> <p>This is the directory where any Phoronix Test Suite modules should save any files to, within a sub-directory of the module's name. The module configuration settings are also stored within this directory.</p> <p><strong>~/.phoronix-test-suite/test-profiles/</strong></p> <p>This is the directory where test profiles are stored.</p> <p><strong>~/.phoronix-test-suite/test-suites/</strong></p> <p>This is the directory where test suites are stored.</p> <h1>Environment Variables</h1> <p><strong>TEST_RESULTS_NAME</strong></p> <p>When this variable is set, the value will be used as the name for automatically saving the test results.</p> <p><strong>TEST_RESULTS_IDENTIFIER</strong></p> <p>When this variable is set, the value will be used as the test identifier when automatically saving the test results.</p> <p><strong>TEST_RESULTS_DESCRIPTION</strong></p> <p>When this variable is set, the value will be used as the test results description when saving the test results.</p> <p><strong>PRESET_OPTIONS</strong></p> <p>For setting any test option(s) from an environment variable rather than being prompted for the options when running a test. Example: <em>PRESET_OPTIONS="stream.run-type=Add" ./phoronix-test-suite benchmark stream</em></p> <p><strong>SKIP_TESTS</strong></p> <p>If there are any test(s) to exempt from the testing process, specify them in this variable. Multiple tests can be waived by delimiting each test identifier by a comma. A test hardware type (i.e. Graphics) can also be supplied for skipping a range of tests.</p> <p><strong>ONLY_TEST_TYPES</strong></p> <p>If you are running a set of benchmarks (namely a result file) but wish to skip some of the tests that don't belong to a certain test type group, you can set the hardware types to test via this environment variable. E.g. setting <em>ONLY_TEST_TYPE=Graphics</em> will skip all test profiles to run that are not of the graphics test group. Multiple types should be delimited by a comma.</p> <p><strong>PTS_MODULE_SETUP</strong></p> <p>This variable can be used to load Phoronix Test Suite module settings automatically when using the <em>module-setup</em> option. An example would be: <em>PTS_MODULE_SETUP="phoromatic.remote_host=http://www.phoromatic.com/; phoromatic.remote_account=123456; phoromatic.remote_verifier=ABCD" phoronix-test-suite module-setup phoromatic</em>.</p> <p><strong>PTS_MODULES</strong></p> <p>If there are any Phoronix Test Suite modules to additionally load, they can be specified here. Multiple modules can be supplied by delimiting them with a comma. The more appropriate way of loading Phoronix Test Suite modules for longer periods of time is by using the <em>~/.phoronix-test-suite/user-config.xml</em> configuration.</p> <p><strong>NO_PHODEVI_CACHE</strong></p> <p>This is a debugging option to disable the Phodevi cache from being loaded of cached software/hardware information. Instead, all software/hardware will be polled from the Phodevi library without caching.</p> <p><strong>EXTERNAL_PHODEVI_CACHE</strong></p> <p>This option can be used for loading an external Phodevi cache. Such as loading the native hardware/software information from within a Windows Wine client from a native system host.</p> <p><strong>PTS_DISPLAY_MODE</strong></p> <p>If you wish to load a non-default display mode for a single instance, specify the mode in this variable.</p> <p><strong>TOTAL_LOOP_TIME</strong></p> <p>When running any test(s), if you would like the test(s) to continue running as a loop until a certain time has been reached, this variable can be used. The value should be the number of minutes to run the testing process before the loop is ended.</p> <p><strong>TOTAL_LOOP_COUNT</strong></p> <p>When running any test(s), if you would like the test(s) to continue running for a number of times, this variable can be used. The value should be the number of times to loop the testing process before ending.</p> <p><strong>FORCE_TIMES_TO_RUN</strong></p> <p>If you wish to override the number of times to run each test -- rather than the Phoronix Test Suite using the number of times specified in each test profile -- this variable can be used.</p> <p><strong>FORCE_MIN_TIMES_TO_RUN</strong></p> <p>This is similar to the FORCE_TIMES_TO_RUN option but will only be used if the test profile's run count is less than this defined value.</p> <p><strong>NO_FILE_HASH_CHECKS</strong></p> <p>To disable MD5/SHA256 check-sums from being checked when downloading test files, set this variable to 1. This variable used to be known as <em>NO_MD5_CHECKS</em>, which is still honored but was changed to <em>NO_FILE_HASH_CHECKS</em> to reflect other kind of file hash sum checks.</p> <p><strong>PTS_DOWNLOAD_CACHE</strong></p> <p>While non-standard Phoronix Test Suite download caches can be specified within the <em>user-config.xml</em> file, an additional directory to look for potential Phoronix Test Suite download files can be specified by this variable.</p> <p><strong>GRAPH_HIGHLIGHT</strong></p> <p>If this variable is set with a valid test identifer from a result file whether you are using the <em>refresh-graphs</em> command or any other related to the rendering of test results on a bar graph, the specified test identifier's result will be highlighted in a different color than the other rendered test results. Multiple identifiers can be specified when delimited by a comma.</p> <p><strong>VIDEO_MEMORY</strong></p> <p>If Phodevi fails to detect the system's video memory capacity or is incorrectly detected, the video memory capacity (in MB) can be specified by this variable.</p> <p><strong>OVERRIDE_VIDEO_MODES</strong></p> <p>If Phodevi fails to detect all of the system's monitor video modes or a separate set of modes would be preferred, the modes can be specified in this variable. Example: <em>OVERRIDE_VIDEO_MODES=800x600,1024x768,1280x1024 phoronix-test-suite benchmark nexuiz</em>.</p> <p><strong>SKIP_TEST_SUPPORT_CHECKS</strong></p> <p>If this environment variable is set, it will not honor the support checks made by individual test profiles. I.e. test profiles that would normally be considered un-supported on a given platform are attempted to install and run regardless.</p> <p><strong>SKIP_ALL_TEST_SUPPORT_CHECKS</strong></p> <p>If this environment variable is set, all tests will be permitted on the client for execution. SKIP_ALL_TEST_SUPPORT_CHECKS is more liberal than SKIP_TEST_SUPPORT_CHECKS in letting disk tests run on RAM-based file-systems, attempt to run 2D/3D tests on VESA display drivers, and other special cases.</p> <p><strong>DEFAULT_VIDEO_MODE</strong></p> <p>If Phodevi fails to detect the system's monitor standard / default resolution, the mode can be specified in this variable. Example: <em>DEFAULT_VIDEO_MODE=1680x1050 phoronix-test-suite benchmark nexuiz</em>.</p> <p><strong>SKIP_EXTERNAL_DEPENDENCIES</strong></p> <p>To skip the Phoronix Test Suite external dependency checking/installation when installing a test, set this environment variable to <em>1</em>. If wishing to skip only certain external dependencies, set this variable's value to the name of the external dependencies (the generic dependency names used by the Phoronix Test Suite) to not install. Multiple dependencies to skip can be delimited by a comma.</p> </body> </html>
