libfaketime 技术文档

1. 安装指南

1.1 编译与安装

1. 克隆或下载 libfaketime 项目源码。
2. 进入项目目录，运行以下命令进行编译：

   make
   

3. 编译完成后，运行测试程序以确保安装成功：

   make test
   

4. 如果测试通过，可以将 libfaketime 库文件复制到目标目录。默认情况下，make install 会将库文件安装到 /usr/local/lib/faketime，并将 faketime 脚本安装到 /usr/local/bin。如果需要自定义安装路径，可以修改 Makefile 中的 PREFIX 变量。

1.2 macOS 用户注意事项

在 macOS 上，需要使用 Makefile.OSX 文件进行编译：

make -f Makefile.OSX

编译完成后，使用 DYLD_INSERT_LIBRARIES 和 DYLD_FORCE_FLAT_NAMESPACE 环境变量来加载 libfaketime.1.dylib。

2. 项目使用说明

2.1 基本用法

使用 libfaketime 的基本步骤如下：

1. 确保 libfaketime 库被系统链接器加载。
2. 指定要伪造的时间。

例如，在 Linux 上，可以使用以下命令让 date 命令报告伪造的时间：

LD_PRELOAD=/usr/local/lib/libfaketime.so.1 FAKETIME="-15d" date

2.2 使用绝对日期

可以通过设置 FAKETIME 环境变量来指定绝对日期，例如：

LD_PRELOAD=/usr/local/lib/libfaketime.so.1 FAKETIME="2022-01-01 12:00:00" date

2.3 使用“开始于”日期

可以通过设置 FAKETIME 环境变量来指定一个“开始于”的日期，例如：

LD_PRELOAD=/usr/local/lib/libfaketime.so.1 FAKETIME="@2022-01-01 12:00:00" date

2.4 使用相对日期偏移

可以通过设置 FAKETIME 环境变量来指定相对日期偏移，例如：

LD_PRELOAD=/usr/local/lib/libfaketime.so.1 FAKETIME="-10d" date

2.5 高级功能与注意事项

• 系统级时间伪造：可以通过设置 FAKETIME_NO_CACHE 环境变量来禁用缓存，从而实现系统级时间伪造。
• 进程限制：可以通过设置 FAKETIME_PER_PID 环境变量来限制 libfaketime 对每个进程的影响。

3. 项目API使用文档

3.1 环境变量

• LD_PRELOAD：指定要加载的 libfaketime 库路径。
• FAKETIME：指定要伪造的时间。
• FAKETIME_DONT_FAKE_MONOTONIC：用于 Java 应用程序，避免挂起。
• FAKETIME_TIMESTAMP_FILE：指定包含伪造时间的文件路径。
• FAKETIME_NO_CACHE：禁用缓存。
• FAKETIME_PER_PID：限制 libfaketime 对每个进程的影响。

3.2 库文件

• libfaketime.so.1：用于单线程应用程序。
• libfaketimeMT.so.1：用于多线程应用程序，包含线程同步调用。

4. 项目安装方式

4.1 系统级安装

运行以下命令进行系统级安装：

make install

这将把库文件安装到 /usr/local/lib/faketime，并将 faketime 脚本安装到 /usr/local/bin。

4.2 用户级安装

如果不想进行系统级安装，可以将库文件复制到用户目录，并在运行时指定库路径：

LD_PRELOAD=/path/to/libfaketime.so.1 your_command_here

通过以上步骤，您可以顺利安装并使用 libfaketime 项目，实现对程序时间的伪造。