You've already forked mariadb-connector-c
mirror of
https://github.com/mariadb-corporation/mariadb-connector-c.git
synced 2025-08-08 14:02:17 +03:00
68 lines
2.2 KiB
Groff
68 lines
2.2 KiB
Groff
.\" Automatically generated by Pandoc 3.5
|
|
.\"
|
|
.TH "mysql_session_track_get_first" "3" "" "Version 3.3" "MariaDB Connector/C"
|
|
.SS Name
|
|
mysql_session_track_get_first \- retrieves first session status change
|
|
information
|
|
.SS Synopsis
|
|
.IP
|
|
.EX
|
|
#include \f[B]<mysql.h>\f[R]
|
|
|
|
int mysql_session_track_get_first(MYSQL * mysql,
|
|
\f[B]enum\f[R] enum_session_state_type type,
|
|
const char **data,
|
|
size_t *length );
|
|
.EE
|
|
.SS Description
|
|
\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[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[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
|
|
Further data needs to be obtained by calling
|
|
\f[B]mysql_session_track_get_next(3)\f[R].
|
|
.SS Parameter
|
|
.IP \[bu] 2
|
|
\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[CR]type\f[R] \- type of information.
|
|
Valid values are
|
|
.RS 2
|
|
.IP \[bu] 2
|
|
\f[CR]SESSION_TRACK_SYSTEM_VARIABLES\f[R]
|
|
.IP \[bu] 2
|
|
\f[CR]SESSION_TRACK_SCHEMA\f[R]
|
|
.IP \[bu] 2
|
|
\f[CR]SESSION_TRACK_STATE_CHANGE\f[R]
|
|
.IP \[bu] 2
|
|
\f[CR]SESSION_TRACK_GTIDS\f[R] (unsupported)
|
|
.RE
|
|
.IP \[bu] 2
|
|
\f[CR]data\f[R] \- pointer to data, which must be declared as
|
|
\f[CR]const char *\f[R]
|
|
.IP \[bu] 2
|
|
\f[CR]length\f[R] \- pointer to a \f[CR]size_t\f[R] variable, which will
|
|
contain the length of data
|
|
.SS Returns
|
|
Zero for success, nonzero if no session tracking information is
|
|
available.
|
|
.SS History
|
|
\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
|
|
\f[B]mysql_session_track_get_next(3)\f[R]
|