database/mariadb-connector-c
1
0
Fork 0
mirror of https://github.com/mariadb-corporation/mariadb-connector-c.git synced 2025-08-08 14:02:17 +03:00
Code Activity

Updated man pages (rebuilt with pandoc 3.5)

Browse Source
This commit is contained in:
Georg Richter
2024-10-24 20:50:13 +02:00
parent e8234ba791
commit e06ff35fd7
128 changed files with 1637 additions and 2257 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
man/mariadb_cancel.3
View File

@@ -1,36 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_cancel" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_cancel" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_cancel \- Immediately aborts a connection mariadb_cancel \- Immediately aborts a connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mariadb_cancel(MYSQL * mysql); int mariadb_cancel(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Immediately aborts a connection by making all subsequent read/write Immediately aborts a connection by making all subsequent read/write
operations fail. operations fail.
\f[C]mariadb_cancel()\f[R] does not invalidate memory used for \f[CR]mariadb_cancel()\f[R] does not invalidate memory used for
\f[C]mysql\f[R] structure, nor close any communication channels. \f[CR]mysql\f[R] structure, nor close any communication channels.
To free the memory, \f[B]mysql_close(3)\f[R] must be called. To free the memory, \f[B]mysql_close(3)\f[R] must be called.
\f[C]mariadb_cancel()\f[R] is useful to break long queries in situations \f[CR]mariadb_cancel()\f[R] is useful to break long queries in
where sending KILL is not possible. situations where sending KILL is not possible.
.SS Parameter .SS Parameter
.PP \f[CR]mysql\f[R] \- mysql handle, which was previously allocated by
\f[C]mysql\f[R] \- mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success or a non\-zero value on error. Returns zero on success or a non\-zero value on error.
.SS History .SS History
.PP \f[CR]mariadb_cancel()\f[R] was added in Connector/C 3.0
\f[C]mariadb_cancel()\f[R] was added in Connector/C 3.0

19
man/mariadb_connection.3
View File

@@ -1,29 +1,22 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_connection" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_connection" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_connection \- checks if the client is connected to a MariaDB mariadb_connection \- checks if the client is connected to a MariaDB
database server database server
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mariadb_connection(MYSQL * mysql); my_bool mariadb_connection(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Checks if the client is connected to a MariaDB or MySQL database server. Checks if the client is connected to a MariaDB or MySQL database server.
.SS Parameter .SS Parameter
.PP \f[CR]mysql\f[R] \- mysql handle, which was previously allocated by
\f[C]mysql\f[R] \- mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP
Returns a non zero value if connected to a MariaDB database server, Returns a non zero value if connected to a MariaDB database server,
otherwise zero. otherwise zero.

28
man/mariadb_dyncol_check.3
View File

@@ -1,32 +1,26 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_check" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_check" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_check \- Checks if a dynamic column has correct format mariadb_dyncol_check \- Checks if a dynamic column has correct format
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_check(DYNAMIC_COLUMN *str); mariadb_dyncol_check(DYNAMIC_COLUMN *str);
\f[R] .EE
.fi
.SS Description .SS Description
.PP The function \f[CR]mariadb_dyncol_check()\f[R] checks if a dynamic
The function \f[C]mariadb_dyncol_check()\f[R] checks if a dynamic column column has correct format.
has correct format.
This can be used e.g.\ to check if a blob contains a dynamic column. This can be used e.g.\ to check if a blob contains a dynamic column.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]str\f[R]\- pointer to a \f[C]DYNAMIC_COLUMN\f[R] structure. \f[CR]str\f[R]\- pointer to a \f[CR]DYNAMIC_COLUMN\f[R] structure.
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] if the dynamic column has correct
Returns \f[C]ER_DYNCOL_OK\f[R] if the dynamic column has correct format, format, otherwise \f[CR]ER_DYNCOL_FORMAT\f[R].
otherwise \f[C]ER_DYNCOL_FORMAT\f[R].
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_dyncol_count(3)\f[R] \f[B]mariadb_dyncol_count(3)\f[R]

26
man/mariadb_dyncol_column_cmp_named.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_column_cmp_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_column_cmp_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_column_cmp_named \- Compare two column names mariadb_dyncol_column_cmp_named \- Compare two column names
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
int mariadb_dyncol_column_cmp_named(const MYSQL_LEX_STRING *s1, int mariadb_dyncol_column_cmp_named(const MYSQL_LEX_STRING *s1,
const MYSQL_LEX_STRING *s2); const MYSQL_LEX_STRING *s2);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Compares two dynamic column keys represented as a pointer to a Compares two dynamic column keys represented as a pointer to a
\f[C]MYSQL_LEX_STRING\f[R] structure. \f[CR]MYSQL_LEX_STRING\f[R] structure.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]s1\f[R] \- First key \f[CR]s1\f[R] \- First key
.IP \[bu] 2 .IP \[bu] 2
\f[C]s2\f[R] \- Second key \f[CR]s2\f[R] \- Second key
.SS Return value .SS Return value
.PP
Returns an integer less than, equal to, or greater than zero if the Returns an integer less than, equal to, or greater than zero if the
first bytes of \f[C]s1\f[R] is found, respectively, to be less than, to first bytes of \f[CR]s1\f[R] is found, respectively, to be less than, to
match, or be greater than the first bytes of \f[C]s2\f[R]. match, or be greater than the first bytes of \f[CR]s2\f[R].

28
man/mariadb_dyncol_column_count.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_column_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_column_count" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_column_count \- Get number of columns in dynamic column mariadb_dyncol_column_count \- Get number of columns in dynamic column
blob ## Synopsis blob ## Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_column_count(DYNAMIC_COLUMN *str, mariadb_dyncol_column_count(DYNAMIC_COLUMN *str,
unsigned int *column_count); unsigned int *column_count);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Gets the number of columnns in a dynamic column blob. Gets the number of columnns in a dynamic column blob.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a \f[C]DYNAMIC_COLUMN\f[R] structure \f[CR]*str\f[R] \- A pointer to a \f[CR]DYNAMIC_COLUMN\f[R] structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_count\f[R] \- An unsigned integer pointer where the number \f[CR]column_count\f[R] \- An unsigned integer pointer where the number
of columns will be stored. of columns will be stored.
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
\f[C]mariadb_dyncol_column_count()\f[R] doesn\[cq]t count NULL values. \f[CR]mariadb_dyncol_column_count()\f[R] doesn\[cq]t count NULL values.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

40
man/mariadb_dyncol_create_many_named.3
View File

@@ -1,51 +1,45 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_create_many_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_create_many_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_create_many_named \- Creates a dynamic column with named mariadb_dyncol_create_many_named \- Creates a dynamic column with named
keys keys
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_create_many_named(DYNAMIC_COLUMN *str, mariadb_dyncol_create_many_named(DYNAMIC_COLUMN *str,
uint column_count, uint column_count,
MYSQL_LEX_STRING *column_keys, MYSQL_LEX_STRING *column_keys,
DYNAMIC_COLUMN_VALUE *values, DYNAMIC_COLUMN_VALUE *values,
my_bool new_string); my_bool new_string);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Create a dynamic column from arrays of values and names. Create a dynamic column from arrays of values and names.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a dynamic column structure \f[CR]*str\f[R] \- A pointer to a dynamic column structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_count\f[R] \- number of columns \f[CR]column_count\f[R] \- number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_keys\f[R] \- an array of column keys \f[CR]*column_keys\f[R] \- an array of column keys
.IP \[bu] 2 .IP \[bu] 2
\f[C]*values\f[R] \- an array of values \f[CR]*values\f[R] \- an array of values
.IP \[bu] 2 .IP \[bu] 2
\f[C]new_string\f[R] \- if set \f[C]str\f[R] will be reinitialized (not \f[CR]new_string\f[R] \- if set \f[CR]str\f[R] will be reinitialized
freed) before usage (not freed) before usage
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To delete, update or insert new columns into an existing dynamic column To delete, update or insert new columns into an existing dynamic column
use <mariadb_dyncol_update_many_named> function use mariadb_dyncol_update_many_named function
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_create_many_num> mariadb_dyncol_create_many_num
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_update_many_named> mariadb_dyncol_update_many_named
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

42
man/mariadb_dyncol_create_many_num.3
View File

@@ -1,51 +1,45 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_create_many_num" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_create_many_num" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_create_many_num \- Creates a dynamic column with numeric mariadb_dyncol_create_many_num \- Creates a dynamic column with numeric
keys keys
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_create_many_num(DYNAMIC_COLUMN *str, mariadb_dyncol_create_many_num(DYNAMIC_COLUMN *str,
uint column_count, uint column_count,
uint *column_numbers, uint *column_numbers,
DYNAMIC_COLUMN_VALUE *values, DYNAMIC_COLUMN_VALUE *values,
my_bool new_string); my_bool new_string);
\f[R] .EE
.fi
.SS Description .SS Description
.PP Create a dynamic column from arrays of values and numbérs
Create a dynamic column from arrays of values and numb\['e]rs
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a dynamic column structure \f[CR]*str\f[R] \- A pointer to a dynamic column structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_count\f[R] \- number of columns \f[CR]column_count\f[R] \- number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_numbers\f[R] \- an array of column numbers \f[CR]*column_numbers\f[R] \- an array of column numbers
.IP \[bu] 2 .IP \[bu] 2
\f[C]*values\f[R] \- an array of values \f[CR]*values\f[R] \- an array of values
.IP \[bu] 2 .IP \[bu] 2
\f[C]new_string\f[R] \- if set \f[C]str\f[R] will be reinitialized (not \f[CR]new_string\f[R] \- if set \f[CR]str\f[R] will be reinitialized
freed) before usage (not freed) before usage
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To delete, update or insert new columns into an existing dynamic column To delete, update or insert new columns into an existing dynamic column
use <mariadb_dyncol_update_many_num> function use mariadb_dyncol_update_many_num function
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_create_many_named> mariadb_dyncol_create_many_named
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_update_many_num> mariadb_dyncol_update_many_num
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

28
man/mariadb_dyncol_exists_named.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_exists_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_exists_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_exists_named \- Check if column with given name exists. mariadb_dyncol_exists_named \- Check if column with given name exists.
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] \f[B]enum\f[R] enum_dyncol_func_result
enum enum_dyncol_func_result
mariadb_dyncol_exists_named(DYNAMIC_COLUMN *str, mariadb_dyncol_exists_named(DYNAMIC_COLUMN *str,
MYSQL_LEX_STRING *column_key); MYSQL_LEX_STRING *column_key);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Checks if a column with the specified column key exists. Checks if a column with the specified column key exists.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- Dynamic column \f[CR]*str\f[R] \- Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_key\f[R] \- The column key to search for \f[CR]*column_key\f[R] \- The column key to search for
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_YES\f[R] if a column with given key exists,
Returns \f[C]ER_DYNCOL_YES\f[R] if a column with given key exists, \f[CR]ER_DYNCOL_NO\f[R] if no column exists or error.
\f[C]ER_DYNCOL_NO\f[R] if no column exists or error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_exists_num> mariadb_dyncol_exists_num
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

28
man/mariadb_dyncol_exists_num.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_exists_num" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_exists_num" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_exists_num \- Check if column with given number exists. mariadb_dyncol_exists_num \- Check if column with given number exists.
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] \f[B]enum\f[R] enum_dyncol_func_result
enum enum_dyncol_func_result
mariadb_dyncol_exists_num(DYNAMIC_COLUMN *str, mariadb_dyncol_exists_num(DYNAMIC_COLUMN *str,
uint column_number); uint column_number);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Checks if a column with the specified column key exists. Checks if a column with the specified column key exists.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- Dynamic column \f[CR]*str\f[R] \- Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_number\f[R] \- The column number to search for \f[CR]column_number\f[R] \- The column number to search for
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_YES\f[R] if a column with given number exists,
Returns \f[C]ER_DYNCOL_YES\f[R] if a column with given number exists, \f[CR]ER_DYNCOL_NO\f[R] if no column exists or error.
\f[C]ER_DYNCOL_NO\f[R] if no column exists or error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_exists_named> mariadb_dyncol_exists_named
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

21
man/mariadb_dyncol_free.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_free" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_free" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_free \- Free memory inside packed blob mariadb_dyncol_free \- Free memory inside packed blob
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
void mariadb_dyncol_free(DYNAMIC_COLUMN *str) void mariadb_dyncol_free(DYNAMIC_COLUMN *str)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Frees memory associated by the specified dynamic column Frees memory associated by the specified dynamic column
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a \f[C]DYNAMIC_COLUMN\f[R] structure \f[CR]*str\f[R] \- A pointer to a \f[CR]DYNAMIC_COLUMN\f[R] structure
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
\f[C]mariadb_dyncol_free()\f[R] doesn\[cq]t free the memory of the \f[CR]mariadb_dyncol_free()\f[R] doesn\[cq]t free the memory of the
passed \f[C]DYNAMIC_COLUMN\f[R] structure but all memory of stored passed \f[CR]DYNAMIC_COLUMN\f[R] structure but all memory of stored
columns. columns.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

26
man/mariadb_dyncol_get_named.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_get_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_get_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_get_name \- Get value of a column with given key mariadb_dyncol_get_name \- Get value of a column with given key
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_get_named(DYNAMIC_COLUMN *str, mariadb_dyncol_get_named(DYNAMIC_COLUMN *str,
LEX_STRING *key, LEX_STRING *key,
DYNAMIC_COLUMN_VALUE *store_it_here) DYNAMIC_COLUMN_VALUE *store_it_here)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns a dynamic column value by given key Returns a dynamic column value by given key
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]str\f[R]: Dynamic column \f[CR]str\f[R]: Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]name\f[R]: Name to search for \f[CR]name\f[R]: Name to search for
.IP \[bu] 2 .IP \[bu] 2
\f[C]value\f[R]: Value of dynamic column \f[CR]value\f[R]: Value of dynamic column
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error.
If the column name could not be found, value will be NULL If the column name could not be found, value will be NULL
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

26
man/mariadb_dyncol_get_num.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_get_num" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_get_num" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_get_num \- Get value of a column with given number mariadb_dyncol_get_num \- Get value of a column with given number
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_get_num(DYNAMIC_COLUMN *str, mariadb_dyncol_get_num(DYNAMIC_COLUMN *str,
uint column_nr, uint column_nr,
DYNAMIC_COLUMN_VALUE *store_it_here) DYNAMIC_COLUMN_VALUE *store_it_here)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns a dynamic column value by given number Returns a dynamic column value by given number
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]str\f[R]: Dynamic column \f[CR]str\f[R]: Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_nr\f[R]: Number of column \f[CR]column_nr\f[R]: Number of column
.IP \[bu] 2 .IP \[bu] 2
\f[C]value\f[R]: Value of dynamic column \f[CR]value\f[R]: Value of dynamic column
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error.
If the column number could not be found, value will be NULL If the column number could not be found, value will be NULL
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mariadb_dyncol_has_names.3
View File

@@ -1,27 +1,21 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_has_names" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_has_names" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_has_names \- Checks if dynamic column uses named keys mariadb_dyncol_has_names \- Checks if dynamic column uses named keys
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
my_bool mariadb_dyncol_has_names(DYNAMIC_COLUMN *str) my_bool mariadb_dyncol_has_names(DYNAMIC_COLUMN *str)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Checks if the specified dynamic column uses named keys. Checks if the specified dynamic column uses named keys.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]str\f[R]: Dynamic column \f[CR]str\f[R]: Dynamic column
.SS Return value .SS Return value
.PP
Returns 1 if the specified dynamic column uses named keys, otherwise Returns 1 if the specified dynamic column uses named keys, otherwise
zero. zero.
.SS See also .SS See also

24
man/mariadb_dyncol_json.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_json" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_json" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_json \- Get content of a dynamic column in JSON format mariadb_dyncol_json \- Get content of a dynamic column in JSON format
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_json(DYNAMIC_COLUMN *str, mariadb_dyncol_json(DYNAMIC_COLUMN *str,
DYNAMIC_STRING *json) DYNAMIC_STRING *json)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Get content of a dynamic column in JSON format. Get content of a dynamic column in JSON format.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- Dynamic column \f[CR]*str\f[R] \- Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]*json\f[R] \- Pointer to a dynamic string which contains json \f[CR]*json\f[R] \- Pointer to a dynamic string which contains json
output output
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_dyncol_list_json(3)\f[R] \f[B]mariadb_dyncol_list_json(3)\f[R]

34
man/mariadb_dyncol_list_named.3
View File

@@ -1,43 +1,37 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_list_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_list_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_list_named \- Lists column keys in dynamic column mariadb_dyncol_list_named \- Lists column keys in dynamic column
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_list_named(DYNAMIC_COLUMN *str, mariadb_dyncol_list_named(DYNAMIC_COLUMN *str,
uint *column_count, uint *column_count,
MYSQL_LEX_STRING **column_keys); MYSQL_LEX_STRING **column_keys);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Lists the column keys inside a dynamic column. Lists the column keys inside a dynamic column.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The application program needs to free the allocated memory for The application program needs to free the allocated memory for
\f[C]column_count\f[R] and \f[C]column_keys\f[R] parameter. \f[CR]column_count\f[R] and \f[CR]column_keys\f[R] parameter.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- Dynamic column \f[CR]*str\f[R] \- Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_count\f[R] \- A pointer to an unsigned integer which stores \f[CR]*column_count\f[R] \- A pointer to an unsigned integer which
the number of columns stores the number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]**column_keys\f[R] \- A pointer to an array of column keys, which \f[CR]**column_keys\f[R] \- A pointer to an array of column keys, which
stores the keys stores the keys
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_list_num> mariadb_dyncol_list_num
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_list_json> mariadb_dyncol_list_json

34
man/mariadb_dyncol_list_num.3
View File

@@ -1,43 +1,37 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_list_num" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_list_num" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_list_num \- Lists numeric column keys in dynamic column mariadb_dyncol_list_num \- Lists numeric column keys in dynamic column
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_list_named(DYNAMIC_COLUMN *str, mariadb_dyncol_list_named(DYNAMIC_COLUMN *str,
uint *column_count, uint *column_count,
uint **column_numbers); uint **column_numbers);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Lists the column numbers inside a dynamic column. Lists the column numbers inside a dynamic column.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- Dynamic column \f[CR]*str\f[R] \- Dynamic column
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_count\f[R] \- A pointer to an unsigned integer which stores \f[CR]*column_count\f[R] \- A pointer to an unsigned integer which
the number of columns stores the number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]**column_numbers\f[R] \- A pointer to an array of column numbers, \f[CR]**column_numbers\f[R] \- A pointer to an array of column numbers,
which stores the numbers which stores the numbers
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The application program needs to free the allocated memory for The application program needs to free the allocated memory for
\f[C]column_count\f[R] and \f[C]column_numbers\f[R] parameter. \f[CR]column_count\f[R] and \f[CR]column_numbers\f[R] parameter.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_list_named> mariadb_dyncol_list_named
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_list_json> mariadb_dyncol_list_json

39
man/mariadb_dyncol_unpack.3
View File

@@ -1,48 +1,43 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_unpack" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_unpack" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_unpack \- extracts keys and values of all columns mariadb_dyncol_unpack \- extracts keys and values of all columns
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_unpack(DYNAMIC_COLUMN *str, mariadb_dyncol_unpack(DYNAMIC_COLUMN *str,
uint *column_count, uint *column_count,
MYSQL_LEX_STRING **column_keys, MYSQL_LEX_STRING **column_keys,
DYNAMIC_COLUMN_VALUE **values); DYNAMIC_COLUMN_VALUE **values);
\f[R] .EE
.fi
.SS Description .SS Description
.PP The \f[CR]mariadb_dyncol_unpack()\f[R] function extracts all keys and
The \f[C]mariadb_dyncol_unpack()\f[R] function extracts all keys and
values of a dynamic column. values of a dynamic column.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]str\f[R] \- Pointer to a \f[C]DYNAMIC_COLUMN\f[R] structure \f[CR]str\f[R] \- Pointer to a \f[CR]DYNAMIC_COLUMN\f[R] structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column count\f[R] \- Pointer to an unsigned integer which will \f[CR]column count\f[R] \- Pointer to an unsigned integer which will
receive the number of columns receive the number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_keys\f[R] \- Pointer of an array of \f[CR]column_keys\f[R] \- Pointer of an array of
\f[C]MYSQL_LEX_STRING\f[R] structures, which will contain the column \f[CR]MYSQL_LEX_STRING\f[R] structures, which will contain the column
keys keys
.IP \[bu] 2 .IP \[bu] 2
\f[C]values\f[R] \- Pointer of an array of \f[CR]values\f[R] \- Pointer of an array of
\f[C]DYNAMIC_COLUMN_VALUE\f[R] structures, which will contain the \f[CR]DYNAMIC_COLUMN_VALUE\f[R] structures, which will contain the
values. values.
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise an error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise an error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The \f[C]column_keys\f[R] and \f[C]values\f[R] arrays will be allocated The \f[CR]column_keys\f[R] and \f[CR]values\f[R] arrays will be
by \f[C]mariadb_dyncol_unpack()\f[R] and must be freed by application. allocated by \f[CR]mariadb_dyncol_unpack()\f[R] and must be freed by
application.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_dyncol_get(3)\f[R] \f[B]mariadb_dyncol_get(3)\f[R]

36
man/mariadb_dyncol_update_many_named.3
View File

@@ -1,47 +1,41 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_update_many_named" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_update_many_named" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_update_many_named \- Update, insert or delete values in a mariadb_dyncol_update_many_named \- Update, insert or delete values in a
dynamic column dynamic column
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_update_many_named(DYNAMIC_COLUMN *str, mariadb_dyncol_update_many_named(DYNAMIC_COLUMN *str,
uint column_count, uint column_count,
MYSQL_LEX_STRING *column_keys, MYSQL_LEX_STRING *column_keys,
DYNAMIC_COLUMN_VALUE *values) DYNAMIC_COLUMN_VALUE *values)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Add, delete or update columns in a dynamic column. Add, delete or update columns in a dynamic column.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a dynamic column structure \f[CR]*str\f[R] \- A pointer to a dynamic column structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_count\f[R] \- number of columns \f[CR]column_count\f[R] \- number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_keys\f[R] \- an array of column keys \f[CR]*column_keys\f[R] \- an array of column keys
.IP \[bu] 2 .IP \[bu] 2
\f[C]*values\f[R] \- an array of values \f[CR]*values\f[R] \- an array of values
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To delete a column, update its value to a \[lq]non\-value\[rq] of type To delete a column, update its value to a \[lq]non\-value\[rq] of type
\f[C]DYN_COL_NULL\f[R] \f[CR]DYN_COL_NULL\f[R]
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_create_many_named> mariadb_dyncol_create_many_named
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_update_many_num> mariadb_dyncol_update_many_num
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

36
man/mariadb_dyncol_update_many_num.3
View File

@@ -1,47 +1,41 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_dyncol_update_many_num" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_dyncol_update_many_num" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_dyncol_update_many_num \- Update, insert or delete values in a mariadb_dyncol_update_many_num \- Update, insert or delete values in a
dynamic column using numeric keys dynamic column using numeric keys
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_dyncol.h>\f[R]
#include <mariadb_dyncol.h>
enum enum_dyncol_func_result \f[B]enum\f[R] enum_dyncol_func_result
mariadb_dyncol_update_many_num(DYNAMIC_COLUMN *str, mariadb_dyncol_update_many_num(DYNAMIC_COLUMN *str,
uint column_count, uint column_count,
uint *column_keys, uint *column_keys,
DYNAMIC_COLUMN_VALUE *values) DYNAMIC_COLUMN_VALUE *values)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Add, delete or update columns in a dynamic column with a numeric key. Add, delete or update columns in a dynamic column with a numeric key.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]*str\f[R] \- A pointer to a dynamic column structure \f[CR]*str\f[R] \- A pointer to a dynamic column structure
.IP \[bu] 2 .IP \[bu] 2
\f[C]column_count\f[R] \- number of columns \f[CR]column_count\f[R] \- number of columns
.IP \[bu] 2 .IP \[bu] 2
\f[C]*column_keys\f[R] \- an array of column keys \f[CR]*column_keys\f[R] \- an array of column keys
.IP \[bu] 2 .IP \[bu] 2
\f[C]*values\f[R] \- an array of values \f[CR]*values\f[R] \- an array of values
.SS Return value .SS Return value
.PP Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error.
Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To delete a column, update its value to a \[lq]non\-value\[rq] of type To delete a column, update its value to a \[lq]non\-value\[rq] of type
\f[C]DYN_COL_NULL\f[R] \f[CR]DYN_COL_NULL\f[R]
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_create_many_num> mariadb_dyncol_create_many_num
.IP \[bu] 2 .IP \[bu] 2
<mariadb_dyncol_update_many_named> mariadb_dyncol_update_many_named
.IP \[bu] 2 .IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) Dynamic Column Error Codes

55
man/mariadb_field_attr.3
View File

@@ -1,38 +1,32 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_field_attr" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_field_attr" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_field_attr \- returns extended metadata information for mariadb_field_attr \- returns extended metadata information for
pluggable field types pluggable field types
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int *mariadb_field_attr(MARIADB_CONST_STRING *attr, int *mariadb_field_attr(MARIADB_CONST_STRING *attr,
const MYSQL_FIELD *field, const MYSQL_FIELD *field,
enum mariadb_field_attr_t type) \f[B]enum\f[R] mariadb_field_attr_t type)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns extended metadata information for pluggable field types like Returns extended metadata information for pluggable field types like
JSON and GEOMETRY. JSON and GEOMETRY.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]attr\f[R]: A pointer which returns extended metadata information \f[CR]attr\f[R]: A pointer which returns extended metadata information
.IP \[bu] 2 .IP \[bu] 2
\f[C]field\f[R]: Specifies the field which contains extended metadata \f[CR]field\f[R]: Specifies the field which contains extended metadata
information information
.IP \[bu] 2 .IP \[bu] 2
\f[C]type:\f[R] Specifies type of metadata information. \f[CR]type:\f[R] Specifies type of metadata information.
Supported types are \f[C]MARIADB_FIELD_METADATA_DATA_TYPE_NAME\f[R] and Supported types are \f[CR]MARIADB_FIELD_METADATA_DATA_TYPE_NAME\f[R] and
\f[C]MARIADB_FIELD_METADATA_FORMAT_NAME\f[R]. \f[CR]MARIADB_FIELD_METADATA_FORMAT_NAME\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success or non zero if the field doesn\[cq]t provide Returns zero on success or non zero if the field doesn\[cq]t provide
extended metadata information. extended metadata information.
.SS Notes .SS Notes
@@ -45,41 +39,38 @@ extended server capabilities which can be obtained by api function
\f[B]mariadb_get_info(3)\f[R] \f[B]mariadb_get_info(3)\f[R]
.SS Example .SS Example
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int display_extended_field_attribute(MYSQL *mysql) int display_extended_field_attribute(MYSQL *mysql)
{ {
MYSQL_RES *result; MYSQL_RES *result;
MYSQL_FIELD *fields; MYSQL_FIELD *fields;
if (mysql_query(mysql, \[dq]CREATE TEMPORARY TABLE t1 (a POINT)\[dq])) \f[B]if\f[R] (mysql_query(mysql, \[dq]CREATE TEMPORARY TABLE t1 (a POINT)\[dq]))
return 1; \f[B]return\f[R] 1;
if (mysql_query(mysql, \[dq]SELECT a FROM t1\[dq])) \f[B]if\f[R] (mysql_query(mysql, \[dq]SELECT a FROM t1\[dq]))
return 1; \f[B]return\f[R] 1;
if (!(result= mysql_store_result(mysql))) \f[B]if\f[R] (!(result= mysql_store_result(mysql)))
return 1; \f[B]return\f[R] 1;
if ((fields= mysql_fetch_fields(result))) \f[B]if\f[R] ((fields= mysql_fetch_fields(result)))
{ {
MARIADB_CONST_STRING field_attr; MARIADB_CONST_STRING field_attr;
if (!mariadb_field_attr(&field_attr, &fields[0], \f[B]if\f[R] (!mariadb_field_attr(&field_attr, &fields[0],
MARIADB_FIELD_ATTR_DATA_TYPE_NAME)) MARIADB_FIELD_ATTR_DATA_TYPE_NAME))
{ {
printf(\[dq]Extended field attribute: %s\[rs]n\[dq], field_attr.str); printf(\[dq]Extended field attribute: %s\[rs]n\[dq], field_attr.str);
} }
} }
mysql_free_result(result); mysql_free_result(result);
return 0; \f[B]return\f[R] 0;
} }
\f[R] .EE
.fi
.SS History .SS History
.PP
mariadb_field_attr was added in MariaDB Connector/C 3.1.8 mariadb_field_attr was added in MariaDB Connector/C 3.1.8
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

20
man/mariadb_free_rpl_event.3
View File

@@ -1,26 +1,20 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_free_rpl_event" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_free_rpl_event" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_free_rpl_event \- free event memory mariadb_free_rpl_event \- free event memory
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
void mariadb_free_rpl_event(MARIADB_RPL_EVENT *event) void mariadb_free_rpl_event(MARIADB_RPL_EVENT *event)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Frees event memory. Frees event memory.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]event\f[R] \- An event handle which was previously obtained by \f[CR]event\f[R] \- An event handle which was previously obtained by
\f[B]mariadb_rpl_fetch(3)\f[R]. \f[B]mariadb_rpl_fetch(3)\f[R].
.SS History .SS History
.PP \f[CR]mariadb_free_rpl_event\f[R] was added in MariaDB Connector/C 3.1.0
\f[C]mariadb_free_rpl_event\f[R] was added in MariaDB Connector/C 3.1.0

237
man/mariadb_get_infov.3
View File

@@ -1,29 +1,23 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_get_infov" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_get_infov" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP mariadb_get_infov \- retrieves generic or connection related information
mariadb_get_infov \- retrieves generic or connection releated
information
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mariadb_get_infov(MYSQL * mysql, int mariadb_get_infov(MYSQL * mysql,
enum mariadb_value value, \f[B]enum\f[R] mariadb_value value,
void * arg, void * arg,
...); ...);
\f[R] .EE
.fi
.SH Description .SH Description
.PP
Retrieves generic or connection specific information. Retrieves generic or connection specific information.
\f[C]arg\f[R] (and further arguments) must be a pointer to a variable of \f[CR]arg\f[R] (and further arguments) must be a pointer to a variable
the type appropriate for the \f[C]value\f[R] argument. of the type appropriate for the \f[CR]value\f[R] argument.
The following table shows which variable type to use for each value. The following table shows which variable type to use for each value.
.PP .PP
.TS .TS
@@ -36,77 +30,82 @@ Values
T} T}
_ _
T{ T{
\f[C]unsigned int\f[R] \f[CR]unsigned int\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CLIENT_VERSION_ID\f[R], \f[CR]MARIADB_CLIENT_VERSION_ID\f[R],
\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R], \f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R],
\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R], \f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R],
\f[C]MARIADB_CONNECTION_ERROR_ID\f[R], \f[CR]MARIADB_CONNECTION_ERROR_ID\f[R],
\f[C]MARIADB_CONNECTION_PORT\f[R], \f[CR]MARIADB_CONNECTION_PORT\f[R],
\f[C]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R], \f[CR]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R],
\f[C]MARIADB_CONNECTION_PVIO_TYPE\f[R], \f[CR]MARIADB_CONNECTION_PVIO_TYPE\f[R],
\f[C]MARIADB_CONNECTION_SERVER_STATUS\f[R], \f[CR]MARIADB_CONNECTION_SERVER_STATUS\f[R],
\f[C]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R], \f[CR]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R],
\f[C]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] \f[CR]MARIADB_CONNECTION_TLS_VERSION_ID\f[R]
T} T}
T{ T{
\f[C]unsigned long\f[R] \f[CR]unsigned long\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R], \f[CR]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R],
\f[C]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R], \f[CR]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R],
\f[C]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] \f[CR]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R]
T} T}
T{ T{
\f[C]size_t\f[R] \f[CR]size_t\f[R]
T}@T{ T}@T{
\f[C]MARIADB_MAX_ALLOWED_PACKET\f[R], \f[CR]MARIADB_MAX_ALLOWED_PACKET\f[R],
\f[C]MARIADB_NET_BUFFER_LENGTH\f[R] \f[CR]MARIADB_NET_BUFFER_LENGTH\f[R]
T} T}
T{ T{
\f[C]const char *\f[R] \f[CR]const char *\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CLIENT_VERSION\f[R], \f[C]MARIADB_TLS_VERSION\f[R], \f[CR]MARIADB_CLIENT_VERSION\f[R], \f[CR]MARIADB_TLS_LIBRARY\f[R],
\f[C]MARIADB_CONNECTION_ERROR\f[R], \f[C]MARIADB_CONNECTION_HOST\f[R], \f[CR]MARIADB_CONNECTION_ERROR\f[R], \f[CR]MARIADB_CONNECTION_HOST\f[R],
\f[C]MARIADB_CONNECTION_INFO\f[R], \f[C]MARIADB_CONNECTION_SCHEMA\f[R], \f[CR]MARIADB_CONNECTION_INFO\f[R],
\f[C]MARIADB_CONNECTION_SERVER_TYPE\f[R], \f[CR]MARIADB_CONNECTION_SCHEMA\f[R],
\f[C]MARIADB_CONNECTION_SERVER_VERSION\f[R], \f[CR]MARIADB_CONNECTION_SERVER_TYPE\f[R],
\f[C]MARIADB_CONNECTION_SQLSTATE\f[R], \f[CR]MARIADB_CONNECTION_SERVER_VERSION\f[R],
\f[C]MARIADB_CONNECTION_SSL_CIPHER\f[R], \f[CR]MARIADB_CONNECTION_SQLSTATE\f[R],
\f[C]MARIADB_CONNECTION_TLS_VERSION\f[R], \f[CR]MARIADB_CONNECTION_SSL_CIPHER\f[R],
\f[C]MARIADB_CONNECTUION_UNIX_SOCKET\f[R], \f[CR]MARIADB_CONNECTION_TLS_VERSION\f[R],
\f[C]MARIADB_CONNECTION_USER\f[R], \f[CR]MARIADB_CONNECTUION_UNIX_SOCKET\f[R],
\f[CR]MARIADB_CONNECTION_USER\f[R],
T} T}
T{ T{
\f[C]const char **\f[R] \f[CR]const char **\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CLIENT_ERRORS\f[R] \f[CR]MARIADB_CLIENT_ERRORS\f[R]
T} T}
T{ T{
\f[C]const *MY_CHARSET_INFO\f[R] \f[CR]const *MY_CHARSET_INFO\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CHARSET_NAME\f[R], \f[CR]MARIADB_CHARSET_NAME\f[R],
\f[C]MARIADB_CONNECTION_CHARSET_INFO\f[R] \f[CR]MARIADB_CONNECTION_CHARSET_INFO\f[R]
T} T}
T{ T{
\f[C]my_socket\f[R] \f[CR]my_socket\f[R]
T}@T{ T}@T{
\f[C]MARIADB_CONNECTION_SOCKET\f[R] \f[CR]MARIADB_CONNECTION_SOCKET\f[R]
T}
T{
\f[CR]MARIADB_X509_INFO *\f[R]
T}@T{
\f[CR]MARIADB_TLS_PEER_CERT_INFO\f[R]
T} T}
.TE .TE
.SS Value types .SS Value types
.SS Generic information .SS Generic information
.PP For these information types parameter \f[CR]mysql\f[R] needs to be set
For these information types parameter \f[C]mysql\f[R] needs to be set to to NULL.
NULL.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CHARSET_NAME\f[R] \f[CR]MARIADB_CHARSET_NAME\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the charset information for a character set by it\[cq]s Retrieves the charset information for a character set by it\[cq]s
literal representation. literal representation.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CLIENT_ERRORS\f[R] \f[CR]MARIADB_CLIENT_ERRORS\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -114,212 +113,218 @@ Retrieve array of client errors.
This can be used in plugins to set global error messages (which are not This can be used in plugins to set global error messages (which are not
exported by MariaDB Connector/C). exported by MariaDB Connector/C).
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CLIENT_VERSION\f[R] \f[CR]MARIADB_CLIENT_VERSION\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
The client version in literal representation. The client version in literal representation.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CLIENT_VERSION_ID\f[R] \f[CR]MARIADB_CLIENT_VERSION_ID\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
The client version in numeric format. The client version in numeric format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_MAX_ALLOWED_PACKET\f[R] \f[CR]MARIADB_MAX_ALLOWED_PACKET\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves value of maximum allowed packet size. Retrieves value of maximum allowed packet size.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_NET_BUFFER_LENGTH\f[R] \f[CR]MARIADB_NET_BUFFER_LENGTH\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the length of net buffer. Retrieves the length of net buffer.
.IP \[bu] 2 .SS Connection and TLS related information
\f[C]MARIADB_SSL_LIBRARY\f[R]
.PD 0
.P
.PD
The TLS library MariaDB Connector/C is compiled against.
.SS Connection related information
.PP
For these information types parameter mysql must be represent a valid For these information types parameter mysql must be represent a valid
connection handle which was allocated by \f[B]mysql_init(3)\f[R]. connection handle which was allocated by \f[B]mysql_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R] \f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the timeout for non blocking calls in seconds. Retrieves the timeout for non blocking calls in seconds.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R] \f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the timeout for non blocking calls in milliseconds. Retrieves the timeout for non blocking calls in milliseconds.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_CHARSET_INFO\f[R] \f[CR]MARIADB_CONNECTION_CHARSET_INFO\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves character set information for given connection. Retrieves character set information for given connection.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R] \f[CR]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Returns the handshak capability flags] of the client. Returns the capability flags of the client.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_ERROR\f[R] \f[CR]MARIADB_CONNECTION_ERROR\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves error message for last used command. Retrieves error message for last used command.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_ERROR_ID\f[R] \f[CR]MARIADB_CONNECTION_ERROR_ID\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves error number for last used command. Retrieves error number for last used command.
*\f[C]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R] *\f[CR]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Returns the extended capability flags of the connected MariaDB server Returns the extended capability flags of the connected MariaDB server
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_HOST\f[R] \f[CR]MARIADB_CONNECTION_HOST\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Returns host name of the connected MariaDB server Returns host name of the connected MariaDB server
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_INFO\f[R] \f[CR]MARIADB_CONNECTION_INFO\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves generic info for last used command. Retrieves generic info for last used command.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_PORT\f[R] \f[CR]MARIADB_CONNECTION_PORT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the port number of server host. Retrieves the port number of server host.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R] \f[CR]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the protocol version number. Retrieves the protocol version number.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_PVIO_TYPE\f[R] \f[CR]MARIADB_CONNECTION_PVIO_TYPE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the pvio plugin used for specified connection. Retrieves the pvio plugin used for specified connection.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SCHEMA\f[R] \f[CR]MARIADB_CONNECTION_SCHEMA\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the current schema. Retrieves the current schema.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] \f[CR]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrievrs the capability flags of the connected server. Retrievrs the capability flags of the connected server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SERVER_STATUS\f[R] \f[CR]MARIADB_CONNECTION_SERVER_STATUS\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Returns server status after last operation. Returns server status after last operation.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SERVER_TYPE\f[R] \f[CR]MARIADB_CONNECTION_SERVER_TYPE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the type of the server. Retrieves the type of the server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SERVER_VERSION\f[R] \f[CR]MARIADB_CONNECTION_SERVER_VERSION\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the server version in literal format. Retrieves the server version in literal format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R] \f[CR]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the server version in numeric format. Retrieves the server version in numeric format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SOCKET\f[R] \f[CR]MARIADB_CONNECTION_SOCKET\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the handle (socket) for given connection. Retrieves the handle (socket) for given connection.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SQLSTATE\f[R] \f[CR]MARIADB_CONNECTION_SQLSTATE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves current sqlstate information for last used command. Retrieves current sqlstate information for last used command.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_SSL_CIPHER\f[R] \f[CR]MARIADB_CONNECTION_SSL_CIPHER\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the TLS/SSL cipher in use. Retrieves the TLS/SSL cipher in use.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_TLS_VERSION\f[R] \f[CR]MARIADB_TLS_LIBRARY\f[R]
.PD 0
.P
.PD
Retrieves the name of TLS library.
.IP \[bu] 2
\f[CR]MARIADB_CONNECTION_TLS_VERSION\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the TLS protocol version used in literal format. Retrieves the TLS protocol version used in literal format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] \f[CR]MARIADB_CONNECTION_TLS_VERSION_ID\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the TLS protocol version used in numeric format. Retrieves the TLS protocol version used in numeric format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_UNIX_SOCKET\f[R] \f[CR]MARIADB_CONNECTION_UNIX_SOCKET\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves the file name of the unix socket Retrieves the file name of the unix socket
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_CONNECTION_USER\f[R] \f[CR]MARIADB_CONNECTION_USER\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Retrieves connection\[cq]s user name. Retrieves connection\[cq]s user name.
.IP \[bu] 2
\f[CR]MARIADB_TLS_PEER_CERT_INFO\f[R] Retrieves peer certificate
information for TLS connections.
The returned pointer to a MARIADB_X509_INFO structure becomes invalid
after the connection has been closed.
(Added in version 3.4.0)
.IP \[bu] 2
\f[CR]MARIADB_TLS_VERIFY_STATUS\f[R] Retrieves the status of a previous
peer certificate verification.
The status is represented as a combination of TLS verification flags.
This option was added in version 3.4.1
.SS Returns .SS Returns
.PP
Returns zero on success, non zero if an error occurred (e.g.\ if an Returns zero on success, non zero if an error occurred (e.g.\ if an
invalid option was specified), invalid option was specified),
.SS Source file .SS Source file
.IP \f[CR]libmariadb/mariadb_lib.c\f[R]
.nf .SS History
\f[C]
## History
This function was added in MariaDB Connector/C 3.0, This function was added in MariaDB Connector/C 3.0,
.SS Examples
## Examples
\f[R]
.fi
.PP
/* get server port for current connection \f[I]/ unsigned int port;
mariadb_get_infov(mysql, MARIADB_CONNECTION_PORT, (void \f[R])&port);
.IP .IP
.nf .EX
\f[C] /* get server port for current connection */
\f[R] unsigned int port;
.fi mariadb_get_infov(mysql, MARIADB_CONNECTION_PORT, (void *)&port);
.PP .EE
/* get user name for current connection \f[I]/ const char \f[R]user; .IP
mariadb_get_infov(mysql, MARIADB_CONNECTION_USER, (void \f[I])&user); .EX
\[ga]\[ga]\[ga] ## See also \f[R] \f[B]mysql_get_optionv(3)\f[R] /* get user name for current connection */
const char *user;
mariadb_get_infov(mysql, MARIADB_CONNECTION_USER, (void *)&user);
.EE
.SS See also
.IP \[bu] 2
\f[B]mysql_get_optionv(3)\f[R]

27
man/mariadb_reconnect.3
View File

@@ -1,34 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_reconnect" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_reconnect" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_reconnect \- reconnects to a server mariadb_reconnect \- reconnects to a server
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mariadb_reconnect(MYSQL * mysql) my_bool mariadb_reconnect(MYSQL * mysql)
\f[R] .EE
.fi
.SS Description .SS Description
.PP \f[CR]mariadb_reconnect()\f[R] tries to reconnect to a server in case
\f[C]mariadb_reconnect()\f[R] tries to reconnect to a server in case the the connection died due to timeout or other errors.
connection died due to timeout or other errors.
It uses the same credentials which were specified in It uses the same credentials which were specified in
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP The function will return 0 on success, a non zero value on error
The function will return 0 on sucess, a non zero value on error
.PP .PP
\f[B]Note\f[R]: The function will return an error, if the option \f[B]Note\f[R]: The function will return an error, if the option
\f[C]MYSQL_OPT_RECONNECT\f[R] wasn\[cq]t set before. \f[CR]MYSQL_OPT_RECONNECT\f[R] wasn\[cq]t set before.
.SS History .SS History
.PP \f[CR]mariadb_reconnect()\f[R] was added in MariaDB Connector/C 3.0
\f[C]mariadb_reconnect()\f[R] was added in MariaDB Connector/C 3.0
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_real_connect(3)\f[R] \f[B]mysql_real_connect(3)\f[R]

22
man/mariadb_rpl_close.3
View File

@@ -1,31 +1,23 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_rpl_close" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_rpl_close" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_rpl_close \- Closes replication stream mariadb_rpl_close \- Closes replication stream
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
void mariadb_rpl_close(MARIADB_RPL *rpl) void mariadb_rpl_close(MARIADB_RPL *rpl)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Closes a replication stream. Closes a replication stream.
.SS Parameter .SS Parameter
.PP \f[CR]rpl\f[R] \- A replication handle which was initialized by
\f[C]rpl\f[R] \- A replication handle which was initialized by
\f[B]mariadb_rpl_init(3)\f[R] and connected by \f[B]mariadb_rpl_init(3)\f[R] and connected by
\f[B]mariadb_rpl_open(3)\f[R]. \f[B]mariadb_rpl_open(3)\f[R].
.SS Notes .SS Notes
.PP
To close the connection to the server, the api function To close the connection to the server, the api function
\f[B]mariadb_close(3)\f[R] must be called. \f[B]mariadb_close(3)\f[R] must be called.
.SS History .SS History
.PP \f[CR]mariadb_rpl_close\f[R] was added in MariaDB Connector/C 3.1
\f[C]mariadb_rpl_close\f[R] was added in MariaDB Connector/C 3.1

28
man/mariadb_rpl_fetch.3
View File

@@ -1,42 +1,34 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_rpl_fetch" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_rpl_fetch" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_rpl_fetch \- fetches next event from replication stream mariadb_rpl_fetch \- fetches next event from replication stream
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
MARIADB_RPL_EVENT *mariadb_rpl_fetch(MARIADB_RPL *rpl, MARIADB_RPL_EVENT *event) MARIADB_RPL_EVENT *mariadb_rpl_fetch(MARIADB_RPL *rpl, MARIADB_RPL_EVENT *event)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Fetches one event from the replication stream Fetches one event from the replication stream
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]rpl\f[R] \- A replication handle which was initialized by \f[CR]rpl\f[R] \- A replication handle which was initialized by
\f[B]mariadb_rpl_init(3)\f[R] and connected by \f[B]mariadb_rpl_init(3)\f[R] and connected by
\f[B]mariadb_rpl_open(3)\f[R]. \f[B]mariadb_rpl_open(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]event\f[R] \- An event which was returned by a previous call to \f[CR]event\f[R] \- An event which was returned by a previous call to
\f[C]mariadb_rpl_fetch\f[R]. \f[CR]mariadb_rpl_fetch\f[R].
If this value is \f[C]NULL\f[R] the function will allocate new memory If this value is \f[CR]NULL\f[R] the function will allocate new memory
for the event, otherwise the passed event value will be overwritten. for the event, otherwise the passed event value will be overwritten.
.SS Return value .SS Return value
.PP
An event handle or NULL if EOF packet was received. An event handle or NULL if EOF packet was received.
.SS Notes .SS Notes
.PP
Event memory needs to be freed by calling Event memory needs to be freed by calling
\f[B]mariadb_rpl_free_event(3)\f[R]. \f[B]mariadb_rpl_free_event(3)\f[R].
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_rpl_free_event(3)\f[R] \f[B]mariadb_rpl_free_event(3)\f[R]
.SS History .SS History
.PP \f[CR]mariadb_rpl_fetch\f[R] was added in MariaDB Connector/C 3.1.0
\f[C]mariadb_rpl_fetch\f[R] was added in MariaDB Connector/C 3.1.0

37
man/mariadb_rpl_get_optionsv.3
View File

@@ -1,26 +1,23 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_rpl_get_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_rpl_get_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_rpl_get_optionsv \- get replication option value mariadb_rpl_get_optionsv \- get replication option value
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
int mariadb_rpl_get_optionsv(MARIADB_RPL *rpl, enum mariadb_rpl_option option, ...) int mariadb_rpl_get_optionsv(MARIADB_RPL *rpl, \f[B]enum\f[R] mariadb_rpl_option option, ...)
\f[R] .EE
.fi
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]rpl\f[R] \- a replication handle which was previously allocated by \f[CR]rpl\f[R] \- a replication handle which was previously allocated by
<mariadb_rpl_init> mariadb_rpl_init
.IP \[bu] 2 .IP \[bu] 2
\f[C]option\f[R] \- The option to be set, followed by one or more values \f[CR]option\f[R] \- The option to be set, followed by one or more
values
.PP .PP
.TS .TS
tab(@); tab(@);
@@ -61,14 +58,20 @@ uint32_t *
T}@T{ T}@T{
Flags Flags
T} T}
T{
MARIADB_RPL_SEMI_SYNC
T}@T{
uint32_t *
T}@T{
Semi sync replication, 1= ON, 0= OFF.
(This option was added in version 3.3.6).
T}
.TE .TE
.SS Return value .SS Return value
.PP
Returns zero on success, non zero on error. Returns zero on success, non zero on error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_rpl_optionsv(3)\f[R] \f[B]mariadb_rpl_optionsv(3)\f[R]
.SS History .SS History
.PP \f[CR]mariadb_rpl_get_optionsv\f[R] was added in MariaDB Connector/C
\f[C]mariadb_rpl_get_optionsv\f[R] was added in MariaDB Connector/C
3.1.0 3.1.0

21
man/mariadb_rpl_open.3
View File

@@ -1,29 +1,22 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_rpl_open" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_rpl_open" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_rpl_open \- opens a replication stream mariadb_rpl_open \- opens a replication stream
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
int mariadb_rpl_open(MARIADB_RPL *rpl) int mariadb_rpl_open(MARIADB_RPL *rpl)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Opens a replication stream Opens a replication stream
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]rpl\f[R] \- A replication handle which was previously initialized \f[CR]rpl\f[R] \- A replication handle which was previously initialized
by \f[B]mariadb_rpl_init(3)\f[R]. by \f[B]mariadb_rpl_init(3)\f[R].
.SS Return value .SS Return value
.PP
Zero on success, nonzero on error. Zero on success, nonzero on error.
.SS History .SS History
.PP \f[CR]mariadb_rpl_open\f[R] was added in MariaDB Connector/C 3.1.0
\f[C]mariadb_rpl_open\f[R] was added in MariaDB Connector/C 3.1.0

59
man/mariadb_rpl_optionsv.3
View File

@@ -1,30 +1,27 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_rpl_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_rpl_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_rpl_optionsv \- sets replication options mariadb_rpl_optionsv \- sets replication options
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mariadb_rpl.h>\f[R]
#include <mariadb_rpl.h>
int mariadb_rpl_optionsv(MARIADB_RPL *rpl, enum mariadb_rpl_option option, ...) int mariadb_rpl_optionsv(MARIADB_RPL *rpl, \f[B]enum\f[R] mariadb_rpl_option option, ...)
\f[R] .EE
.fi
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]rpl\f[R] \- a replication handle which was previously allocated by \f[CR]rpl\f[R] \- a replication handle which was previously allocated by
<mariadb_rpl_init> mariadb_rpl_init
.IP \[bu] 2 .IP \[bu] 2
\f[C]option\f[R] \- The option to be set, followed by one or more values \f[CR]option\f[R] \- The option to be set, followed by one or more
values
.PP .PP
.TS .TS
tab(@); tab(@);
l l l. lw(23.3n) lw(23.3n) lw(23.3n).
T{ T{
Option Option
T}@T{ T}@T{
@@ -61,9 +58,36 @@ uint32_t
T}@T{ T}@T{
Flags Flags
T} T}
T{
MARIADB_RPL_VERIFY_CHECKSUM
T}@T{
uint32_t
T}@T{
Verify CRC32 checksum (option added in version 3.3.5)
T}
T{
MARIADB_RPL_PORT
T}@T{
uint32_t
T}@T{
Port of replication client (option added in version 3.3.5)
T}
T{
MARIADB_RPL_HOST
T}@T{
char *
T}@T{
Name of replication client (option added in version 3.3.5)
T}
T{
MARIADB_RPL_SEMI_SYNC
T}@T{
uint_32_t
T}@T{
Enable or disable semi sync replication (option added in version 3.3.6).
T}
.TE .TE
.SS Return value .SS Return value
.PP
Returns zero on success, non zero on error. Returns zero on success, non zero on error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
@@ -71,5 +95,4 @@ Returns zero on success, non zero on error.
.IP \[bu] 2 .IP \[bu] 2
\f[B]mariadb_rpl_open(3)\f[R] \f[B]mariadb_rpl_open(3)\f[R]
.SS History .SS History
.PP \f[CR]mariadb_rpl_optionsv\f[R] was added in MariaDB Connector/C 3.1.0
\f[C]mariadb_rpl_optionsv\f[R] was added in MariaDB Connector/C 3.1.0

24
man/mariadb_stmt_execute_direct.3
View File

@@ -1,37 +1,31 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_stmt_execute_direct" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_stmt_execute_direct" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_stmt_execute_direct \- prepares and executes a prepared mariadb_stmt_execute_direct \- prepares and executes a prepared
statement statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C]
#include <mysql.h> #include <mysql.h>
int mariadb_stmt_execute_direct(MYSQL_STMT * stmt, int mariadb_stmt_execute_direct(MYSQL_STMT * stmt,
const char *query, const char *query,
size_t length); size_t length);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Prepares and executes a statement which was previously allocated by Prepares and executes a statement which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R], using the current values of the parameter \f[B]mysql_stmt_init(3)\f[R], using the current values of the parameter
variables if any parameters exist in the statement. variables if any parameters exist in the statement.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- A statement handle, which was previously allocated by \f[CR]stmt\f[R] \- A statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]query\f[R] SQL statement \f[CR]query\f[R] SQL statement
.IP \[bu] 2 .IP \[bu] 2
\f[C]length\f[R] Length of SQL statement \f[CR]length\f[R] Length of SQL statement
.SS Return value .SS Return value
.PP
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
@@ -40,12 +34,11 @@ execution it is mandatory to set the number of parameters via the
\f[B]mysql_stmt_attr_set(3)\f[R] function. \f[B]mysql_stmt_attr_set(3)\f[R] function.
.IP \[bu] 2 .IP \[bu] 2
If the SQL statement is a zero\-terminated string, you can also pass If the SQL statement is a zero\-terminated string, you can also pass
\f[C]\-1\f[R] as length. \f[CR]\-1\f[R] as length.
.IP \[bu] 2 .IP \[bu] 2
The statement handle is intended for one\-time execution. The statement handle is intended for one\-time execution.
Reusing the statement handle might lead to unexpected behavior. Reusing the statement handle might lead to unexpected behavior.
.SS History .SS History
.PP
This function was added in Connector/C 3.0 and requires MariaDB 10.2 or This function was added in Connector/C 3.0 and requires MariaDB 10.2 or
later versions. later versions.
.SS See Also .SS See Also
@@ -54,7 +47,6 @@ later versions.
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_stmt_bind_param(3)\f[R] \f[B]mysql_stmt_bind_param(3)\f[R]
.SS Example .SS Example
.PP
\[ga]\[ga]\[ga]C static int execute_direct_example(MYSQL \f[I]mysql) { \[ga]\[ga]\[ga]C static int execute_direct_example(MYSQL \f[I]mysql) {
MYSQL_STMT \f[R]stmt= mysql_stmt_init(mysql); MYSQL_BIND bind[2]; int MYSQL_STMT \f[R]stmt= mysql_stmt_init(mysql); MYSQL_BIND bind[2]; int
intval= 1; int param_count= 2; char *strval= intval= 1; int param_count= 2; char *strval=

20
man/mariadb_stmt_fetch_fields.3
View File

@@ -1,36 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mariadb_stmt_fetch_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mariadb_stmt_fetch_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mariadb_stmt_fetch_fields \- Returns an array of fields containing the mariadb_stmt_fetch_fields \- Returns an array of fields containing the
column definitions ## Synopsis column definitions ## Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD *mariadb_stmt_fetch_fields(MYSQL_STMT * stmt); MYSQL_FIELD *mariadb_stmt_fetch_fields(MYSQL_STMT * stmt);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns an array of fields. Returns an array of fields.
Each field contains the definition for a column of the result set. Each field contains the definition for a column of the result set.
If the statement doesn\[cq]t have a result set a NULL pointer will be If the statement doesn\[cq]t have a result set a NULL pointer will be
returned. returned.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- A statement handle, which was previously allocated by \f[CR]stmt\f[R] \- A statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.SS Notes .SS Notes
.PP
The number of fields can be obtained by The number of fields can be obtained by
\f[B]mysql_stmt_field_count(3)\f[R] \f[B]mysql_stmt_field_count(3)\f[R]
.SS History .SS History
.PP
This function was added in MariaDB Connector/C 3.1.0 This function was added in MariaDB Connector/C 3.1.0
.SS See Also .SS See Also
.PP
*\f[B]mysql_stmt_field_count(3)\f[R] *\f[B]mysql_stmt_field_count(3)\f[R]

29
man/mysql_affected_rows.3
View File

@@ -1,45 +1,38 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_affected_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_affected_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_affected_rows \- returns the number of rows affected by the last mysql_affected_rows \- returns the number of rows affected by the last
operation operation
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_ulonglong mysql_affected_rows(MYSQL * mysql); my_ulonglong mysql_affected_rows(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the number of affected rows by the last operation associated Returns the number of affected rows by the last operation associated
with mysql, if the operation was an \[lq]upsert\[rq] (\f[C]INSERT\f[R], with mysql, if the operation was an \[lq]upsert\[rq] (\f[CR]INSERT\f[R],
\f[C]UPDATE\f[R], \f[C]DELETE\f[R] or \f[C]REPLACE\f[R]) statement, or \f[CR]UPDATE\f[R], \f[CR]DELETE\f[R] or \f[CR]REPLACE\f[R]) statement,
\-1 if the last operation failed. or \-1 if the last operation failed.
.SS Parameters: .SS Parameters:
.PP \f[CR]mysql\f[R] is a connection identifier, which was previously
\f[C]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes: .SS Notes:
.IP \[bu] 2 .IP \[bu] 2
When using \f[C]UPDATE\f[R], MariaDB will not update columns where the When using \f[CR]UPDATE\f[R], MariaDB will not update columns where the
new value is the same as the old value. new value is the same as the old value.
This creates the possibility that mysql_affected_rows may not actually This creates the possibility that mysql_affected_rows may not actually
equal the number of rows matched, only the number of rows that were equal the number of rows matched, only the number of rows that were
literally affected by the query. literally affected by the query.
.IP \[bu] 2 .IP \[bu] 2
The \f[C]REPLACE\f[R] statement first deletes the record with the same The \f[CR]REPLACE\f[R] statement first deletes the record with the same
primary key and then inserts the new record. primary key and then inserts the new record.
This function returns the number of deleted records in addition to the This function returns the number of deleted records in addition to the
number of inserted records. number of inserted records.
.SH Return value .SH Return value
.PP
Returns the number of affected rows or \-1 on error. Returns the number of affected rows or \-1 on error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

63
man/mysql_autocommit.3
View File

@@ -1,35 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_autocommit" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_autocommit" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_autocommit \- Toggles autocommit mode mysql_autocommit \- Toggles autocommit mode
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_autocommit(MYSQL * mysql, my_bool auto_mode); my_bool mysql_autocommit(MYSQL * mysql, my_bool auto_mode);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Toggles autocommit mode on or off for the current database connection. Toggles autocommit mode on or off for the current database connection.
Autocommit mode will be set if mode=1 or unset if mode=0. Autocommit mode will be set if mode=1 or unset if mode=0.
.SS Parameters: .SS Parameters:
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]auto_mode\f[R] \- whether to turn autocommit on or not. \f[CR]auto_mode\f[R] \- whether to turn autocommit on or not.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Autocommit mode only affects operations on transactional table types. Autocommit mode only affects operations on transactional table types.
To determine the current state of autocommit mode use the SQL command To determine the current state of autocommit mode use the SQL command
\f[C]SELECT \[at]\[at]autocommit\f[R] or check the server status (see \f[CR]SELECT \[at]\[at]autocommit\f[R] or check the server status (see
example below). example below).
.IP \[bu] 2 .IP \[bu] 2
Be aware: the [mysql_rollback()}(mysql_rollback() function will not work Be aware: the [mysql_rollback()}(mysql_rollback() function will not work
@@ -37,46 +32,42 @@ if autocommit mode is switched on.
.SS Examples .SS Examples
.SS SQL .SS SQL
.IP .IP
.nf .EX
\f[C] # Turn \f[B]off\f[R] autocommit
# Turn of autocmmit \f[B]SET\f[R] AUTOCOMMIT=0;
SET AUTOCOMMIT=0;
# Retrieve autocommit # Retrieve autocommit
SELECT \[at]\[at]autocommit; \f[B]SELECT\f[R] \[at]\[at]autocommit;
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
| \[at]\[at]autocommit | | \[at]\[at]autocommit |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
| 0 | | 0 |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
\f[R] .EE
.fi
.SS MariaDB Connector/C .SS MariaDB Connector/C
.IP .IP
.nf .EX
\f[C]
static int test_autocommit(MYSQL *mysql) static int test_autocommit(MYSQL *mysql)
{ {
int rc; int rc;
unsigned int server_status; unsigned int server_status;
/* Turn autocommit off */ \f[I]/* Turn autocommit off */\f[R]
rc= mysql_autocommit(mysql, 0); rc= mysql_autocommit(mysql, 0);
if (rc) \f[B]if\f[R] (rc)
return rc; /* Error */ \f[B]return\f[R] rc; \f[I]/* Error */\f[R]
/* If autocommit = 0 succeeded, the last OK packet updated the server status */ \f[I]/* If autocommit = 0 succeeded, the last OK packet updated the server status */\f[R]
rc= mariadb_get_infov(mysql, MARIADB_CONNECTION_SERVER_STATUS, &server_status); rc= mariadb_get_infov(mysql, MARIADB_CONNECTION_SERVER_STATUS, &server_status);
if (rc) \f[B]if\f[R] (rc)
return rc; /* Error */ \f[B]return\f[R] rc; \f[I]/* Error */\f[R]
if (server_status & SERVER_STATUS_AUTOCOMMIT) \f[B]if\f[R] (server_status & SERVER_STATUS_AUTOCOMMIT)
{ {
printf(\[dq]Error: autocommit is on\[rs]n\[dq]); printf(\[dq]Error: autocommit is on\[rs]n\[dq]);
return 1; \f[B]return\f[R] 1;
} }
printf(\[dq]OK: autocommit is off\[rs]n\[dq]); printf(\[dq]OK: autocommit is off\[rs]n\[dq]);
return 0; \f[B]return\f[R] 0;
} }
\f[R] .EE
.fi

28
man/mysql_change_user.3
View File

@@ -1,24 +1,19 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_change_user" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_change_user" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_change_user \- changes user and default database mysql_change_user \- changes user and default database
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_change_user(MYSQL * mysql, my_bool mysql_change_user(MYSQL * mysql,
const char * user, const char * user,
const char * passwd, const char * passwd,
const char * db); const char * db);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Changes the user and default database of the current connection. Changes the user and default database of the current connection.
.PP .PP
In order to successfully change users a valid username and password In order to successfully change users a valid username and password
@@ -28,15 +23,15 @@ If for any reason authorization fails, the current user authentication
will remain. will remain.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]user\f[R] \- the user name for server authentication \f[CR]user\f[R] \- the user name for server authentication
.IP \[bu] 2 .IP \[bu] 2
\f[C]passwd\f[R] \- the password for server authentication \f[CR]passwd\f[R] \- the password for server authentication
.IP \[bu] 2 .IP \[bu] 2
\f[C]db\f[R] \- the default database. \f[CR]db\f[R] \- the default database.
If desired, the NULL value may be passed resulting in only changing the If desired, the NULL value may be passed resulting in only changing the
user and not selecting a database. user and not selecting a database.
To select a database in this case use the \f[B]mysql_select_db(3)\f[R] To select a database in this case use the \f[B]mysql_select_db(3)\f[R]
@@ -50,10 +45,9 @@ This reset includes performing a rollback on any active transactions,
closing all temporary tables, and unlocking all locked tables. closing all temporary tables, and unlocking all locked tables.
.IP \[bu] 2 .IP \[bu] 2
To prevent denial of service and brute\-force attacks the server will To prevent denial of service and brute\-force attacks the server will
block the connection if \f[C]mysql_change_user()\f[R] failed three times block the connection if \f[CR]mysql_change_user()\f[R] failed three
in a row times in a row
.SS Return value .SS Return value
.PP
Returns zero on success, nonzero if an error occurred. Returns zero on success, nonzero if an error occurred.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

17
man/mysql_close.3
View File

@@ -1,25 +1,20 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_close" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_close" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_close \- Closes a previously opened connection mysql_close \- Closes a previously opened connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_close(MYSQL *mysql); void mysql_close(MYSQL *mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Closes a previously opened connection and deallocates all memory. Closes a previously opened connection and deallocates all memory.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To reuse a connection handle after \f[C]mysql_close()\f[R] the handle To reuse a connection handle after \f[CR]mysql_close()\f[R] the handle
must be initialized again by \f[B]mysql_init(3)\f[R]. must be initialized again by \f[B]mysql_init(3)\f[R].
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mysql_commit.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_commit" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_commit" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_commit \- Commits the current transaction mysql_commit \- Commits the current transaction
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_commit(MYSQL * mysql); my_bool mysql_commit(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Commits the current transaction for the specified database connection. Commits the current transaction for the specified database connection.
Returns zero on success, nonzero if an error occurred. Returns zero on success, nonzero if an error occurred.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
Executing mysql_commit() will not affected the behaviour of autocommit. Executing mysql_commit() will not affected the behaviour of autocommit.
This means, any update or insert statements following mysql_commit() This means, any update or insert statements following mysql_commit()
will be rolled back when the connection gets closed. will be rolled back when the connection gets closed.

20
man/mysql_data_seek.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_data_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_data_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_data_seek \- seeks to an offset mysql_data_seek \- seeks to an offset
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_data_seek(MYSQL_RES * result, void mysql_data_seek(MYSQL_RES * result,
my_ulonglong offset); my_ulonglong offset);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
The mysql_data_seek() function seeks to an arbitrary function result The mysql_data_seek() function seeks to an arbitrary function result
pointer specified by the offset in the result set. pointer specified by the offset in the result set.
Returns zero on success, nonzero if an error occurred. Returns zero on success, nonzero if an error occurred.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
mysql_store_result(). mysql_store_result().
.IP \[bu] 2 .IP \[bu] 2
\f[C]offset\f[R] \- the field offset. \f[CR]offset\f[R] \- the field offset.
Must be between zero and the total number of rows minus one Must be between zero and the total number of rows minus one
(0..mysql_num_rows \- 1). (0..mysql_num_rows \- 1).
.SS Notes .SS Notes
.PP
This function can only be used with buffered result sets obtained from This function can only be used with buffered result sets obtained from
the use of the \f[B]mysql_store_result(3)\f[R] function. the use of the \f[B]mysql_store_result(3)\f[R] function.
.SS See also .SS See also

15
man/mysql_eof.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_eof" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_eof" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_eof \- determines if the last row of a result set has been read mysql_eof \- determines if the last row of a result set has been read
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_eof(MYSQL_RES *result); my_bool mysql_eof(MYSQL_RES *result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Determines if the last row of a result set has been read. Determines if the last row of a result set has been read.
.PP .PP
\f[B]Notes:\f[R] * This function is deprecated and will be removed. \f[B]Notes:\f[R] * This function is deprecated and will be removed.

21
man/mysql_errno.3
View File

@@ -1,34 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_errno" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_errno" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_errno \- returns the last error code for the most recent function mysql_errno \- returns the last error code for the most recent function
call call
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned int mysql_errno(MYSQL * mysql); unsigned int mysql_errno(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the last error code for the most recent function call that can Returns the last error code for the most recent function call that can
succeed or fail. succeed or fail.
Zero means no error occurred. Zero means no error occurred.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Client error codes are listed in \f[C]errmsg.h\f[R] header file, server Client error codes are listed in \f[CR]errmsg.h\f[R] header file, server
error codes are listed in \f[C]mysqld_error.h\f[R] header file of the error codes are listed in \f[CR]mysqld_error.h\f[R] header file of the
server source distribution. server source distribution.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

23
man/mysql_error.3
View File

@@ -1,39 +1,34 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_error" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_error" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_error \- returns the last error message for the most recent mysql_error \- returns the last error message for the most recent
function call function call
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_error(MYSQL * mysql); const char * mysql_error(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the last error message for the most recent function call that Returns the last error message for the most recent function call that
can succeed or fail. can succeed or fail.
An empty string means no error occurred. An empty string means no error occurred.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Client error codes are listed in \f[C]errmsg.h\f[R] header file, server Client error codes are listed in \f[CR]errmsg.h\f[R] header file, server
error codes are listed in \f[C]mysqld_error.h\f[R] header file of the error codes are listed in \f[CR]mysqld_error.h\f[R] header file of the
server source distribution. server source distribution.
.IP \[bu] 2 .IP \[bu] 2
Client error messages can be obtained by calling Client error messages can be obtained by calling
\f[B]mariadb_get_infov(3)\f[R] and passing the parameter \f[B]mariadb_get_infov(3)\f[R] and passing the parameter
\f[C]MARIADB_CLIENT_ERRORS\f[R] \f[CR]MARIADB_CLIENT_ERRORS\f[R]
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_errno(3)\f[R] \f[B]mysql_errno(3)\f[R]

20
man/mysql_fetch_field.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_fetch_field" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_fetch_field" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_fetch_field \- Returns the definition of one column of a result mysql_fetch_field \- Returns the definition of one column of a result
set set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD * mysql_fetch_field(MYSQL_RES * result); MYSQL_FIELD * mysql_fetch_field(MYSQL_RES * result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the definition of one column of a result set as a pointer to a Returns the definition of one column of a result set as a pointer to a
MYSQL_FIELD structure. MYSQL_FIELD structure.
Call this function repeatedly to retrieve information about all columns Call this function repeatedly to retrieve information about all columns
in the result set. in the result set.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
@@ -33,8 +28,7 @@ In case only information for a specific field is required the field can
be selected by using the \f[B]mysql_field_seek(3)\f[R] function or be selected by using the \f[B]mysql_field_seek(3)\f[R] function or
obtained by \f[B]mysql_fetch_field_direct(3)\f[R] function. obtained by \f[B]mysql_fetch_field_direct(3)\f[R] function.
.SS Return value .SS Return value
.PP a pointer of a \f[CR]MYSQL_FIELD\f[R] structure, or NULL if there are no
a pointer of a \f[C]MYSQL_FIELD\f[R] structure, or NULL if there are no
more fields. more fields.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

24
man/mysql_fetch_field_direct.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_fetch_field_direct" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_fetch_field_direct" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_fetch_field_direct \- Returns a pointer to a MYSQL_FIELD structure mysql_fetch_field_direct \- Returns a pointer to a MYSQL_FIELD structure
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD * mysql_fetch_field_direct(MYSQL_RES * res, MYSQL_FIELD * mysql_fetch_field_direct(MYSQL_RES * res,
unsigned int fieldnr); unsigned int fieldnr);
\f[R] .EE
.fi
.SS Description .SS Description
.PP Returns a pointer to a \f[CR]MYSQL_FIELD\f[R] structure which contains
Returns a pointer to a \f[C]MYSQL_FIELD\f[R] structure which contains
field information from the specified result set. field information from the specified result set.
### Parameter * \f[C]res\f[R] \- a result set identifier returned by ### Parameter * \f[CR]res\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
* \f[C]fieldnr\f[R] \- the field number. * \f[CR]fieldnr\f[R] \- the field number.
This value must be within the range from 0 to number of fields \- 1 ### This value must be within the range from 0 to number of fields \- 1 ###
Notes * The total number of fields can be obtained by Notes * The total number of fields can be obtained by
mysql_field_count() mysql_field_count()
.SS Return value .SS Return value
.PP Pointer to a \f[CR]MYSQL_FIELD\f[R] structure or \f[CR]NULL\f[R] if an
Pointer to a \f[C]MYSQL_FIELD\f[R] structure or \f[C]NULL\f[R] if an
invalid field number was specified invalid field number was specified
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

21
man/mysql_fetch_fields.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_fetch_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_fetch_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_fetch_fields \- returns an array of fields mysql_fetch_fields \- returns an array of fields
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD * mysql_fetch_fields(MYSQL_RES * res); MYSQL_FIELD * mysql_fetch_fields(MYSQL_RES * res);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
This function serves an identical purpose to the This function serves an identical purpose to the
\f[B]mysql_fetch_field(3)\f[R] function with the single difference that \f[B]mysql_fetch_field(3)\f[R] function with the single difference that
instead of returning one field at a time for each field, the fields are instead of returning one field at a time for each field, the fields are
@@ -23,15 +18,13 @@ returned as an array.
Each field contains the definition for a column of the result set. Each field contains the definition for a column of the result set.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]res\f[R] \- a result set identifier returned by \f[CR]res\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Notes .SS Notes
.PP
The total number of fields can be obtained by The total number of fields can be obtained by
\f[B]mysql_field_count(3)\f[R]. \f[B]mysql_field_count(3)\f[R].
.SS Return value .SS Return value
.PP an array of type \f[CR]MYSQL_FIELD\f[R].
an array of type \f[C]MYSQL_FIELD\f[R].
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_fetch_field(3)\f[R] \f[B]mysql_fetch_field(3)\f[R]

30
man/mysql_fetch_lengths.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_fetch_lengths" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_fetch_lengths" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_fetch_lengths \- returns an array of length values for the current mysql_fetch_lengths \- returns an array of length values for the current
row row
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned long * mysql_fetch_lengths(MYSQL_RES * result); unsigned long * mysql_fetch_lengths(MYSQL_RES * result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP The \f[CR]mysql_fetch_lengths()\f[R] function returns an array
The \f[C]mysql_fetch_lengths()\f[R] function returns an array containing containing the lengths of every column of the current row within the
the lengths of every column of the current row within the result set result set (not including terminating zero character) or \f[CR]NULL\f[R]
(not including terminating zero character) or \f[C]NULL\f[R] if an error if an error occurred.
occurred.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
### Notes \f[C]mysql_fetch_lengths()\f[R] is valid only for the current ### Notes \f[CR]mysql_fetch_lengths()\f[R] is valid only for the current
row of the result set. row of the result set.
It returns \f[C]NULL\f[R] if you call it before calling It returns \f[CR]NULL\f[R] if you call it before calling
\f[B]mysql_fetch_row(3)\f[R] or after retrieving all rows in the result. \f[B]mysql_fetch_row(3)\f[R] or after retrieving all rows in the result.
.SS Return value .SS Return value
.PP
An array of unsigned long values . An array of unsigned long values .
The size of the array can be determined by the number of fields in The size of the array can be determined by the number of fields in
current result set. current result set.

30
man/mysql_fetch_row.3
View File

@@ -1,42 +1,36 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_fetch_row" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_fetch_row" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_fetch_row \- fetches row of data from result set mysql_fetch_row \- fetches row of data from result set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_ROW mysql_fetch_row(MYSQL_RES * result); MYSQL_ROW mysql_fetch_row(MYSQL_RES * result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Fetches one row of data from the result set and returns it as an array Fetches one row of data from the result set and returns it as an array
of char pointers (\f[C]MYSQL_ROW\f[R]), where each column is stored in of char pointers (\f[CR]MYSQL_ROW\f[R]), where each column is stored in
an offset starting from 0 (zero). an offset starting from 0 (zero).
Each subsequent call to this function will return the next row within Each subsequent call to this function will return the next row within
the result set, or NULL if there are no more rows. the result set, or NULL if there are no more rows.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
If a column contains a \f[C]NULL\f[R] value the corresponding char If a column contains a \f[CR]NULL\f[R] value the corresponding char
pointer will be set to \f[C]NULL\f[R]. pointer will be set to \f[CR]NULL\f[R].
.IP \[bu] 2 .IP \[bu] 2
Memory associated to \f[C]MYSQL_ROW\f[R] will be freed when calling Memory associated to \f[CR]MYSQL_ROW\f[R] will be freed when calling
\f[B]mysql_free_result(3)\f[R] function. \f[B]mysql_free_result(3)\f[R] function.
.SS Return value .SS Return value
.PP A \f[CR]MYSQL_ROW\f[R] structure (array of character pointers)
A \f[C]MYSQL_ROW\f[R] structure (array of character pointers)
representing the data of the current row. representing the data of the current row.
If there are no more rows available \f[C]NULL\f[R]will be returned. If there are no more rows available \f[CR]NULL\f[R]will be returned.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_use_result(3)\f[R] \f[B]mysql_use_result(3)\f[R]

25
man/mysql_field_count.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_field_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_field_count" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_field_count \- returns the number of columns for the most recent mysql_field_count \- returns the number of columns for the most recent
statement statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned int mysql_field_count(MYSQL * mysql); unsigned int mysql_field_count(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the number of columns for the most recent statement on the Returns the number of columns for the most recent statement on the
connection represented by the link parameter as an unsigned integer. connection represented by the link parameter as an unsigned integer.
This function can be useful when using the This function can be useful when using the
@@ -25,17 +20,15 @@ should have produced a non\-empty result set or not without knowing the
nature of the query. nature of the query.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP The \f[CR]mysql_field_count()\f[R] function should be used to determine
The \f[C]mysql_field_count()\f[R] function should be used to determine
if there is a result set available. if there is a result set available.
.SS Return value: .SS Return value:
.PP The number of columns for the most recent statement.
The number of columns for the most recent statemet. The value is zero, if the statement didn\[cq]t produce a result set.
The value is zero, if the statemet didn\[cq]t produce a result set.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_store_result(3)\f[R] \f[B]mysql_store_result(3)\f[R]

22
man/mysql_field_seek.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_field_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_field_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_field_seek \- sets the field cursor to given offset mysql_field_seek \- sets the field cursor to given offset
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES * result, MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES * result,
MYSQL_FIELD_OFFSET offset); MYSQL_FIELD_OFFSET offset);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Sets the field cursor to the given offset. Sets the field cursor to the given offset.
The next call to \f[B]mysql_fetch_field(3)\f[R] will retrieve the field The next call to \f[B]mysql_fetch_field(3)\f[R] will retrieve the field
definition of the column associated with that offset. definition of the column associated with that offset.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]offset\f[R] \- the field number. \f[CR]offset\f[R] \- the field number.
This number must be in the range from This number must be in the range from
\f[C]0\f[R]..\f[C]number of fields \- 1\f[R]. \f[CR]0\f[R]..\f[CR]number of fields \- 1\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The number of fields can be obtained from \f[B]mysql_field_count(3)\f[R] The number of fields can be obtained from \f[B]mysql_field_count(3)\f[R]
@@ -36,7 +31,6 @@ The number of fields can be obtained from \f[B]mysql_field_count(3)\f[R]
To move the field cursor to the first field offset parameter should be To move the field cursor to the first field offset parameter should be
zero. zero.
.SS Return value .SS Return value
.PP
Returns the previous value of the field cursor Returns the previous value of the field cursor
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mysql_field_tell.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_field_tell" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_field_tell" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_field_tell \- Returns offset of the field cursor mysql_field_tell \- Returns offset of the field cursor
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES * result); MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES * result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Return the offset of the field cursor used for the last Return the offset of the field cursor used for the last
\f[B]mysql_fetch_field(3)\f[R] call. \f[B]mysql_fetch_field(3)\f[R] call.
This value can be used as a parameter for the function This value can be used as a parameter for the function
\f[B]mysql_field_seek(3)\f[R]. \f[B]mysql_field_seek(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Return value .SS Return value
.PP
Returns the current offset of the field cursor Returns the current offset of the field cursor
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

17
man/mysql_free_result.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_free_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_free_result" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_free_result \- Frees result set mysql_free_result \- Frees result set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_free_result(MYSQL_RES * result); void mysql_free_result(MYSQL_RES * result);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Frees the memory associated with a result set. Frees the memory associated with a result set.
Returns void. Returns void.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2

21
man/mysql_get_character_set_info.3
View File

@@ -1,32 +1,27 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_character_set_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_character_set_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_character_set_info \- returns character set information mysql_get_character_set_info \- returns character set information
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_get_character_set_info(MYSQL * mysql, void mysql_get_character_set_info(MYSQL * mysql,
MY_CHARSET_INFO * charset); MY_CHARSET_INFO * charset);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns information about the current default character set for the Returns information about the current default character set for the
specified connection. specified connection.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]charset\f[R] \- a pointer to a \f[C]MY_CHARSET_INFO\f[R] structure, \f[CR]charset\f[R] \- a pointer to a \f[CR]MY_CHARSET_INFO\f[R]
in which the information will be copied. structure, in which the information will be copied.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
A complete list of supported character sets in the client library is A complete list of supported character sets in the client library is

16
man/mysql_get_client_info.3
View File

@@ -1,25 +1,19 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_client_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_client_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_client_info \- returns client library version as string mysql_get_client_info \- returns client library version as string
representation representation
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_get_client_info(void ); const char * mysql_get_client_info(void );
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns a string representing the client library version Returns a string representing the client library version
.SS Notes .SS Notes
.PP
To obtain the numeric value of the client library version use To obtain the numeric value of the client library version use
\f[B]mysql_get_client_version(3)\f[R]. \f[B]mysql_get_client_version(3)\f[R].
.SS See also .SS See also

16
man/mysql_get_client_version.3
View File

@@ -1,19 +1,14 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_client_version" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_client_version" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_client_version \- returns client version number mysql_get_client_version \- returns client version number
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C]
unsigned long mysql_get_client_version(void); unsigned long mysql_get_client_version(void);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns a number representing the client library version. Returns a number representing the client library version.
The value has the format XXYYZZ: major version * 10000 + minor version * The value has the format XXYYZZ: major version * 10000 + minor version *
100 + patch version. 100 + patch version.
@@ -23,9 +18,8 @@ the \f[B]mysql_get_client_info(3)\f[R] function.
client library is bundled with server package and returns the server client library is bundled with server package and returns the server
package version. package version.
To obtain the client version of the connector, please use the constant To obtain the client version of the connector, please use the constant
\f[C]MARIADB_PACKAGE_VERSION_ID\f[R] \f[CR]MARIADB_PACKAGE_VERSION_ID\f[R]
.SS Return value .SS Return value
.PP
A long integer representing the client version A long integer representing the client version
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

20
man/mysql_get_host_info.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_host_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_host_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_host_info \- Returns host information mysql_get_host_info \- Returns host information
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_get_host_info(MYSQL * mysql); const char * mysql_get_host_info(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Describes the type of connection in use for the connection, including Describes the type of connection in use for the connection, including
the server host name. the server host name.
Returns a string, or NULL if the connection is not valid. Returns a string, or NULL if the connection is not valid.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP Returns a string, describing host information or \f[CR]NULL\f[R] if the
Returns a string, describing host information or \f[C]NULL\f[R] if the
connection is not valid. connection is not valid.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

19
man/mysql_get_proto_info.3
View File

@@ -1,32 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_proto_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_proto_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_proto_info \- Returns protocol version number mysql_get_proto_info \- Returns protocol version number
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned int mysql_get_proto_info(MYSQL * mysql); unsigned int mysql_get_proto_info(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the protocol version number for the specified connection Returns the protocol version number for the specified connection
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
MariaDB Connector/C doesn\[cq]t support protocol version 9 and prior. MariaDB Connector/C doesn\[cq]t support protocol version 9 and prior.
.SS Return value .SS Return value
.PP
The protocol version number in use The protocol version number in use
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

25
man/mysql_get_server_info.3
View File

@@ -1,35 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_server_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_server_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_server_info \- Returns server version as string mysql_get_server_info \- Returns server version as string
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_get_server_info(MYSQL * mysql); const char * mysql_get_server_info(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP Returns the server version or \f[CR]NULL\f[R] on failure.
Returns the server version or \f[C]NULL\f[R] on failure.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
To obtain the numeric server version please use To obtain the numeric server version please use
\f[B]mysql_get_server_version(3)\f[R]. \f[B]mysql_get_server_version(3)\f[R].
.SS Return value .SS Return value
.PP Returns the server version as zero terminated string or
Returns the server version as zero terminated string or \f[C]NULL\f[R]on \f[CR]NULL\f[R]on failure.
failure.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_get_server_info(3)\f[R] \f[B]mysql_get_server_info(3)\f[R]

19
man/mysql_get_server_version.3
View File

@@ -1,33 +1,26 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_server_version" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_server_version" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_server_version \- returns numeric server version mysql_get_server_version \- returns numeric server version
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned long mysql_get_server_version(MYSQL * mysql); unsigned long mysql_get_server_version(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns an integer representing the version of connected server. Returns an integer representing the version of connected server.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
The form of the version number is VERSION_MAJOR * 10000 + VERSION_MINOR The form of the version number is VERSION_MAJOR * 10000 + VERSION_MINOR
* 100 + VERSION_PATCH. * 100 + VERSION_PATCH.
.SS Return value .SS Return value
.PP
The version number of the connected server The version number of the connected server
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mysql_get_socket.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_socket" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_socket" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_socket \- Returns the descriptor of the socket used for the mysql_get_socket \- Returns the descriptor of the socket used for the
current connection current connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_socket mysql_get_socket(MYSQL * mysql); my_socket mysql_get_socket(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the descriptor of the socket used for the current connection. Returns the descriptor of the socket used for the current connection.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP
A socket handle or INVALID_SOCKET (\-1) if the socket descriptor could A socket handle or INVALID_SOCKET (\-1) if the socket descriptor could
not be determined, e.g.\ if the connection doesn\[cq]t use a socket not be determined, e.g.\ if the connection doesn\[cq]t use a socket
connection. connection.

28
man/mysql_get_ssl_cipher.3
View File

@@ -1,31 +1,26 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_get_ssl_cipher" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_get_ssl_cipher" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_get_ssl_cipher \- returns the cipher suite in use mysql_get_ssl_cipher \- returns the cipher suite in use
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char *mysql_get_ssl_cipher(MYSQL *mysql) const char *mysql_get_ssl_cipher(MYSQL *mysql)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the name of the currently used cipher suite of the secure Returns the name of the currently used cipher suite of the secure
connection, or NULL for non TLS connections. connection, or NULL for non TLS connections.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
For using \f[C]mysql_get_ssl_cipher()\f[R] MariaDB Connector/C must be For using \f[CR]mysql_get_ssl_cipher()\f[R] MariaDB Connector/C must be
built with TLS/SSL support, otherwise the function will return NULL. built with TLS/SSL support, otherwise the function will return NULL.
.IP \[bu] 2 .IP \[bu] 2
\[ga]mysql_get_ssl_cipher()\[cq] can be used to determine if the client \[ga]mysql_get_ssl_cipher()\[cq] can be used to determine if the client
@@ -34,13 +29,12 @@ server connection is secure.
Depending on the TLS library in use (OpenSSL, GnuTLS or Windows Depending on the TLS library in use (OpenSSL, GnuTLS or Windows
Schannel) the name of the cipher suites may differ. Schannel) the name of the cipher suites may differ.
For example the cipher suite 0x002F For example the cipher suite 0x002F
(\f[C]TLS_RSA_WITH_AES_128_CBC_SHA\f[R]) has different names: (\f[CR]TLS_RSA_WITH_AES_128_CBC_SHA\f[R]) has different names:
\f[C]AES128\-SHA\f[R] for OpenSSL and Schannel and \f[CR]AES128\-SHA\f[R] for OpenSSL and Schannel and
\f[C]TLS_RSA_AES_128_CBC_SHA1\f[R] for GnuTLS. \f[CR]TLS_RSA_AES_128_CBC_SHA1\f[R] for GnuTLS.
.SS Return value .SS Return value
.PP
Returns a zero terminated string containing the cipher suite used for a Returns a zero terminated string containing the cipher suite used for a
secure connection, or \f[C]NULL\f[R] if connection doesn\[cq]t use secure connection, or \f[CR]NULL\f[R] if connection doesn\[cq]t use
TLS/SSL. TLS/SSL.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

24
man/mysql_hex_string.3
View File

@@ -1,39 +1,33 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_hex_string" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_hex_string" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_hex_string \- create a hexadecimal string mysql_hex_string \- create a hexadecimal string
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned long mysql_hex_string(char * to, unsigned long mysql_hex_string(char * to,
const char * from, const char * from,
unsigned long len); unsigned long len);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
This function is used to create a hexadecimal string which can be used This function is used to create a hexadecimal string which can be used
in SQL statements. in SQL statements.
e.g.\ \f[C]INSERT INTO my_blob VALUES(X\[aq]A0E1CD\[aq])\f[R]. e.g.\ \f[CR]INSERT INTO my_blob VALUES(X\[aq]A0E1CD\[aq])\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]to\f[R] \- result buffer \f[CR]to\f[R] \- result buffer
.IP \[bu] 2 .IP \[bu] 2
\f[C]from\f[R] \- the string which will be encoded \f[CR]from\f[R] \- the string which will be encoded
.IP \[bu] 2 .IP \[bu] 2
\f[C]len\f[R] \- length of the string (from) \f[CR]len\f[R] \- length of the string (from)
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The size of the buffer for the encoded string must be 2 * length + 1. The size of the buffer for the encoded string must be 2 * length + 1.
.IP \[bu] 2 .IP \[bu] 2
The encoded string does not contain a leading X\[cq]. The encoded string does not contain a leading X\[cq].
.SS Return value .SS Return value
.PP
Returns the length of the encoded string without the trailing null Returns the length of the encoded string without the trailing null
character. character.
.SS See also .SS See also

35
man/mysql_info.3
View File

@@ -1,36 +1,29 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_info" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_info \- provides information about the last executed statement mysql_info \- provides information about the last executed statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_info(MYSQL * mysql); const char * mysql_info(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP The \f[CR]mysql_info()\f[R] function returns a string providing
The \f[C]mysql_info()\f[R] function returns a string providing
information about the last statement executed. information about the last statement executed.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
Statements which do not fall into one of the preceding formats are not Statements which do not fall into one of the preceding formats are not
supported (e.g.\ \f[C]SELECT\f[R]). supported (e.g.\ \f[CR]SELECT\f[R]).
In these situations mysql_info() will return an empty string. In these situations mysql_info() will return an empty string.
.SS Return value .SS Return value
.PP
Zero terminated information string. Zero terminated information string.
The information depends on statement type: The information depends on statement type:
.PP .PP
@@ -44,27 +37,27 @@ Example result string
T} T}
_ _
T{ T{
\f[C]INSERT INTO...SELECT...\f[R] \f[CR]INSERT INTO...SELECT...\f[R]
T}@T{ T}@T{
Records: 100 Duplicates: 0 Warnings: 0 Records: 100 Duplicates: 0 Warnings: 0
T} T}
T{ T{
\f[C]INSERT INTO...VALUES (...),(...),(...)\f[R] \f[CR]INSERT INTO...VALUES (...),(...),(...)\f[R]
T}@T{ T}@T{
Records: 3 Duplicates: 0 Warnings: 0 Records: 3 Duplicates: 0 Warnings: 0
T} T}
T{ T{
\f[C]LOAD DATA INFILE\f[R] \f[CR]LOAD DATA INFILE\f[R]
T}@T{ T}@T{
Records: 1 Deleted: 0 Skipped: 0 Warnings: 0 Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
T} T}
T{ T{
\f[C]ALTER TABLE ...\f[R] \f[CR]ALTER TABLE ...\f[R]
T}@T{ T}@T{
Records: 3 Duplicates: 0 Warnings: 0 Records: 3 Duplicates: 0 Warnings: 0
T} T}
T{ T{
\f[C]UPDATE ...\f[R] \f[CR]UPDATE ...\f[R]
T}@T{ T}@T{
Rows matched: 40 Changed: 40 Warnings: 0 Rows matched: 40 Changed: 40 Warnings: 0
T} T}

32
man/mysql_init.3
View File

@@ -1,37 +1,31 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_init" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_init" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP mysql_init \- Prepares and initializes a \f[CR]MYSQL\f[R] structure
mysql_init \- Prepares and initializes a \f[C]MYSQL\f[R] structure
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL *mysql_init(MYSQL *mysql); MYSQL *mysql_init(MYSQL *mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP Prepares and initializes a \f[CR]MYSQL\f[R] structure to be used with
Prepares and initializes a \f[C]MYSQL\f[R] structure to be used with
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
If an address of a \f[C]MYSQL\f[R] structure was passed as parameter, If an address of a \f[CR]MYSQL\f[R] structure was passed as parameter,
the structure will be initialized, if \f[C]NULL\f[R] was passed, a new the structure will be initialized, if \f[CR]NULL\f[R] was passed, a new
structure will be allocated and initialized. structure will be allocated and initialized.
.PP .PP
\f[B]Notes:\f[R] * If parameter \f[C]mysql\f[R] is not \f[C]NULL\f[R] \f[B]Notes:\f[R] * If parameter \f[CR]mysql\f[R] is not \f[CR]NULL\f[R]
\f[B]mysql_close(3)\f[R] API function will not release the memory * Any \f[B]mysql_close(3)\f[R] API function will not release the memory * Any
subsequent calls to any function (except \f[B]mysql_optionsv(3)\f[R] subsequent calls to any function (except \f[B]mysql_optionsv(3)\f[R]
will fail until \f[B]mysql_real_connect(3)\f[R] was called. will fail until \f[B]mysql_real_connect(3)\f[R] was called.
* Memory allocated by \f[C]mysql_init()\f[R] must be freed with * Memory allocated by \f[CR]mysql_init()\f[R] must be freed with
\f[B]mysql_close(3)\f[R]. \f[B]mysql_close(3)\f[R].
.SS Return value .SS Return value
.PP The \f[CR]mysql_init()\f[R] function returns an address of a
The \f[C]mysql_init()\f[R] function returns an address of a \f[CR]MYSQL\f[R] structure, or NULL in case of memory allcation error.
\f[C]MYSQL\f[R] structure, or NULL in case of memory allcation error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_close(3)\f[R] \f[B]mysql_close(3)\f[R]

19
man/mysql_insert_id.3
View File

@@ -1,30 +1,23 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_insert_id" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_insert_id" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_insert_id \- returns the auto generated ID used in last statement mysql_insert_id \- returns the auto generated ID used in last statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_ulonglong mysql_insert_id(MYSQL * mysql); my_ulonglong mysql_insert_id(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the auto generated ID generated by a SQL statement (usually Returns the auto generated ID generated by a SQL statement (usually
INSERT) on a table for a column defined with AUTO_INCREMENT attribute. INSERT) on a table for a column defined with AUTO_INCREMENT attribute.
.SS Parameters: .SS Parameters:
.PP \f[CR]mysql\f[R] is a connection identifier, which was previously
\f[C]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SH Return value .SH Return value
.PP
Returns the value of the modified column with AUTO_INCREMENT attribute. Returns the value of the modified column with AUTO_INCREMENT attribute.
If the table doesn\[cq]t contain an auto_increment column or no If the table doesn\[cq]t contain an auto_increment column or no
INSERT/UPDATE statement was executed, this function will return zero. INSERT/UPDATE statement was executed, this function will return zero.

24
man/mysql_kill.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_kill" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_kill" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_kill \- Kills a connection mysql_kill \- Kills a connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_kill(MYSQL * mysql, int mysql_kill(MYSQL * mysql,
unsigned long); unsigned long);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
This function is used to ask the server to kill a MariaDB thread This function is used to ask the server to kill a MariaDB thread
specified by the processid parameter. specified by the processid parameter.
This value must be retrieved by [show\-processlist()](SHOW This value must be retrieved by [show\-processlist()](SHOW
@@ -25,22 +20,21 @@ If trying to kill the own connection \f[B]mysql_thread_id(3)\f[R] should
be used. be used.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
Returns 0 on success, otherwise nonzero. Returns 0 on success, otherwise nonzero.
.IP \[bu] 2 .IP \[bu] 2
\f[C]long\f[R] \- process id \f[CR]long\f[R] \- process id
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To stop a running command without killing the connection use To stop a running command without killing the connection use
\f[C]KILL QUERY\f[R]. \f[CR]KILL QUERY\f[R].
.IP \[bu] 2 .IP \[bu] 2
The \f[C]mysql_kill()\f[R] function only kills a connection, it The \f[CR]mysql_kill()\f[R] function only kills a connection, it
doesn\[cq]t free any memory \- this must be done explicitly by calling doesn\[cq]t free any memory \- this must be done explicitly by calling
\f[B]mysql_close(3)\f[R]. \f[B]mysql_close(3)\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success, non zero on error. Returns zero on success, non zero on error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

20
man/mysql_more_results.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_more_results" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_more_results" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_more_results \- indicates if one or more results are available mysql_more_results \- indicates if one or more results are available
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_more_results(MYSQL * mysql); my_bool mysql_more_results(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Indicates if one or more result sets are available from a previous call Indicates if one or more result sets are available from a previous call
to \f[B]mysql_real_query(3)\f[R]. to \f[B]mysql_real_query(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a connection identifier, which was previously \f[CR]mysql\f[R] \- a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
@@ -30,9 +25,8 @@ multi statement support.
.IP \[bu] 2 .IP \[bu] 2
Multiple result sets can be obtained either by calling a stored Multiple result sets can be obtained either by calling a stored
procedure or by executing concatenated statements, procedure or by executing concatenated statements,
e.g.\ \f[C]SELECT a FROM t1;SELECT b, c FROM t2\f[R]. e.g.\ \f[CR]SELECT a FROM t1;SELECT b, c FROM t2\f[R].
.SS Return value .SS Return value
.PP
Returns 1 if more result sets are available, otherwise zero. Returns 1 if more result sets are available, otherwise zero.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mysql_next_result.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_next_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_next_result" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_next_result \- prepares next result set mysql_next_result \- prepares next result set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_next_result(MYSQL * mysql); int mysql_next_result(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Prepares next result set from a previous call to Prepares next result set from a previous call to
\f[B]mysql_real_query(3)\f[R] which can be retrieved by \f[B]mysql_real_query(3)\f[R] which can be retrieved by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_store_result(3)\f[R] or
@@ -23,7 +18,7 @@ Prepares next result set from a previous call to
Returns zero on success, nonzero if an error occurred. Returns zero on success, nonzero if an error occurred.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
@@ -32,7 +27,6 @@ If a multi query contains errors the return value of
\f[B]mysql_errno(3)\f[R] and \f[B]mysql_error(3)\f[R] might change and \f[B]mysql_errno(3)\f[R] and \f[B]mysql_error(3)\f[R] might change and
there will be no result set available. there will be no result set available.
.SS Return value .SS Return value
.PP
Returns zero on success, non zero value on error. Returns zero on success, non zero value on error.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

18
man/mysql_num_fields.3
View File

@@ -1,28 +1,22 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_num_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_num_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_num_fields \- Returns number of fields in a result set mysql_num_fields \- Returns number of fields in a result set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned int mysql_num_fields(MYSQL_RES * ); unsigned int mysql_num_fields(MYSQL_RES * );
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns number of fields in a specified result set. Returns number of fields in a specified result set.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL RES *\f[R] \- A result set identifier returned by \f[CR]MYSQL RES *\f[R] \- A result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
.SS Return value .SS Return value
.PP
Returns number of fields. Returns number of fields.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

23
man/mysql_num_rows.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_num_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_num_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_num_rows \- Returns number of rows in a result set. mysql_num_rows \- Returns number of rows in a result set.
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_ulonglong mysql_num_rows(MYSQL_RES * ); my_ulonglong mysql_num_rows(MYSQL_RES * );
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns number of rows in a result set. Returns number of rows in a result set.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_RES\f[R] \- a result set identifier returned by \f[CR]MYSQL_RES\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R] or \f[B]mysql_use_result(3)\f[R].
### Notes The behaviour of \f[C]mysql_num_rows()\f[R] depends on whether ### Notes The behaviour of \f[CR]mysql_num_rows()\f[R] depends on
buffered or unbuffered result sets are being used. whether buffered or unbuffered result sets are being used.
For unbuffered result sets, \f[C]mysql_num_rows()\f[R] will not return For unbuffered result sets, \f[CR]mysql_num_rows()\f[R] will not return
the correct number of rows until all the rows in the result have been the correct number of rows until all the rows in the result have been
retrieved. retrieved.
.SS See also .SS See also

22
man/mysql_options.3
View File

@@ -1,37 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_options" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_options" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_options \- Used to set extra connect options and affect behavior mysql_options \- Used to set extra connect options and affect behavior
of a connection of a connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_options(MYSQL * mysql, int mysql_options(MYSQL * mysql,
enum mysql_option, \f[B]enum\f[R] mysql_option,
const void * arg); const void * arg);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Used to set extra connect options and affect behavior for a connection. Used to set extra connect options and affect behavior for a connection.
This function may be called multiple times to set several options. This function may be called multiple times to set several options.
\f[C]mysql_options()\f[R] should be called after \f[CR]mysql_options()\f[R] should be called after
\f[B]mysql_init(3)\f[R]. \f[B]mysql_init(3)\f[R].
.SS Notes .SS Notes
.PP
This function is deprecated, new implementations should use This function is deprecated, new implementations should use
\f[B]mysql_optionsv(3)\f[R] api function instead. \f[B]mysql_optionsv(3)\f[R] api function instead.
.SS Options .SS Options
.PP
An overview of the possible options can be found in the description of An overview of the possible options can be found in the description of
the \f[B]mysql_optionsv(3)\f[R] API function. the \f[B]mysql_optionsv(3)\f[R] API function.
.SS See Also .SS See Also
.PP
\f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_optionsv(3)\f[R] \f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_optionsv(3)\f[R]
*\f[B]mysql_real_connect(3)\f[R] *\f[B]mysql_real_connect(3)\f[R]

22
man/mysql_options4.3
View File

@@ -1,38 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_options4" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_options4" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_options4 \- Used to set extra connect options and affect behavior mysql_options4 \- Used to set extra connect options and affect behavior
of a connection of a connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_options4(MYSQL * mysql, int mysql_options4(MYSQL * mysql,
enum mysql_option, \f[B]enum\f[R] mysql_option,
const void * arg1, const void * arg1,
const void * arg2); const void * arg2);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Used to set extra connect options and affect behavior for a connection. Used to set extra connect options and affect behavior for a connection.
This function may be called multiple times to set several options. This function may be called multiple times to set several options.
\f[C]mysql_options()\f[R] should be called after \f[CR]mysql_options()\f[R] should be called after
\f[B]mysql_init(3)\f[R]. \f[B]mysql_init(3)\f[R].
.SS Notes .SS Notes
.PP
This function is deprecated, new implementations should use This function is deprecated, new implementations should use
\f[B]mysql_optionsv(3)\f[R] api function instead. \f[B]mysql_optionsv(3)\f[R] api function instead.
.SS Options .SS Options
.PP
An overview of the possible options can be found in the description of An overview of the possible options can be found in the description of
the \f[B]mysql_optionsv(3)\f[R] API function. the \f[B]mysql_optionsv(3)\f[R] API function.
.SS See Also .SS See Also
.PP
\f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_optionsv(3)\f[R] \f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_optionsv(3)\f[R]
*\f[B]mysql_real_connect(3)\f[R] *\f[B]mysql_real_connect(3)\f[R]

367
man/mysql_optionsv.3
View File

@@ -1,32 +1,26 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_optionsv \- Used to set extra connect options and affect behavior mysql_optionsv \- Used to set extra connect options and affect behavior
of a connection of a connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_optionsv(MYSQL * mysql, int mysql_optionsv(MYSQL * mysql,
enum mysql_option, \f[B]enum\f[R] mysql_option,
const void * arg, const void * arg,
...); ...);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Used to set extra connect options and affect behavior for a connection. Used to set extra connect options and affect behavior for a connection.
This function may be called multiple times to set several options. This function may be called multiple times to set several options.
\f[C]mysql_optionsv()\f[R] should be called after \f[CR]mysql_optionsv()\f[R] should be called after
\f[B]mysql_init(3)\f[R]. \f[B]mysql_init(3)\f[R].
.SS Options .SS Options
.PP
The following table shows which variable type to use for each option. The following table shows which variable type to use for each option.
.PP .PP
.TS .TS
@@ -39,63 +33,90 @@ Values
T} T}
_ _
T{ T{
\f[C]my_bool\f[R] \f[CR]my_bool\f[R]
T}@T{ T}@T{
\f[C]MYSQL_OPT_RECONNECT\f[R], \f[C]MYSQL_SECURE_AUTH\f[R], \f[CR]MYSQL_OPT_RECONNECT\f[R], \f[CR]MYSQL_SECURE_AUTH\f[R],
\f[C]MYSQL_REPORT_DATA_TRUNCATION\f[R], \f[C]MYSQL_OPT_SSL_ENFORCE\f[R], \f[CR]MYSQL_REPORT_DATA_TRUNCATION\f[R],
\f[C]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R] \f[CR]MYSQL_OPT_SSL_ENFORCE\f[R],
\f[CR]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R],
\f[CR]MARIADB_OPT_SKIP_READ_RESPONSE\f[R]
T} T}
T{ T{
\f[C]unsigned int\f[R] \f[CR]unsigned int\f[R]
T}@T{ T}@T{
\f[C]MYSQL_OPT_PORT\f[R], \f[C]MYSQL_OPT_LOCAL_INFILE\f[R], \f[CR]MYSQL_OPT_PORT\f[R], \f[CR]MYSQL_OPT_LOCAL_INFILE\f[R],
\f[C]MYSQL_OPT_CONNECT_TIMEOUT\f[R], \f[C]MYSQL_OPT_PROTOCOL\f[R], \f[CR]MYSQL_OPT_CONNECT_TIMEOUT\f[R], \f[CR]MYSQL_OPT_PROTOCOL\f[R],
\f[C]MYSQL_OPT_READ_TIMEOUT\f[R], \f[C]MYSQL_OPT_WRITE_TIMEOUT\f[R] \f[CR]MYSQL_OPT_READ_TIMEOUT\f[R], \f[CR]MYSQL_OPT_WRITE_TIMEOUT\f[R]
T} T}
T{ T{
\f[C]unsigned long\f[R] \f[CR]unsigned long\f[R]
T}@T{ T}@T{
\f[C]MYSQL_OPT_NET_BUFFER_LENGTH\f[R], \f[CR]MYSQL_OPT_NET_BUFFER_LENGTH\f[R],
\f[C]MYSQL_OPT_MAX_ALLOWED_PACKET\f[R] \f[CR]MYSQL_OPT_MAX_ALLOWED_PACKET\f[R]
T} T}
T{ T{
\f[C]const char *\f[R] \f[CR]const char *\f[R]
T}@T{ T}@T{
\f[C]MYSQL_INIT_COMMAND\f[R], \f[C]MARIADB_OPT_UNIXSOCKET\f[R], \f[CR]MYSQL_INIT_COMMAND\f[R], \f[CR]MARIADB_OPT_UNIXSOCKET\f[R],
\f[C]MARIADB_OPT_PASSWORD\f[R] , \f[C]MARIADB_OPT_USER\f[R], \f[CR]MARIADB_OPT_PASSWORD\f[R] , \f[CR]MARIADB_OPT_USER\f[R],
\f[C]MARIADB_OPT_HOST\f[R], \f[C]MARIADB_OPT_SCHEMA\f[R], \f[CR]MARIADB_OPT_HOST\f[R], \f[CR]MARIADB_OPT_SCHEMA\f[R],
\f[C]MYSQL_OPT_SSL_KEY\f[R], \f[C]MYSQL_OPT_SSL_CERT\f[R], \f[CR]MYSQL_OPT_SSL_KEY\f[R], \f[CR]MYSQL_OPT_SSL_CERT\f[R],
\f[C]MYSQL_OPT_SSL_CA\f[R], \f[C]MYSQL_OPT_SSL_CAPATH\f[R], \f[CR]MYSQL_OPT_SSL_CA\f[R], \f[CR]MYSQL_OPT_SSL_CAPATH\f[R],
\f[C]MYSQL_SET_CHARSET_NAME\f[R], \f[C]MYSQL_SET_CHARSET_DIR\f[R], \f[CR]MYSQL_SET_CHARSET_NAME\f[R], \f[CR]MYSQL_SET_CHARSET_DIR\f[R],
\f[C]MYSQL_OPT_SSL_CIPHER\f[R], \f[C]MYSQL_SHARED_MEMORY_BASE_NAME\f[R], \f[CR]MYSQL_OPT_SSL_CIPHER\f[R],
\f[C]MYSQL_PLUGIN_DIR\f[R], \f[C]MYSQL_DEFAULT_AUTH\f[R], \f[CR]MYSQL_SHARED_MEMORY_BASE_NAME\f[R], \f[CR]MYSQL_PLUGIN_DIR\f[R],
\f[C]MARIADB_OPT_SSL_FP\f[R], \f[C]MARIADB_OPT_SSL_FP_LIST\f[R], \f[CR]MYSQL_DEFAULT_AUTH\f[R], \f[CR]MARIADB_OPT_SSL_FP\f[R],
\f[C]MARIADB_OPT_TLS_PASSPHRASE\f[R], \f[C]MARIADB_OPT_TLS_VERSION\f[R], \f[CR]MARIADB_OPT_SSL_FP_LIST\f[R],
\f[C]MYSQL_OPT_BIND\f[R], \f[C]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R], \f[CR]MARIADB_OPT_TLS_PASSPHRASE\f[R],
\f[C]MYSQL_OPT_CONNECT_ATTR_ADD\f[R], \f[CR]MARIADB_OPT_TLS_VERSION\f[R], \f[CR]MYSQL_OPT_BIND\f[R],
\f[C]MARIADB_OPT_CONNECTION_HANDLER\f[R], \f[CR]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R],
\f[C]MYSQL_SERVER_PUBLIC_KEY\f[R], \f[C]MARIADB_OPT_RESTRICTED_AUTH\f[R] \f[CR]MYSQL_OPT_CONNECT_ATTR_ADD\f[R],
\f[CR]MARIADB_OPT_CONNECTION_HANDLER\f[R],
\f[CR]MYSQL_SERVER_PUBLIC_KEY\f[R],
\f[CR]MARIADB_OPT_RESTRICTED_AUTH\f[R]
T}
T{
\f[CR]const char*, unsigned int\f[R]
T}@T{
\f[CR]MARIADB_OPT_RPL_REGISTER_REPLICA\f[R]
T} T}
T{ T{
\- \-
T}@T{ T}@T{
\f[C]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] \f[CR]MYSQL_OPT_CONNECT_ATTR_RESET\f[R]
T} T}
T{ T{
void * void *
T}@T{ T}@T{
\f[C]MARIADB_OPT_PROXY_HEADER\f[R] \f[CR]MARIADB_OPT_PROXY_HEADER\f[R]
T} T}
.TE .TE
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_INIT_COMMAND\f[R] \f[CR]MYSQL_OPT_SSL_ENFORCE\f[R]
.PD 0
.P
.PD
Enable or disable TLS.
This option can be used to enable TLS without having to provide TLS
certificates, keys or CAs.
.PD 0
.P
.PD
\f[B]Note\f[R]: currenty this does not enforce TLS like the option name
would suggest.
If the server does not support TLS, the protocol will fall back to
unencrypted communication.
To enforce the use of TLS, use
\f[CR]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R] instead.
.IP \[bu] 2
\f[CR]MYSQL_INIT_COMMAND\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Command(s) which will be executed when connecting and reconnecting to Command(s) which will be executed when connecting and reconnecting to
the server. the server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_COMPRESS\f[R] \f[CR]MYSQL_OPT_COMPRESS\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -103,82 +124,89 @@ Use the compressed protocol for client server communication.
If the server doesn\[cq]t support compressed protocol, the default If the server doesn\[cq]t support compressed protocol, the default
protocol will be used. protocol will be used.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_CONNECT_TIMEOUT\f[R] \f[CR]MYSQL_OPT_CONNECT_TIMEOUT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Connect timeout in seconds. Connect timeout in seconds.
This value will be passed as an unsigned ##int## parameter. This value will be passed as an unsigned ##int## parameter.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_LOCAL_INFILE\f[R] \f[CR]MYSQL_OPT_LOCAL_INFILE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Enable or disable the use of \f[C]LOAD DATA LOCAL INFILE\f[R] Enable or disable the use of \f[CR]LOAD DATA LOCAL INFILE\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_NAMED_PIPE\f[R] \f[CR]MYSQL_OPT_NAMED_PIPE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
For Windows operating systems only: Use named pipes for client/server For Windows operating systems only: Use named pipes for client/server
communication. communication.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_PROGRESS_CALLBACK\f[R] \f[CR]MYSQL_PROGRESS_CALLBACK\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specifies a callback function which will be able to visualize the Specifies a callback function which will be able to visualize the
progress of certain long running statements progress of certain long running statements
(i.e.\ \f[C]LOAD DATA LOCAL INFILE\f[R] or \f[C]ALTER TABLE\f[R]). (i.e.\ \f[CR]LOAD DATA LOCAL INFILE\f[R] or \f[CR]ALTER TABLE\f[R]).
The callback function must be defined as followed: The callback function must be defined as followed:
.IP .IP
.nf .EX
\f[C]
static void report_progress(const MYSQL *mysql __attribute__((unused)), static void report_progress(const MYSQL *mysql __attribute__((unused)),
uint stage, uint max_stage, uint stage, uint max_stage,
double progress __attribute__((unused)), double progress __attribute__((unused)),
const char *proc_info __attribute__((unused)), const char *proc_info __attribute__((unused)),
uint proc_info_length __attribute__((unused))) uint proc_info_length __attribute__((unused)))
\f[R] .EE
.fi
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_PROTOCOL\f[R] \f[CR]MYSQL_OPT_PROTOCOL\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the type of client/server protocol. Specify the type of client/server protocol.
Possible values are: \f[C]MYSQL_PROTOCOL_TCP\f[R], Possible values are: \f[CR]MYSQL_PROTOCOL_TCP\f[R],
\f[C]MYSQL_PROTOCOL_SOCKET\f[R], \f[C]MYSQL_PROTOCOL_PIPE\f[R] and \f[CR]MYSQL_PROTOCOL_SOCKET\f[R], \f[CR]MYSQL_PROTOCOL_PIPE\f[R] and
\f[C]MYSQL_PROTOCOL_MEMORY\f[R]. \f[CR]MYSQL_PROTOCOL_MEMORY\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_RECONNECT\f[R] \f[CR]MYSQL_OPT_RECONNECT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Enable or disable automatic reconnect. Enable or disable automatic reconnect.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_READ_TIMEOUT\f[R] \f[CR]MYSQL_OPT_READ_TIMEOUT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specifies the timeout in seconds for reading packets from the server. Specifies the timeout in seconds for reading packets from the server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_WRITE_TIMEOUT\f[R] \f[CR]MYSQL_OPT_WRITE_TIMEOUT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specifies the timeout in seconds for sending packets to the server. Specifies the timeout in seconds for sending packets to the server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_READ_DEFAULT_FILE\f[R] \f[CR]MYSQL_READ_DEFAULT_FILE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Read options from named configuration file. Read options from the specified configuration file.
To read from default \f[C]my.cnf\f[R] configuration file, a NULL pointer If an empty string is passed, the default configuration files (such as
has to be passed with option MYSQL_READ_DEFAULT_GROUP. /etc/my.cnf, /etc/mysql/my.cnf) will be read.
\f[B]Note:\f[R] MariaDB Connector/C will not read the configuration by By default, configuration files are not processed unless this option is
default. specified.
If \f[C]MYSQL_READ_DEFAULT_FILE\f[R] is specified the following sections .IP \[bu] 2
\f[CR]MYSQL_READ_DEFAULT_GROUP\f[R] Read options from the specified
group within the default configuration file or the file specified by
MYSQL_READ_DEFAULT_FILE.
Passing an empty string will result in all sections being processed.
If no specific file is provided via MYSQL_READ_DEFAULT_FILE, all
available default configuration files will be considered.
.RS 2
.PP
\f[B]Note:\f[R] In addition to a specified group the following groups
will be always processed: will be always processed:
.IP \[bu] 2 .IP \[bu] 2
[client] [client]
@@ -186,34 +214,28 @@ will be always processed:
[client\-server] [client\-server]
.IP \[bu] 2 .IP \[bu] 2
[client\-mariadb] [client\-mariadb]
.RE
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_READ_DEFAULT_GROUP\f[R] \f[CR]MYSQL_REPORT_DATA_TRUNCATION\f[R]
.PD 0
.P
.PD
Read options from the named group from default configuration
file (config_files) or the file specified with MYSQL_READ_DEFAULT_FILE.
.IP \[bu] 2
\f[C]MYSQL_REPORT_DATA_TRUNCATION\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Enable or disable reporting data truncation errors for prepared Enable or disable reporting data truncation errors for prepared
statements. statements.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_BIND\f[R] \f[CR]MYSQL_OPT_BIND\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the network interface from which to connect to MariaDB Server. Specify the network interface from which to connect to MariaDB Server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_PLUGIN_DIR\f[R] \f[CR]MYSQL_PLUGIN_DIR\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the location of client plugins. Specify the location of client plugins.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_NONBLOCK\f[R] \f[CR]MYSQL_OPT_NONBLOCK\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -224,13 +246,29 @@ and the application is doing other processing.
Normally, applications will not have to change this, and it can be Normally, applications will not have to change this, and it can be
passed as zero to use the default value. passed as zero to use the default value.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_CONNECTION_HANDLER\f[R] \f[CR]MYSQL_OPT_NET_BUFFER_LENGTH\f[R]
.PD 0
.P
.PD
Initial network buffer size in bytes.
The default value is 16777216 (16MiB).
.IP \[bu] 2
\f[CR]MYSQL_OPT_MAX_ALLOWED_PACKET\f[R]
.PD 0
.P
.PD
Maximum allowed packet length.
The default value is 1073741824 (1GiB) on the client side.
If the limit is exceeded by a packet sent by the server, an error is
generated.
.IP \[bu] 2
\f[CR]MARIADB_OPT_CONNECTION_HANDLER\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the name of a connection handler plugin. Specify the name of a connection handler plugin.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_USERDATA\f[R] \f[CR]MARIADB_OPT_USERDATA\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -238,61 +276,131 @@ Bundle user data to the current connection, e.g.\ for use in connection
handler plugins. handler plugins.
This option requires 4 parameters: connection, option, key and value: This option requires 4 parameters: connection, option, key and value:
.IP .IP
.nf .EX
\f[C] mysql_optionsv(mysql, MARIADB_OPT_USERDATA, (void *)\[dq]my_key\[dq], (void *)value);
mysql_optionsv(mysql, MARIADB_OPT_USERDATA, (void *)\[dq]ssh_user\[dq], (void *)ssh_user); .EE
\f[R]
.fi
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_CONNECTION_READ_ONLY\f[R] \f[CR]MARIADB_OPT_CONNECTION_READ_ONLY\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
This option is used by connection handler plugins and indicates that the This option is used by connection handler plugins and indicates that the
current connection will be used for read operations only. current connection will be used for read operations only.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R] \f[CR]MYSQL_OPT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
If this option is set, the client indicates that it will be able to If this option is set, the client indicates that it will be able to
handle expired passwords by setting the handle expired passwords by setting the
\f[C]CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R] capability flag. \f[CR]CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R] capability flag.
If the password has expired and If the password has expired and
\f[C]CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R] is set, the server will \f[CR]CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS\f[R] is set, the server will
not return an error when connecting, but put the connection in sandbox not return an error when connecting, but put the connection in sandbox
mode, where all commands will return error 1820 mode, where all commands will return error 1820
(\f[C]ER_MUST_CHANGE_PASSWORD\f[R]) unless a new password was set. (\f[CR]ER_MUST_CHANGE_PASSWORD\f[R]) unless a new password was set.
This option was added in MariaDB Connector/C 3.0.4 This option was added in MariaDB Connector/C 3.0.4
.IP \[bu] 2
\f[CR]MARIADB_OPT_STATUS_CALLBACK\f[R]
.PD 0
.P
.PD
Specifies a callback function which will be called whenever the server
status changes or the server sent session_track information to the
client:
.IP
.EX
mysql_optionsv(mysql, MARIADB_OPT_STATUS_CALLBACK, function, data)
.EE
.PP
The callback function must be defined as follows:
.IP
.EX
void status_callback(void *data, \f[B]enum\f[R] enum_mariadb_status_info type, ..)
.EE
.PP
Parameters:
.IP
.EX
\- data Pointer passed with registration of callback function
(usually a connection handle)
\- type Information type STATUS_TYPE or SESSION_TRACK_TYPE
.EE
.PP
Variadic Parameters:
.IP
.EX
if (type == STATUS_TYPE):
\- server status (unsigned int)
if (type == SESSION_TRACK_TYPE)
\- enum enum_session_state_type track_type \- session track type
if (track_type == SESSION_TRACK_SYSTEM_VARIABLES)
\- MARIADB_CONST_STRING *key
\- MARIADB_CONST_STRING *value
else
\- MARIADB_CONST_STRING *value
.EE
.PP
\[ga] Note: Specifying a callback function overwrites the internal
session tracking function, so API functions
mysql_session_track_get_first()/next() can\[cq]t be used.
.PP
An example can be found in unittest/libmariadb/connection.c
(test_status_callback)
.PP
Addid in version 3.3.2
.IP \[bu] 2
\f[CR]MARIADB_OPT_SKIP_READ_RESPONSE\f[R]
.PD 0
.P
.PD
Don\[cq]t read response packets in binary protocol.
.PP
Added in version 3.1.13
.SS Replication/Binlog API options
.IP \[bu] 2
\f[CR]MARIADB_OPT_RPL_REGISTER_REPLICA\f[R]
.PD 0
.P
.PD
Specifies host name and port for Binlog/API.
When this option was set, rpl_open() will register replica with
server_id, host and port to the connected server.
This information can be retrieved by \f[CR]SHOW SLAVE STATUS\f[R]
command.
This option was added in version 3.3.1
.SS TLS/SSL and Security options .SS TLS/SSL and Security options
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_KEY\f[R] \f[CR]MYSQL_OPT_SSL_KEY\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the name of a key for a secure connection. Specify the name of a key for a secure connection.
If the key is protected with a passphrase, the passphrase needs to be If the key is protected with a passphrase, the passphrase needs to be
specified with \f[C]MARIADB_OPT_PASSPHRASE\f[R] option. specified with \f[CR]MARIADB_OPT_PASSPHRASE\f[R] option.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CERT\f[R] \f[CR]MYSQL_OPT_SSL_CERT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the name of a certificate for a secure connection. Specify the name of a certificate for a secure connection.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CA\f[R] \f[CR]MYSQL_OPT_SSL_CA\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the name of a file which contains one or more trusted CAs. Specify the name of a file which contains one or more trusted CAs.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CAPATH\f[R] \f[CR]MYSQL_OPT_SSL_CAPATH\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the path which contains trusted CAs. Specify the path which contains trusted CAs.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CIPHER\f[R] \f[CR]MYSQL_OPT_SSL_CIPHER\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -301,47 +409,51 @@ encryption.
Even if Connector/C supports TLSv1.3 protocol, it is not possible yet to Even if Connector/C supports TLSv1.3 protocol, it is not possible yet to
specify TLSv1.3 cipher suites. specify TLSv1.3 cipher suites.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CRL\f[R] \f[CR]MYSQL_OPT_SSL_CRL\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify a file with a certificate revocation list. Specify a file with a certificate revocation list.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_CRLPATH\f[R] \f[CR]MYSQL_OPT_SSL_CRLPATH\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify a directory with contains files with certificate revocation Specify a directory with contains files with certificate revocation
lists. lists.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_SSL_FP\f[R] \f[CR]MARIADB_OPT_SSL_FP\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify the SHA1 fingerprint of a server certificate for validation Specify the fingerprint hash of a server certificate for validation
during the TLS handshake. during the TLS handshake.
For versions prior to 3.4.0 the hash is a SHA1 hash, for versions 3.4.0
and newer SHA256,SHA384 or SHA512.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_SSL_FP\f[R] \f[CR]MARIADB_OPT_SSL_FP_LIST\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify a file which contains one or more SHA1 fingerprints of server Specify a file which contains one or more fingerprint hashes of server
certificates for validation during the TLS handshake. certificates for validation during the TLS handshake.
For versions prior to 3.4.0 the hash is a SHA1 hash, for versions 3.4.0
and newer SHA256,SHA384 or SHA512.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_SSL_PASPHRASE\f[R] \f[CR]MARIADB_OPT_SSL_PASPHRASE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Specify a passphrase for a passphrase protected client key. Specify a passphrase for a passphrase protected client key.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R] \f[CR]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Enable (or disable) the verification of the hostname against common name Enable (or disable) the verification of the host name against common
(CN) of the server\[cq]s host certificate. name (CN) of the server\[cq]s host certificate.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_SERVER_PUBLIC_KEY\f[R] \f[CR]MYSQL_SERVER_PUBLIC_KEY\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -351,13 +463,13 @@ The format of this file must be in PEM format.
This option is used by the caching_sha2_password plugin and was added in This option is used by the caching_sha2_password plugin and was added in
Connector/C 3.1.0 Connector/C 3.1.0
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_TLS_CIPHER_STRENGTH\f[R] \f[CR]MARIADB_OPT_TLS_CIPHER_STRENGTH\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
This option is not in use anymore. This option is not in use anymore.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MARIADB_OPT_RESTRICTED_AUTH\f[R] \f[CR]MARIADB_OPT_RESTRICTED_AUTH\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
@@ -367,54 +479,51 @@ If the database server asks for an authentication plugin not listed in
this option, MariaDB Connector/C will return an error. this option, MariaDB Connector/C will return an error.
This option was added in MariaDB Connector/C 3.3.0 This option was added in MariaDB Connector/C 3.3.0
.SS Proxy settings .SS Proxy settings
.PP
As per the proxy protocol specification, the connecting client can As per the proxy protocol specification, the connecting client can
prefix its first packet with a proxy protocol header. prefix its first packet with a proxy protocol header.
The server will parse the header and assume the client\[cq]s IP address The server will parse the header and assume the client\[cq]s IP address
is the one set in the proxy header. is the one set in the proxy header.
* \f[C]MARIADB_OPT_PROXY_HEADER\f[R] \- specifies the proxy header which * \f[CR]MARIADB_OPT_PROXY_HEADER\f[R] \- specifies the proxy header
will be prefixed to the first packet. which will be prefixed to the first packet.
Parameters are void * for the prefix buffer and size_t for length of the Parameters are void * for the prefix buffer and size_t for length of the
buffer: buffer:
.IP .IP
.nf .EX
\f[C]
const char *hdr=\[dq]PROXY TCP4 192.168.0.1 192.168.0.11 56324 443\[rs]r\[rs]n\[dq]; const char *hdr=\[dq]PROXY TCP4 192.168.0.1 192.168.0.11 56324 443\[rs]r\[rs]n\[dq];
mysql_optionsv(mysql, MARIADB_OPT_PROXY_HEADER, hdr, strlen(hdr)); mysql_optionsv(mysql, MARIADB_OPT_PROXY_HEADER, hdr, strlen(hdr));
\f[R] .EE
.fi
.SS Connection Attributes .SS Connection Attributes
.PP Connection attributes are stored in the \f[CR]session_connect_attrs\f[R]
Connection attributes are stored in the \f[C]session_connect_attrs\f[R] and \f[CR]session_account_connect_attrs\f[R]Performance Schema tables.
and \f[C]session_account_connect_attrs\f[R]Performance Schema tables.
By default, MariaDB Connector/C sends the following connection By default, MariaDB Connector/C sends the following connection
attributes to the server: * \f[C]_client_name\f[R]: always attributes to the server: * \f[CR]_client_name\f[R]: always
\[lq]libmariadb\[rq] * \f[C]_client_version\f[R]: version of MariaDB \[lq]libmariadb\[rq] * \f[CR]_client_version\f[R]: version of MariaDB
Connector/C * \f[C]_os\f[R]: operation system * _pid: process id * Connector/C * \f[CR]_os\f[R]: operation system * _pid: process id *
\f[C]_platform\f[R]: e.g.\ x86 or x64 * \f[C]_server_host\f[R]: the \f[CR]_platform\f[R]: e.g.\ x86 or x64 * \f[CR]_server_host\f[R]: the
hostname (as specified in mysql_real_connect). host name (as specified in mysql_real_connect).
This attribute was added in Connector/C 3.0.5 This attribute was added in Connector/C 3.0.5
.PP .PP
\f[B]Note:\f[R] If the Performance Schema is disabled, connection \f[B]Note:\f[R] If the Performance Schema is disabled, connection
attributes will not be stored on server. attributes will not be stored on server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R] \f[CR]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Deletes a connection attribute for the given key. Deletes a connection attribute for the given key.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_CONNECT_ATTR_ADD\f[R] \f[CR]MYSQL_OPT_CONNECT_ATTR_ADD\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Adds a key/value pair to connection attributes. Adds a key/value pair to connection attributes.
The total length of the stored connection attributes is limited to a
maximum of 65535 bytes.
.IP \[bu] 2 .IP \[bu] 2
\f[C]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] \f[CR]MYSQL_OPT_CONNECT_ATTR_RESET\f[R]
.PD 0 .PD 0
.P .P
.PD .PD
Clears the current list of connection attributes. Clears the current list of connection attributes.
.SS See Also .SS See Also
.PP
\f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_real_connect(3)\f[R] \f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_real_connect(3)\f[R]

23
man/mysql_ping.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_ping" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_ping" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_ping \- checks if the connection between client and server is mysql_ping \- checks if the connection between client and server is
working working
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_ping(MYSQL * mysql); int mysql_ping(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Checks whether the connection to the server is working. Checks whether the connection to the server is working.
If it has gone down, and global option reconnect is enabled an automatic If it has gone down, and global option reconnect is enabled an automatic
reconnection is attempted. reconnection is attempted.
@@ -26,17 +21,17 @@ to check whether the server has closed the connection and reconnect if
necessary. necessary.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
### Notes ### Notes
.IP \[bu] 2 .IP \[bu] 2
If a reconnect occurred the thread_id will change. If a reconnect occurred the thread_id will change.
Also resources bundled to the connection (prepared statements, locks, Also resources bundled to the connection (prepared statements, locks,
temporary tables, \&...) will be released. temporary tables, \&...)
will be released.
.SS Return value .SS Return value
.PP Returns zero on success, nonzero if an error occurred.
Returns zero on success, nonzero if an error occured.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_optionsv(3)\f[R] \f[B]mysql_optionsv(3)\f[R]

20
man/mysql_query.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_query" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_query" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_query \- executes a null terminated statement string mysql_query \- executes a null terminated statement string
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_query(MYSQL * mysql, int mysql_query(MYSQL * mysql,
const char * query); const char * query);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Performs a statement pointed to by the null terminate string query Performs a statement pointed to by the null terminate string query
against the database. against the database.
Contrary to \f[B]mysql_real_query(3)\f[R], mysql_query() is not binary Contrary to \f[B]mysql_real_query(3)\f[R], mysql_query() is not binary
safe. safe.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]query\f[R] \-a null terminated string containing the statement to \f[CR]query\f[R] \-a null terminated string containing the statement to
be performed. be performed.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
@@ -41,7 +36,6 @@ If your statement contains binary data you should use
To determine if a statement returned a result set use the function To determine if a statement returned a result set use the function
\f[B]mysql_field_count(3)\f[R]. \f[B]mysql_field_count(3)\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success, non zero on failure. Returns zero on success, non zero on failure.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

27
man/mysql_read_query_result.3
View File

@@ -1,37 +1,32 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_read_query_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_read_query_result" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_read_query_result \- waits for a server result or response package mysql_read_query_result \- waits for a server result or response package
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_read_query_result(MYSQL * mysql); my_bool mysql_read_query_result(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Waits for a server result set or response package from a previously Waits for a server result set or response package from a previously
executed \f[B]mysql_send_query(3)\f[R]. executed \f[B]mysql_send_query(3)\f[R].
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP
Zero on success, non zero on error. Zero on success, non zero on error.
.SS Example .SS Example
.PP
For an example how to use \[cq]mysql_send_query()\[ga] in an event For an example how to use \[cq]mysql_send_query()\[ga] in an event
driven model, please check Jan Kneschke\[cq]s Blog entry \[lq]Async driven model, please check Jan Kneschke\[cq]s Blog entry \c
MySQL Queries with .UR https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/
C\-API\[rq] (https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/). \[lq]Async MySQL Queries with C\-API\[rq]
.UE \c
\&.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_real_query(3)\f[R] \f[B]mysql_real_query(3)\f[R]

65
man/mysql_real_connect.3
View File

@@ -1,16 +1,13 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_real_connect" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_real_connect" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_real_connect \- establishes a connection to a MariaDB database mysql_real_connect \- establishes a connection to a MariaDB database
server server
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C]
MYSQL * mysql_real_connect(MYSQL *mysql, MYSQL * mysql_real_connect(MYSQL *mysql,
const char *host, const char *host,
const char *user, const char *user,
@@ -19,17 +16,15 @@ MYSQL * mysql_real_connect(MYSQL *mysql,
unsigned int port, unsigned int port,
const char *unix_socket, const char *unix_socket,
unsigned long flags); unsigned long flags);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Establishes a connection to a database server. Establishes a connection to a database server.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] \f[B]mysql_init(3)\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]host\f[R] \- can be either a host name or an IP address. \f[CR]host\f[R] \- can be either a host name or an IP address.
Passing the NULL value or the string \[lq]localhost\[rq] to this Passing the NULL value or the string \[lq]localhost\[rq] to this
parameter, the local host is assumed. parameter, the local host is assumed.
When possible, pipes will be used instead of the TCP/IP protocol. When possible, pipes will be used instead of the TCP/IP protocol.
@@ -37,24 +32,27 @@ Since version 3.3.0 it is also possible to provide a comma separated
list of hosts for simple fail over in case of one or more hosts are not list of hosts for simple fail over in case of one or more hosts are not
available. available.
.IP \[bu] 2 .IP \[bu] 2
\f[C]user\f[R] \- the user name. \f[CR]user\f[R] \- the user name.
If NULL or an empty string \[lq]\[rq] is specified, the current user
will be used.
.IP \[bu] 2 .IP \[bu] 2
\f[C]passwd\f[R] \- If provided or NULL, the server will attempt to \f[CR]passwd\f[R] \- If provided or NULL, the server will attempt to
authenticate the user against those user records which have no password authenticate the user against those user records which have no password
only. only.
This allows one username to be used with different permissions This allows one username to be used with different permissions
(depending on if a password as provided or not). (depending on if a password as provided or not).
.IP \[bu] 2 .IP \[bu] 2
\f[C]db\f[R] \- if provided will specify the default database to be used \f[CR]db\f[R] \- if provided will specify the default database to be
when performing queries. used when performing queries.
.IP \[bu] 2 .IP \[bu] 2
\f[C]port\f[R] \- specifies the port number to attempt to connect to the \f[CR]port\f[R] \- specifies the port number to attempt to connect to
server. the server.
.IP \[bu] 2 .IP \[bu] 2
\f[C]unix_socket\f[R] \- specifies the socket or named pipe that should \f[CR]unix_socket\f[R] \- specifies the socket or named pipe that should
be used. be used.
.IP \[bu] 2 .IP \[bu] 2
\f[C]flags\f[R] \- the flags allows various connection options to be set \f[CR]flags\f[R] \- the flags allows various connection options to be
set
.PD 0 .PD 0
.P .P
.PD .PD
@@ -69,56 +67,55 @@ Description
T} T}
_ _
T{ T{
\f[C]CLIENT_FOUND_ROWS\f[R] \f[CR]CLIENT_FOUND_ROWS\f[R]
T}@T{ T}@T{
Return the number of matched rows instead of number of changed rows. Return the number of matched rows instead of number of changed rows.
T} T}
T{ T{
\f[C]CLIENT_NO_SCHEMA\f[R] \f[CR]CLIENT_NO_SCHEMA\f[R]
T}@T{ T}@T{
Forbids the use of database.tablename.column syntax and forces the SQL Forbids the use of database.tablename.column syntax and forces the SQL
parser to generate an error. parser to generate an error.
T} T}
T{ T{
\f[C]CLIENT_COMPRESS\f[R] \f[CR]CLIENT_COMPRESS\f[R]
T}@T{ T}@T{
Use compression protocol Use compression protocol
T} T}
T{ T{
\f[C]CLIENT_IGNORE_SPACE\f[R] \f[CR]CLIENT_IGNORE_SPACE\f[R]
T}@T{ T}@T{
Allows spaces after function names. Allows spaces after function names.
All function names will become reserved words. All function names will become reserved words.
T} T}
T{ T{
\f[C]CLIENT_LOCAL_FILES\f[R] \f[CR]CLIENT_LOCAL_FILES\f[R]
T}@T{ T}@T{
Allows LOAD DATA LOCAL statements Allows LOAD DATA LOCAL statements
T} T}
T{ T{
\f[C]CLIENT_MULTI_STATEMENTS\f[R] \f[CR]CLIENT_MULTI_STATEMENTS\f[R]
T}@T{ T}@T{
Allows the client to send multiple statements in one command. Allows the client to send multiple statements in one command.
Statements will be divided by a semicolon. Statements will be divided by a semicolon.
T} T}
T{ T{
\f[C]CLIENT_MULTI_RESULTS\f[R] \f[CR]CLIENT_MULTI_RESULTS\f[R]
T}@T{ T}@T{
Indicates that the client is able to handle multiple result sets from Indicates that the client is able to handle multiple result sets from
stored procedures or multi statements. stored procedures or multi statements.
This option will be automatically set if CLIENT_MULTI_STATEMENTS is set. This option will be automatically set if CLIENT_MULTI_STATEMENTS is set.
T} T}
T{ T{
\f[C]CLIENT_REMEMBER_OPTIONS\f[R] \f[CR]CLIENT_REMEMBER_OPTIONS\f[R]
T}@T{ T}@T{
Rembers options passed to \f[B]mysql_optionsv(3)\f[R] if a connect Remembers options passed to \f[B]mysql_optionsv(3)\f[R] if a connect
attempt failed. attempt failed.
If MYSQL_OPTIONS_RECONNECT option was set to true, options will be saved If MYSQL_OPTIONS_RECONNECT option was set to true, options will be saved
and used for reconnection. and used for reconnection.
T} T}
.TE .TE
.SS Return value .SS Return value
.PP
returns a connection handle (same as passed for 1st parameter) or NULL returns a connection handle (same as passed for 1st parameter) or NULL
on error. on error.
On error, please check \f[B]mysql_errno(3)\f[R] and On error, please check \f[B]mysql_errno(3)\f[R] and
@@ -141,11 +138,11 @@ since version 3.3.0).
The following syntax is required: The following syntax is required:
.RS 2 .RS 2
.IP \[bu] 2 .IP \[bu] 2
hostname and port must be seperated by a colon (:) hostname and port must be separated by a colon (:)
.IP \[bu] 2 .IP \[bu] 2
IPv6 addresses must be enclosed within square brackets IPv6 addresses must be enclosed within square brackets
.IP \[bu] 2 .IP \[bu] 2
hostname:port pairs must be be seperated by a comma (,) hostname:port pairs must be be separated by a comma (,)
.IP \[bu] 2 .IP \[bu] 2
if only one host:port was specified, the host string needs to end with a if only one host:port was specified, the host string needs to end with a
comma. comma.
@@ -154,9 +151,9 @@ if no port was specified, the default port will be used.
.PP .PP
\f[B]Examples for failover host string:\f[R] \f[B]Examples for failover host string:\f[R]
.PP .PP
\f[C]host=[::1]:3306,192.168.0.1:3306,test.example.com\f[R] \f[CR]host=[::1]:3306,192.168.0.1:3306,test.example.com\f[R]
.PP .PP
\f[C]host=127.0.0.1:3306,\f[R] \f[CR]host=127.0.0.1:3306,\f[R]
.RE .RE
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

24
man/mysql_real_escape_string.3
View File

@@ -1,46 +1,40 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_real_escape_string" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_real_escape_string" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_real_escape_string \- escape string by taking into account mysql_real_escape_string \- escape string by taking into account
character set of connection character set of connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned long mysql_real_escape_string(MYSQL * mysql, unsigned long mysql_real_escape_string(MYSQL * mysql,
char * to, char * to,
const char * from, const char * from,
unsigned long); unsigned long);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
This function is used to create a legal SQL string that you can use in This function is used to create a legal SQL string that you can use in
an SQL statement. an SQL statement.
The given string is encoded to an escaped SQL string, taking into The given string is encoded to an escaped SQL string, taking into
account the current character set of the connection. account the current character set of the connection.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]to\f[R] \- buffer for the encoded string. \f[CR]to\f[R] \- buffer for the encoded string.
The size of this buffer must be length * 2 + 1 bytes: in worst case The size of this buffer must be length * 2 + 1 bytes: in worst case
every character of the from string needs to be escaped. every character of the from string needs to be escaped.
Additionally a trailing 0 character will be appended. Additionally a trailing 0 character will be appended.
.IP \[bu] 2 .IP \[bu] 2
\f[C]from\f[R] \- a string which will be encoded by \f[CR]from\f[R] \- a string which will be encoded by
mysql_real_escape_string(). mysql_real_escape_string().
.IP \[bu] 2 .IP \[bu] 2
\f[C]long\f[R] \- the length of the \f[C]from\f[R] string. \f[CR]long\f[R] \- the length of the \f[CR]from\f[R] string.
.SS Return value .SS Return value
.PP
Returns the length of the encoded (to) string. Returns the length of the encoded (to) string.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

22
man/mysql_real_query.3
View File

@@ -1,34 +1,29 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_real_query" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_real_query" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_real_query \- execute a statement (binary safe) mysql_real_query \- execute a statement (binary safe)
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_real_query(MYSQL * mysql, int mysql_real_query(MYSQL * mysql,
const char * query, const char * query,
unsigned long length); unsigned long length);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
mysql_real_query() is the binary safe function for performing a mysql_real_query() is the binary safe function for performing a
statement on the database server. statement on the database server.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]query\f[R] \- a string containing the statement to be performed. \f[CR]query\f[R] \- a string containing the statement to be performed.
.IP \[bu] 2 .IP \[bu] 2
\f[C]length\f[R] \- length of the string. \f[CR]length\f[R] \- length of the string.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Contrary to the \f[B]mysql_query(3)\f[R] function, mysql_real_query is Contrary to the \f[B]mysql_query(3)\f[R] function, mysql_real_query is
@@ -37,7 +32,6 @@ binary safe.
To determine if mysql_real_query returns a result set use the To determine if mysql_real_query returns a result set use the
\f[B]mysql_num_fields(3)\f[R] function. \f[B]mysql_num_fields(3)\f[R] function.
.SS Return value .SS Return value
.PP
Returns zero on success, otherwise non zero. Returns zero on success, otherwise non zero.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

44
man/mysql_refresh.3
View File

@@ -1,39 +1,34 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_refresh" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_refresh" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_refresh \- flushes information on the server mysql_refresh \- flushes information on the server
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_refresh(MYSQL * mysql, unsigned int options); int mysql_refresh(MYSQL * mysql, unsigned int options);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Flushes different types of information stored on the server. Flushes different types of information stored on the server.
The bit\-masked parameter options specify which kind of information will The bit\-masked parameter options specify which kind of information will
be flushed. be flushed.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]options\f[R] \- a bit masked composed integer. \f[CR]options\f[R] \- a bit masked composed integer.
See below. See below.
.PP .PP
\f[C]options\f[R] can be any combinationation of the following flags: \f[CR]options\f[R] can be any combination of the following flags:
.PP .PP
.TS .TS
tab(@); tab(@);
l l. lw(35.0n) lw(35.0n).
T{ T{
Option Option
T}@T{ T}@T{
@@ -41,42 +36,42 @@ Description
T} T}
_ _
T{ T{
\f[C]REFRESH_GRANT\f[R] \f[CR]REFRESH_GRANT\f[R]
T}@T{ T}@T{
Refresh grant tables. Refresh grant tables.
T} T}
T{ T{
\f[C]REFRESH_LOG\f[R] \f[CR]REFRESH_LOG\f[R]
T}@T{ T}@T{
Flush logs. Flush logs.
T} T}
T{ T{
\f[C]REFRESH_TABLES\f[R] \f[CR]REFRESH_TABLES\f[R]
T}@T{ T}@T{
Flush table cache. Flush table cache.
T} T}
T{ T{
\f[C]REFRESH_HOSTS\f[R] \f[CR]REFRESH_HOSTS\f[R]
T}@T{ T}@T{
Flush host cache. Flush host cache.
T} T}
T{ T{
\f[C]REFRESH_STATUS\f[R] \f[CR]REFRESH_STATUS\f[R]
T}@T{ T}@T{
Reset status variables. Reset status variables.
T} T}
T{ T{
\f[C]REFRESH_THREADS\f[R] \f[CR]REFRESH_THREADS\f[R]
T}@T{ T}@T{
Flush thread cache. Flush thread cache.
T} T}
T{ T{
\f[C]REFRESH_SLAVE\f[R] \f[CR]REFRESH_SLAVE\f[R]
T}@T{ T}@T{
Reset master server information and restart slaves. Reset master server information and restart slaves.
T} T}
T{ T{
\f[C]REFRESH_MASTER\f[R] \f[CR]REFRESH_MASTER\f[R]
T}@T{ T}@T{
Remove binary log files. Remove binary log files.
T} T}
@@ -86,7 +81,6 @@ T}
To combine different values in the options parameter use the OR operator To combine different values in the options parameter use the OR operator
`|'. `|'.
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql_reload()\f[R] is an alias for mysql_refresh(). \f[CR]mysql_reload()\f[R] is an alias for mysql_refresh().
.SS Return value .SS Return value
.PP
Returns zero on success, otherwise non zero. Returns zero on success, otherwise non zero.

19
man/mysql_reset_connection.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_reset_connection" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_reset_connection" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_reset_connection \- Resets connection and clears session state mysql_reset_connection \- Resets connection and clears session state
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_reset_connection(MYSQL * mysql); int mysql_reset_connection(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Resets the current connection and clears session state. Resets the current connection and clears session state.
Similar to \f[B]mysql_change_user(3)\f[R] or Similar to \f[B]mysql_change_user(3)\f[R] or
\f[B]mariadb_reconnect(3)\f[R], mysql_reset_connection() resets session \f[B]mariadb_reconnect(3)\f[R], mysql_reset_connection() resets session
@@ -32,14 +27,12 @@ corresponding global variables) * closes active prepared statements *
clears user variables clears user variables
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success, non zero if an error occurred. Returns zero on success, non zero if an error occurred.
.SS History .SS History
.PP
This function was added in MariaDB Connector/C 3.0.0. This function was added in MariaDB Connector/C 3.0.0.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

17
man/mysql_rollback.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_rollback" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_rollback" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_rollback \- Rolls back the current transaction mysql_rollback \- Rolls back the current transaction
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_rollback(MYSQL * mysql); my_bool mysql_rollback(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Rolls back the current transaction for the database. Rolls back the current transaction for the database.
Returns zero on success, nonzero if an error occurred. Returns zero on success, nonzero if an error occurred.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes

20
man/mysql_row_seek.3
View File

@@ -1,30 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_row_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_row_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_row_seek \- Positions the row cursor to an arbitrary row mysql_row_seek \- Positions the row cursor to an arbitrary row
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES * result, MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES * result,
MYSQL_ROW_OFFSET offset); MYSQL_ROW_OFFSET offset);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Positions the row cursor to an arbitrary row in a result set which was Positions the row cursor to an arbitrary row in a result set which was
obtained by \f[B]mysql_store_result(3)\f[R]. obtained by \f[B]mysql_store_result(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]result\f[R] \- a result set identifier returned by \f[CR]result\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]offset\f[R] \- row offset. \f[CR]offset\f[R] \- row offset.
This value can be obtained either by mysql_row_seek() or This value can be obtained either by mysql_row_seek() or
\f[B]mysql_row_tell(3)\f[R] \f[B]mysql_row_tell(3)\f[R]
.SS Notes .SS Notes
@@ -32,7 +27,6 @@ This value can be obtained either by mysql_row_seek() or
This function will not work if the result set was obtained by This function will not work if the result set was obtained by
\f[B]mysql_use_result(3)\f[R]. \f[B]mysql_use_result(3)\f[R].
.SS Return value .SS Return value
.PP
Returns the previous row offset. Returns the previous row offset.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

17
man/mysql_row_tell.3
View File

@@ -1,27 +1,22 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_row_tell" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_row_tell" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_row_tell \- Returns row offset of a result cursor mysql_row_tell \- Returns row offset of a result cursor
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES * res); MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES * res);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the row offset of a result cursor. Returns the row offset of a result cursor.
The returned offset value can be used to reposition the result cursor by The returned offset value can be used to reposition the result cursor by
calling \f[B]mysql_row_seek(3)\f[R]. calling \f[B]mysql_row_seek(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]res\f[R] \- a result set identifier returned by \f[CR]res\f[R] \- a result set identifier returned by
\f[B]mysql_store_result(3)\f[R]. \f[B]mysql_store_result(3)\f[R].
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2

68
man/mysql_select_db.3
View File

@@ -1,35 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_select_db" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_select_db" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_select_db \- selects a database as default mysql_select_db \- selects a database as default
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_select_db(MYSQL * mysql, int mysql_select_db(MYSQL * mysql,
const char * db); const char * db);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Selects a database as default. Selects a database as default.
Returns zero on success, non\-zero on failure Returns zero on success, non\-zero on failure
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] is a connection identifier, which was previously \f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]db\f[R] \- the default database name \f[CR]db\f[R] \- the default database name
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To retrieve the name of the default database either execute the SQL To retrieve the name of the default database either execute the SQL
command \f[C]SELECT DATABASE()\f[R] or retrieve the value via command \f[CR]SELECT DATABASE()\f[R] or retrieve the value via
\f[B]mariadb_get_infov(3)\f[R] API function. \f[B]mariadb_get_infov(3)\f[R] API function.
.IP \[bu] 2 .IP \[bu] 2
The default database can also be set by the db parameter in The default database can also be set by the db parameter in
@@ -37,48 +32,43 @@ The default database can also be set by the db parameter in
.SS Examples .SS Examples
.SS SQL .SS SQL
.IP .IP
.nf .EX
\f[C] # \f[B]switch\f[R] \f[B]to\f[R] \f[B]default\f[R] \f[B]database\f[R] test
# switch to default database test \f[B]USE\f[R] test;
USE test; # \f[B]check\f[R] \f[B]default\f[R] \f[B]database\f[R]
# check default database \f[B]SELECT\f[R] \f[B]DATABASE\f[R]();
SELECT DATABASE(); +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
+\-\-\-\-\-\-\-\-\-\-\-\-+ | \f[B]database\f[R]() |
| database() | +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
+\-\-\-\-\-\-\-\-\-\-\-\-+
| test | | test |
+\-\-\-\-\-\-\-\-\-\-\-\-+ +\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
\f[R] .EE
.fi
.SS MariadDB Connector/C .SS MariadDB Connector/C
.IP .IP
.nf .EX
\f[C]
static int set_default_db(MYSQL *mysql) static int set_default_db(MYSQL *mysql)
{ {
int rc; int rc;
char *default_db; char *default_db;
/* change default database to test */ \f[I]/* change default database to test */\f[R]
rc= mysql_select_db(mysql, \[dq]test\[dq]); rc= mysql_select_db(mysql, \[dq]test\[dq]);
if (rc) \f[B]if\f[R] (rc)
return rc; /* Error */ \f[B]return\f[R] rc; \f[I]/* Error */\f[R]
/* get the default database */ \f[I]/* get the default database */\f[R]
rc= mariadb_get_infov(mysql, MARIADB_CONNECTION_SCHEMA, &default_db); rc= mariadb_get_infov(mysql, MARIADB_CONNECTION_SCHEMA, &default_db);
if (rc) \f[B]if\f[R] (rc)
return rc; /* Error */ \f[B]return\f[R] rc; \f[I]/* Error */\f[R]
if (strcmp(\[dq]test\[dq], default_db) != NULL) \f[B]if\f[R] (strcmp(\[dq]test\[dq], default_db) != NULL)
{ {
printf(\[dq]Wrong default database\[rs]n\[dq]); printf(\[dq]Wrong default database\[rs]n\[dq]);
return 1; \f[B]return\f[R] 1;
} }
printf(\[dq]Default database: %s\[dq], default_db); printf(\[dq]Default database: %s\[dq], default_db);
return 0; \f[B]return\f[R] 0;
} }
\f[R] .EE
.fi
.SS See also .SS See also
.PP
\f[B]mysql_real_connect(3)\f[R] \f[B]mysql_real_connect(3)\f[R]

38
man/mysql_send_query.3
View File

@@ -1,52 +1,48 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_send_query" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_send_query" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_send_query \- sends a SQL statement without waiting for server mysql_send_query \- sends a SQL statement without waiting for server
reponse response
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_send_query(MYSQL * mysql, int mysql_send_query(MYSQL * mysql,
const char *query, const char *query,
unsigned long length); unsigned long length);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Sends a statement to the server, without waiting for the Server OK Sends a statement to the server, without waiting for the Server OK
packet and/or resultset. packet and/or resultset.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]query\f[R] \- SQL statement \f[CR]query\f[R] \- SQL statement
.IP \[bu] 2 .IP \[bu] 2
\f[C]length\f[R] \- length of the SQL statement \f[CR]length\f[R] \- length of the SQL statement
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
The OK and result set package need to be retrieved by The OK and result set package need to be retrieved by
\f[B]mysql_read_query_result(3)\f[R] function \f[B]mysql_read_query_result(3)\f[R] function
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql_send_query()\f[R] can be used for semi asynchronous \f[CR]mysql_send_query()\f[R] can be used for semi asynchronous
operation. operation.
While the function itself is blocking, an event driven application can While the function itself is blocking, an event driven application can
do other tasks until result set is available. do other tasks until result set is available.
.SS Example .SS Example
.PP
For an example how to use \[cq]mysql_send_query()\[ga] in an event For an example how to use \[cq]mysql_send_query()\[ga] in an event
driven model, please check Jan Kneschke\[cq]s article \[lq]Async MySQL driven model, please check Jan Kneschke\[cq]s article \c
Queries with .UR https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/
C\-API\[rq] (https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/). \[lq]Async MySQL Queries with C\-API\[rq]
.UE \c
\&.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
<mysql_real_query> mysql_real_query
.IP \[bu] 2 .IP \[bu] 2
<mysql_read_query_result> mysql_read_query_result

21
man/mysql_server_end.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_server_end" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_server_end" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_server_end \- Called when finished using MariaDB Connector/C mysql_server_end \- Called when finished using MariaDB Connector/C
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_server_end(void) void mysql_server_end(void)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Call when finished using the library, such as after disconnecting from Call when finished using the library, such as after disconnecting from
the server. the server.
For a client program, only cleans up by performing memory management For a client program, only cleans up by performing memory management
tasks. tasks.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql_library_end()\f[R] is an alias for \f[CR]mysql_library_end()\f[R] is an alias for
\f[C]mysql_server_end()\f[R]. \f[CR]mysql_server_end()\f[R].
.IP \[bu] 2 .IP \[bu] 2
In MySQL Connector/C versions 3.0.1 to 3.0.4 it was not possible to call In MySQL Connector/C versions 3.0.1 to 3.0.4 it was not possible to call
multiple times \f[B]mysql_server_init(3)\f[R] and multiple times \f[B]mysql_server_init(3)\f[R] and
\f[C]mysql_server_end()\f[R]. \f[CR]mysql_server_end()\f[R].
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_server_init(3)\f[R] \f[B]mysql_server_init(3)\f[R]

25
man/mysql_server_init.3
View File

@@ -1,38 +1,31 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_server_init" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_server_init" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_server_init \- Initializes library mysql_server_init \- Initializes library
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_library_init(int argc __attribute__((unused)), int mysql_library_init(int argc __attribute__((unused)),
char **argv __attribute__((unused)), char **argv __attribute__((unused)),
char **groups __attribute__((unused))) char **groups __attribute__((unused)))
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Call to initialize the library before calling other functions. Call to initialize the library before calling other functions.
.SS Parameters .SS Parameters
.PP
All parameters are unused, they only exist for compatibility reasons. All parameters are unused, they only exist for compatibility reasons.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Call \f[B]mysql_server_end(3)\f[R] to clean up after completion. Call \f[B]mysql_server_end(3)\f[R] to clean up after completion.
.IP \[bu] 2 .IP \[bu] 2
If the library was not explicetly initialized by If the library was not explicitly initialized by
\f[C]mysql_server_init()\f[R] any call to \f[B]mysql_init(3)\f[R] will \f[CR]mysql_server_init()\f[R] any call to \f[B]mysql_init(3)\f[R] will
automatically initialize the library. automatically initialize the library.
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql_library_init()\f[R] is an alias for \f[CR]mysql_library_init()\f[R] is an alias for
\f[C]mysql_server_init()\f[R] \f[CR]mysql_server_init()\f[R]
.SS Return value .SS Return value
.PP
Returns zero for success, or nonzero if an error occurred. Returns zero for success, or nonzero if an error occurred.
## See also * \f[B]mysql_server_end(3)\f[R] ## See also * \f[B]mysql_server_end(3)\f[R]

51
man/mysql_session_track_get_first.3
View File

@@ -1,37 +1,32 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_session_track_get_first" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_session_track_get_first" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_session_track_get_first \- retrieves first session status change mysql_session_track_get_first \- retrieves first session status change
information information
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_session_track_get_first(MYSQL * mysql, int mysql_session_track_get_first(MYSQL * mysql,
enum enum_session_state_type type, \f[B]enum\f[R] enum_session_state_type type,
const char **data, const char **data,
size_t *length ); size_t *length );
\f[R] .EE
.fi
.SS Description .SS Description
.PP \f[CR]mysql_session_track_get_first()\f[R] retrieves the first session
\f[C]mysql_session_track_get_first()\f[R] retrieves the first session
status change information received from the server. status change information received from the server.
.PP .PP
Depending on the specified type the read only data pointer will contain Depending on the specified type the read only data pointer will contain
the following information: * \f[C]SESSION_TRACK_SCHEMA\f[R]: The name of the following information: * \f[CR]SESSION_TRACK_SCHEMA\f[R]: The name
the default schema (database) * of the default schema (database) *
\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R]: If a session system variable \f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R]: If a session system variable
is changed, the first call contains the name of the changed system is changed, the first call contains the name of the changed system
variable, the second call contains the new value. variable, the second call contains the new value.
Both name and value are represented as strings. Both name and value are represented as strings.
* \f[C]SESSION_TRACK_STATE_CHANGE\f[R]: shows whether the session status * \f[CR]SESSION_TRACK_STATE_CHANGE\f[R]: shows whether the session
has changed. status has changed.
The value is changed as string \[lq]1\[rq] (changed) or \[lq]0\[rq] The value is changed as string \[lq]1\[rq] (changed) or \[lq]0\[rq]
(unchanged). (unchanged).
.PP .PP
@@ -39,35 +34,33 @@ Further data needs to be obtained by calling
\f[B]mysql_session_track_get_next(3)\f[R]. \f[B]mysql_session_track_get_next(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]type\f[R] \- type of information. \f[CR]type\f[R] \- type of information.
Valid values are Valid values are
.RS 2 .RS 2
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R] \f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_SCHEMA\f[R] \f[CR]SESSION_TRACK_SCHEMA\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_STATE_CHANGE\f[R] \f[CR]SESSION_TRACK_STATE_CHANGE\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_GTIDS\f[R] (unsupported) \f[CR]SESSION_TRACK_GTIDS\f[R] (unsupported)
.RE .RE
.IP \[bu] 2 .IP \[bu] 2
\f[C]data\f[R] \- pointer to data, which must be declared as \f[CR]data\f[R] \- pointer to data, which must be declared as
\f[C]const char *\f[R] \f[CR]const char *\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]length\f[R] \- pointer to a \f[C]size_t\f[R] variable, which will \f[CR]length\f[R] \- pointer to a \f[CR]size_t\f[R] variable, which will
contain the length of data contain the length of data
.SS Returns .SS Returns
.PP
Zero for success, nonzero if no session tracking information is Zero for success, nonzero if no session tracking information is
available. available.
.SS History .SS History
.PP \f[CR]mysql_session_track_get_first()\f[R] was added in Connector/C 3.0
\f[C]mysql_session_track_get_first()\f[R] was added in Connector/C 3.0
and MariaDB Server 10.2. and MariaDB Server 10.2.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

44
man/mysql_session_track_get_next.3
View File

@@ -1,62 +1,54 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_session_track_get_next" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_session_track_get_next" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_session_track_get_next \- Retrieves the next session status change mysql_session_track_get_next \- Retrieves the next session status change
information information
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_session_track_get_next(MYSQL * mysql, int mysql_session_track_get_next(MYSQL * mysql,
enum enum_session_state_type type, \f[B]enum\f[R] enum_session_state_type type,
const char **data, const char **data,
size_t *length ); size_t *length );
\f[R] .EE
.fi
.SS Description .SS Description
.PP \f[CR]mysql_session_track_get_next()\f[R] retrieves the session status
\f[C]mysql_session_track_get_next()\f[R] retrieves the session status
change information received from the server after a successful call to change information received from the server after a successful call to
\f[B]mysql_session_track_get_first(3)\f[R]. \f[B]mysql_session_track_get_first(3)\f[R].
.PP .PP
\f[C]mysql_session_track_get_next()\f[R] needs to be called repeatedly \f[CR]mysql_session_track_get_next()\f[R] needs to be called repeatedly
until a non zero return value indicates end of data. until a non zero return value indicates end of data.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected bys \f[B]mysql_init(3)\f[R] and connected bys
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]type\f[R] \- type of information. \f[CR]type\f[R] \- type of information.
Valid values are Valid values are
.RS 2 .RS 2
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R] \f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_SCHEMA\f[R] \f[CR]SESSION_TRACK_SCHEMA\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_STATE_CHANGE\f[R] \f[CR]SESSION_TRACK_STATE_CHANGE\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]SESSION_TRACK_GTIDS\f[R] (unsupported) \f[CR]SESSION_TRACK_GTIDS\f[R] (unsupported)
.RE .RE
.IP \[bu] 2 .IP \[bu] 2
\f[C]data\f[R] \- pointer to data, which must be declared as \f[CR]data\f[R] \- pointer to data, which must be declared as
\f[C]const char *\f[R] \f[CR]const char *\f[R]
.IP \[bu] 2 .IP \[bu] 2
\f[C]length\f[R] \- pointer to a \f[C]size_t\f[R] variable, which will \f[CR]length\f[R] \- pointer to a \f[CR]size_t\f[R] variable, which will
contain the length of data contain the length of data
.SS Return value .SS Return value
.PP
Zero for success, nonzero if an error occurred. Zero for success, nonzero if an error occurred.
.SS History .SS History
.PP \f[CR]mysql_session_track_get_next()\f[R] was added in Connector/C 3.0
\f[C]mysql_session_track_get_next()\f[R] was added in Connector/C 3.0
and MariaDB Server 10.2. and MariaDB Server 10.2.
.SS See also .SS See also
.PP
\f[B]mysql_session_track_get_first(3)\f[R] \f[B]mysql_session_track_get_first(3)\f[R]

33
man/mysql_set_character_set.3
View File

@@ -1,42 +1,33 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_set_character_set" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_set_character_set" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_set_character_set \- Sets the default character set for connection mysql_set_character_set \- Sets the default character set for connection
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_set_character_set(MYSQL * mysql, int mysql_set_character_set(MYSQL * mysql,
const char * csname); const char * csname);
\f[R] .EE
.fi
.SS Description .SS Description
.PP Sets the default character setfor the current connection.
Sets the default
[data\-types\-character\-sets\-and\-collations()](character set]] for
the current connection.
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
mysql_init() (mysql_init) or \f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_init(3)\f[R] or \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]csname\f[R] \- character set name ### Notes \f[CR]csname\f[R] \- character set name ### Notes
.IP \[bu] 2 .IP \[bu] 2
It\[cq]s strongly recommended to use mysql_set_character_set() instead It\[cq]s strongly recommended to use mysql_set_character_set() instead
of \f[C]SET NAMES ...\f[R] since \f[B]mysql_real_escape_string(3)\f[R] of \f[CR]SET NAMES ...\f[R] since \f[B]mysql_real_escape_string(3)\f[R]
might fail or deliver unexpected results. might fail or deliver unexpected results.
.SS Return value .SS Return value
.PP Zero on success, non zero if an error occurred
Zero on success, non zero if an error occured
.SS Supported character sets .SS Supported character sets
.PP
The client library supports the following character sets: The client library supports the following character sets:
.PP .PP
.TS .TS

24
man/mysql_set_server_option.3
View File

@@ -1,31 +1,26 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_set_server_option" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_set_server_option" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_set_server_option \- Sets server option mysql_set_server_option \- Sets server option
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_set_server_option(MYSQL * mysql, int mysql_set_server_option(MYSQL * mysql,
enum enum_mysql_set_option); \f[B]enum\f[R] enum_mysql_set_option);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Sets server option. Sets server option.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]enum_mysql_set_option\f[R] \- server option (see below) Server \f[CR]enum_mysql_set_option\f[R] \- server option (see below) Server
option, which can be one of the following values: option, which can be one of the following values:
.PP .PP
.TS .TS
@@ -49,7 +44,6 @@ Enable multi statement support
T} T}
.TE .TE
.SS Return value .SS Return value
.PP
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

26
man/mysql_shutdown.3
View File

@@ -1,40 +1,34 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_shutdown" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_shutdown" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_shutdown \- Sends shutdown message to server mysql_shutdown \- Sends shutdown message to server
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
int mysql_shutdown(MYSQL * mysql, int mysql_shutdown(MYSQL * mysql,
enum mysql_enum_shutdown_level); \f[B]enum\f[R] mysql_enum_shutdown_level);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
This function is deprecated. This function is deprecated.
Instead please use SQL \f[C]SHUTDOWN\f[R] command. Instead please use SQL \f[CR]SHUTDOWN\f[R] command.
.PP .PP
Sends a shutdown message to the server. Sends a shutdown message to the server.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql_enum_shutdown_level\f[R] \- currently only one shutdown \f[CR]mysql_enum_shutdown_level\f[R] \- currently only one shutdown
level, \f[C]SHUTDOWN_DEFAULT\f[R] is supported. level, \f[CR]SHUTDOWN_DEFAULT\f[R] is supported.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
To shutdown the database server, the user for the current connection To shutdown the database server, the user for the current connection
must have SHUTDOWN privileges. must have SHUTDOWN privileges.
.SS Return value .SS Return value
.PP
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

17
man/mysql_sqlstate.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_sqlstate" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_sqlstate" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_sqlstate \- returns SQLSTATE error code mysql_sqlstate \- returns SQLSTATE error code
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_sqlstate(MYSQL * mysql); const char * mysql_sqlstate(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns a string containing the SQLSTATE error code for the most Returns a string containing the SQLSTATE error code for the most
recently invoked function that can succeed or fail. recently invoked function that can succeed or fail.
The error code consists of five characters. The error code consists of five characters.
@@ -23,12 +18,10 @@ The error code consists of five characters.
The values are specified by ANSI SQL and ODBC The values are specified by ANSI SQL and ODBC
.SS Parameter .SS Parameter
.SS Notes .SS Notes
.PP
Please note that not all client library error codes are mapped to Please note that not all client library error codes are mapped to
SQLSTATE errors. SQLSTATE errors.
Errors which can\[cq]t be mapped will returned as value HY000. Errors which can\[cq]t be mapped will returned as value HY000.
.SS Return value .SS Return value
.PP
A string containing SQLSTATE error code. A string containing SQLSTATE error code.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2

41
man/mysql_ssl_set.3
View File

@@ -1,15 +1,12 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_ssl_set" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_ssl_set" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_ssl_set \- Sets TLS/SSL options mysql_ssl_set \- Sets TLS/SSL options
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_ssl_set(MYSQL *mysql, my_bool mysql_ssl_set(MYSQL *mysql,
const char *key, const char *key,
@@ -17,33 +14,41 @@ my_bool mysql_ssl_set(MYSQL *mysql,
const char *ca, const char *ca,
const char *capath, const char *capath,
const char *cipher) const char *cipher)
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Used for establishing a secure TLS connection. Used for establishing a secure TLS connection.
It must be called before attempting to use It must be called before attempting to use
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
TLS support must be enabled in the client library in order for the TLS support must be enabled in the client library in order for the
function to have any effect. function to have any effect.
.PP .PP
NULL can be used for an unused parameter. \f[CR]NULL\f[R] can be used for an unused parameter.
Always returns zero. Always returns zero.
.PP
To enable TLS without specifying certificates, set all values to
\f[CR]NULL\f[R]:
.IP
.EX
mysql_ssl_set(mysql, NULL, NULL, NULL, NULL, NULL)
.EE
.PP
This is the same as
\f[CR]mysql_optionsv(mysql, MYSQL_OPT_SSL_ENFORCE, &yes)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R]. \f[B]mysql_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]key\f[R] \- path to the key file. \f[CR]key\f[R] \- path to the key file.
.IP \[bu] 2 .IP \[bu] 2
\f[C]cert\f[R] \- path to the certificate file. \f[CR]cert\f[R] \- path to the certificate file.
.IP \[bu] 2 .IP \[bu] 2
\f[C]ca\f[R] \- path to the certificate authority file. \f[CR]ca\f[R] \- path to the certificate authority file.
.IP \[bu] 2 .IP \[bu] 2
\f[C]capath\f[R] \- path to the directory containing the trusted TLS CA \f[CR]capath\f[R] \- path to the directory containing the trusted TLS CA
certificates in PEM format. certificates in PEM format.
.IP \[bu] 2 .IP \[bu] 2
\f[C]cipher\f[R] list of permitted (SSLv3, TLSv1.0 or TLSv1.2) cipher \f[CR]cipher\f[R] list of permitted (SSLv3, TLSv1.0 or TLSv1.2) cipher
suites to use for TLS encryption. suites to use for TLS encryption.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
@@ -51,7 +56,7 @@ suites to use for TLS encryption.
connect and TLS is incorrectly set up. connect and TLS is incorrectly set up.
.IP \[bu] 2 .IP \[bu] 2
Even if Connector/C supports TLSv1.3 protocol, it is not possible yet to Even if Connector/C supports TLSv1.3 protocol, it is not possible yet to
specify TLSv1.3 cipher suites via \f[C]cipher\f[R] parameter. specify TLSv1.3 cipher suites via \f[CR]cipher\f[R] parameter.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_get_ssl_cipher(3)\f[R] \f[B]mysql_get_ssl_cipher(3)\f[R]

21
man/mysql_stat.3
View File

@@ -1,35 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stat" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stat" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stat \- Returns current server status mysql_stat \- Returns current server status
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
const char * mysql_stat(MYSQL * mysql); const char * mysql_stat(MYSQL * mysql);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
mysql_stat() returns a string with the current server status for uptime, mysql_stat() returns a string with the current server status for uptime,
threads, queries, open tables, flush tables and queries per second. threads, queries, open tables, flush tables and queries per second.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]mysql\f[R] \- a mysql handle, which was previously allocated by \f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected byy \f[B]mysql_init(3)\f[R] and connected byy
\f[B]mysql_real_connect(3)\f[R]. \f[B]mysql_real_connect(3)\f[R].
.SS Notes .SS Notes
.PP
For a complete list of other status variables, you have to use the For a complete list of other status variables, you have to use the
[show\-status()](SHOW STATUS]] SQL command. [show\-status()](SHOW STATUS]] SQL command.
.SS Return value .SS Return value
.PP
Returns a string representing current server status. Returns a string representing current server status.
.SS See also .SS See also
.IP \[bu] 2 .IP \[bu] 2
mysql_get_server_info() (mysql_get_server_info) mysql_get_server_info()

23
man/mysql_stmt_affected_rows.3
View File

@@ -1,39 +1,34 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_affected_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_affected_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_affected_rows \- Returns the number of affected rows from mysql_stmt_affected_rows \- Returns the number of affected rows from
previous executed prepared statement previous executed prepared statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT * stmt); my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT * stmt);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the number of affected rows by the last prepared statement Returns the number of affected rows by the last prepared statement
associated with mysql, if the operation was an \[lq]upsert\[rq] (INSERT, associated with mysql, if the operation was an \[lq]upsert\[rq] (INSERT,
UPDATE, DELETE or REPLACE) statement, or \-1 if the last prepared UPDATE, DELETE or REPLACE) statement, or \-1 if the last prepared
statement failed. statement failed.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
[mysql_stmt_init()](mysql_stmt_init().]] [mysql_stmt_init()](mysql_stmt_init().]]
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
When using \f[C]UPDATE\f[R], MariaDB will not update columns where the When using \f[CR]UPDATE\f[R], MariaDB will not update columns where the
new value is the same as the old value. new value is the same as the old value.
This creates the possibility that \f[C]mysql_stmt_affected_rows()\f[R] This creates the possibility that \f[CR]mysql_stmt_affected_rows()\f[R]
may not actually equal the number of rows matched, only the number of may not actually equal the number of rows matched, only the number of
rows that were literally affected by the query. rows that were literally affected by the query.
.IP \[bu] 2 .IP \[bu] 2
The \f[C]REPLACE\f[R] statement first deletes the record with the same The \f[CR]REPLACE\f[R] statement first deletes the record with the same
primary key and then inserts the new record. primary key and then inserts the new record.
This function returns the number of deleted records in addition to the This function returns the number of deleted records in addition to the
number of inserted records. number of inserted records.

56
man/mysql_stmt_attr_get.3
View File

@@ -1,39 +1,33 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_attr_get" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_attr_get" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_attr_get \- Gets the current value of a statement attribute mysql_stmt_attr_get \- Gets the current value of a statement attribute
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_stmt_attr_get(MYSQL_STMT * stmt, my_bool mysql_stmt_attr_get(MYSQL_STMT * stmt,
enum enum_stmt_attr_type, \f[B]enum\f[R] enum_stmt_attr_type,
void * attr); void * attr);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Gets the current value of a statement attribute. Gets the current value of a statement attribute.
Returns zero on success, non zero on failure. Returns zero on success, non zero on failure.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]enum_stmt_attr_type\f[R] \- attribute. \f[CR]enum_stmt_attr_type\f[R] \- attribute.
See below. See below.
.IP \[bu] 2 .IP \[bu] 2
\f[C]attr\f[R] \- pointer to a variable, which will contain the \f[CR]attr\f[R] \- pointer to a variable, which will contain the
attribute value. attribute value.
.SS Attribute types .SS Attribute types
.PP The \f[CR]enum_stmt_attr_type\f[R] parameter has the following possible
The \f[C]enum_stmt_attr_type\f[R] parameter has the following possible
values: values:
.PP .PP
.TS .TS
@@ -48,43 +42,43 @@ Description
T} T}
_ _
T{ T{
\f[C]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] \f[CR]STMT_ATTR_UPDATE_MAX_LENGTH\f[R]
T}@T{ T}@T{
\f[C]my_bool *\f[R] \f[CR]my_bool *\f[R]
T}@T{ T}@T{
Indicates if \f[B]mysql_stmt_store_result(3)\f[R] will update the Indicates if \f[B]mysql_stmt_store_result(3)\f[R] will update the
max_length value of \f[C]MYSQL_FIELD\f[R] structures. max_length value of \f[CR]MYSQL_FIELD\f[R] structures.
T} T}
T{ T{
\f[C]STMT_ATTR_CURSOR_TYPE\f[R] \f[CR]STMT_ATTR_CURSOR_TYPE\f[R]
T}@T{ T}@T{
\f[C]unsigned long *\f[R] \f[CR]unsigned long *\f[R]
T}@T{ T}@T{
Possible values are \f[C]CURSOR_TYPE_READ_ONLY\f[R] or default value Possible values are \f[CR]CURSOR_TYPE_READ_ONLY\f[R] or default value
\f[C]CURSOR_TYPE_NO_CURSOR\f[R]. \f[CR]CURSOR_TYPE_NO_CURSOR\f[R].
T} T}
T{ T{
\f[C]STMT_ATTR_PREFETCH_ROWS\f[R] \f[CR]STMT_ATTR_PREFETCH_ROWS\f[R]
T}@T{ T}@T{
\f[C]unsigned long *\f[R] \f[CR]unsigned long *\f[R]
T}@T{ T}@T{
Number of rows which will be prefetched. Number of rows which will be prefetched.
The default value is 1. The default value is 1.
T} T}
T{ T{
\f[C]STMT_ATTR_PREBIND_PARAMS\f[R] \f[CR]STMT_ATTR_PREBIND_PARAMS\f[R]
T}@T{ T}@T{
\f[C]unsigned int *\f[R] \f[CR]unsigned int *\f[R]
T}@T{ T}@T{
Number of parameters used for \f[B]mariadb_stmt_execute_direct(3)\f[R] Number of parameters used for \f[B]mariadb_stmt_execute_direct(3)\f[R]
T} T}
T{ T{
\f[C]STMT_ATTR_STATE\f[R] \f[CR]STMT_ATTR_STATE\f[R]
T}@T{ T}@T{
\f[C]enum mysql_stmt_state *\f[R] \f[CR]enum mysql_stmt_state *\f[R]
T}@T{ T}@T{
Status of prepared statement. Status of prepared statement.
Possible values are defined in \f[C]enum mysql_stmt_state\f[R]. Possible values are defined in \f[CR]enum mysql_stmt_state\f[R].
This option was added in MariaDB Connector/C 3.1.0 This option was added in MariaDB Connector/C 3.1.0
T} T}
.TE .TE

60
man/mysql_stmt_attr_set.3
View File

@@ -1,39 +1,33 @@
.\"t '\" t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_attr_set" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_attr_set" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_attr_set \- Sets attribute of a statement mysql_stmt_attr_set \- Sets attribute of a statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_stmt_attr_set(MYSQL_STMT * stmt, my_bool mysql_stmt_attr_set(MYSQL_STMT * stmt,
enum enum_stmt_attr_type, \f[B]enum\f[R] enum_stmt_attr_type,
const void * attr); const void * attr);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Used to modify the behavior of a prepared statement. Used to modify the behavior of a prepared statement.
This function may be called multiple times to set several attributes. This function may be called multiple times to set several attributes.
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]enum_stmt_attr_type\f[R] \- the attribute that you want to set. \f[CR]enum_stmt_attr_type\f[R] \- the attribute that you want to set.
See below. See below.
.IP \[bu] 2 .IP \[bu] 2
\f[C]attr\f[R] \- the value to assign to the attribute \f[CR]attr\f[R] \- the value to assign to the attribute
.SS Attribute types .SS Attribute types
.PP The \f[CR]enum_stmt_attr_type\f[R] attribute can have one of the
The \f[C]enum_stmt_attr_type\f[R] attribute can have one of the
following values: following values:
.PP .PP
.TS .TS
@@ -48,34 +42,34 @@ Description
T} T}
_ _
T{ T{
\f[C]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] \f[CR]STMT_ATTR_UPDATE_MAX_LENGTH\f[R]
T}@T{ T}@T{
\f[C]my_bool *\f[R] \f[CR]my_bool *\f[R]
T}@T{ T}@T{
If set to 1, \f[B]mysql_stmt_store_result(3)\f[R] will update the If set to 1, \f[B]mysql_stmt_store_result(3)\f[R] will update the
max_length value of MYSQL_FIELD structures. max_length value of MYSQL_FIELD structures.
T} T}
T{ T{
\f[C]STMT_ATTR_CURSOR_TYPE\f[R] \f[CR]STMT_ATTR_CURSOR_TYPE\f[R]
T}@T{ T}@T{
\f[C]unsigned long *\f[R] \f[CR]unsigned long *\f[R]
T}@T{ T}@T{
cursor type when \f[B]mysql_stmt_execute(3)\f[R] is invoked. cursor type when \f[B]mysql_stmt_execute(3)\f[R] is invoked.
Possible values are \f[C]CURSOR_TYPE_READ_ONLY\f[R] or default value Possible values are \f[CR]CURSOR_TYPE_READ_ONLY\f[R] or default value
\f[C]CURSOR_TYPE_NO_CURSOR\f[R]. \f[CR]CURSOR_TYPE_NO_CURSOR\f[R].
T} T}
T{ T{
\f[C]STMT_ATTR_PREFETCH_ROWS\f[R] \f[CR]STMT_ATTR_PREFETCH_ROWS\f[R]
T}@T{ T}@T{
\f[C]unsigned long *\f[R] \f[CR]unsigned long *\f[R]
T}@T{ T}@T{
number of rows which will be prefetched. number of rows which will be prefetched.
The default value is 1. The default value is 1.
T} T}
T{ T{
\f[C]STMT_ATTR_PREBIND_PARAMS\f[R] \f[CR]STMT_ATTR_PREBIND_PARAMS\f[R]
T}@T{ T}@T{
\f[C]unsigned int *\f[R] \f[CR]unsigned int *\f[R]
T}@T{ T}@T{
number of parameter markers when using number of parameter markers when using
\f[B]mariadb_stmt_execute_direct(3)\f[R]. \f[B]mariadb_stmt_execute_direct(3)\f[R].
@@ -84,18 +78,18 @@ state after mysql_stmt_init().
This option was added in Connector/C 3.0 This option was added in Connector/C 3.0
T} T}
T{ T{
\f[C]STMT_ATTR_ARRAY_SIZE\f[R] \f[CR]STMT_ATTR_ARRAY_SIZE\f[R]
T}@T{ T}@T{
\f[C]unsigned int *\f[R] \f[CR]unsigned int *\f[R]
T}@T{ T}@T{
number of array elements. number of array elements.
This option was added in Connector/C 3.0 and requires MariaDB 10.2 or This option was added in Connector/C 3.0 and requires MariaDB 10.2 or
later later
T} T}
T{ T{
\f[C]STMT_ATTR_ROW_SIZE\f[R] \f[CR]STMT_ATTR_ROW_SIZE\f[R]
T}@T{ T}@T{
\f[C]size_t *\f[R] \f[CR]size_t *\f[R]
T}@T{ T}@T{
specifies size of a structure for row wise binding. specifies size of a structure for row wise binding.
This length must include space for all of the bound parameters and any This length must include space for all of the bound parameters and any
@@ -111,8 +105,8 @@ T}
.TE .TE
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
If you use the \f[C]MYSQL_STMT_ATTR_CURSOR_TYPE\f[R] option with If you use the \f[CR]MYSQL_STMT_ATTR_CURSOR_TYPE\f[R] option with
\f[C]MYSQL_CURSOR_TYPE_READ_ONLY\f[R], a cursor is opened for the \f[CR]MYSQL_CURSOR_TYPE_READ_ONLY\f[R], a cursor is opened for the
statement when you invoke \f[B]mysql_stmt_execute(3)\f[R]. statement when you invoke \f[B]mysql_stmt_execute(3)\f[R].
If there is already an open cursor from a previous If there is already an open cursor from a previous
\f[B]mysql_stmt_execute(3)\f[R] call, it closes the cursor before \f[B]mysql_stmt_execute(3)\f[R] call, it closes the cursor before

19
man/mysql_stmt_bind_param.3
View File

@@ -1,31 +1,26 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_bind_param" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_bind_param" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_bind_param \- Binds parameter to a prepared statement mysql_stmt_bind_param \- Binds parameter to a prepared statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_stmt_bind_param(MYSQL_STMT * stmt, my_bool mysql_stmt_bind_param(MYSQL_STMT * stmt,
MYSQL_BIND * bind); MYSQL_BIND * bind);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Binds variables for parameter markers in the prepared statement that was Binds variables for parameter markers in the prepared statement that was
passed to \f[B]mysql_stmt_prepare(3)\f[R]. passed to \f[B]mysql_stmt_prepare(3)\f[R].
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]bind\f[R] \- an array of \f[C]MYSQL_BIND\f[R] structures. \f[CR]bind\f[R] \- an array of \f[CR]MYSQL_BIND\f[R] structures.
The size of this array must be equal to the number of parameters. The size of this array must be equal to the number of parameters.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2

19
man/mysql_stmt_bind_result.3
View File

@@ -1,30 +1,25 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_bind_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_bind_result" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_bind_result \- binds result columns to variables mysql_stmt_bind_result \- binds result columns to variables
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_stmt_bind_result(MYSQL_STMT * stmt, my_bool mysql_stmt_bind_result(MYSQL_STMT * stmt,
MYSQL_BIND * bind); MYSQL_BIND * bind);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Binds columns in the result set to variables. Binds columns in the result set to variables.
Returns zero on success, non\-zero on failure. Returns zero on success, non\-zero on failure.
.SS Parameters .SS Parameters
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]bind\f[R] \- an array of [MYSQL_BIND]] structures. \f[CR]bind\f[R] \- an array of [MYSQL_BIND]] structures.
The size of this array must be equal to the number of columns in result The size of this array must be equal to the number of columns in result
set. set.
.SS Notes .SS Notes

18
man/mysql_stmt_close.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_close" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_close" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_close \- Closes a prepared statement mysql_stmt_close \- Closes a prepared statement
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
my_bool mysql_stmt_close(MYSQL_STMT * stmt); my_bool mysql_stmt_close(MYSQL_STMT * stmt);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Closes a prepared statement and deallocates the statement handle. Closes a prepared statement and deallocates the statement handle.
If the current statement has pending or unread results, this function If the current statement has pending or unread results, this function
cancels them so that the next query can be executed. cancels them so that the next query can be executed.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.SS Return value .SS Return value
.PP
Returns zero on success, nonzero on error (when communicating with the Returns zero on success, nonzero on error (when communicating with the
server). server).
The statement is deallocated, regardless of the error. The statement is deallocated, regardless of the error.

20
man/mysql_stmt_data_seek.3
View File

@@ -1,34 +1,28 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_data_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_data_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_data_seek \- Seeks to an arbitrary row in statement result mysql_stmt_data_seek \- Seeks to an arbitrary row in statement result
set set
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
void mysql_stmt_data_seek(MYSQL_STMT * stmt, void mysql_stmt_data_seek(MYSQL_STMT * stmt,
my_ulonglong offset); my_ulonglong offset);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Seeks to an arbitrary row in statement result set obtained by a previous Seeks to an arbitrary row in statement result set obtained by a previous
call to \f[B]mysql_stmt_store_result(3)\f[R]. call to \f[B]mysql_stmt_store_result(3)\f[R].
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[C]offset\f[R] \- row offset. \f[CR]offset\f[R] \- row offset.
This value must between 0 and number of rows \- 1. This value must between 0 and number of rows \- 1.
.SS Return value .SS Return value
.PP
Returns void Returns void
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2

24
man/mysql_stmt_errno.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 3.5
.\" .\"
.TH "mysql_stmt_errno" "3" "" "Version 3.3.1" "MariaDB Connector/C" .TH "mysql_stmt_errno" "3" "" "Version 3.4.2" "MariaDB Connector/C"
.hy
.SS Name .SS Name
.PP
mysql_stmt_errno \- Returns error code for the last statement error mysql_stmt_errno \- Returns error code for the last statement error
.SS Synopsis .SS Synopsis
.IP .IP
.nf .EX
\f[C] #include \f[B]<mysql.h>\f[R]
#include <mysql.h>
unsigned int mysql_stmt_errno(MYSQL_STMT * stmt); unsigned int mysql_stmt_errno(MYSQL_STMT * stmt);
\f[R] .EE
.fi
.SS Description .SS Description
.PP
Returns the error code for the most recently invoked statement function Returns the error code for the most recently invoked statement function
that can succeed or fail. that can succeed or fail.
.SS Parameter .SS Parameter
.IP \[bu] 2 .IP \[bu] 2
\f[C]stmt\f[R] \- a statement handle, which was previously allocated by \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by
\f[B]mysql_stmt_init(3)\f[R]. \f[B]mysql_stmt_init(3)\f[R].
.SS Return value .SS Return value
.PP
Returns error code. Returns error code.
A zero value means that no error occurred. A zero value means that no error occurred.
.SS Notes .SS Notes
.IP \[bu] 2 .IP \[bu] 2
Client error messages are listed in \f[C]errmsg.h\f[R] header file, Client error messages are listed in \f[CR]errmsg.h\f[R] header file,
server error messages are listed in \f[C]mysqld_error.h\f[R] header file server error messages are listed in \f[CR]mysqld_error.h\f[R] header
of the server source distribution. file of the server source distribution.
.SS See Also .SS See Also
.IP \[bu] 2 .IP \[bu] 2
\f[B]mysql_stmt_error(3)\f[R], \f[B]mysql_stmt_error(3)\f[R],

Some files were not shown because too many files have changed in this diff Show More