Ubuntu下nginx-1.24.0源码分析-ngx_open_file

ngx_open_file

---

定义在src/os/unix/ngx_files.h

#define ngx_open_file(name, mode, create, access) \ open((const char *) name, mode|create, access)

---

#define NGX_FILE_RDONLY O_RDONLY #define NGX_FILE_WRONLY O_WRONLY #define NGX_FILE_RDWR O_RDWR #define NGX_FILE_CREATE_OR_OPEN O_CREAT #define NGX_FILE_OPEN 0 #define NGX_FILE_TRUNCATE (O_CREAT|O_TRUNC) #define NGX_FILE_APPEND (O_WRONLY|O_APPEND) #define NGX_FILE_NONBLOCK O_NONBLOCK

---

1. #define NGX_FILE_RDONLY O_RDONLY 作用：定义只读模式标志。映射：直接对应 Unix/Linux 的 O_RDONLY（值为 0）。用途： 用于以只读方式打开文件（如配置文件、静态资源文件）。

---

2. #define NGX_FILE_WRONLY O_WRONLY 作用：定义写入模式标志。映射：对应 O_WRONLY（值为 1）。用途： 用于以只写方式打开文件（如日志文件、临时文件）。注意： 若文件不存在，需配合 NGX_FILE_CREATE_OR_OPEN 使用。

---

3. #define NGX_FILE_RDWR O_RDWR 作用：定义读写模式标志。映射：对应 O_RDWR（值为 2）。用途： 需要同时读写文件时使用

---

4. #define NGX_FILE_CREATE_OR_OPEN O_CREAT 作用：定义文件创建标志。映射：对应 O_CREAT（值为 0x40）。用途： 若文件不存在，则创建新文件；若存在，直接打开。权限： 需配合 access 参数指定权限（如 0644）。

---

5. #define NGX_FILE_OPEN 0 作用：定义“仅打开”标志（不创建文件）。映射：值为 0，表示不添加任何额外标志。用途： 确保仅打开已存在的文件，避免意外创建新文件（如配置文件）。场景： 在解析主配置文件时使用，防止因路径错误创建无效文件。

---

6. #define NGX_FILE_TRUNCATE (O_CREAT|O_TRUNC) 作用：定义截断模式标志。映射：组合 O_CREAT（创建）和 O_TRUNC（截断）。用途： 若文件存在，将其长度截断为 0（清空内容）。若文件不存在，创建新文件。

---

7. #define NGX_FILE_APPEND (O_WRONLY|O_APPEND) 作用：定义追加模式标志。映射：组合 O_WRONLY（写入）和 O_APPEND（追加）。用途： 每次写入操作均追加到文件末尾，避免覆盖已有内容。

---

8. #define NGX_FILE_NONBLOCK O_NONBLOCK 作用：定义非阻塞模式标志。映射：对应 O_NONBLOCK（值为 0x800）。用途： 使文件操作立即返回，避免阻塞（如异步 I/O 或设备文件操作）。注意： 在 Nginx 中主要用于处理非阻塞套接字，而非普通文件。