configure向cmake过渡指南

网址:http://forge.mysql.com/wiki/Autotools_to_CMake_Transition_Guide

     mysql5.5起,mysql源码安装开始使用cmake了。下面是介绍configure选项如何映射到CMake的等值参数。

 

1. 命令语法:

configure command cmake command
./configure cmake .
./configure –help cmake . -LH or ccmake .

 

 

 

 

 

 

  重新编译时,需要清除旧的对象文件和缓存信息

 # make clean

 # rm -f  CMakeCache.txt

 

     2.安装选项

parameter configure option cmake option
Install base dir –prefix=/usr/local/mysql -DCMAKE_INSTALL_PREFIX=/usr/local/mysql
Mysqld dir –libexecdir=/usr/local/mysql/sbin -DINSTALL_SBINDIR=sbin
Data dir –datadir=/mydata -DMYSQL_DATADIR=/mydata
Config dir –sysconfdir=/etc/mysql -DSYSCONFDIR=/etc/mysql
Plugin dir –with-plugindir=/usr/local/mysql/lib/mysql/plugin -DINSTALL_PLUGINDIR=lib/mysql/plugin
Manpage dir –mandir=/usr/local/mysql/share/man -DINSTALL_MANDIR=share/man
Shared-data dir –sharedstaedir=/usr/local/mysql/share/mysql -DINSTALL_SHAREDIR=share
Library install dir –libdir=/usr/local/mysql/lib/mysql -DINSTALL_LIBDIR=lib/mysql
Header install dir –includedir=/usr/local/mysql/include/mysql -DINSTALL_INCLUDEDIR=include/mysql
Info doc dir –infodir=/usr/local/mysql/share/info -DINSTALL_INFODIR=share/info

CMAKE_INSTALL_PREFIX值是安装的基本目录,其他cmake选项值是不包括前缀,是相对路径名,绝对路径包括CMAKE_INSTALL_PREFIX路径。如-DINSTALL_SBINDIR=sbin的绝对路径是/usr/local/mysql/sbin

 

3.存储引擎选项

mysql存储引擎是插件式的,因此插件控制选项可以指定那个存储引擎安装。

configure编译插件选项–with-plugins=csv,myisam,myisammrg,heap,innobase,

archive,blackholecmake中没有直接对应的相同选项。对于csv,myisam,myisammrg,heapcmake中是不需要明确指定存储引擎的名称,因为它们是强制性安装。

 

可以使用以下选择来安装innodb,archive,blackhole存储引擎

-DWITH_INNOBASE_STORAGE_ENGINE=1

-DWITH_ARCHIVE_STORAGE_ENGINE=1

-DWITH_BLACKHOLE_STORAGE_ENGINE=1

1可以使用on代替)

 

如果既不是-DWITH_<ENGINE>_STORAGE_ENGINE 也不是 -DWITHOUT_<ENGINE>_STORAGE_ENGINE 来指定存储引擎,该存储引擎将安装成共享模块式的。如果不是共享模块式的将排除在外。共享模块安装时必须使用INSTALL PLUGIN语句或–plugin-load才可以使用。

 

 4.lib库选项

parameter configure option cmake option
readline library –with-readline -DWITH_READLINE=1
SSL library –with-ssl=/usr -DWITH_SSL=system
zlib library –with-zlib-dir/usr -DWITH_ZLIB=system
Libwrap library –without-libwrap -DWITH_LIBWRAP=0

 

 

 

 

 

 

 

有关插件的CMake的选项的其他信息,请查阅:

http://forge.mysql.com/wiki/MySQL_Internals_Support_for_Plug-Ins

 

  5.其他选项

之前MySQL的编译选项大多数都支持。新旧版本之间的安装选项映射成大写字母,删除选项前面破折号,中间字符间的破折号替换成下划线。如:

 –with-debug => WITH_DEBUG=1

 –with-embedded-server => WITH_EMBEDDED_SERVER

 

Parameter Configure option Cmake option
TCP/IP port number –with-tcp-port=3306 -DMYSQL_TCP_PORT=3306
UNIX socket file –with-unix-socket-path=/tmp/mysqld.sock -DMYSQL_UNIX_ADDR=/tmp/mysqld.sock
Enable LOCAL for LOAD DATA –enable-local-infile -DENABLED_LOCAL_INFILE=1
Extra charsets –with-extra-charsets=all -DEXTRA_CHARSETS=all
Default charset –with-charset=utf8 -DDEFAULT_CHARSET=utf8
Default collation –with-collation=utf8_general_ci -DDEFAULT_COLLATION=utf8_general_ci
Build the server –with-server none
Build the embedded server –with-embedded-server -DWITH_EMBEDDED_SERVER=1
libmysqld privilege control –with-embedded-privilege-control none
Install the documentation –without-docs none
Big tables –with-big-tables, –without-big-tables none
mysqld user –with-mysqld-user=mysql -DMYSQL_USER=mysql
Debugging –without-debug -DWITH_DEBUG=0
GIS support –with-geometry none
Community features –enable-community-features none
Profiling –disable-profiling -DENABLE_PROFILING=0
pstack –without-pstack none
Assembler string functions –enable-assembler none
Build type –build=x86_64-pc-linux-gnu no equivalent
Cross-compile host –host=x86_64-pc-linux-gnu no equivalent
Client flag –with-client-ldflags=-lstdc++ none
Client flag –enable-thread-safe-client none
Comment –with-comment=’string’ -DWITH_COMMENT=’string’
Shared/static binaries –enable-shared –enable-static none
Memory use –with-low-memory none

 

 6.调试配置过程

 使用configure编译完将生成config.logconfig.status文件。

 使用cmake编译完在CMakeFiles目录下生成CMakeError.log CMakeOutput.log文件。

 

               7.第三方接口工具

  在之前的版本,第三方工具从MySQL顶层源目录中读取源configure.in文件来确定mysql版本。如:对5.5.7 – RC版本的AC_INIT线看起来像这样:

AC_INIT([MySQL Server], [5.5.7-rc], [], [mysql])

   现在的版本可以直接读取版本文件。如:如果版本是5.5.8,文件看起来像这样的:

MYSQL_VERSION_MAJOR=5

MYSQL_VERSION_MINOR=5

MYSQL_VERSION_PATCH=8

MYSQL_VERSION_EXTRA=

 

如果源码包不是GA版,MYSQL_VERSION_EXTRA的值将非空。如:对于一个发布RC版本是这样的:

MYSQL_VERSION_EXTRA=rc

 

构建5位数字的版本号,使用下面公式:

MYSQL_VERSION_MAJOR*10000 + MYSQL_VERSION_MINOR*100 + MYSQL_VERSION_PATCH