Zabbix 2.4.8源码配置选项解析

1. 简介

在编译zabbix之前,可以通过以下命令查看编译配置脚本的可用选项:

  1. ./configure --help

本文主要描述上述编译配置脚本的每个可用选项的使用方法。在bash中运行这个编译配置脚本的格式如下所示:

  1. ./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-rulesdependency-trackingstatic,等等。

  • --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-db2oraclemysql,等等。另外,与--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的配置。