← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/options.rst

Merge Revision revid:marko.makela@oracle.com-20100514133144-fe0l0b89tea4x4uu from MySQL InnoDB

Original revid:marko.makela@oracle.com-20100514133144-fe0l0b89tea4x4uu

Original Authors: Marko Mkel <marko.makela@oracle.com>
Original commit message:
Merge from mysql-5.1-innodb:

Post-merge fixes: Remove the MYSQL_VERSION_ID checks, because they only
apply to the InnoDB Plugin. Fix potential race condition accessing
trx->op_info and trx->detailed_error.
------------------------------------------------------------
revno: 3466
revision-id: marko.makela@oracle.com-20100514130815-ym7j7cfu88ro6km4
parent: marko.makela@oracle.com-20100514130228-n3n42nw7ht78k0wn
committer: Marko Mkel <marko.makela@oracle.com>
branch nick: mysql-5.1-innodb2
timestamp: Fri 2010-05-14 16:08:15 +0300
message:
  Make the InnoDB FOREIGN KEY parser understand multi-statements. (Bug #48024)
  Also make InnoDB thinks that /*/ only starts a comment. (Bug #53644).

  This fixes the bugs in the InnoDB Plugin.

  ha_innodb.h: Use trx_query_string() instead of trx_query() when
  available (MySQL 5.1.42 or later).

  innobase_get_stmt(): New function, to retrieve the currently running
  SQL statement.

  struct trx_struct: Remove mysql_query_str. Use innobase_get_stmt() instead.

  dict_strip_comments(): Add and observe the parameter sql_length. Treat
  /*/ as the start of a comment.

  dict_create_foreign_constraints(), row_table_add_foreign_constraints():
  Add the parameter sql_length.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/options.rst
 
1
Drizzled Options
 
2
================
 
3
 
 
4
There are many different options one can use to configure Drizzle.
 
5
 
 
6
Config File Options
 
7
-------------------
 
8
 
 
9
.. option:: --help-extended
 
10
  Display this help and exit after initializing plugins.
 
11
 
 
12
.. option:: -?,--help
 
13
  Display this help and exit.
 
14
 
 
15
.. option:: --no-defaults
 
16
  Configuration file defaults are not used if no-defaults is set
 
17
 
 
18
.. option:: --defaults-file arg
 
19
  Configuration file to use
 
20
 
 
21
.. option:: --config-dir arg (=/etc/drizzle)
 
22
  Base location for config files
 
23
 
 
24
.. option:: --plugin-dir arg
 
25
  Directory for plugins
 
26
 
 
27
.. option:: --pid-file arg
 
28
 
 
29
  Pid file used by drizzled.
 
30
 
 
31
Plugin Loading Options
 
32
----------------------
 
33
 
 
34
.. option:: --plugin-add arg
 
35
  Optional comma separated list of plugins to load at startup in addition
 
36
  to the default list of plugins.
 
37
  
 
38
  for example: --plugin_add=crc32,console,pbxt
 
39
 
 
40
.. option:: --plugin-remove arg
 
41
  Optional comma separated list of plugins to not load at startup.
 
42
  Effectively removes a plugin from the list of plugins to be loaded.
 
43
 
 
44
  for example: --plugin_remove=syslog,md5
 
45
 
 
46
.. 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,)
 
47
 
 
48
  Optional comma separated list of plugins to load at starup instead of 
 
49
  the default plugin load list. This completely replaces the whole list.
 
50
 
 
51
Kernel Options
 
52
--------------
 
53
 
 
54
.. option:: --auto-increment-increment arg (=1)
 
55
  
 
56
  Auto-increment columns are incremented by this
 
57
 
 
58
.. option:: --auto-increment-offset arg (=1)
 
59
 
 
60
  Offset added to Auto-increment columns.
 
61
  Used when auto-increment-increment != 1
 
62
 
 
63
.. option:: -b,--basedir arg
 
64
 
 
65
  Path to installation directory.
 
66
  All paths are usually resolved relative to this.
 
67
 
 
68
.. option:: -r,--chroot arg
 
69
 
 
70
  Chroot drizzled daemon during startup.
 
71
 
 
72
.. option:: --collation-server arg
 
73
 
 
74
  Set the default collation.
 
75
 
 
76
.. option:: --completion-type arg (=0)
 
77
 
 
78
  Default completion type.
 
79
 
 
80
.. option:: --core-file
 
81
 
 
82
  Write core on errors.
 
83
 
 
84
.. option:: --datadir arg
 
85
 
 
86
  Path to the database root.
 
87
 
 
88
.. option:: --default-storage-engine arg
 
89
 
 
90
  Set the default storage engine for tables.
 
91
 
 
92
.. option:: --default-time-zone arg
 
93
 
 
94
  Set the default time zone.
 
95
 
 
96
.. We should really remove --exit-info as an option
 
97
.. option:: -T,--exit-info arg
 
98
 
 
99
  Used for debugging;  Use at your own risk!
 
100
 
 
101
.. option:: --gdb
 
102
 
 
103
  Set up signals usable for debugging
 
104
 
 
105
.. option:: --lc-time-name arg
 
106
 
 
107
  Set the language used for the month names and the days of the week.
 
108
 
 
109
.. option:: -W [ --log-warnings ] arg
 
110
 
 
111
  Log some not critical warnings to the log file.
 
112
 
 
113
.. Why is this a core argument?
 
114
.. option:: --port-open-timeout arg (=0)
 
115
 
 
116
  Maximum time in seconds to wait for the port to become free.
 
117
  A value of 0 means not to wait.
 
118
 
 
119
.. option:: --secure-file-priv arg
 
120
 
 
121
  Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
 
122
  specified directory
 
123
 
 
124
.. Why is this still here?
 
125
.. option:: --server-id arg (=0)
 
126
 
 
127
  Uniquely identifies the server instance in the community of replication
 
128
  partners.
 
129
 
 
130
.. option:: --skip-stack-trace
 
131
 
 
132
  Don't print a stack trace on failure.
 
133
 
 
134
.. option:: -s,--symbolic-links
 
135
 
 
136
  Enable symbolic link support.
 
137
 
 
138
.. option:: --timed-mutexes
 
139
 
 
140
  Specify whether to time mutexes (only InnoDB mutexes are currently supported)
 
141
 
 
142
.. option::  -t,--tmpdir arg
 
143
 
 
144
  Path for temporary files.
 
145
 
 
146
.. option:: --transaction-isolation arg
 
147
 
 
148
  Default transaction isolation level.
 
149
 
 
150
.. option:: -u,--user arg
 
151
 
 
152
  Run drizzled daemon as user.
 
153
  
 
154
.. option:: -V,--version
 
155
 
 
156
  Output version information and exit.
 
157
 
 
158
.. option:: --back-log arg (=50)
 
159
 
 
160
  The number of outstanding connection requests Drizzle can have. This comes
 
161
  into play when the main Drizzle thread gets very many connection requests in
 
162
  a very short time.
 
163
 
 
164
.. option:: --bulk-insert-buffer-size arg (=8388608)
 
165
  
 
166
  Size of tree cache used in bulk insert optimization. Note that this is a limit
 
167
  per thread!
 
168
 
 
169
.. option:: --div-precision-increment arg (=4)
 
170
  
 
171
  Precision of the result of '/' operator will be increased on that value.
 
172
 
 
173
.. option:: --group-concat-max-len arg (=1024)
 
174
 
 
175
  The maximum length of the result of function  group_concat.
 
176
 
 
177
.. option:: --join-buffer-size arg (=131072)
 
178
 
 
179
  The size of the buffer that is used for full joins.
 
180
 
 
181
.. option:: --join-buffer-constraint arg (=0)
 
182
 
 
183
  A global constraint for join-buffer-size for all clients, cannot be set lower
 
184
  than --join-buffer-size.  Setting to 0 means unlimited.
 
185
 
 
186
.. Why is this a core arg?
 
187
.. option:: --max-allowed-packet arg (=64M)
 
188
 
 
189
  Max packetlength to send/receive from to server.
 
190
 
 
191
.. option:: --max-connect-errors arg (=10)
 
192
 
 
193
  If there is more than this number of interrupted connections from a host 
 
194
  this host will be blocked from further connections.
 
195
 
 
196
.. option:: --max-error-count arg (=64)
 
197
 
 
198
  Max number of errors/warnings to store for a statement.
 
199
 
 
200
.. option:: --max-heap-table-size arg (=16M)
 
201
 
 
202
  Don't allow creation of heap tables bigger than this.
 
203
 
 
204
.. option:: --max-join-size arg (=2147483647)
 
205
 
 
206
  Joins that are probably going to read more than max_join_size records return 
 
207
  an error.
 
208
 
 
209
.. option:: --max-length-for-sort-data arg (=1024)
 
210
 
 
211
  Max number of bytes in sorted records.
 
212
  
 
213
.. option:: --max-seeks-for-key arg (=18446744073709551615)
 
214
 
 
215
  Limit assumed max number of seeks when looking up rows based on a key
 
216
 
 
217
.. option:: --max-sort-length arg (=1024)
 
218
 
 
219
  The number of bytes to use when sorting BLOB or TEXT values (only the first 
 
220
  max_sort_length bytes of each value are used; the rest are ignored).
 
221
 
 
222
.. option:: --max-write-lock-count arg (=18446744073709551615)
 
223
 
 
224
  After this many write locks, allow some read locks to run in between.
 
225
 
 
226
.. option:: --min-examined-row-limit arg (=0)
 
227
 
 
228
  Don't log queries which examine less than min_examined_row_limit rows to file.
 
229
 
 
230
.. option:: --disable-optimizer-prune
 
231
 
 
232
  Do not apply any heuristic(s) during query optimization to prune, thus
 
233
  perform an exhaustive search from the optimizer search space.
 
234
 
 
235
.. option:: --optimizer-search-depth arg (=0)
 
236
 
 
237
  Maximum depth of search performed by the query optimizer. Values larger than
 
238
  the number of relations in a query result in better query plans, but take
 
239
  longer to compile a query. Smaller values than the number of tables in a
 
240
  relation result in faster optimization, but may produce very bad query plans. 
 
241
  If set to 0, the system will automatically pick a reasonable value; if set to
 
242
  MAX_TABLES+2, the optimizer will switch to the original find_best (used for
 
243
  testing/comparison).
 
244
 
 
245
.. option:: --preload-buffer-size arg (=32768)
 
246
 
 
247
  The size of the buffer that is allocated when preloading indexes
 
248
 
 
249
.. option:: --query-alloc-block-size arg (=8192)
 
250
 
 
251
  Allocation block size for query parsing and execution
 
252
 
 
253
.. option:: --query-prealloc-size arg (=8192)
 
254
 
 
255
  Persistent buffer for query parsing and execution
 
256
 
 
257
.. option:: --range-alloc-block-size arg (=4096)
 
258
 
 
259
  Allocation block size for storing ranges during optimization
 
260
 
 
261
.. option:: --read-buffer-size arg (=131072)
 
262
 
 
263
  Each thread that does a sequential scan allocates a buffer of this size for
 
264
  each table it scans. If you do many sequential scans, you may want to
 
265
  increase this value.
 
266
 
 
267
.. option:: --read-buffer-constraint arg (=0)
 
268
 
 
269
  A global constraint for read-buffer-size for all clients, cannot be set lower
 
270
  than --read-buffer-size.  Setting to 0 means unlimited.
 
271
 
 
272
.. option:: --read-rnd-buffer-size arg (=262144)
 
273
 
 
274
  When reading rows in sorted order after a sort, the rows are read through
 
275
  this buffer to avoid a disk seeks. If not set, then it's set to the value of
 
276
  record_buffer.
 
277
 
 
278
.. option:: --read-rnd-constraint arg (=0)
 
279
 
 
280
  A global constraint for read-rnd-buffer-size for all clients, cannot be set
 
281
  lower than --read-rnd-buffer-size.  Setting to 0 means unlimited.
 
282
 
 
283
.. option:: --scheduler arg (=multi-thread)
 
284
 
 
285
  Select scheduler to be used.
 
286
 
 
287
.. option:: --sort-buffer-size arg (=2097144)
 
288
 
 
289
  Each thread that needs to do a sort allocates a buffer of this size.
 
290
 
 
291
.. option:: --sort-buffer-constraint arg (=0)
 
292
 
 
293
  A global constraint for sort-buffer-size for all clients, cannot be set lower
 
294
  than --sort-buffer-size.  Setting to 0 means unlimited.
 
295
 
 
296
.. option:: --table-definition-cache arg (=128)
 
297
 
 
298
  The number of cached table definitions.
 
299
 
 
300
.. option:: --table-open-cache arg (=1024)
 
301
 
 
302
  The number of cached open tables.
 
303
 
 
304
.. option:: --table-lock-wait-timeout arg (=50)
 
305
 
 
306
  Timeout in seconds to wait for a table level lock before returning an error.
 
307
  Used only if the connection has active cursors.
 
308
 
 
309
.. option:: --thread-stack arg (=0)
 
310
 
 
311
  The stack size for each thread. 0 means use OS default.
 
312
 
 
313
.. option:: --tmp-table-size arg (=16M)
 
314
 
 
315
  If an internal in-memory temporary table exceeds this size, Drizzle will
 
316
  automatically convert it to an on-disk MyISAM table.
 
317