udevadm settle 怎么用设备文件作为提前结束条件

如果启动脚本只关心某个设备节点是否已经准备好，就不必把“整个 udev 事件队列清空”当成唯一前置条件。udevadm settle 的 --exit-if-exists=FILE 会在指定文件出现时提前结束等待；再配合有限的 --timeout，脚本就能从全局等待迁移到目标设备等待。

官方资料：https://man7.org/linux/man-pages/man8/udevadm.8.html

最实用的写法是：给 --exit-if-exists 传入后续步骤真正要访问的设备节点或稳定链接，同时保留超时和退出状态处理。设备文件出现只说明等待条件满足，不等于你的业务初始化已经全部成功。

先分清全局等待和目标文件条件

直接执行 udevadm settle 时，它观察的是 udev 事件队列，目标是等待当前事件处理完。这个语义适合“后续操作依赖全局设备状态”的场景，但启动脚本通常只依赖一个设备文件，例如某个块设备、串口设备或自定义稳定链接。此时等待不相关事件，会把启动时间绑定到更大的范围。

--exit-if-exists=FILE 增加了一个提前结束条件：目标文件存在时停止等待。它不会替你创建设备文件，也不会修改 udev 规则，更不会保证设备已经可以完成所有业务操作。它只是把等待的“成功信号”从队列状态扩展为一个可观察的文件条件。

升级范围：从无边界等待迁移到有目标的等待

可以把旧脚本理解为“只等待队列”，新脚本则是“等待队列或目标文件先满足”。迁移时最关键的变化不是把参数机械加上，而是先确定 FILE 的含义。

旧代码风险：把文件存在误当成完整可用

常见旧写法是无限等待，或者把命令失败直接吞掉：

# 旧写法：只等全局队列，和目标设备没有直接关系
udevadm settle

# 风险写法：忽略返回码，后续步骤可能在设备未准备好时继续
udevadm settle --timeout=30 || true

前一种写法可能等得过久，后一种写法则失去了超时信号。更稳妥的迁移方式是保存返回码，再决定是继续、重试还是退出。与此同时，FILE 应该选择后续命令实际打开的路径，避免用一个过于宽泛、与目标设备无关的标记文件。

新写法：设备节点出现后继续初始化

下面的脚本把设备节点作为提前结束条件，并将等待时间限制为 30 秒。示例只负责等待，不包含 udev 规则匹配或设备业务配置。

#!/usr/bin/env bash
set -u

# 这个路径应当与后续初始化真正访问的设备入口一致。
device_file="/dev/example-device"

# 限制等待时间：设备文件出现或 30 秒超时，二者先发生者结束等待。
udevadm settle --timeout=30 --exit-if-exists="$device_file"
settle_status=$?

if [ "$settle_status" -eq 0 ]; then
  # 0 表示等待条件在超时前满足，继续做后续初始化。
  printf 'device marker is ready: %s\\n' "$device_file"
  exec /usr/local/bin/next-init "$device_file"
else
  # 非 0 表示没有在限定时间内得到成功结果，保留上下文便于排障。
  printf 'device marker was not ready within timeout: %s\\n' "$device_file" >&2
  exit "$settle_status"
fi

这里的 exec 只是让后续程序接管当前脚本进程；如果你的启动框架需要脚本继续执行，也可以改为普通命令调用。重要的是不要把非 0 返回码静默成成功。

回归检查：四个容易漏掉的边界

设备已经存在。脚本启动前目标文件可能已经出现，此时等待命令应能快速结束；不要把“本次启动刚创建”作为唯一假设。

设备重新连接。如果设备节点会被移除后重新创建，稳定链接、权限和后续打开动作要保持一致。单纯看到路径存在，并不能替代后续打开失败处理。

超时分支。用有限 --timeout 把异常显式暴露出来，日志中至少记录目标路径和等待结果；不要用 || true 把问题隐藏。

全局依赖仍然存在。如果后续步骤会读取多个设备或依赖其它 udev 事件，提前结束可能过早。此时继续使用全局 settle，或者在目标文件条件之后补充明确的业务检查。

迁移清单

1. 列出后续命令真正需要的设备入口，优先使用稳定且范围明确的 FILE。
2. 把无界的 udevadm settle 改为带 --timeout 的等待。
3. 增加 --exit-if-exists=FILE，并保存命令返回码。
4. 把返回码 0 与超时、设备不可用等非 0 情况分开处理。
5. 在已有设备、设备重连和全局依赖场景下各做一次启动回归。

常见问题

--exit-if-exists 会创建设备文件吗？

不会。它只观察指定文件是否存在，并把存在作为停止等待的条件。

文件出现后，udev 队列一定为空吗？

不一定。这个选项的价值正是允许目标文件条件先满足；其它无关事件仍可能处于处理中。

为什么还要设置 --timeout？

设备文件可能因硬件、驱动或权限问题迟迟不出现。有限超时能让启动流程进入可处理的失败分支，而不是无限卡住。