diff --git a/man/mariadb_cancel.3 b/man/mariadb_cancel.3 index 38729c2d..0938aeb7 100644 --- a/man/mariadb_cancel.3 +++ b/man/mariadb_cancel.3 @@ -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" -.hy +.TH "mariadb_cancel" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_cancel \- Immediately aborts a connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mariadb_cancel(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Immediately aborts a connection by making all subsequent read/write operations fail. -\f[C]mariadb_cancel()\f[R] does not invalidate memory used for -\f[C]mysql\f[R] structure, nor close any communication channels. +\f[CR]mariadb_cancel()\f[R] does not invalidate memory used for +\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. -\f[C]mariadb_cancel()\f[R] is useful to break long queries in situations -where sending KILL is not possible. +\f[CR]mariadb_cancel()\f[R] is useful to break long queries in +situations where sending KILL is not possible. .SS Parameter -.PP -\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_real_connect(3)\f[R]. .SS Return value -.PP Returns zero on success or a non\-zero value on error. .SS History -.PP -\f[C]mariadb_cancel()\f[R] was added in Connector/C 3.0 +\f[CR]mariadb_cancel()\f[R] was added in Connector/C 3.0 diff --git a/man/mariadb_connection.3 b/man/mariadb_connection.3 index a2b571b5..dabf8227 100644 --- a/man/mariadb_connection.3 +++ b/man/mariadb_connection.3 @@ -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" -.hy +.TH "mariadb_connection" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_connection \- checks if the client is connected to a MariaDB database server .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mariadb_connection(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Checks if the client is connected to a MariaDB or MySQL database server. .SS Parameter -.PP -\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_real_connect(3)\f[R]. .SS Return value -.PP Returns a non zero value if connected to a MariaDB database server, otherwise zero. diff --git a/man/mariadb_dyncol_check.3 b/man/mariadb_dyncol_check.3 index 5b425e31..3bfab989 100644 --- a/man/mariadb_dyncol_check.3 +++ b/man/mariadb_dyncol_check.3 @@ -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" -.hy +.TH "mariadb_dyncol_check" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_check \- Checks if a dynamic column has correct format .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_check(DYNAMIC_COLUMN *str); -\f[R] -.fi +.EE .SS Description -.PP -The function \f[C]mariadb_dyncol_check()\f[R] checks if a dynamic column -has correct format. +The function \f[CR]mariadb_dyncol_check()\f[R] checks if a dynamic +column has correct format. This can be used e.g.\ to check if a blob contains a dynamic column. .SS Parameter .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 -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] if the dynamic column has correct format, -otherwise \f[C]ER_DYNCOL_FORMAT\f[R]. +Returns \f[CR]ER_DYNCOL_OK\f[R] if the dynamic column has correct +format, otherwise \f[CR]ER_DYNCOL_FORMAT\f[R]. .SS See also .IP \[bu] 2 \f[B]mariadb_dyncol_count(3)\f[R] diff --git a/man/mariadb_dyncol_column_cmp_named.3 b/man/mariadb_dyncol_column_cmp_named.3 index ba345c28..0dadb298 100644 --- a/man/mariadb_dyncol_column_cmp_named.3 +++ b/man/mariadb_dyncol_column_cmp_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_column_cmp_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_column_cmp_named \- Compare two column names .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mariadb_dyncol_column_cmp_named(const MYSQL_LEX_STRING *s1, const MYSQL_LEX_STRING *s2); -\f[R] -.fi +.EE .SS Description -.PP 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 .IP \[bu] 2 -\f[C]s1\f[R] \- First key +\f[CR]s1\f[R] \- First key .IP \[bu] 2 -\f[C]s2\f[R] \- Second key +\f[CR]s2\f[R] \- Second key .SS Return value -.PP 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 -match, or be greater than the first bytes of \f[C]s2\f[R]. +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[CR]s2\f[R]. diff --git a/man/mariadb_dyncol_column_count.3 b/man/mariadb_dyncol_column_count.3 index 2d4fe142..fa04430b 100644 --- a/man/mariadb_dyncol_column_count.3 +++ b/man/mariadb_dyncol_column_count.3 @@ -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" -.hy +.TH "mariadb_dyncol_column_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_column_count \- Get number of columns in dynamic column blob ## Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_column_count(DYNAMIC_COLUMN *str, unsigned int *column_count); -\f[R] -.fi +.EE .SS Description -.PP Gets the number of columnns in a dynamic column blob. .SS Parameter .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 -\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. .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .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 .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_create_many_named.3 b/man/mariadb_dyncol_create_many_named.3 index 0778f722..d5bde6a9 100644 --- a/man/mariadb_dyncol_create_many_named.3 +++ b/man/mariadb_dyncol_create_many_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_create_many_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_create_many_named \- Creates a dynamic column with named keys .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_create_many_named(DYNAMIC_COLUMN *str, uint column_count, MYSQL_LEX_STRING *column_keys, DYNAMIC_COLUMN_VALUE *values, my_bool new_string); -\f[R] -.fi +.EE .SS Description -.PP Create a dynamic column from arrays of values and names. .SS Parameter .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 -\f[C]column_count\f[R] \- number of columns +\f[CR]column_count\f[R] \- number of columns .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 -\f[C]*values\f[R] \- an array of values +\f[CR]*values\f[R] \- an array of values .IP \[bu] 2 -\f[C]new_string\f[R] \- if set \f[C]str\f[R] will be reinitialized (not -freed) before usage +\f[CR]new_string\f[R] \- if set \f[CR]str\f[R] will be reinitialized +(not freed) before usage .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .IP \[bu] 2 To delete, update or insert new columns into an existing dynamic column -use function +use mariadb_dyncol_update_many_named function .SS See also .IP \[bu] 2 - +mariadb_dyncol_create_many_num .IP \[bu] 2 - +mariadb_dyncol_update_many_named .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_create_many_num.3 b/man/mariadb_dyncol_create_many_num.3 index a49aaba3..d938b2b9 100644 --- a/man/mariadb_dyncol_create_many_num.3 +++ b/man/mariadb_dyncol_create_many_num.3 @@ -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" -.hy +.TH "mariadb_dyncol_create_many_num" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_create_many_num \- Creates a dynamic column with numeric keys .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_create_many_num(DYNAMIC_COLUMN *str, uint column_count, uint *column_numbers, DYNAMIC_COLUMN_VALUE *values, my_bool new_string); -\f[R] -.fi +.EE .SS Description -.PP -Create a dynamic column from arrays of values and numb\['e]rs +Create a dynamic column from arrays of values and numbérs .SS Parameter .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 -\f[C]column_count\f[R] \- number of columns +\f[CR]column_count\f[R] \- number of columns .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 -\f[C]*values\f[R] \- an array of values +\f[CR]*values\f[R] \- an array of values .IP \[bu] 2 -\f[C]new_string\f[R] \- if set \f[C]str\f[R] will be reinitialized (not -freed) before usage +\f[CR]new_string\f[R] \- if set \f[CR]str\f[R] will be reinitialized +(not freed) before usage .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .IP \[bu] 2 To delete, update or insert new columns into an existing dynamic column -use function +use mariadb_dyncol_update_many_num function .SS See also .IP \[bu] 2 - +mariadb_dyncol_create_many_named .IP \[bu] 2 - +mariadb_dyncol_update_many_num .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_exists_named.3 b/man/mariadb_dyncol_exists_named.3 index 7bd54b4b..4cf450fe 100644 --- a/man/mariadb_dyncol_exists_named.3 +++ b/man/mariadb_dyncol_exists_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_exists_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_exists_named \- Check if column with given name exists. .SS Synopsis .IP -.nf -\f[C] -enum enum_dyncol_func_result +.EX +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_exists_named(DYNAMIC_COLUMN *str, MYSQL_LEX_STRING *column_key); -\f[R] -.fi +.EE .SS Description -.PP Checks if a column with the specified column key exists. .SS Parameter .IP \[bu] 2 -\f[C]*str\f[R] \- Dynamic column +\f[CR]*str\f[R] \- Dynamic column .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 -.PP -Returns \f[C]ER_DYNCOL_YES\f[R] if a column with given key exists, -\f[C]ER_DYNCOL_NO\f[R] if no column exists or error. +Returns \f[CR]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. .SS See also .IP \[bu] 2 - +mariadb_dyncol_exists_num .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_exists_num.3 b/man/mariadb_dyncol_exists_num.3 index 638c5d91..e536d428 100644 --- a/man/mariadb_dyncol_exists_num.3 +++ b/man/mariadb_dyncol_exists_num.3 @@ -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" -.hy +.TH "mariadb_dyncol_exists_num" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_exists_num \- Check if column with given number exists. .SS Synopsis .IP -.nf -\f[C] -enum enum_dyncol_func_result +.EX +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_exists_num(DYNAMIC_COLUMN *str, uint column_number); -\f[R] -.fi +.EE .SS Description -.PP Checks if a column with the specified column key exists. .SS Parameter .IP \[bu] 2 -\f[C]*str\f[R] \- Dynamic column +\f[CR]*str\f[R] \- Dynamic column .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 -.PP -Returns \f[C]ER_DYNCOL_YES\f[R] if a column with given number exists, -\f[C]ER_DYNCOL_NO\f[R] if no column exists or error. +Returns \f[CR]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. .SS See also .IP \[bu] 2 - +mariadb_dyncol_exists_named .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_free.3 b/man/mariadb_dyncol_free.3 index 4cee7c60..9f599e88 100644 --- a/man/mariadb_dyncol_free.3 +++ b/man/mariadb_dyncol_free.3 @@ -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" -.hy +.TH "mariadb_dyncol_free" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_free \- Free memory inside packed blob .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mariadb_dyncol_free(DYNAMIC_COLUMN *str) -\f[R] -.fi +.EE .SS Description -.PP Frees memory associated by the specified dynamic column .SS Parameter .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 .IP \[bu] 2 -\f[C]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 +\f[CR]mariadb_dyncol_free()\f[R] doesn\[cq]t free the memory of the +passed \f[CR]DYNAMIC_COLUMN\f[R] structure but all memory of stored columns. .SS See also .IP \[bu] 2 diff --git a/man/mariadb_dyncol_get_named.3 b/man/mariadb_dyncol_get_named.3 index 69153b9c..1509f3bd 100644 --- a/man/mariadb_dyncol_get_named.3 +++ b/man/mariadb_dyncol_get_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_get_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_get_name \- Get value of a column with given key .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_get_named(DYNAMIC_COLUMN *str, LEX_STRING *key, DYNAMIC_COLUMN_VALUE *store_it_here) -\f[R] -.fi +.EE .SS Description -.PP Returns a dynamic column value by given key .SS Parameter .IP \[bu] 2 -\f[C]str\f[R]: Dynamic column +\f[CR]str\f[R]: Dynamic column .IP \[bu] 2 -\f[C]name\f[R]: Name to search for +\f[CR]name\f[R]: Name to search for .IP \[bu] 2 -\f[C]value\f[R]: Value of dynamic column +\f[CR]value\f[R]: Value of dynamic column .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error. If the column name could not be found, value will be NULL .SS See also .IP \[bu] 2 diff --git a/man/mariadb_dyncol_get_num.3 b/man/mariadb_dyncol_get_num.3 index 0224e68e..92966fc0 100644 --- a/man/mariadb_dyncol_get_num.3 +++ b/man/mariadb_dyncol_get_num.3 @@ -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" -.hy +.TH "mariadb_dyncol_get_num" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_get_num \- Get value of a column with given number .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_get_num(DYNAMIC_COLUMN *str, uint column_nr, DYNAMIC_COLUMN_VALUE *store_it_here) -\f[R] -.fi +.EE .SS Description -.PP Returns a dynamic column value by given number .SS Parameter .IP \[bu] 2 -\f[C]str\f[R]: Dynamic column +\f[CR]str\f[R]: Dynamic column .IP \[bu] 2 -\f[C]column_nr\f[R]: Number of column +\f[CR]column_nr\f[R]: Number of column .IP \[bu] 2 -\f[C]value\f[R]: Value of dynamic column +\f[CR]value\f[R]: Value of dynamic column .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error. If the column number could not be found, value will be NULL .SS See also .IP \[bu] 2 diff --git a/man/mariadb_dyncol_has_names.3 b/man/mariadb_dyncol_has_names.3 index 20f3fde5..5d5f075f 100644 --- a/man/mariadb_dyncol_has_names.3 +++ b/man/mariadb_dyncol_has_names.3 @@ -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" -.hy +.TH "mariadb_dyncol_has_names" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_has_names \- Checks if dynamic column uses named keys .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mariadb_dyncol_has_names(DYNAMIC_COLUMN *str) -\f[R] -.fi +.EE .SS Description -.PP Checks if the specified dynamic column uses named keys. .SS Parameter .IP \[bu] 2 -\f[C]str\f[R]: Dynamic column +\f[CR]str\f[R]: Dynamic column .SS Return value -.PP Returns 1 if the specified dynamic column uses named keys, otherwise zero. .SS See also diff --git a/man/mariadb_dyncol_json.3 b/man/mariadb_dyncol_json.3 index 19a74212..11d0a4bd 100644 --- a/man/mariadb_dyncol_json.3 +++ b/man/mariadb_dyncol_json.3 @@ -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" -.hy +.TH "mariadb_dyncol_json" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_json \- Get content of a dynamic column in JSON format .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_json(DYNAMIC_COLUMN *str, DYNAMIC_STRING *json) -\f[R] -.fi +.EE .SS Description -.PP Get content of a dynamic column in JSON format. .SS Parameter .IP \[bu] 2 -\f[C]*str\f[R] \- Dynamic column +\f[CR]*str\f[R] \- Dynamic column .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 .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R]on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R]on success, otherwise error. .SS See also .IP \[bu] 2 \f[B]mariadb_dyncol_list_json(3)\f[R] diff --git a/man/mariadb_dyncol_list_named.3 b/man/mariadb_dyncol_list_named.3 index 64b2cc5e..56b20762 100644 --- a/man/mariadb_dyncol_list_named.3 +++ b/man/mariadb_dyncol_list_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_list_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_list_named \- Lists column keys in dynamic column .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_list_named(DYNAMIC_COLUMN *str, uint *column_count, MYSQL_LEX_STRING **column_keys); -\f[R] -.fi +.EE .SS Description -.PP Lists the column keys inside a dynamic column. .SS Notes .IP \[bu] 2 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 .IP \[bu] 2 -\f[C]*str\f[R] \- Dynamic column +\f[CR]*str\f[R] \- Dynamic column .IP \[bu] 2 -\f[C]*column_count\f[R] \- A pointer to an unsigned integer which stores -the number of columns +\f[CR]*column_count\f[R] \- A pointer to an unsigned integer which +stores the number of columns .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 .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS See also .IP \[bu] 2 - +mariadb_dyncol_list_num .IP \[bu] 2 - +mariadb_dyncol_list_json diff --git a/man/mariadb_dyncol_list_num.3 b/man/mariadb_dyncol_list_num.3 index 0334224b..65afdde5 100644 --- a/man/mariadb_dyncol_list_num.3 +++ b/man/mariadb_dyncol_list_num.3 @@ -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" -.hy +.TH "mariadb_dyncol_list_num" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_list_num \- Lists numeric column keys in dynamic column .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_list_named(DYNAMIC_COLUMN *str, uint *column_count, uint **column_numbers); -\f[R] -.fi +.EE .SS Description -.PP Lists the column numbers inside a dynamic column. .SS Parameter .IP \[bu] 2 -\f[C]*str\f[R] \- Dynamic column +\f[CR]*str\f[R] \- Dynamic column .IP \[bu] 2 -\f[C]*column_count\f[R] \- A pointer to an unsigned integer which stores -the number of columns +\f[CR]*column_count\f[R] \- A pointer to an unsigned integer which +stores the number of columns .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 .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .IP \[bu] 2 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 .IP \[bu] 2 - +mariadb_dyncol_list_named .IP \[bu] 2 - +mariadb_dyncol_list_json diff --git a/man/mariadb_dyncol_unpack.3 b/man/mariadb_dyncol_unpack.3 index 57b80d4c..e033ba27 100644 --- a/man/mariadb_dyncol_unpack.3 +++ b/man/mariadb_dyncol_unpack.3 @@ -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" -.hy +.TH "mariadb_dyncol_unpack" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_unpack \- extracts keys and values of all columns .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_unpack(DYNAMIC_COLUMN *str, uint *column_count, MYSQL_LEX_STRING **column_keys, DYNAMIC_COLUMN_VALUE **values); -\f[R] -.fi +.EE .SS Description -.PP -The \f[C]mariadb_dyncol_unpack()\f[R] function extracts all keys and +The \f[CR]mariadb_dyncol_unpack()\f[R] function extracts all keys and values of a dynamic column. .SS Parameter .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 -\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 .IP \[bu] 2 -\f[C]column_keys\f[R] \- Pointer of an array of -\f[C]MYSQL_LEX_STRING\f[R] structures, which will contain the column +\f[CR]column_keys\f[R] \- Pointer of an array of +\f[CR]MYSQL_LEX_STRING\f[R] structures, which will contain the column keys .IP \[bu] 2 -\f[C]values\f[R] \- Pointer of an array of -\f[C]DYNAMIC_COLUMN_VALUE\f[R] structures, which will contain the +\f[CR]values\f[R] \- Pointer of an array of +\f[CR]DYNAMIC_COLUMN_VALUE\f[R] structures, which will contain the values. .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise an error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise an error. .SS Notes .IP \[bu] 2 -The \f[C]column_keys\f[R] and \f[C]values\f[R] arrays will be allocated -by \f[C]mariadb_dyncol_unpack()\f[R] and must be freed by application. +The \f[CR]column_keys\f[R] and \f[CR]values\f[R] arrays will be +allocated by \f[CR]mariadb_dyncol_unpack()\f[R] and must be freed by +application. .SS See also .IP \[bu] 2 \f[B]mariadb_dyncol_get(3)\f[R] diff --git a/man/mariadb_dyncol_update_many_named.3 b/man/mariadb_dyncol_update_many_named.3 index 81f0f594..85ca0cd4 100644 --- a/man/mariadb_dyncol_update_many_named.3 +++ b/man/mariadb_dyncol_update_many_named.3 @@ -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" -.hy +.TH "mariadb_dyncol_update_many_named" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_update_many_named \- Update, insert or delete values in a dynamic column .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_update_many_named(DYNAMIC_COLUMN *str, uint column_count, MYSQL_LEX_STRING *column_keys, DYNAMIC_COLUMN_VALUE *values) -\f[R] -.fi +.EE .SS Description -.PP Add, delete or update columns in a dynamic column. .SS Parameter .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 -\f[C]column_count\f[R] \- number of columns +\f[CR]column_count\f[R] \- number of columns .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 -\f[C]*values\f[R] \- an array of values +\f[CR]*values\f[R] \- an array of values .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .IP \[bu] 2 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 .IP \[bu] 2 - +mariadb_dyncol_create_many_named .IP \[bu] 2 - +mariadb_dyncol_update_many_num .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_dyncol_update_many_num.3 b/man/mariadb_dyncol_update_many_num.3 index 4d7a3ed3..c87094d4 100644 --- a/man/mariadb_dyncol_update_many_num.3 +++ b/man/mariadb_dyncol_update_many_num.3 @@ -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" -.hy +.TH "mariadb_dyncol_update_many_num" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_dyncol_update_many_num \- Update, insert or delete values in a dynamic column using numeric keys .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -enum enum_dyncol_func_result +\f[B]enum\f[R] enum_dyncol_func_result mariadb_dyncol_update_many_num(DYNAMIC_COLUMN *str, uint column_count, uint *column_keys, DYNAMIC_COLUMN_VALUE *values) -\f[R] -.fi +.EE .SS Description -.PP Add, delete or update columns in a dynamic column with a numeric key. .SS Parameter .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 -\f[C]column_count\f[R] \- number of columns +\f[CR]column_count\f[R] \- number of columns .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 -\f[C]*values\f[R] \- an array of values +\f[CR]*values\f[R] \- an array of values .SS Return value -.PP -Returns \f[C]ER_DYNCOL_OK\f[R] on success, otherwise error. +Returns \f[CR]ER_DYNCOL_OK\f[R] on success, otherwise error. .SS Notes .IP \[bu] 2 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 .IP \[bu] 2 - +mariadb_dyncol_create_many_num .IP \[bu] 2 - +mariadb_dyncol_update_many_named .IP \[bu] 2 -Dynamic Column Error Codes (dyncol_typesanddefs#error-codes) +Dynamic Column Error Codes diff --git a/man/mariadb_field_attr.3 b/man/mariadb_field_attr.3 index 80a2cb8c..90318232 100644 --- a/man/mariadb_field_attr.3 +++ b/man/mariadb_field_attr.3 @@ -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" -.hy +.TH "mariadb_field_attr" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_field_attr \- returns extended metadata information for pluggable field types .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int *mariadb_field_attr(MARIADB_CONST_STRING *attr, const MYSQL_FIELD *field, - enum mariadb_field_attr_t type) -\f[R] -.fi + \f[B]enum\f[R] mariadb_field_attr_t type) +.EE .SS Description -.PP Returns extended metadata information for pluggable field types like JSON and GEOMETRY. .SS Parameter .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 -\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 .IP \[bu] 2 -\f[C]type:\f[R] Specifies type of metadata information. -Supported types are \f[C]MARIADB_FIELD_METADATA_DATA_TYPE_NAME\f[R] and -\f[C]MARIADB_FIELD_METADATA_FORMAT_NAME\f[R]. +\f[CR]type:\f[R] Specifies type of metadata information. +Supported types are \f[CR]MARIADB_FIELD_METADATA_DATA_TYPE_NAME\f[R] and +\f[CR]MARIADB_FIELD_METADATA_FORMAT_NAME\f[R]. .SS Return value -.PP Returns zero on success or non zero if the field doesn\[cq]t provide extended metadata information. .SS Notes @@ -45,41 +39,38 @@ extended server capabilities which can be obtained by api function \f[B]mariadb_get_info(3)\f[R] .SS Example .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int display_extended_field_attribute(MYSQL *mysql) { MYSQL_RES *result; MYSQL_FIELD *fields; - if (mysql_query(mysql, \[dq]CREATE TEMPORARY TABLE t1 (a POINT)\[dq])) - return 1; + \f[B]if\f[R] (mysql_query(mysql, \[dq]CREATE TEMPORARY TABLE t1 (a POINT)\[dq])) + \f[B]return\f[R] 1; - if (mysql_query(mysql, \[dq]SELECT a FROM t1\[dq])) - return 1; + \f[B]if\f[R] (mysql_query(mysql, \[dq]SELECT a FROM t1\[dq])) + \f[B]return\f[R] 1; - if (!(result= mysql_store_result(mysql))) - return 1; + \f[B]if\f[R] (!(result= mysql_store_result(mysql))) + \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; - 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)) { printf(\[dq]Extended field attribute: %s\[rs]n\[dq], field_attr.str); } } mysql_free_result(result); - return 0; + \f[B]return\f[R] 0; } -\f[R] -.fi +.EE .SS History -.PP mariadb_field_attr was added in MariaDB Connector/C 3.1.8 .SS See also .IP \[bu] 2 diff --git a/man/mariadb_free_rpl_event.3 b/man/mariadb_free_rpl_event.3 index e22ba3ff..8fe5eb5e 100644 --- a/man/mariadb_free_rpl_event.3 +++ b/man/mariadb_free_rpl_event.3 @@ -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" -.hy +.TH "mariadb_free_rpl_event" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_free_rpl_event \- free event memory .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mariadb_free_rpl_event(MARIADB_RPL_EVENT *event) -\f[R] -.fi +.EE .SS Description -.PP Frees event memory. .SS Parameter .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]. .SS History -.PP -\f[C]mariadb_free_rpl_event\f[R] was added in MariaDB Connector/C 3.1.0 +\f[CR]mariadb_free_rpl_event\f[R] was added in MariaDB Connector/C 3.1.0 diff --git a/man/mariadb_get_infov.3 b/man/mariadb_get_infov.3 index 309cb936..1ca19011 100644 --- a/man/mariadb_get_infov.3 +++ b/man/mariadb_get_infov.3 @@ -1,29 +1,23 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mariadb_get_infov" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mariadb_get_infov" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP -mariadb_get_infov \- retrieves generic or connection releated -information +mariadb_get_infov \- retrieves generic or connection related information .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mariadb_get_infov(MYSQL * mysql, - enum mariadb_value value, + \f[B]enum\f[R] mariadb_value value, void * arg, ...); -\f[R] -.fi +.EE .SH Description -.PP Retrieves generic or connection specific information. -\f[C]arg\f[R] (and further arguments) must be a pointer to a variable of -the type appropriate for the \f[C]value\f[R] argument. +\f[CR]arg\f[R] (and further arguments) must be a pointer to a variable +of the type appropriate for the \f[CR]value\f[R] argument. The following table shows which variable type to use for each value. .PP .TS @@ -36,77 +30,82 @@ Values T} _ T{ -\f[C]unsigned int\f[R] +\f[CR]unsigned int\f[R] T}@T{ -\f[C]MARIADB_CLIENT_VERSION_ID\f[R], -\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R], -\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R], -\f[C]MARIADB_CONNECTION_ERROR_ID\f[R], -\f[C]MARIADB_CONNECTION_PORT\f[R], -\f[C]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R], -\f[C]MARIADB_CONNECTION_PVIO_TYPE\f[R], -\f[C]MARIADB_CONNECTION_SERVER_STATUS\f[R], -\f[C]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R], -\f[C]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] +\f[CR]MARIADB_CLIENT_VERSION_ID\f[R], +\f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R], +\f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R], +\f[CR]MARIADB_CONNECTION_ERROR_ID\f[R], +\f[CR]MARIADB_CONNECTION_PORT\f[R], +\f[CR]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R], +\f[CR]MARIADB_CONNECTION_PVIO_TYPE\f[R], +\f[CR]MARIADB_CONNECTION_SERVER_STATUS\f[R], +\f[CR]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R], +\f[CR]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] T} T{ -\f[C]unsigned long\f[R] +\f[CR]unsigned long\f[R] T}@T{ -\f[C]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R], -\f[C]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R], -\f[C]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] +\f[CR]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R], +\f[CR]MARIADB_CONNECTION_EXTENDED_SERVER_CAPABILITIES\f[R], +\f[CR]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] T} T{ -\f[C]size_t\f[R] +\f[CR]size_t\f[R] T}@T{ -\f[C]MARIADB_MAX_ALLOWED_PACKET\f[R], -\f[C]MARIADB_NET_BUFFER_LENGTH\f[R] +\f[CR]MARIADB_MAX_ALLOWED_PACKET\f[R], +\f[CR]MARIADB_NET_BUFFER_LENGTH\f[R] T} T{ -\f[C]const char *\f[R] +\f[CR]const char *\f[R] T}@T{ -\f[C]MARIADB_CLIENT_VERSION\f[R], \f[C]MARIADB_TLS_VERSION\f[R], -\f[C]MARIADB_CONNECTION_ERROR\f[R], \f[C]MARIADB_CONNECTION_HOST\f[R], -\f[C]MARIADB_CONNECTION_INFO\f[R], \f[C]MARIADB_CONNECTION_SCHEMA\f[R], -\f[C]MARIADB_CONNECTION_SERVER_TYPE\f[R], -\f[C]MARIADB_CONNECTION_SERVER_VERSION\f[R], -\f[C]MARIADB_CONNECTION_SQLSTATE\f[R], -\f[C]MARIADB_CONNECTION_SSL_CIPHER\f[R], -\f[C]MARIADB_CONNECTION_TLS_VERSION\f[R], -\f[C]MARIADB_CONNECTUION_UNIX_SOCKET\f[R], -\f[C]MARIADB_CONNECTION_USER\f[R], +\f[CR]MARIADB_CLIENT_VERSION\f[R], \f[CR]MARIADB_TLS_LIBRARY\f[R], +\f[CR]MARIADB_CONNECTION_ERROR\f[R], \f[CR]MARIADB_CONNECTION_HOST\f[R], +\f[CR]MARIADB_CONNECTION_INFO\f[R], +\f[CR]MARIADB_CONNECTION_SCHEMA\f[R], +\f[CR]MARIADB_CONNECTION_SERVER_TYPE\f[R], +\f[CR]MARIADB_CONNECTION_SERVER_VERSION\f[R], +\f[CR]MARIADB_CONNECTION_SQLSTATE\f[R], +\f[CR]MARIADB_CONNECTION_SSL_CIPHER\f[R], +\f[CR]MARIADB_CONNECTION_TLS_VERSION\f[R], +\f[CR]MARIADB_CONNECTUION_UNIX_SOCKET\f[R], +\f[CR]MARIADB_CONNECTION_USER\f[R], T} T{ -\f[C]const char **\f[R] +\f[CR]const char **\f[R] T}@T{ -\f[C]MARIADB_CLIENT_ERRORS\f[R] +\f[CR]MARIADB_CLIENT_ERRORS\f[R] T} T{ -\f[C]const *MY_CHARSET_INFO\f[R] +\f[CR]const *MY_CHARSET_INFO\f[R] T}@T{ -\f[C]MARIADB_CHARSET_NAME\f[R], -\f[C]MARIADB_CONNECTION_CHARSET_INFO\f[R] +\f[CR]MARIADB_CHARSET_NAME\f[R], +\f[CR]MARIADB_CONNECTION_CHARSET_INFO\f[R] T} T{ -\f[C]my_socket\f[R] +\f[CR]my_socket\f[R] 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} .TE .SS Value types .SS Generic information -.PP -For these information types parameter \f[C]mysql\f[R] needs to be set to -NULL. +For these information types parameter \f[CR]mysql\f[R] needs to be set +to NULL. .IP \[bu] 2 -\f[C]MARIADB_CHARSET_NAME\f[R] +\f[CR]MARIADB_CHARSET_NAME\f[R] .PD 0 .P .PD Retrieves the charset information for a character set by it\[cq]s literal representation. .IP \[bu] 2 -\f[C]MARIADB_CLIENT_ERRORS\f[R] +\f[CR]MARIADB_CLIENT_ERRORS\f[R] .PD 0 .P .PD @@ -114,212 +113,218 @@ Retrieve array of client errors. This can be used in plugins to set global error messages (which are not exported by MariaDB Connector/C). .IP \[bu] 2 -\f[C]MARIADB_CLIENT_VERSION\f[R] +\f[CR]MARIADB_CLIENT_VERSION\f[R] .PD 0 .P .PD The client version in literal representation. .IP \[bu] 2 -\f[C]MARIADB_CLIENT_VERSION_ID\f[R] +\f[CR]MARIADB_CLIENT_VERSION_ID\f[R] .PD 0 .P .PD The client version in numeric format. .IP \[bu] 2 -\f[C]MARIADB_MAX_ALLOWED_PACKET\f[R] +\f[CR]MARIADB_MAX_ALLOWED_PACKET\f[R] .PD 0 .P .PD Retrieves value of maximum allowed packet size. .IP \[bu] 2 -\f[C]MARIADB_NET_BUFFER_LENGTH\f[R] +\f[CR]MARIADB_NET_BUFFER_LENGTH\f[R] .PD 0 .P .PD Retrieves the length of net buffer. -.IP \[bu] 2 -\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 +.SS Connection and TLS related information For these information types parameter mysql must be represent a valid connection handle which was allocated by \f[B]mysql_init(3)\f[R]. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R] +\f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT\f[R] .PD 0 .P .PD Retrieves the timeout for non blocking calls in seconds. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R] +\f[CR]MARIADB_CONNECTION_ASYNC_TIMEOUT_MS\f[R] .PD 0 .P .PD Retrieves the timeout for non blocking calls in milliseconds. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_CHARSET_INFO\f[R] +\f[CR]MARIADB_CONNECTION_CHARSET_INFO\f[R] .PD 0 .P .PD Retrieves character set information for given connection. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R] +\f[CR]MARIADB_CONNECTION_CLIENT_CAPABILITIES\f[R] .PD 0 .P .PD -Returns the handshak capability flags] of the client. +Returns the capability flags of the client. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_ERROR\f[R] +\f[CR]MARIADB_CONNECTION_ERROR\f[R] .PD 0 .P .PD Retrieves error message for last used command. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_ERROR_ID\f[R] +\f[CR]MARIADB_CONNECTION_ERROR_ID\f[R] .PD 0 .P .PD 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 .P .PD Returns the extended capability flags of the connected MariaDB server .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_HOST\f[R] +\f[CR]MARIADB_CONNECTION_HOST\f[R] .PD 0 .P .PD Returns host name of the connected MariaDB server .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_INFO\f[R] +\f[CR]MARIADB_CONNECTION_INFO\f[R] .PD 0 .P .PD Retrieves generic info for last used command. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_PORT\f[R] +\f[CR]MARIADB_CONNECTION_PORT\f[R] .PD 0 .P .PD Retrieves the port number of server host. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R] +\f[CR]MARIADB_CONNECTION_PROTOCOL_VERSION_ID\f[R] .PD 0 .P .PD Retrieves the protocol version number. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_PVIO_TYPE\f[R] +\f[CR]MARIADB_CONNECTION_PVIO_TYPE\f[R] .PD 0 .P .PD Retrieves the pvio plugin used for specified connection. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SCHEMA\f[R] +\f[CR]MARIADB_CONNECTION_SCHEMA\f[R] .PD 0 .P .PD Retrieves the current schema. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] +\f[CR]MARIADB_CONNECTION_SERVER_CAPABILITIES\f[R] .PD 0 .P .PD Retrievrs the capability flags of the connected server. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SERVER_STATUS\f[R] +\f[CR]MARIADB_CONNECTION_SERVER_STATUS\f[R] .PD 0 .P .PD Returns server status after last operation. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SERVER_TYPE\f[R] +\f[CR]MARIADB_CONNECTION_SERVER_TYPE\f[R] .PD 0 .P .PD Retrieves the type of the server. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SERVER_VERSION\f[R] +\f[CR]MARIADB_CONNECTION_SERVER_VERSION\f[R] .PD 0 .P .PD Retrieves the server version in literal format. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R] +\f[CR]MARIADB_CONNECTION_SERVER_VERSION_ID\f[R] .PD 0 .P .PD Retrieves the server version in numeric format. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SOCKET\f[R] +\f[CR]MARIADB_CONNECTION_SOCKET\f[R] .PD 0 .P .PD Retrieves the handle (socket) for given connection. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SQLSTATE\f[R] +\f[CR]MARIADB_CONNECTION_SQLSTATE\f[R] .PD 0 .P .PD Retrieves current sqlstate information for last used command. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_SSL_CIPHER\f[R] +\f[CR]MARIADB_CONNECTION_SSL_CIPHER\f[R] .PD 0 .P .PD Retrieves the TLS/SSL cipher in use. .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 .P .PD Retrieves the TLS protocol version used in literal format. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] +\f[CR]MARIADB_CONNECTION_TLS_VERSION_ID\f[R] .PD 0 .P .PD Retrieves the TLS protocol version used in numeric format. .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_UNIX_SOCKET\f[R] +\f[CR]MARIADB_CONNECTION_UNIX_SOCKET\f[R] .PD 0 .P .PD Retrieves the file name of the unix socket .IP \[bu] 2 -\f[C]MARIADB_CONNECTION_USER\f[R] +\f[CR]MARIADB_CONNECTION_USER\f[R] .PD 0 .P .PD 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 -.PP Returns zero on success, non zero if an error occurred (e.g.\ if an invalid option was specified), .SS Source file -.IP -.nf -\f[C] - -## History +\f[CR]libmariadb/mariadb_lib.c\f[R] +.SS History This function was added in MariaDB Connector/C 3.0, - -## 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); +.SS Examples .IP -.nf -\f[C] -\f[R] -.fi -.PP -/* get user name for current connection \f[I]/ const char \f[R]user; -mariadb_get_infov(mysql, MARIADB_CONNECTION_USER, (void \f[I])&user); -\[ga]\[ga]\[ga] ## See also \f[R] \f[B]mysql_get_optionv(3)\f[R] +.EX +/* get server port for current connection */ +unsigned int port; +mariadb_get_infov(mysql, MARIADB_CONNECTION_PORT, (void *)&port); +.EE +.IP +.EX +/* 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] diff --git a/man/mariadb_reconnect.3 b/man/mariadb_reconnect.3 index 3a89b545..738bfd6a 100644 --- a/man/mariadb_reconnect.3 +++ b/man/mariadb_reconnect.3 @@ -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" -.hy +.TH "mariadb_reconnect" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_reconnect \- reconnects to a server .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mariadb_reconnect(MYSQL * mysql) -\f[R] -.fi +.EE .SS Description -.PP -\f[C]mariadb_reconnect()\f[R] tries to reconnect to a server in case the -connection died due to timeout or other errors. +\f[CR]mariadb_reconnect()\f[R] tries to reconnect to a server in case +the connection died due to timeout or other errors. It uses the same credentials which were specified in \f[B]mysql_real_connect(3)\f[R]. .SS Return value -.PP -The function will return 0 on sucess, a non zero value on error +The function will return 0 on success, a non zero value on error .PP \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 -.PP -\f[C]mariadb_reconnect()\f[R] was added in MariaDB Connector/C 3.0 +\f[CR]mariadb_reconnect()\f[R] was added in MariaDB Connector/C 3.0 .SS See also .IP \[bu] 2 \f[B]mysql_real_connect(3)\f[R] diff --git a/man/mariadb_rpl_close.3 b/man/mariadb_rpl_close.3 index cc7b9893..373bf384 100644 --- a/man/mariadb_rpl_close.3 +++ b/man/mariadb_rpl_close.3 @@ -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" -.hy +.TH "mariadb_rpl_close" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_rpl_close \- Closes replication stream .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mariadb_rpl_close(MARIADB_RPL *rpl) -\f[R] -.fi +.EE .SS Description -.PP Closes a replication stream. .SS Parameter -.PP -\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_open(3)\f[R]. .SS Notes -.PP To close the connection to the server, the api function \f[B]mariadb_close(3)\f[R] must be called. .SS History -.PP -\f[C]mariadb_rpl_close\f[R] was added in MariaDB Connector/C 3.1 +\f[CR]mariadb_rpl_close\f[R] was added in MariaDB Connector/C 3.1 diff --git a/man/mariadb_rpl_fetch.3 b/man/mariadb_rpl_fetch.3 index 38c77636..12eac0dd 100644 --- a/man/mariadb_rpl_fetch.3 +++ b/man/mariadb_rpl_fetch.3 @@ -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" -.hy +.TH "mariadb_rpl_fetch" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_rpl_fetch \- fetches next event from replication stream .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MARIADB_RPL_EVENT *mariadb_rpl_fetch(MARIADB_RPL *rpl, MARIADB_RPL_EVENT *event) -\f[R] -.fi +.EE .SS Description -.PP Fetches one event from the replication stream .SS Parameter .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_open(3)\f[R]. .IP \[bu] 2 -\f[C]event\f[R] \- An event which was returned by a previous call to -\f[C]mariadb_rpl_fetch\f[R]. -If this value is \f[C]NULL\f[R] the function will allocate new memory +\f[CR]event\f[R] \- An event which was returned by a previous call to +\f[CR]mariadb_rpl_fetch\f[R]. +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. .SS Return value -.PP An event handle or NULL if EOF packet was received. .SS Notes -.PP Event memory needs to be freed by calling \f[B]mariadb_rpl_free_event(3)\f[R]. .SS See also .IP \[bu] 2 \f[B]mariadb_rpl_free_event(3)\f[R] .SS History -.PP -\f[C]mariadb_rpl_fetch\f[R] was added in MariaDB Connector/C 3.1.0 +\f[CR]mariadb_rpl_fetch\f[R] was added in MariaDB Connector/C 3.1.0 diff --git a/man/mariadb_rpl_get_optionsv.3 b/man/mariadb_rpl_get_optionsv.3 index a0520e60..4394e7ec 100644 --- a/man/mariadb_rpl_get_optionsv.3 +++ b/man/mariadb_rpl_get_optionsv.3 @@ -1,26 +1,23 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mariadb_rpl_get_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mariadb_rpl_get_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_rpl_get_optionsv \- get replication option value .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -int mariadb_rpl_get_optionsv(MARIADB_RPL *rpl, enum mariadb_rpl_option option, ...) -\f[R] -.fi +int mariadb_rpl_get_optionsv(MARIADB_RPL *rpl, \f[B]enum\f[R] mariadb_rpl_option option, ...) +.EE .SS Parameter .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 .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 .TS tab(@); @@ -61,14 +58,20 @@ uint32_t * T}@T{ Flags 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 .SS Return value -.PP Returns zero on success, non zero on error. .SS See also .IP \[bu] 2 \f[B]mariadb_rpl_optionsv(3)\f[R] .SS History -.PP -\f[C]mariadb_rpl_get_optionsv\f[R] was added in MariaDB Connector/C +\f[CR]mariadb_rpl_get_optionsv\f[R] was added in MariaDB Connector/C 3.1.0 diff --git a/man/mariadb_rpl_open.3 b/man/mariadb_rpl_open.3 index babaa19b..b451238a 100644 --- a/man/mariadb_rpl_open.3 +++ b/man/mariadb_rpl_open.3 @@ -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" -.hy +.TH "mariadb_rpl_open" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_rpl_open \- opens a replication stream .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mariadb_rpl_open(MARIADB_RPL *rpl) -\f[R] -.fi +.EE .SS Description -.PP Opens a replication stream .SS Parameter .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]. .SS Return value -.PP Zero on success, nonzero on error. .SS History -.PP -\f[C]mariadb_rpl_open\f[R] was added in MariaDB Connector/C 3.1.0 +\f[CR]mariadb_rpl_open\f[R] was added in MariaDB Connector/C 3.1.0 diff --git a/man/mariadb_rpl_optionsv.3 b/man/mariadb_rpl_optionsv.3 index ac231a7a..c9f275f9 100644 --- a/man/mariadb_rpl_optionsv.3 +++ b/man/mariadb_rpl_optionsv.3 @@ -1,30 +1,27 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mariadb_rpl_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mariadb_rpl_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_rpl_optionsv \- sets replication options .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] -int mariadb_rpl_optionsv(MARIADB_RPL *rpl, enum mariadb_rpl_option option, ...) -\f[R] -.fi +int mariadb_rpl_optionsv(MARIADB_RPL *rpl, \f[B]enum\f[R] mariadb_rpl_option option, ...) +.EE .SS Parameter .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 .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 .TS tab(@); -l l l. +lw(23.3n) lw(23.3n) lw(23.3n). T{ Option T}@T{ @@ -61,9 +58,36 @@ uint32_t T}@T{ Flags 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 .SS Return value -.PP Returns zero on success, non zero on error. .SS See also .IP \[bu] 2 @@ -71,5 +95,4 @@ Returns zero on success, non zero on error. .IP \[bu] 2 \f[B]mariadb_rpl_open(3)\f[R] .SS History -.PP -\f[C]mariadb_rpl_optionsv\f[R] was added in MariaDB Connector/C 3.1.0 +\f[CR]mariadb_rpl_optionsv\f[R] was added in MariaDB Connector/C 3.1.0 diff --git a/man/mariadb_stmt_execute_direct.3 b/man/mariadb_stmt_execute_direct.3 index b441a9e9..231a6817 100644 --- a/man/mariadb_stmt_execute_direct.3 +++ b/man/mariadb_stmt_execute_direct.3 @@ -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" -.hy +.TH "mariadb_stmt_execute_direct" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_stmt_execute_direct \- prepares and executes a prepared statement .SS Synopsis .IP -.nf -\f[C] +.EX #include int mariadb_stmt_execute_direct(MYSQL_STMT * stmt, const char *query, size_t length); -\f[R] -.fi +.EE .SS Description -.PP 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 variables if any parameters exist in the statement. .SS Parameters .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]. .IP \[bu] 2 -\f[C]query\f[R] SQL statement +\f[CR]query\f[R] SQL statement .IP \[bu] 2 -\f[C]length\f[R] Length of SQL statement +\f[CR]length\f[R] Length of SQL statement .SS Return value -.PP Returns zero on success, non\-zero on failure. .SS Notes .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. .IP \[bu] 2 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 The statement handle is intended for one\-time execution. Reusing the statement handle might lead to unexpected behavior. .SS History -.PP This function was added in Connector/C 3.0 and requires MariaDB 10.2 or later versions. .SS See Also @@ -54,7 +47,6 @@ later versions. .IP \[bu] 2 \f[B]mysql_stmt_bind_param(3)\f[R] .SS Example -.PP \[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 intval= 1; int param_count= 2; char *strval= diff --git a/man/mariadb_stmt_fetch_fields.3 b/man/mariadb_stmt_fetch_fields.3 index dbd68de1..74591146 100644 --- a/man/mariadb_stmt_fetch_fields.3 +++ b/man/mariadb_stmt_fetch_fields.3 @@ -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" -.hy +.TH "mariadb_stmt_fetch_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mariadb_stmt_fetch_fields \- Returns an array of fields containing the column definitions ## Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD *mariadb_stmt_fetch_fields(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns an array of fields. 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 returned. .SS Parameter .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]. .SS Notes -.PP The number of fields can be obtained by \f[B]mysql_stmt_field_count(3)\f[R] .SS History -.PP This function was added in MariaDB Connector/C 3.1.0 .SS See Also -.PP *\f[B]mysql_stmt_field_count(3)\f[R] diff --git a/man/mysql_affected_rows.3 b/man/mysql_affected_rows.3 index c408ed78..a6cfdae2 100644 --- a/man/mysql_affected_rows.3 +++ b/man/mysql_affected_rows.3 @@ -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" -.hy +.TH "mysql_affected_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_affected_rows \- returns the number of rows affected by the last operation .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_ulonglong mysql_affected_rows(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP 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], -\f[C]UPDATE\f[R], \f[C]DELETE\f[R] or \f[C]REPLACE\f[R]) statement, or -\-1 if the last operation failed. +with mysql, if the operation was an \[lq]upsert\[rq] (\f[CR]INSERT\f[R], +\f[CR]UPDATE\f[R], \f[CR]DELETE\f[R] or \f[CR]REPLACE\f[R]) statement, +or \-1 if the last operation failed. .SS Parameters: -.PP -\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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes: .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. This creates the possibility that mysql_affected_rows may not actually equal the number of rows matched, only the number of rows that were literally affected by the query. .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. This function returns the number of deleted records in addition to the number of inserted records. .SH Return value -.PP Returns the number of affected rows or \-1 on error. .SS See also .IP \[bu] 2 diff --git a/man/mysql_autocommit.3 b/man/mysql_autocommit.3 index 9b12b9de..e316f19b 100644 --- a/man/mysql_autocommit.3 +++ b/man/mysql_autocommit.3 @@ -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" -.hy +.TH "mysql_autocommit" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_autocommit \- Toggles autocommit mode .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_autocommit(MYSQL * mysql, my_bool auto_mode); -\f[R] -.fi +.EE .SS Description -.PP Toggles autocommit mode on or off for the current database connection. Autocommit mode will be set if mode=1 or unset if mode=0. .SS Parameters: .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 \f[B]mysql_real_connect(3)\f[R]. .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 .IP \[bu] 2 Autocommit mode only affects operations on transactional table types. 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). .IP \[bu] 2 Be aware: the [mysql_rollback()}(mysql_rollback() function will not work @@ -37,46 +32,42 @@ if autocommit mode is switched on. .SS Examples .SS SQL .IP -.nf -\f[C] -# Turn of autocmmit -SET AUTOCOMMIT=0; +.EX +# Turn \f[B]off\f[R] autocommit +\f[B]SET\f[R] AUTOCOMMIT=0; # Retrieve autocommit -SELECT \[at]\[at]autocommit; -+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\f[B]SELECT\f[R] \[at]\[at]autocommit; ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] | \[at]\[at]autocommit | -+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] | 0 | -+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ -\f[R] -.fi ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] +.EE .SS MariaDB Connector/C .IP -.nf -\f[C] +.EX static int test_autocommit(MYSQL *mysql) { int rc; unsigned int server_status; - /* Turn autocommit off */ + \f[I]/* Turn autocommit off */\f[R] rc= mysql_autocommit(mysql, 0); - if (rc) - return rc; /* Error */ + \f[B]if\f[R] (rc) + \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); - if (rc) - return rc; /* Error */ + \f[B]if\f[R] (rc) + \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]); - return 1; + \f[B]return\f[R] 1; } printf(\[dq]OK: autocommit is off\[rs]n\[dq]); - return 0; + \f[B]return\f[R] 0; } -\f[R] -.fi +.EE diff --git a/man/mysql_change_user.3 b/man/mysql_change_user.3 index 8f9939b8..22f8f356 100644 --- a/man/mysql_change_user.3 +++ b/man/mysql_change_user.3 @@ -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" -.hy +.TH "mysql_change_user" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_change_user \- changes user and default database .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_change_user(MYSQL * mysql, const char * user, const char * passwd, const char * db); -\f[R] -.fi +.EE .SS Description -.PP Changes the user and default database of the current connection. .PP 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. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .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 -\f[C]passwd\f[R] \- the password for server authentication +\f[CR]passwd\f[R] \- the password for server authentication .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 user and not selecting a database. 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. .IP \[bu] 2 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 -in a row +block the connection if \f[CR]mysql_change_user()\f[R] failed three +times in a row .SS Return value -.PP Returns zero on success, nonzero if an error occurred. .SS See also .IP \[bu] 2 diff --git a/man/mysql_close.3 b/man/mysql_close.3 index 7d212ac4..5ea3155d 100644 --- a/man/mysql_close.3 +++ b/man/mysql_close.3 @@ -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" -.hy +.TH "mysql_close" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_close \- Closes a previously opened connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_close(MYSQL *mysql); -\f[R] -.fi +.EE .SS Description -.PP Closes a previously opened connection and deallocates all memory. .SS Notes .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]. .SS See also .IP \[bu] 2 diff --git a/man/mysql_commit.3 b/man/mysql_commit.3 index a35b234f..a5a116c7 100644 --- a/man/mysql_commit.3 +++ b/man/mysql_commit.3 @@ -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" -.hy +.TH "mysql_commit" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_commit \- Commits the current transaction .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_commit(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Commits the current transaction for the specified database connection. Returns zero on success, nonzero if an error occurred. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP Executing mysql_commit() will not affected the behaviour of autocommit. This means, any update or insert statements following mysql_commit() will be rolled back when the connection gets closed. diff --git a/man/mysql_data_seek.3 b/man/mysql_data_seek.3 index 7b4f0555..fac5b921 100644 --- a/man/mysql_data_seek.3 +++ b/man/mysql_data_seek.3 @@ -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" -.hy +.TH "mysql_data_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_data_seek \- seeks to an offset .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_data_seek(MYSQL_RES * result, my_ulonglong offset); -\f[R] -.fi +.EE .SS Description -.PP The mysql_data_seek() function seeks to an arbitrary function result pointer specified by the offset in the result set. Returns zero on success, nonzero if an error occurred. .SS Parameters .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(). .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 (0..mysql_num_rows \- 1). .SS Notes -.PP 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. .SS See also diff --git a/man/mysql_eof.3 b/man/mysql_eof.3 index ca5da9bd..cc6e7365 100644 --- a/man/mysql_eof.3 +++ b/man/mysql_eof.3 @@ -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" -.hy +.TH "mysql_eof" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_eof \- determines if the last row of a result set has been read .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_eof(MYSQL_RES *result); -\f[R] -.fi +.EE .SS Description -.PP Determines if the last row of a result set has been read. .PP \f[B]Notes:\f[R] * This function is deprecated and will be removed. diff --git a/man/mysql_errno.3 b/man/mysql_errno.3 index c99a9e2c..7b5b68c0 100644 --- a/man/mysql_errno.3 +++ b/man/mysql_errno.3 @@ -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" -.hy +.TH "mysql_errno" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_errno \- returns the last error code for the most recent function call .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_errno(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the last error code for the most recent function call that can succeed or fail. Zero means no error occurred. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes .IP \[bu] 2 -Client error codes are listed in \f[C]errmsg.h\f[R] header file, server -error codes are listed in \f[C]mysqld_error.h\f[R] header file of the +Client error codes are listed in \f[CR]errmsg.h\f[R] header file, server +error codes are listed in \f[CR]mysqld_error.h\f[R] header file of the server source distribution. .SS See also .IP \[bu] 2 diff --git a/man/mysql_error.3 b/man/mysql_error.3 index a156a5af..fb7f7980 100644 --- a/man/mysql_error.3 +++ b/man/mysql_error.3 @@ -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" -.hy +.TH "mysql_error" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_error \- returns the last error message for the most recent function call .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_error(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the last error message for the most recent function call that can succeed or fail. An empty string means no error occurred. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes .IP \[bu] 2 -Client error codes are listed in \f[C]errmsg.h\f[R] header file, server -error codes are listed in \f[C]mysqld_error.h\f[R] header file of the +Client error codes are listed in \f[CR]errmsg.h\f[R] header file, server +error codes are listed in \f[CR]mysqld_error.h\f[R] header file of the server source distribution. .IP \[bu] 2 Client error messages can be obtained by calling \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 .IP \[bu] 2 \f[B]mysql_errno(3)\f[R] diff --git a/man/mysql_fetch_field.3 b/man/mysql_fetch_field.3 index bb3e7e3c..e22e6a0f 100644 --- a/man/mysql_fetch_field.3 +++ b/man/mysql_fetch_field.3 @@ -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" -.hy +.TH "mysql_fetch_field" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_fetch_field \- Returns the definition of one column of a result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD * mysql_fetch_field(MYSQL_RES * result); -\f[R] -.fi +.EE .SS Description -.PP Returns the definition of one column of a result set as a pointer to a MYSQL_FIELD structure. Call this function repeatedly to retrieve information about all columns in the result set. .SS Parameters .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]. .SS Notes .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 obtained by \f[B]mysql_fetch_field_direct(3)\f[R] function. .SS Return value -.PP -a pointer of a \f[C]MYSQL_FIELD\f[R] structure, or NULL if there are no +a pointer of a \f[CR]MYSQL_FIELD\f[R] structure, or NULL if there are no more fields. .SS See also .IP \[bu] 2 diff --git a/man/mysql_fetch_field_direct.3 b/man/mysql_fetch_field_direct.3 index cc5d03ed..6b8f15c6 100644 --- a/man/mysql_fetch_field_direct.3 +++ b/man/mysql_fetch_field_direct.3 @@ -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" -.hy +.TH "mysql_fetch_field_direct" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_fetch_field_direct \- Returns a pointer to a MYSQL_FIELD structure .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD * mysql_fetch_field_direct(MYSQL_RES * res, unsigned int fieldnr); -\f[R] -.fi +.EE .SS Description -.PP -Returns a pointer to a \f[C]MYSQL_FIELD\f[R] structure which contains +Returns a pointer to a \f[CR]MYSQL_FIELD\f[R] structure which contains 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[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 ### Notes * The total number of fields can be obtained by mysql_field_count() .SS Return value -.PP -Pointer to a \f[C]MYSQL_FIELD\f[R] structure or \f[C]NULL\f[R] if an +Pointer to a \f[CR]MYSQL_FIELD\f[R] structure or \f[CR]NULL\f[R] if an invalid field number was specified .SS See also .IP \[bu] 2 diff --git a/man/mysql_fetch_fields.3 b/man/mysql_fetch_fields.3 index cb9c2a22..58ef8839 100644 --- a/man/mysql_fetch_fields.3 +++ b/man/mysql_fetch_fields.3 @@ -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" -.hy +.TH "mysql_fetch_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_fetch_fields \- returns an array of fields .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD * mysql_fetch_fields(MYSQL_RES * res); -\f[R] -.fi +.EE .SS Description -.PP This function serves an identical purpose to the \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 @@ -23,15 +18,13 @@ returned as an array. Each field contains the definition for a column of the result set. .SS Parameters .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]. .SS Notes -.PP The total number of fields can be obtained by \f[B]mysql_field_count(3)\f[R]. .SS Return value -.PP -an array of type \f[C]MYSQL_FIELD\f[R]. +an array of type \f[CR]MYSQL_FIELD\f[R]. .SS See also .IP \[bu] 2 \f[B]mysql_fetch_field(3)\f[R] diff --git a/man/mysql_fetch_lengths.3 b/man/mysql_fetch_lengths.3 index deb99605..68442c50 100644 --- a/man/mysql_fetch_lengths.3 +++ b/man/mysql_fetch_lengths.3 @@ -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" -.hy +.TH "mysql_fetch_lengths" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_fetch_lengths \- returns an array of length values for the current row .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long * mysql_fetch_lengths(MYSQL_RES * result); -\f[R] -.fi +.EE .SS Description -.PP -The \f[C]mysql_fetch_lengths()\f[R] function returns an array containing -the lengths of every column of the current row within the result set -(not including terminating zero character) or \f[C]NULL\f[R] if an error -occurred. +The \f[CR]mysql_fetch_lengths()\f[R] function returns an array +containing the lengths of every column of the current row within the +result set (not including terminating zero character) or \f[CR]NULL\f[R] +if an error occurred. .SS Parameter .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]. -### 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. -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. .SS Return value -.PP An array of unsigned long values . The size of the array can be determined by the number of fields in current result set. diff --git a/man/mysql_fetch_row.3 b/man/mysql_fetch_row.3 index 2c20bf70..ffc258df 100644 --- a/man/mysql_fetch_row.3 +++ b/man/mysql_fetch_row.3 @@ -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" -.hy +.TH "mysql_fetch_row" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_fetch_row \- fetches row of data from result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_ROW mysql_fetch_row(MYSQL_RES * result); -\f[R] -.fi +.EE .SS Description -.PP 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). Each subsequent call to this function will return the next row within the result set, or NULL if there are no more rows. .SS Parameter .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]. .SS Notes .IP \[bu] 2 -If a column contains a \f[C]NULL\f[R] value the corresponding char -pointer will be set to \f[C]NULL\f[R]. +If a column contains a \f[CR]NULL\f[R] value the corresponding char +pointer will be set to \f[CR]NULL\f[R]. .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. .SS Return value -.PP -A \f[C]MYSQL_ROW\f[R] structure (array of character pointers) +A \f[CR]MYSQL_ROW\f[R] structure (array of character pointers) 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 .IP \[bu] 2 \f[B]mysql_use_result(3)\f[R] diff --git a/man/mysql_field_count.3 b/man/mysql_field_count.3 index ad3144c6..f3867c57 100644 --- a/man/mysql_field_count.3 +++ b/man/mysql_field_count.3 @@ -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" -.hy +.TH "mysql_field_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_field_count \- returns the number of columns for the most recent statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_field_count(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of columns for the most recent statement on the connection represented by the link parameter as an unsigned integer. 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. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP -The \f[C]mysql_field_count()\f[R] function should be used to determine +The \f[CR]mysql_field_count()\f[R] function should be used to determine if there is a result set available. .SS Return value: -.PP -The number of columns for the most recent statemet. -The value is zero, if the statemet didn\[cq]t produce a result set. +The number of columns for the most recent statement. +The value is zero, if the statement didn\[cq]t produce a result set. .SS See also .IP \[bu] 2 \f[B]mysql_store_result(3)\f[R] diff --git a/man/mysql_field_seek.3 b/man/mysql_field_seek.3 index 364909aa..0ea3540d 100644 --- a/man/mysql_field_seek.3 +++ b/man/mysql_field_seek.3 @@ -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" -.hy +.TH "mysql_field_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_field_seek \- sets the field cursor to given offset .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES * result, MYSQL_FIELD_OFFSET offset); -\f[R] -.fi +.EE .SS Description -.PP Sets the field cursor to the given offset. The next call to \f[B]mysql_fetch_field(3)\f[R] will retrieve the field definition of the column associated with that offset. .SS Parameters .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]. .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 -\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 .IP \[bu] 2 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 zero. .SS Return value -.PP Returns the previous value of the field cursor .SS See also .IP \[bu] 2 diff --git a/man/mysql_field_tell.3 b/man/mysql_field_tell.3 index ca0c6f8b..a35b5a81 100644 --- a/man/mysql_field_tell.3 +++ b/man/mysql_field_tell.3 @@ -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" -.hy +.TH "mysql_field_tell" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_field_tell \- Returns offset of the field cursor .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES * result); -\f[R] -.fi +.EE .SS Description -.PP Return the offset of the field cursor used for the last \f[B]mysql_fetch_field(3)\f[R] call. This value can be used as a parameter for the function \f[B]mysql_field_seek(3)\f[R]. .SS Parameter .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]. .SS Return value -.PP Returns the current offset of the field cursor .SS See also .IP \[bu] 2 diff --git a/man/mysql_free_result.3 b/man/mysql_free_result.3 index 4c138ea5..b0e587ff 100644 --- a/man/mysql_free_result.3 +++ b/man/mysql_free_result.3 @@ -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" -.hy +.TH "mysql_free_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_free_result \- Frees result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_free_result(MYSQL_RES * result); -\f[R] -.fi +.EE .SS Description -.PP Frees the memory associated with a result set. Returns void. .SS Parameters .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]. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_get_character_set_info.3 b/man/mysql_get_character_set_info.3 index 3b9ef2f3..f29d6d29 100644 --- a/man/mysql_get_character_set_info.3 +++ b/man/mysql_get_character_set_info.3 @@ -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" -.hy +.TH "mysql_get_character_set_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_character_set_info \- returns character set information .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_get_character_set_info(MYSQL * mysql, MY_CHARSET_INFO * charset); -\f[R] -.fi +.EE .SS Description -.PP Returns information about the current default character set for the specified connection. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]charset\f[R] \- a pointer to a \f[C]MY_CHARSET_INFO\f[R] structure, -in which the information will be copied. +\f[CR]charset\f[R] \- a pointer to a \f[CR]MY_CHARSET_INFO\f[R] +structure, in which the information will be copied. .SS Notes .IP \[bu] 2 A complete list of supported character sets in the client library is diff --git a/man/mysql_get_client_info.3 b/man/mysql_get_client_info.3 index 59646f38..d980f6bf 100644 --- a/man/mysql_get_client_info.3 +++ b/man/mysql_get_client_info.3 @@ -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" -.hy +.TH "mysql_get_client_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_client_info \- returns client library version as string representation .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_get_client_info(void ); -\f[R] -.fi +.EE .SS Description -.PP Returns a string representing the client library version .SS Notes -.PP To obtain the numeric value of the client library version use \f[B]mysql_get_client_version(3)\f[R]. .SS See also diff --git a/man/mysql_get_client_version.3 b/man/mysql_get_client_version.3 index 8c1fea4a..a206ad77 100644 --- a/man/mysql_get_client_version.3 +++ b/man/mysql_get_client_version.3 @@ -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" -.hy +.TH "mysql_get_client_version" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_client_version \- returns client version number .SS Synopsis .IP -.nf -\f[C] +.EX unsigned long mysql_get_client_version(void); -\f[R] -.fi +.EE .SS Description -.PP Returns a number representing the client library version. The value has the format XXYYZZ: major version * 10000 + minor 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 package version. 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 -.PP A long integer representing the client version .SS See also .IP \[bu] 2 diff --git a/man/mysql_get_host_info.3 b/man/mysql_get_host_info.3 index 9e0cf94e..c441df38 100644 --- a/man/mysql_get_host_info.3 +++ b/man/mysql_get_host_info.3 @@ -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" -.hy +.TH "mysql_get_host_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_host_info \- Returns host information .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_get_host_info(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Describes the type of connection in use for the connection, including the server host name. Returns a string, or NULL if the connection is not valid. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Return value -.PP -Returns a string, describing host information or \f[C]NULL\f[R] if the +Returns a string, describing host information or \f[CR]NULL\f[R] if the connection is not valid. .SS See also .IP \[bu] 2 diff --git a/man/mysql_get_proto_info.3 b/man/mysql_get_proto_info.3 index 6bc26f18..617b3bf7 100644 --- a/man/mysql_get_proto_info.3 +++ b/man/mysql_get_proto_info.3 @@ -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" -.hy +.TH "mysql_get_proto_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_proto_info \- Returns protocol version number .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_get_proto_info(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the protocol version number for the specified connection .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP MariaDB Connector/C doesn\[cq]t support protocol version 9 and prior. .SS Return value -.PP The protocol version number in use .SS See also .IP \[bu] 2 diff --git a/man/mysql_get_server_info.3 b/man/mysql_get_server_info.3 index 6f1d569a..c8b5e9cd 100644 --- a/man/mysql_get_server_info.3 +++ b/man/mysql_get_server_info.3 @@ -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" -.hy +.TH "mysql_get_server_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_server_info \- Returns server version as string .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_get_server_info(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP -Returns the server version or \f[C]NULL\f[R] on failure. +Returns the server version or \f[CR]NULL\f[R] on failure. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP To obtain the numeric server version please use \f[B]mysql_get_server_version(3)\f[R]. .SS Return value -.PP -Returns the server version as zero terminated string or \f[C]NULL\f[R]on -failure. +Returns the server version as zero terminated string or +\f[CR]NULL\f[R]on failure. .SS See also .IP \[bu] 2 \f[B]mysql_get_server_info(3)\f[R] diff --git a/man/mysql_get_server_version.3 b/man/mysql_get_server_version.3 index a74ab808..30191372 100644 --- a/man/mysql_get_server_version.3 +++ b/man/mysql_get_server_version.3 @@ -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" -.hy +.TH "mysql_get_server_version" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_server_version \- returns numeric server version .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long mysql_get_server_version(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns an integer representing the version of connected server. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP The form of the version number is VERSION_MAJOR * 10000 + VERSION_MINOR * 100 + VERSION_PATCH. .SS Return value -.PP The version number of the connected server .SS See also .IP \[bu] 2 diff --git a/man/mysql_get_socket.3 b/man/mysql_get_socket.3 index a68e5e4f..c25e00d4 100644 --- a/man/mysql_get_socket.3 +++ b/man/mysql_get_socket.3 @@ -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" -.hy +.TH "mysql_get_socket" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_socket \- Returns the descriptor of the socket used for the current connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_socket mysql_get_socket(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the descriptor of the socket used for the current connection. .SS Parameter .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_real_connect(3)\f[R]. .SS Return value -.PP 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 connection. diff --git a/man/mysql_get_ssl_cipher.3 b/man/mysql_get_ssl_cipher.3 index 5305d562..d033afad 100644 --- a/man/mysql_get_ssl_cipher.3 +++ b/man/mysql_get_ssl_cipher.3 @@ -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" -.hy +.TH "mysql_get_ssl_cipher" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_get_ssl_cipher \- returns the cipher suite in use .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char *mysql_get_ssl_cipher(MYSQL *mysql) -\f[R] -.fi +.EE .SS Description -.PP Returns the name of the currently used cipher suite of the secure connection, or NULL for non TLS connections. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes .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. .IP \[bu] 2 \[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 Schannel) the name of the cipher suites may differ. For example the cipher suite 0x002F -(\f[C]TLS_RSA_WITH_AES_128_CBC_SHA\f[R]) has different names: -\f[C]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_WITH_AES_128_CBC_SHA\f[R]) has different names: +\f[CR]AES128\-SHA\f[R] for OpenSSL and Schannel and +\f[CR]TLS_RSA_AES_128_CBC_SHA1\f[R] for GnuTLS. .SS Return value -.PP 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. .SS See also .IP \[bu] 2 diff --git a/man/mysql_hex_string.3 b/man/mysql_hex_string.3 index da116595..e87b86a5 100644 --- a/man/mysql_hex_string.3 +++ b/man/mysql_hex_string.3 @@ -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" -.hy +.TH "mysql_hex_string" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_hex_string \- create a hexadecimal string .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long mysql_hex_string(char * to, const char * from, unsigned long len); -\f[R] -.fi +.EE .SS Description -.PP This function is used to create a hexadecimal string which can be used 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 .IP \[bu] 2 -\f[C]to\f[R] \- result buffer +\f[CR]to\f[R] \- result buffer .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 -\f[C]len\f[R] \- length of the string (from) +\f[CR]len\f[R] \- length of the string (from) .SS Notes .IP \[bu] 2 The size of the buffer for the encoded string must be 2 * length + 1. .IP \[bu] 2 The encoded string does not contain a leading X\[cq]. .SS Return value -.PP Returns the length of the encoded string without the trailing null character. .SS See also diff --git a/man/mysql_info.3 b/man/mysql_info.3 index 2b9cea23..105858b3 100644 --- a/man/mysql_info.3 +++ b/man/mysql_info.3 @@ -1,36 +1,29 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_info" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_info" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_info \- provides information about the last executed statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_info(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP -The \f[C]mysql_info()\f[R] function returns a string providing +The \f[CR]mysql_info()\f[R] function returns a string providing information about the last statement executed. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP 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. .SS Return value -.PP Zero terminated information string. The information depends on statement type: .PP @@ -44,27 +37,27 @@ Example result string T} _ T{ -\f[C]INSERT INTO...SELECT...\f[R] +\f[CR]INSERT INTO...SELECT...\f[R] T}@T{ Records: 100 Duplicates: 0 Warnings: 0 T} T{ -\f[C]INSERT INTO...VALUES (...),(...),(...)\f[R] +\f[CR]INSERT INTO...VALUES (...),(...),(...)\f[R] T}@T{ Records: 3 Duplicates: 0 Warnings: 0 T} T{ -\f[C]LOAD DATA INFILE\f[R] +\f[CR]LOAD DATA INFILE\f[R] T}@T{ Records: 1 Deleted: 0 Skipped: 0 Warnings: 0 T} T{ -\f[C]ALTER TABLE ...\f[R] +\f[CR]ALTER TABLE ...\f[R] T}@T{ Records: 3 Duplicates: 0 Warnings: 0 T} T{ -\f[C]UPDATE ...\f[R] +\f[CR]UPDATE ...\f[R] T}@T{ Rows matched: 40 Changed: 40 Warnings: 0 T} diff --git a/man/mysql_init.3 b/man/mysql_init.3 index 5f2c3f40..691afd43 100644 --- a/man/mysql_init.3 +++ b/man/mysql_init.3 @@ -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" -.hy +.TH "mysql_init" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP -mysql_init \- Prepares and initializes a \f[C]MYSQL\f[R] structure +mysql_init \- Prepares and initializes a \f[CR]MYSQL\f[R] structure .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL *mysql_init(MYSQL *mysql); -\f[R] -.fi +.EE .SS Description -.PP -Prepares and initializes a \f[C]MYSQL\f[R] structure to be used with +Prepares and initializes a \f[CR]MYSQL\f[R] structure to be used with \f[B]mysql_real_connect(3)\f[R]. -If an address of a \f[C]MYSQL\f[R] structure was passed as parameter, -the structure will be initialized, if \f[C]NULL\f[R] was passed, a new +If an address of a \f[CR]MYSQL\f[R] structure was passed as parameter, +the structure will be initialized, if \f[CR]NULL\f[R] was passed, a new structure will be allocated and initialized. .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 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. -* 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]. .SS Return value -.PP -The \f[C]mysql_init()\f[R] function returns an address of a -\f[C]MYSQL\f[R] structure, or NULL in case of memory allcation error. +The \f[CR]mysql_init()\f[R] function returns an address of a +\f[CR]MYSQL\f[R] structure, or NULL in case of memory allcation error. .SS See also .IP \[bu] 2 \f[B]mysql_close(3)\f[R] diff --git a/man/mysql_insert_id.3 b/man/mysql_insert_id.3 index aa4b27e3..79ea795f 100644 --- a/man/mysql_insert_id.3 +++ b/man/mysql_insert_id.3 @@ -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" -.hy +.TH "mysql_insert_id" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_insert_id \- returns the auto generated ID used in last statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_ulonglong mysql_insert_id(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the auto generated ID generated by a SQL statement (usually INSERT) on a table for a column defined with AUTO_INCREMENT attribute. .SS Parameters: -.PP -\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 \f[B]mysql_real_connect(3)\f[R]. .SH Return value -.PP Returns the value of the modified column with AUTO_INCREMENT attribute. If the table doesn\[cq]t contain an auto_increment column or no INSERT/UPDATE statement was executed, this function will return zero. diff --git a/man/mysql_kill.3 b/man/mysql_kill.3 index 833a66ea..470e6c7d 100644 --- a/man/mysql_kill.3 +++ b/man/mysql_kill.3 @@ -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" -.hy +.TH "mysql_kill" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_kill \- Kills a connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_kill(MYSQL * mysql, unsigned long); -\f[R] -.fi +.EE .SS Description -.PP This function is used to ask the server to kill a MariaDB thread specified by the processid parameter. 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. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. Returns 0 on success, otherwise nonzero. .IP \[bu] 2 -\f[C]long\f[R] \- process id +\f[CR]long\f[R] \- process id .SS Notes .IP \[bu] 2 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 -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 \f[B]mysql_close(3)\f[R]. .SS Return value -.PP Returns zero on success, non zero on error. .SS See also .IP \[bu] 2 diff --git a/man/mysql_more_results.3 b/man/mysql_more_results.3 index d06dc61a..3afcb15a 100644 --- a/man/mysql_more_results.3 +++ b/man/mysql_more_results.3 @@ -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" -.hy +.TH "mysql_more_results" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_more_results \- indicates if one or more results are available .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_more_results(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Indicates if one or more result sets are available from a previous call to \f[B]mysql_real_query(3)\f[R]. .SS Parameter .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes @@ -30,9 +25,8 @@ multi statement support. .IP \[bu] 2 Multiple result sets can be obtained either by calling a stored 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 -.PP Returns 1 if more result sets are available, otherwise zero. .SS See also .IP \[bu] 2 diff --git a/man/mysql_next_result.3 b/man/mysql_next_result.3 index 92da0942..a0b67daa 100644 --- a/man/mysql_next_result.3 +++ b/man/mysql_next_result.3 @@ -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" -.hy +.TH "mysql_next_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_next_result \- prepares next result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_next_result(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP 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_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. .SS Parameter .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_real_connect(3)\f[R]. .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 there will be no result set available. .SS Return value -.PP Returns zero on success, non zero value on error. .SS See also .IP \[bu] 2 diff --git a/man/mysql_num_fields.3 b/man/mysql_num_fields.3 index 0839f1e4..3ab16ef8 100644 --- a/man/mysql_num_fields.3 +++ b/man/mysql_num_fields.3 @@ -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" -.hy +.TH "mysql_num_fields" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_num_fields \- Returns number of fields in a result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_num_fields(MYSQL_RES * ); -\f[R] -.fi +.EE .SS Description -.PP Returns number of fields in a specified result set. .SS Parameter .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]. .SS Return value -.PP Returns number of fields. .SS See also .IP \[bu] 2 diff --git a/man/mysql_num_rows.3 b/man/mysql_num_rows.3 index c4c25d84..10a487e9 100644 --- a/man/mysql_num_rows.3 +++ b/man/mysql_num_rows.3 @@ -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" -.hy +.TH "mysql_num_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_num_rows \- Returns number of rows in a result set. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_ulonglong mysql_num_rows(MYSQL_RES * ); -\f[R] -.fi +.EE .SS Description -.PP Returns number of rows in a result set. .SS Parameters .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]. -### Notes The behaviour of \f[C]mysql_num_rows()\f[R] depends on whether -buffered or unbuffered result sets are being used. -For unbuffered result sets, \f[C]mysql_num_rows()\f[R] will not return +### Notes The behaviour of \f[CR]mysql_num_rows()\f[R] depends on +whether buffered or unbuffered result sets are being used. +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 retrieved. .SS See also diff --git a/man/mysql_options.3 b/man/mysql_options.3 index eafc83bc..5fb8261e 100644 --- a/man/mysql_options.3 +++ b/man/mysql_options.3 @@ -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" -.hy +.TH "mysql_options" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_options \- Used to set extra connect options and affect behavior of a connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_options(MYSQL * mysql, - enum mysql_option, + \f[B]enum\f[R] mysql_option, const void * arg); -\f[R] -.fi +.EE .SS Description -.PP Used to set extra connect options and affect behavior for a connection. 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]. .SS Notes -.PP This function is deprecated, new implementations should use \f[B]mysql_optionsv(3)\f[R] api function instead. .SS Options -.PP An overview of the possible options can be found in the description of the \f[B]mysql_optionsv(3)\f[R] API function. .SS See Also -.PP \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] diff --git a/man/mysql_options4.3 b/man/mysql_options4.3 index e3c4c6f6..e2a62371 100644 --- a/man/mysql_options4.3 +++ b/man/mysql_options4.3 @@ -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" -.hy +.TH "mysql_options4" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_options4 \- Used to set extra connect options and affect behavior of a connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_options4(MYSQL * mysql, - enum mysql_option, + \f[B]enum\f[R] mysql_option, const void * arg1, const void * arg2); -\f[R] -.fi +.EE .SS Description -.PP Used to set extra connect options and affect behavior for a connection. 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]. .SS Notes -.PP This function is deprecated, new implementations should use \f[B]mysql_optionsv(3)\f[R] api function instead. .SS Options -.PP An overview of the possible options can be found in the description of the \f[B]mysql_optionsv(3)\f[R] API function. .SS See Also -.PP \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] diff --git a/man/mysql_optionsv.3 b/man/mysql_optionsv.3 index b59e0ff4..d76a873e 100644 --- a/man/mysql_optionsv.3 +++ b/man/mysql_optionsv.3 @@ -1,32 +1,26 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_optionsv" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_optionsv" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_optionsv \- Used to set extra connect options and affect behavior of a connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_optionsv(MYSQL * mysql, - enum mysql_option, + \f[B]enum\f[R] mysql_option, const void * arg, ...); -\f[R] -.fi +.EE .SS Description -.PP Used to set extra connect options and affect behavior for a connection. 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]. .SS Options -.PP The following table shows which variable type to use for each option. .PP .TS @@ -39,63 +33,90 @@ Values T} _ T{ -\f[C]my_bool\f[R] +\f[CR]my_bool\f[R] T}@T{ -\f[C]MYSQL_OPT_RECONNECT\f[R], \f[C]MYSQL_SECURE_AUTH\f[R], -\f[C]MYSQL_REPORT_DATA_TRUNCATION\f[R], \f[C]MYSQL_OPT_SSL_ENFORCE\f[R], -\f[C]MYSQL_OPT_SSL_VERIFY_SERVER_CERT\f[R] +\f[CR]MYSQL_OPT_RECONNECT\f[R], \f[CR]MYSQL_SECURE_AUTH\f[R], +\f[CR]MYSQL_REPORT_DATA_TRUNCATION\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{ -\f[C]unsigned int\f[R] +\f[CR]unsigned int\f[R] T}@T{ -\f[C]MYSQL_OPT_PORT\f[R], \f[C]MYSQL_OPT_LOCAL_INFILE\f[R], -\f[C]MYSQL_OPT_CONNECT_TIMEOUT\f[R], \f[C]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_PORT\f[R], \f[CR]MYSQL_OPT_LOCAL_INFILE\f[R], +\f[CR]MYSQL_OPT_CONNECT_TIMEOUT\f[R], \f[CR]MYSQL_OPT_PROTOCOL\f[R], +\f[CR]MYSQL_OPT_READ_TIMEOUT\f[R], \f[CR]MYSQL_OPT_WRITE_TIMEOUT\f[R] T} T{ -\f[C]unsigned long\f[R] +\f[CR]unsigned long\f[R] T}@T{ -\f[C]MYSQL_OPT_NET_BUFFER_LENGTH\f[R], -\f[C]MYSQL_OPT_MAX_ALLOWED_PACKET\f[R] +\f[CR]MYSQL_OPT_NET_BUFFER_LENGTH\f[R], +\f[CR]MYSQL_OPT_MAX_ALLOWED_PACKET\f[R] T} T{ -\f[C]const char *\f[R] +\f[CR]const char *\f[R] T}@T{ -\f[C]MYSQL_INIT_COMMAND\f[R], \f[C]MARIADB_OPT_UNIXSOCKET\f[R], -\f[C]MARIADB_OPT_PASSWORD\f[R] , \f[C]MARIADB_OPT_USER\f[R], -\f[C]MARIADB_OPT_HOST\f[R], \f[C]MARIADB_OPT_SCHEMA\f[R], -\f[C]MYSQL_OPT_SSL_KEY\f[R], \f[C]MYSQL_OPT_SSL_CERT\f[R], -\f[C]MYSQL_OPT_SSL_CA\f[R], \f[C]MYSQL_OPT_SSL_CAPATH\f[R], -\f[C]MYSQL_SET_CHARSET_NAME\f[R], \f[C]MYSQL_SET_CHARSET_DIR\f[R], -\f[C]MYSQL_OPT_SSL_CIPHER\f[R], \f[C]MYSQL_SHARED_MEMORY_BASE_NAME\f[R], -\f[C]MYSQL_PLUGIN_DIR\f[R], \f[C]MYSQL_DEFAULT_AUTH\f[R], -\f[C]MARIADB_OPT_SSL_FP\f[R], \f[C]MARIADB_OPT_SSL_FP_LIST\f[R], -\f[C]MARIADB_OPT_TLS_PASSPHRASE\f[R], \f[C]MARIADB_OPT_TLS_VERSION\f[R], -\f[C]MYSQL_OPT_BIND\f[R], \f[C]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R], -\f[C]MYSQL_OPT_CONNECT_ATTR_ADD\f[R], -\f[C]MARIADB_OPT_CONNECTION_HANDLER\f[R], -\f[C]MYSQL_SERVER_PUBLIC_KEY\f[R], \f[C]MARIADB_OPT_RESTRICTED_AUTH\f[R] +\f[CR]MYSQL_INIT_COMMAND\f[R], \f[CR]MARIADB_OPT_UNIXSOCKET\f[R], +\f[CR]MARIADB_OPT_PASSWORD\f[R] , \f[CR]MARIADB_OPT_USER\f[R], +\f[CR]MARIADB_OPT_HOST\f[R], \f[CR]MARIADB_OPT_SCHEMA\f[R], +\f[CR]MYSQL_OPT_SSL_KEY\f[R], \f[CR]MYSQL_OPT_SSL_CERT\f[R], +\f[CR]MYSQL_OPT_SSL_CA\f[R], \f[CR]MYSQL_OPT_SSL_CAPATH\f[R], +\f[CR]MYSQL_SET_CHARSET_NAME\f[R], \f[CR]MYSQL_SET_CHARSET_DIR\f[R], +\f[CR]MYSQL_OPT_SSL_CIPHER\f[R], +\f[CR]MYSQL_SHARED_MEMORY_BASE_NAME\f[R], \f[CR]MYSQL_PLUGIN_DIR\f[R], +\f[CR]MYSQL_DEFAULT_AUTH\f[R], \f[CR]MARIADB_OPT_SSL_FP\f[R], +\f[CR]MARIADB_OPT_SSL_FP_LIST\f[R], +\f[CR]MARIADB_OPT_TLS_PASSPHRASE\f[R], +\f[CR]MARIADB_OPT_TLS_VERSION\f[R], \f[CR]MYSQL_OPT_BIND\f[R], +\f[CR]MYSQL_OPT_CONNECT_ATTR_DELETE\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{ -\f[C]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] +\f[CR]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] T} T{ void * T}@T{ -\f[C]MARIADB_OPT_PROXY_HEADER\f[R] +\f[CR]MARIADB_OPT_PROXY_HEADER\f[R] T} .TE .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 .P .PD Command(s) which will be executed when connecting and reconnecting to the server. .IP \[bu] 2 -\f[C]MYSQL_OPT_COMPRESS\f[R] +\f[CR]MYSQL_OPT_COMPRESS\f[R] .PD 0 .P .PD @@ -103,82 +124,89 @@ Use the compressed protocol for client server communication. If the server doesn\[cq]t support compressed protocol, the default protocol will be used. .IP \[bu] 2 -\f[C]MYSQL_OPT_CONNECT_TIMEOUT\f[R] +\f[CR]MYSQL_OPT_CONNECT_TIMEOUT\f[R] .PD 0 .P .PD Connect timeout in seconds. This value will be passed as an unsigned ##int## parameter. .IP \[bu] 2 -\f[C]MYSQL_OPT_LOCAL_INFILE\f[R] +\f[CR]MYSQL_OPT_LOCAL_INFILE\f[R] .PD 0 .P .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 -\f[C]MYSQL_OPT_NAMED_PIPE\f[R] +\f[CR]MYSQL_OPT_NAMED_PIPE\f[R] .PD 0 .P .PD For Windows operating systems only: Use named pipes for client/server communication. .IP \[bu] 2 -\f[C]MYSQL_PROGRESS_CALLBACK\f[R] +\f[CR]MYSQL_PROGRESS_CALLBACK\f[R] .PD 0 .P .PD Specifies a callback function which will be able to visualize the 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: .IP -.nf -\f[C] +.EX static void report_progress(const MYSQL *mysql __attribute__((unused)), uint stage, uint max_stage, double progress __attribute__((unused)), const char *proc_info __attribute__((unused)), uint proc_info_length __attribute__((unused))) -\f[R] -.fi +.EE .IP \[bu] 2 -\f[C]MYSQL_OPT_PROTOCOL\f[R] +\f[CR]MYSQL_OPT_PROTOCOL\f[R] .PD 0 .P .PD Specify the type of client/server protocol. -Possible values are: \f[C]MYSQL_PROTOCOL_TCP\f[R], -\f[C]MYSQL_PROTOCOL_SOCKET\f[R], \f[C]MYSQL_PROTOCOL_PIPE\f[R] and -\f[C]MYSQL_PROTOCOL_MEMORY\f[R]. +Possible values are: \f[CR]MYSQL_PROTOCOL_TCP\f[R], +\f[CR]MYSQL_PROTOCOL_SOCKET\f[R], \f[CR]MYSQL_PROTOCOL_PIPE\f[R] and +\f[CR]MYSQL_PROTOCOL_MEMORY\f[R]. .IP \[bu] 2 -\f[C]MYSQL_OPT_RECONNECT\f[R] +\f[CR]MYSQL_OPT_RECONNECT\f[R] .PD 0 .P .PD Enable or disable automatic reconnect. .IP \[bu] 2 -\f[C]MYSQL_OPT_READ_TIMEOUT\f[R] +\f[CR]MYSQL_OPT_READ_TIMEOUT\f[R] .PD 0 .P .PD Specifies the timeout in seconds for reading packets from the server. .IP \[bu] 2 -\f[C]MYSQL_OPT_WRITE_TIMEOUT\f[R] +\f[CR]MYSQL_OPT_WRITE_TIMEOUT\f[R] .PD 0 .P .PD Specifies the timeout in seconds for sending packets to the server. .IP \[bu] 2 -\f[C]MYSQL_READ_DEFAULT_FILE\f[R] +\f[CR]MYSQL_READ_DEFAULT_FILE\f[R] .PD 0 .P .PD -Read options from named configuration file. -To read from default \f[C]my.cnf\f[R] configuration file, a NULL pointer -has to be passed with option MYSQL_READ_DEFAULT_GROUP. -\f[B]Note:\f[R] MariaDB Connector/C will not read the configuration by -default. -If \f[C]MYSQL_READ_DEFAULT_FILE\f[R] is specified the following sections +Read options from the specified configuration file. +If an empty string is passed, the default configuration files (such as +/etc/my.cnf, /etc/mysql/my.cnf) will be read. +By default, configuration files are not processed unless this option is +specified. +.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: .IP \[bu] 2 [client] @@ -186,34 +214,28 @@ will be always processed: [client\-server] .IP \[bu] 2 [client\-mariadb] +.RE .IP \[bu] 2 -\f[C]MYSQL_READ_DEFAULT_GROUP\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] +\f[CR]MYSQL_REPORT_DATA_TRUNCATION\f[R] .PD 0 .P .PD Enable or disable reporting data truncation errors for prepared statements. .IP \[bu] 2 -\f[C]MYSQL_OPT_BIND\f[R] +\f[CR]MYSQL_OPT_BIND\f[R] .PD 0 .P .PD Specify the network interface from which to connect to MariaDB Server. .IP \[bu] 2 -\f[C]MYSQL_PLUGIN_DIR\f[R] +\f[CR]MYSQL_PLUGIN_DIR\f[R] .PD 0 .P .PD Specify the location of client plugins. .IP \[bu] 2 -\f[C]MYSQL_OPT_NONBLOCK\f[R] +\f[CR]MYSQL_OPT_NONBLOCK\f[R] .PD 0 .P .PD @@ -224,13 +246,29 @@ and the application is doing other processing. Normally, applications will not have to change this, and it can be passed as zero to use the default value. .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 .P .PD Specify the name of a connection handler plugin. .IP \[bu] 2 -\f[C]MARIADB_OPT_USERDATA\f[R] +\f[CR]MARIADB_OPT_USERDATA\f[R] .PD 0 .P .PD @@ -238,61 +276,131 @@ Bundle user data to the current connection, e.g.\ for use in connection handler plugins. This option requires 4 parameters: connection, option, key and value: .IP -.nf -\f[C] -mysql_optionsv(mysql, MARIADB_OPT_USERDATA, (void *)\[dq]ssh_user\[dq], (void *)ssh_user); -\f[R] -.fi +.EX +mysql_optionsv(mysql, MARIADB_OPT_USERDATA, (void *)\[dq]my_key\[dq], (void *)value); +.EE .IP \[bu] 2 -\f[C]MARIADB_OPT_CONNECTION_READ_ONLY\f[R] +\f[CR]MARIADB_OPT_CONNECTION_READ_ONLY\f[R] .PD 0 .P .PD This option is used by connection handler plugins and indicates that the current connection will be used for read operations only. .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 .P .PD If this option is set, the client indicates that it will be able to 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 -\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 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 +.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 .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_KEY\f[R] +\f[CR]MYSQL_OPT_SSL_KEY\f[R] .PD 0 .P .PD Specify the name of a key for a secure connection. 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 -\f[C]MYSQL_OPT_SSL_CERT\f[R] +\f[CR]MYSQL_OPT_SSL_CERT\f[R] .PD 0 .P .PD Specify the name of a certificate for a secure connection. .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_CA\f[R] +\f[CR]MYSQL_OPT_SSL_CA\f[R] .PD 0 .P .PD Specify the name of a file which contains one or more trusted CAs. .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_CAPATH\f[R] +\f[CR]MYSQL_OPT_SSL_CAPATH\f[R] .PD 0 .P .PD Specify the path which contains trusted CAs. .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_CIPHER\f[R] +\f[CR]MYSQL_OPT_SSL_CIPHER\f[R] .PD 0 .P .PD @@ -301,47 +409,51 @@ encryption. Even if Connector/C supports TLSv1.3 protocol, it is not possible yet to specify TLSv1.3 cipher suites. .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_CRL\f[R] +\f[CR]MYSQL_OPT_SSL_CRL\f[R] .PD 0 .P .PD Specify a file with a certificate revocation list. .IP \[bu] 2 -\f[C]MYSQL_OPT_SSL_CRLPATH\f[R] +\f[CR]MYSQL_OPT_SSL_CRLPATH\f[R] .PD 0 .P .PD Specify a directory with contains files with certificate revocation lists. .IP \[bu] 2 -\f[C]MARIADB_OPT_SSL_FP\f[R] +\f[CR]MARIADB_OPT_SSL_FP\f[R] .PD 0 .P .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. +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 -\f[C]MARIADB_OPT_SSL_FP\f[R] +\f[CR]MARIADB_OPT_SSL_FP_LIST\f[R] .PD 0 .P .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. +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 -\f[C]MARIADB_OPT_SSL_PASPHRASE\f[R] +\f[CR]MARIADB_OPT_SSL_PASPHRASE\f[R] .PD 0 .P .PD Specify a passphrase for a passphrase protected client key. .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 .P .PD -Enable (or disable) the verification of the hostname against common name -(CN) of the server\[cq]s host certificate. +Enable (or disable) the verification of the host name against common +name (CN) of the server\[cq]s host certificate. .IP \[bu] 2 -\f[C]MYSQL_SERVER_PUBLIC_KEY\f[R] +\f[CR]MYSQL_SERVER_PUBLIC_KEY\f[R] .PD 0 .P .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 Connector/C 3.1.0 .IP \[bu] 2 -\f[C]MARIADB_OPT_TLS_CIPHER_STRENGTH\f[R] +\f[CR]MARIADB_OPT_TLS_CIPHER_STRENGTH\f[R] .PD 0 .P .PD This option is not in use anymore. .IP \[bu] 2 -\f[C]MARIADB_OPT_RESTRICTED_AUTH\f[R] +\f[CR]MARIADB_OPT_RESTRICTED_AUTH\f[R] .PD 0 .P .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 was added in MariaDB Connector/C 3.3.0 .SS Proxy settings -.PP As per the proxy protocol specification, the connecting client can prefix its first packet with a proxy protocol header. The server will parse the header and assume the client\[cq]s IP address is the one set in the proxy header. -* \f[C]MARIADB_OPT_PROXY_HEADER\f[R] \- specifies the proxy header which -will be prefixed to the first packet. +* \f[CR]MARIADB_OPT_PROXY_HEADER\f[R] \- specifies the proxy header +which will be prefixed to the first packet. Parameters are void * for the prefix buffer and size_t for length of the buffer: .IP -.nf -\f[C] +.EX 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)); -\f[R] -.fi +.EE .SS Connection Attributes -.PP -Connection attributes are stored in the \f[C]session_connect_attrs\f[R] -and \f[C]session_account_connect_attrs\f[R]Performance Schema tables. +Connection attributes are stored in the \f[CR]session_connect_attrs\f[R] +and \f[CR]session_account_connect_attrs\f[R]Performance Schema tables. By default, MariaDB Connector/C sends the following connection -attributes to the server: * \f[C]_client_name\f[R]: always -\[lq]libmariadb\[rq] * \f[C]_client_version\f[R]: version of MariaDB -Connector/C * \f[C]_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 -hostname (as specified in mysql_real_connect). +attributes to the server: * \f[CR]_client_name\f[R]: always +\[lq]libmariadb\[rq] * \f[CR]_client_version\f[R]: version of MariaDB +Connector/C * \f[CR]_os\f[R]: operation system * _pid: process id * +\f[CR]_platform\f[R]: e.g.\ x86 or x64 * \f[CR]_server_host\f[R]: the +host name (as specified in mysql_real_connect). This attribute was added in Connector/C 3.0.5 .PP \f[B]Note:\f[R] If the Performance Schema is disabled, connection attributes will not be stored on server. .IP \[bu] 2 -\f[C]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R] +\f[CR]MYSQL_OPT_CONNECT_ATTR_DELETE\f[R] .PD 0 .P .PD Deletes a connection attribute for the given key. .IP \[bu] 2 -\f[C]MYSQL_OPT_CONNECT_ATTR_ADD\f[R] +\f[CR]MYSQL_OPT_CONNECT_ATTR_ADD\f[R] .PD 0 .P .PD 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 -\f[C]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] +\f[CR]MYSQL_OPT_CONNECT_ATTR_RESET\f[R] .PD 0 .P .PD Clears the current list of connection attributes. .SS See Also -.PP \f[I]\f[BI]mysql_init(3)\f[I] \f[R]\f[B]mysql_real_connect(3)\f[R] diff --git a/man/mysql_ping.3 b/man/mysql_ping.3 index 40150920..1ec17c6f 100644 --- a/man/mysql_ping.3 +++ b/man/mysql_ping.3 @@ -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" -.hy +.TH "mysql_ping" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_ping \- checks if the connection between client and server is working .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_ping(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Checks whether the connection to the server is working. If it has gone down, and global option reconnect is enabled an automatic reconnection is attempted. @@ -26,17 +21,17 @@ to check whether the server has closed the connection and reconnect if necessary. .SS Parameters .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_real_connect(3)\f[R]. ### Notes .IP \[bu] 2 If a reconnect occurred the thread_id will change. Also resources bundled to the connection (prepared statements, locks, -temporary tables, \&...) will be released. +temporary tables, \&...) +will be released. .SS Return value -.PP -Returns zero on success, nonzero if an error occured. +Returns zero on success, nonzero if an error occurred. .SS See also .IP \[bu] 2 \f[B]mysql_optionsv(3)\f[R] diff --git a/man/mysql_query.3 b/man/mysql_query.3 index f416d426..ab9fcee2 100644 --- a/man/mysql_query.3 +++ b/man/mysql_query.3 @@ -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" -.hy +.TH "mysql_query" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_query \- executes a null terminated statement string .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_query(MYSQL * mysql, const char * query); -\f[R] -.fi +.EE .SS Description -.PP Performs a statement pointed to by the null terminate string query against the database. Contrary to \f[B]mysql_real_query(3)\f[R], mysql_query() is not binary safe. .SS Parameter .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_real_connect(3)\f[R]. .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. .SS Notes .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 \f[B]mysql_field_count(3)\f[R]. .SS Return value -.PP Returns zero on success, non zero on failure. .SS See also .IP \[bu] 2 diff --git a/man/mysql_read_query_result.3 b/man/mysql_read_query_result.3 index 5f066f0f..fac6d517 100644 --- a/man/mysql_read_query_result.3 +++ b/man/mysql_read_query_result.3 @@ -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" -.hy +.TH "mysql_read_query_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_read_query_result \- waits for a server result or response package .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_read_query_result(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Waits for a server result set or response package from a previously executed \f[B]mysql_send_query(3)\f[R]. .SS Parameters .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_real_connect(3)\f[R]. .SS Return value -.PP Zero on success, non zero on error. .SS Example -.PP 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 -MySQL Queries with -C\-API\[rq] (https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/). +driven model, please check Jan Kneschke\[cq]s Blog entry \c +.UR 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 .IP \[bu] 2 \f[B]mysql_real_query(3)\f[R] diff --git a/man/mysql_real_connect.3 b/man/mysql_real_connect.3 index 3a7a7f60..958aa15d 100644 --- a/man/mysql_real_connect.3 +++ b/man/mysql_real_connect.3 @@ -1,16 +1,13 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_real_connect" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_real_connect" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_real_connect \- establishes a connection to a MariaDB database server .SS Synopsis .IP -.nf -\f[C] +.EX MYSQL * mysql_real_connect(MYSQL *mysql, const char *host, const char *user, @@ -19,17 +16,15 @@ MYSQL * mysql_real_connect(MYSQL *mysql, unsigned int port, const char *unix_socket, unsigned long flags); -\f[R] -.fi +.EE .SS Description -.PP Establishes a connection to a database server. .SS Parameter .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] .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 parameter, the local host is assumed. 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 available. .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 -\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 only. This allows one username to be used with different permissions (depending on if a password as provided or not). .IP \[bu] 2 -\f[C]db\f[R] \- if provided will specify the default database to be used -when performing queries. +\f[CR]db\f[R] \- if provided will specify the default database to be +used when performing queries. .IP \[bu] 2 -\f[C]port\f[R] \- specifies the port number to attempt to connect to the -server. +\f[CR]port\f[R] \- specifies the port number to attempt to connect to +the server. .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. .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 .P .PD @@ -69,56 +67,55 @@ Description T} _ T{ -\f[C]CLIENT_FOUND_ROWS\f[R] +\f[CR]CLIENT_FOUND_ROWS\f[R] T}@T{ Return the number of matched rows instead of number of changed rows. T} T{ -\f[C]CLIENT_NO_SCHEMA\f[R] +\f[CR]CLIENT_NO_SCHEMA\f[R] T}@T{ Forbids the use of database.tablename.column syntax and forces the SQL parser to generate an error. T} T{ -\f[C]CLIENT_COMPRESS\f[R] +\f[CR]CLIENT_COMPRESS\f[R] T}@T{ Use compression protocol T} T{ -\f[C]CLIENT_IGNORE_SPACE\f[R] +\f[CR]CLIENT_IGNORE_SPACE\f[R] T}@T{ Allows spaces after function names. All function names will become reserved words. T} T{ -\f[C]CLIENT_LOCAL_FILES\f[R] +\f[CR]CLIENT_LOCAL_FILES\f[R] T}@T{ Allows LOAD DATA LOCAL statements T} T{ -\f[C]CLIENT_MULTI_STATEMENTS\f[R] +\f[CR]CLIENT_MULTI_STATEMENTS\f[R] T}@T{ Allows the client to send multiple statements in one command. Statements will be divided by a semicolon. T} T{ -\f[C]CLIENT_MULTI_RESULTS\f[R] +\f[CR]CLIENT_MULTI_RESULTS\f[R] T}@T{ Indicates that the client is able to handle multiple result sets from stored procedures or multi statements. This option will be automatically set if CLIENT_MULTI_STATEMENTS is set. T} T{ -\f[C]CLIENT_REMEMBER_OPTIONS\f[R] +\f[CR]CLIENT_REMEMBER_OPTIONS\f[R] 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. If MYSQL_OPTIONS_RECONNECT option was set to true, options will be saved and used for reconnection. T} .TE .SS Return value -.PP returns a connection handle (same as passed for 1st parameter) or NULL on error. 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: .RS 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 IPv6 addresses must be enclosed within square brackets .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 if only one host:port was specified, the host string needs to end with a comma. @@ -154,9 +151,9 @@ if no port was specified, the default port will be used. .PP \f[B]Examples for failover host string:\f[R] .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 -\f[C]host=127.0.0.1:3306,\f[R] +\f[CR]host=127.0.0.1:3306,\f[R] .RE .SS See also .IP \[bu] 2 diff --git a/man/mysql_real_escape_string.3 b/man/mysql_real_escape_string.3 index 0a0f51f4..efc6b0a1 100644 --- a/man/mysql_real_escape_string.3 +++ b/man/mysql_real_escape_string.3 @@ -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" -.hy +.TH "mysql_real_escape_string" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_real_escape_string \- escape string by taking into account character set of connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long mysql_real_escape_string(MYSQL * mysql, char * to, const char * from, unsigned long); -\f[R] -.fi +.EE .SS Description -.PP This function is used to create a legal SQL string that you can use in an SQL statement. The given string is encoded to an escaped SQL string, taking into account the current character set of the connection. .SS Parameter .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_real_connect(3)\f[R]. .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 every character of the from string needs to be escaped. Additionally a trailing 0 character will be appended. .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(). .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 -.PP Returns the length of the encoded (to) string. .SS See also .IP \[bu] 2 diff --git a/man/mysql_real_query.3 b/man/mysql_real_query.3 index a3f33796..b0cbd98a 100644 --- a/man/mysql_real_query.3 +++ b/man/mysql_real_query.3 @@ -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" -.hy +.TH "mysql_real_query" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_real_query \- execute a statement (binary safe) .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_real_query(MYSQL * mysql, const char * query, unsigned long length); -\f[R] -.fi +.EE .SS Description -.PP mysql_real_query() is the binary safe function for performing a statement on the database server. .SS Parameter .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_real_connect(3)\f[R]. .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 -\f[C]length\f[R] \- length of the string. +\f[CR]length\f[R] \- length of the string. .SS Notes .IP \[bu] 2 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 \f[B]mysql_num_fields(3)\f[R] function. .SS Return value -.PP Returns zero on success, otherwise non zero. .SS See also .IP \[bu] 2 diff --git a/man/mysql_refresh.3 b/man/mysql_refresh.3 index dd1c098f..6767f45b 100644 --- a/man/mysql_refresh.3 +++ b/man/mysql_refresh.3 @@ -1,39 +1,34 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_refresh" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_refresh" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_refresh \- flushes information on the server .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_refresh(MYSQL * mysql, unsigned int options); -\f[R] -.fi +.EE .SS Description -.PP Flushes different types of information stored on the server. The bit\-masked parameter options specify which kind of information will be flushed. .SS Parameters .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_real_connect(3)\f[R]. .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. .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 .TS tab(@); -l l. +lw(35.0n) lw(35.0n). T{ Option T}@T{ @@ -41,42 +36,42 @@ Description T} _ T{ -\f[C]REFRESH_GRANT\f[R] +\f[CR]REFRESH_GRANT\f[R] T}@T{ Refresh grant tables. T} T{ -\f[C]REFRESH_LOG\f[R] +\f[CR]REFRESH_LOG\f[R] T}@T{ Flush logs. T} T{ -\f[C]REFRESH_TABLES\f[R] +\f[CR]REFRESH_TABLES\f[R] T}@T{ Flush table cache. T} T{ -\f[C]REFRESH_HOSTS\f[R] +\f[CR]REFRESH_HOSTS\f[R] T}@T{ Flush host cache. T} T{ -\f[C]REFRESH_STATUS\f[R] +\f[CR]REFRESH_STATUS\f[R] T}@T{ Reset status variables. T} T{ -\f[C]REFRESH_THREADS\f[R] +\f[CR]REFRESH_THREADS\f[R] T}@T{ Flush thread cache. T} T{ -\f[C]REFRESH_SLAVE\f[R] +\f[CR]REFRESH_SLAVE\f[R] T}@T{ Reset master server information and restart slaves. T} T{ -\f[C]REFRESH_MASTER\f[R] +\f[CR]REFRESH_MASTER\f[R] T}@T{ Remove binary log files. T} @@ -86,7 +81,6 @@ T} To combine different values in the options parameter use the OR operator `|'. .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 -.PP Returns zero on success, otherwise non zero. diff --git a/man/mysql_reset_connection.3 b/man/mysql_reset_connection.3 index 8cd4ef5c..699792b9 100644 --- a/man/mysql_reset_connection.3 +++ b/man/mysql_reset_connection.3 @@ -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" -.hy +.TH "mysql_reset_connection" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_reset_connection \- Resets connection and clears session state .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_reset_connection(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Resets the current connection and clears session state. Similar to \f[B]mysql_change_user(3)\f[R] or \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 .SS Parameter .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_real_connect(3)\f[R]. .SS Return value -.PP Returns zero on success, non zero if an error occurred. .SS History -.PP This function was added in MariaDB Connector/C 3.0.0. .SS See also .IP \[bu] 2 diff --git a/man/mysql_rollback.3 b/man/mysql_rollback.3 index e69cbc6f..37601df5 100644 --- a/man/mysql_rollback.3 +++ b/man/mysql_rollback.3 @@ -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" -.hy +.TH "mysql_rollback" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_rollback \- Rolls back the current transaction .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_rollback(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Rolls back the current transaction for the database. Returns zero on success, nonzero if an error occurred. .SS Parameter .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_real_connect(3)\f[R]. .SS Notes diff --git a/man/mysql_row_seek.3 b/man/mysql_row_seek.3 index 35a05ede..b0b61247 100644 --- a/man/mysql_row_seek.3 +++ b/man/mysql_row_seek.3 @@ -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" -.hy +.TH "mysql_row_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_row_seek \- Positions the row cursor to an arbitrary row .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES * result, MYSQL_ROW_OFFSET offset); -\f[R] -.fi +.EE .SS Description -.PP Positions the row cursor to an arbitrary row in a result set which was obtained by \f[B]mysql_store_result(3)\f[R]. .SS Parameter .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]. .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 \f[B]mysql_row_tell(3)\f[R] .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 \f[B]mysql_use_result(3)\f[R]. .SS Return value -.PP Returns the previous row offset. .SS See also .IP \[bu] 2 diff --git a/man/mysql_row_tell.3 b/man/mysql_row_tell.3 index 22dda28b..7c1255ae 100644 --- a/man/mysql_row_tell.3 +++ b/man/mysql_row_tell.3 @@ -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" -.hy +.TH "mysql_row_tell" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_row_tell \- Returns row offset of a result cursor .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES * res); -\f[R] -.fi +.EE .SS Description -.PP Returns the row offset of a result cursor. The returned offset value can be used to reposition the result cursor by calling \f[B]mysql_row_seek(3)\f[R]. .SS Parameter .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]. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_select_db.3 b/man/mysql_select_db.3 index 5a70797c..dd750324 100644 --- a/man/mysql_select_db.3 +++ b/man/mysql_select_db.3 @@ -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" -.hy +.TH "mysql_select_db" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_select_db \- selects a database as default .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_select_db(MYSQL * mysql, const char * db); -\f[R] -.fi +.EE .SS Description -.PP Selects a database as default. Returns zero on success, non\-zero on failure .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]db\f[R] \- the default database name +\f[CR]db\f[R] \- the default database name .SS Notes .IP \[bu] 2 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. .IP \[bu] 2 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 SQL .IP -.nf -\f[C] -# switch to default database test -USE test; -# check default database -SELECT DATABASE(); -+\-\-\-\-\-\-\-\-\-\-\-\-+ -| database() | -+\-\-\-\-\-\-\-\-\-\-\-\-+ +.EX +# \f[B]switch\f[R] \f[B]to\f[R] \f[B]default\f[R] \f[B]database\f[R] test +\f[B]USE\f[R] test; +# \f[B]check\f[R] \f[B]default\f[R] \f[B]database\f[R] +\f[B]SELECT\f[R] \f[B]DATABASE\f[R](); ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] +| \f[B]database\f[R]() | ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] | test | -+\-\-\-\-\-\-\-\-\-\-\-\-+ -\f[R] -.fi ++\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R] +.EE .SS MariadDB Connector/C .IP -.nf -\f[C] +.EX static int set_default_db(MYSQL *mysql) { int rc; 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]); - if (rc) - return rc; /* Error */ + \f[B]if\f[R] (rc) + \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); - if (rc) - return rc; /* Error */ + \f[B]if\f[R] (rc) + \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]); - return 1; + \f[B]return\f[R] 1; } printf(\[dq]Default database: %s\[dq], default_db); - return 0; + \f[B]return\f[R] 0; } -\f[R] -.fi +.EE .SS See also -.PP \f[B]mysql_real_connect(3)\f[R] diff --git a/man/mysql_send_query.3 b/man/mysql_send_query.3 index dea08137..bb57422b 100644 --- a/man/mysql_send_query.3 +++ b/man/mysql_send_query.3 @@ -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" -.hy +.TH "mysql_send_query" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_send_query \- sends a SQL statement without waiting for server -reponse +response .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_send_query(MYSQL * mysql, const char *query, unsigned long length); -\f[R] -.fi +.EE .SS Description -.PP Sends a statement to the server, without waiting for the Server OK packet and/or resultset. .SS Parameters .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_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]query\f[R] \- SQL statement +\f[CR]query\f[R] \- SQL statement .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 .IP \[bu] 2 The OK and result set package need to be retrieved by \f[B]mysql_read_query_result(3)\f[R] function .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. While the function itself is blocking, an event driven application can do other tasks until result set is available. .SS Example -.PP 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 -Queries with -C\-API\[rq] (https://jan.kneschke.de/projects/mysql/async-mysql-queries-with-c-api/). +driven model, please check Jan Kneschke\[cq]s article \c +.UR 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 .IP \[bu] 2 - +mysql_real_query .IP \[bu] 2 - +mysql_read_query_result diff --git a/man/mysql_server_end.3 b/man/mysql_server_end.3 index c3182baf..93837e8d 100644 --- a/man/mysql_server_end.3 +++ b/man/mysql_server_end.3 @@ -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" -.hy +.TH "mysql_server_end" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_server_end \- Called when finished using MariaDB Connector/C .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_server_end(void) -\f[R] -.fi +.EE .SS Description -.PP Call when finished using the library, such as after disconnecting from the server. For a client program, only cleans up by performing memory management tasks. .SS Notes .IP \[bu] 2 -\f[C]mysql_library_end()\f[R] is an alias for -\f[C]mysql_server_end()\f[R]. +\f[CR]mysql_library_end()\f[R] is an alias for +\f[CR]mysql_server_end()\f[R]. .IP \[bu] 2 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 -\f[C]mysql_server_end()\f[R]. +\f[CR]mysql_server_end()\f[R]. .SS See also .IP \[bu] 2 \f[B]mysql_server_init(3)\f[R] diff --git a/man/mysql_server_init.3 b/man/mysql_server_init.3 index 19f7492c..ce4541cc 100644 --- a/man/mysql_server_init.3 +++ b/man/mysql_server_init.3 @@ -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" -.hy +.TH "mysql_server_init" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_server_init \- Initializes library .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_library_init(int argc __attribute__((unused)), char **argv __attribute__((unused)), char **groups __attribute__((unused))) -\f[R] -.fi +.EE .SS Description -.PP Call to initialize the library before calling other functions. .SS Parameters -.PP All parameters are unused, they only exist for compatibility reasons. .SS Notes .IP \[bu] 2 Call \f[B]mysql_server_end(3)\f[R] to clean up after completion. .IP \[bu] 2 -If the library was not explicetly initialized by -\f[C]mysql_server_init()\f[R] any call to \f[B]mysql_init(3)\f[R] will +If the library was not explicitly initialized by +\f[CR]mysql_server_init()\f[R] any call to \f[B]mysql_init(3)\f[R] will automatically initialize the library. .IP \[bu] 2 -\f[C]mysql_library_init()\f[R] is an alias for -\f[C]mysql_server_init()\f[R] +\f[CR]mysql_library_init()\f[R] is an alias for +\f[CR]mysql_server_init()\f[R] .SS Return value -.PP Returns zero for success, or nonzero if an error occurred. ## See also * \f[B]mysql_server_end(3)\f[R] diff --git a/man/mysql_session_track_get_first.3 b/man/mysql_session_track_get_first.3 index 1274f47c..02b61b3e 100644 --- a/man/mysql_session_track_get_first.3 +++ b/man/mysql_session_track_get_first.3 @@ -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" -.hy +.TH "mysql_session_track_get_first" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_session_track_get_first \- retrieves first session status change information .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] 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, size_t *length ); -\f[R] -.fi +.EE .SS Description -.PP -\f[C]mysql_session_track_get_first()\f[R] retrieves the first session +\f[CR]mysql_session_track_get_first()\f[R] retrieves the first session status change information received from the server. .PP 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 default schema (database) * -\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R]: If a session system variable +the following information: * \f[CR]SESSION_TRACK_SCHEMA\f[R]: The name +of the default schema (database) * +\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 variable, the second call contains the new value. Both name and value are represented as strings. -* \f[C]SESSION_TRACK_STATE_CHANGE\f[R]: shows whether the session status -has changed. +* \f[CR]SESSION_TRACK_STATE_CHANGE\f[R]: shows whether the session +status has changed. The value is changed as string \[lq]1\[rq] (changed) or \[lq]0\[rq] (unchanged). .PP @@ -39,35 +34,33 @@ Further data needs to be obtained by calling \f[B]mysql_session_track_get_next(3)\f[R]. .SS Parameter .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_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]type\f[R] \- type of information. +\f[CR]type\f[R] \- type of information. Valid values are .RS 2 .IP \[bu] 2 -\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R] +\f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_SCHEMA\f[R] +\f[CR]SESSION_TRACK_SCHEMA\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_STATE_CHANGE\f[R] +\f[CR]SESSION_TRACK_STATE_CHANGE\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_GTIDS\f[R] (unsupported) +\f[CR]SESSION_TRACK_GTIDS\f[R] (unsupported) .RE .IP \[bu] 2 -\f[C]data\f[R] \- pointer to data, which must be declared as -\f[C]const char *\f[R] +\f[CR]data\f[R] \- pointer to data, which must be declared as +\f[CR]const char *\f[R] .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 .SS Returns -.PP Zero for success, nonzero if no session tracking information is available. .SS History -.PP -\f[C]mysql_session_track_get_first()\f[R] was added in Connector/C 3.0 +\f[CR]mysql_session_track_get_first()\f[R] was added in Connector/C 3.0 and MariaDB Server 10.2. .SS See also .IP \[bu] 2 diff --git a/man/mysql_session_track_get_next.3 b/man/mysql_session_track_get_next.3 index 5b849ef7..fd53f822 100644 --- a/man/mysql_session_track_get_next.3 +++ b/man/mysql_session_track_get_next.3 @@ -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" -.hy +.TH "mysql_session_track_get_next" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_session_track_get_next \- Retrieves the next session status change information .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] 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, size_t *length ); -\f[R] -.fi +.EE .SS Description -.PP -\f[C]mysql_session_track_get_next()\f[R] retrieves the session status +\f[CR]mysql_session_track_get_next()\f[R] retrieves the session status change information received from the server after a successful call to \f[B]mysql_session_track_get_first(3)\f[R]. .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. .SS Parameters .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_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]type\f[R] \- type of information. +\f[CR]type\f[R] \- type of information. Valid values are .RS 2 .IP \[bu] 2 -\f[C]SESSION_TRACK_SYSTEM_VARIABLES\f[R] +\f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_SCHEMA\f[R] +\f[CR]SESSION_TRACK_SCHEMA\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_STATE_CHANGE\f[R] +\f[CR]SESSION_TRACK_STATE_CHANGE\f[R] .IP \[bu] 2 -\f[C]SESSION_TRACK_GTIDS\f[R] (unsupported) +\f[CR]SESSION_TRACK_GTIDS\f[R] (unsupported) .RE .IP \[bu] 2 -\f[C]data\f[R] \- pointer to data, which must be declared as -\f[C]const char *\f[R] +\f[CR]data\f[R] \- pointer to data, which must be declared as +\f[CR]const char *\f[R] .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 .SS Return value -.PP Zero for success, nonzero if an error occurred. .SS History -.PP -\f[C]mysql_session_track_get_next()\f[R] was added in Connector/C 3.0 +\f[CR]mysql_session_track_get_next()\f[R] was added in Connector/C 3.0 and MariaDB Server 10.2. .SS See also -.PP \f[B]mysql_session_track_get_first(3)\f[R] diff --git a/man/mysql_set_character_set.3 b/man/mysql_set_character_set.3 index d2b8e2c2..361dfb93 100644 --- a/man/mysql_set_character_set.3 +++ b/man/mysql_set_character_set.3 @@ -1,42 +1,33 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_set_character_set" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_set_character_set" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_set_character_set \- Sets the default character set for connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_set_character_set(MYSQL * mysql, const char * csname); -\f[R] -.fi +.EE .SS Description -.PP -Sets the default -[data\-types\-character\-sets\-and\-collations()](character set]] for -the current connection. +Sets the default character setfor the current connection. Returns zero on success, non\-zero on failure. .SS Parameters .IP \[bu] 2 -\f[C]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[CR]mysql\f[R] \- a mysql handle, which was previously allocated by +\f[B]mysql_init(3)\f[R] or \f[B]mysql_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]csname\f[R] \- character set name ### Notes +\f[CR]csname\f[R] \- character set name ### Notes .IP \[bu] 2 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. .SS Return value -.PP -Zero on success, non zero if an error occured +Zero on success, non zero if an error occurred .SS Supported character sets -.PP The client library supports the following character sets: .PP .TS diff --git a/man/mysql_set_server_option.3 b/man/mysql_set_server_option.3 index 915468eb..da5b7418 100644 --- a/man/mysql_set_server_option.3 +++ b/man/mysql_set_server_option.3 @@ -1,31 +1,26 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_set_server_option" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_set_server_option" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_set_server_option \- Sets server option .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_set_server_option(MYSQL * mysql, - enum enum_mysql_set_option); -\f[R] -.fi + \f[B]enum\f[R] enum_mysql_set_option); +.EE .SS Description -.PP Sets server option. .SS Parameters .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_real_connect(3)\f[R]. .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: .PP .TS @@ -49,7 +44,6 @@ Enable multi statement support T} .TE .SS Return value -.PP Returns zero on success, non\-zero on failure. .SS See also .IP \[bu] 2 diff --git a/man/mysql_shutdown.3 b/man/mysql_shutdown.3 index b91687f0..c7aac024 100644 --- a/man/mysql_shutdown.3 +++ b/man/mysql_shutdown.3 @@ -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" -.hy +.TH "mysql_shutdown" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_shutdown \- Sends shutdown message to server .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_shutdown(MYSQL * mysql, - enum mysql_enum_shutdown_level); -\f[R] -.fi + \f[B]enum\f[R] mysql_enum_shutdown_level); +.EE .SS Description -.PP 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 Sends a shutdown message to the server. .SS Parameter .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_real_connect(3)\f[R]. .IP \[bu] 2 -\f[C]mysql_enum_shutdown_level\f[R] \- currently only one shutdown -level, \f[C]SHUTDOWN_DEFAULT\f[R] is supported. +\f[CR]mysql_enum_shutdown_level\f[R] \- currently only one shutdown +level, \f[CR]SHUTDOWN_DEFAULT\f[R] is supported. .SS Notes .IP \[bu] 2 To shutdown the database server, the user for the current connection must have SHUTDOWN privileges. .SS Return value -.PP Returns zero on success, non\-zero on failure. .SS See also .IP \[bu] 2 diff --git a/man/mysql_sqlstate.3 b/man/mysql_sqlstate.3 index f949f746..2f4e6844 100644 --- a/man/mysql_sqlstate.3 +++ b/man/mysql_sqlstate.3 @@ -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" -.hy +.TH "mysql_sqlstate" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_sqlstate \- returns SQLSTATE error code .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_sqlstate(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns a string containing the SQLSTATE error code for the most recently invoked function that can succeed or fail. 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 .SS Parameter .SS Notes -.PP Please note that not all client library error codes are mapped to SQLSTATE errors. Errors which can\[cq]t be mapped will returned as value HY000. .SS Return value -.PP A string containing SQLSTATE error code. .SS See also .IP \[bu] 2 diff --git a/man/mysql_ssl_set.3 b/man/mysql_ssl_set.3 index bccf3774..9ffb8e6f 100644 --- a/man/mysql_ssl_set.3 +++ b/man/mysql_ssl_set.3 @@ -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" -.hy +.TH "mysql_ssl_set" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_ssl_set \- Sets TLS/SSL options .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_ssl_set(MYSQL *mysql, const char *key, @@ -17,33 +14,41 @@ my_bool mysql_ssl_set(MYSQL *mysql, const char *ca, const char *capath, const char *cipher) -\f[R] -.fi +.EE .SS Description -.PP Used for establishing a secure TLS connection. It must be called before attempting to use \f[B]mysql_real_connect(3)\f[R]. TLS support must be enabled in the client library in order for the function to have any effect. .PP -NULL can be used for an unused parameter. +\f[CR]NULL\f[R] can be used for an unused parameter. 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 .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]. .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 -\f[C]cert\f[R] \- path to the certificate file. +\f[CR]cert\f[R] \- path to the certificate file. .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 -\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. .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. .SS Notes .IP \[bu] 2 @@ -51,7 +56,7 @@ suites to use for TLS encryption. connect and TLS is incorrectly set up. .IP \[bu] 2 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 .IP \[bu] 2 \f[B]mysql_get_ssl_cipher(3)\f[R] diff --git a/man/mysql_stat.3 b/man/mysql_stat.3 index a2b88565..921bc15e 100644 --- a/man/mysql_stat.3 +++ b/man/mysql_stat.3 @@ -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" -.hy +.TH "mysql_stat" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stat \- Returns current server status .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_stat(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP mysql_stat() returns a string with the current server status for uptime, threads, queries, open tables, flush tables and queries per second. .SS Parameter .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_real_connect(3)\f[R]. .SS Notes -.PP For a complete list of other status variables, you have to use the [show\-status()](SHOW STATUS]] SQL command. .SS Return value -.PP Returns a string representing current server status. .SS See also .IP \[bu] 2 -mysql_get_server_info() (mysql_get_server_info) +mysql_get_server_info() diff --git a/man/mysql_stmt_affected_rows.3 b/man/mysql_stmt_affected_rows.3 index d7b2f1de..4fbae655 100644 --- a/man/mysql_stmt_affected_rows.3 +++ b/man/mysql_stmt_affected_rows.3 @@ -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" -.hy +.TH "mysql_stmt_affected_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_affected_rows \- Returns the number of affected rows from previous executed prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of affected rows by the last prepared statement associated with mysql, if the operation was an \[lq]upsert\[rq] (INSERT, UPDATE, DELETE or REPLACE) statement, or \-1 if the last prepared statement failed. .SS Parameter .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().]] .SS Notes .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. -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 rows that were literally affected by the query. .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. This function returns the number of deleted records in addition to the number of inserted records. diff --git a/man/mysql_stmt_attr_get.3 b/man/mysql_stmt_attr_get.3 index 2dd07a74..a56a7400 100644 --- a/man/mysql_stmt_attr_get.3 +++ b/man/mysql_stmt_attr_get.3 @@ -1,39 +1,33 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_attr_get" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_attr_get" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_attr_get \- Gets the current value of a statement attribute .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] 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); -\f[R] -.fi +.EE .SS Description -.PP Gets the current value of a statement attribute. Returns zero on success, non zero on failure. .SS Parameter .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]. .IP \[bu] 2 -\f[C]enum_stmt_attr_type\f[R] \- attribute. +\f[CR]enum_stmt_attr_type\f[R] \- attribute. See below. .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. .SS Attribute types -.PP -The \f[C]enum_stmt_attr_type\f[R] parameter has the following possible +The \f[CR]enum_stmt_attr_type\f[R] parameter has the following possible values: .PP .TS @@ -48,43 +42,43 @@ Description T} _ T{ -\f[C]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] +\f[CR]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] T}@T{ -\f[C]my_bool *\f[R] +\f[CR]my_bool *\f[R] T}@T{ 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{ -\f[C]STMT_ATTR_CURSOR_TYPE\f[R] +\f[CR]STMT_ATTR_CURSOR_TYPE\f[R] T}@T{ -\f[C]unsigned long *\f[R] +\f[CR]unsigned long *\f[R] T}@T{ -Possible values are \f[C]CURSOR_TYPE_READ_ONLY\f[R] or default value -\f[C]CURSOR_TYPE_NO_CURSOR\f[R]. +Possible values are \f[CR]CURSOR_TYPE_READ_ONLY\f[R] or default value +\f[CR]CURSOR_TYPE_NO_CURSOR\f[R]. T} T{ -\f[C]STMT_ATTR_PREFETCH_ROWS\f[R] +\f[CR]STMT_ATTR_PREFETCH_ROWS\f[R] T}@T{ -\f[C]unsigned long *\f[R] +\f[CR]unsigned long *\f[R] T}@T{ Number of rows which will be prefetched. The default value is 1. T} T{ -\f[C]STMT_ATTR_PREBIND_PARAMS\f[R] +\f[CR]STMT_ATTR_PREBIND_PARAMS\f[R] T}@T{ -\f[C]unsigned int *\f[R] +\f[CR]unsigned int *\f[R] T}@T{ Number of parameters used for \f[B]mariadb_stmt_execute_direct(3)\f[R] T} T{ -\f[C]STMT_ATTR_STATE\f[R] +\f[CR]STMT_ATTR_STATE\f[R] T}@T{ -\f[C]enum mysql_stmt_state *\f[R] +\f[CR]enum mysql_stmt_state *\f[R] T}@T{ 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 T} .TE diff --git a/man/mysql_stmt_attr_set.3 b/man/mysql_stmt_attr_set.3 index 5d9446a3..1e77c5f0 100644 --- a/man/mysql_stmt_attr_set.3 +++ b/man/mysql_stmt_attr_set.3 @@ -1,39 +1,33 @@ -.\"t -.\" Automatically generated by Pandoc 2.5 +'\" t +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_attr_set" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_attr_set" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_attr_set \- Sets attribute of a statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] 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); -\f[R] -.fi +.EE .SS Description -.PP Used to modify the behavior of a prepared statement. This function may be called multiple times to set several attributes. Returns zero on success, non\-zero on failure. .SS Parameters .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]. .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. .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 -.PP -The \f[C]enum_stmt_attr_type\f[R] attribute can have one of the +The \f[CR]enum_stmt_attr_type\f[R] attribute can have one of the following values: .PP .TS @@ -48,34 +42,34 @@ Description T} _ T{ -\f[C]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] +\f[CR]STMT_ATTR_UPDATE_MAX_LENGTH\f[R] T}@T{ -\f[C]my_bool *\f[R] +\f[CR]my_bool *\f[R] T}@T{ If set to 1, \f[B]mysql_stmt_store_result(3)\f[R] will update the max_length value of MYSQL_FIELD structures. T} T{ -\f[C]STMT_ATTR_CURSOR_TYPE\f[R] +\f[CR]STMT_ATTR_CURSOR_TYPE\f[R] T}@T{ -\f[C]unsigned long *\f[R] +\f[CR]unsigned long *\f[R] T}@T{ 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 -\f[C]CURSOR_TYPE_NO_CURSOR\f[R]. +Possible values are \f[CR]CURSOR_TYPE_READ_ONLY\f[R] or default value +\f[CR]CURSOR_TYPE_NO_CURSOR\f[R]. T} T{ -\f[C]STMT_ATTR_PREFETCH_ROWS\f[R] +\f[CR]STMT_ATTR_PREFETCH_ROWS\f[R] T}@T{ -\f[C]unsigned long *\f[R] +\f[CR]unsigned long *\f[R] T}@T{ number of rows which will be prefetched. The default value is 1. T} T{ -\f[C]STMT_ATTR_PREBIND_PARAMS\f[R] +\f[CR]STMT_ATTR_PREBIND_PARAMS\f[R] T}@T{ -\f[C]unsigned int *\f[R] +\f[CR]unsigned int *\f[R] T}@T{ number of parameter markers when using \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 T} T{ -\f[C]STMT_ATTR_ARRAY_SIZE\f[R] +\f[CR]STMT_ATTR_ARRAY_SIZE\f[R] T}@T{ -\f[C]unsigned int *\f[R] +\f[CR]unsigned int *\f[R] T}@T{ number of array elements. This option was added in Connector/C 3.0 and requires MariaDB 10.2 or later T} T{ -\f[C]STMT_ATTR_ROW_SIZE\f[R] +\f[CR]STMT_ATTR_ROW_SIZE\f[R] T}@T{ -\f[C]size_t *\f[R] +\f[CR]size_t *\f[R] T}@T{ specifies size of a structure for row wise binding. This length must include space for all of the bound parameters and any @@ -111,8 +105,8 @@ T} .TE .SS Notes .IP \[bu] 2 -If you use the \f[C]MYSQL_STMT_ATTR_CURSOR_TYPE\f[R] option with -\f[C]MYSQL_CURSOR_TYPE_READ_ONLY\f[R], a cursor is opened for the +If you use the \f[CR]MYSQL_STMT_ATTR_CURSOR_TYPE\f[R] option with +\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]. If there is already an open cursor from a previous \f[B]mysql_stmt_execute(3)\f[R] call, it closes the cursor before diff --git a/man/mysql_stmt_bind_param.3 b/man/mysql_stmt_bind_param.3 index a92672ed..29fbb04a 100644 --- a/man/mysql_stmt_bind_param.3 +++ b/man/mysql_stmt_bind_param.3 @@ -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" -.hy +.TH "mysql_stmt_bind_param" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_bind_param \- Binds parameter to a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_bind_param(MYSQL_STMT * stmt, MYSQL_BIND * bind); -\f[R] -.fi +.EE .SS Description -.PP Binds variables for parameter markers in the prepared statement that was passed to \f[B]mysql_stmt_prepare(3)\f[R]. Returns zero on success, non\-zero on failure. .SS Parameters .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]. .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. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_bind_result.3 b/man/mysql_stmt_bind_result.3 index 70ecdcbd..9f02475d 100644 --- a/man/mysql_stmt_bind_result.3 +++ b/man/mysql_stmt_bind_result.3 @@ -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" -.hy +.TH "mysql_stmt_bind_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_bind_result \- binds result columns to variables .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_bind_result(MYSQL_STMT * stmt, MYSQL_BIND * bind); -\f[R] -.fi +.EE .SS Description -.PP Binds columns in the result set to variables. Returns zero on success, non\-zero on failure. .SS Parameters .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]. .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 set. .SS Notes diff --git a/man/mysql_stmt_close.3 b/man/mysql_stmt_close.3 index a7499ee8..f5ae3431 100644 --- a/man/mysql_stmt_close.3 +++ b/man/mysql_stmt_close.3 @@ -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" -.hy +.TH "mysql_stmt_close" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_close \- Closes a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_close(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Closes a prepared statement and deallocates the statement handle. If the current statement has pending or unread results, this function cancels them so that the next query can be executed. .SS Parameter .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]. .SS Return value -.PP Returns zero on success, nonzero on error (when communicating with the server). The statement is deallocated, regardless of the error. diff --git a/man/mysql_stmt_data_seek.3 b/man/mysql_stmt_data_seek.3 index 9b896f44..ed55665d 100644 --- a/man/mysql_stmt_data_seek.3 +++ b/man/mysql_stmt_data_seek.3 @@ -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" -.hy +.TH "mysql_stmt_data_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_data_seek \- Seeks to an arbitrary row in statement result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_stmt_data_seek(MYSQL_STMT * stmt, my_ulonglong offset); -\f[R] -.fi +.EE .SS Description -.PP Seeks to an arbitrary row in statement result set obtained by a previous call to \f[B]mysql_stmt_store_result(3)\f[R]. .SS Parameter .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]. .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. .SS Return value -.PP Returns void .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_errno.3 b/man/mysql_stmt_errno.3 index a523b2d9..a1a698b9 100644 --- a/man/mysql_stmt_errno.3 +++ b/man/mysql_stmt_errno.3 @@ -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" -.hy +.TH "mysql_stmt_errno" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_errno \- Returns error code for the last statement error .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_stmt_errno(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the error code for the most recently invoked statement function that can succeed or fail. .SS Parameter .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]. .SS Return value -.PP Returns error code. A zero value means that no error occurred. .SS Notes .IP \[bu] 2 -Client error messages are listed in \f[C]errmsg.h\f[R] header file, -server error messages are listed in \f[C]mysqld_error.h\f[R] header file -of the server source distribution. +Client error messages are listed in \f[CR]errmsg.h\f[R] header file, +server error messages are listed in \f[CR]mysqld_error.h\f[R] header +file of the server source distribution. .SS See Also .IP \[bu] 2 \f[B]mysql_stmt_error(3)\f[R], diff --git a/man/mysql_stmt_error.3 b/man/mysql_stmt_error.3 index c58d5804..cb8821ed 100644 --- a/man/mysql_stmt_error.3 +++ b/man/mysql_stmt_error.3 @@ -1,37 +1,32 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_error" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_error" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_error \- Returns a string description for the last statement error .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_stmt_error(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns a string containing the error message for the most recently invoked statement function that can succeed or fail. The string will be empty if no error occurred. .SS Parameter .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]. .SS Return value .IP \[bu] 2 A string describing the last error or an empty string if no error -occured. +occurred. .SS Notes .IP \[bu] 2 -Client error messages are listed in the \f[C]errmsg.h\f[R] header file, -server error messages are listed in the \f[C]mysqld_error.h\f[R] header +Client error messages are listed in the \f[CR]errmsg.h\f[R] header file, +server error messages are listed in the \f[CR]mysqld_error.h\f[R] header file of the server source distribution. .SS See Also .IP \[bu] 2 diff --git a/man/mysql_stmt_execute.3 b/man/mysql_stmt_execute.3 index 34056f44..e6f1a861 100644 --- a/man/mysql_stmt_execute.3 +++ b/man/mysql_stmt_execute.3 @@ -1,31 +1,25 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_execute" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_execute" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_execute \- Executes a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_execute(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Executes a prepared statement which was previously prepared by \f[B]mysql_stmt_prepare(3)\f[R]. When executed any parameter markers which exist will automatically be replaced with the appropriate data. .SS Parameter .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]. .SS Return value -.PP Returns zero on success, non\-zero on failure. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_fetch.3 b/man/mysql_stmt_fetch.3 index 49ab8576..68bc6d33 100644 --- a/man/mysql_stmt_fetch.3 +++ b/man/mysql_stmt_fetch.3 @@ -1,31 +1,25 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_fetch" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_fetch" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_fetch \- Fetches result set row from a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_fetch(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Fetch the result from a prepared statement into the buffer bound by [mysql_stmt_bind_result()}(mysql_stmt_bind_result). .SS Parameter .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]. .SS Return value -.PP -Returns \f[C]0\f[R] for success, \f[C]MYSQL_NO_DATA\f[R] if the end of -the result set has been reached, or \f[C]MYSQL_DATA_TRUNCATION\f[R] if +Returns \f[CR]0\f[R] for success, \f[CR]MYSQL_NO_DATA\f[R] if the end of +the result set has been reached, or \f[CR]MYSQL_DATA_TRUNCATION\f[R] if one or more values are truncated. .SS Notes .IP \[bu] 2 @@ -38,7 +32,7 @@ reduces memory cost). .IP \[bu] 2 Truncation reporting must be enabled by function \f[B]mysql_optionsv(3)\f[R] with option -\f[C]MYSQL_REPORT_DATA_TRUNCATION\f[R] +\f[CR]MYSQL_REPORT_DATA_TRUNCATION\f[R] .SS See Also .IP \[bu] 2 \f[B]mysql_stmt_prepare(3)\f[R] diff --git a/man/mysql_stmt_fetch_column.3 b/man/mysql_stmt_fetch_column.3 index d0c559a8..c9b8651d 100644 --- a/man/mysql_stmt_fetch_column.3 +++ b/man/mysql_stmt_fetch_column.3 @@ -1,38 +1,32 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_fetch_column" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_fetch_column" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_fetch_column \- Fetches a single column into bind buffer .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_fetch_column(MYSQL_STMT * stmt, MYSQL_BIND * bind_arg, unsigned int column, unsigned long offset); -\f[R] -.fi +.EE .SS Description -.PP This function can be used to fetch large data of a single column in pieces. .SS Parameter .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]. .IP \[bu] 2 -\f[C]bind_arg\f[R] \- a pointer to a MYSQL_BIND structure. +\f[CR]bind_arg\f[R] \- a pointer to a MYSQL_BIND structure. .IP \[bu] 2 -\f[C]column\f[R] \- number of column, first column is numbered zero. +\f[CR]column\f[R] \- number of column, first column is numbered zero. .IP \[bu] 2 -\f[C]offset\f[R] \- offset at which to begin retrieving data. +\f[CR]offset\f[R] \- offset at which to begin retrieving data. .SS Return value -.PP Returns zero on success, non\-zero on failure. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_field_count.3 b/man/mysql_stmt_field_count.3 index fa239a9c..23ea0bac 100644 --- a/man/mysql_stmt_field_count.3 +++ b/man/mysql_stmt_field_count.3 @@ -1,35 +1,29 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_field_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_field_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_field_count \- Returns the number of fields in a result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_stmt_field_count(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of fields in a result set of a prepared statement. .SS Return value -.PP Number of fields or zero if the prepared statement has no result set. .SS Parameter .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]. .SS Notes .IP \[bu] 2 The number of fields will be available after calling \f[B]mysql_stmt_prepare(3)\f[R] .IP \[bu] 2 -\f[C]mysql_stmt_field_count()\f[R] returns zero for statements which +\f[CR]mysql_stmt_field_count()\f[R] returns zero for statements which don\[cq]t produce a result set. .SS See Also .IP \[bu] 2 diff --git a/man/mysql_stmt_free_result.3 b/man/mysql_stmt_free_result.3 index 2ca10517..37c657d5 100644 --- a/man/mysql_stmt_free_result.3 +++ b/man/mysql_stmt_free_result.3 @@ -1,29 +1,23 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_free_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_free_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_free_result \- Frees stored result set memory of a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_stmt_free_result(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Frees stored result memory of a prepared statement. .SS Parameter .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]. .SS Return value -.PP Returns void .SS See Also .IP \[bu] 2 diff --git a/man/mysql_stmt_init.3 b/man/mysql_stmt_init.3 index 8844aeb2..ff9abe3d 100644 --- a/man/mysql_stmt_init.3 +++ b/man/mysql_stmt_init.3 @@ -1,34 +1,28 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_init" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_init" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_init \- Initializes a prepared statement handle .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_STMT * mysql_stmt_init(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Initializes and allocates memory for a prepared statement. .SS Parameter .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_real_connect(3)\f[R]. .SS Return value -.PP -Returns a pointer to a \f[C]MYSQL_STMT\f[R] structure or \f[C]NULL\f[R] -if an error occurred. +Returns a pointer to a \f[CR]MYSQL_STMT\f[R] structure or +\f[CR]NULL\f[R] if an error occurred. .SS Notes .IP \[bu] 2 -Members of the \f[C]MYSQL_STMT\f[R] structure are not intended for +Members of the \f[CR]MYSQL_STMT\f[R] structure are not intended for application use. .IP \[bu] 2 A statement handle which was allocated by mysql_stmt_init() needs to be diff --git a/man/mysql_stmt_insert_id.3 b/man/mysql_stmt_insert_id.3 index 60219704..cccce142 100644 --- a/man/mysql_stmt_insert_id.3 +++ b/man/mysql_stmt_insert_id.3 @@ -1,26 +1,21 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_insert_id" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_insert_id" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_insert_id \- Returns the auto generated id from previously executed prepared statement. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_ulonglong mysql_stmt_insert_id(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP -The \f[C]mysql_stmt_insert_id()\f[R] function returns the ID generated +The \f[CR]mysql_stmt_insert_id()\f[R] function returns the ID generated by a prepared statement on a table with a column having the -\f[C]AUTO_INCREMENT\f[R] attribute. -## Parameter * \f[C]stmt\f[R] \- a statement handle, which was +\f[CR]AUTO_INCREMENT\f[R] attribute. +## Parameter * \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by \f[B]mysql_stmt_init(3)\f[R]. ## Return value Returns the auto generated id from previously executed prepared statement. diff --git a/man/mysql_stmt_more_results.3 b/man/mysql_stmt_more_results.3 index 43f758dc..25953ec3 100644 --- a/man/mysql_stmt_more_results.3 +++ b/man/mysql_stmt_more_results.3 @@ -1,36 +1,29 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_more_results" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_more_results" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_more_results \- indicates if one or more results from a previously executed prepared statement are available .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_more_results(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Indicates if one or more result sets are available from a previous call to \f[B]mysql_stmt_execute(3)\f[R]. .SS Parameter .IP \[bu] 2 -\f[C]stmt\f[R] \- a statement handle, which was previously allocated by -mysql_stmt_init() (mysql_init) and executed by -\f[B]mysql_stmt_execute(3)\f[R]. +\f[CR]stmt\f[R] \- a statement handle, which was previously allocated by +mysql_stmt_init() and executed by \f[B]mysql_stmt_execute(3)\f[R]. .SS Notes .IP \[bu] 2 Multiple result sets can be obtained by calling a stored procedure. Executing concatenated statements is not supported in prepared statement protocol. .SS Return value -.PP Returns 1 if more result sets are available, otherwise zero. .SS See also .IP \[bu] 2 diff --git a/man/mysql_stmt_next_result.3 b/man/mysql_stmt_next_result.3 index b7474ef5..c0c12f06 100644 --- a/man/mysql_stmt_next_result.3 +++ b/man/mysql_stmt_next_result.3 @@ -1,31 +1,25 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_next_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_next_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_next_result \- prepares next result set of a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_next_result(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Prepares next result set from a previous call to \f[B]mysql_stmt_execute(3)\f[R] which can be retrieved by \f[B]mysql_stmt_store_result(3)\f[R]. .SS Parameter .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().]] .SS Return value -.PP Returns zero on success, nonzero if an error occurred. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_num_rows.3 b/man/mysql_stmt_num_rows.3 index 15312a11..e710c4ca 100644 --- a/man/mysql_stmt_num_rows.3 +++ b/man/mysql_stmt_num_rows.3 @@ -1,32 +1,26 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_num_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_num_rows" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_num_rows \- Returns number of rows in a prepared statement result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long long mysql_stmt_num_rows(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of rows in the result set. The use of mysql_stmt_num_rows() depends on whether or not you used \f[B]mysql_stmt_store_result(3)\f[R] to buffer the entire result set in the statement handle. .SS Parameter .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]. .SS Return value -.PP Number of rows in the result set .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_param_count.3 b/man/mysql_stmt_param_count.3 index 79ab3585..0af757af 100644 --- a/man/mysql_stmt_param_count.3 +++ b/man/mysql_stmt_param_count.3 @@ -1,37 +1,31 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_param_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_param_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_param_count \- Returns number of parameters .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long mysql_stmt_param_count(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of parameter markers present in the prepared statement. -Parameter markers are specified as \f[C]?\f[R] (question mark) +Parameter markers are specified as \f[CR]?\f[R] (question mark) .SS Parameter .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]. .SS Return value -.PP The number of parameter markers in prepared statement. .SS Notes .IP \[bu] 2 This function will not deliver a valid result until -mysql_stmt_prepare()() (mysql_stmt_prepare) was called. +mysql_stmt_prepare()() was called. .SS See Also .IP \[bu] 2 -mysql_stmt_prepare()() (mysql_stmt_prepare) +mysql_stmt_prepare()() .IP \[bu] 2 \f[B]mysql_stmt_field_count(3)\f[R] diff --git a/man/mysql_stmt_param_metadata.3 b/man/mysql_stmt_param_metadata.3 index 8ec3eeea..118f3f07 100644 --- a/man/mysql_stmt_param_metadata.3 +++ b/man/mysql_stmt_param_metadata.3 @@ -1,27 +1,21 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_param_metadata" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_param_metadata" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_param_metadata \- This function does nothing! .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_RES * mysql_stmt_param_metadata(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP This function does nothing, it\[cq]s not implemented now and reserved for future use. .SS Parameter .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]. .SS Return value -.PP -Always returns \f[C]NULL\f[R]. +Always returns \f[CR]NULL\f[R]. diff --git a/man/mysql_stmt_prepare.3 b/man/mysql_stmt_prepare.3 index 2478328b..5e2ed320 100644 --- a/man/mysql_stmt_prepare.3 +++ b/man/mysql_stmt_prepare.3 @@ -1,34 +1,28 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_prepare" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_prepare" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_prepare \- Prepares an SQL string .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_prepare(MYSQL_STMT * stmt, const char * query, unsigned long length); -\f[R] -.fi +.EE .SS Description -.PP Prepares the SQL query. .SS Parameter .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]. .IP \[bu] 2 -\f[C]query\f[R] \- SQL statement +\f[CR]query\f[R] \- SQL statement .IP \[bu] 2 -\f[C]length\f[R] \- length of SQL statement +\f[CR]length\f[R] \- length of SQL statement .SS Return value -.PP Zero on success, non zero on error. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_reset.3 b/man/mysql_stmt_reset.3 index 84c7228e..814e0b32 100644 --- a/man/mysql_stmt_reset.3 +++ b/man/mysql_stmt_reset.3 @@ -1,33 +1,27 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_reset" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_reset" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_reset \- Resets a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_reset(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Resets a prepared statement on client and server to state after prepare. .SS Parameter .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]. Returns zero on success, nonzero if an error occurred. .SS Return value -.PP -Returns zero on succes, 1 if an error occured. +Returns zero on success, 1 if an error occurred. .SS Notes .IP \[bu] 2 -\f[C]mysql_stmt_reset()\f[R] resets the statement on the server, +\f[CR]mysql_stmt_reset()\f[R] resets the statement on the server, unbuffered result sets and errors. Bindings and stored result sets will not be cleared. The latter one will be cleared when re\-executing or closing the diff --git a/man/mysql_stmt_result_metadata.3 b/man/mysql_stmt_result_metadata.3 index 2b8357f1..57136eca 100644 --- a/man/mysql_stmt_result_metadata.3 +++ b/man/mysql_stmt_result_metadata.3 @@ -1,32 +1,26 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_result_metadata" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_result_metadata" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_result_metadata \- Returns result set metadata from a prepared statement. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_RES * mysql_stmt_result_metadata(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP If a statement passed to \f[B]mysql_stmt_prepare(3)\f[R] is one that produces a result set, mysql_stmt_result_metadata() returns the result set that can be used to process the meta information such as total number of fields and individual field information. .SS Parameter .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]. .SS Return value -.PP Returns a result set that can be used to process metadata information. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_row_seek.3 b/man/mysql_stmt_row_seek.3 index f225ff74..8f0c4c28 100644 --- a/man/mysql_stmt_row_seek.3 +++ b/man/mysql_stmt_row_seek.3 @@ -1,37 +1,30 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_row_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_row_seek" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_row_seek \- Positions row cursor. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_ROW_OFFSET mysql_stmt_row_seek(MYSQL_STMT * stmt, MYSQL_ROW_OFFSET offset); -\f[R] -.fi +.EE .SS Description -.PP Positions the row cursor to an arbitrary row in a result set which was obtained by \f[B]mysql_stmt_store_result(3)\f[R]. .SS Parameter .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]. .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_stmt_row_seek() or \f[B]mysql_stmt_row_tell(3)\f[R]. .SS Return value -.PP Returns the previous row offset. .SS Notes -.PP The result set must be obtained by \f[B]mysql_use_result(3)\f[R]. .SS See Also .IP \[bu] 2 diff --git a/man/mysql_stmt_row_tell.3 b/man/mysql_stmt_row_tell.3 index ef754c20..5b33866a 100644 --- a/man/mysql_stmt_row_tell.3 +++ b/man/mysql_stmt_row_tell.3 @@ -1,30 +1,24 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_row_tell" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_row_tell" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_row_tell \- Returns position of row cursor .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_ROW_OFFSET mysql_stmt_row_tell(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the row offset of a result cursor. The returned offset value can be used to reposition the result cursor by calling \f[B]mysql_stmt_row_seek(3)\f[R]. .SS Parameter .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]. .SS Return value -.PP Returns the current position of the row cursor. .SS Notes .IP \[bu] 2 diff --git a/man/mysql_stmt_send_long_data.3 b/man/mysql_stmt_send_long_data.3 index 4955d144..4d0c29b2 100644 --- a/man/mysql_stmt_send_long_data.3 +++ b/man/mysql_stmt_send_long_data.3 @@ -1,47 +1,41 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_send_long_data" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_send_long_data" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_send_long_data \- Sends data in chunks .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_stmt_send_long_data(MYSQL_STMT * stmt, unsigned int, const char * data, unsigned long); -\f[R] -.fi +.EE .SS Description -.PP Allows sending parameter data to the server in pieces (or chunks), e.g.\ if the size of a blob exceeds the size of max_allowed_packet size. This function can be called multiple times to send the parts of a character or binary data value for a column, which must be one of the -\f[C]TEXT\f[R] or \f[C]BLOB\f[R] datatypes. +\f[CR]TEXT\f[R] or \f[CR]BLOB\f[R] datatypes. .SS Parameter .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]. .IP \[bu] 2 -\f[C]param_no\f[R] \- indicates which parameter to associate the data +\f[CR]param_no\f[R] \- indicates which parameter to associate the data with. Parameters are numbered beginning with 0. .IP \[bu] 2 -\f[C]data\f[R] \- a buffer containing the data to send. +\f[CR]data\f[R] \- a buffer containing the data to send. .IP \[bu] 2 -\f[C]long\f[R] \- size of the data buffer. +\f[CR]long\f[R] \- size of the data buffer. .SS Return value -.PP Returns zero on success, nonzero if an error occurred. .SS Notes .IP \[bu] 2 -\f[C]mysql_stmt_send_long_data()\f[R] must be called before +\f[CR]mysql_stmt_send_long_data()\f[R] must be called before \f[B]mysql_stmt_execute(3)\f[R]. .IP \[bu] 2 bound variables for this column will be ignored when calling diff --git a/man/mysql_stmt_sqlstate.3 b/man/mysql_stmt_sqlstate.3 index d46f3de3..5fc33053 100644 --- a/man/mysql_stmt_sqlstate.3 +++ b/man/mysql_stmt_sqlstate.3 @@ -1,31 +1,25 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_sqlstate" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_sqlstate" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_sqlstate \- Returns SQLSTATE error from previous statement operation. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] const char * mysql_stmt_sqlstate(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns a string containing the SQLSTATE error code for the most recently invoked prepared statement function that can succeed or fail. -## Parameter * \f[C]stmt\f[R] \- a statement handle, which was +## Parameter * \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by \f[B]mysql_stmt_init(3)\f[R]. ## Return value Returns a 5 digit error code. `00000' means no error. The values are specified by ANSI SQL and ODBC. .SS Notes -.PP Please note that not all client library error codes are mapped to SQLSTATE errors. Errors which can\[cq]t be mapped will returned as value HY000. diff --git a/man/mysql_stmt_store_result.3 b/man/mysql_stmt_store_result.3 index fe98e461..2a993878 100644 --- a/man/mysql_stmt_store_result.3 +++ b/man/mysql_stmt_store_result.3 @@ -1,32 +1,26 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_store_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_store_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_store_result \- Transfers a result set from a prepared statement .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] int mysql_stmt_store_result(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP You must call mysql_stmt_store_result() for every query that successfully produces a result set only if you want to buffer the complete result set by the client, so that the subsequent \f[B]mysql_stmt_fetch(3)\f[R] call returns buffered data. .SS Parameter .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]. .SS Return value -.PP Returns zero on success, nonzero if an error occurred. ## Notes * You can detect whether the statement produced a result set by checking the return value of \f[B]mysql_stmt_field_count(3)\f[R] diff --git a/man/mysql_stmt_warning_count.3 b/man/mysql_stmt_warning_count.3 index 2190719b..74258b14 100644 --- a/man/mysql_stmt_warning_count.3 +++ b/man/mysql_stmt_warning_count.3 @@ -1,36 +1,30 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_stmt_warning_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_stmt_warning_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_stmt_warning_count \- Returns the number of warnings from the last executed statement. .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_stmt_warning_count(MYSQL_STMT * stmt); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of warnings from the last executed statement, or zero if there are no warnings. -## Parameter * \f[C]stmt\f[R] \- a statement handle, which was +## Parameter * \f[CR]stmt\f[R] \- a statement handle, which was previously allocated by \f[B]mysql_stmt_init(3)\f[R]. .SS Return value -.PP Returns the number of warnings. .SS Notes .IP \[bu] 2 For retrieving warning messages you should use the SQL command -\f[C]SHOW WARNINGS\f[R]. +\f[CR]SHOW WARNINGS\f[R]. .IP \[bu] 2 -If SQL_MODE \f[C]TRADITIONAL\f[R] is enabled an error instead of warning -will be returned. +If SQL_MODE \f[CR]TRADITIONAL\f[R] is enabled an error instead of +warning will be returned. For detailed information check the server documentation. ## History This function was added in Connector/C 3.0. .SS See Also diff --git a/man/mysql_store_result.3 b/man/mysql_store_result.3 index 5669063a..14c8160b 100644 --- a/man/mysql_store_result.3 +++ b/man/mysql_store_result.3 @@ -1,39 +1,32 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_store_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_store_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_store_result \- returns a buffered result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_RES * mysql_store_result(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns a buffered resultset from the last executed query. ### Notes .IP \[bu] 2 -mysql_field_count() (imysql_field_count) indicates if there will be a -result set available. +mysql_field_count() indicates if there will be a result set available. .IP \[bu] 2 The memory allocated by mysql_store_result() needs to be released by calling the function \f[B]mysql_free_result(3)\f[R]. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .SS Return value -.PP -Returns a buffered result set or NULL in case an error occured or if the -query didn\[cq]t return data (e.g.\ when executing an INSERT, UPDATE, -DELETE or REPLACE statement). +Returns a buffered result set or NULL in case an error occurred or if +the query didn\[cq]t return data (e.g.\ when executing an INSERT, +UPDATE, DELETE or REPLACE statement). ## See also * \f[B]mysql_free_result(3)\f[R] * \f[B]mysql_use_result(3)\f[R] * \f[B]mysql_real_query(3)\f[R] * \f[B]mysql_field_count(3)\f[R] diff --git a/man/mysql_thread_end.3 b/man/mysql_thread_end.3 index a7c91926..37b6b60b 100644 --- a/man/mysql_thread_end.3 +++ b/man/mysql_thread_end.3 @@ -1,33 +1,26 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_thread_end" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_thread_end" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_thread_end \- Releases thread specific memory .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] void mysql_thread_end(void ); -\f[R] -.fi +.EE .SS Description -.PP The mysql_thread_end() function needs to be called before a client thread ends. It will release thread specific memory, which was allocated by a previous \f[B]mysql_thread_init(3)\f[R] call. Returns void. .SS Notes -.PP Unlike \f[B]mysql_thread_init(3)\f[R] mysql_thread_end() will not be invoked automatically if the thread ends. To avoid memory leaks mysql_thread_end() must be called explicitly. .SS History -.PP This function is deprecated since MariaDB Connector/C 3.0.0. .SS See also .IP \[bu] 2 diff --git a/man/mysql_thread_id.3 b/man/mysql_thread_id.3 index a46fc7ca..1fe22aae 100644 --- a/man/mysql_thread_id.3 +++ b/man/mysql_thread_id.3 @@ -1,26 +1,21 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_thread_id" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_thread_id" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_thread_id \- Returns id of the current connection .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned long mysql_thread_id(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP The mysql_thread_id() function returns the thread id for the current connection. .SS Parameter .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_real_connect(3)\f[R]. ### Notes @@ -30,7 +25,6 @@ The current connection can be killed with \f[B]mysql_kill(3)\f[R]. If reconnect option is enabled the thread id might change if the client reconnects to the server. .SS Return value -.PP Returns the thread id of the current connection. .SS See also .IP \[bu] 2 diff --git a/man/mysql_thread_init.3 b/man/mysql_thread_init.3 index c382a555..2bc3c069 100644 --- a/man/mysql_thread_init.3 +++ b/man/mysql_thread_init.3 @@ -1,21 +1,16 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_thread_init" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_thread_init" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_thread_init \- initialize thread .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] my_bool mysql_thread_init(void ); -\f[R] -.fi +.EE .SS Description -.PP Thread initialization for multi threaded clients. Multi threaded clients should call mysql_thread_init() at the beginning of the thread initialization to initialize thread specific client @@ -24,15 +19,12 @@ If mysql_thread_init() was not called explicitly, it will be called automatically by \f[B]mysql_init(3)\f[R] or \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP Before a client thread ends the \f[B]mysql_thread_end(3)\f[R] function must be called to release memory \- otherwise the client library will report an error. .SS Return value -.PP Returns zero if successful or 1 if an error occurred. .SS History -.PP This function is deprecated since MariaDB Connector/C 3.0.0. .SS See also .IP \[bu] 2 diff --git a/man/mysql_use_result.3 b/man/mysql_use_result.3 index a0777c29..59a4efcf 100644 --- a/man/mysql_use_result.3 +++ b/man/mysql_use_result.3 @@ -1,21 +1,16 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_use_result" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_use_result" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_use_result \- returns an unbuffered result set .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] MYSQL_RES * mysql_use_result(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Used to initiate the retrieval of a result set from the last query executed using the mysql_real_query() function on the database connection. @@ -25,11 +20,10 @@ other must be called to prevent the next query on that database connection from failing. .SS Parameters .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 \f[B]mysql_real_connect(3)\f[R]. .SS Notes -.PP The mysql_use_result() function does not transfer the entire result set. Hence several functions like \f[B]mysql_num_rows(3)\f[R] or \f[B]mysql_data_seek(3)\f[R] cannot be used. @@ -37,8 +31,8 @@ mysql_use_result() will block the current connection until all result sets are retrieved or result set was released by \f[B]mysql_free_result(3)\f[R]. .SS Return value -.PP -Returns an unbuffered result set or \f[C]NULL\f[R] if an error occurred. +Returns an unbuffered result set or \f[CR]NULL\f[R] if an error +occurred. .SS See also .IP \[bu] 2 \f[B]mysql_store_result(3)\f[R] diff --git a/man/mysql_warning_count.3 b/man/mysql_warning_count.3 index 166bbf29..136ecca8 100644 --- a/man/mysql_warning_count.3 +++ b/man/mysql_warning_count.3 @@ -1,38 +1,32 @@ -.\" Automatically generated by Pandoc 2.5 +.\" Automatically generated by Pandoc 3.5 .\" -.TH "mysql_warning_count" "3" "" "Version 3.3.1" "MariaDB Connector/C" -.hy +.TH "mysql_warning_count" "3" "" "Version 3.4.2" "MariaDB Connector/C" .SS Name -.PP mysql_warning_count \- Returns the number of warnings .SS Synopsis .IP -.nf -\f[C] -#include +.EX +#include \f[B]\f[R] unsigned int mysql_warning_count(MYSQL * mysql); -\f[R] -.fi +.EE .SS Description -.PP Returns the number of warnings from the last executed query, or zero if there are no warnings. .SS Parameter .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_real_connect(3)\f[R]. .SS Notes .IP \[bu] 2 For retrieving warning messages you should use the SQL command -\f[C]SHOW WARNINGS\f[R]. +\f[CR]SHOW WARNINGS\f[R]. .IP \[bu] 2 -If SQL_MODE \f[C]TRADITIONAL\f[R] is enabled an error instead of warning -will be returned. +If SQL_MODE \f[CR]TRADITIONAL\f[R] is enabled an error instead of +warning will be returned. For detailed information check the server documentation. .SS Return value -.PP Returns the number of warnings .SS See also .IP \[bu] 2