xnu-1699.22.73.tar.gz

[apple/xnu.git] / tools / tests / xnu_quick_test / README

diff --git a/tools/tests/xnu_quick_test/README b/tools/tests/xnu_quick_test/README
index 3e15a5a91bdf2f5b9f95dfd4bf29285edfb6c2ef..3bf8a2d8fd15e903c2077b1883af52a6110a97b2 100644 (file)
--- a/tools/tests/xnu_quick_test/README
+++ b/tools/tests/xnu_quick_test/README
@@ -28,22 +28,24 @@ is 32 or 64 bits.
 
 NOTE - we have several workarounds and test exceptions for some
 outstanding bugs in xnu.  All the workarounds are marked with "todo" and
 
 NOTE - we have several workarounds and test exceptions for some
 outstanding bugs in xnu.  All the workarounds are marked with "todo" and

-some comments noting the radar number of the offending bug.  Do a seach
+some comments noting the radar number of the offending bug.  Do a search

 for "todo" in the source files for this project to locate which tests have
 known failures.   And please tag any new exceptions you find with "todo"
 in the comment and the radar number of the bug.
 
 for "todo" in the source files for this project to locate which tests have
 known failures.   And please tag any new exceptions you find with "todo"
 in the comment and the radar number of the bug.
 

-To build a fat binary, export ARCH="ppc ppc64 i386 x86_64". This will work
+To build a fat binary, export ARCH="i386 x86_64". This will work

 for any architectures that Apple gcc recognizes.
 
 for any architectures that Apple gcc recognizes.
 

-Added three defines which you can use at the compile line to build variants.
+Added four defines which you can use at the compile line to build variants.

 DEBUG
        turn on additional printfs
 CONFORMANCE_TESTS_IN_XNU 
        when conformance tests are in xnu, set this to 1
 TEST_SYSTEM_CALLS
        test system calls (doesn't compile; a different bug)
 DEBUG
        turn on additional printfs
 CONFORMANCE_TESTS_IN_XNU 
        when conformance tests are in xnu, set this to 1
 TEST_SYSTEM_CALLS
        test system calls (doesn't compile; a different bug)

-by default, all three are set to 0, i.e. disabled.  To build, export
+RUN_UNDER_TESTBOTS
+       when running under testbots, set this to 1              
+by default, all four are set to 0, i.e. disabled.  To build, export

 MORECFLAGS with the values you want set, e.g. 
        export MORECFLAGS="-D DEBUG=1 -D CONFORMANCE_TESTS_IN_XNU=1"
 
 MORECFLAGS with the values you want set, e.g. 
        export MORECFLAGS="-D DEBUG=1 -D CONFORMANCE_TESTS_IN_XNU=1"
 


@@ -59,7 +61,8 @@ USAGE:  xnu_quick_test -target TARGET_PATH
          -l[ist]                         # list all the tests this tool performs   
          -r[un] 1, 3, 10 - 19            # run specific tests.  enter individual test numbers and/or range of numbers.  use -list to list tests.   
          -s[kip]                         # skip setuid tests   
          -l[ist]                         # list all the tests this tool performs   
          -r[un] 1, 3, 10 - 19            # run specific tests.  enter individual test numbers and/or range of numbers.  use -list to list tests.   
          -s[kip]                         # skip setuid tests   

-         -t[arget] TARGET_PATH           # path to directory where tool will create test files.  defaults to "/tmp/"   
+         -t[arget] TARGET_PATH           # path to directory where tool will create test files.  defaults to "/tmp/"  
+        -x[ilog]                        # To run the xnu_quick_test with xilog reporting enabled. 

 
 examples:  
 --- Place all test files and directories at the root of volume "test_vol" --- 
 
 examples:  
 --- Place all test files and directories at the root of volume "test_vol" ---