main()執行流程

main()程式碼解析

/* src/core/nginx.c */

int ngx_cdecl // #define ngx_cdecl，一個空的define，跨平臺支援
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(); // 在Linux系統中，#define ngx_debug_init()，一個空的define
 


    /* 建立一個包含NGX_SYS_NERR個ngx_str_t的陣列ngx_sys_errlist，用於記錄錯誤碼[0,NGX_SYS_NERR-1]對應的錯誤資訊
       NGX_SYS_NERR定義在objs/ngx_auto_config.h中，這是一個auto性質的檔案，只有在執行了./configure後才能生成這個檔案
       在Linux系統中NGX_SYS_NERR=132，表示有132個錯誤碼 */
    if (ngx_strerror_init() != NGX_OK) {
        return 1;
    }

    // 解析命令列引數，對於-s，ngx_process = NGX_PROCESS_SIGNALLER;
 

    if (ngx_get_options(argc, argv) != NGX_OK) {
        return 1;
    }

    if (ngx_show_version) {
        ngx_show_version_info();

        if (!ngx_test_config) {
            return 0;
        }
    }

    /* TODO */ ngx_max_sockets = -1; // extern ngx_int_t ngx_max_sockets;

    ngx_time_init(); // 初始化時間
 


#if (NGX_PCRE)
    ngx_regex_init(); // 若啟用了PCRE(Perl Compatible Regular Expressions)，則初始化正則表示式
#endif

    ngx_pid = ngx_getpid(); // #define ngx_getpid getpid

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

    /* STUB */
#if (NGX_OPENSSL)
    ngx_ssl_init(log); // 若啟用了NGX_OPENSSL，則初始化ssl
#endif

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

    ngx_memzero(&init_cycle, sizeof(ngx_cycle_t)); // 清零init_cycle
    init_cycle.log = log;
    ngx_cycle = &init_cycle; // volatile ngx_cycle_t *ngx_cycle;

    init_cycle.pool = ngx_create_pool(1024, log); // 建立大小為1024B的記憶體池
    if (init_cycle.pool == NULL) {
        return 1;
    }

    // 將命令列引數儲存到全域性變數ngx_argv中
    if (ngx_save_argv(&init_cycle, argc, argv) != NGX_OK) {
        return 1;
    }

    // 初始化init_cycle的conf_prefix、prefix、conf_file、conf_param等
    if (ngx_process_options(&init_cycle) != NGX_OK) {
        return 1;
    }

    // 初始化系統變數ngx_pagesize、ngx_cacheline_size、ngx_max_sockets等
    if (ngx_os_init(log) != NGX_OK) {
        return 1;
    }

    /*
     * ngx_crc32_table_init() requires ngx_cacheline_size set in ngx_os_init()
     */

    // 初始化CRC(Cyclic Redundancy Check)表，快取對齊
    if (ngx_crc32_table_init() != NGX_OK) {
        return 1;
    }

    // 將環境變數NGINX中的socket儲存到init_cycle的listening陣列中
    if (ngx_add_inherited_sockets(&init_cycle) != NGX_OK) {
        return 1;
    }

    // 遍歷全域性陣列ngx_modules，根據各模組在ngx_modules中的順序，設定各模組的index
    if (ngx_preinit_modules() != NGX_OK) {
        return 1;
    }

    // 初始化init_cycle，詳見資料結構ngx_cycle_t
    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);
        }

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

    // 若有訊號，則處理訊號
    if (ngx_signal) {
        return ngx_signal_process(cycle, ngx_signal);
    }

    ngx_os_status(cycle->log);

    ngx_cycle = cycle;

    // ccf指向儲存ngx_core_module配置項的資料結構
    ccf = (ngx_core_conf_t *) ngx_get_conf(cycle->conf_ctx, ngx_core_module);

    /* 在ngx_core_module_create_conf()中，ccf->master初始化為-1；
       在ngx_core_module_init_conf()中，若ccf->master == -1，則ccf->master = 1，否則ccf->master不變；
       ngx_process是一個未初始化的全域性變數，預設值是0（即NGX_PROCESS_SINGLE） */
    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;
    }

    // 若無繼承socket，且設定了守護程序標識，則呼叫ngx_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

    // 建立pid檔案
    if (ngx_create_pidfile(&ccf->pid, cycle->log) != NGX_OK) {
        return 1;
    }

    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) {
        // 單程序工作模式：系統中只有一個程序，該程序既是master程序，也是worker程序
        ngx_single_process_cycle(cycle);

    } else {
        // 多程序工作模式：系統中有一個master程序，多個worker程序
        ngx_master_process_cycle(cycle);
    }

    return 0;
}