Book Image

MySQL 5.1 Plugin Development

Book Image

MySQL 5.1 Plugin Development

Overview of this book

MySQL has introduced a Plugin API with its latest version – a robust, powerful, and easy way of extending the server functionality with loadable modules on the fly. But until now anyone wishing to develop a plugin would almost certainly need to dig into the MySQL source code and search the Web for missing bits of the information.This is the first book on the MySQL Plugin API. Written together with one of the Plugin API primary architects, it contains all the details you need to build a plugin. It shows what a plugin should contain and how to compile, install, and package it. Every chapter illustrates the material with thoroughly explained source code examples.Starting from the basic features, common to all plugin types, and the structure of the plugin framework, this book will guide you through the different plugin types, from simple examples to advanced ones. Server monitoring, full-text search in JPEG comments, typo-tolerant searches, getting the list of all user variables, system usage statistics, or a complete storage engine with indexes – these and other plugins are developed in different chapters of this book, demonstrating the power and versatility of the MySQL Plugin API and explaining the intricate details of MySQL Plugin programming.
Table of Contents (16 chapters)
MySQL 5.1 Plugin Development
Credits
About the Authors
About the Reviewer
Preface

Compiling and linking


We will need a Makefile.am file, which looks almost exactly as in the previous chapter:

pkgplugindir = $(pkglibdir)/plugin
INCLUDES = -I$(top_srcdir)/include \
-I$(top_builddir)/include \
-I$(top_srcdir)/sql
noinst_HEADERS = ha_tocab.h
EXTRA_LTLIBRARIES = ha_tocab.la
pkgplugin_LTLIBRARIES= @plugin_tocab_shared_target@
ha_tocab_la_LDFLAGS = -module -rpath $(pkgplugindir)
ha_tocab_la_CXXFLAGS= -DMYSQL_DYNAMIC_PLUGIN
ha_tocab_la_SOURCES = ha_tocab.cc
EXTRA_LIBRARIES = libha_tocab.a
noinst_LIBRARIES = @plugin_tocab_static_target@
libha_tocab_a_SOURCES= ha_tocab.cc
EXTRA_DIST = plug.in

We will also require a plug.in file that has two new lines:

MYSQL_PLUGIN(tocab, [TOCAB Storage Engine],
[Storage Engine that uses Tokyo Cabinet storage library],
[max,max-no-ndb])
MYSQL_PLUGIN_STATIC(tocab, [libha_tocab.a])
MYSQL_PLUGIN_DYNAMIC(tocab, [ha_tocab.la])
AC_CHECK_HEADER([tctdb.h],,[with_plugin_tocab=no])
AC_CHECK_LIB(tokyocabinet,tcbdbopen,,[with_plugin_tocab=no])

Besides declaring...