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

Updated man pages (rebuilt with pandoc 3.5)

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

30
man/mariadb_cancel.3
View File

@@ -1,36 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_cancel" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

19
man/mariadb_connection.3
View File

@@ -1,29 +1,22 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_connection" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

28
man/mariadb_dyncol_check.3
View File

@@ -1,32 +1,26 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_check" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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]

26
man/mariadb_dyncol_column_cmp_named.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_column_cmp_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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].

28
man/mariadb_dyncol_column_count.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_column_count" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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

40
man/mariadb_dyncol_create_many_named.3
View File

@@ -1,51 +1,45 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_create_many_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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 <mariadb_dyncol_update_many_named> function
use mariadb_dyncol_update_many_named function
.SS See also
.IP \[bu] 2
<mariadb_dyncol_create_many_num>
mariadb_dyncol_create_many_num
.IP \[bu] 2
<mariadb_dyncol_update_many_named>
mariadb_dyncol_update_many_named
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

42
man/mariadb_dyncol_create_many_num.3
View File

@@ -1,51 +1,45 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_create_many_num" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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 <mariadb_dyncol_update_many_num> function
use mariadb_dyncol_update_many_num function
.SS See also
.IP \[bu] 2
<mariadb_dyncol_create_many_named>
mariadb_dyncol_create_many_named
.IP \[bu] 2
<mariadb_dyncol_update_many_num>
mariadb_dyncol_update_many_num
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

28
man/mariadb_dyncol_exists_named.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_exists_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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>
mariadb_dyncol_exists_num
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

28
man/mariadb_dyncol_exists_num.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_exists_num" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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>
mariadb_dyncol_exists_named
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

21
man/mariadb_dyncol_free.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_free" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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

26
man/mariadb_dyncol_get_named.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_get_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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

26
man/mariadb_dyncol_get_num.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_get_num" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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

18
man/mariadb_dyncol_has_names.3
View File

@@ -1,27 +1,21 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_has_names" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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

24
man/mariadb_dyncol_json.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_json" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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]

34
man/mariadb_dyncol_list_named.3
View File

@@ -1,43 +1,37 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_list_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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>
mariadb_dyncol_list_num
.IP \[bu] 2
<mariadb_dyncol_list_json>
mariadb_dyncol_list_json

34
man/mariadb_dyncol_list_num.3
View File

@@ -1,43 +1,37 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_list_num" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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>
mariadb_dyncol_list_named
.IP \[bu] 2
<mariadb_dyncol_list_json>
mariadb_dyncol_list_json

39
man/mariadb_dyncol_unpack.3
View File

@@ -1,48 +1,43 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_unpack" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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]

36
man/mariadb_dyncol_update_many_named.3
View File

@@ -1,47 +1,41 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_update_many_named" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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>
mariadb_dyncol_create_many_named
.IP \[bu] 2
<mariadb_dyncol_update_many_num>
mariadb_dyncol_update_many_num
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

36
man/mariadb_dyncol_update_many_num.3
View File

@@ -1,47 +1,41 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_dyncol_update_many_num" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_dyncol.h>
.EX
#include \f[B]<mariadb_dyncol.h>\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>
mariadb_dyncol_create_many_num
.IP \[bu] 2
<mariadb_dyncol_update_many_named>
mariadb_dyncol_update_many_named
.IP \[bu] 2
Dynamic Column Error Codes (dyncol_typesanddefs#error-codes)
Dynamic Column Error Codes

55
man/mariadb_field_attr.3
View File

@@ -1,38 +1,32 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_field_attr" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

20
man/mariadb_free_rpl_event.3
View File

@@ -1,26 +1,20 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_free_rpl_event" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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

237
man/mariadb_get_infov.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

27
man/mariadb_reconnect.3
View File

@@ -1,34 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_reconnect" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

22
man/mariadb_rpl_close.3
View File

@@ -1,31 +1,23 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_rpl_close" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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

28
man/mariadb_rpl_fetch.3
View File

@@ -1,42 +1,34 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_rpl_fetch" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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

37
man/mariadb_rpl_get_optionsv.3
View File

@@ -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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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
<mariadb_rpl_init>
\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

21
man/mariadb_rpl_open.3
View File

@@ -1,29 +1,22 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_rpl_open" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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

59
man/mariadb_rpl_optionsv.3
View File

@@ -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 <mariadb_rpl.h>
.EX
#include \f[B]<mariadb_rpl.h>\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
<mariadb_rpl_init>
\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

24
man/mariadb_stmt_execute_direct.3
View File

@@ -1,37 +1,31 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_stmt_execute_direct" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
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=

20
man/mariadb_stmt_fetch_fields.3
View File

@@ -1,36 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mariadb_stmt_fetch_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

29
man/mysql_affected_rows.3
View File

@@ -1,45 +1,38 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_affected_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

63
man/mysql_autocommit.3
View File

@@ -1,35 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_autocommit" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

28
man/mysql_change_user.3
View File

@@ -1,24 +1,19 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_change_user" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

17
man/mysql_close.3
View File

@@ -1,25 +1,20 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_close" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_commit.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_commit" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

20
man/mysql_data_seek.3
View File

@@ -1,35 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_data_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

15
man/mysql_eof.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_eof" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

21
man/mysql_errno.3
View File

@@ -1,34 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_errno" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

23
man/mysql_error.3
View File

@@ -1,39 +1,34 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_error" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

20
man/mysql_fetch_field.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_fetch_field" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

24
man/mysql_fetch_field_direct.3
View File

@@ -1,33 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_fetch_field_direct" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

21
man/mysql_fetch_fields.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_fetch_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

30
man/mysql_fetch_lengths.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_fetch_lengths" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

30
man/mysql_fetch_row.3
View File

@@ -1,42 +1,36 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_fetch_row" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

25
man/mysql_field_count.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_field_count" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

22
man/mysql_field_seek.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_field_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_field_tell.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_field_tell" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

17
man/mysql_free_result.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_free_result" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

21
man/mysql_get_character_set_info.3
View File

@@ -1,32 +1,27 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_character_set_info" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

16
man/mysql_get_client_info.3
View File

@@ -1,25 +1,19 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_client_info" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

16
man/mysql_get_client_version.3
View File

@@ -1,19 +1,14 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_client_version" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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

20
man/mysql_get_host_info.3
View File

@@ -1,31 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_host_info" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

19
man/mysql_get_proto_info.3
View File

@@ -1,32 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_proto_info" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

25
man/mysql_get_server_info.3
View File

@@ -1,35 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_server_info" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

19
man/mysql_get_server_version.3
View File

@@ -1,33 +1,26 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_server_version" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_get_socket.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_socket" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

28
man/mysql_get_ssl_cipher.3
View File

@@ -1,31 +1,26 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_get_ssl_cipher" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

24
man/mysql_hex_string.3
View File

@@ -1,39 +1,33 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_hex_string" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

35
man/mysql_info.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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}

32
man/mysql_init.3
View File

@@ -1,37 +1,31 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_init" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

19
man/mysql_insert_id.3
View File

@@ -1,30 +1,23 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_insert_id" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

24
man/mysql_kill.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_kill" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

20
man/mysql_more_results.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_more_results" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_next_result.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_next_result" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_num_fields.3
View File

@@ -1,28 +1,22 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_num_fields" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

23
man/mysql_num_rows.3
View File

@@ -1,29 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_num_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

22
man/mysql_options.3
View File

@@ -1,37 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_options" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

22
man/mysql_options4.3
View File

@@ -1,38 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_options4" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

367
man/mysql_optionsv.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

23
man/mysql_ping.3
View File

@@ -1,22 +1,17 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_ping" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

20
man/mysql_query.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_query" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

27
man/mysql_read_query_result.3
View File

@@ -1,37 +1,32 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_read_query_result" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

65
man/mysql_real_connect.3
View File

@@ -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

24
man/mysql_real_escape_string.3
View File

@@ -1,46 +1,40 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_real_escape_string" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

22
man/mysql_real_query.3
View File

@@ -1,34 +1,29 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_real_query" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

44
man/mysql_refresh.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

19
man/mysql_reset_connection.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_reset_connection" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

17
man/mysql_rollback.3
View File

@@ -1,26 +1,21 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_rollback" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

20
man/mysql_row_seek.3
View File

@@ -1,30 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_row_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

17
man/mysql_row_tell.3
View File

@@ -1,27 +1,22 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_row_tell" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

68
man/mysql_select_db.3
View File

@@ -1,35 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_select_db" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

38
man/mysql_send_query.3
View File

@@ -1,52 +1,48 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_send_query" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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>
mysql_real_query
.IP \[bu] 2
<mysql_read_query_result>
mysql_read_query_result

21
man/mysql_server_end.3
View File

@@ -1,33 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_server_end" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

25
man/mysql_server_init.3
View File

@@ -1,38 +1,31 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_server_init" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

51
man/mysql_session_track_get_first.3
View File

@@ -1,37 +1,32 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_session_track_get_first" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

44
man/mysql_session_track_get_next.3
View File

@@ -1,62 +1,54 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_session_track_get_next" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

33
man/mysql_set_character_set.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

24
man/mysql_set_server_option.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

26
man/mysql_shutdown.3
View File

@@ -1,40 +1,34 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_shutdown" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

17
man/mysql_sqlstate.3
View File

@@ -1,21 +1,16 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_sqlstate" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

41
man/mysql_ssl_set.3
View File

@@ -1,15 +1,12 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_ssl_set" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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]

21
man/mysql_stat.3
View File

@@ -1,35 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stat" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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()

23
man/mysql_stmt_affected_rows.3
View File

@@ -1,39 +1,34 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_affected_rows" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

56
man/mysql_stmt_attr_get.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

60
man/mysql_stmt_attr_set.3
View File

@@ -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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

19
man/mysql_stmt_bind_param.3
View File

@@ -1,31 +1,26 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_bind_param" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

19
man/mysql_stmt_bind_result.3
View File

@@ -1,30 +1,25 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_bind_result" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

18
man/mysql_stmt_close.3
View File

@@ -1,30 +1,24 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_close" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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.

20
man/mysql_stmt_data_seek.3
View File

@@ -1,34 +1,28 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_data_seek" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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

24
man/mysql_stmt_errno.3
View File

@@ -1,36 +1,30 @@
.\" Automatically generated by Pandoc 2.5
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_stmt_errno" "3" "" "Version 3.3.1" "MariaDB Connector/C"
.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 <mysql.h>
.EX
#include \f[B]<mysql.h>\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],

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