Gentoo Development Guide

MYSQL-V2.ECLASS

Section: portage (5)
Updated: May 2013
Index Return to Main Contents

NAME

mysql-v2.eclass - This eclass provides most of the functions for mysql ebuilds

DESCRIPTION

The mysql-v2.eclass is the base eclass to build the mysql and alternative projects (mariadb) ebuilds. This eclass uses the mysql-autotools and mysql-cmake eclasses for the specific bits related to the build system. It provides the src_unpack, src_prepare, src_configure, src_compile, src_install, pkg_preinst, pkg_postinst, pkg_config and pkg_postrm phase hooks.

FUNCTIONS

mysql-v2_disable_test: Helper function to disable specific tests.
mysql-v2_configure_minimal: Helper function to configure minimal build
mysql-v2_configure_common: Helper function to configure common builds
mysql-v2_pkg_setup: Perform some basic tests and tasks during pkg_setup phase:
  die if FEATURES="test", USE="-minimal" and not using FEATURES="userpriv"
  check for conflicting use flags
  create new user and group for mysql
  warn about deprecated features
mysql-v2_src_unpack: Unpack the source code
mysql-v2_src_prepare: Apply patches to the source code and remove unneeded bundled libs.
mysql-v2_src_configure: Configure mysql to build the code for Gentoo respecting the use flags.
mysql-v2_src_compile: Compile the mysql code.
mysql-v2_src_install: Install mysql.
mysql-v2_pkg_preinst: Create the user and groups for mysql - die if that fails.
mysql-v2_pkg_postinst: Run post-installation tasks:
  create the dir for logfiles if non-existant
  touch the logfiles and secure them
  install scripts
  issue required steps for optional features
  issue deprecation warnings
mysql-v2_getopt: Use my_print_defaults to extract specific config options
mysql-v2_getoptval: Use my_print_defaults to extract specific config options
mysql-v2_pkg_config: Configure mysql environment.
mysql-v2_pkg_postrm: Remove mysql symlinks.

ECLASS VARIABLES

BUILD ?= autotools: Build type of the mysql version
MYSQL_EXTRAS_VER: The version of the MYSQL_EXTRAS repo to use to build mysql Use "none" to disable it's use
MYSQL_PV_MAJOR = "$(get_version_component_range 1-2 ${PV})": Upstream MySQL considers the first two parts of the version number to be the major version. Upgrades that change major version should always run mysql_upgrade.
MYSQL_VERSION_ID = "": MYSQL_VERSION_ID will be: major * 10e6 + minor * 10e4 + micro * 10e2 + gentoo revision number, all [0..99] This is an important part, because many of the choices the MySQL ebuild will do depend on this variable. In particular, the code below transforms a $PVR like "5.0.18-r3" in "5001803" We also strip off upstream's trailing letter that they use to respin tarballs
XTRADB_VER: Version of the XTRADB storage engine
PERCONA_VER: Designation by PERCONA for a MySQL version to apply an XTRADB release

MAINTAINERS

Maintainers:
- MySQL Team <mysql-bugs@gentoo.org>
- Robin H. Johnson <robbat2@gentoo.org>
- Jorge Manuel B. S. Vicetto <jmbsvicetto@gentoo.org>

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/

FILES

/usr/portage/eclass/mysql-v2.eclass

This document was created by man2html, using the manual pages.
Time: 03:25:01 GMT, May 25, 2013