MySQL CMake参数说明手册

MySQL自5.5版本以后,就开始使用CMake编译工具了。MySQL内幕有篇文章,专门介绍了如何用CMake工具进行新版MySQL的编译安装。

 

原文地址为:4.6 Autotools to CMake Transition Guide



介绍


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

 

命令调用语法


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


configure命令

CMake命令

./configure

cmake .

./configure --help

cmake . -LH or ccmake .


 

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


Autotools:

1
2
make clean
rm config.cache


CMake (Unix/Linux):

1
2
make clean
rm CMakeCache.txt


CMake (Windows):

1
2
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

配置文件(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中,引擎被作为单个的选项来进行控制。假设有以下配置选项:

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

 

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

1
csv myisam myisammrg heap

 

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

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

 

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

 

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

1
2
3
-DWITHOUT_EXAMPLE_STORAGE_ENGINE=1
-DWITHOUT_FEDERATED_STORAGE_ENGINE=1
-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编译选项,新老编译选项的差别在于:之前的是小写,现在全部变成了大写,之前采用双横线,现在使用单横线,之前使用的破折号,现在取而代之的是使用下划线,例如:

1
2
--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

调试模式

--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














本文转自UltraSQL51CTO博客,原文链接:http://blog.51cto.com/ultrasql/1640862 ,如需转载请自行联系原作者

上一篇:核对数据库表记录的shell脚本


下一篇:开源 VS 商业,消息中间件你不知道的那些事