NGINX单进程服务器主处理流程

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;


    ngx_debug_init();


    if (ngx_strerror_init() != NGX_OK) {
        return 1;
    }


    // 处理选项
    if (ngx_get_options(argc, argv) != NGX_OK) {
        return 1;
    }


    if (ngx_show_version) {
        ngx_write_stderr("nginx version: " NGINX_VER NGX_LINEFEED);


        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) {
            ngx_write_stderr(
#ifdef NGX_COMPILER
                "built by " NGX_COMPILER NGX_LINEFEED
#endif
#if (NGX_SSL)
#ifdef SSL_CTRL_SET_TLSEXT_HOSTNAME
                "TLS SNI support enabled" NGX_LINEFEED
#else
                "TLS SNI support disabled" NGX_LINEFEED
#endif
#endif
                "configure arguments:" NGX_CONFIGURE NGX_LINEFEED);
        }


        if (!ngx_test_config) {
            return 0;
        }
    }


    /* TODO */ ngx_max_sockets = -1;


    // 获取当前时间
    ngx_time_init();


#if (NGX_PCRE)
    ngx_regex_init();
#endif


    // 获取本进程进程ID
    ngx_pid = ngx_getpid();


    // 初始化日志系统
    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()
     */
    // 初始化init_cycle 为空
    ngx_memzero(&init_cycle, sizeof(ngx_cycle_t));


    // 初始化init_cycle日志变量
    init_cycle.log = log;


    // 初始化全集变量ngx_cycle
    ngx_cycle = &init_cycle;


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


    // 保存进程参数
    if (ngx_save_argv(&init_cycle, argc, argv) != NGX_OK) {
        return 1;
    }


    // 处理进程参数
    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()
     */


    if (ngx_crc32_table_init() != NGX_OK) {
        return 1;
    }


    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++;
    }


    // 初始化init cycle 变量，这是个牛逼的结构
    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;
    }


    if (ngx_signal) {
        return ngx_signal_process(cycle, ngx_signal);
    }


    ngx_os_status(cycle->log);


    ngx_cycle = cycle;


    // 获取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)


    if (ngx_init_signals(cycle->log) != NGX_OK) {
        return 1;
    }


    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 文件
    if (ngx_create_pidfile(&ccf->pid, cycle->log) != NGX_OK) {
        return 1;
    }


    // 检查log 文件句柄
    if (cycle->log->file->fd != ngx_stderr) {


        if (ngx_set_stderr(cycle->log->file->fd) == NGX_FILE_ERROR) {
            ngx_log_error(NGX_LOG_EMERG, cycle->log, ngx_errno,
                          ngx_set_stderr_n " failed");
            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) {
        ngx_single_process_cycle(cycle);


    } else {
        ngx_master_process_cycle(cycle);
    }


    return 0;
}










void
ngx_single_process_cycle(ngx_cycle_t *cycle)
{
    ngx_uint_t  i;
    // 设置环境
    if (ngx_set_environment(cycle, NULL) == NULL) {
        /* fatal */
        exit(2);
    }


    // 初始化所有模块配置
    for (i = 0; ngx_modules[i]; i++) {
        if (ngx_modules[i]->init_process) {
            // ngx_event_process_init
            if (ngx_modules[i]->init_process(cycle) == NGX_ERROR) {
                /* fatal */
                exit(2);
            }
        }
    }
    // 主线程处理事件死循环
    for ( ;; ) {
        ngx_log_debug0(NGX_LOG_DEBUG_EVENT, cycle->log, 0, "worker cycle");


        // 处理事件和定时器事件
        ngx_process_events_and_timers(cycle); // 所有事件是在这里进行处理的


        if (ngx_terminate || ngx_quit) {


            for (i = 0; ngx_modules[i]; i++) {
                if (ngx_modules[i]->exit_process) {
                    ngx_modules[i]->exit_process(cycle);
                }
            }


            ngx_master_process_exit(cycle);
        }


        if (ngx_reconfigure) {
            ngx_reconfigure = 0;
            ngx_log_error(NGX_LOG_NOTICE, cycle->log, 0, "reconfiguring");


            cycle = ngx_init_cycle(cycle);
            if (cycle == NULL) {
                cycle = (ngx_cycle_t *) ngx_cycle;
                continue;
            }


            ngx_cycle = cycle;
        }


        if (ngx_reopen) {
            ngx_reopen = 0;
            ngx_log_error(NGX_LOG_NOTICE, cycle->log, 0, "reopening logs");
            ngx_reopen_files(cycle, (ngx_uid_t) -1);
        }
    }
}