Compile bug: FreeBSD ggml vulkan compilation issue

快速结论：在 FreeBSD（以及受同一宏保护影响的 macOS 等 BSD 系平台）上启用 Vulkan 后端编译 llama.cpp 时，ggml-vulkan-comm.cpp 引用了 F_DUPFD_CLOEXEC，该宏在 _XOPEN_SOURCE=600 下不可见，导致编译失败。优先确认宏可见性与上游补丁。

适用环境：FreeBSD 16.0-CURRENT（amd64，GENERIC-NODEBUG），clang23，CMake 构建，开启 -DGGML_VULKAN=ON，涉及 ggml/src/ggml-vulkan/ggml-vulkan-comm.cpp；该问题由 PR #25051 引入。

最快修复方案：升级到包含 PR #31701 的 llama.cpp 版本；该补丁将 Linux 之外的路径改为 fcntl(fd, F_DUPFD, 0) 加 fcntl(imp_fd, F_SETFD, FD_CLOEXEC)，报告者已确认修复该回归问题。

注意事项：Issue 标记为 bug-unconfirmed；补丁验证环境为 FreeBSD 16.0-CURRENT，FreeBSD 11–15 仅依据旧 POSIX 原语兼容性推断，未逐一实测；自行打补丁属于可优先尝试的临时方案。

问题场景

用户在 FreeBSD 上按自用 CMake 脚本编译 llama.cpp，编译命令中启用了 -DGGML_VULKAN=ON（同时开启 LTO、Native 与 AVX512 等选项），编译到 Vulkan 后端源文件 ggml/src/ggml-vulkan/ggml-vulkan-comm.cpp 时失败。该文件中的 ggml_vk_comm_sfd_exchange() 使用 fcntl(fd, F_DUPFD_CLOEXEC, 0) 来复制文件描述符并设置 close-on-exec。

报错原文

/zfast/github/llama.cpp/ggml/src/ggml-vulkan/ggml-vulkan-comm.cpp:370:69: error: use of undeclared identifier 'F_DUPFD_CLOEXEC'
  370 |             const int imp_fd = fd < 0 || i == last ? fd : fcntl(fd, F_DUPFD_CLOEXEC, 0);
      |                                                                     ^~~~~~~~~~~~~~~
1 error generated.

原因分析

FreeBSD 头文件中确实定义了 F_DUPFD_CLOEXEC，但该定义被 #if __POSIX_VISIBLE >= 200809 包裹。ggml 在 ggml/src/CMakeLists.txt 中对所有 BSD 平台统一传入 -D_XOPEN_SOURCE=600（OpenBSD 为 700），sys/cdefs.h 会据此限制 __POSIX_VISIBLE，使该宏在当前编译单元中不可见。因此这不是 FreeBSD 某一版本的缺口，而是 POSIX 可见性级别导致的问题；同一保护条件也会隐藏 O_CLOEXEC 和 dup3，所以替换成这两个符号并不能绕过。

环境排查

确认操作系统与版本（报告为 FreeBSD 16.0-CURRENT，amd64）。
确认编译器（报告使用 clang23）。
确认 llama.cpp 提交是否包含引入该问题的 PR #25051（首个坏提交为 dcbb0916772195bee457d23751edf8c1cbdc707e，报告时提交为 cd8427d018c07eefab6c110f7f115c31ec4c6157）。
确认 CMake 配置中包含 -DGGML_VULKAN=ON。
检查 ggml 是否对 BSD 传入 -D_XOPEN_SOURCE=600（ggml/src/CMakeLists.txt）。
确认系统头文件中的 F_DUPFD_CLOEXEC 定义及其 __POSIX_VISIBLE 保护条件（如 /usr/include/sys/fcntl.h）。

解决步骤

将 llama.cpp 升级到已合入 PR #31701 的版本，然后按原编译命令重新构建。
无法升级时，可优先尝试在 ggml-vulkan-comm.cpp 中新增 FD 复制辅助函数：Linux 下保持 fcntl(fd, F_DUPFD_CLOEXEC, 0)；其他平台先用 fcntl(fd, F_DUPFD, 0)，成功后再调用 fcntl(imp_fd, F_SETFD, FD_CLOEXEC)。
在 ggml_vk_comm_sfd_exchange() 中把原 fcntl(fd, F_DUPFD_CLOEXEC, 0) 调用替换为该辅助函数。
修改后完整重新配置并构建（报告者使用的 clang23 与完整编译选项均已验证通过）。

验证方法

重新执行完整构建，确认 ggml-vulkan-comm.cpp 不再出现 use of undeclared identifier 'F_DUPFD_CLOEXEC'，且 ggml-vulkan 与各 server 目标均编译链接成功。报告者应用 PR #31701 后确认该回归已修复。另外可用 zig 交叉目标快速确认宏可见性：对 x86_64-freebsd 加 -D_XOPEN_SOURCE=600 预处理 <fcntl.h> 时只能看到 F_DUPFD；改为 -D_XOPEN_SOURCE=700 时才出现 F_DUPFD_CLOEXEC。