网址: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,blackhole在cmake中没有直接对应的相同选项。对于csv,myisam,myisammrg,heap在cmake中是不需要明确指定存储引擎的名称,因为它们是强制性安装。
可以使用以下选择来安装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.log和config.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
转载于:https://my.oschina.net/766/blog/210985