Oracle 5.0, Reference Manual

Page: 2183 / 3232

C API Function Descriptions
2163
This function is deprecated. It is preferable to use
mysql_query()
to issue an SQL
KILL
statement
instead.
Return Values
Zero for success. Nonzero if an error occurred.
Errors
•
CR_COMMANDS_OUT_OF_SYNC
[2942]
Commands were executed in an improper order.
•
CR_SERVER_GONE_ERROR
[2942]
The MySQL server has gone away.
•
CR_SERVER_LOST
[2942]
The connection to the server was lost during the query.
•
CR_UNKNOWN_ERROR
[2941]
An unknown error occurred.
20.6.6.39.
mysql_library_end()
void mysql_library_end(void)
Description
This function finalizes the MySQL library. Call it when you are done using the library (for example, after
disconnecting from the server). The action taken by the call depends on whether your application is
linked to the MySQL client library or the MySQL embedded server library. For a client program linked
against the
libmysqlclient
library by using the
-lmysqlclient
flag,
mysql_library_end()
performs some memory management to clean up. For an embedded server application linked against
the
libmysqld
library by using the
-lmysqld
flag,
mysql_library_end()
shuts down the
embedded server and then cleans up.
For usage information, see Section 20.6.5, “C API Function Overview” , and Section 20.6.6.40,
“
mysql_library_init()
” .
mysql_library_end()
was added in MySQL 5.0.3. For older versions of MySQL, call
mysql_server_end()
instead.
20.6.6.40.
mysql_library_init()
int mysql_library_init(int argc, char **argv, char **groups)
Description
Call this function to initialize the MySQL library before you call any other MySQL function, whether
your application is a regular client program or uses the embedded server. If the application uses the
embedded server, this call starts the server and initializes any subsystems (
mysys
,
InnoDB
, and so
forth) that the server uses.
After your application is done using the MySQL library, call
mysql_library_end()
to clean up. See
Section 20.6.6.39, “
mysql_library_end()
” .
The choice of whether the application operates as a regular client or uses the embedded server
depends on whether you use the
libmysqlclient
or
libmysqld
library at link time to produce the
final executable. For additional information, see Section 20.6.5, “C API Function Overview” .