Nginx原始碼完全註釋(8)ngx_errno.c
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 < 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
-
相關文章
- Nginx原始碼完全註釋(6)core/murmurhashNginx原始碼
- Nginx原始碼完全註釋(9)nginx.c: ngx_get_optionsNginx原始碼
- Nginx原始碼完全註釋(5)core/ngx_cpuinfo.cNginx原始碼UI
- 原始碼完全註釋:socket select原始碼
- Nginx原始碼完全註釋(1)ngx_alloc.h / ngx_alloc.cNginx原始碼
- Nginx原始碼完全註釋(7)ngx_palloc.h/ngx_palloc.cNginx原始碼
- Nginx原始碼完全註釋(4)ngx_queue.h / ngx_queue.cNginx原始碼
- Nginx原始碼完全註釋(3)ngx_list.h / ngx_list.cNginx原始碼
- Nginx原始碼完全註釋(2)ngx_array.h / ngx_array.cNginx原始碼
- Nginx 原始碼完全剖析(11)ngx_spinlockNginx原始碼
- Nginx 原始碼完全剖析(10)ngx_radix_treeNginx原始碼
- 《Linux核心完全註釋》學習筆記:2.7 Linux核心原始碼的目錄結構Linux筆記原始碼
- HashMap原始碼(JDK1.8)-手動註釋HashMap原始碼JDK
- Bootstrap的Model原始碼詳細註釋 (轉)boot原始碼
- 8個最沒有意義的程式碼註釋
- Nginx篇--Nginx原始碼搭建Nginx原始碼
- Redux原始碼完全解讀Redux原始碼
- Python的編碼註釋# -*- coding:utf-8 -*-Python
- Spring 原始碼(8)Spring BeanPostProcessor的註冊、國際化及事件釋出機制Spring原始碼Bean事件
- bootstrap-modal.js學習筆記(原始碼註釋)bootJS筆記原始碼
- Dubbo原始碼解析之服務釋出與註冊原始碼
- 從Python原始碼註釋,自動生成API文件Python原始碼API
- 使用ehcache元註釋提高Spring 效能原始碼案例Spring原始碼
- C231n-KNN-assignment1-完全程式碼及註釋KNN
- C231n-SVM-assignment1-完全程式碼及註釋
- nginx原始碼安裝Nginx原始碼
- NGINX原始碼閱讀Nginx原始碼
- Nginx 原始碼安裝Nginx原始碼
- 原始碼安裝Nginx原始碼Nginx
- Nginx的nginx.conf配置檔案中文註釋說明Nginx
- CSS程式碼註釋CSS
- php程式碼註釋PHP
- maven下載原始碼,解決中文註釋為亂碼的問題Maven原始碼
- DialogFragment使用到原始碼完全解析Fragment原始碼
- docker原始碼安裝NginxDocker原始碼Nginx
- macbook 原始碼安裝 nginxMac原始碼Nginx
- Centos原始碼安裝NginxCentOS原始碼Nginx
- ArcGIS VBA - VBA+AO入門15例完全註釋版