第17章 使用 USES 宏

17.1. USES 简介

USES 宏使得为 port 声明需求和设置变得容易。它们可以添加依赖关系,改变构建行为,为软件包添加元数据等等,所有这些都通过选择简单的预设值来实现。

本章的每个部分描述了 USES 的一个可能值,以及它可能的参数。参数会在值后面加上冒号 ( : ),多个参数之间用逗号分隔 ( , )。

示例 1. 使用多个值

USES=	bison perl

示例 2. 添加一个参数

USES=	tar:xz

示例 3. 添加多个参数

USES=	drupal:7,theme

示例 4. 混合所有内容

USES=	pgsql:9.3+ cpe python:2.7,build

17.2. 7z

可能的参数: (无), p7zip , partial

使用 7z(1) 提取而非 bsdtar(1),并设置 EXTRACT_SUFX=.7z 。使用 p7zip 选项会强制依赖于来自 archivers/p7zip 的 7z ,如果基本系统的工具无法提取文件。如果使用了 partial 选项, EXTRACT_SUFX 不会改变,这在主分发文件没有 .7z 扩展名时可以使用。

17.3. ada

可能的参数: (无), 6 , 12 , (run)

依赖于支持 Ada 的编译器,并相应地设置 CC 。默认使用 gcc6-aux 来自 ports。

17.4. autoreconf

可能的参数: (无), build

运行 autoreconf 。它封装了 aclocal 、 autoconf 、 autoheader 、 automake 、 autopoint 和 libtoolize 命令。每个命令应用于 ${AUTORECONF_WRKSRC}/configure.ac 或其旧名称 ${AUTORECONF_WRKSRC}/configure.in。如果 configure.ac 定义了具有自己 configure.ac 的子目录,使用 AC_CONFIG_SUBDIRS , autoreconf 将递归更新这些目录。 :build 参数仅在这些工具上添加构建时依赖关系,但不运行 autoreconf 。如果 WRKSRC 不包含 configure.ac 的路径,则 port 可以设置 AUTORECONF_WRKSRC 。

17.5. blaslapack

可能的参数:(无), atlas , netlib (默认), gotoblas , openblas

添加对 Blas / Lapack 库的依赖。

17.6. bdb

可能的参数:(无), 48 , 5 (默认), 6

添加对伯克利数据库库的依赖。默认为 databases/db5。当使用 :48 参数时也可以依赖 databases/db48,或者使用 :6 依赖 databases/db6。可以声明可接受的版本范围, :48+ 可以找到已安装的最高版本,并在未安装其他版本时回退到 4.8。 INVALID_BDB_VER 可用于指定与此 port 不兼容的版本。框架向 port 暴露以下变量:

BDB_LIB_NAME 伯克利数据库库的名称。例如,使用 databases/db5 时,它包含 db-5.3 。

BDB_LIB_CXX_NAME 伯克利 DBC++ 库的名称。例如,使用 databases/db5 时,它包含 db_cxx-5.3 。

BDB_INCLUDE_DIR Berkeley DB 包含目录的位置。例如,当使用 databases/db5 时,它将包含 ${LOCALBASE}/include/db5 。

BDB_LIB_DIR Berkeley DB 库目录的位置。例如,当使用 databases/db5 时,它包含 ${LOCALBASE}/lib 。

BDB_VER 检测到的 Berkeley DB 版本。例如,如果使用 USES=bdb:48+ 并安装了 Berkeley DB 5,它包含 5 。

17.7. bison

可能的参数:(无), build , run , both

默认使用 devel/bison。不带参数或使用 build 参数时,意味着 bison 是构建时依赖, run 意味着运行时依赖,而 both 则既是运行时依赖也是构建时依赖。

17.8. budgie

可能的参数:(无)

为 Budgie 桌面环境提供支持。 使用 USE_BUDGIE 来选择所需的组件。 有关更多信息,请参阅使用 Budgie。

17.9. cabal

可能的参数:(无), hpack , nodefault

设置用于使用 Cabal 构建 Haskell 软件的默认值和目标。添加对 Haskell 编译器 port ( lang/ghc) 的构建依赖。如果已在 BUILD_DEPENDS 变量中列出了其他版本的 GHC(例如,lang/ghc810),则将使用它。如果给出 hpack 参数,则添加对 devel/hs-hpack 的构建依赖,并在配置步骤中调用 hpack 以生成 .cabal 文件。如果给出 nodefault 参数,该框架将不尝试从 Hackage 获取主要发布文件。如果存在 USE_GITHUB 或 USE_GITLAB ,则隐含添加此参数。

该框架提供以下变量:

CABAL_REVISION 存储在 Hackage 上的 Haskell 软件包可能有修订版本。将此旋钮设置为整数以拉取已修订的软件包描述。

USE_CABAL 如果软件使用 Haskell 依赖项,请在此变量中列出它们。每个项目应该在 Hackage 上并且列在 packagename-0.1.2 形式中。依赖项也可以有修订版本,修订版本在 _ 符号之后指定。支持依赖项列表的自动生成,请参阅使用 cabal 构建 Haskell 应用程序。

CABAL_FLAGS 传递到配置和构建阶段中 cabal-install 的标志列表。这些标志完全按原样传递。通常使用此变量来启用或禁用在.cabal 文件中声明的标志。传递 foo 以启用 foo 标志,并传递 -foo 以禁用它。

CABAL_EXECUTABLES 列出由 port 安装的可执行文件列表。默认值: ${PORTNAME} 。请查看要移植项目的 .cabal 文件,以获取此变量可能值的列表。每个值对应 .cabal 文件中的一个 executable 部分。此列表中的项目会自动添加到 pkg-plist 中。

SKIP_CABAL_PLIST 如果定义,不要将 ${CABAL_EXECUTABLES} 中的项目添加到 pkg-plist。

opt_USE_CABAL 根据 opt 选项向 ${USE_CABAL} 添加项目。

opt_CABAL_EXECUTABLES 根据 ${CABAL_EXECUTABLES} 选项将项目添加到 opt 中。

opt_CABAL_FLAGS 如果 opt 启用,则将值附加到 ${CABAL_FLAGS} 。否则,将 -value 附加以禁用标志。请注意,这种行为与普通的 CABAL_FLAGS 略有不同,因为它不接受以 - 开头的值。

CABAL_WRAPPER_SCRIPTS 一个包含 Haskell 程序的 ${CABAL_EXECUTABLES} 子集,这些程序将被包装成 shell 脚本,在运行程序之前设置 *_datadir 环境变量。这也导致实际的 Haskell 二进制文件安装在 libexec/cabal/ 目录下。这个选项是为了那些在 share/ 目录下安装数据文件的 Haskell 程序所需的。

FOO_DATADIR_VARS 列出额外的 Haskell 包,这些包的数据文件应可被名为 FOO 的可执行文件访问。该可执行文件应是 ${CABAL_WRAPPER_SCRIPTS} 的一部分。列在那里的 Haskell 包不应具有版本后缀。

CABAL_PROJECT 一些 Haskell 项目可能已经有一个 cabal.project 文件,该文件也是由ports框架生成的。如果是这种情况,请使用此变量指定如何处理原始 cabal.project 。将此变量设置为 remove 将导致删除原始文件。将此变量设置为 append 将:

  1. 在 extract 阶段期间将原始文件移动到 cabal.project.${PORTNAME} 。

  2. 将原始 cabal.project.${PORTNAME} 和生成的 cabal.project 在 patch 阶段之后合并到单个文件中。使用 append 可以在合并之前对原始文件进行修补。

17.10. cargo

可能的参数:(无)

使用 Cargo 进行配置、构建和测试。它可以用于 port 使用 Cargo 构建系统的 Rust 应用程序。有关更多信息,请参阅 使用 cargo 构建 Rust 应用程序。

17.11. charsetfix

可能的参数:(无)

阻止 port 安装 charset.alias。这必须仅由 converters/libiconv 安装。如果 charset.alias 未由 ${WRKSRC}/Makefile.in 安装, CHARSETFIX_MAKEFILEIN 可设置为相对于 WRKSRC 的路径。

17.12. cmake

可能的参数:(无), insource , noninja , run , testing

使用 CMake 配置port并生成一个构建系统。

默认情况下,执行无源代码构建,使源码 WRKSRC 中免受构建工件影响。使用 insource 参数,将执行源代码构建。这个参数应该是一种例外,仅在常规的无源代码构建无法工作时使用。

默认情况下,使用 Ninja (devel/ninja)进行构建。在某些情况下,这种方法不起作用。使用 noninja 参数,构建将使用常规 make 进行构建。该参数仅在 Ninja 构建不起作用时使用。

使用 run 参数时,除了构建依赖外,还注册了运行依赖。

使用 testing 参数时,将添加一个使用 CTest 的测试目标。在运行测试时,port 将被重新配置以进行测试和重新构建。

欲了解更多信息,请参阅使用 cmake 。

17.13. compiler

可能的参数: (无), env (默认, 隐式), C++17-lang , C++14-lang , C++11-lang , gcc-C++11-lib , C++11-lib , C++0x , c11 , nestedfct , features

根据任何给定的需求确定使用哪个编译器。如果 port 需要支持 C++17 的编译器,请使用 C++17-lang ;如果 port 需要支持 C++14 的编译器,请使用 C++14-lang ;如果 port 需要支持 C++11 的编译器,请使用 C++11-lang ;如果 port 需要带有 C++11 库的 g++ 编译器,请使用 gcc-C++11-lib ;如果 port 需要准备好支持 C++11 标准库的编译器,请使用 C++11-lib 。如果 port 需要理解 C++0X、C11 或嵌套函数的编译器,则应使用相应的参数。

使用 features 请求由默认编译器支持的功能列表。在包含 bsd.port.pre.mk 后,port 可以使用这些变量检查结果。

  • COMPILER_TYPE :系统上的默认编译器,可以是 gcc 或 clang

  • ALT_COMPILER_TYPE :系统上的备用编译器,可以是 gcc 或 clang。仅在基本系统中存在两个编译器时设置。

  • COMPILER_VERSION :默认编译器版本的前两位数字。

  • ALT_COMPILER_VERSION : 替代编译器版本的前两个数字(如果存在的话)。

  • CHOSEN_COMPILER_TYPE : 选择的编译器,可能是 gcc 或 clang

  • COMPILER_FEATURES : 默认编译器支持的功能。目前列出了 C++ 库。

17.14. cpe

可能的参数: (无)

在软件包清单中包含公共平台枚举(CPE)信息,作为一个 CPE 2.3 格式的字符串。查看 CPE 规范获取详细信息。要向 port 添加 CPE 信息,请按照以下步骤进行:

  1. 通过使用 NVD 的 CPE 搜索引擎或在官方 CPE 词典中搜索软件产品的官方 CPE 条目。永远不要虚构 CPE 数据。

  2. 将 cpe 添加到 USES 并将 make -V CPE_STR 的结果与 CPE 字典条目进行比较。一步一步进行,直到 make -V CPE_STR 正确为止。

  3. 如果产品名称(第二字段,默认为 PORTNAME )不正确,请定义 CPE_PRODUCT 。

  4. 如果供应商名称(第一个字段,默认为 CPE_PRODUCT )不正确,请定义 CPE_VENDOR 。

  5. 如果版本字段(第三字段,默认为 PORTVERSION )不正确,请定义 CPE_VERSION 。

  6. 如果更新字段(第四字段,默认为空)不正确,请定义 CPE_UPDATE 。

  7. 如果仍然不正确,请查看 Mk/Uses/cpe.mk 以获取更多详细信息,或联系Ports安全团队 ports-secteam@FreeBSD.org

  8. 尽量从现有变量(如 PORTNAME 和 PORTVERSION )中汲取 CPE 名称的大部分内容。使用变量修饰符从这些变量中提取相关部分,而不是硬编码名称。

  9. 在提交任何更改 PORTNAME 或 PORTVERSION 或用于派生 CPE_STR 的任何其他变量之前,始终运行 make -V CPE_STR 并检查输出。

17.15. cran

可能的参数:(无), auto-plist , compiles

使用综合 R 存档网络。 指定 auto-plist 以自动生成 pkg-plist。 如果 port 有需要编译的代码,则指定 compiles 。

17.16. desktop-file-utils

可能的参数:(无)

使用 devel/desktop-file-utils 中的 update-desktop-database。 将运行额外的安装后步骤,而不会干扰已在 port Makefile 中的任何安装后步骤。 将在 plist 中添加一个包含 @desktop-file-utils 的行。 只有在 port 提供包含 MimeType 条目的 .desktop 文件时才使用此宏。

17.17. desthack

可能的参数:(无)

更改 GNU 配置的行为,以正确支持 DESTDIR ,以防原始软件不支持。

17.18. display

可能的参数:(无),ARGS

设置虚拟显示环境。如果环境变量 DISPLAY 未设置,则将 Xvfb 添加为构建依赖项,并将 CONFIGURE_ENV 扩展到当前运行的 Xvfb 实例的 port 号。ARGS 参数默认为 install ,控制启动和停止虚拟显示的阶段。

17.19. dos2unix

可能的参数:(无)

port 有带 DOS 格式换行符的文件需要转换。可以设置多个变量来控制要转换的文件。默认是转换所有文件,包括二进制文件。请参见简单自动替换的示例。

  • DOS2UNIX_REGEX :根据正则表达式匹配文件名。

  • DOS2UNIX_FILES :匹配字面文件名。

  • DOS2UNIX_GLOB :根据通配符模式匹配文件名。

  • DOS2UNIX_WRKSRC :开始转换的目录。默认为 ${WRKSRC} 。

17.20. drupal

可能的参数: 7 , module , theme

自动安装适用于 Drupal 主题或模块的port。与port期望的 Drupal 版本一起使用。例如, USES=drupal:7,module 表示此port创建一个 Drupal 7 模块。Drupal 7 主题可以用 USES=drupal:7,theme 指定。

17.21. ebur128

可能的参数: (无), build , lib , run , test

添加对 audio/ebur128 的依赖。通过在 make.conf 中使用 DEFAULT_VERSIONS ,可以透明地依赖于 rust 或 legacy 变体。例如,要使用旧版,请使用 DEFAULT_VERSIONS+=ebur128=legacy

当不使用任何参数时,行为与提供 lib 参数相同。其余的参数提供相应的依赖类别。

17.22. eigen

可能的参数:2, 3, 构建(默认),运行

添加依赖于 math/eigen。

17.23. elfctl

可能的参数:(无)

通过设置 ELF_FEATURES 更改 ELF 二进制文件的特征控制注释。

示例 5。使用 elfctl

USES=           elfctl
ELF_FEATURES=	featurelist:path/to/file1 \
		featurelist:path/to/file1 \
		featurelist:path/to/file2

featurelist 的格式在 elfctl(1) 中描述。文件路径相对于 ${BUILD_WRKSRC}。

17.24. erlang

可能的参数: (无), enc , rebar , rebar3

添加了对 lang/erlang 的构建和运行时依赖。根据参数不同,可能会增加额外的构建依赖。 enc 添加了对 devel/erlang-native-compiler 的依赖, rebar 添加了对 devel/rebar 的依赖, rebar3 添加了对 devel/rebar3 的依赖。

此外,以下变量对 port 可用:

  • ERL_APP_NAME :Erlang 应用程序名称,安装在 Erlang 的 lib 目录中(减去版本)

  • ERL_APP_ROOT :此 Erlang 应用程序的根目录

  • REBAR_CMD :"rebar"命令的路径

  • REBAR3_CMD :到 "rebar3" 命令的路径

  • REBAR_PROFILE :Rebar 配置文件

  • REBAR_TARGETS :Rebar 目标列表(通常是编译,也可能是生成可执行文件)

  • ERL_BUILD_NAME :rebar3 构建名称

  • ERL_BUILD_DEPS :按类别/端口名称格式列出的 BUILD_DEPENDS 列表

  • ERL_RUN_DEPS :按类别/端口名称格式列出的 RUN_DEPENDS 列表

  • ERL_DOCS :文档文件和目录列表

17.25. fakeroot

可能的参数:(无)

更改一些构建系统的默认行为,以允许以用户身份安装。有关 fakeroot 的更多信息,请参见 https://wiki.debian.org/FakeRoot。

17.26. fam

可能的参数:(无), fam , gamin

使用文件更改监视器作为库依赖项,可以是 devel/fam 或 devel/gamin。最终用户可以设置 WITH_FAM_SYSTEM 以指定他们的首选项。

17.27. firebird

可能的参数:(无), 25

添加到 Firebird 数据库客户端库的依赖项。

17.28. fonts

可能的参数:(无), fc , fontsdir (默认), none

添加到需要注册字体的工具的运行时依赖项。根据参数添加 @fc ${FONTSDIR} 行、 @fontsdir ${FONTSDIR} 行,如果参数为 none 则不添加行到 plist。 FONTSDIR 默认为 ${PREFIX}/share/fonts/${FONTNAME}, FONTNAME 为 ${PORTNAME} 。添加 FONTSDIR 到 PLIST_SUB 和 SUB_LIST 。

17.29. fortran

可能的参数: gcc (默认)

使用 GNU Fortran 编译器。

17.30. fuse

可能的参数: 2 (默认), 3

根据 FreeBSD 的版本,port 将取决于 FUSE 库并处理内核模块的依赖项。

17.31. gem

可能的参数:(无), noautoplist

处理使用 RubyGems 构建。如果使用 noautoplist ,则不会自动生成包装清单。

这意味着 USES=ruby 。

17.32. gettext

可能的参数: (无)

已弃用。将包括 gettext-runtime 和 gettext-tools 。

17.33. gettext-runtime

可能的参数: (无), lib (默认), build , run

使用 devel/gettext-runtime。默认情况下,没有参数或使用 lib 参数,意味着对 libintl.so 的库依赖。 build 和 run 分别意味着构建时和运行时对 gettext 的依赖。

17.34. gettext-tools

可能的参数: (无), build (默认), run

使用 devel/gettext-tools。默认情况下,没有参数,或者使用 build 参数时,将注册 msgfmt 的构建时间依赖项。使用 run 参数时,将注册运行时依赖项。

17.35. ghostscript

可能的参数: X, build , run , nox11

可以使用特定版本 X。可用版本为 7 , 8 , 9 , 和 agpl (默认)。 nox11 表示需要port的 -nox11 版本。 build 和 run 增加对 Ghostscript 的构建和运行时依赖项。默认情况下是构建和运行时依赖项。

17.36. gl

可能的参数:(无)

提供了一种依赖于 GL 组件的简便方法。这些组件应该列在 USE_GL 中。可用的组件有:

egl 在 graphics/libglvnd 中添加对 libEGL.so 的库依赖

gbm 从 graphics/mesa-libs 添加对 libgbm.so 的库依赖

gl 从 graphics/libglvnd 添加对 libGL.so 的库依赖

glesv2 从 graphics/libglvnd 添加对 libGLESv2.so 的库依赖

glew 在 graphics/glew 中添加对 libGLEW.so 的库依赖

glu 在 graphics/libGLU 中添加对 libGLU.so 的库依赖

glut 在 graphics/freeglut 中添加对 libglut.so 的库依赖

opengl 添加一个库依赖于 graphics/libglvnd 上的 libOpenGL.so

17.37. gmake

可能的参数: (无)

使用 devel/gmake 作为构建时依赖,并设置环境以使用 gmake 作为构建的默认 make 。

17.38. gnome

可能的参数:(无)

提供一种依赖于 GNOME 组件的简单方式。组件应列在 USE_GNOME 中。可用的组件包括:

  • atk

  • atkmm

  • cairo

  • cairomm

  • dconf

  • esound

  • evolutiondataserver3

  • gconf2

  • gconfmm26

  • gdkpixbuf

  • gdkpixbuf2

  • glib12

  • glib20

  • glibmm

  • gnomecontrolcenter3

  • gnomedesktop3

  • gnomedocutils

  • gnomemenus3

  • gnomemimedata

  • gnomeprefix

  • gnomesharp20

  • gnomevfs2

  • gsound

  • gtk-update-icon-cache

  • gtk12

  • gtk20

  • gtk30

  • gtkhtml3

  • gtkhtml4

  • gtkmm20

  • gtkmm24

  • gtkmm30

  • gtksharp20

  • gtksourceview

  • gtksourceview2

  • gtksourceview3

  • gtksourceviewmm3

  • gvfs

  • intlhack

  • intltool

  • introspection

  • libartlgpl2

  • libbonobo

  • libbonoboui

  • libgda5

  • libgda5-ui

  • libgdamm5

  • libglade2

  • libgnome

  • libgnomecanvas

  • libgnomekbd

  • libgnomeprint

  • libgnomeprintui

  • libgnomeui

  • libgsf

  • libgtkhtml

  • libgtksourceviewmm

  • libidl

  • librsvg2

  • libsigc++12

  • libsigc++20

  • libwnck

  • libwnck3

  • libxml++26

  • libxml2

  • libxslt

  • metacity

  • nautilus3

  • orbit2

  • pango

  • pangomm

  • pangox-compat

  • py3gobject3

  • pygnome2

  • pygobject

  • pygobject3

  • pygtk2

  • pygtksourceview

  • referencehack

  • vte

  • vte3

默认的依赖性是构建和运行时的,可以使用 :build 或 :run 进行更改。例如:

USES=		gnome
USE_GNOME=	gnomemenus3:build intlhack

查看有关使用 GNOME 的更多信息。

17.39. go

可能的参数: (none), N.NN , N.NN-devel , modules , no_targets , run

设置默认值和用于构建 Go 软件的目标。添加对 Go 编译器port的构建依赖,port维护者可以设置所需的版本。默认情况下,使用 GOPATH 模式进行构建。如果 Go 软件使用模块,可以使用 modules 参数切换到支持模块的模式。 no_targets 将设置构建环境,类似于 GO_ENV , GO_BUILDFLAGS ,但跳过创建提取和构建目标。 run 还会添加对 Go 编译器port的运行依赖。

构建过程由多个变量控制:

GO_MODULE 应用程序模块的名称,由 module 指令在 go.mod 中指定。在大多数情况下,这是ports使用 Go 模块的唯一必需变量。

GO_PKGNAME 构建时在 GOPATH 模式下的 Go 包名称。这是在 ${GOPATH}/src 中创建的目录。如果未显式设置且存在 GH_SUBDIR 或 GL_SUBDIR ,将从中推断出 GO_PKGNAME 。在模块感知模式下构建时不需要它。

GO_TARGET 要构建的软件包。默认值为 ${GO_PKGNAME} 。 GO_TARGET 也可以是形如 package:path 的元组,其中路径可以是简单的文件名,也可以是以 ${PREFIX} 开头的完整路径。

GO_TESTTARGET 要测试的软件包。默认值为 ./… (当前包及所有子包)。

CGO_CFLAGS 附加 CFLAGS 值,通过 go 传递给 C 编译器。

CGO_LDFLAGS 附加 LDFLAGS 值,通过 go 传递给 C 编译器。

GO_BUILDFLAGS 附加构建参数,传递给 go build 。

GO_TESTFLAGS 要传递给 go test 的附加构建参数。

查看构建 Go 应用程序以获取使用示例。

17.40. gperf

可能的参数:(无)

如果基础系统中不存在 gperf ,则在构建时增加对 devel/gperf 的依赖。

17.41. grantlee

可能的参数: 5 , selfbuild

处理对 Grantlee 的依赖。指定 5 来依赖基于 Qt5 的版本 devel/grantlee5。 selfbuild 在 devel/grantlee5 内部用于获取它们的版本号。

17.42. groff

可能的参数: build , run , both

如果基础系统中不存在,注册对 textproc/groff 的依赖。

17.43. gssapi

可能的参数:(无), base (默认), heimdal , mit , flags , bootstrap

为 GSS-API 的使用者处理所需的依赖关系。仅提供提供 Kerberos 机制的库。默认情况下,或设置为 base ,使用基本系统中的 GSS-API 库。也可以设置为 heimdal 使用 security/heimdal,或 mit 使用 security/krb5。

当本地 Kerberos 安装不在 LOCALBASE 时,请设置 HEIMDAL_HOME (对于 heimdal )或 KRB5_HOME (对于 krb5 )为 Kerberos 安装的位置。

这些变量被导出供 ports 使用:

  • GSSAPIBASEDIR

  • GSSAPICPPFLAGS

  • GSSAPIINCDIR

  • GSSAPILDFLAGS

  • GSSAPILIBDIR

  • GSSAPILIBS

  • GSSAPI_CONFIGURE_ARGS

可以将 flags 选项与 base 、 heimdal 或 mit 一起使用,以自动将 GSSAPICPPFLAGS 、 GSSAPILDFLAGS 和 GSSAPILIBS 分别添加到 CFLAGS 、 LDFLAGS 和 LDADD 。例如,使用 base,flags 。

bootstrap 选项是一个特殊前缀,仅供 security/krb5 和 security/heimdal 使用。例如,使用 bootstrap,mit 。

示例 6. 典型用法

OPTIONS_SINGLE=	GSSAPI
OPTIONS_SINGLE_GSSAPI=	GSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE

GSSAPI_BASE_USES=	gssapi
GSSAPI_BASE_CONFIGURE_ON=	--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}
GSSAPI_HEIMDAL_USES=	gssapi:heimdal
GSSAPI_HEIMDAL_CONFIGURE_ON=	--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}
GSSAPI_MIT_USES=	gssapi:mit
GSSAPI_MIT_CONFIGURE_ON=	--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}
GSSAPI_NONE_CONFIGURE_ON=	--without-gssapi

17.44. gstreamer

可能的参数:(无)

提供一种依赖于 GStreamer 组件的简单方式。组件应列在 USE_GSTREAMER 中。可用的组件包括:

  • a52dec

  • aalib

  • amrnb

  • amrwbdec

  • aom

  • assrender

  • bad

  • bs2b

  • cairo

  • cdio

  • cdparanoia

  • chromaprint

  • curl

  • dash

  • dtls

  • dts

  • dv

  • dvd

  • dvdread

  • editing-services

  • faac

  • faad

  • flac

  • flite

  • gdkpixbuf

  • gl

  • gme

  • gnonlin

  • good

  • gsm

  • gtk4

  • gtk

  • hal

  • hls

  • jack

  • jpeg

  • kate

  • kms

  • ladspa

  • lame

  • libav

  • libcaca

  • libde265

  • libmms

  • libvisual

  • lv2

  • mm

  • modplug

  • mpeg2dec

  • mpeg2enc

  • mpg123

  • mplex

  • musepack

  • neon

  • ogg

  • opencv

  • openexr

  • openh264

  • openjpeg

  • openmpt

  • opus

  • pango

  • png

  • pulse

  • qt

  • resindvd

  • rsvg

  • rtmp

  • shout2

  • sidplay

  • smoothstreaming

  • sndfile

  • sndio

  • soundtouch

  • soup

  • spandsp

  • speex

  • srtp

  • taglib

  • theora

  • ttml

  • twolame

  • ugly

  • v4l2

  • vorbis

  • vpx

  • vulkan

  • wavpack

  • webp

  • webrtcdsp

  • x264

  • x265

  • x

  • ximagesrc

  • zbar

17.45. guile

可能的参数:(无), X.Y , flavors , build , run , alias , conflicts

增加对 Guile 的依赖。默认情况下,这是对适当 libguile*.so 的库依赖,除非被 build 和/或 run 选项覆盖。 alias 选项适当地配置 BINARY_ALIAS (请参阅使用 BINARY_ALIAS )。

默认版本由通常 DEFAULT_VERSIONS 机制设置;如果默认版本不是所列版本之一,则使用最新可用的所列版本。

使用 Guile 的应用程序通常仅构建为单个 Guile 版本。但是,扩展或库模块应使用 flavors 选项以与多个 flavors 构建。

获取更多信息,请参阅使用 Guile。

17.46. horde

可能的参数:(无)

添加构建时间和运行时依赖项至 devel/pear-channel-horde。其他 Horde 依赖项可以通过 USE_HORDE_BUILD 和 USE_HORDE_RUN 添加。有关更多信息,请参阅 Horde 模块。

17.47. iconv

可能的参数:(无), lib , build , patch , translit , wchar_t

使用 iconv 函数,要么来自port转换器/libiconv 作为构建时和运行时依赖,要么来自基本系统。默认情况下,没有参数或使用 lib 参数,意味着使用构建时和运行时依赖的 iconv 。 build 意味着构建时依赖, patch 意味着补丁时间依赖。如果port 使用 WCHAR_T 或 //TRANSLIT 的 iconv 扩展,添加相关参数以使用正确的 iconv。有关更多信息,请参阅 使用 iconv 。

17.48. imake

可能的参数:(无), env , notall , noman

将 devel/imake 添加为构建时依赖项,并在 configure 阶段运行 xmkmf -a 。如果给定了 env 参数,则不设置 configure 目标。如果 -a 标志对port造成问题,请添加 notall 参数。如果 xmkmf 未生成 install.man 目标,请添加 noman 参数。

17.49. kde

可能的参数: 5

添加对 KDE 组件的依赖。有关更多信息,请参阅使用 KDE。

17.50. kmod

可能的参数:(无), debug

填充内核模块ports的样板,目前:

  • 将 kld 添加到 CATEGORIES 。

  • 設置 SSP_UNSAFE 。

  • 如果在 SRC_BASE 中找不到內核源碼,則設置 IGNORE 。

  • 默認將 KMODDIR 定義為 /boot/modules,將其添加到 PLIST_SUB 和 MAKE_ENV 中,並在安裝時創建它。 如果 KMODDIR 設置為 /boot/kernel,則將其重寫為 /boot/modules。 這可以防止在升級內核過程中由於 /boot/kernel 被重命名為 /boot/kernel.old 而破壞包。

  • 使用 @kld 处理内核模块在安装和卸载时的交叉引用。

  • 如果提供了 debug 参数,port 可以将模块的调试版本安装到 KERN_DEBUGDIR/KMODDIR 中。默认情况下, KERN_DEBUGDIR 从 DEBUGDIR 复制并设置为 /usr/lib/debug。框架将负责创建和删除任何所需的目录。

17.51. ldap

可能的参数:(无),,客户端,服务器

注册对 net/openldap 的依赖。如果设置了特定的 (不使用点符号),则使用该版本。否则,尝试查找当前安装的版本。如有必要,将回退到 bsd.default-versions.mk 中找到的默认版本。 client 指定对客户端库的运行时依赖。这也是默认设置。 server 指定对服务器的运行时依赖。

可以由 port 访问以下变量:

IGNORE_WITH_OPENLDAP

如果 ports 不支持一个或多个版本的 OpenLDAP,则可以定义此变量。

WITH_OPENLDAP_VER

用户定义的变量以设置 OpenLDAP 版本。

OPENLDAP_VER

检测到的 OpenLDAP 版本。

17.52. lha

可能的参数:(无)

将 EXTRACT_SUFX 设置为 .lzh

17.53. libarchive

可能的参数:(无)

注册对 archivers/libarchive 的依赖。任何依赖于 libarchive 的 ports 都必须包含 USES=libarchive 。

17.54. libedit

可能的参数:(无)

注册对 devel/libedit 的依赖。任何依赖于 libedit 的 ports 必须包含 USES=libedit 。

17.55. libtool

可能的参数:(无), keepla , build

补丁 libtool 脚本。这必须添加到所有使用 libtool 的 ports 中。可以使用 keepla 参数保留 .la 文件。一些 ports 不包含自己的 libtool 副本,需要在构建时依赖 devel/libtool,请使用 :build 参数添加此类依赖关系。

17.56. linux

可能的参数: c6 , c7

Ports Linux 兼容框架。指定 c6 以依赖于 CentOS 6 包。指定 c7 以依赖于 CentOS 7 包。可用的软件包有:

  • allegro

  • alsa-plugins-oss

  • alsa-plugins-pulseaudio

  • alsalib

  • atk

  • avahi-libs

  • base

  • cairo

  • cups-libs

  • curl

  • cyrus-sasl2

  • dbusglib

  • dbuslibs

  • devtools

  • dri

  • expat

  • flac

  • fontconfig

  • gdkpixbuf2

  • gnutls

  • graphite2

  • gtk2

  • harfbuzz

  • jasper

  • jbigkit

  • jpeg

  • libasyncns

  • libaudiofile

  • libelf

  • libgcrypt

  • libgfortran

  • libgpg-error

  • libmng

  • libogg

  • libpciaccess

  • libsndfile

  • libsoup

  • libssh2

  • libtasn1

  • libthai

  • libtheora

  • libv4l

  • libvorbis

  • libxml2

  • mikmod

  • naslibs

  • ncurses-base

  • nspr

  • nss

  • openal

  • openal-soft

  • openldap

  • openmotif

  • openssl

  • pango

  • pixman

  • png

  • pulseaudio-libs

  • qt

  • qt-x11

  • qtwebkit

  • scimlibs

  • sdl12

  • sdlimage

  • sdlmixer

  • sqlite3

  • tcl85

  • tcp_wrappers-libs

  • tiff

  • tk85

  • ucl

  • xorglibs

17.57. llvm

可能的参数:(无), XY ,最小值= XY ,最大值= XY ,构建,运行,库

添加对 LLVM 的依赖。默认情况下,这是构建依赖,除非被 run 或 lib 选项覆盖。默认版本是设置在 LLVM_DEFAULT 中的版本。也可以指定特定版本。最小和最大版本可以分别用 min 和 max 参数指定。ports框架将以下变量导出到port:

LLVM_VERSION

从 llvm.mk 的参数中选择的版本

LLVM_PORT

已选 llvm port

LLVM_CONFIG

已选 port 的 llvm-config

LLVM_LIBLLVM

已选 port 的 libLLVM.so

LLVM_PREFIX

选定port的安装前缀

17.58. localbase

可能的参数:(无), ldflags

确保在 LOCALBASE 中使用依赖项中的库,而不是基本系统中的库。指定 ldflags 将 -L${LOCALBASE}/lib 添加到 LDFLAGS 而不是 LIBS 。应使用在基本系统中也存在库的Ports。一些其他 USES 也在内部使用它。

17.59. lua

可能的参数有:(无), XYXY+ , -XYXY-ZA , module , flavors , build , run , env

添加对 Lua 的依赖。默认情况下这是一个库依赖,除非通过 build 和/或 run 选项覆盖。 env 选项阻止添加任何依赖,同时仍然定义所有通常的变量。

默认版本由通常的 DEFAULT_VERSIONS 机制设置,除非指定了版本或版本范围作为参数,例如, 51 或 51-54 。

使用 Lua 的应用通常仅构建为一个 Lua 版本。然而,预期由 Lua 代码加载的库模块应使用 module 选项构建多个 flavors。

更多信息请参阅 Lua 使用。

17.60. luajit

可能的参数:(无), X

添加对 luajit 运行时的依赖。可以使用特定版本 X。可能的版本是 luajit , luajit-devel , luajit-openresty

在包含 bsd.port.options.mk 或 bsd.port.pre.mk 之后,port可以检查这些变量:

LUAJIT_VER 所选的 luajit 版本

LUAJIT_INCDIR 查找 luajit 的头文件路径

LUAJIT_LUAVER 选择的 luajit 规范版本(luajit 为 2.0,否则为 2.1)

查看更多信息,请参阅 Lua 使用。

17.61. lxqt

可能的参数:(无)

处理 LXQt 桌面环境的依赖关系。使用 USE_LXQT 选择所需的组件port。更多信息,请参阅使用 LXQt。

17.62. magick

可能的参数:(无), X , build , nox11 , run , test

添加对 ImageMagick 的库依赖。可以使用特定版本 X。可能的版本为 6 和 7 (默认)。 nox11 表示需要 port 的 -nox11 版本。 build 、 run 和 test 添加到 ImageMagick 的构建、运行时和测试依赖。

17.63. makeinfo

可能的参数:(无)

如果基础系统中不存在 makeinfo ,则添加到构建时依赖。

17.64. makeself

可能的参数:(无)

表示分发文件为 makeself 存档,并设置适当的依赖关系。

17.65. mate

可能的参数:(无)

提供一种依赖于 MATE 组件的简单方法。组件应列在 USE_MATE 中。可用的组件是:

  • autogen

  • caja

  • common

  • controlcenter

  • desktop

  • dialogs

  • docutils

  • icontheme

  • intlhack

  • intltool

  • libmatekbd

  • libmateweather

  • marco

  • menus

  • notificationdaemon

  • panel

  • pluma

  • polkit

  • session

  • settingsdaemon

默认依赖是构建和运行时的,可以通过 :build 或 :run 更改。例如:

USES=		mate
USE_MATE=	menus:build intlhack

17.66. meson

可能的参数:(无)

支持基于 Meson 的项目。有关更多信息,请参见使用 meson 。

17.67. metaport

可能的参数:(无)

设置以下变量,以便更轻松地创建元端口: MASTER_SITES , DISTFILES , EXTRACT_ONLY , NO_BUILD , NO_INSTALL , NO_MTREE , NO_ARCH 。

17.68. minizip

可能的参数:(无), ng

添加对 archivers/minizip 或 archivers/minizip-ng 的库依赖。

17.69. mysql

可能的参数:(无), version , client (默认), server , embedded

如果没有给出版本号,则尝试查找当前安装的版本。回退到默认版本,MySQL-5.6。可能的版本是 55 , 55m , 55p , 56 , 56p , 56w , 57 , 57p , 80 , 100m , 101m 和 102m 。 m 和 p 后缀用于 MySQL 的 MariaDB 和 Percona 变体。 server 和 embedded 添加了对 MySQL 服务器的构建和运行时依赖。使用 server 或 embedded 时,还添加 client 以添加对 libmysqlclient.so 的依赖。port可以设置 IGNORE_WITH_MYSQL ,如果某些版本不受支持。

框架将 MYSQL_VER 设置为检测到的 MySQL 版本。

17.70. mono

可能的参数:(无), nuget

通过设置适当的依赖关系,向 Mono(目前仅支持 C#)框架添加依赖。

当port使用 nuget 软件包时,请指定 nuget 。 NUGET_DEPENDS 需要以 name=version 格式设置 nuget 软件包的名称和版本。可以使用 name=version:origin 添加可选的软件包来源。

助手目标 buildnuget 将根据提供的 packages.config 输出 NUGET_DEPENDS 的内容。

17.71. motif

可能的参数: (无)

使用 x11-toolkits/open-motif 作为库依赖。最终用户可以在 make.conf 中设置 WANT_LESSTIF 使用 x11-toolkits/lesstif 作为依赖,而不是 x11-toolkits/open-motif。类似地,设置 WANT_OPEN_MOTIF_DEVEL 在 make.conf 中将添加依赖 x11-toolkits/open-motif-devel。

17.72. ncurses

可能的参数: (无), base , port

使用 ncurses,并设置一些有用的变量。

17.73. nextcloud

可能的参数:(无)

通过在运行时依赖于 www/nextcloud 来增加对 Nextcloud 应用程序的支持。

17.74. ninja

可能的参数:(无), build , make (默认), run

如果指定了 build 或 run 参数,则分别添加构建或运行时依赖于 devel/ninja。如果提供了 make 或没有参数,则使用 ninja 来构建port而不是 make。 make 意味着 build 。如果变量 NINJA_DEFAULT 设置为 samurai ,则依赖项设置为 devel/samurai。

17.75. nodejs

可能的参数:(无), build , run , current , lts , 10 , 14 , 16 , 17 。

使用 nodejs。 在 www/node* 上添加依赖项。如果指定了受支持的版本,则还必须指定 run 和/或 build 。

17.76. objc

可能的参数:(无)

如果基础系统不支持,添加 Objective C 依赖项(编译器,运行时库)。

17.77. octave

可能的参数:(无), env

使用 math/octave。 env 仅加载一个 OCTAVE_VERSION 环境变量。

17.78. openal

可能的参数: al , soft (默认), si , alut

使用 OpenAL 。 可以指定后端,软件实现为默认设置。 用户可以使用 WANT_OPENAL 指定首选后端。 此旋钮的有效值为 soft (默认)和 si 。

17.79. pathfix

可能的参数:(无)

查找 Makefile.in 和 configure 在 PATHFIX_WRKSRC (默认为 WRKSRC ) 中,并修复常见路径,以确保它们符合 FreeBSD 层次结构。 例如,它自动修复 pkgconfig’s .pc files to ${PREFIX}/libdata/pkgconfig. If the port uses USES=autoreconf , Makefile.am will be added to PATHFIX_MAKEFILEIN`的安装目录。

如果port USES=cmake ,它会查找 PATHFIX_WRKSRC 中的 CMakeLists.txt。如有需要,可以使用 PATHFIX_CMAKELISTSTXT 来更改默认文件名。

17.80. pear

可能的参数: env

添加对 devel/pear 的依赖。它将为使用 PHP 扩展和应用程序存储库的软件设置默认行为。仅仅使用 env 参数设置 PEAR 环境变量。有关更多信息,请参见 PEAR 模块。

17.81. perl5

可能的参数:(无)

依赖于 Perl。配置使用 USE_PERL5 完成。

USE_PERL5 可以包含使用 Perl 的阶段,可以是 extract , patch , build , run 或 test 。

USE_PERL5 在需要 Makefile.PL、Build.PL 或 Module::Build::Tiny 的 Build.PL 的时候,也可以包含 configure 、 modbuild 或 modbuildtiny 。

USE_PERL5 默认为 build run 。在使用 configure 、 modbuild 或 modbuildtiny 时,意味着 build 和 run 。

查看有关更多信息,请参阅《使用 Perl》。

17.82. pgsql

可能的参数:(无), X.YX.Y+ , X.Y- , X.Y-Z.A

提供对 PostgreSQL 的支持。Port 维护者可以设置所需的版本。可以指定最小和最大版本或范围;例如, 9.0- , 8.4+ , 8.4-9.2.

默认情况下,添加的依赖将是客户端,但如果 port 需要额外的组件,则可以使用 WANT_PGSQL=component[:target] ;例如, WANT_PGSQL=server:configure pltcl plperl 。可用的组件包括:

  • client

  • contrib

  • docs

  • pgtcl

  • plperl

  • plpython

  • pltcl

  • server

17.83. php

可能的参数:(无), phpize , ext , zend , build , cli , cgi , mod , web , embed , pecl , flavors , noflavors

支持 PHP。添加对默认 PHP 版本 lang/php81 的运行时依赖。

phpize

用于构建 PHP 扩展。启用 flavors。

ext

用于构建、安装和注册 PHP 扩展。启用 flavors。

zend

用于构建、安装和注册 Zend 扩展。启用 flavors。

build

将 PHP 也设置为构建时依赖项。

cli

需要 PHP 的 CLI 版本。

cgi

需要 PHP 的 CGI 版本。

mod

需要 PHP 的 Apache 模块。

web

需要 Apache 模块或 PHP 的 CGI 版本。

embed

需要 PHP 的嵌入式库版本。

pecl

为从 PECL 存储库获取 PHP 扩展提供默认值。启用flavors。

flavors

启用自动生成 PHP flavors。将为除了 IGNORE_WITH_PHP 中已有的所有 PHP 版本生成 Flavors 。

noflavors

禁用自动生成 PHP flavors。仅适用于 PHP 自身提供的扩展。

变量用于指定所需的 PHP 模块以及支持的 PHP 版本。

USE_PHP

在运行时所需的 PHP 扩展列表。将 :build 添加到扩展名中以添加构建时依赖项。例如: pcre xml:build gettext

IGNORE_WITH_PHP

port与给定版本的 PHP 不兼容。有关可能的值,请查看 Mk/Uses/php.mk 中 _ALL_PHP_VERSIONS 的内容。

使用 :ext 或 :zend 构建 PHP 或 Zend 扩展时,可以设置这些变量:

PHP_MODNAME

PHP 或 Zend 扩展的名称。默认值是 ${PORTNAME} 。

PHP_HEADER_DIRS

从中安装头文件的子目录列表。框架将始终安装与扩展位于同一目录中的头文件。

PHP_MOD_PRIO

加载扩展的优先级。它是 00 和 99 之间的一个数字。

对于不依赖任何扩展的扩展,优先级会自动设置为 20 ,对于依赖另一个扩展的扩展,优先级会自动设置为 30 。有些扩展可能需要在所有其他扩展之前加载,例如 www/php56-opcache。有些可能需要在具有 30 优先级的扩展之后加载。在这种情况下,在port的 Makefile 中添加 PHP_MOD_PRIO=XX 。例如:

USES=		php:ext
USE_PHP=	wddx
PHP_MOD_PRIO=	40

这些变量可用于 PKGNAMEPREFIX 或 PKGNAMESUFFIX :

PHP_PKGNAMEPREFIX

包含 php_XY_- ,其中 XY 是当前flavor的 PHP 版本。与 PHP 扩展和模块一起使用。

PHP_PKGNAMESUFFIX

包含 -php_XY_ ,其中 XY 是当前 flavor 的 PHP 版本。与 PHP 应用程序一起使用。

PECL_PKGNAMEPREFIX

包含 php_XY_-pecl- ,其中 XY 是当前 flavor 的 PHP 版本。与 PECL 模块一起使用。

17.84. pkgconfig

可能的参数: (无), build (默认), run , both

使用 devel/pkgconf。没有参数或使用 build 参数,意味着 pkg-config 作为构建时依赖。 run 意味着运行时依赖, both 意味着同时是运行时和构建时依赖。

17.85. pure

可能的参数: (无), ffi

使用 lang/pure。主要用于构建相关的纯 ports。使用 ffi 参数时,意味着 devel/pure-ffi 作为运行时依赖。

17.86. pyqt

可能的参数: (无), 4 , 5

使用 PyQt。如果 port 是 PyQt 本身的一部分,请设置 PYQT_DIST 。使用 USE_PYQT 选择 port 需要的组件。可用的组件有:

  • core

  • dbus

  • dbussupport

  • demo

  • designer

  • designerplugin

  • doc

  • gui

  • multimedia

  • network

  • opengl

  • qscintilla2

  • sip

  • sql

  • svg

  • test

  • webkit

  • xml

  • xmlpatterns

这些组件只能在 PyQT4 中使用:

  • assistant

  • declarative

  • help

  • phonon

  • script

  • scripttools

这些组件只能在 PyQT5 中使用:

  • multimediawidgets

  • printsupport

  • qml

  • serialport

  • webkitwidgets

  • widgets

每个组件的默认依赖是构建时和运行时的,要只选择构建或运行时,请在组件名称后添加 _build 或 _run 。例如:

USES=		pyqt
USE_PYQT=	core doc_build designer_run

17.87. pytest

可能的参数:(无),4

引入了新的依赖关系 devel/pytest。它定义了一个 do-test 目标,将正确运行测试。使用参数依赖于特定的 devel/pytest 版本。对于ports使用 devel/pytest 的人考虑使用这个而不是特定的 do-test 目标。该框架向port公开以下变量:

PYTEST_ARGS pytest 的额外参数(默认为空)。

PYTEST_IGNORED_TESTS 个测试忽略模式列表 pytest -k (默认为空)。适用于不会通过的测试,比如需要数据库访问的测试。

PYTEST_BROKEN_TESTS 个测试忽略模式列表 pytest -k (默认为空)。适用于需要修复的错误测试。

另外,用户可以设置以下变量:

PYTEST_ENABLE_IGNORED_TESTS 启用通常被 PYTEST_IGNORED_TESTS 忽略的测试。

PYTEST_ENABLE_BROKEN_TESTS 启用通常被 PYTEST_BROKEN_TESTS 忽略的测试。

PYTEST_ENABLE_ALL_TESTS 启用通常被 PYTEST_IGNORED_TESTS 和 PYTEST_BROKEN_TESTS 忽略的测试。

17.88. python

可能的参数: (无), X.Y , X.Y+ , -X.Y , X.Y-Z.A , patch , build , run , test

使用 Python。可以指定支持的版本或版本范围。如果 Python 仅在构建时、运行时或用于测试时需要,可以将其设置为构建、运行或测试依赖项,使用 build , run , 或 test 。如果在修补阶段也需要 Python,请使用 patch 。有关详细信息,请参阅使用 Python。

当需要框架导出的变量但不需要依赖 Python 时,可以使用 USES=python:env 。这可能发生在使用 USES=shebangfix 时,目标只是修复 shebangs 而不添加对 Python 的依赖。

17.89. qmail

可能的参数:(无), build , run , both , vars

使用 mail/qmail。使用 build 参数时,意味着 qmail 是一个构建时依赖。 run 意味着是运行时依赖。不使用参数或使用 both 参数意味着同时是运行时和构建时依赖。 vars 只会设置 QMAIL 变量供 port 使用。

17.90. qmake

可能的参数:(无), norecursive , outsource , no_env , no_configure

使用 QMake 进行配置。有关详细信息,请参阅 使用 qmake 。

17.91. qt

可能的参数: 5 , 6 , no_env

添加依赖于 Qt 组件。 no_env 直接传递给 USES= qmake 。有关详细信息,请参阅 使用 Qt。

17.92. qt-dist

可能的参数:(无)或 5 和(无)或 6 和(无)或其中之一 3d , 5compat , base , charts , connectivity , datavis3d , declarative , doc languageserver , gamepad , graphicaleffects , imageformats , locat ion , lottie , multimedia , networkauth , positioning , quick3d , quickcontrols2 , quickcontrols , quicktimeline , remoteobjects , script , scxml , sensors , serialbus , serialport , shadertools , speech , svg , tools , translations , virtualkeyboard , wayland , webchannel , webengine , webglplugin , websockets , webview , x11extras , xmlpatterns 。

提供构建 Qt 5 和 Qt 6 组件的支持。 它会处理配置适当环境的设置port构建。

示例 7. 构建 Qt 5 组件

port是 Qt 5 的 networkauth 组件,是 networkauth 分发文件的一部分。

PORTNAME=	networkauth
DISTVERSION=	${QT5_VERSION}

USES=		qt-dist:5

示例 8. 构建 Qt 6 组件

port是 Qt 6 的 websockets 组件,是 websockets 分发文件的一部分。

PORTNAME=       websockets
PORTVERSION=    ${QT6_VERSION}

USES=           qt-dist:6

如果 PORTNAME 与组件名称不匹配,则可以将其作为参数传递给 qt-dist 。

例 9。使用不同名称构建 Qt 5 组件

port是 Qt 5 的 gui 组件,是 base 分发文件的一部分。

PORTNAME=	gui
DISTVERSION=	${QT5_VERSION}

USES=		qt-dist:5,base

17.93. readline

可能的参数:(无), port

使用 readline 作为库依赖,并根据需要设置 CPPFLAGS 和 LDFLAGS 。如果使用了 port 参数或基本系统中没有安装 readline,则添加一个 devel/readline 的依赖项。

17.94. ruby

可能的参数:(无), build , extconf , run , setup

提供对与 Ruby 相关的 ports 的支持。 (none) 没有参数会在运行时依赖于 lang/ruby。 build 在构建时会依赖于 lang/ruby。 extconf 表示 port 使用 extconf.rb 进行配置。 run 在运行时会依赖于 lang/ruby,这也是默认设置。 setup 表示 port 使用 setup.rb 进行配置和构建。

用户可以定义以下变量:

RUBY_VER 表示 ruby 的替代短版本,格式为 `x.y'。

RUBY_DEFAULT_VER 设置为 (例如) 2.7 以使用 ruby27 作为默认版本。

RUBY_ARCH 设置架构名称 (例如 i386-freebsd7)。

导出以下变量供 port 使用:

RUBY 设为 Ruby 的完整路径。如果设置,以下变量的值将自动从 Ruby 可执行文件中获取: RUBY_ARCH , RUBY_ARCHLIBDIR , RUBY_LIBDIR , RUBY_SITEARCHLIBDIR , RUBY_SITELIBDIR , RUBY_VER and RUBY_VERSION

RUBY_VER 设为 Ruby 的替代短版本,格式为 `x.y'。

RUBY_EXTCONF 设为 extconf.rb 的替代名称(默认值:extconf.rb)。

RUBY_EXTCONF_SUBDIRS 设置为子目录列表,如果包含多个模块。

RUBY_SETUP 设置为 setup.rb 的替代名称(默认为 setup.rb)。

17.95. samba

可能的参数: build , env , lib , run

处理对 Samba 的依赖。 env 不会添加任何依赖,只会设置变量。 build 和 run 会在 smbd 上添加构建时和运行时依赖。 lib 将添加一个对 libsmbclient.so 的依赖。被导出的变量是:

SAMBAPORT 默认 Samba port 的来源。

SAMBAINCLUDES Samba 头文件的位置。

SAMBALIBS Samba 共享库所在的目录。

17.96. scons

可能的参数:(无)

为 devel/scons 的使用提供支持。有关更多信息,请参阅 使用 scons 。

17.97. shared-mime-info

可能的参数:(无)

使用 misc/shared-mime-info 中的 update-mime-database。这将自动添加一个 post-install 步骤,使 port 本身仍然可以根据需要指定自己的 post-install 步骤。它还会在 plist 中添加一个 @shared-mime-info 条目。

17.98. shebangfix

可能的参数:(无)

许多软件在脚本解释器的位置上使用不正确,最明显的是 /usr/bin/perl 和 /bin/bash。shebangfix 宏修复列在 SHEBANG_REGEX 、 SHEBANG_GLOB 或 SHEBANG_FILES 中的脚本的 shebang 行。

SHEBANG_REGEX

包含一个扩展正则表达式,并与 find(1) 的 -iregex 参数一起使用。参见 USES=shebangfix 与 SHEBANG_REGEX 。

SHEBANG_GLOB

包含与 find(1) 的 -name 参数一起使用的模式列表。参见 USES=shebangfix 与 SHEBANG_GLOB 。

SHEBANG_FILES

包含文件列表或 sh(1)通配符。 shebangfix 宏从 ${WRKSRC} 执行,因此 SHEBANG_FILES 可以包含相对于 ${WRKSRC} 的路径。如果 ${WRKSRC} 外的文件需要打补丁,它也可以处理绝对路径。参见 USES=shebangfix 与 SHEBANG_FILES 。

目前默认支持 Bash、Java、Ksh、Lua、Perl、PHP、Python、Ruby、Tcl 和 Tk。

有三个配置变量:

SHEBANG_LANG

受支持的解释器列表。

_interp__CMD

FreeBSD 上命令解释器的路径。默认值为 ${LOCALBASE}/bin/interp

_interp__OLD_CMD

解释器的错误调用列表。这些通常是过时的路径,或者是在其他操作系统上使用的在 FreeBSD 上不正确的路径。它们将在 _interp__CMD 中被正确的路径替换。

示例 10. 添加另一个解释器到 USES=shebangfix

要添加另一个解释器,请设置 SHEBANG_LANG 。例如:

SHEBANG_LANG=	lua

示例 11. 在添加解释器到 USES=shebangfix 时指定所有路径

如果它尚未定义,并且对于 _interpOLD_CMD 和 _interp 没有默认值,Ksh 条目可以定义为:

SHEBANG_LANG=	ksh
ksh_OLD_CMD=	"/usr/bin/env ksh" /bin/ksh /usr/bin/ksh
ksh_CMD=	${LOCALBASE}/bin/ksh

示例 12. 为解释器添加一个奇怪的位置

一些软件使用奇怪的位置来放置解释器。例如,一个应用程序可能期望 Python 位于 /opt/bin/python2.7。可以在 port Makefile 中声明要替换的奇怪路径:

python_OLD_CMD=	/opt/bin/python2.7

示例 13. USES=shebangfix 与 SHEBANG_REGEX

为了修复所有以 .pl、.sh 或 .cgi 结尾的文件,请执行:

USES=	shebangfix
SHEBANG_REGEX=	./scripts/.*\.(sh|pl|cgi)

示例 14。 USES=shebangfix 和 SHEBANG_GLOB

修复所有以 .pl 或 .sh 结尾的文件 ${WRKSRC} ,请执行:

USES=	shebangfix
SHEBANG_GLOB=	*.sh *.pl

示例 15. USES=shebangfix 和 SHEBANG_FILES

要修复 ${WRKSRC} 中的文件 script/foobar.pl 和 script/*.sh,请执行:

USES=	shebangfix
SHEBANG_FILES=	scripts/foobar.pl scripts/*.sh

17.99. sqlite

可能的参数:(无), 2 , 3

添加对 SQLite 的依赖。默认使用的版本是 3,但也可以使用 :2 修改器来使用版本 2。

17.100. ssl

可能的参数:(无), build , run

提供对 OpenSSL 的支持。可以使用 build 或 run 来指定仅限构建或运行时的依赖关系。这些变量供port使用,也添加到 MAKE_ENV 中:

OPENSSLBASE

OpenSSL 安装基础路径。

OPENSSLDIR

OpenSSL 配置文件路径。

OPENSSLLIB

OpenSSL 库的路径。

OPENSSLINC

OpenSSL 包含文件的路径。

OPENSSLRPATH

如果定义了,链接器需要使用的 OpenSSL 库的路径。

BROKEN_SSL=	libressl
BROKEN_SSL_REASON_libressl=	needs features only available in OpenSSL

17.101. tar

可能的参数: (无), Z , bz2 , bzip2 , lzma , tbz , tbz2 , tgz , txz , xz , zst , zstd

将 EXTRACT_SUFX 设置为 .tar , .tar.Z , .tar.bz2 , .tar.bz2 , .tar.lzma , .tbz , .tbz2 , .tgz , .txz , .tar.xz , .tar.zst 或 .tar.zstd 之一。

17.102. tcl

可能的参数: 版本, wrapper , build , run , tea

添加对 Tcl 的依赖。可以使用版本号进行特定版本的请求。版本号可以为空,一个或多个精确的版本号(当前 84 , 85 或 86 ),或一个最低版本号(当前 84+ , 85+ 或 86+ )。若只需请求一个非特定版本的 Wrapper,请使用 wrapper 。可以使用 build 或 run 指定构建时或运行时的依赖项。要使用 Tcl 扩展架构构建 port,请使用 tea 。在包含 bsd.port.pre.mk 后,port 可以使用这些变量检查结果:

  • TCL_VER :所选的 Tcl 主版本.次版本号

  • TCLSH :Tcl 解释器的完整路径

  • TCL_LIBDIR :Tcl 库的路径

  • TCL_INCLUDEDIR :Tcl C 头文件的路径

  • TK_VER :选择的 Tk 主版本号.次版本号

  • WISH :Tk 解释器的完整路径

  • TK_LIBDIR :Tk 库的路径

  • TK_INCLUDEDIR :Tk C 头文件的路径

17.103. terminfo

可能的参数:(无)

将 @terminfo 添加到 plist 中。在 ${PREFIX}/share/misc 中安装 *.terminfo 文件时使用。

17.104. tex

可能的参数:(无)

提供对 tex 的支持。加载所有与 TEX 相关的默认变量 ports,并且不增加任何 ports 的依赖。

变量用于指定所需的 TEX 模块。

USE_TEX 运行时所需的 TEX 扩展列表。添加 :build 到扩展名以添加构建时依赖项,添加 :run 以添加运行时依赖项,添加 :test 以添加测试时依赖项,添加 :extract 以添加提取时依赖项。例如: base texmf:build source:run

目前可能的参数如下:

  • base

  • texmf

  • source

  • docs

  • web2c

  • kpathsea

  • ptexenc

  • basic

  • tlmgr

  • texlua

  • texluajit

  • synctex

  • xpdfopen

  • dvipsk

  • dvipdfmx

  • xdvik

  • gbklatex

  • formats

  • tex

  • latex

  • pdftex

  • jadetex

  • luatex

  • ptex

  • xetex

  • xmltex

  • texhash

  • updmap

  • fmtutil

17.105. tk

与 tcl 的参数相同

当同时使用 Tcl 和 Tk 时的小包装。当使用 Tcl 时,返回的变量与之相同。

17.106. uidfix

可能的参数:(无)

更改构建系统的某些默认行为(主要是变量),以允许将此作为普通用户安装。在使用 USES=fakeroot 或打补丁之前,请在 port 中尝试这种方法。

17.107. uniquefiles

可能的参数:(无), dirs

通过添加前缀或后缀使文件或目录 'unique'。如果使用 dirs 参数,则基于 UNIQUE_PREFIX 对标准目录 DOCSDIR 、 EXAMPLESDIR 、 DATADIR 、 WWWDIR 、 ETCDIR 进行前缀添加(仅前缀)。这些变量适用于 ports:

  • UNIQUE_PREFIX :要用于目录和文件的前缀。默认: ${PKGNAMEPREFIX} 。

  • UNIQUE_PREFIX_FILES :需要添加前缀的文件列表。默认:空。

  • UNIQUE_SUFFIX :用于文件的后缀。默认: ${PKGNAMESUFFIX} 。

  • UNIQUE_SUFFIX_FILES :需要添加后缀的文件列表。默认:空。

17.108. vala

可能的参数: build , lib , no_depend

添加构建或库依赖于 lang/vala。 no_depend 参数保留给 lang/vala 本身。

17.109. varnish

可能的参数: 4 (默认), 6 , 7

处理对 Varnish Cache 的依赖。添加对 www/varnish*的依赖。

17.110. webplugin

可能的参数: (无), ARGS

自动为支持 webplugin 框架的每个应用程序创建和删除符号链接。 ARGS 可以是以下之一:

  • gecko :支持基于 Gecko 的插件

  • native :支持 Gecko、Opera 和 WebKit-GTK 插件

  • linux :支持 Linux 插件

  • all (默认,隐式):支持所有插件类型

  • (个体条目): 仅支持所列的浏览器

这些变量可以调整:

  • WEBPLUGIN_FILES :无默认值,必须手动设置。安装插件文件。

  • WEBPLUGIN_DIR :安装插件文件的目录,默认为 PREFIX/lib/browser_plugins/WEBPLUGIN_NAME。如果 port 将插件文件安装在默认目录之外,请设置此项以防止损坏的符号链接。

  • WEBPLUGIN_NAME :安装插件文件的最终目录,默认为 PKGBASE 。

17.111. xfce

可能的参数:(无), gtk2

提供对与 Xfce 相关的 ports 的支持。详见使用 Xfce 以获取详情。

gtk2 参数指定 port 需要 GTK2 支持。它添加了一些核心组件提供的额外功能,例如 x11/libxfce4menu 和 x11-wm/xfce4-panel。

17.112. xorg

可能的参数:(无)

提供了依赖于 X.org 组件的简便方法。这些组件应该在 USE_XORG 中列出。可用的组件为:

表 1. 可用的 X.Org 组件

17.113. xorg-cat

可能的参数: app , data , doc , driver , font , lib , proto , util , xserver 和(无)或一个关闭 autotools (默认), meson

提供支持构建 Xorg 组件。它负责设置所需的常见依赖项和适当的配置环境。此功能仅用于 Xorg 组件。

类别必须与上游类别匹配。

第二个参数是要使用的构建系统。autotools 是默认选项,但也支持 meson。

17.114. zip

可能的参数: (无), infozip

表示分发文件使用 ZIP 压缩算法。对于使用 InfoZip 算法的文件,必须传递 infozip 参数以设置适当的依赖项。

最后更新于

FreeBSD 中文社区 2024