【Linux102】26-include/sys/wait.h

原创于 2025-08-21 10:55:15 发布 · 420 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#linux #kernel

Linux102系列专栏收录该内容

24 篇文章

订阅专栏

公粽号「专注Linux」，专注Linux内核开发

Linux102系列会详细讲解Linux0.11版本中的102个文件，本文讲解linux0.11的第26个文件include/sys/wait.h的文件源码。

1.include/sys/wait.h的主要作用

这个sys/wait.h头文件的核心作用是：

定义解析子进程终止状态的宏（如WIFEXITED、WEXITSTATUS等），用于判断子进程是正常退出还是被信号终止，以及获取具体的退出码或信号值。

声明wait和waitpid两个系统调用函数，用于父进程等待子进程结束并获取其状态。

这些功能是进程管理的基础，尤其在多进程编程中，父进程通过这些函数可以有效地管理子进程的生命周期。

2.源码注释版本

本节涉及的文件：


😉【Linux102】19-include/sys/types.h	定义跨平台的基础数据类型，为系统调用、库函数和应用程序提供统一的数据类型声明。

#ifndef _SYS_WAIT_H
#define _SYS_WAIT_H
// sys/types.h头文件定义了一些基本数据类型（如pid_t，用于表示进程 ID）。
#include <sys/types.h>
// 这两个宏用于提取一个整数的低 8 位和高 8 位
// （使用八进制0377表示二进制11111111）。
#define _LOW(v)		( (v) & 0377)/*低8位*/
#define _HIGH(v)	( ((v) >> 8) & 0377)/*高8位*/
/* options for waitpid, WUNTRACED not supported */
// WNOHANG：值为 1，表示如果没有子进程退出，waitpid不会阻塞，而是立即返回 0。
#define WNOHANG		1
// WUNTRACED：值为 2，表示需要关注被暂停（stopped）的子进程
#define WUNTRACED	2
/**
* func descp: 状态解析宏（核心功能）
* 这些宏用于解析wait和waitpid函数返回的子进程状态码（stat_loc参数所指向的值），判断子进程的终止原因。
*/

// 作用：判断子进程是否正常退出：
// 如果状态码s的低 8 位为 0（(s)&0xFF == 0），返回真（非 0），表示子进程通过exit或return正常退出。
#define WIFEXITED(s)	(!((s)&0xFF))
// 作用：判断子进程是否被暂停（stopped）：
// 如果状态码s的低 8 位等于0x7F，返回真，表示子进程被信号暂停。
#define WIFSTOPPED(s)	(((s)&0xFF)==0x7F)
// 作用：获取子进程正常退出时的退出状态码：
// 仅当WIFEXITED(s)为真时有效，返回s的高 8 位（右移 8 位后取低 8 位），即子进程通过exit(n)传递的退出码n。
#define WEXITSTATUS(s)	(((s)>>8)&0xFF)
// 作用：获取导致子进程终止的信号编号：
// 当子进程被信号终止时有效，返回s低 8 位中的低 7 位（&0x7F），即终止子进程的信号值。
#define WTERMSIG(s)	((s)&0x7F)
// 作用：获取导致子进程暂停的信号编号：
// 当WIFSTOPPED(s)为真时有效，返回s的高 8 位，即暂停子进程的信号值。
#define WSTOPSIG(s)	(((s)>>8)&0xFF)
// 作用：判断子进程是否被信号终止：
// 通过位运算判断状态码s是否表示子进程被信号杀死，返回真表示是信号导致的终止。
#define WIFSIGNALED(s)	(((unsigned int)(s)-1 & 0xFFFF) < 0xFF)
// 声明wait函数：
// 功能：阻塞等待任意一个子进程终止，并获取其终止状态。
// 参数：stat_loc指向一个整数，用于存储子进程的终止状态（可通过上述宏解析）。
// 返回值：成功返回终止的子进程 ID（pid_t类型），失败返回 - 1。
pid_t wait(int *stat_loc);
// 声明waitpid函数（更灵活的等待函数）：
// 功能：等待指定的子进程，可通过选项控制是否阻塞。
// 参数：
// pid：指定要等待的子进程 ID（特殊值：-1 表示任意子进程，0 表示同组子进程等）。
// stat_loc：同wait，用于存储子进程终止状态。
// options：选项参数（如WNOHANG表示非阻塞）。
// 返回值：成功返回终止的子进程 ID，无子进程退出且使用WNOHANG时返回 0，失败返回 - 1。
pid_t waitpid(pid_t pid, int *stat_loc, int options);

#endif

3.源码完整版

#ifndef _SYS_WAIT_H
#define _SYS_WAIT_H

#include <sys/types.h>

#define _LOW(v)		( (v) & 0377)
#define _HIGH(v)	( ((v) >> 8) & 0377)

/* options for waitpid, WUNTRACED not supported */
#define WNOHANG		1
#define WUNTRACED	2

#define WIFEXITED(s)	(!((s)&0xFF)
#define WIFSTOPPED(s)	(((s)&0xFF)==0x7F)
#define WEXITSTATUS(s)	(((s)>>8)&0xFF)
#define WTERMSIG(s)	((s)&0x7F)
#define WSTOPSIG(s)	(((s)>>8)&0xFF)
#define WIFSIGNALED(s)	(((unsigned int)(s)-1 & 0xFFFF) < 0xFF)

pid_t wait(int *stat_loc);
pid_t waitpid(pid_t pid, int *stat_loc, int options);

#endif