cmake檔案詳解

MySQL5.5之後就開始使用cMake來代替傳統的configure了,很多朋友還一個勁兒的找configure 呵呵, 找不見就對了。
秋偉光的這篇文章主要整理了cMake的安裝方法及引數詳解,同時提供新老版本的引數對比,方便習慣了configure的朋友順利過渡到cMake上

首先說一下安裝方法,當然我只是給不會的朋友提醒一下,(*^__^*) 嘻嘻……

MySQL5.5/MySQL5.6的安裝方法

### 轉載後備注:cmake內容較多，以下僅供參考，實際根據應用選擇。

其實安裝方法和之前差不對, 只是用cmake代替了configure,引數發生了變化而已,詳情請看以下程式碼:

好了這就算安裝結束了,當然需要配置一些環境變數及檔案軟連線,自己弄哦

下面介紹一下引數

MySQL cMake 常規引數介紹

-DCMAKE_INSTALL_PREFIX= 指向mysql安裝目錄
-DINSTALL_SBINDIR=sbin 指向可執行檔案目錄（prefix/sbin）
-DMYSQL_DATADIR=/var/lib/mysql 指向mysql資料檔案目錄（/var/lib/mysql）
-DSYSCONFDIR=/etc/mysql 指向mysql配置檔案目錄（/etc/mysql）
-DINSTALL_PLUGINDIR=lib/mysql/plugin 指向外掛目錄（prefix/lib/mysql/plugin）
-DINSTALL_MANDIR=share/man 指向man文件目錄（prefix/share/man）
-DINSTALL_SHAREDIR=share 指向aclocal/mysql.m4安裝目錄（prefix/share）
-DINSTALL_LIBDIR=lib/mysql 指向物件程式碼庫目錄（prefix/lib/mysql）
-DINSTALL_INCLUDEDIR=include/mysql 指向標頭檔案目錄（prefix/include/mysql）
-DINSTALL_INFODIR=share/info 指向info文件存放目錄（prefix/share/info）
prefix官方推薦設為/usr

MySQL cMake Storage Engine 相關引數詳解

型別csv,myisam,myisammrg,heap,innobase,archive,blackhole
若想啟用某個引擎的支援：-DWITH_<ENGINE>_STORAGE_ENGINE=1
如：
-DWITH_INNOBASE_STORAGE_ENGINE=1
-DWITH_ARCHIVE_STORAGE_ENGINE=1
-DWITH_BLACKHOLE_STORAGE_ENGINE=1
若想禁用某個引擎的支援：-DWITHOUT_<ENGINE>_STORAGE_ENGINE=1
如：
-DWITHOUT_EXAMPLE_STORAGE_ENGINE=1
-DWITHOUT_FEDERATED_STORAGE_ENGINE=1
-DWITHOUT_PARTITION_STORAGE_ENGINE=1

MySQL cMake Library相關引數詳解

-DWITH_READLINE=1 啟用readline庫支援（提供可編輯的命令列）
-DWITH_SSL=system 啟用ssl庫支援（安全套接層）
-DWITH_ZLIB=system 啟用libz庫支援（zib、gzib相關）
-DWTIH_LIBWRAP=0 禁用libwrap庫（實現了通用TCP包裝的功能，為網路服務守護程式使用）
-DMYSQL_TCP_PORT=3306 指定TCP埠為3306
-DMYSQL_UNIX_ADDR=/tmp/mysqld.sock 指定mysql.sock路徑
-DENABLED_LOCAL_INFILE=1 啟用本地資料匯入支援
-DEXTRA_CHARSETS=all 啟用額外的字符集型別（預設為all）
-DDEFAULT_CHARSET=utf8 指定預設的字符集為utf8
-DDEFAULT_COLLATION=utf8_general_ci 設定預設排序規則（utf8_general_ci快速/utf8_unicode_ci準確）
-DWITH_EMBEDDED_SERVER=1 編譯嵌入式伺服器支援
-DMYSQL_USER=mysql 指定mysql使用者(預設為mysql)
-DWITH_DEBUG=0 禁用debug（預設為禁用）
-DENABLE_PROFILING=0 禁用Profiling分析（預設為開啟）
-DWITH_COMMENT='string' 一個關於編譯環境的描述性註釋

MySQL cMake/configure 編譯引數即使用方法對比詳解

下表列是MySQL編譯工具configure的呼叫語法和等效的CMake命令。“.”表示你當前的工作目錄路徑，請根據你所在的目錄，適當的替換掉路徑“.”。

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

如果你需要重新配置或重新構建之前的安裝，則需要先清除舊的物件檔案和快取資訊，方法如下：

Autotools:

CMake (Uinx/Linux):

CMake (Windows):

MySQL cMake/configure 安裝引數詳細對比及說明

在下表中，“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中，引擎被作為單個的選項來進行控制。假設有以下配置選項：
--with-plugins=csv,myisam,myisammrg,heap,innobase,archive,blackhole
上面的引數指定MySQL資料庫可以支援哪些資料庫引擎，將上述編譯選項轉換成CMake編譯選項時，下面的幾個引擎名字可以被省略，因為編譯時，預設就支援：csv,myisam,myisammrg,heap

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

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

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

庫檔案載入選項
該選項指明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

MySQL Cmake 編譯其他選項
MySQL cMake編譯選項大部分能與之前的configure地址相同，其編譯選項的差別在於：之前的是小寫，現在全部變成了大寫，之前採用雙橫線，現在使用單橫線，之前使用的破折號，現在取而代之的是使用下劃線，下面是具體對比：

--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	無