~ubuntu-branches/ubuntu/trusty/mysql-5.5/trusty-updates

« back to all changes in this revision

Viewing changes to man/mysqltest.1

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2016-07-20 14:03:48 UTC
  • mfrom: (1.1.27)
  • Revision ID: package-import@ubuntu.com-20160720140348-pkqf7esqccf1du6b
Tags: 5.5.50-0ubuntu0.14.04.1
* SECURITY UPDATE: Update to 5.5.50 to fix security issues (LP: #1604796)
  - http://www.oracle.com/technetwork/security-advisory/cpujul2016-2881720.html
  - CVE-2016-3477
  - CVE-2016-3521
  - CVE-2016-3615
  - CVE-2016-5440

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
'\" t
2
2
.\"     Title: \fBmysqltest\fR
3
3
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
5
 
.\"      Date: 02/29/2016
 
4
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
 
5
.\"      Date: 05/13/2016
6
6
.\"    Manual: MySQL Database System
7
7
.\"    Source: MySQL
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "\FBMYSQLTEST\FR" "1" "02/29/2016" "MySQL" "MySQL Database System"
 
10
.TH "\FBMYSQLTEST\FR" "1" "05/13/2016" "MySQL" "MySQL Database System"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
27
27
.\" -----------------------------------------------------------------
28
28
.\" * MAIN CONTENT STARTS HERE *
29
29
.\" -----------------------------------------------------------------
30
 
.\" mysqltest
31
 
.\" mysqltest_embedded
32
30
.SH "NAME"
33
31
mysqltest \- program to run test cases
34
32
.br
152
150
.sp -1
153
151
.IP \(bu 2.3
154
152
.\}
155
 
.\" mysqltest: help option
156
 
.\" help option: mysqltest
157
153
\fB\-\-help\fR,
158
154
\fB\-?\fR
159
155
.sp
168
164
.sp -1
169
165
.IP \(bu 2.3
170
166
.\}
171
 
.\" mysqltest: basedir option
172
 
.\" basedir option: mysqltest
173
167
\fB\-\-basedir=\fR\fB\fIdir_name\fR\fR,
174
168
\fB\-b \fR\fB\fIdir_name\fR\fR
175
169
.sp
184
178
.sp -1
185
179
.IP \(bu 2.3
186
180
.\}
187
 
.\" mysqltest: character-sets-dir option
188
 
.\" character-sets-dir option: mysqltest
189
181
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
190
182
.sp
191
183
The directory where character sets are installed\&.
199
191
.sp -1
200
192
.IP \(bu 2.3
201
193
.\}
202
 
.\" mysqltest: compress option
203
 
.\" compress option: mysqltest
204
194
\fB\-\-compress\fR,
205
195
\fB\-C\fR
206
196
.sp
215
205
.sp -1
216
206
.IP \(bu 2.3
217
207
.\}
218
 
.\" mysqltest: currsor-protocol option
219
 
.\" cursor-protocol option: mysqltest
220
208
\fB\-\-cursor\-protocol\fR
221
209
.sp
222
210
Use cursors for prepared statements\&.
230
218
.sp -1
231
219
.IP \(bu 2.3
232
220
.\}
233
 
.\" mysqltest: database option
234
 
.\" database option: mysqltest
235
221
\fB\-\-database=\fR\fB\fIdb_name\fR\fR,
236
222
\fB\-D \fR\fB\fIdb_name\fR\fR
237
223
.sp
246
232
.sp -1
247
233
.IP \(bu 2.3
248
234
.\}
249
 
.\" mysqltest: debug option
250
 
.\" debug option: mysqltest
251
235
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
252
236
\fB\-#[\fR\fB\fIdebug_options\fR\fR\fB]\fR
253
237
.sp
265
249
.sp -1
266
250
.IP \(bu 2.3
267
251
.\}
268
 
.\" mysqltest: debug-check option
269
 
.\" debug-check option: mysqltest
270
252
\fB\-\-debug\-check\fR
271
253
.sp
272
254
Print some debugging information when the program exits\&.
280
262
.sp -1
281
263
.IP \(bu 2.3
282
264
.\}
283
 
.\" mysqltest: debug-info option
284
 
.\" debug-info option: mysqltest
285
265
\fB\-\-debug\-info\fR
286
266
.sp
287
267
Print debugging information and memory and CPU usage statistics when the program exits\&.
295
275
.sp -1
296
276
.IP \(bu 2.3
297
277
.\}
298
 
.\" mysqltest: explain-protocol option
299
 
.\" explain-protocol option: mysqltest
300
278
\fB\-\-explain\-protocol\fR,
301
279
.sp
302
280
Run
312
290
.sp -1
313
291
.IP \(bu 2.3
314
292
.\}
315
 
.\" mysqltest: host option
316
 
.\" host option: mysqltest
317
293
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
318
294
\fB\-h \fR\fB\fIhost_name\fR\fR
319
295
.sp
328
304
.sp -1
329
305
.IP \(bu 2.3
330
306
.\}
331
 
.\" mysqltest: include option
332
 
.\" include option: mysqltest
333
307
\fB\-\-include=\fR\fB\fIfile_name\fR\fR,
334
308
\fB\-i \fR\fB\fIfile_name\fR\fR
335
309
.sp
348
322
.sp -1
349
323
.IP \(bu 2.3
350
324
.\}
351
 
.\" mysqltest: json-explain-protocol option
352
 
.\" json-explain-protocol option: mysqltest
353
325
\fB\-\-json\-explain\-protocol\fR,
354
326
.sp
355
327
Run
367
339
.sp -1
368
340
.IP \(bu 2.3
369
341
.\}
370
 
.\" mysqltest: logdir option
371
 
.\" logdir option: mysqltest
372
342
\fB\-\-logdir=\fR\fB\fIdir_name\fR\fR
373
343
.sp
374
344
The directory to use for log files\&.
382
352
.sp -1
383
353
.IP \(bu 2.3
384
354
.\}
385
 
.\" mysqltest: mark-progress option
386
 
.\" mark-progress option: mysqltest
387
355
\fB\-\-mark\-progress\fR
388
356
.sp
389
357
Write the line number and elapsed time to
398
366
.sp -1
399
367
.IP \(bu 2.3
400
368
.\}
401
 
.\" mysqltest: max-connect-retries option
402
 
.\" max-connect-retries option: mysqltest
403
369
\fB\-\-max\-connect\-retries=\fR\fB\fInum\fR\fR
404
370
.sp
405
371
The maximum number of connection attempts when connecting to server\&.
413
379
.sp -1
414
380
.IP \(bu 2.3
415
381
.\}
416
 
.\" mysqltest: max-connections option
417
 
.\" max-connections option: mysqltest
418
382
\fB\-\-max\-connections=\fR\fB\fInum\fR\fR
419
383
.sp
420
384
The maximum number of simultaneous server connections per client (that is, per test)\&. If not set, the maximum is 128\&. Minimum allowed limit is 8, maximum is 5120\&.
428
392
.sp -1
429
393
.IP \(bu 2.3
430
394
.\}
431
 
.\" mysqltest: no-defaults option
432
 
.\" no-defaults option: mysqltest
433
395
\fB\-\-no\-defaults\fR
434
396
.sp
435
397
Do not read default options from any option files\&. If used, this must be the first option\&.
443
405
.sp -1
444
406
.IP \(bu 2.3
445
407
.\}
446
 
.\" mysqltest: plugin-dir option
447
 
.\" plugin-dir option: mysqltest
448
408
\fB\-\-plugin\-dir=\fR\fB\fIpath\fR\fR
449
409
.sp
450
410
The directory in which to look for plugins\&. It may be necessary to specify this option if the
464
424
.sp -1
465
425
.IP \(bu 2.3
466
426
.\}
467
 
.\" mysqltest: password option
468
 
.\" password option: mysqltest
469
427
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
470
428
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
471
429
.sp
488
446
.sp -1
489
447
.IP \(bu 2.3
490
448
.\}
491
 
.\" mysqltest: port option
492
 
.\" port option: mysqltest
493
449
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
494
450
\fB\-P \fR\fB\fIport_num\fR\fR
495
451
.sp
504
460
.sp -1
505
461
.IP \(bu 2.3
506
462
.\}
507
 
.\" mysqltest: protocol option
508
 
.\" protocol option: mysqltest
509
463
\fB\-\-protocol=\fR\fB{TCP|SOCKET|PIPE|MEMORY}\fR
510
464
.sp
511
465
Choose the protocol for communication with the server\&.
525
479
.sp -1
526
480
.IP \(bu 2.3
527
481
.\}
528
 
.\" mysqltest: ps-protocol option
529
 
.\" ps-protocol option: mysqltest
530
482
\fB\-\-ps\-protocol\fR
531
483
.sp
532
484
Use the prepared\-statement protocol for communication\&.
540
492
.sp -1
541
493
.IP \(bu 2.3
542
494
.\}
543
 
.\" mysqltest: quiet option
544
 
.\" quiet option: mysqltest
545
495
\fB\-\-quiet\fR
546
496
.sp
547
497
Suppress all normal output\&. This is a synonym for
548
 
.\" mysqltest: silent option
549
 
.\" silent option: mysqltest
550
498
\fB\-\-silent\fR\&.
551
499
.RE
552
500
.sp
558
506
.sp -1
559
507
.IP \(bu 2.3
560
508
.\}
561
 
.\" mysqltest: record option
562
 
.\" record option: mysqltest
563
509
\fB\-\-record\fR,
564
510
\fB\-r\fR
565
511
.sp
577
523
.sp -1
578
524
.IP \(bu 2.3
579
525
.\}
580
 
.\" mysqltest: result-file option
581
 
.\" result-file option: mysqltest
582
526
\fB\-\-result\-file=\fR\fB\fIfile_name\fR\fR,
583
527
\fB\-R \fR\fB\fIfile_name\fR\fR
584
528
.sp
663
607
.sp -1
664
608
.IP \(bu 2.3
665
609
.\}
666
 
.\" mysqltest: server-arg option
667
 
.\" server-arg option: mysqltest
668
610
\fB\-\-server\-arg=\fR\fB\fIvalue\fR\fR,
669
611
\fB\-A \fR\fB\fIvalue\fR\fR
670
612
.sp
682
624
.sp -1
683
625
.IP \(bu 2.3
684
626
.\}
685
 
.\" mysqltest: server-file option
686
 
.\" server-file option: mysqltest
687
627
\fB\-\-server\-file=\fR\fB\fIfile_name\fR\fR,
688
628
\fB\-F \fR\fB\fIfile_name\fR\fR
689
629
.sp
698
638
.sp -1
699
639
.IP \(bu 2.3
700
640
.\}
701
 
.\" mysqltest: server-public-key-path option
702
 
.\" server-public-key-path option: mysqltest
703
641
\fB\-\-server\-public\-key\-path=\fR\fBfile_name\fR
704
642
.sp
705
643
The path name to a file containing the server RSA public key\&. The file must be in PEM format\&. The public key is used for RSA encryption of the client password for connections to the server made using accounts that authenticate with the
727
665
.sp -1
728
666
.IP \(bu 2.3
729
667
.\}
730
 
.\" mysqltest: silent option
731
 
.\" silent option: mysqltest
732
668
\fB\-\-silent\fR,
733
669
\fB\-s\fR
734
670
.sp
743
679
.sp -1
744
680
.IP \(bu 2.3
745
681
.\}
746
 
.\" mysqltest: skip-safemalloc option
747
 
.\" skip-safemalloc option: mysqltest
748
682
\fB\-\-skip\-safemalloc\fR
749
683
.sp
750
684
Do not use memory allocation checking\&.
758
692
.sp -1
759
693
.IP \(bu 2.3
760
694
.\}
761
 
.\" mysqltest: sleep option
762
 
.\" sleep option: mysqltest
763
695
\fB\-\-sleep=\fR\fB\fInum\fR\fR,
764
696
\fB\-T \fR\fB\fInum\fR\fR
765
697
.sp
784
716
.sp -1
785
717
.IP \(bu 2.3
786
718
.\}
787
 
.\" mysqltest: socket option
788
 
.\" socket option: mysqltest
789
719
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
790
720
\fB\-S \fR\fB\fIpath\fR\fR
791
721
.sp
802
732
.sp -1
803
733
.IP \(bu 2.3
804
734
.\}
805
 
.\" mysqltest: sp-protocol option
806
 
.\" sp-protocol option: mysqltest
807
735
\fB\-\-sp\-protocol\fR
808
736
.sp
809
737
Execute DML statements within a stored procedure\&. For every DML statement,
819
747
.sp -1
820
748
.IP \(bu 2.3
821
749
.\}
822
 
.\" mysqltest: tail-lines option
823
 
.\" tail-lines option: mysqltest
824
750
\fB\-\-tail\-lines=\fR\fB\fInn\fR\fR
825
751
.sp
826
752
Specify how many lines of the result to include in the output if the test fails because an SQL statement fails\&. The default is 0, meaning no lines of result printed\&.
834
760
.sp -1
835
761
.IP \(bu 2.3
836
762
.\}
837
 
.\" mysqltest: test-file option
838
 
.\" test-file option: mysqltest
839
763
\fB\-\-test\-file=\fR\fB\fIfile_name\fR\fR,
840
764
\fB\-x \fR\fB\fIfile_name\fR\fR
841
765
.sp
850
774
.sp -1
851
775
.IP \(bu 2.3
852
776
.\}
853
 
.\" mysqltest: timer-file option
854
 
.\" timer-file option: mysqltest
855
777
\fB\-\-timer\-file=\fR\fB\fIfile_name\fR\fR,
856
778
\fB\-m \fR\fB\fIfile_name\fR\fR
857
779
.sp
868
790
.sp -1
869
791
.IP \(bu 2.3
870
792
.\}
871
 
.\" mysqltest: tls-version option
872
 
.\" tls-version option: mysqltest
873
793
\fB\-\-tls\-version=\fR\fB\fIprotocol_list\fR\fR
874
794
.sp
875
795
The protocols permitted by the client for encrypted connections\&. The value is a comma\-separated list containing one or more of these protocols: TLSv1, TLSv1\&.1, TLSv1\&.2\&. (TLSv1\&.2 is supported only if MySQL was compiled using OpenSSL 1\&.0\&.1 or higher\&. It is not supported if MySQL was compiled using yaSSL\&.)
885
805
.sp -1
886
806
.IP \(bu 2.3
887
807
.\}
888
 
.\" mysqltest: tmpdir option
889
 
.\" tmpdir option: mysqltest
890
808
\fB\-\-tmpdir=\fR\fB\fIdir_name\fR\fR,
891
809
\fB\-t \fR\fB\fIdir_name\fR\fR
892
810
.sp
901
819
.sp -1
902
820
.IP \(bu 2.3
903
821
.\}
904
 
.\" mysqltest: trace-exec option
905
 
.\" trace-exec option: mysqltest
906
822
\fB\-\-trace\-exec\fR
907
823
.sp
908
824
If enabled, this option causes
921
837
.sp -1
922
838
.IP \(bu 2.3
923
839
.\}
924
 
.\" mysqltest: user option
925
 
.\" user option: mysqltest
926
840
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
927
841
\fB\-u \fR\fB\fIuser_name\fR\fR
928
842
.sp
937
851
.sp -1
938
852
.IP \(bu 2.3
939
853
.\}
940
 
.\" mysqltest: verbose option
941
 
.\" verbose option: mysqltest
942
854
\fB\-\-verbose\fR,
943
855
\fB\-v\fR
944
856
.sp
953
865
.sp -1
954
866
.IP \(bu 2.3
955
867
.\}
956
 
.\" mysqltest: version option
957
 
.\" version option: mysqltest
958
868
\fB\-\-version\fR,
959
869
\fB\-V\fR
960
870
.sp
969
879
.sp -1
970
880
.IP \(bu 2.3
971
881
.\}
972
 
.\" mysqltest: view-protocol option
973
 
.\" view-protocol option: mysqltest
974
882
\fB\-\-view\-protocol\fR
975
883
.sp
976
884
Every