MySQL CMake參數說明手冊

標籤：style   http   io   ar   color   os   使用   sp   for   

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                            
 
                       
  
 make clean  
                       
  
 rm config.cache  
              
 

CMake (Unix/Linux)：

                           view plain                          copy                            
 
                       
  
 make clean  
                       
  
 rm CMakeCache.txt  
              
 

CMake (Windows)：

                           view plain                          copy                            
 
                       
  
 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中，引擎被作為單個的選項來進行控制。假設有以下配置選項：

                           view plain                          copy                            
 
                       
  
 --with-plugins=csv,myisam,myisammrg,heap,innobase,archive,blackhole   
              
 

上面的參數指定MySQL資料庫可以支援哪些資料庫引擎，將上述編譯選項轉換成CMake編譯選項時，下面的幾個引擎名字可以被省略，因為編譯時間，預設就支援：

                           view plain                          copy                            
 
                       
  
 csv myisam myisammrg heap  
              
 

然後使用下面的編譯參數，以啟用InnoDB、ARCHIVE和BLACKHOLE引擎支援：

                           view plain                          copy                            
 
                       
  
 -DWITH_INNOBASE_STORAGE_ENGINE=1  
                       
  
 -DWITH_ARCHIVE_STORAGE_ENGINE=1  
                       
  
 -DWITH_BLACKHOLE_STORAGE_ENGINE=1  
              
 

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

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

                           view plain                          copy                            
 
                       
  
 -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編譯選項，新老編譯選項的差別在於：之前的是小寫，現在全部變成了大寫，之前採用雙橫線，現在使用單橫線，之前使用的破折號，現在取而代之的是使用底線，例如：

                           view plain                          copy                            
 
                       
  
 --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	-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參數說明手冊