Zero's Blog

MySQL cmake编译参数

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

原文地址为:http://forge.mysql.com/wiki/Autotools_to_CMake_Transition_Guide。

介绍

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

命令调用语法

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

1
2
3
configure命令 CMake命令
./configure cmake .
./configure --help cmake . -LH or ccmake .

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Autotools:
view plain copy
make clean
rm config.cache
CMake (Unix/Linux):
view plain copy
make clean
rm CMakeCache.txt
CMake (Windows):
view plain copy
devenv MySQL.sln /clean
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
配置文件目录 –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

1
2
3
4
5
6
7
8
9
10
11
### 存储引擎选项
存储引擎是以插件的形式存在的,所以,该选项可以控制插件的构建,比如指定使用某个特定的引擎。
--with-plugins配置选项接受两种形式的参数值,它没有对应的CMake配置参数:
* 以逗号(,)分隔的引擎名称列表;
* a "group name" value that is shorthand for a set of engines
在CMake中,引擎被作为单个的选项来进行控制。假设有以下配置选项:

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

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

csv myisam myisammrg heap

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

-DWITH_INNOBASE_STORAGE_ENGINE=1
-DWITH_ARCHIVE_STORAGE_ENGINE=1
-DWITH_BLACKHOLE_STORAGE_ENGINE=1

1
2
3
当然也可以使用“ON”来替代数字1,它们是等效的。
如果你想除去对某种引擎的支持,则在CMake编译选项中使用-DWITHOUT__STORAGE_ENGINE,例如:

-DWITHOUT_EXAMPLE_STORAGE_ENGINE=1
-DWITHOUT_FEDERATED_STORAGE_ENGINE=1
-DWITHOUT_PARTITION_STORAGE_ENGINE=1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
### 库文件加载选项
该选项指明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编译选项,新老编译选项的差别在于:之前的是小写,现在全部变成了大写,之前采用双横线,现在使用单横线,之前使用的破折号,现在取而代之的是使用下划线,例如:
```
--with-debug => WITH_DEBUG=1
--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 无
```