Rechercher dans le manuel MySQL
28.7.17.3 mysql_load_plugin()
struct st_mysql_client_plugin *mysql_load_plugin(MYSQL
*mysql, const char *name, int type, int argc, ...)
Description
Loads a MySQL client plugin, specified by name and type. An error occurs if the type is invalid or the plugin cannot be loaded.
It is not possible to load multiple plugins of the same type. An error occurs if you try to load a plugin of a type already loaded.
Specify the parameters as follows:
mysql
: A pointer to aMYSQL
structure. The plugin API does not require a connection to a MySQL server, but this structure must be properly initialized. The structure is used to obtain connection-related information.name
: The name of the plugin to load.type
: The type of plugin to load, or −1 to disable type checking. If type is not −1, only plugins matching the type are considered for loading.argc
: The number of following arguments (0 if there are none). Interpretation of any following arguments depends on the plugin type.
Another way to cause plugins to be loaded is to set the
LIBMYSQL_PLUGINS
environment variable to a
list of semicolon-separated plugin names. For example:
shell> export LIBMYSQL_PLUGINS="myplugin1;myplugin2"
Plugins named by LIBMYSQL_PLUGINS
are
loaded when the client program calls
mysql_library_init()
. No error
is reported if problems occur loading these plugins.
The LIBMYSQL_PLUGIN_DIR
environment
variable can be set to the path name of the directory in which
to look for client plugins. This variable is used in two ways:
During client plugin preloading, the value of the
--plugin-dir
option is not available, so client plugin loading fails unless the plugins are located in the hardwired default directory. If the plugins are located elsewhere,LIBMYSQL_PLUGIN_DIR
environment variable can be set to the proper directory to enable plugin preloading to succeed.For explicit client plugin loading, the
mysql_load_plugin()
andmysql_load_plugin_v()
C API functions use theLIBMYSQL_PLUGIN_DIR
value if it exists and the--plugin-dir
option was not given. If--plugin-dir
is given,mysql_load_plugin()
andmysql_load_plugin_v()
ignoreLIBMYSQL_PLUGIN_DIR
.
To check for errors, call the
mysql_error()
or
mysql_errno()
function. See
Section 28.7.7.15, “mysql_error()”, and
Section 28.7.7.14, “mysql_errno()”.
MYSQL mysql;
if(!mysql_load_plugin(&mysql, "myplugin",
MYSQL_CLIENT_AUTHENTICATION_PLUGIN, 0))
{
fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
exit(-1);
}
Traduction non disponible
Le manuel MySQL n'est pas encore traduit en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Document créé le 26/06/2006, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/mysql-rf-mysql-load-plugin.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.