GNU strerror_r 缓冲区含义

Question

char *strerror_r(int errnum, char *buf, size_t buflen);

这些buf/buflen参数是干什么用的？

空缓冲区就像一个魅力：

char* buf = nullptr;
fprintf(stderr, strerror_r(errno, buf, 0));

这个缓冲区看起来也没有使用：

char buf[1024];
fprintf(stderr, "%s\n", strerror_r(errno, buf, sizeof buf)); // Correct message here
fprintf(stderr, "%s\n", buf); // Empty

Answer 1

引用man page，强调我的

GNU 特定的strerror_r() 返回一个指向包含错误消息的字符串的指针。 这可能是指向函数存储在buf 中的字符串的指针，也可能是指向某些（不可变）静态字符串的指针（在这种情况下buf 未使用）。

所以很有可能buf 未被使用，如果buf 未被使用，buflen 无关紧要。

[....] 如果函数在buf中存储一个字符串，那么最多存储buflen字节（如果buflen太小，字符串可能会被截断并且errnum 未知）。 [...]

Answer 2

正如您在 cmets 中注意到的，buf 和 buflen 参数仅在您传递无效 errnum、负数或未知 errno 时使用 值。 the source code of the function 确认了这一点。

char *
__strerror_r (int errnum, char *buf, size_t buflen)
{
  if (__builtin_expect (errnum < 0 || errnum >= _sys_nerr_internal
                        || _sys_errlist_internal[errnum] == NULL, 0))
    {
      /* To fill up buf with "Unknown error" localized string and to append
         digits of errnum. Nothing happens if buflen equals zero. */

      ...

      return buf;
    }

  return (char *) _(_sys_errlist_internal[errnum]);
}

关于缓冲区的容量，我认为 1024 字节就足够了。此外，它与 strerror 实现使用的大小完全相同（即线程不安全）。另见the related answer and the comment to it。

当然，这一切都与函数的 GNU 版本有关。 XSI 兼容版本始终使用此缓冲区来复制静态字符串。