SerenityOS nohup 命令详解让进程无视 SIGHUP 挂断信号并安全脱离终端【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenitynohup是 SerenityOS 用户态核心工具之一其职责是以“忽略 SIGHUP 挂断信号”的方式启动一个指定程序utility使该程序在终端会话关闭、控制终端挂断时依然能够继续运行。本文以系统手册页 Base/usr/share/man/man1/nohup.md 为骨架结合其完整实现 Userland/Utilities/nohup.cpp逐层讲解 nohup 的调用语法、输出重定向规则、stderr 处理逻辑、退出码语义与底层源码实现帮助你准确掌握这一经典守护式启动工具在 SerenityOS 中的完整行为契约。nohup 的作用忽略 SIGHUP 信号在 POSIX 风格的系统中当终端会话关闭例如用户登出、断开 SSH、关闭终端窗口时系统会向该会话的前台进程组发送 SIGHUPhangup挂断信号其默认行为是终止进程。nohup的使命就是在调用目标程序之前先将 SIGHUP 的处理方式设置为忽略SIG_IGN从而保证被启动的程序不会因终端挂断而退出。手册页Name一节对此的定义是nohup- Invoke a utility that will ignore SIGHUPs在 SerenityOS 的源码实现中这一步对应 nohup.cpp 中的显式信号设置调用TRY(Core::System::signal(SIGHUP, SIG_IGN));Core::System::signal是 LibCore 对系统信号接口的封装这里将 SIGHUP 的处置策略设置为SIG_IGN忽略随后才真正执行目标程序。也就是说nohup自身只负责“设置信号忽略 调整标准输出/标准错误 执行目标程序”这三件事目标程序本身并不会感知到自己是被nohup启动的。调用语法与参数解析手册页Synopsis一节给出的调用格式为$ nohup utility [args...]utility要被调用的程序名称args传递给该程序的可选参数列表可以为空。参数解析在源码中通过 LibCore 的ArgsParser完成nohup.cppCore::ArgsParser args_parser; args_parser.set_stop_on_first_non_option(true); args_parser.set_general_help(Invoke a utility that will ignore SIGHUPs); args_parser.add_positional_argument(utility, Utility to be invoked, utility); args_parser.add_positional_argument(args, Arguments to pass to utility, args, Core::ArgsParser::Required::No); args_parser.parse(arguments);两个值得注意的细节set_stop_on_first_non_option(true)解析器在遇到第一个非选项参数即utility后立即停止解析选项其后的所有参数包括以-开头的字符串都会原样作为args传递给目标程序。这样nohup curl -v https://example.com中的-v不会被 nohup 吞掉而是完整传给curl。该接口定义在 LibCore/ArgsParser.h。args是可选位置参数Required::No即nohup utility不带任何额外参数是完全合法的。解析完成后源码先将utility插入参数列表头部args.try_prepend(utility)再通过Core::System::exec执行auto exec_or_error Core::System::exec(utility, args.span(), Core::System::SearchInPath::Yes);其中SearchInPath::Yes表示会在PATH环境变量所声明的目录中查找目标程序对应 LibCore/System.h 中exec的声明这与 shell 直接输入命令名时的查找行为一致。标准输出重定向nohup.out 的完整规则nohup最经典的行为是把目标程序的标准输出stdout追加写入当前目录下的nohup.out文件。手册页Description一节对此有精确描述SerenityOS 的实现逐条落实了这些规则仅当标准输出是 tty 时才重定向如果 stdout 已经是文件、管道或 /dev/null 等非终端设备则不做任何重定向目标程序的 stdout 原样保留。首选当前目录的nohup.out以O_CREAT | O_WRONLY | O_APPEND方式打开当前目录下的nohup.out采用追加模式多次运行会连续累加写入。失败则回退到$HOME/nohup.out若当前目录下无法创建或打开nohup.out则改为追加写入$HOME/nohup.out。两者都失败则拒绝启动如果$HOME/nohup.out也无法打开nohup将直接退出且不会调用目标程序。新建文件的权限位固定为S_IRUSR | S_IWUSR即所有者可读可写0600不继承 umask 之外的任何额外权限。源码级验证上述规则在 nohup.cpp 的dup_out_file辅助函数中得到完整实现void dup_out_file(int fd_to_redirect) { int fd -1; ByteString path nohup.out; auto options O_CREAT | O_WRONLY | O_APPEND; auto mode S_IRUSR | S_IWUSR; auto fd_or_error Core::System::open(path, options, mode); if (fd_or_error.is_error()) { auto* home_env getenv(HOME); if (!home_env) { warnln(nohup: unable to open for appending as $HOME is not set); exit(127); } path LexicalPath::join(LexicalPath::canonicalized_path(home_env), path).string(); fd_or_error Core::System::open(path, options, mode); if (fd_or_error.is_error()) { warnln(nohup: unable to open {} for appending: {}, path, strerror(fd_or_error.error().code())); exit(127); } } fd fd_or_error.value(); auto maybe_error Core::System::dup2(fd, fd_to_redirect); ... if (fd_to_redirect ! STDERR_FILENO) outln(stderr, appending output to {}, path); }对照手册可以确认的细节权限位mode S_IRUSR | S_IWUSR与手册中“permission bits are set to S_IRUSR | S_IWUSR when it is created”完全一致追加模式O_APPEND保证多进程或多批次运行结果不互相覆盖HOME 未设置时的处理如果环境变量$HOME不存在nohup直接打印错误并退出 127与手册“If this also fails,utilitywont be invoked”呼应路径拼接$HOME与nohup.out的拼接使用AK::LexicalPath::join与canonicalized_path确保去掉$HOME尾部多余的/得到规范化的绝对路径重定向手段通过dup2(fd, fd_to_redirect)把目标文件描述符复制到 stdoutSTDOUT_FILENO的位置上随后关闭原始 fd提示信息当重定向目标是 stdout而非 stderr时会在标准错误上打印一行appending output to 路径方便用户在终端看到实际落盘位置但这行提示本身不会写进nohup.out。标准错误处理两分支规则手册页Description的第三部分专门规定了当标准错误stderr也是 tty 时的处理方式共有两个分支若 stdout 已打开但不是 tty将 stderr 重定向到 stdout即两者合并写入同一个目标若 stdout 是 tty 或已关闭stderr 按前述规则追加写入nohup.out。源码级验证对应实现位于 nohup.cppif (stderr_is_a_tty) { auto dup_or_error Core::System::dup2(STDOUT_FILENO, STDERR_FILENO); if (dup_or_error.is_error()) { auto error dup_or_error.release_error(); if (error.code() ! EBADF) { warnln(nohup: error redirecting stderr to stdout: {}, strerror(error.code())); return 127; } // NOTE: Standard output must be closed, so ...the same output shall // instead be appended to the end of the nohup.out file... dup_out_file(STDERR_FILENO); } }这段代码非常精妙地实现了手册语义首先尝试dup2(STDOUT_FILENO, STDERR_FILENO)把 stderr 指到 stdout 上。此时 stdout 可能已被前面的步骤重定向到nohup.out因为 stdout 是 tty 的情况在前面已处理所以这条路径天然实现“stderr 合并到 stdout”的效果如果dup2失败且错误码是EBADF说明stdout 处于关闭状态即不是有效文件描述符此时落入分支 2调用dup_out_file(STDERR_FILENO)把 stderr 直接追加到nohup.out。源码注释特意引用了手册原文...the same output shall instead be appended to the end of the nohup.out file...说明这一分支正是为了满足“stdout 已关闭时 stderr 也写 nohup.out”的规范其余错误非 EBADF则视为致命错误打印信息并返回退出码 127。也就是说只要 stdout 或 stderr 有一个是 ttynohup 就会保证目标程序的输出不会丢失在终端上而是落到nohup.out或$HOME/nohup.out中只有当两者都不是 tty例如都已重定向到文件或管道时nohup 才完全不做输出接管保持原有的文件描述符布局。退出状态码语义手册页Exit Status一节定义了两种退出码退出码含义126utility被找到了但无法被调用执行127utility找不到或者 nohup 自身在处理过程中发生错误源码级验证退出码的产生逻辑在 nohup.cppauto exec_or_error Core::System::exec(utility, args.span(), Core::System::SearchInPath::Yes); if (exec_or_error.is_error()) { auto error exec_or_error.release_error(); warnln(nohup: error while calling exec: {}, strerror(error.code())); return error.code() ENOENT ? 127 : 126; }127exec返回ENOENT即目标程序在PATH中找不到或者 nohup 自身出错如$HOME未设置、nohup.out打不开、dup2失败等这些路径均直接exit(127)126目标程序存在但exec因其他原因失败如权限不足无法执行、格式无效等统一返回 126。此外源码在serenity_main开头调用Main::set_return_code_for_errors(127)nohup.cpp这意味着即使程序自身因异常或内部错误非正常返回也会映射为退出码 127与手册语义保持一致。安全模型pledge 系统调用SerenityOS 的每个用户态程序都遵循“最小权限”的 pledge 机制。nohup在启动时声明自己只需要以下权限nohup.cppTRY(Core::System::pledge(stdio wpath cpath rpath exec sigaction));各能力项的含义与 nohup 实际工作的对应关系如下pledge 能力nohup 的用途stdio标准输入/输出/错误的基本操作isatty、dup2、读写输出wpath/cpath创建与写入nohup.out、$HOME/nohup.out对应O_CREAT与O_WRONLYrpath读取目标程序的路径信息exec在PATH中查找时所需exec通过exec启动目标程序sigaction设置 SIGHUP 信号为SIG_IGN这也从侧面说明 nohup 的实现刻意保持极简除了“打开两个候选文件、改信号、执行程序”之外它不拥有任何多余的权限体现了 SerenityOS 内核级安全模型对每个工具进程的约束。完整执行流程一览综合手册语义与源码nohup的一次完整调用可按如下顺序展开解析命令行确定utility与args并声明 pledge 能力对 stdout 执行isatty检测若 stdout 是 tty → 打开当前目录nohup.out失败则$HOME/nohup.out再失败则退出 127dup2将 stdout 指向该文件并在 stderr 打印appending output to 路径对 stderr 执行isatty检测若 stderr 是 tty → 尝试dup2将 stderr 指向 stdout若该dup2因 stdout 已关闭EBADF而失败 → 将 stderr 直接追加到nohup.out将 SIGHUP 设置为SIG_IGN以PATH查找方式exec目标程序若exec失败ENOENT返回 127其余错误返回 126若成功则不再返回目标程序接管进程。典型使用场景在 SerenityOS 的 shell 中nohup的典型用法包括# 启动一个长时间运行的命令登出终端后它仍继续运行 $ nohup ping 1.1.1.1 # 显式传入参数 $ nohup tar -czf /home/anon/backup.tar.gz /home/anon/Documents # 目标程序输出与错误信息都被收入 nohup.out $ nohup make -j8 /dev/null其中第一条命令配合 shell 后台运算符是最经典的长任务守护模式nohup负责屏蔽 SIGHUPshell 的后台执行则让任务立即回到命令行提示符两者配合即可实现“关闭终端、任务照跑”的效果。第二条展示args的透传——-czf等选项不会与 nohup 自身的参数解析冲突。第三条则演示了“stdout 非 tty、stderr 是 tty”时手册分支 1 的行为stdout 被 shell 重定向到/dev/nullstderr 会被 nohup 合并到 stdout即/dev/null最终不留任何落盘文件。与系统手册的关系本文所依据的手册页位于 Base/usr/share/man/man1/nohup.md它是 SerenityOS 系统内置文档的一部分与man1目录下的其他命令手册一起随系统发布。nohup工具本体则登记在 Userland/Utilities/CMakeLists.txt 中参与构建。如果你在 SerenityOS 环境内使用man nohup看到的就是这份文档的内容——而它的每一条规则都能在 Userland/Utilities/nohup.cpp 中找到对应的、逐字落实的实现。小结nohup是一个体量极小但行为契约极其严谨的工具它通过SIG_IGN屏蔽 SIGHUP 保证进程在终端挂断后存活通过“当前目录 →$HOME”两级回退与S_IRUSR | S_IWUSR权限位保证输出总有一个安全落点通过 stdout/stderr 的两分支规则保证终端输出不丢失并以 126/127 区分“找到但无法执行”与“找不到/自身错误”。理解这套规则不仅能在 SerenityOS 中正确地使用它也能更深刻地理解 POSIX 信号与文件描述符重定向在守护进程场景下的经典配合方式。【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考