Bug #9369 --log-error missing from man page
Submitted: 23 Mar 2005 21:47 Modified: 2 Dec 2005 19:34
Reporter: Robert Minsk Email Updates:
Status: Closed Impact on me:
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:4.1.10 OS:Linux (Fedora Core 3)
Assigned to: Paul DuBois CPU Architecture:Any

[23 Mar 2005 21:47] Robert Minsk
The documentation for the command line option --log-error is missing from mysqld.1.  It should also be noted in the documentation that the mysqld variable log_error will be set to the --log-error option with ".err" appended if the value of --log-error does not end in ".err".  Without having the ".err" postfix on the command line "mysqladmin flush-logs" will fail to work correctly.

How to repeat:
Documentation missing so it is not repeatable.

Suggested fix:
Add --log-error to mysqld.1 man page.
[27 Apr 2005 1:31] Paul DuBois
What does this mean: "Without having the ".err" postfix
on the command line "mysqladmin flush-logs" will
fail to work correctly."

I find that "mysqladmin flush-logs" works correctly
whether or not the filename for --log-error has
an .err suffix.
[27 Apr 2005 1:58] Robert Minsk
On the version I was running 4.1.10 when I had "log-error=/var/log/mysqld" in /etc/my.cnf it would output the logfile to /var/log/mysqld but the output of "mysqladmin variables" would have log_error set to /var/log/mysqld.err.  When I would try "mysqladmin flush-logs" I would get a non-zero exit status.

Unfortunately the machine running the database is in production right and I can not change it to try to recreate the problem.
[27 Apr 2005 2:41] Paul DuBois
Okay.  It works for me in 4.1.12.  If you can verify
later that lack of .err does cause a problem, please open
a new (non-Doc) bug report.

For the present report, I'm closing it with "to be fixed
later" status.  The manual pages rarely get updated,
because they were contributed and we don't maintain
them.  However, there are plans to derive manual pages
from the main manual in the future (so that we can generate
both the manual and the man pages from the same source).
[2 Dec 2005 19:34] Paul DuBois
Manpages are generated directly from the Reference Manual
now, so all distributions from now on will have manpages that
list the same options that are present in the manual.