1. 简介
在编译zabbix之前,可以通过以下命令查看编译配置脚本的可用选项:
./configure --help
本文主要描述上述编译配置脚本的每个可用选项的使用方法。在bash中运行这个编译配置脚本的格式如下所示:
./configure [OPTION]... [VAR=VALUE]...
若要为环境变量(例如,CC和CFLAGS,等等)赋值,则可以指定为VAR=VALUE
这样的格式。
2. 配置选项
-h
或--help
显示编译配置脚本的帮助信息,然后退出。
--help=short
只显示Zabbix源码包专用的可选项。
--help=recursive
功能和
--help=short
选项完全相同。-V
或--version
显示Zabbix的版本信息,然后退出。
-q
、--quiet
或--silent
不会输出“checking …”消息。
--cache-file=FILE
将缓存测试的结果存入FILE指定的文件中,默认值为
disabled
。-C
或--config-cache
--cache-file=config.cache
选项的别名。-n
或--no-create
不会创建输出文件。
--srcdir=DIR
在DIR指定的目录中查找源码,默认值为配置脚本的目录或上级目录。
3. 安装目录选项
--prefix=PREFIX
将不依赖于架构的文件安装在PREFIX指定的目录中,默认值为
/usr/local
。--exec-prefix=EPREFIX
将依赖于架构的文件安装在EPREFIX指定的目录中,默认值为上文的PREFIX指定的目录。
在默认情况下,make install
命令会将所有文件安装在/usr/local/bin
、/usr/local/lib
等目录中。你可以使用--prefix
选项指定安装目录的前缀,例如:--prefix=$HOME
。
若想要更好地控制安装目录,请使用下面的选项对安装目录的路径进行微调。
--bindir=DIR
存放用户可执行文件的目录,默认值为
EPREFIX/bin
。--sbindir=DIR
存放系统管理员可执行文件的目录,默认值为
EPREFIX/sbin
。--libexecdir=DIR
存放程序可执行文件的目录,默认值为
EPREFIX/libexec
。--sysconfdir=DIR
存放只读的单机数据(也就是Zabbix的配置文件)的目录,默认值为
PREFIX/etc
。--sharedstatedir=DIR
存放可修改的、不依赖于架构的数据的目录,默认值为
PREFIX/com
。--localstatedir=DIR
存放可修改的单机数据的目录,默认值为
PREFIX/var
。--libdir=DIR
存放目标代码库文件的目录,默认值为
EPREFIX/lib
。--includedir=DIR
存放C语言头文件的目录,默认值为
PREFIX/include
。--oldincludedir=DIR
存放非gcc编译器的C语言头文件的目录,默认值为
/usr/include
。--datarootdir=DIR
存放只读的、不依赖于架构的数据的根目录,默认值为
PREFIX/share
。--datadir=DIR
存放只读的、依赖于架构的数据的根目录,默认值为DATAROOTDIR指定的目录。
--infodir=DIR
存放info文档的目录,默认值为
DATAROOTDIR/info
。--localedir=DIR
存放依赖于地区的数据的目录,默认值为
DATAROOTDIR/locale
。--mandir=DIR
存放man文档的目录,默认值为
DATAROOTDIR/man
。--docdir=DIR
存放文档的根目录,默认值为
DATAROOTDIR/doc/zabbix
。--htmldir=DIR
存放html文档的目录,默认值为DOCDIR指定的目录。
--dvidir=DIR
存放dvi文档的目录,默认值为DOCDIR指定的目录。
--pdfdir=DIR
存放pdf文档的目录,默认值为DOCDIR指定的目录。
--psdir=DIR
存放ps文档的目录,默认值为DOCDIR指定的目录。
4. 程序名称选项
--program-prefix=PREFIX
将PREFIX指定的字符串作为安装程序名称的前缀。
--program-suffix=SUFFIX
将SUFFIX指定的字符串作为安装程序名称的后缀。
--program-transform-name=PROGRAM
运行sed命令,将安装程序名称转换为PROGRAM指定的字符串。
5. 系统类型选项
--build=BUILD
使用BUILD指定的构建工具链进行编译,默认值为
guessed
。--host=HOST
交叉编译后的程序将会在HOST指定的主机上运行,默认值为BUILD指定的值。
6. 可选的功能特性
--disable-option-checking
忽略未能识别的
--enable/--with
选项。--disable-FEATURE
不包含FEATURE指定的功能特性(和
--enable-FEATURE=no
选项相同)。--enable-FEATURE[=ARG]
包含FEATURE指定的功能特性,ARG的默认值为
yes
。
上述两个选项中的FEATURE表示Zabbix可选的功能特性,它可以是下面每个选项的--enable-
或--disable-
选项前缀之后的功能名称之一。例如,FEATURE可以是silent-rules
、dependency-tracking
或static
,等等。
--enable-silent-rules
输出较少的编译日志(取消命令:
make V=1
)。--disable-silent-rules
输出详细的编译日志(取消命令:
make V=0
)。--enable-dependency-tracking
启用依赖关系跟踪功能,这样会导致编译速度变慢。
--disable-dependency-tracking
禁用依赖关系跟踪功能,这样可以加快编译速度。
--disable-largefile
禁用对大文件的支持。
--enable-static
构建静态链接的二进制文件。
--enable-server
打开Zabbix Server的编译开关。
--enable-proxy
打开Zabbix Proxy的编译开关。
--enable-agent
打开Zabbix Agent和客户端工具的编译开关。
--enable-java
打开Zabbix Java Gateway的编译开关。
--enable-ipv6
启用对IPv6的支持。
7. 可选的程序包选项
--with-PACKAGE[=ARG]
使用PACKAGE指定的程序包,ARG的默认值为
yes
。--without-PACKAGE
不使用PACKAGE指定的程序包(和
--with-PACKAGE=no
选项相同)。
上述两个选项中的PACKAGE表示Zabbix可选的程序包,它可以是下面每个选项的--with-
选项前缀之后的程序包名称之一。例如,PACKAGE可以是ibm-db2
、oracle
或mysql
,等等。另外,与--with-
相对的--without-
选项,下文不再赘述。
--with-ibm-db2=[ARG]
使用指定的sqllib目录中的IBM DB2 CLI程序包。若
ARG=yes
,则使用/home/db2inst1/sqllib
目录中的程序包;若ARG=no
,则禁用对IBM DB2数据库的支持。--with-ibm-db2-include=[DIR]
使用DIR指定目录中的IBM DB2 CLI的头文件。
--with-ibm-db2-lib=[DIR]
使用DIR指定目录中的IBM DB2 CLI的库文件。
--with-mysql[=ARG]
使用MySQL客户端的程序库,默认值为no。若要使用这个程序包,请设置为
mysql_config
文件的路径。--with-oracle=[ARG]
若
ARG=path
,则使用指定的Oracle主目录中的Oracle OCI API程序包;若ARG=yes
,则使用ORACLE_HOME
环境变量指定的目录中的Oracle OCI API程序包;若ARG=no
,则不使用Oracle OCI API程序包。--with-oracle-include=[DIR]
使用DIR指定目录中的Oracle OCI API的头文件。
--with-oracle-lib=[DIR]
使用DIR指定目录中的Oracle OCI API的库文件。
--with-postgresql[=ARG]
使用PostgreSQL客户端的程序库,默认值为no。若要使用这个程序包,请设置为
pg_config
文件的路径。--with-sqlite3[=ARG]
使用SQLite 3的程序库,默认值为no。若要使用这个程序包,请设置为sqlite3库文件的路径。
--with-jabber[=DIR]
如果需要使用Jabber协议实现消息传递,那么请启用对Jabber的支持,默认值为
no
。DIR是iksemel库文件的安装目录。--with-libxml2[=ARG]
如果需要使用XML程序库,那么请使用libxml2客户端的程序库,默认值为
no
。可以指定为xml2-config文件的路径。--with-unixodbc[=ARG]
如果需要使用unixODBC程序库,那么请使用专用于unixODBC程序包的ODBC驱动程序,默认值为
no
。可以指定为odbc_config二进制文件的路径。--with-net-snmp[=ARG]
如果需要使用Net-SNMP程序库,那么请使用Net-SNMP程序包,默认值为
no
。可以指定为net-snmp-config文件的路径。--with-ssh2[=DIR]
如果需要使用基于SSH2的检查验证,那么请使用SSH2程序包,默认值为
no
。DIR是SSH2程序库的安装目录。--with-openipmi[=DIR]
如果需要检查IPMI设备,那么请启用对OPENIPMI的支持,默认值为
no
。DIR是OPENIPMI的安装根目录,默认会在若干个常用路径中搜索OPENIPMI文件。--with-ldap[=DIR]
如果需要检查LDAP服务器,那么请启用对LDAP的支持,默认值为
no
。DIR是LDAP的安装根目录,默认会在若干个常用路径中搜索LDAP文件。--with-libcurl[=DIR]
如果需要使用cURL程序库,那么请使用cURL程序包,默认值为
no
。可以指定为curl-config文件的路径。--with-iconv=[DIR]
DIR可以指定iconv的安装根目录,默认会在若干个常用路径中搜索iconv文件。
--with-iconv-include=[DIR]
DIR可以指定iconv包含的头文件的路径。
--with-iconv-lib=[DIR]
DIR可以指定iconv的程序库文件的路径。
8. 影响编译的环境变量
CC
指定C编译器的命令。
CFLAGS
指定C编译器的标志。
LDFLAGS
指定链接器标志。用于使用存放在非标准目录
<lib dir>
中的程序库,例如:-L<lib dir>
。LIBS
指定传递给链接器使用的程序库,例如:
-l<library>
。CPPFLAGS
指定目标C/C++预处理器标志。用于使用存放在非标准目录
<include dir>
中的头文件,例如:-I<include dir>
。CPP
指定C预处理器。
PKG_CONFIG
指定pkg-config工具的路径。
PKG_CONFIG_PATH
可能存放pkg-config工具的目录路径。
PKG_CONFIG_LIBDIR
可以覆盖pkg-config工具内建的搜索路径。
IKSEMEL_CFLAGS
IKSEMEL使用的C编译器标志,会覆盖pkg-config的配置。
IKSEMEL_LIBS
IKSEMEL使用的链接器标志,会覆盖pkg-config的配置。