1 定义

nginx-1.24.0 的 main 函数
定义在
./nginx-1.24.0/src/core/nginx.c

2 作用

nginx 1.24.0 的主函数 main，
位于 src/core/nginx.c 文件中。

它是整个 nginx 服务器的入口点，
负责初始化各种子系统、解析命令行参数、读取配置文件、
启动工作进程或单进程模式，最终进入主循环。

3 详解

1 函数签名

int ngx_cdecl
main(int argc, char *const *argv)

1 返回值

返回值类型 `int`

`main` 函数返回一个整数给操作系统，表示程序的退出状态。
- 约定：
  - 返回 `0` 通常表示程序正常结束。
  - 返回非 `0`（如 `1`）表示程序因错误而终止。
  
在 Nginx 中的使用：
`main` 函数的最后是 `return 0;`，表示成功；
之前的多个 `return 1;` 分别对应不同的初始化失败场景（如日志初始化失败、配置解析失败等），
使得操作系统或父进程可以感知到异常退出。

2 ngx_cdecl

调用约定 ngx_cdecl

什么是调用约定？
调用约定规定了：

函数参数的传递顺序（从左到右还是从右到左）

由调用者还是被调用者负责清理堆栈

在 C 语言中，默认的调用约定通常是由编译器决定的（例如 GCC 默认使用 cdecl），
但在跨平台或混合编程（如与汇编、Windows 系统调用）时，可能需要显式指定。

• ngx_cdecl

3 函数名

函数名 main
C 语言标准规定的程序入口函数名。
操作系统在加载可执行文件后，会跳转到这个函数开始执行。

在 Nginx 中：
这是整个 Nginx 服务器的起点，
完成初始化、配置加载、信号处理，
最后进入主循环（单进程或 master‑worker 模式），
直到服务停止。

4 参数

 第一个参数 int argc

- 类型：整数。
- 含义：命令行参数的个数（argument count）。它表示 argv 数组中有效元素的数目。
  至少为 1，因为 argv[0] 通常是程序名本身。

第二个参数 char *const *argv

argv 本身是一个二级指针，指向一个由 char *const 元素组成的数组。

每个数组元素 argv[i] 的类型是 char *const，
即指针本身是常量，不能修改，但它指向的字符串内容可以修改
（虽然通常不会去修改命令行参数字符串）。

const 的位置和效果：
  - const 修饰的是 *argv，也就是 argv[0] 这个指针本身。
  - 这意味着在函数内部，不能修改 argv[0] 的值，
  - 即不能让它重新指向另一个字符串；
  - 但可以通过 argv[0][0] 等修改第一个参数字符串中的字符。
  - 这个限定同样适用于 argv[1]、argv[2] 等所有命令行参数指针。
  
- 设计意义：
  - 明确表达了函数的意图：
  - 本函数不会修改传入的 argv 数组中存储的那些指针，
  - 不会让它们指向别的地址。
  - 这给调用者（C 运行时启动代码）提供了更强的保障，也增加了代码的可读性和安全性。
  - 同时并没有禁止修改参数字符串的内容（虽然 Nginx 代码中也不会故意去修改它们），

char *const *argv

argv 是一个数组（在参数中退化为指针），
数组的每个元素是一个 char *（字符串）。
中间的 const 修饰的是数组里的指针本身。
约束力：这意味着在 main 函数内部，你不能修改 argv 数组中的指针指向。

所以 const 放在中间的含义是约束数组中的每一个元素，不能修改数组中的元素的值，
const 锁住的是 argv 数组中存储的“地址”,而不是锁住了“字符串内容”

2 逻辑流程

• 1 初始化

• 2 信号发送模式

• 3 非信号发送模式 初始化

• 4 进入工作状态