nginx源码分析-main函数

《音视频应用开发系列文章目录》

nginx的main函数位于nginx源码目录下的src/core/nginx.c文件中

int ngx_cdecl
main(int argc, char *const *argv)
{
    ngx_buf_t        *b;
    ngx_log_t        *log;
    ngx_uint_t        i;
    ngx_cycle_t      *cycle, init_cycle;
    ngx_conf_dump_t  *cd;
    ngx_core_conf_t  *ccf;

    // 根据不同系统平台设置调试环境
    ngx_debug_init();

    // win:直接返回NGX_OK
    // unix:通过strerror将错误码转为错误内容存于ngx_str_t *ngx_sys_errlist表中
    if (ngx_strerror_init() != NGX_OK) {
        return 1;
    }
	
    // 解析用户传参，赋值给对应的全局变量
    if (ngx_get_options(argc, argv) != NGX_OK) {
        return 1;
    }

	// 如果用户传参里有-?, -h, -v, -V, ngx_show_version将会置1
    if (ngx_show_version) {
        // nginx显示版本信息
        ngx_show_version_info();

        // 如果没有指定-t, -T就会直接退出
        if (!ngx_test_config) {
            return 0;
        }
    }

    /* TODO */ ngx_max_sockets = -1;

    // nginx初始化时间并更新
    ngx_time_init();

#if (NGX_PCRE)
    // 如果使能了PCRE, 则初始化PCRE的正则表达式
    ngx_regex_init();
#endif

    // 获取进程ID和父进程ID
    ngx_pid = ngx_getpid();
    ngx_parent = ngx_getppid();

    // 初始化日志
    log = ngx_log_init(ngx_prefix);
    if (log == NULL) {
        return 1;
    }

    /* STUB */
#if (NGX_OPENSSL)
    // 如果使能了OPENSSL, 则初始化OPENSSL
    ngx_ssl_init(log);
#endif

    /*
     * init_cycle->log is required for signal handlers and
     * ngx_process_options()
     */

    ngx_memzero(&init_cycle, sizeof(ngx_cycle_t));
    init_cycle.log = log;
    ngx_cycle = &init_cycle;
    // 创建内存池
    init_cycle.pool = ngx_create_pool(1024, log);
    if (init_cycle.pool == NULL) {
        return 1;
    }

    // 保存argv参数到ngx_argv
    if (ngx_save_argv(&init_cycle, argc, argv) != NGX_OK) {
        return 1;
    }
	
    // 处理用户传参并填充对应信息到init_cycle
    if (ngx_process_options(&init_cycle) != NGX_OK) {
        return 1;
    }

    // 主要是初始化CPU和系统的信息
    if (ngx_os_init(log) != NGX_OK) {
        return 1;
    }

    /*
     * ngx_crc32_table_init() requires ngx_cacheline_size set in ngx_os_init()
     */
	
    if (ngx_crc32_table_init() != NGX_OK) {
        return 1;
    }

    /*
     * ngx_slab_sizes_init() requires ngx_pagesize set in ngx_os_init()
     */

    ngx_slab_sizes_init();

    // 添加继承套接字描述符到init_cycle
    if (ngx_add_inherited_sockets(&init_cycle) != NGX_OK) {
        return 1;
    }

    // 初始化模块, 主要填充ngx_modules的index和对应的模块名字
    if (ngx_preinit_modules() != NGX_OK) {
        return 1;
    }

    // 根据旧的circle生成新的circle
    // 解析配置文件, 模块初始化
    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;
    }

    // nginx test 
    if (ngx_test_config) {
        if (!ngx_quiet_mode) {
            ngx_log_stderr(0, "configuration file %s test is successful",
                           cycle->conf_file.data);
        }

        if (ngx_dump_config) {
            cd = cycle->config_dump.elts;

            for (i = 0; i < cycle->config_dump.nelts; i++) {

                ngx_write_stdout("# configuration file ");
                (void) ngx_write_fd(ngx_stdout, cd[i].name.data,
                                    cd[i].name.len);
                ngx_write_stdout(":" NGX_LINEFEED);

                b = cd[i].buffer;

                (void) ngx_write_fd(ngx_stdout, b->pos, b->last - b->pos);
                ngx_write_stdout(NGX_LINEFEED);
            }
        }

        return 0;
    }

    // 如果有指定-s信号, 则处理该信号
    if (ngx_signal) {
        return ngx_signal_process(cycle, ngx_signal);
    }

    // 获取操作系统的信息
    ngx_os_status(cycle->log);

    ngx_cycle = cycle;

    // 获取ngx_core_module模块的配置
    ccf = (ngx_core_conf_t *) ngx_get_conf(cycle->conf_ctx, ngx_core_module);

    if (ccf->master && ngx_process == NGX_PROCESS_SINGLE) {
        ngx_process = NGX_PROCESS_MASTER;
    }

#if !(NGX_WIN32)
    // 非Windows初始化信号
    if (ngx_init_signals(cycle->log) != NGX_OK) {
        return 1;
    }
    // nginx守护
    if (!ngx_inherited && ccf->daemon) {
        if (ngx_daemon(cycle->log) != NGX_OK) {
            return 1;
        }

        ngx_daemonized = 1;
    }

    if (ngx_inherited) {
        ngx_daemonized = 1;
    }

#endif
    // 创建pid文件, 默认就是logs/nginx.pid文件，里面存放nginx的pid
    if (ngx_create_pidfile(&ccf->pid, cycle->log) != NGX_OK) {
        return 1;
    }

    // 重定向stderr
    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;

    if (ngx_process == NGX_PROCESS_SINGLE) {
		
        // nginx单进程模式
        ngx_single_process_cycle(cycle);

    } else {
		
        // nginx多进程模式
        // 启动工作子进程进入事件循环, 主进程进入信号监听处理模式
        ngx_master_process_cycle(cycle);
    }

    return 0;
}