Zabbix 2.4.8源码配置选项解析

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

  指定链接器标志。用于使用存放在非标准目录中的程序库，例如：-L。

• LIBS

  指定传递给链接器使用的程序库，例如：-l。

• CPPFLAGS

  指定目标C/C++预处理器标志。用于使用存放在非标准目录中的头文件，例如：-I。

• 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的配置。