Bug #72024 Document C/C++ connection properties
Submitted: 12 Mar 2014 16:24 Modified: 12 Jun 2017 17:56
Reporter: Todd Farmer (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:Connector / C++ Documentation Severity:S3 (Non-critical)
Version:1.1.3 OS:Any
Assigned to: Paul DuBois CPU Architecture:Any

[12 Mar 2014 16:24] Todd Farmer
Description:
Connector/C++ provides connection options.  These options are not described in any single reference page.  Connector/Java has the following page:

http://dev.mysql.com/doc/connector-j/en/connector-j-reference-configuration-properties.htm...

It would be very useful to have a similar such page for C/C++.  WB has an "Advanced Properties" tab for connections where C/C++ connection options can be defined, but without a reference to know what options exist, this is largely useless.  It's unrealistic to expect WB users to inspect C/C++ source to collect option possibilities.

How to repeat:
Try to find documentation about C/C++ connection properties.

Suggested fix:
Add connection properties documentation page.
[12 Mar 2014 18:24] Peter Laursen
My assumption always was that this is how the C-API mysql_options() http://dev.mysql.com/doc/refman/5.6/en/mysql-options.html is exposed and managed in Connector C++

??
[12 Mar 2014 18:54] Todd Farmer
Peter,

Entirely possible (even likely?).  I'd like to see this explicitly referenced in the documentation.  Thanks for the pointer!
[12 Mar 2014 19:36] Peter Laursen
I fully agree. 

Even if I am right in my assumption, it is not certain that all what the C-API supports in mysql_options() is available in the C++/connector. C++/connector is more recent than the C-API and some old and rarely used options may have been discarded and omitted.  There may also be cases where an option in various connectors (C, C++, JAVA, Python etc.) are very similar but still not fully identical.

(besides I am not sure that Python//connector has an implementation  of mysql_options() at all.  PHP to my best knowledge has not - or had not till 5+ years back when I knew a little about PHP!).
[12 Jun 2017 17:56] Paul DuBois
Posted by developer:
 
https://dev.mysql.com/doc/connector-cpp/en/connector-cpp-connect-options.html