~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/options.rst

  • Committer: Mark Atwood
  • Date: 2011-10-08 04:50:51 UTC
  • mfrom: (2430.1.1 rf)
  • Revision ID: me@mark.atwood.name-20111008045051-6ha1qiy7k2a9c3jv
Tags: 2011.10.27
mergeĀ lp:~olafvdspek/drizzle/refactor2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. _options:
 
2
 
 
3
Drizzled Options
 
4
================
 
5
 
 
6
There are many different options one can use to configure Drizzle.
 
7
 
 
8
Config File Options
 
9
-------------------
 
10
 
1
11
.. program:: drizzled
2
12
 
3
 
.. _drizzled_configuration:
4
 
 
5
 
drizzled Configuration
6
 
======================
7
 
 
8
 
.. _drizzled_options:
9
 
 
10
 
Options
11
 
-------
12
 
 
13
 
.. _drizzled_gneral_options:
14
 
 
15
 
General Options
16
 
^^^^^^^^^^^^^^^
 
13
.. option:: --help-extended
 
14
 
 
15
   Display this help and exit after initializing plugins.
17
16
 
18
17
.. option:: --help, -?
19
18
 
20
19
   Display this help and exit.
21
20
 
22
 
.. option:: --help-extended
23
 
 
24
 
   Display this help and exit after initializing plugins.
25
 
 
26
 
.. _drizzled_config_file_options:
27
 
 
28
 
Config File Options
29
 
^^^^^^^^^^^^^^^^^^^
30
 
 
31
 
.. option:: --config-dir DIR
32
 
 
33
 
   :Default: :file:`/etc/drizzle`
34
 
   :Variable: 
35
 
 
36
 
   Base location for config files.
37
 
 
38
 
.. option:: --defaults-file FILE
39
 
   
40
 
   :Default:
41
 
   :Variable: 
42
 
 
43
 
   Configuration file to use.
44
 
 
45
21
.. option:: --no-defaults
46
22
 
47
 
   :Default:
48
 
   :Variable: 
49
 
 
50
 
   Configuration file defaults are not used if no-defaults is set.
51
 
 
52
 
.. _drizzled_plugin_options:
53
 
 
54
 
Plugin Options
55
 
^^^^^^^^^^^^^^
56
 
 
57
 
.. option:: --plugin-add LIST
58
 
 
59
 
   :Default:
60
 
   :Variable: 
 
23
   Configuration file defaults are not used if no-defaults is set
 
24
 
 
25
.. option:: --defaults-file arg
 
26
 
 
27
   Configuration file to use
 
28
 
 
29
.. option:: --config-dir arg (=/etc/drizzle)
 
30
 
 
31
   Base location for config files
 
32
 
 
33
.. option:: --plugin-dir arg
 
34
 
 
35
   Directory for plugins
 
36
 
 
37
.. option:: --pid-file arg
 
38
 
 
39
   Pid file used by drizzled.
 
40
 
 
41
Plugin Loading Options
 
42
----------------------
 
43
 
 
44
.. program:: drizzled
 
45
 
 
46
.. option:: --plugin-add arg
61
47
 
62
48
   Optional comma separated list of plugins to load at startup in addition
63
49
   to the default list of plugins.
66
52
 
67
53
     --plugin_add=crc32,console,pbxt
68
54
 
69
 
.. option:: --plugin-dir DIR
70
 
 
71
 
   :Default:
72
 
   :Variable: 
73
 
 
74
 
   Directory for plugins.
75
 
 
76
 
.. option:: --plugin-load LIST
77
 
 
78
 
   :Default: See :ref:`default_plugins`
79
 
   :Variable: 
80
 
 
81
 
   Optional comma separated list of plugins to load at starup instead of 
82
 
   the default plugin load list. This completely replaces the whole list.
83
 
 
84
 
.. option:: --plugin-remove LIST
85
 
 
86
 
   :Default:
87
 
   :Variable: 
 
55
.. option:: --plugin-remove arg
88
56
 
89
57
   Optional comma separated list of plugins to not load at startup.
90
58
   Effectively removes a plugin from the list of plugins to be loaded.
93
61
 
94
62
     --plugin_remove=syslog,md5
95
63
 
96
 
.. _drizzled_kernel_options:
 
64
.. option:: --plugin-load arg (=version, uuid_function, user_function, transaction_log, syslog, substr_functions, sleep, show_schema_proto, rot13, reverse_function, rand_function, multi_thread, md5, logging_stats, length, hex_functions, hello_world, filtered_replicator, errmsg_stderr, default_replicator, database_function, crc32, connection_id, compression, charlength, benchmark, ascii)
 
65
 
 
66
   Optional comma separated list of plugins to load at starup instead of 
 
67
   the default plugin load list. This completely replaces the whole list.
97
68
 
98
69
Kernel Options
99
 
^^^^^^^^^^^^^^
100
 
 
101
 
.. option:: --auto-increment-increment ARG
102
 
 
103
 
   :Default: 1
104
 
   :Variable: ``auto_increment_increment``
105
 
 
 
70
--------------
 
71
 
 
72
.. program:: drizzled
 
73
 
 
74
.. option:: --auto-increment-increment arg (=1)
 
75
  
106
76
   Auto-increment columns are incremented by this
107
77
 
108
 
.. option:: --auto-increment-offset ARG
109
 
 
110
 
   :Default: 1
111
 
   :Variable: ``auto_increment_offset``
 
78
.. option:: --auto-increment-offset arg (=1)
112
79
 
113
80
   Offset added to Auto-increment columns.
114
81
   Used when auto-increment-increment != 1
115
82
 
116
 
.. option:: --back-log ARG
117
 
 
118
 
   :Default: 50
119
 
   :Variable: ``back_log``
120
 
 
121
 
   The number of outstanding connection requests Drizzle can have. This comes
122
 
   into play when the main Drizzle thread gets very many connection requests in
123
 
   a very short time.
124
 
 
125
 
.. option:: --basedir, -b ARG
126
 
 
127
 
   :Default:
128
 
   :Variable: ``basedir``
 
83
.. option:: --basedir, -b arg
129
84
 
130
85
   Path to installation directory.
131
86
   All paths are usually resolved relative to this.
132
87
 
133
 
.. option:: --bulk-insert-buffer-size SIZE
134
 
 
135
 
   :Default: 8388608
136
 
   :Variable: ``bulk_insert_buffer_size``
137
 
 
138
 
   Size of tree cache used in bulk insert optimization. Note that this is a
139
 
   limit per thread!
140
 
 
141
 
.. option:: --chroot, -r ARG
142
 
 
143
 
   :Default:
144
 
   :Variable: 
 
88
.. option:: --chroot, -r arg
145
89
 
146
90
   Chroot drizzled daemon during startup.
147
91
 
148
 
.. option:: --collation-server ARG
149
 
 
150
 
   :Default:
151
 
   :Variable: ``collation_server``
 
92
.. option:: --collation-server arg
152
93
 
153
94
   Set the default collation.
154
95
 
155
 
.. option:: --completion-type ARG
156
 
 
157
 
   :Default: 0
158
 
   :Variable: ``completion_type``
159
 
 
160
 
   Unknown.
 
96
.. option:: --completion-type arg (=0)
 
97
 
 
98
   Default completion type.
161
99
 
162
100
.. option:: --core-file
163
101
 
164
 
   :Default:
165
 
   :Variable: 
166
 
 
167
102
   Write core on errors.
168
103
 
169
 
.. option:: --datadir ARG
170
 
 
171
 
   :Default:
172
 
   :Variable: ``datadir``
 
104
.. option:: --datadir arg
173
105
 
174
106
   Path to the database root.
175
107
 
176
 
.. option:: --default-storage-engine ARG
177
 
 
178
 
   :Default: InnoDB
179
 
   :Variable: ``storage_engine``
 
108
.. option:: --default-storage-engine arg
180
109
 
181
110
   Set the default storage engine for tables.
182
111
 
183
 
.. option:: --default-time-zone ARG
184
 
 
185
 
   :Default:
186
 
   :Variable: 
 
112
.. option:: --default-time-zone arg
187
113
 
188
114
   Set the default time zone.
189
115
 
190
 
.. option:: --disable-optimizer-prune
191
 
 
192
 
   :Default:
193
 
   :Variable: ``optimizer_prune_level``
194
 
 
195
 
   Do not apply any heuristic(s) during query optimization to prune, thus
196
 
   perform an exhaustive search from the optimizer search space.
197
 
 
198
 
.. option:: --div-precision-increment ARG
199
 
 
200
 
   :Default: 4
201
 
   :Variable: ``div_precision_increment``
202
 
  
203
 
   Precision of the result of '/' operator will be increased on that value.
204
 
 
205
116
.. We should really remove --exit-info as an option
206
 
.. option:: --exit-info, -T ARG
207
 
 
208
 
   :Default:
209
 
   :Variable: 
 
117
.. option:: --exit-info, -T arg
210
118
 
211
119
   Used for debugging;  Use at your own risk!
212
120
 
213
121
.. option:: --gdb
214
122
 
215
 
   :Default:
216
 
   :Variable: 
217
 
 
218
 
   Set up signals usable for debugging.
219
 
 
220
 
.. option:: --group-concat-max-len ARG
221
 
 
222
 
   :Default: 1024
223
 
   :Variable: ``group_concat_max_len``
 
123
   Set up signals usable for debugging
 
124
 
 
125
.. option:: --lc-time-name arg
 
126
 
 
127
   Set the language used for the month names and the days of the week.
 
128
 
 
129
.. option:: --log-warnings, -W arg
 
130
 
 
131
   Log some not critical warnings to the log file.
 
132
 
 
133
.. Why is this a core argument?
 
134
.. option:: --port-open-timeout arg (=0)
 
135
 
 
136
   Maximum time in seconds to wait for the port to become free.
 
137
   A value of 0 means not to wait.
 
138
 
 
139
.. option:: --secure-file-priv arg
 
140
 
 
141
   Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
 
142
   specified directory
 
143
 
 
144
.. Why is this still here?
 
145
.. option:: --server-id arg (=0)
 
146
 
 
147
   Uniquely identifies the server instance in the community of replication
 
148
   partners.
 
149
 
 
150
.. option:: --skip-stack-trace
 
151
 
 
152
   Don't print a stack trace on failure.
 
153
 
 
154
.. option:: --symbolic-links, -s
 
155
 
 
156
   Enable symbolic link support.
 
157
 
 
158
.. option:: --timed-mutexes
 
159
 
 
160
   Specify whether to time mutexes (only InnoDB mutexes are currently supported)
 
161
 
 
162
.. option:: --tmpdir, -t arg
 
163
 
 
164
   Path for temporary files.
 
165
 
 
166
.. option:: --transaction-isolation arg
 
167
 
 
168
   Default transaction isolation level.
 
169
 
 
170
.. option:: --user, -u arg
 
171
 
 
172
   Run drizzled daemon as user.
 
173
  
 
174
.. option:: --version, -V
 
175
 
 
176
   Output version information and exit.
 
177
 
 
178
.. option:: --back-log arg (=50)
 
179
 
 
180
   The number of outstanding connection requests Drizzle can have. This comes
 
181
   into play when the main Drizzle thread gets very many connection requests in
 
182
   a very short time.
 
183
 
 
184
.. option:: --bulk-insert-buffer-size arg (=8388608)
 
185
  
 
186
   Size of tree cache used in bulk insert optimization. Note that this is a
 
187
   limit per thread!
 
188
 
 
189
.. option:: --div-precision-increment arg (=4)
 
190
  
 
191
   Precision of the result of '/' operator will be increased on that value.
 
192
 
 
193
.. option:: --group-concat-max-len arg (=1024)
224
194
 
225
195
   The maximum length of the result of function  group_concat.
226
196
 
227
 
.. option:: --join-buffer-constraint ARG
228
 
 
229
 
   :Default: 0
230
 
   :Variable: 
 
197
.. option:: --join-buffer-size arg (=131072)
 
198
 
 
199
   The size of the buffer that is used for full joins.
 
200
 
 
201
.. option:: --join-buffer-constraint arg (=0)
231
202
 
232
203
   A global constraint for join-buffer-size for all clients, cannot be set lower
233
 
   than :option:`--join-buffer-size`.  Setting to 0 means unlimited.
234
 
 
235
 
.. option:: --join-buffer-size SIZE
236
 
 
237
 
   :Default: 131072
238
 
   :Variable: ``join_buffer_size``
239
 
 
240
 
   The size of the buffer that is used for full joins.
241
 
 
242
 
.. option:: --lc-time-name ARG
243
 
 
244
 
   :Default:
245
 
   :Variable: ``lc_time_names``
246
 
 
247
 
   Set the language used for the month names and the days of the week.
248
 
 
249
 
.. option:: --log-warnings, -W ARG
250
 
 
251
 
   :Default:
252
 
   :Variable: 
253
 
 
254
 
   Log some not critical warnings to the log file.
255
 
 
256
 
.. Why is this a core ARG?
257
 
.. option:: --max-allowed-packet SIZE
258
 
 
259
 
   :Default: 64M
260
 
   :Variable: ``max_allowed_packet``
 
204
   than --join-buffer-size.  Setting to 0 means unlimited.
 
205
 
 
206
.. Why is this a core arg?
 
207
.. option:: --max-allowed-packet arg (=64M)
261
208
 
262
209
   Max packetlength to send/receive from to server.
263
210
 
264
 
.. option:: --max-connect-errors ARG
265
 
 
266
 
   :Default: 10
267
 
   :Variable: 
 
211
.. option:: --max-connect-errors arg (=10)
268
212
 
269
213
   If there is more than this number of interrupted connections from a host 
270
214
   this host will be blocked from further connections.
271
215
 
272
 
.. option:: --max-error-count ARG
273
 
 
274
 
   :Default: 64
275
 
   :Variable: ``max_error_count``
 
216
.. option:: --max-error-count arg (=64)
276
217
 
277
218
   Max number of errors/warnings to store for a statement.
278
219
 
279
 
.. option:: --max-heap-table-size SIZE
280
 
 
281
 
   :Default: 16M
282
 
   :Variable: ``max_heap_table_size``
 
220
.. option:: --max-heap-table-size arg (=16M)
283
221
 
284
222
   Don't allow creation of heap tables bigger than this.
285
223
 
286
 
.. option:: --max-join-size SIZE
287
 
 
288
 
   :Default: 2147483647
289
 
   :Variable: ``max_join_size``
 
224
.. option:: --max-join-size arg (=2147483647)
290
225
 
291
226
   Joins that are probably going to read more than max_join_size records return 
292
227
   an error.
293
228
 
294
 
.. option:: --max-length-for-sort-data SIZE
295
 
 
296
 
   :Default: 1024
297
 
   :Variable: ``max_length_for_sort_data``
 
229
.. option:: --max-length-for-sort-data arg (=1024)
298
230
 
299
231
   Max number of bytes in sorted records.
300
 
 
301
 
.. option:: --max-seeks-for-key ARG
302
 
 
303
 
   :Default: -1
304
 
   :Variable: ``max_seeks_for_key``
305
 
 
306
 
   Limit assumed max number of seeks when looking up rows based on a key.
307
 
   Set to -1 to disable.
308
 
 
309
 
.. option:: --max-sort-length SIZE
310
 
 
311
 
   :Default: 1024
312
 
   :Variable: ``max_sort_length``
 
232
  
 
233
.. option:: --max-seeks-for-key arg (=18446744073709551615)
 
234
 
 
235
   Limit assumed max number of seeks when looking up rows based on a key
 
236
 
 
237
.. option:: --max-sort-length arg (=1024)
313
238
 
314
239
   The number of bytes to use when sorting BLOB or TEXT values (only the first 
315
240
   max_sort_length bytes of each value are used; the rest are ignored).
316
241
 
317
 
.. option:: --max-write-lock-count ARG
318
 
 
319
 
   :Default: -1
320
 
   :Variable: ``max_write_lock_count``
 
242
.. option:: --max-write-lock-count arg (=18446744073709551615)
321
243
 
322
244
   After this many write locks, allow some read locks to run in between.
323
 
   Set to -1 to disable.
324
 
 
325
 
.. option:: --min-examined-row-limit ARG
326
 
 
327
 
   :Default: 0
328
 
   :Variable: ``min_examined_row_limit``
 
245
 
 
246
.. option:: --min-examined-row-limit arg (=0)
329
247
 
330
248
   Don't log queries which examine less than min_examined_row_limit rows to
331
249
   file.
332
250
 
333
 
.. option:: --optimizer-search-depth ARG
334
 
 
335
 
   :Default: 0
336
 
   :Variable: ``optimizer_search_depth``
 
251
.. option:: --disable-optimizer-prune
 
252
 
 
253
   Do not apply any heuristic(s) during query optimization to prune, thus
 
254
   perform an exhaustive search from the optimizer search space.
 
255
 
 
256
.. option:: --optimizer-search-depth arg (=0)
337
257
 
338
258
   Maximum depth of search performed by the query optimizer. Values larger than
339
259
   the number of relations in a query result in better query plans, but take
343
263
   MAX_TABLES+2, the optimizer will switch to the original find_best (used for
344
264
   testing/comparison).
345
265
 
346
 
.. option:: --pid-file FILE
347
 
   
348
 
   :Default:
349
 
   :Variable: ``pid_file``
350
 
 
351
 
   PID file used by :program:`drizzled`.
352
 
 
353
 
.. Why is this a core argument?
354
 
.. option:: --port-open-timeout ARG
355
 
 
356
 
   :Default: 0
357
 
   :Variable: 
358
 
 
359
 
   Maximum time in seconds to wait for the port to become free.
360
 
   A value of 0 means not to wait.
361
 
 
362
 
.. option:: --preload-buffer-size SIZE
363
 
 
364
 
   :Default: 32768
365
 
   :Variable: ``preload_buffer_size``
366
 
 
367
 
   The size of the buffer that is allocated when preloading indexes.
368
 
 
369
 
.. option:: --query-alloc-block-size SIZE
370
 
 
371
 
   :Default: 8192
372
 
   :Variable: ``query_alloc_block_size``
373
 
 
374
 
   Allocation block size for query parsing and execution.
375
 
 
376
 
.. option:: --query-prealloc-size SIZE
377
 
 
378
 
   :Default: 8192
379
 
   :Variable: ``query_prealloc_size``
380
 
 
381
 
   Persistent buffer for query parsing and execution.
382
 
 
383
 
.. option:: --range-alloc-block-size SIZE
384
 
 
385
 
   :Default: 4096
386
 
   :Variable: ``range_alloc_block_size``
387
 
 
388
 
   Allocation block size for storing ranges during optimization.
389
 
 
390
 
.. option:: --read-buffer-constraint ARG
391
 
 
392
 
   :Default: 0
393
 
   :Variable: 
394
 
 
395
 
   A global constraint for read-buffer-size for all clients, cannot be set lower
396
 
   than --read-buffer-size.  Setting to 0 means unlimited.
397
 
 
398
 
.. option:: --read-buffer-size SIZE
399
 
 
400
 
   :Default: 131072
401
 
   :Variable: ``read_buffer_size``
 
266
.. option:: --preload-buffer-size arg (=32768)
 
267
 
 
268
   The size of the buffer that is allocated when preloading indexes
 
269
 
 
270
.. option:: --query-alloc-block-size arg (=8192)
 
271
 
 
272
   Allocation block size for query parsing and execution
 
273
 
 
274
.. option:: --query-prealloc-size arg (=8192)
 
275
 
 
276
   Persistent buffer for query parsing and execution
 
277
 
 
278
.. option:: --range-alloc-block-size arg (=4096)
 
279
 
 
280
   Allocation block size for storing ranges during optimization
 
281
 
 
282
.. option:: --read-buffer-size arg (=131072)
402
283
 
403
284
   Each thread that does a sequential scan allocates a buffer of this size for
404
285
   each table it scans. If you do many sequential scans, you may want to
405
286
   increase this value.  Note that this only affect MyISAM.
406
287
 
407
 
.. option:: --read-rnd-buffer-size SIZE
408
 
 
409
 
   :Default: 262144
410
 
   :Variable: ``read_rnd_buffer_size``
 
288
.. option:: --read-buffer-constraint arg (=0)
 
289
 
 
290
   A global constraint for read-buffer-size for all clients, cannot be set lower
 
291
   than --read-buffer-size.  Setting to 0 means unlimited.
 
292
 
 
293
.. option:: --read-rnd-buffer-size arg (=262144)
411
294
 
412
295
   When reading rows in sorted order after a sort, the rows are read through
413
296
   this buffer to avoid a disk seeks. If not set, then it's set to the value of
414
297
   record_buffer.
415
298
 
416
 
.. option:: --read-rnd-constraint ARG
417
 
 
418
 
   :Default: 0
419
 
   :Variable: 
 
299
.. option:: --read-rnd-constraint arg (=0)
420
300
 
421
301
   A global constraint for read-rnd-buffer-size for all clients, cannot be set
422
302
   lower than --read-rnd-buffer-size.  Setting to 0 means unlimited.
423
303
 
424
 
.. option:: --replicate-query
425
 
 
426
 
   :Default:
427
 
   :Variable: ``replicate_query``
428
 
   
429
 
   Include the SQL query in replicated protobuf messages.
430
 
 
431
 
.. option:: --scheduler ARG
432
 
 
433
 
   :Default: multi-thread
434
 
   :Variable: ``scheduler``
 
304
.. option:: --scheduler arg (=multi-thread)
435
305
 
436
306
   Select scheduler to be used.
437
307
 
438
 
.. option:: --secure-file-priv ARG
439
 
 
440
 
   :Default:
441
 
   :Variable: ``secure_file_priv``
442
 
 
443
 
   Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
444
 
   specified directory.
445
 
 
446
 
.. Why is this still here?
447
 
.. option:: --server-id ARG
448
 
 
449
 
   :Default: 0
450
 
   :Variable: ``server_id``
451
 
 
452
 
   Uniquely identifies the server instance in the community of replication
453
 
   partners.
454
 
 
455
 
.. option:: --skip-stack-trace
456
 
 
457
 
   :Default:
458
 
   :Variable: 
459
 
 
460
 
   Don't print a stack trace on failure.
461
 
 
462
 
.. option:: --sort-buffer-constraint ARG
463
 
 
464
 
   :Default: 0
465
 
   :Variable: 
 
308
.. option:: --sort-buffer-size arg (=2097144)
 
309
 
 
310
   Each thread that needs to do a sort allocates a buffer of this size.
 
311
 
 
312
.. option:: --sort-buffer-constraint arg (=0)
466
313
 
467
314
   A global constraint for sort-buffer-size for all clients, cannot be set lower
468
315
   than --sort-buffer-size.  Setting to 0 means unlimited.
469
316
 
470
 
.. option:: --sort-buffer-size SIZE
471
 
   
472
 
   :Default: 2097144
473
 
   :Variable: ``sort_buffer_size``
474
 
 
475
 
   Each thread that needs to do a sort allocates a buffer of this size.
476
 
 
477
 
.. option:: --symbolic-links, -s
478
 
 
479
 
   :Default:
480
 
   :Variable: 
481
 
 
482
 
   Enable symbolic link support.
483
 
 
484
 
.. option:: --table-definition-cache ARG
485
 
 
486
 
   :Default: 128
487
 
   :Variable: ``table_definition_cache``
 
317
.. option:: --table-definition-cache arg (=128)
488
318
 
489
319
   The number of cached table definitions.
490
320
 
491
 
.. option:: --table-lock-wait-timeout ARG
492
 
 
493
 
   :Default: 50
494
 
   :Variable: ``table_lock_wait_timeout``
 
321
.. option:: --table-open-cache arg (=1024)
 
322
 
 
323
   The number of cached open tables.
 
324
 
 
325
.. option:: --table-lock-wait-timeout arg (=50)
495
326
 
496
327
   Timeout in seconds to wait for a table level lock before returning an error.
497
328
   Used only if the connection has active cursors.
498
329
 
499
 
.. option:: --table-open-cache ARG
500
 
 
501
 
   :Default: 1024
502
 
   :Variable: ``table_open_cache``
503
 
 
504
 
   The number of cached open tables.
505
 
 
506
 
.. option:: --thread-stack ARG
507
 
 
508
 
   :Default: 0
509
 
   :Variable: ``thread_stack``
 
330
.. option:: --thread-stack arg (=0)
510
331
 
511
332
   The stack size for each thread. 0 means use OS default.
512
333
 
513
 
.. option:: --timed-mutexes
514
 
 
515
 
   :Default:
516
 
   :Variable: ``timed_mutexes``
517
 
 
518
 
   Specify whether to time mutexes (only InnoDB mutexes are currently supported).
519
 
 
520
 
.. option:: --tmp-table-size SIZE
521
 
 
522
 
   :Default: 16M
523
 
   :Variable: ``tmp_table_size``
 
334
.. option:: --tmp-table-size arg (=16M)
524
335
 
525
336
   If an internal in-memory temporary table exceeds this size, Drizzle will
526
337
   automatically convert it to an on-disk MyISAM table.
527
338
 
528
 
.. option:: --tmpdir, -t DIR
529
 
 
530
 
   :Default:
531
 
   :Variable: ``tmpdir``
532
 
 
533
 
   Path for temporary files.
534
 
 
535
 
.. option:: --transaction-isolation ARG
536
 
 
537
 
   :Default: REPEATABLE-READ
538
 
   :Variable: ``tx_isolation``
539
 
 
540
 
   Default transaction isolation level.
541
 
 
542
 
.. option:: --transaction-message-threshold
543
 
 
544
 
   :Default: 1048576
545
 
   :Variable: ``transaction_message_threshold``
546
 
 
547
 
   Max message size written to transaction log, valid values 131072 - 1048576 bytes.
548
 
 
549
 
.. option:: --user, -u ARG
550
 
 
551
 
   :Default:
552
 
   :Variable: 
553
 
 
554
 
   Run drizzled daemon as user.
555
 
  
556
 
.. option:: --version, -V
557
 
 
558
 
   :Default:
559
 
   :Variable: ``version``
560
 
 
561
 
   Output version information and exit.
562
 
 
563
 
.. _drizzled_variables:
564
 
 
565
 
Variables
566
 
---------
567
 
 
568
 
.. _drizzled_auto_increment_increment:
569
 
 
570
 
* ``auto_increment_increment``
571
 
 
572
 
   :Scope: Global
573
 
   :Dynamic: No
574
 
   :Option: :option:`--auto-increment-increment`
575
 
 
576
 
.. _drizzled_auto_increment_offset:
577
 
 
578
 
* ``auto_increment_offset``
579
 
 
580
 
   :Scope: Global
581
 
   :Dynamic: No
582
 
   :Option: :option:`--auto-increment-offset`
583
 
 
584
 
.. _drizzled_autocommit:
585
 
 
586
 
* ``autocommit``
587
 
 
588
 
   :Scope: Global
589
 
   :Dynamic: No
590
 
   :Option: 
591
 
 
592
 
   If statements are auto-committed.
593
 
 
594
 
.. _drizzled_back_log:
595
 
 
596
 
* ``back_log``
597
 
 
598
 
   :Scope: Global
599
 
   :Dynamic: No
600
 
   :Option: :option:`--back-log`
601
 
 
602
 
.. _drizzled_basedir:
603
 
 
604
 
* ``basedir``
605
 
 
606
 
   :Scope: Global
607
 
   :Dynamic: No
608
 
   :Option: :option:`--basedir`
609
 
 
610
 
.. _drizzled_bulk_insert_buffer_size:
611
 
 
612
 
* ``bulk_insert_buffer_size``
613
 
 
614
 
   :Scope: Global
615
 
   :Dynamic: No
616
 
   :Option: :option:`--bulk-insert-buffer-size`
617
 
 
618
 
.. _drizzled_collation_server:
619
 
 
620
 
* ``collation_server``
621
 
 
622
 
   :Scope: Global
623
 
   :Dynamic: No
624
 
   :Option: :option:`--collation-server`
625
 
 
626
 
.. _drizzled_completion_type:
627
 
 
628
 
* ``completion_type``
629
 
 
630
 
   :Scope: Global
631
 
   :Dynamic: No
632
 
   :Option: :option:`--completion-type`
633
 
 
634
 
.. _drizzled_datadir:
635
 
 
636
 
* ``datadir``
637
 
 
638
 
   :Scope: Global
639
 
   :Dynamic: No
640
 
   :Option: :option:`--datadir`
641
 
 
642
 
.. _drizzled_div_precision_increment:
643
 
 
644
 
* ``div_precision_increment``
645
 
 
646
 
   :Scope: Global
647
 
   :Dynamic: No
648
 
   :Option: :option:`--div-precision-increment`
649
 
 
650
 
.. _drizzled_error_count:
651
 
 
652
 
* ``error_count``
653
 
 
654
 
   :Scope: Global
655
 
   :Dynamic: No
656
 
   :Option: 
657
 
 
658
 
   Error count.
659
 
 
660
 
.. _drizzled_foreign_key_checks:
661
 
 
662
 
* ``foreign_key_checks``
663
 
 
664
 
   :Scope: Global
665
 
   :Dynamic: No
666
 
   :Option: 
667
 
 
668
 
   If foreign key checks are enabled.
669
 
 
670
 
.. _drizzled_group_concat_max_len:
671
 
 
672
 
* ``group_concat_max_len``
673
 
 
674
 
   :Scope: Global
675
 
   :Dynamic: No
676
 
   :Option: :option:`--group-concat-max-len`
677
 
 
678
 
.. _drizzled_hostname:
679
 
 
680
 
* ``hostname``
681
 
 
682
 
   :Scope: Global
683
 
   :Dynamic: No
684
 
   :Option: 
685
 
 
686
 
   Hostname of the server.
687
 
 
688
 
.. _drizzled_identity:
689
 
 
690
 
* ``identity``
691
 
 
692
 
   :Scope: Global
693
 
   :Dynamic: No
694
 
   :Option: 
695
 
 
696
 
   Unknown.
697
 
 
698
 
.. _drizzled_join_buffer_size:
699
 
 
700
 
* ``join_buffer_size``
701
 
 
702
 
   :Scope: Global
703
 
   :Dynamic: No
704
 
   :Option: :option:`--join-buffer-size`
705
 
 
706
 
.. _drizzled_last_insert_id:
707
 
 
708
 
* ``last_insert_id``
709
 
 
710
 
   :Scope: Global
711
 
   :Dynamic: No
712
 
   :Option: 
713
 
 
714
 
   Last auto-increment insert ID value.
715
 
 
716
 
.. _drizzled_lc_time_names:
717
 
 
718
 
* ``lc_time_names``
719
 
 
720
 
   :Scope: Global
721
 
   :Dynamic: No
722
 
   :Option: 
723
 
 
724
 
   Unknown.
725
 
 
726
 
.. _drizzled_max_allowed_packet:
727
 
 
728
 
* ``max_allowed_packet``
729
 
 
730
 
   :Scope: Global
731
 
   :Dynamic: No
732
 
   :Option: :option:`--max-allowed-packet`
733
 
 
734
 
.. _drizzled_max_error_count:
735
 
 
736
 
* ``max_error_count``
737
 
 
738
 
   :Scope: Global
739
 
   :Dynamic: No
740
 
   :Option: :option:`--max-error-count`
741
 
 
742
 
.. _drizzled_max_heap_table_size:
743
 
 
744
 
* ``max_heap_table_size``
745
 
 
746
 
   :Scope: Global
747
 
   :Dynamic: No
748
 
   :Option: :option:`--max-heap-table-size`
749
 
 
750
 
.. _drizzled_max_join_size:
751
 
 
752
 
* ``max_join_size``
753
 
 
754
 
   :Scope: Global
755
 
   :Dynamic: No
756
 
   :Option: :option:`--max-join-size`
757
 
 
758
 
.. _drizzled_max_length_for_sort_data:
759
 
 
760
 
* ``max_length_for_sort_data``
761
 
 
762
 
   :Scope: Global
763
 
   :Dynamic: No
764
 
   :Option: :option:`--max-length-for-sort-data`
765
 
 
766
 
.. _drizzled_max_seeks_for_key:
767
 
 
768
 
* ``max_seeks_for_key``
769
 
 
770
 
   :Scope: Global
771
 
   :Dynamic: No
772
 
   :Option: :option:`--max-seeks-for-key`
773
 
 
774
 
.. _drizzled_max_sort_length:
775
 
 
776
 
* ``max_sort_length``
777
 
 
778
 
   :Scope: Global
779
 
   :Dynamic: No
780
 
   :Option: :option:`--max-sort-length`
781
 
 
782
 
.. _drizzled_max_write_lock_count:
783
 
 
784
 
* ``max_write_lock_count``
785
 
 
786
 
   :Scope: Global
787
 
   :Dynamic: No
788
 
   :Option: :option:`--max-write-lock-count`
789
 
 
790
 
.. _drizzled_min_examined_row_limit:
791
 
 
792
 
* ``min_examined_row_limit``
793
 
 
794
 
   :Scope: Global
795
 
   :Dynamic: No
796
 
   :Option: :option:`--min-examined-row-limit`
797
 
 
798
 
.. _drizzled_optimizer_prune_level:
799
 
 
800
 
* ``optimizer_prune_level``
801
 
 
802
 
   :Scope: Global
803
 
   :Dynamic: No
804
 
   :Option: :option:`--disable-optimizer-prune`
805
 
 
806
 
   Optimizer prune level.
807
 
 
808
 
.. _drizzled_optimizer_search_depth:
809
 
 
810
 
* ``optimizer_search_depth``
811
 
 
812
 
   :Scope: Global
813
 
   :Dynamic: No
814
 
   :Option: :option:`--optimizer-search-depth`
815
 
 
816
 
.. _drizzled_pid_file:
817
 
 
818
 
* ``pid_file``
819
 
 
820
 
   :Scope: Global
821
 
   :Dynamic: No
822
 
   :Option: :option:`--pid-file`
823
 
 
824
 
.. _drizzled_plugin_dir:
825
 
 
826
 
* ``plugin_dir``
827
 
 
828
 
   :Scope: Global
829
 
   :Dynamic: No
830
 
   :Option: :option:`--plugin-dir`
831
 
 
832
 
.. _drizzled_preload_buffer_size:
833
 
 
834
 
* ``preload_buffer_size``
835
 
 
836
 
   :Scope: Global
837
 
   :Dynamic: No
838
 
   :Option: :option:`--preload-buffer-size`
839
 
 
840
 
.. _drizzled_pseudo_thread_id:
841
 
 
842
 
* ``pseudo_thread_id``
843
 
 
844
 
   :Scope: Global
845
 
   :Dynamic: No
846
 
   :Option: 
847
 
 
848
 
   Unknown.
849
 
 
850
 
.. _drizzled_query_alloc_block_size:
851
 
 
852
 
* ``query_alloc_block_size``
853
 
 
854
 
   :Scope: Global
855
 
   :Dynamic: No
856
 
   :Option: :option:`--query-alloc-block-size`
857
 
 
858
 
.. _drizzled_query_prealloc_size:
859
 
 
860
 
* ``query_prealloc_size``
861
 
 
862
 
   :Scope: Global
863
 
   :Dynamic: No
864
 
   :Option: :option:`--query-prealloc-size`
865
 
 
866
 
.. _drizzled_range_alloc_block_size:
867
 
 
868
 
* ``range_alloc_block_size``
869
 
 
870
 
   :Scope: Global
871
 
   :Dynamic: No
872
 
   :Option: :option:`--range-alloc-block-size`
873
 
 
874
 
.. _drizzled_read_buffer_size:
875
 
 
876
 
* ``read_buffer_size``
877
 
 
878
 
   :Scope: Global
879
 
   :Dynamic: No
880
 
   :Option: :option:`--read-buffer-size`
881
 
 
882
 
.. _drizzled_read_rnd_buffer_size:
883
 
 
884
 
* ``read_rnd_buffer_size``
885
 
 
886
 
   :Scope: Global
887
 
   :Dynamic: No
888
 
   :Option: :option:`--read-rnd-buffer-size`
889
 
 
890
 
.. _drizzled_replicate_query:
891
 
 
892
 
* ``replicate_query``
893
 
 
894
 
   :Scope: Global
895
 
   :Dynamic: No
896
 
   :Option: :option:`--replicate-query`
897
 
 
898
 
.. _drizzled_scheduler:
899
 
 
900
 
* ``scheduler``
901
 
 
902
 
   :Scope: Global
903
 
   :Dynamic: No
904
 
   :Option: :option:`--scheduler`
905
 
 
906
 
.. _drizzled_secure_file_priv:
907
 
 
908
 
* ``secure_file_priv``
909
 
 
910
 
   :Scope: Global
911
 
   :Dynamic: No
912
 
   :Option: :option:`--secure-file-priv`
913
 
 
914
 
.. _drizzled_server_id:
915
 
 
916
 
* ``server_id``
917
 
 
918
 
   :Scope: Global
919
 
   :Dynamic: No
920
 
   :Option: :option:`--server-id`
921
 
 
922
 
.. _drizzled_server_uuid:
923
 
 
924
 
* ``server_uuid``
925
 
 
926
 
   :Scope: Global
927
 
   :Dynamic: No
928
 
   :Option: 
929
 
 
930
 
   Server UUID.
931
 
 
932
 
.. _drizzled_sort_buffer_size:
933
 
 
934
 
* ``sort_buffer_size``
935
 
 
936
 
   :Scope: Global
937
 
   :Dynamic: No
938
 
   :Option: :option:`--sort-buffer-size`
939
 
 
940
 
.. _drizzled_sql_big_selects:
941
 
 
942
 
* ``sql_big_selects``
943
 
 
944
 
   :Scope: Global
945
 
   :Dynamic: No
946
 
   :Option: 
947
 
 
948
 
   Unknown.
949
 
 
950
 
.. _drizzled_sql_buffer_result:
951
 
 
952
 
* ``sql_buffer_result``
953
 
 
954
 
   :Scope: Global
955
 
   :Dynamic: No
956
 
   :Option: 
957
 
 
958
 
   Unknown.
959
 
 
960
 
.. _drizzled_sql_notes:
961
 
 
962
 
* ``sql_notes``
963
 
 
964
 
   :Scope: Global
965
 
   :Dynamic: No
966
 
   :Option: 
967
 
 
968
 
   Unknown.
969
 
 
970
 
.. _drizzled_sql_select_limit:
971
 
 
972
 
* ``sql_select_limit``
973
 
 
974
 
   :Scope: Global
975
 
   :Dynamic: No
976
 
   :Option: 
977
 
 
978
 
   Unknown.
979
 
 
980
 
.. _drizzled_sql_warnings:
981
 
 
982
 
* ``sql_warnings``
983
 
 
984
 
   :Scope: Global
985
 
   :Dynamic: No
986
 
   :Option: 
987
 
 
988
 
   Unknown.
989
 
 
990
 
.. _drizzled_storage_engine:
991
 
 
992
 
* ``storage_engine``
993
 
 
994
 
   :Scope: Global
995
 
   :Dynamic: No
996
 
   :Option: :option:`--default-storage-engine`
997
 
 
998
 
.. _drizzled_table_definition_cache:
999
 
 
1000
 
* ``table_definition_cache``
1001
 
 
1002
 
   :Scope: Global
1003
 
   :Dynamic: No
1004
 
   :Option: :option:`--table-definition-cache`
1005
 
 
1006
 
.. _drizzled_table_lock_wait_timeout:
1007
 
 
1008
 
* ``table_lock_wait_timeout``
1009
 
 
1010
 
   :Scope: Global
1011
 
   :Dynamic: No
1012
 
   :Option: :option:`--table-lock-wait-timeout`
1013
 
 
1014
 
.. _drizzled_table_open_cache:
1015
 
 
1016
 
* ``table_open_cache``
1017
 
 
1018
 
   :Scope: Global
1019
 
   :Dynamic: No
1020
 
   :Option: :option:`--table-open-cache`
1021
 
 
1022
 
.. _drizzled_thread_stack:
1023
 
 
1024
 
* ``thread_stack``
1025
 
 
1026
 
   :Scope: Global
1027
 
   :Dynamic: No
1028
 
   :Option: :option:`--thread-stack`
1029
 
 
1030
 
.. _drizzled_timed_mutexes:
1031
 
 
1032
 
* ``timed_mutexes``
1033
 
 
1034
 
   :Scope: Global
1035
 
   :Dynamic: No
1036
 
   :Option: :option:`--timed-mutexes`
1037
 
 
1038
 
.. _drizzled_timestamp:
1039
 
 
1040
 
* ``timestamp``
1041
 
 
1042
 
   :Scope: Global
1043
 
   :Dynamic: No
1044
 
   :Option: 
1045
 
 
1046
 
   Current UNIX timestamp.
1047
 
 
1048
 
.. _drizzled_tmp_table_size:
1049
 
 
1050
 
* ``tmp_table_size``
1051
 
 
1052
 
   :Scope: Global
1053
 
   :Dynamic: No
1054
 
   :Option: :option:`--tmp-table-size`
1055
 
 
1056
 
.. _drizzled_tmpdir:
1057
 
 
1058
 
* ``tmpdir``
1059
 
 
1060
 
   :Scope: Global
1061
 
   :Dynamic: No
1062
 
   :Option: :option:`--tmpdir`
1063
 
 
1064
 
.. _drizzled_transaction_message_threshold:
1065
 
 
1066
 
* ``transaction_message_threshold``
1067
 
 
1068
 
   :Scope: Global
1069
 
   :Dynamic: No
1070
 
   :Option: :option:`--transaction-message-threshold`
1071
 
 
1072
 
.. _drizzled_tx_isolation:
1073
 
 
1074
 
* ``tx_isolation``
1075
 
 
1076
 
   :Scope: Global
1077
 
   :Dynamic: No
1078
 
   :Option: :option:`--transactions-isolation`
1079
 
 
1080
 
.. _drizzled_unique_checks:
1081
 
 
1082
 
* ``unique_checks``
1083
 
 
1084
 
   :Scope: Global
1085
 
   :Dynamic: No
1086
 
   :Option: 
1087
 
 
1088
 
   Check UNIQUE indexes for uniqueness.
1089
 
 
1090
 
.. _drizzled_vc_branch:
1091
 
 
1092
 
* ``vc_branch``
1093
 
 
1094
 
   :Scope: Global
1095
 
   :Dynamic: No
1096
 
   :Option: 
1097
 
 
1098
 
   Version control (Bazaar) branch.
1099
 
 
1100
 
.. _drizzled_vc_release_id:
1101
 
 
1102
 
* ``vc_release_id``
1103
 
 
1104
 
   :Scope: Global
1105
 
   :Dynamic: No
1106
 
   :Option: 
1107
 
 
1108
 
   Version control (Bazaar) release id.
1109
 
 
1110
 
.. _drizzled_vc_revid:
1111
 
 
1112
 
* ``vc_revid``
1113
 
 
1114
 
   :Scope: Global
1115
 
   :Dynamic: No
1116
 
   :Option: 
1117
 
 
1118
 
   Version control (Bazaar) revision id.
1119
 
 
1120
 
.. _drizzled_vc_revno:
1121
 
 
1122
 
* ``vc_revno``
1123
 
 
1124
 
   :Scope: Global
1125
 
   :Dynamic: No
1126
 
   :Option: 
1127
 
 
1128
 
   Version control (Bazaar) revision number.
1129
 
 
1130
 
.. _drizzled_version:
1131
 
 
1132
 
* ``version``
1133
 
 
1134
 
   :Scope: Global
1135
 
   :Dynamic: No
1136
 
   :Option: :option:`--version`
1137
 
 
1138
 
   Drizzle version.
1139
 
 
1140
 
.. _drizzled_version_comment:
1141
 
 
1142
 
* ``version_comment``
1143
 
 
1144
 
   :Scope: Global
1145
 
   :Dynamic: No
1146
 
   :Option: 
1147
 
 
1148
 
   Version comment.
1149
 
 
1150
 
.. _drizzled_version_compile_machine:
1151
 
 
1152
 
* ``version_compile_machine``
1153
 
 
1154
 
   :Scope: Global
1155
 
   :Dynamic: No
1156
 
   :Option: 
1157
 
 
1158
 
   Version compile for machine type.
1159
 
 
1160
 
.. _drizzled_version_compile_os:
1161
 
 
1162
 
* ``version_compile_os``
1163
 
 
1164
 
   :Scope: Global
1165
 
   :Dynamic: No
1166
 
   :Option: 
1167
 
 
1168
 
   Version compile for OS.
1169
 
 
1170
 
.. _drizzled_version_compile_vendor:
1171
 
 
1172
 
* ``version_compile_vendor``
1173
 
 
1174
 
   :Scope: Global
1175
 
   :Dynamic: No
1176
 
   :Option: 
1177
 
 
1178
 
   Version compile for OS vendor.
1179
 
 
1180
 
.. _drizzled_warning_count:
1181
 
 
1182
 
* ``warning_count``
1183
 
 
1184
 
   :Scope: Global
1185
 
   :Dynamic: No
1186
 
   :Option: 
1187
 
 
1188
 
   Unknown.