MySQL Bugs: #71317: Default location for the trace file for --debug option isn't properly documented

Bug #71317	Default location for the trace file for --debug option isn't properly documented
Submitted:	8 Jan 2014 20:14	Modified:	23 Jan 2014 18:39
Reporter:	Valeriy Kravchuk	Email Updates:
Status:	Closed	Impact on me:	None
Category:	MySQL Server: Documentation	Severity:	S3 (Non-critical)
Version:	5.6	OS:	Any
Assigned to:	Paul DuBois	CPU Architecture:	Any
Tags:	--debug, missing manual

Description:
Please, check http://dev.mysql.com/doc/refman/5.6/en/server-options.html#option_mysqld_debug carefully. It says in the table that default value for --debug option is:

'd:t:o,/tmp/mysqld.trace'

but then in the text it says:

"The default is 'd:t:i:o,mysqld.trace'."

So, where trace file is created by default?

This page also says nothing about Windows, while at http://dev.mysql.com/doc/refman/5.6/en/dbug-package.html we see:

" The default trace file is usually /tmp/program_name.trace on Unix and \program_name.trace on Windows."

How to repeat:
Start debug build of MySQL server with --debug option on Linux and Windows. Check where trace file is really created and document accordingly, on all related pages.

Suggested fix:
Check where debug trace file is really created when debug binary is started with --debug (and no further explicit options) and document accordingly, on all related pages.

http://dev.mysql.com/doc/refman/5.6/en/making-trace-files.html mentions different default location for Windows... Something to fix/get in sync also.

Hello Valeriy,

Thank you for the bug report.

Thanks,
Umesh

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 products.

For mysqld:
Windows: d:t:i:O,\mysqld.trace
Otherwise: d:t:i:o,/tmp/mysqld.trace

Client programs:
d:t:o,/tmp/program_name.trace
(regardless of platform)
Exceptions: comp_error, mysql_upgrade use O rather than o

re: "http://dev.mysql.com/doc/refman/5.6/en/making-trace-files.html mentions different default location for Windows... Something to fix/get in sync also."

That is correct because the server does use different locations.