Bug #88208 CLIENT_OPTIONAL_RESULTSET_METADATA is defined in wrong place

Submitted:	24 Oct 2017 16:56	Modified:	25 Oct 2017 10:51
Reporter:	Bradley Grainger (OCA)	Email Updates:
Status:	Verified	Impact on me:	None
Category:	MySQL Server: DDL	Severity:	S3 (Non-critical)
Version:	8.0	OS:	Any
Assigned to:		CPU Architecture:	Any
Tags:	documentation

Description:
The comment for and definition of CLIENT_OPTIONAL_RESULTSET_METADATA (at 
https://github.com/mysql/mysql-server/blob/020025d9f277fd3283b8c75024f590857f58fbbd/includ...) is inserted between the comment for CLIENT_SSL_VERIFY_SERVER_CERT and its definition: https://github.com/mysql/mysql-server/blob/020025d9f277fd3283b8c75024f590857f58fbbd/includ...

As a result, the generated documentation for CLIENT_OPTIONAL_RESULTSET_METADATA and CLIENT_SSL_VERIFY_SERVER_CERT is incorrect:
* https://dev.mysql.com/doc/dev/mysql-server/latest/group__group__cs__capabilities__flags.ht...
* https://dev.mysql.com/doc/dev/mysql-server/latest/group__group__cs__capabilities__flags.ht...

How to repeat:
Open mysql_com.h in a text editor and go to line 618

https://github.com/mysql/mysql-server/blob/020025d9f277fd3283b8c75024f590857f58fbbd/includ...

Suggested fix:
Rewrite lines 618-633 as follows:

/**
  Verify server certificate.
  Client only flag.
  @deprecated in favor of --ssl-mode.
*/
#define CLIENT_SSL_VERIFY_SERVER_CERT (1UL << 30)

/**
  The client can handle optional metadata information in the resultset.
*/
#define CLIENT_OPTIONAL_RESULTSET_METADATA (1UL << 25)

Opened a PR to fix this problem: https://github.com/mysql/mysql-server/pull/175

Thank you for the bug report.

Page generated in 0.052 sec. using MySQL 8.4.7-u6-cloud

Timestamp references displayed by the system are UTC.
Content reproduced on this site is the property of the respective copyright holders.
It is not reviewed in advance by Oracle and does not necessarily represent the opinion of Oracle or any other party.