首页 > 代码库 > MySQL CMake参数说明手册

MySQL CMake参数说明手册

2024-08-03 03:16:39   221人阅读

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

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

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

介绍

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

命令调用语法

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

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

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

Autotools： 

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  make clean  
    2. 


   
   
   
   
 
   
 
   
   
  2.  rm config.cache  
    3.

CMake (Unix/Linux)： 

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  make clean  
    2. 


   
   
   
   
 
   
 
   
   
  2.  rm CMakeCache.txt  
    3.

CMake (Windows)： 

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  devenv MySQL.sln /clean  
    2. 


   
   
   
   
 
   
 
   
   
  2.  del CMakeCache.txt  
    3.

安装参数选项

在下表中，“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   
    2.

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

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  csv myisam myisammrg heap  
    2.

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

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  -DWITH_INNOBASE_STORAGE_ENGINE=1  
    2. 


   
   
   
   
 
   
 
   
   
  2.  -DWITH_ARCHIVE_STORAGE_ENGINE=1  
    3. 


   
   
   
   
 
   
 
   
   
  3.  -DWITH_BLACKHOLE_STORAGE_ENGINE=1  
    4.

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

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

  
  


   
   
   
   
 
   
 
   
   view plain   
   
   
   
   
 
   
 
   
   copy

  
  
  
  

  

  
  



  
  
  
  

  

  
  
    


   
   
   
   
 
   
 
   
   
  1.  -DWITHOUT_EXAMPLE_STORAGE_ENGINE=1  
    2. 


   
   
   
   
 
   
 
   
   
  2.  -DWITHOUT_FEDERATED_STORAGE_ENGINE=1  
    3. 


   
   
   
   
 
   
 
   
   
  3.  -DWITHOUT_PARTITION_STORAGE_ENGINE=1  
    4.

库文件加载选项

该选项指明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. 


   
   
   
   
 
   
 
   
   
  2.  --with-embedded-server => WITH_EMBEDDED_SERVER  
    3.

下面是编译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 无

MySQL CMake参数说明手册


联系
我们