util-linux:

util-linux

util-linux 是一个包含各类 Linux 实用工具的集合

注：2006-2010 年间该项目曾命名为 "util-linux-ng"。

编译与安装：

详见 Documentation/howto-compilation.txt。

邮件列表：

邮箱：util-linux@vger.kernel.org
网址：http://vger.kernel.org/vger-lists.html#util-linux
存档：https://lore.kernel.org/util-linux/

邮件列表会拒收以下内容：

• 超过 100K 字符的邮件
• 包含 HTML 的邮件
• 含有垃圾邮件关键词的邮件
  详见：http://vger.kernel.org/majordomo-info.html#taboo

IRC 频道：

#util-linux 位于 libera.chat：
irc://irc.libera.chat/util-linux

该 IRC 频道和邮件列表面向开发者和项目维护者。终端用户建议使用发行版的支持系统。

问题报告：

邮箱：util-linux@vger.kernel.org
网页：https://github.com/util-linux/util-linux/issues

涉及敏感或隐私信息的问题报告请发送至：Karel Zak kzak@redhat.com

本项目无资源处理发行版特定问题。终端用户建议使用发行版的支持系统。

NLS（PO 翻译）：

PO 文件由以下平台维护：
https://translationproject.org/domain/util-linux.html

版本规范：

标准发布：
<主版本>.<次版本>[.<维护版本>]
主版本 = 重大变更
次版本 = 含新功能的常规发布
维护版本 = 仅含错误修复的维护性发布

开发版发布：
<主版本>.<次版本>-rc

源代码：

下载归档：
https://www.kernel.org/pub/linux/utils/util-linux/

另见：
Documentation/howto-contribute.txt
Documentation/howto-build-sys.txt
Documentation/howto-pull-request.txt

SCM（源代码管理）仓库：

主仓库：
git clone git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git

备用仓库：
git clone https://github.com/util-linux/util-linux.git

网页界面：
https://git.kernel.org/cgit/utils/util-linux/util-linux.git
https://github.com/util-linux/util-linux

注：GitHub 仓库可能包含临时开发分支。

kernel.org 仓库仅包含 master（当前开发）和 stable/（维护）分支。所有 master 或 stable/ 变更会同时推送到两个仓库。

仓库分支：'git branch -a'
master 分支

• 当前开发分支
• 稳定版发布的来源（当准备就绪时）
• 日常状态为："在我这里能运行"。这意味着其正常状态可用但未经充分测试。
• 长期开发或重大变更会从 master 分支的尖端分出单独的 "topic" 分支。

stable/ 分支

• 公开发布版本
• 分支命名：stable/v<主版本>.<次版本>
• 在发布两个或更多候选版本及最终公开版本后，从 master 分支创建。这意味着稳定版提交、标记并可在 master 中追溯。
• 这些分支随后成为分叉的开发分支。意味着对其的任何变更将与 master 分支分离。
• 维护版本属于其对应的 stable 分支，以标签（<主版本>.<次版本>.<维护版本>）形式存在，而非独立分支。它们与 master 开发分支无关。在 git 术语中：维护版本无法从 master 追溯。
• 初始克隆时（如上述 git clone 命令），这些分支作为 "远程跟踪分支" 创建，仅通过 git branch -a 或 -r 选项可见。要创建本地分支，请使用命令：'git checkout -b v2.29.2 v2.29.2'

标签：'git tag'

• 每个发布版本都会创建新标签对象。
• 标签命名：v<版本号>。
• 所有标签均经维护者 PGP 密钥签名。

已知问题：

• 请勿使用标签 v2.13.1（误创建并发布），改用 v2.13.1-REAL。

工作流示例：

1. 开发阶段（分支：）

2. master 发布（标签：v2.29-rc1, v2.29-rc2, v2.29，分支：）

3. 开发阶段（开发 v2.30，分支：）

4. 分叉——基于标签 v2.29 创建新分支 <stable/v2.29>

4a) 新增补丁或从 挑选补丁（分支：<stable/v2.29>）

4b) 稳定版发布（标签：v2.29.1，分支：<stable/v2.29>）

4c) 更多补丁；再次发布（标签：v2.29.2，分支：<stable/v2.29>）

5. master 发布 v2.30（分支：）
   ...

其中步骤 3) 和 4) 可同步进行。