Nginx源码完全注释（8）ngx_errno.c

pond2539

Nginx源码完全注释（8）ngx_errno.c

• 作者：柳大·Poechant（钟超）
  
• 邮箱：zhongchao.ustc#gmail.com（# -> @）
  
• 博客：Blog.CSDN.net/Poechant
  
• 日期：2012/09/29
  

errno.h中的strerror(int errno)可以确定指定的errno的错误的提示信息。在 Nginx 中，将所有错误提示信息预先存储在一个数组里，而预先确定这个数组的大小，是在自动化脚本中完成的，如下是auto/unix脚本：（其中自动化脚本auto/feature的作用参考《解剖 Nginx·自动脚本篇（4）工具型脚本系列》一文）


// auto/unix
ngx_feature="sys_nerr"
ngx_feature_name="NGX_SYS_NERR"
ngx_feature_run=value
ngx_feature_incs='#include <errno h="">
#include <stdio h="">'</stdio></errno><errno h="">
ngx_feature_path=
ngx_feature_libs=
ngx_feature_test=<span class="string" style="color: rgb(136, 0, 0); ">'printf("%d", sys_nerr);'</span>
. auto/feature
</errno>
但是对于某些平台是没有sys_nerr的，此时引用auto/feature后得到的ngx_found变量的值为no，否则为yes。当为no时，则执行下面这段：


// auto/unix
if [ $ngx_found = no ]; then
ngx_feature="_sys_nerr"
ngx_feature_name="NGX_SYS_NERR"
ngx_feature_run=value
ngx_feature_incs='#include <errno h="">
#include <stdio h="">'</stdio></errno><errno h="">
ngx_feature_path=
ngx_feature_libs=
ngx_feature_test=<span class="string" style="color: rgb(136, 0, 0); ">'printf("%d", _sys_nerr);'</span>
. auto/feature
<span class="keyword" style="font-weight: bold; ">fi</span>
</errno>
上面这段会在 Cygwin 环境下起作用，因为 Cygwin 定义了_sys_nerr。如果此后ngx_found还是no，则运行：


if [ $ngx_found = no ]; then
ngx_feature='maximum errno'
ngx_feature_name=NGX_SYS_NERR
ngx_feature_run=value
ngx_feature_incs='#include <errno h="">
#include <string h="">
#include <stdio h="">'</stdio></string></errno><errno h="">
ngx_feature_path=
ngx_feature_libs=
ngx_feature_test=<span class="string" style="color: rgb(136, 0, 0); ">'int  n;
char *p;
for (n = 1; n &lt; 1000; n++) {
errno = 0;
p = strerror(n);
if (errno == EINVAL
|| p == NULL
|| strncmp(p, "Unknown error", 13) == 0)
{
break;
}
}
printf("%d", n);'</span>
. auto/feature
<span class="keyword" style="font-weight: bold; ">fi</span>
</errno>
上面这段会在 Solaris 上生效，因为 Solaris 没有sys_nerr和_sys_nerr。
这样就会在objs/ngx_auto_config.h文件中加入如下一句；


// Mac OS X 10.8
#ifndef NGX_SYS_NERR
#define NGX_SYS_NERR  107
#endif


// Linux ubuntu 3.2.0-30-generic-pae
#ifndef NGX_SYS_NERR
#define NGX_SYS_NERR  135
#endif

Igor 把所有 strerror 消息都拷贝到一个数组里，他是这样解释原因的：

• 1) strerror() and strerror_r() functions are not Async-Signal-Safe, therefore, they cannot be used in signal handlers;
  
• 
  2) a direct sys_errlist[] array may be used instead of these functions, but Linux linker warns about its usage:
  
    warning: `sys_errlist' is deprecated; use `strerror' or `strerror_r' instead
  warning: `sys_nerr' is deprecated; use `strerror' or `strerror_r' instead
  causing false bug reports.
  

如下是src/os/unix/ngx_errno.c：


static ngx_str_t  *ngx_sys_errlist;
static ngx_str_t   ngx_unknown_error = ngx_string("Unknown error");
// 替代 strerror，传入 err 错误码、已分配内存的 errstr 指针以及其内存大小
// 调用该函数后，errstr 和返回值均为给定错误码相应的错误消息
u_char *
ngx_strerror(ngx_err_t err, u_char *errstr, size_t size)
{
ngx_str_t  *msg;
msg = ((ngx_uint_t) err < NGX_SYS_NERR) ? &ngx_sys_errlist[err]:
&ngx_unknown_error;
size = ngx_min(size, msg->len);
return ngx_cpymem(errstr, msg->data, size);
}

ngx_int_t
ngx_strerror_init(void)
{
char       *msg;
u_char     *p;
size_t      len;
ngx_err_t   err;
/*
* ngx_strerror() is not ready to work at this stage, therefore,
* malloc() is used and possible errors are logged using strerror().
*/
// 所有 strerror 消息的数量所需要的 ngx_str_t 的内存字节数
//（注意不是消息本身，因为小内容是存在 ngx_str_t 的 data 里的）
len = NGX_SYS_NERR * sizeof(ngx_str_t);
// 分配内存，注意此时是直接使用 malloc 的
// TODO
ngx_sys_errlist = malloc(len);
if (ngx_sys_errlist == NULL) {
goto failed;
}
// 初始化错误消息的每一项
for (err = 0; err < NGX_SYS_NERR; err++) {
// 获取该消息
msg = strerror(err);
// 该条消息的大小
len = ngx_strlen(msg);
// 分配 len 大小的内存
p = malloc(len);
if (p == NULL) {
goto failed;
}
ngx_memcpy(p, msg, len);
ngx_sys_errlist[err].len = len;
ngx_sys_errlist[err].data = p;
}
return NGX_OK;
failed:
err = errno;
ngx_log_stderr(0, "malloc(%uz) failed (%d: %s)", len, err, strerror(err));
return NGX_ERROR;
}

-
转载请注明来自柳大·Poechant（钟超）的CSDN博客：http://blog.CSDN.net/Poechant
-