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命令。“.”表示你當前的工作目錄路徑,請根據你所在的目錄,適當的替換掉路徑“.”。

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

在重新配置或重新構建之前,需要先清除舊的對象文件和緩存信息,方法如下:

Autotools:

  1. make clean 
  2. rm config.cache 

CMake (Unix/Linux):

  1. make clean 
  2. rm CMakeCache.txt 

CMake (Windows):

  1. devenv MySQL.sln /clean 
  2. 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. -DWITH_INNOBASE_STORAGE_ENGINE=1 
  2. -DWITH_ARCHIVE_STORAGE_ENGINE=1 
  3. -DWITH_BLACKHOLE_STORAGE_ENGINE=1 

當然也可以使用“ON”來替代數字1,它們是等效的。

如果你想除去對某種引擎的支持,則在CMake編譯選項中使用-DWITHOUT_<ENGINE>_STORAGE_ENGINE,例如:

  1. -DWITHOUT_EXAMPLE_STORAGE_ENGINE=1 
  2. -DWITHOUT_FEDERATED_STORAGE_ENGINE=1 
  3. -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. --with-debug => WITH_DEBUG=1 
  2. --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
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章