Documentation/translations/zh_CN/filesystems/gfs2-uevents.rst

Source file repositories/reference/linux-study-clean/Documentation/translations/zh_CN/filesystems/gfs2-uevents.rst

File Facts

System
Linux kernel
Corpus path
Documentation/translations/zh_CN/filesystems/gfs2-uevents.rst
Extension
.rst
Size
3539 bytes
Lines
98
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: GPL-2.0

.. include:: ../disclaimer-zh_CN.rst

:Original: Documentation/filesystems/gfs2-uevents.rst

:翻译:

   邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>

:校译:

   杨涛 yang tao <yang.tao172@zte.com.cn>

===============
uevents 与 GFS2
===============

在 GFS2 文件系统的挂载生命周期内，会生成多个 uevent。
本文档解释了这些事件的含义及其用途（被 gfs2-utils 中的 gfs_controld 使用）。

GFS2 uevents 列表
=================

1. ADD
------

ADD 事件发生在挂载时。它始终是新建文件系统生成的第一个 uevent。如果挂载成
功，随后会生成 ONLINE uevent。如果挂载失败，则随后会生成 REMOVE uevent。

ADD uevent 包含两个环境变量：SPECTATOR=[0|1] 和 RDONLY=[0|1]，分别用
于指定文件系统的观察者状态（一种未分配日志的只读挂载）和只读状态（已分配日志）。

2. ONLINE
---------

ONLINE uevent 在成功挂载或重新挂载后生成。它具有与 ADD uevent 相同的环
境变量。ONLINE uevent 及其用于标识观察者和 RDONLY 状态的两个环境变量是较
新版本内核引入的功能（2.6.32-rc+ 及以上），旧版本内核不会生成此事件。

3. CHANGE
---------

CHANGE uevent 在两种场景下使用。一是报告第一个节点成功挂载文件系统时
（FIRSTMOUNT=Done）。这作为信号告知 gfs_controld，此时集群中其他节点可以
安全挂载该文件系统。

另一个 CHANGE uevent 用于通知文件系统某个日志的日志恢复已完成。它包含两个
环境变量：JID= 指定刚恢复的日志 ID，RECOVERY=[Done|Failed] 表示操作成
功与否。这些 uevent 会在每次日志恢复时生成，无论是在初始挂载过程中，还是
gfs_controld 通过 /sys/fs/gfs2/<fsname>/lock_module/recovery 文件
请求特定日志恢复的结果。

由于早期版本的 gfs_controld 使用 CHANGE uevent 时未检查环境变量以确定状
态，若为其添加新功能，存在用户工具版本过旧导致集群故障的风险。因此，在新增用
于标识成功挂载或重新挂载的 uevent 时，选择了使用 ONLINE uevent。

4. OFFLINE
----------

OFFLINE uevent 仅在文件系统发生错误时生成，是 "withdraw" 机制的一部分。
当前该事件未提供具体错误信息，此问题有待修复。

5. REMOVE
---------

REMOVE uevent 在挂载失败结束或卸载文件系统时生成。所有 REMOVE uevent
之前都至少存在同一文件系统的 ADD uevent。与其他 uevent 不同，它由内核的
kobject 子系统自动生成。

Annotation

Implementation Notes