[MDEV-20701] "core_file" parameter documentation is unclear Created: 2019-09-30  Updated: 2020-08-25  Resolved: 2019-10-01

Status: Closed
Project: MariaDB Server
Component/s: Documentation
Affects Version/s: None
Fix Version/s: N/A

Type: Bug Priority: Trivial
Reporter: Juan Assignee: Ian Gilfillan
Resolution: Fixed Votes: 0
Labels: None


 Description   

The documentation for core_file contains this bullet point:

  • Default Value: OFF, ON (Windows only >= MariaDB 10.4.3)

which implies that there is a default of OFF, and maybe a default of ON for Windows, or that the parameter is available on Windows only since MariaDB 10.4.3.

It might be a good idea to show explicitly that this parameter accepts no arguments when specified in .cnf files, and to separate out the information that it's only available on Windows as of 10.4.3.

Specifying "core_file=ON" in configuration results in the server failing to start with:

[ERROR] /usr/sbin/mysqld: option '--core-file' cannot take an argument



 Comments   
Comment by Jon Brightwell [ 2019-10-01 ]

With 10.3 with systemd/multi instance, we couldn't see an error anywhere. It was complaining about start limits and exit code 1 in the journal and logs. We had to revert config changes one at a time until it started.

Comment by Ian Gilfillan [ 2019-10-01 ]

Thanks - the commandline option in the docs always specified no argument, but I agree this is unusual and unclear, especially since the variable indicates OFF and ON values, so have expanded in the text.

Generated at Thu Feb 08 09:01:31 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.