废话不多说,直接上代码和注释,有问题或者有不足的地方可以大家一起讨论。
-
int ngx_cdecl
-
main(int argc, char *const *argv)
-
{
-
ngx_int_t i;
-
ngx_log_t *log;
-
ngx_cycle_t *cycle, init_cycle;
-
ngx_core_conf_t *ccf;
-
/* 在linux为空函数 ,
-
* src/os/unix/ngx_linux_config.h
-
* #define ngx_debug_init()
-
**/
-
ngx_debug_init();
-
/*将linux系统标准的errno信息strerror字符串存储成一个数组链,数组总的大小由宏NGX_SYS_NERR控制*/
-
if (ngx_strerror_init() != NGX_OK) {
-
return 1;
-
}
-
/*对选项参数的解析,此处并没有像一般的linux程序一样调用getopt/getopt_long,
-
* 而是通过对选项的字符识别来解析参数,可以解决不同平台兼容问题,如使用windows and linux*/
-
if (ngx_get_options(argc, argv) != NGX_OK) {
-
return 1;
-
}
-
/*根据入参选项,来判断是否输出nginx版本,nginx帮助信息,nginx配置信息等等*/
-
if (ngx_show_version) {
-
ngx_write_stderr("nginx version: " NGINX_VER_BUILD NGX_LINEFEED);/*nginx_write_stderr将信心输出到标准错误文件句柄,直接显示在终端*/
-
-
if (ngx_show_help) {
-
ngx_write_stderr(
-
"Usage: nginx [-?hvVtq] [-s signal] [-c filename] "
-
"[-p prefix] [-g directives]" NGX_LINEFEED
-
NGX_LINEFEED
-
"Options:" NGX_LINEFEED
-
" -?,-h : this help" NGX_LINEFEED
-
" -v : show version and exit" NGX_LINEFEED
-
" -V : show version and configure options then exit"
-
NGX_LINEFEED
-
" -t : test configuration and exit" NGX_LINEFEED
-
" -q : suppress non-error messages "
-
"during configuration testing" NGX_LINEFEED
-
" -s signal : send signal to a master process: "
-
"stop, quit, reopen, reload" NGX_LINEFEED
-
#ifdef NGX_PREFIX
-
" -p prefix : set prefix path (default: "
-
NGX_PREFIX ")" NGX_LINEFEED
-
#else
-
" -p prefix : set prefix path (default: NONE)" NGX_LINEFEED
-
#endif
-
" -c filename : set configuration file (default: "
-
NGX_CONF_PATH ")" NGX_LINEFEED
-
" -g directives : set global directives out of configuration "
-
"file" NGX_LINEFEED NGX_LINEFEED
-
);
-
}
-
-
if (ngx_show_configure) {
-
-
#ifdef NGX_COMPILER
-
ngx_write_stderr("built by " NGX_COMPILER NGX_LINEFEED);
-
#endif
-
-
#if (NGX_SSL)
-
if (SSLeay() == SSLEAY_VERSION_NUMBER) {
-
ngx_write_stderr("built with " OPENSSL_VERSION_TEXT
-
NGX_LINEFEED);
-
} else {
-
ngx_write_stderr("built with " OPENSSL_VERSION_TEXT
-
" (running with ");
-
ngx_write_stderr((char *) (uintptr_t)
-
SSLeay_version(SSLEAY_VERSION));
-
ngx_write_stderr(")" NGX_LINEFEED);
-
}
-
#ifdef SSL_CTRL_SET_TLSEXT_HOSTNAME
-
ngx_write_stderr("TLS SNI support enabled" NGX_LINEFEED);
-
#else
-
ngx_write_stderr("TLS SNI support disabled" NGX_LINEFEED);
-
#endif
-
#endif
-
-
ngx_write_stderr("configure arguments:" NGX_CONFIGURE NGX_LINEFEED);
-
}
-
-
if (!ngx_test_config) {
-
return 0;
-
}
-
}
-
-
/* TODO */ ngx_max_sockets = -1;
-
-
ngx_time_init();/*时间初始化*/
-
/*如果有PCRE库,则进行正则表达式初始化*/
-
#if (NGX_PCRE)
-
ngx_regex_init();
-
#endif
-
-
ngx_pid = ngx_getpid();/*获取当前进程id,放入全局变量ngx_pid中*/
-
/*将ngx_log.c里面的静态变量ngx_log的地址返回给局部log变量*/
-
log = ngx_log_init(ngx_prefix);/*初始化日志文件*/
-
if (log == NULL) {
-
return 1;
-
}
-
-
/* STUB */
-
#if (NGX_OPENSSL)
-
ngx_ssl_init(log);
-
#endif
-
-
/*
-
* init_cycle->log is required for signal handlers and
-
* ngx_process_options()
-
*/
-
/*初始化ngx_cycle_t结构变量init_cycle*/
-
ngx_memzero(&init_cycle, sizeof(ngx_cycle_t));
-
init_cycle.log = log;/*将log指针赋值给init_cycle结构中的log*/
-
ngx_cycle = &init_cycle;/*ngx_cycle指针指向init_cycle的地址*/
-
/*创建内存地址池::::TODO,后面详细学习分析*/
-
init_cycle.pool = ngx_create_pool(1024, log);
-
if (init_cycle.pool == NULL) {
-
return 1;
-
}
-
/*将命令参数和环境变量保存到ngx_os_argv,ngx_argc,ngx_argv和ngx_os_environ中,
-
* 这个是一个备份存储,方便后面的初始化工作能够随时获取命令行参数*/
-
if (ngx_save_argv(&init_cycle, argc, argv) != NGX_OK) {
-
return 1;
-
}
-
/*nginx前缀,配置文件前缀和配置文件路径等写入init_cycle结构*/
-
if (ngx_process_options(&init_cycle) != NGX_OK) {
-
return 1;
-
}
-
/*完成操作系统的一些信息获取,比如内存页面大小、系统限制资源等信息;
-
* 所有这些资源都保存到对应的全局变量中,以便后续访问*/
-
if (ngx_os_init(log) != NGX_OK) {
-
return 1;
-
}
-
-
/*
-
* ngx_crc32_table_init() requires ngx_cacheline_size set in ngx_os_init()
-
*/
-
/*初始化CRC表,以便后续CRC校验通过查表进行,效率高*/
-
if (ngx_crc32_table_init() != NGX_OK) {
-
return 1;
-
}
-
/*解析环境变量NGINX_VAR="NGINX"中的sockets,并保存至ngx_cycle.listening数组中*/
-
if (ngx_add_inherited_sockets(&init_cycle) != NGX_OK) {
-
return 1;
-
}
-
/*统计模块总数,并且记录模块索引*/
-
ngx_max_module = 0;
-
for (i = 0; ngx_modules[i]; i++) {
-
ngx_modules[i]->index = ngx_max_module++;
-
}
-
/*cycle是周期的意思,对应着一次启动过程,每次启动,nginx都会创建一个新的cycle与这次启动对应
-
* 初始化cycle,入参init_cycle为老的cycle,主要存储了log和配置文件相关的信息,还有main函数入参信息
-
* ngx_init_cycle函数的主要作用:
-
* 1. 解析nginx配置文件
-
* 2. 初始化core模块
-
* 3. 初始化文件句柄
-
* 4. 初始化共享内存
-
* 5. 监听端口*/
-
cycle = ngx_init_cycle(&init_cycle);
-
if (cycle == NULL) {
-
if (ngx_test_config) {
-
ngx_log_stderr(0, "configuration file %s test failed",
-
init_cycle.conf_file.data);
-
}
-
-
return 1;
-
}
-
-
if (ngx_test_config) {
-
if (!ngx_quiet_mode) {
-
ngx_log_stderr(0, "configuration file %s test is successful",
-
cycle->conf_file.data);
-
}
-
-
return 0;
-
}
-
/*nginx -s 信号选项,处理相应的信号选项,根据信号类型,调用kill向自身发送信号*/
-
if (ngx_signal) {
-
return ngx_signal_process(cycle, ngx_signal);
-
}
-
-
ngx_os_status(cycle->log);
-
-
ngx_cycle = cycle;
-
-
ccf = (ngx_core_conf_t *) ngx_get_conf(cycle->conf_ctx, ngx_core_module);
-
ngx_log_error(NGX_LOG_DEBUG,log,0,"master=%z",ccf->master);
-
/*ccf->master值在core模块conf init函数中已经初始化为1*/
-
if (ccf->master && ngx_process == NGX_PROCESS_SINGLE) {
-
ngx_process = NGX_PROCESS_MASTER;
-
}
-
-
#if !(NGX_WIN32)
-
/*初始化信号,注册信号处理函数
-
* 需要注册的信号及相应的信号处理函数被放在一个类型为ngx_signal_t的数组signals中。
-
* 数组定义在src/os/unix/ngx_process.c中。ngx_signal_t结构类型定义了信号值,信号名字,信号对应动作名以及信号处理函数。
-
* */
-
if (ngx_init_signals(cycle->log) != NGX_OK) {
-
return 1;
-
}
-
/*设置为daemon进程*/
-
if (!ngx_inherited && ccf->daemon) {
-
if (ngx_daemon(cycle->log) != NGX_OK) {
-
return 1;
-
}
-
-
ngx_daemonized = 1;
-
}
-
-
if (ngx_inherited) {
-
ngx_daemonized = 1;
-
}
-
-
#endif
-
/* 把进程id记入到文件中
-
* 如果配置文件nginx.conf里面没有配置 pid logs/nginx.pid;
-
* 则在core模块初始化配置ngx_core_module_init_conf时设置ccf->pid为默认路径
-
* "/usr/local/nginx/nginx.pid"*/
-
if (ngx_create_pidfile(&ccf->pid, cycle->log) != NGX_OK) {
-
return 1;
-
}
-
/*调用dup2将标准错误复制为log 文件句柄,
-
* 即后续往标准错误里面写入的东西,都会体现在log文件句柄中
-
* fd = ngx_log_get_file_log(cycle->log)->file->fd*/
-
if (ngx_log_redirect_stderr(cycle) != NGX_OK) {
-
return 1;
-
}
-
-
if (log->file->fd != ngx_stderr) {
-
if (ngx_close_file(log->file->fd) == NGX_FILE_ERROR) {
-
ngx_log_error(NGX_LOG_ALERT, cycle->log, ngx_errno,
-
ngx_close_file_n " built-in log failed");
-
}
-
}
-
-
ngx_use_stderr = 0;
-
ngx_log_stderr(0,"ngx_process = %d",ngx_process);
-
/*Nginx分为Single和Master两种进程模型,Single模型即为单进程方式工作,具有较差的容错能力,不适合生产之用。
-
* Master模型即为一个master进程+N个worker进程的工作方式。*/
-
if (ngx_process == NGX_PROCESS_SINGLE) {
-
ngx_single_process_cycle(cycle);
-
-
} else {
-
ngx_master_process_cycle(cycle);
-
}
-
-
return 0;
-
}
阅读(1188) | 评论(0) | 转发(0) |