stagex/musl-fts

镜像概述

该Docker镜像提供musl libc中缺失的fts(3)函数实现。fts(3)是用于文件树遍历的标准库函数族，广泛应用于需要递归遍历目录结构的应用程序。由于musl libc未实现该函数族，本镜像提供兼容实现，使依赖fts(3)的应用可在musl环境中正常运行。

核心功能与特性

• 完整fts(3)函数支持：包含fts_open、fts_read、fts_children、fts_set、fts_close等核心函数实现
• glibc兼容接口：函数接口与glibc的fts(3)保持一致，确保应用无需修改即可使用
• 轻量级设计：仅包含必要的函数实现，不引入额外依赖，镜像体积小巧

使用场景

适用于以下场景：

• 基于Alpine Linux等使用musl libc的容器环境
• 需要运行依赖fts(3)函数的应用程序（如文件管理工具、构建系统、系统工具等）
• 开发或调试依赖fts(3)功能的应用时作为依赖库

使用方法

Dockerfile集成

在基于musl的镜像中集成fts(3)支持：

dockerfile
# 以Alpine为例
FROM docker.xuanyuan.run/alpine:latest
# 从fts3镜像复制库文件
COPY --from=your-image-name /usr/lib/libfts.so /usr/lib/
# 安装并运行依赖fts(3)的应用
...

直接使用示例

验证库文件是否存在：

bash
docker run --rm docker.xuanyuan.run/your-image-name ls /usr/lib/libfts.so

编译链接说明

应用编译时需链接libfts库：

bash
gcc -o app app.c -lfts

注意事项

• 确保应用未硬编码glibc特定依赖
• 静态链接应用需在编译阶段显式链接libfts库
• 库文件默认安装路径为/usr/lib，可直接被系统动态链接器识别