~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/testing/test-run.rst

Refactor

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. _test-run-label:
 
2
 
1
3
**********************************
2
4
test-run.pl - Drizzle testing tool
3
5
**********************************
172
174
Options to control what engine/variation to run
173
175
-----------------------------------------------
174
176
 
 
177
.. program:: test-run
 
178
 
175
179
.. option:: --compress
176
180
   
177
181
   Use the compressed protocol between client and server
187
191
Options to control directories to use
188
192
-------------------------------------
189
193
 
 
194
.. program:: test-run
 
195
 
190
196
.. option:: --benchdir=DIR          
191
197
 
192
198
   The directory where the benchmark suite is stored
210
216
   using a builtin list of standard locations
211
217
   for tmpfs (/dev/shm)
212
218
   The option can also be set using environment
213
 
   variable DTR_MEM=[DIR]
 
219
   variable :envvar:`DTR_MEM` =[DIR]
214
220
 
215
221
Options to control what test suites or cases to run
216
222
---------------------------------------------------
217
223
 
 
224
.. program:: test-run
 
225
 
218
226
.. option:: --force                 
219
227
   
220
228
   Continue to run the suite after failure
253
261
Options that specify ports
254
262
--------------------------
255
263
 
 
264
.. program:: test-run
 
265
 
256
266
.. option:: --master_port=PORT      
257
267
 
258
268
   Specify the port number used by the first master
264
274
.. option:: --dtr-build-thread=#    
265
275
 
266
276
   Specify unique collection of ports. Can also be set by
267
 
   setting the environment variable DTR_BUILD_THREAD.
 
277
   setting the environment variable :envvar:`DTR_BUILD_THREAD`.
268
278
 
269
279
Options for test case authoring
270
280
-------------------------------
271
281
 
 
282
.. program:: test-run
 
283
 
272
284
.. option:: --record TESTNAME       
273
285
 
274
286
   (Re)genereate the result file for TESTNAME
284
296
Options that pass on options
285
297
----------------------------
286
298
 
 
299
.. program:: test-run
 
300
 
287
301
.. option:: --drizzled=ARGS           
288
302
 
289
303
   Specify additional arguments to "drizzled"
291
305
Options to run test on running server
292
306
-------------------------------------
293
307
 
 
308
.. program:: test-run
 
309
 
294
310
.. option:: --extern                
295
311
 
296
312
   Use running server for tests
302
318
Options for debugging the product
303
319
---------------------------------
304
320
 
 
321
.. program:: test-run
 
322
 
305
323
.. option:: --client-ddd            
306
324
 
307
325
   Start drizzletest client in ddd
362
380
Options for coverage, profiling etc
363
381
-----------------------------------
364
382
 
365
 
.. option:: --gcov                  
 
383
.. todo::
 
384
   
 
385
   .. option:: --gcov                  
366
386
 
367
 
   FIXME
 
387
.. program:: test-run
368
388
 
369
389
.. option:: --gprof                 
370
390
 
415
435
Misc options
416
436
------------
417
437
 
 
438
.. program:: test-run
 
439
 
418
440
.. option:: --comment=STR           
419
441
 
420
442
   Write STR to the output