MySQL自5.5版本以后,就开始使用CMake编译工具了,因此,你在安装源文件中找不到configure文件是正常的。很多人下到了新版的MySQL,因为找不到configure文件,不知道该怎么继续下去。有没有一篇可供参考的文章呢?其实在http://forge.mysql.com网站上有一篇文章,专门介绍了如何用CMake工具进行新版MySQL的编译安装。

原文地址为:https://dev.mysql.com/doc/internals/en/cmake.html

1、介绍2、命令调用语法3、安装参数选项4、存储引擎选项5、库文件加载选项6、其他选项

介绍

本页将介绍常用编译工具的一些配置选项和这些配置选项在CMake中又是如何进行配置的,然后介绍如何使用CMake工具来构建编译MySQL。

命令调用语法

下表列出了常用编译工具的调用语法和等效的CMake命令。“.”表示你当前的工作目录路径,请根据你所在的目录,适当的替换掉路径“.”。

configure命令

CMake命令

./configure

cmake .

./configure --help

cmake . -LH or ccmake .

[root@typhoeus79 mysql-5.5.8]# cmake . -LH
-- MySQL 5.5.8
-- C warning options: -Wall -Wextra -Wunused -Wwrite-strings -Wno-strict-aliasing -Werror
-- C++ warning options: -Wall -Wextra -Wunused -Wwrite-strings -Wno-strict-aliasing -Werror -Wno-unused-parameter
-- Configuring done
-- Generating done
-- Build files have been written to: /data1/guosong/opdir/mysql-5.5.8
-- Cache values
// Choose the type of build, options are: None(CMAKE_CXX_FLAGS or
 CMAKE_C_FLAGS used) Debug Release RelWithDebInfo MinSizeRel
CMAKE_BUILD_TYPE:STRING=Debug

// Install path prefix, prepended onto install directories.
CMAKE_INSTALL_PREFIX:PATH=/data1/guosong/mysql_debug

// Set to true if this is a community build
COMMUNITY_BUILD:BOOL=ON

// Enable profiling
ENABLED_PROFILING:BOOL=ON

// Enable debug sync (debug builds only)
ENABLE_DEBUG_SYNC:BOOL=ON

// Installation directory layout. Options are: STANDALONE (as in zip or tar.gz installer), RPM, DEB, SVR4
INSTALL_LAYOUT:STRING=STANDALONE

// default MySQL data directory
MYSQL_DATADIR:PATH=/data1/guosong/mysql_debug/data

// MySQL maintainer-specific development environment
MYSQL_MAINTAINER_MODE:BOOL=ON

// C++ warning options used in maintainer builds.
MY_MAINTAINER_CXX_WARNINGS:STRING=-Wall -Wextra -Wunused -Wwrite-strings -Wno-strict-aliasing -Werror -Wno-unused-parameter

// C warning options used in maintainer builds.
MY_MAINTAINER_C_WARNINGS:STRING=-Wall -Wextra -Wunused -Wwrite-strings -Wno-strict-aliasing -Werror -Wdeclaration-after-statement

// Link ARCHIVE statically to the server
WITH_ARCHIVE_STORAGE_ENGINE:BOOL=OFF

// Link BLACKHOLE statically to the server
WITH_BLACKHOLE_STORAGE_ENGINE:BOOL=OFF

// Use dbug/safemutex
WITH_DEBUG:BOOL=ON

// Compile MySQL with embedded server
WITH_EMBEDDED_SERVER:BOOL=OFF

// Options are: none, complex, all
WITH_EXTRA_CHARSETS:STRING=all

// Link FEDERATED statically to the server
WITH_FEDERATED_STORAGE_ENGINE:BOOL=OFF

// Link INNOBASE statically to the server
WITH_INNOBASE_STORAGE_ENGINE:BOOL=ON

// Use bundled libedit
WITH_LIBEDIT:BOOL=ON

// Compile with tcp wrappers support
WITH_LIBWRAP:BOOL=OFF

// Link PARTITION statically to the server
WITH_PARTITION_STORAGE_ENGINE:BOOL=ON

// Link PERFSCHEMA statically to the server
WITH_PERFSCHEMA_STORAGE_ENGINE:BOOL=ON

// Generate PIC objects
WITH_PIC:BOOL=ON

// Use bundled readline
WITH_READLINE:BOOL=OFF

// Options are : no, bundled, yes (prefer os library if present otherwise use bundled), system (use os library)
WITH_SSL:STRING=no

// Compile MySQL with unit tests
WITH_UNIT_TESTS:BOOL=ON

// Valgrind instrumentation
WITH_VALGRIND:BOOL=OFF

// Which zlib to use (possible values are 'bundled' or 'system')
WITH_ZLIB:STRING=system

 

在重新配置或重新构建之前,需要先清除旧的对象文件和缓存信息,方法如下:

Autotools:

view plain   copy

1. make clean 
2. rm config.cache

CMake (Unix/Linux):

view plain   copy

1. make clean 
2. rm CMakeCache.txt

CMake (Windows):

view plain   copy

1. devenv MySQL.sln /clean 
2. del CMakeCache.txt

安装参数选项

在下表中,“CMAKE_INSTALL_PREFIX”的值表示的是安装根目录,其他参数值的路径都是相对于根目录的,当然你也可以直接使用绝对路径,具体如下:

参数值说明

配置选项

CMak选项

安装根目录

--prefix=/usr

-DCMAKE_INSTALL_PREFIX=/usr

mysqld目录

--libexecdir=/usr/sbin

-DINSTALL_SBINDIR=sbin

数据存储目录

--localstatedir=/var/lib/mysql

-DMYSQL_DATADIR=/var/lib/mysql

配置文件(my.cnf)目录

--sysconfdir=/etc/mysql

-DSYSCONFDIR=/etc/mysql

插件目录

--with-plugindir=/usr/lib64/mysql/plugin

-DINSTALL_PLUGINDIR=lib64/mysql/plugin

手册文件目录

--mandir=/usr/share/man

-DINSTALL_MANDIR=share/man

共享数据目录

--sharedstatedir=/usr/share/mysql

-DINSTALL_SHAREDIR=share

Library库目录

--libdir=/usr/lib64/mysql

-DINSTALL_LIBDIR=lib64/mysql

Header安装目录

--includedir=/usr/include/mysql

-DINSTALL_INCLUDEDIR=include/mysql

信息文档目录

--infodir=/usr/share/info

-DINSTALL_INFODIR=share/info

存储引擎选项

存储引擎是以插件的形式存在的,所以,该选项可以控制插件的构建,比如指定使用某个特定的引擎。

--with-plugins配置选项接受两种形式的参数值,它没有对应的CMake配置参数:

① 以逗号(,)分隔的引擎名称列表;

② a "group name" value that is shorthand for a set of engines

在CMake中,引擎被作为单个的选项来进行控制。假设有以下配置选项:

view plain   copy

1. --with-plugins=csv,myisam,myisammrg,heap,innobase,archive,blackhole

上面的参数指定MySQL数据库可以支持哪些数据库引擎,将上述编译选项转换成CMake编译选项时,下面的几个引擎名字可以被省略,因为编译时,默认就支持:

view plain   copy

1. csv myisam myisammrg heap

然后使用下面的编译参数,以启用InnoDB、ARCHIVE和BLACKHOLE引擎支持:

view plain   copy

    1. -DWITH_INNOBASE_STORAGE_ENGINE=1
    2. -DWITH_ARCHIVE_STORAGE_ENGINE=1
    3. -DWITH_BLACKHOLE_STORAGE_ENGINE=1

    当然也可以使用“ON”来替代数字1,它们是等效的。

    如果你想除去对某种引擎的支持,则在CMake编译选项中使用-DWITHOUT_<ENGINE>_STORAGE_ENGINE,例如:

    view plain   copy

    1. -DWITHOUT_EXAMPLE_STORAGE_ENGINE=1
    2. -DWITHOUT_FEDERATED_STORAGE_ENGINE=1
    3. -DWITHOUT_PARTITION_STORAGE_ENGINE=1

    库文件加载选项

    该选项指明Mysql使用库的情况:

    参数值说明

    配置选项

    CMak选项

    readline库

    --with-readline

    -DWITH_READLINE=1

    SSL库

    --with-ssl=/usr

    -DWITH_SSL=system

    zlib库

    --with-zlib-dir=/usr

    -DWITH_ZLIB=system

    libwrap库

    --without-libwrap

    -DWITH_LIBWRAP=0

    其他选项

    CMake编译选项支持大部分之前版本的MySQL编译选项,新老编译选项的差别在于:之前的是小写,现在全部变成了大写,之前采用双横线,现在使用单横线,之前使用的破折号,现在取而代之的是使用下划线,例如:

    view plain   copy

    1. --with-debug => WITH_DEBUG=1
    2. --with-embedded-server => WITH_EMBEDDED_SERVER 

    下面是编译MySQL的新老参数对照表:

    参数值说明

    配置选项

    CMak选项

    TCP/IP端口

    --with-tcp-port-=3306

    -DMYSQL_TCP_PORT=3306

    UNIX socket文件

    --with-unix-socket-path=/tmp/mysqld.sock

    -DMYSQL_UNIX_ADDR=/tmp/mysqld.sock

    启用加载本地数据

    --enable-local-infile

    -DENABLED_LOCAL_INFILE=1

    扩展字符支持

    --with-extra-charsets=all(默认:all)

    -DEXTRA_CHARSETS=all(默认:all)

    默认字符集

    --with-charset=utf8

    -DDEFAULT_CHARSET=utf8

    默认字符校对

    --with-collation=utf8_general_ci

    -DDEFAULT_COLLATION=utf8_general_ci

    Build the server

    --with-server


    嵌入式服务器

    --with-embedded-server

    -DWITH_EMBEDDED_SERVER=1

    libmysqld权限控制

    --with-embedded-privilege-control


    安装文档

    --without-docs


    Big tables支持

    --with-big-tables, --without-big-tables


    mysqld运行用户

    --with-mysqld-user=mysql

    -DMYSQL_USER=mysql

    调试模式

    --without-debug(默认禁用)

    -DWITH_DEBUG=0(默认禁用)

    GIS支持

    --with-geometry


    社区功能

    --enable-community-features


    Profiling

    --disable-profiling(默认启用)

    -DENABLE_PROFILING=0(默认启用)

    pstack

    --without-pstack

    无(新版移除该功能)

    汇编字符串函数

    --enable-assembler


    构建类型

    --build=x86_64-pc-linux-gnu

    没有等效参数

    交叉编译主机

    --host=x86_64-pc-linux-gnu

    没有等效参数

    客户端标志

    --with-client-ldflags=-lstdc++


    线程安全标志

    --enable-thread-safe-client


    注释存储类型

    --with-comment='string'

    -DWITH_COMMENT='string'

    Shared/static binaries

    --enable-shared --enable-static


    内存使用控制

    --with-low-memory