USEX: Command Line Options
A short listing of all usex command line options may be viewed from the command line by entering "usex -h". The following table contains the same short-form descriptions. For more information concerning each option, click on the option's "details" link. Also note that many of the options may alternatively be entered in a .usexrc file that is located either in the user's home directory or in the directory from which the usex session is invoked.

OPTION SHORT DESCRIPTION .usexrc
CAPABLE?
OPTION
DETAILS
-h
or
--help
Display the USEX help message. no
-b [count] Automatically execute bin test suites, adapting to the terminal window size. If a test count is specified, then only run that many tests. The maximum test count is 48. no
-e [count] Automatically execute an an example set of built-in tests, adapting to the terminal window size. If a test count is specified, then only run that many tests. The minimum test count is 6, so as to allow one of each type of built-in test to run. The maximum test count is 48. no
-v Display the USEX version number. no
-M Use SYSV IPC message queues for message passing. yes
-S Use SYSV shared memory for message passing. yes
-P Use pipes for message passing. yes
-r Prevent automatic screen refresh. yes
-d Start USEX in debug mode. yes
OPTION SHORT DESCRIPTION .usexrc
CAPABLE?
OPTION
DETAILS
-i filename Read USEX input from file. yes
-o filename Save test parameters in USEX input file. yes
-p filename
or
-p ID
Use I/O test pattern as indicated in the file, or the keyword "ID", which fills the test pattern with the test ID number. yes
-t filename Use as transfer rate file for -e option. yes
-l filename Log usex events in a file, along with a screen dump, test summaries, and usex internal status. yes
-R filename Create a report file with pass/fail status, screen dump, test summaries, and usex internal status. yes
-T minutes Minutes to run test (overrides any input file setting). yes
-H minutes Number of minutes without any builtin test messages to qualify for HANG status (default is 10 minutes). yes
-n niceval Assign nice value to USEX window manager. yes
OPTION SHORT DESCRIPTION .usexrc
CAPABLE?
OPTION
DETAILS
-w Wire window manager pages in memory (root only). yes
-C Clean leftover USEX files without query. yes
-c Clean leftover USEX files and exit immediately after query. no
-q Quiet -- no beeps on error conditions, and do not check for leftover files. yes
--nostats Do not display any system statistics. yes
--nodisplay Do not display anything on the terminal screen; this option requires the use of either the -i filename, -b or -e options, and either -T minutes or a kill-time must be entered in the input file. Use -l filename and/or -R filename options to ascertain test results. no
-k Kill any leftover usex processes that are not attached to a running window manager. no
OPTION SHORT DESCRIPTION .usexrc
CAPABLE?
OPTION
DETAILS
-I Ignore exit returns from any bin test. yes
--binargs cmd,... Comma-separated list of specified commands for all bin tests to run. yes
--exclude cmd,... Comma-separated list of specified commands to exclude in all bin tests. yes
--io fsync,notrunc Comma-separated list of I/O test arguments, consisting of "fsync", which forces an explicit fsync() call after each write() call in the Fill cycle, and/or "notrunc", which negates the ftruncate() call after each read() call in the Trun cycle. yes
--vmem mb,ran|seq Comma-separated vmem test arguments in which "mb" is the number of megabytes to allocate (overrides any input file, interactive or -e setting); "ran" or "seq" sets the access mode to random or sequential (overrides any input file or -e setting). yes
--nolog io,bin,vmem,
dhry,whet,
rate,user
Comma-separated list of test types for which event logging should not be done when using the -l filename option. yes