IEEE Std 1003.1-2024 (POSIX)中对于errno的定义如下:

The lvalue to which the macro errno expands is used by many functions to return error values.

在更早期的POSIX(Issue 5及以前)以及X/Open文档中,曾经规定errno是一个外部变量(extern int errno),但这使得errno无法实现线程安全,因为所有线程共享同一个全局变量,一个线程的系统调用返回的错误码会覆盖另一个线程的值。因此,POSIX Issue 6(即SUSv3 / IEEE Std 1003.1-2001)将这一要求删除,改为现在的定义:只要求errno是一个展开为int类型的可修改左值(modifiable lvalue)的宏。这为实现者提供了足够的自由度,以支持线程安全的errno。

ISO C标准在C90/C89时期已经不再要求errno是外部变量。

FreeBSD中的errno实现

FreeBSD的sys/sys/errno.h即/usr/include/sys/errno.h中,errno的定义是:

int *	__error(void);
#define	errno		(* __error())

即errno宏会调用 __error() 函数取得一个int *指针,然后对其解引用。这意味着每次访问errno实际上都是一次函数调用,而通过控制 __error() 的行为,就可以让不同线程获得各自独立的errno存储。

__error() 与函数指针间接调用

__error() 的实现位于lib/libsys/__error.c,采用了函数指针间接调用的模式:

默认情况下,__error_selector函数指针指向 __error_unthreaded,它简单地返回全局变量 __libsys_errno的地址。这适用于单线程程序,避免了与TLS相关的开销。

此外,libsys通过 __sym_compat(errno, __libsys_errno, FBSD_1.0) 在FBSD_1.0符号版本下将 __libsys_errno导出为errno符号。这是为了兼容那些直接引用errno变量(而非通过宏)的老旧二进制程序。但在现代代码中,应始终通过 <errno.h> 提供的宏来访问errno。

libthr的线程安全介入

当程序链接了libthr(FreeBSD的POSIX线程库)时,线程库需要将errno的实现替换为线程安全的版本。这一过程通过两个互补的机制实现。

机制一:构造函数与 __set_error_selector

libthr中的 _thread_init_hack函数标记了 __attribute__((constructor)),因此会在库加载时由动态链接器自动调用。它的调用链如下:

  1. _thread_init_hack()(constructor)调用 _libpthread_init()
  2. _libpthread_init() 调用 __thr_interpose_libc()
  3. __thr_interpose_libc() 调用 __set_error_selector(__error_threaded)

这样就将 __error_selector函数指针从 __error_unthreaded替换为了__error_threaded。

机制二:弱符号引用

libthr的thr_error.c中还声明了:

__weak_reference(__error_threaded, __error);

如此,在链接libthr时,会提供一个 __error_threaded到 __error的弱符号别名,这提供了符号层面的一个兼容路径。

__error_threaded的实现

线程安全版本的errno访问函数位于lib/libthr/sys/thr_error.c:

这个函数的逻辑是:

  • 如果线程子系统已经初始化(_thr_initial != NULL),并且当前线程不是初始线程(主线程),则返回当前线程的pthread结构体中的error字段的地址。这是每个线程独立的存储。
  • 否则,回退到全局的 __libsys_errno。

初始线程使用全局 __libsys_errno而非TLS存储,这是因为主线程的errno需要在线程库完成初始化之前就可用,而且它也需要与那些不使用线程库的代码(如在 _libpthread_init之前执行的初始化代码)共享同一个errno存储位置。

更广泛的介入机制

值得一提的是,__thr_interpose_libc() 不仅替换了errno的实现,还将一系列可能阻塞的系统调用(如read、write、accept、connect、select、poll、close、fork、sigaction等)替换为libthr提供的线程化版本。这些线程化版本会在调用实际系统调用前后处理取消点(cancellation point)等线程相关的语义,确保整个C运行环境在多线程下正确工作。