Home | History | Annotate | Download | only in graphics
      1 page.title=Using special test groups
      2 @jd:body
      3 
      4 <!--
      5     Copyright 2015 The Android Open Source Project
      6 
      7     Licensed under the Apache License, Version 2.0 (the "License");
      8     you may not use this file except in compliance with the License.
      9     You may obtain a copy of the License at
     10 
     11         http://www.apache.org/licenses/LICENSE-2.0
     12 
     13     Unless required by applicable law or agreed to in writing, software
     14     distributed under the License is distributed on an "AS IS" BASIS,
     15     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     16     See the License for the specific language governing permissions and
     17     limitations under the License.
     18 -->
     19 
     20 <div id="qv-wrapper">
     21   <div id="qv">
     22     <h2>In this document</h2>
     23     <ol id="auto-toc">
     24     </ol>
     25   </div>
     26 </div>
     27 
     28 <p>Some test groups may need or support special command line options, or require
     29 special care when used on certain systems.</p>
     30 
     31 <h2 id=memory_allocation_stress_tests>Memory allocation stress tests</h2>
     32 
     33 <p>Memory allocation stress tests exercise out-of-memory conditions by repeatedly
     34 allocating certain resources until the driver reports an out-of-memory error.</p>
     35 
     36 <p>On certain platforms, such as Android and most Linux variants, the following
     37 can occur: The operating system may kill the test process instead of allowing a
     38 driver to handle or otherwise provide an out-of-memory error. On such
     39 platforms, tests that are designed to cause out-of-memory errors are disabled
     40 by default, and must be enabled using the  <code>--deqp-test-oom=enable</code> command line argument. 
     41 It is recommended that you run such tests manually to
     42 check if the system behaves correctly under resource pressure. However, in such
     43 a situation, a test process crash should be interpreted as a pass.</p>
     44 
     45 <h3 id=test_groups>Test groups</h3>
     46 
     47 <pre>
     48 dEQP-GLES2.stress.memory.*
     49 dEQP-GLES3.stress.memory.*
     50 </pre>
     51 
     52 <h2 id=long-running_rendering_stress_tests>Long-running rendering stress tests</h2>
     53 
     54 <p>Rendering stress tests are designed to reveal robustness issues under sustained
     55 rendering load. By default the tests will execute only a few iterations, but
     56 they can be configured to run indefinitely by supplying the <code>--deqp-test-iteration-count=-1</code> command line argument. The test watchdog should be disabled (<code>--deqp-watchdog=disable</code>) when running these tests for a long period of time.</p>
     57 
     58 <h3 id=test_groups2>Test groups</h3>
     59 
     60 <pre>
     61 dEQP-GLES2.stress.long.*
     62 dEQP-GLES3.stress.long.*
     63 </pre>
     64