Bug #11951 BDB option name confusion
Submitted: 14 Jul 2005 21:00 Modified: 18 Jul 2005 18:22
Reporter: Kristian Nielsen Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.0.8-beta-nightly-20050618 OS:N/A
Assigned to: Paul DuBois CPU Architecture:Any

[14 Jul 2005 21:00] Kristian Nielsen
Description:
The MySQL server documentation mention the --bdb-no-sync option. However, according to mysqld --verbose --help, this is deprecated:

      --bdb-no-sync       This option is deprecated, use --skip-sync-bdb-logs instead

Further, the --skip-sync-bdb-logs option does not exist. Intended is instead the --sync-bdb-logs option, which is not documented in the MySQL manual.

How to repeat:
Read http://dev.mysql.com/doc/mysql/en/bdb-start.html.
Check output of "mysqld --verbose --help|grep bdb" (on mysqld with BDB compiled in).

Suggested fix:
Update MySQL manual section 14.4.3, explain the --sync-bdb-logs option, and mention that --bdb-no-sync is deprecated.

Update sql/mysqld.cc like this:

--- mysqld.cc.orig	Thu Jul 14 22:58:35 2005
+++ mysqld.cc	Thu Jul 14 22:59:10 2005
@@ -4397,7 +4397,7 @@
    "Don't try to recover Berkeley DB tables on start.", 0, 0, 0, GET_NO_ARG,
    NO_ARG, 0, 0, 0, 0, 0, 0},
   {"bdb-no-sync", OPT_BDB_NOSYNC,
-   "This option is deprecated, use --skip-sync-bdb-logs instead",
+   "This option is deprecated, use --sync-bdb-logs instead",
    0, 0, 0, GET_NO_ARG, NO_ARG, 0, 0, 0, 0, 0, 0},
   {"bdb-shared-data", OPT_BDB_SHARED,
    "Start Berkeley DB in multi-process mode.", 0, 0, 0, GET_NO_ARG, NO_ARG, 0,
[18 Jul 2005 18:22] Paul DuBois
Thank you for your bug report. This issue has been addressed in the
documentation. The updated documentation will appear on our website
shortly, and will be included in the next release of the relevant
product(s).