DTrace Test Suite

dtest: The DTrace Test Suite

The DTrace test suite was created and is continually updated to aid DTrace development. Each time a new feature is added to DTrace or a change is made to fix a bug in DTrace, the developer should run the test suite to make sure no regressions are introduced; the developer should also integrate new tests that exercise the new feature or verify the bug fix.

Use

To use the DTrace test suite, first build it by going to usr/src/cmd/dtrace/test in your ON workspace and running dmake pkg. This will produce the SUNWdtrt package.

To install the package on a test machine, run pkgadd -d package-location as root.

As of build 62, the SUNWdtrt package is built by default and installed during BFU.

To run the test suite, as root on your test machine: cd /opt/SUNWdtrt and run bin/dtest. This will cause the DTrace test suite to execute. Each line of output represents a test executed. When all tests complete, it will emit a summary of the tests executed, passed and failed. There should be no failing tests. Any test failure will produce a directory containing a README file with the name of the test and reason for failure, and other test output. If you encounter a test failure in ON, check for a bug in the utility/dtest bug category whose synopsis is the contents of the README up to the initial semi-colon. For example:

ERROR: /opt/SUNWdtrt/tst/common/java_api/tst.Bean.ksh stdout mismatch

File the bug if it doesn't already exist. To repeat: we will try to make sure there are never failures.

Porting

The DTrace test suite was integrated into Solaris primarily as an aid to porting projects. Ports should use the DTrace test suite as the measuring stick by which they should be judged.