mariadb_get_infov − retrieves generic or connection releated information
#include <mysql.h>
int mariadb_get_infov(MYSQL * mysql,
enum mariadb_value value,
void * arg,
...);
Retrieves generic or connection specific information. arg (and further arguments) must be a pointer to a variable of the type appropriate for the value argument. The following table shows which variable type to use for each value.
For these information types parameter mysql needs to be set to NULL.
|
• |
MARIADB_CHARSET_NAME |
Retrieves the charset information for a character set by it’s literal representation.
|
• |
MARIADB_CLIENT_ERRORS |
Retrieve array of client errors. This can be used in plugins to set global error messages (which are not exported by MariaDB Connector/C).
|
• |
MARIADB_CLIENT_VERSION |
The client version in literal representation.
|
• |
MARIADB_CLIENT_VERSION_ID |
The client version in numeric format.
|
• |
MARIADB_MAX_ALLOWED_PACKET |
Retrieves value of maximum allowed packet size.
|
• |
MARIADB_NET_BUFFER_LENGTH |
Retrieves the length of net buffer.
|
• |
MARIADB_SSL_LIBRARY |
The TLS library MariaDB Connector/C is compiled against.
For these information types parameter mysql must be represent a valid connection handle which was allocated by mysql_init(3).
|
• |
MARIADB_CONNECTION_ASYNC_TIMEOUT |
Retrieves the timeout for non blocking calls in seconds.
|
• |
MARIADB_CONNECTION_ASYNC_TIMEOUT_MS |
Retrieves the timeout for non blocking calls in milliseconds.
|
• |
MARIADB_CONNECTION_CHARSET_INFO |
Retrieves character set information for given connection.
|
• |
MARIADB_CONNECTION_CLIENT_CAPABILITIES |
Returns the handshak capability flags] of the client.
|
• |
MARIADB_CONNECTION_ERROR |
Retrieves error message for last used command.
|
• |
MARIADB_CONNECTION_ERROR_ID |
Retrieves error number for last
used command.
*MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES
Returns the extended capability flags of the connected
MariaDB server
|
• |
MARIADB_CONNECTION_HOST |
Returns host name of the connected MariaDB server
|
• |
MARIADB_CONNECTION_INFO |
Retrieves generic info for last used command.
|
• |
MARIADB_CONNECTION_PORT |
Retrieves the port number of server host.
|
• |
MARIADB_CONNECTION_PROTOCOL_VERSION_ID |
Retrieves the protocol version number.
|
• |
MARIADB_CONNECTION_PVIO_TYPE |
Retrieves the pvio plugin used for specified connection.
|
• |
MARIADB_CONNECTION_SCHEMA |
Retrieves the current schema.
|
• |
MARIADB_CONNECTION_SERVER_CAPABILITIES |
Retrievrs the capability flags of the connected server.
|
• |
MARIADB_CONNECTION_SERVER_STATUS |
Returns server status after last operation.
|
• |
MARIADB_CONNECTION_SERVER_TYPE |
Retrieves the type of the server.
|
• |
MARIADB_CONNECTION_SERVER_VERSION |
Retrieves the server version in literal format.
|
• |
MARIADB_CONNECTION_SERVER_VERSION_ID |
Retrieves the server version in numeric format.
|
• |
MARIADB_CONNECTION_SOCKET |
Retrieves the handle (socket) for given connection.
|
• |
MARIADB_CONNECTION_SQLSTATE |
Retrieves current sqlstate information for last used command.
|
• |
MARIADB_CONNECTION_SSL_CIPHER |
Retrieves the TLS/SSL cipher in use.
|
• |
MARIADB_CONNECTION_TLS_VERSION |
Retrieves the TLS protocol version used in literal format.
|
• |
MARIADB_CONNECTION_TLS_VERSION_ID |
Retrieves the TLS protocol version used in numeric format.
|
• |
MARIADB_CONNECTION_UNIX_SOCKET |
Retrieves the file name of the unix socket
|
• |
MARIADB_CONNECTION_USER |
Retrieves connection’s user name.
Returns zero on success, non zero if an error occurred (e.g. if an invalid option was specified),
## History This function was added in MariaDB Connector/C 3.0, ## Examples
/* get server port for current connection / unsigned int port; mariadb_get_infov(mysql, MARIADB_CONNECTION_PORT, (void )&port);
/* get user name for current connection / const char user; mariadb_get_infov(mysql, MARIADB_CONNECTION_USER, (void )&user); ``` ## See also mysql_get_optionv(3)