augtool - 云端在线

程序：

您的姓名

augtool - 检查和修改配置文件

概要

augtool [选项] [命令]

商品描述

Augeas 是一个配置编辑工具。 它解析本机中的配置文件
格式化并将它们转换为树。 配置更改是通过操作
此树并将其保存回本机配置文件。

augtool 为生成的树提供命令行界面。 COMMAND 可以是单个
命令如“命令”中所述。 当没有 COMMAND 调用时，它从
标准输入，直到遇到文件结束。

配置

-c, --类型检查
类型检查镜头。 这可能非常慢，因此默认情况下不会完成，而是
在开发过程中强烈推荐。

-b, --备份
更改文件时，将原始文件保存在扩展名为“.augsave”的文件中

-n, - 新的
保存扩展名为“.augnew”的文件中的更改，不要修改原始文件

-r, - 根=根
使用目录 ROOT 作为文件系统的根目录。 优先于根集
使用 AUGEAS_ROOT 环境变量。

-I, - 包括=DIR
将 DIR 添加到模块加载路径。 可以多次给予。 这里设置的目录
在 AUGEAS_LENS_LIB 环境中指定的任何目录之前搜索
变量，在默认目录之前 /usr/share/augeas/镜头 和
/usr/share/augeas/镜头/距离.

-t, - 转变=XFM
添加文件转换； 使用 'transform' 命令语法，例如“-t 'Fstab incl
/etc/fstab.bak'”。

-f, - 文件=文件
从 FILE 读取命令。

-i, - 交互的
从终端读取命令。 当与 -f 或重定向标准输入，删除
执行文件中的命令后进入交互式会话。

-e, - 回声
通过标准输入从文件中读取命令时，在打印命令之前回显命令
输出。

-s, - 自动保存
在会话结束时自动保存所有更改。

-S, --nostdinc
不要在任何默认目录中搜索模块。 设置此选项后，
只有明确指定的目录 -I 或在 AUGEAS_LENS_LIB 会
搜索模块。

-L, - 空载
不要在启动时加载任何文件。 这通常用于微调哪些文件
通过修改“/augeas/load”中的条目然后发出“load”命令来加载。

-A, --不自动加载
启动时不要加载任何镜头模块，因此也不要加载文件。 这不会造成
“/auges/load”下的条目； 要读取任何文件，它们需要被设置
手动加载，必须使用“加载”命令启动。 使用这个选项给出
最快的启动。

- 跨度
加载树中节点的跨度位置，因为它们与原始文件相关。
允许使用 跨度 命令来检索位置数据。

- 版
打印版本信息并退出。 版本也在树下
“/augas/版本”。

指令

在交互模式下，可以通过按“TAB”来完成命令和路径。

命令作为参数接受的路径使用一小部分 XPath 路径表达式。
路径表达式由许多段组成，以“/”分隔。 在每个细分市场中，
字符“*”可用于匹配每个节点，而不管其标签如何。 同级节点
可以通过将“[N]”附加到标签以匹配第 N 个标签来区分相同的标签
有这样标签的兄弟姐妹。 可以通过以下方式到达具有特定标签的最后一个兄弟
“[最后的（）]”。 有关这方面的一些示例，请参阅“示例”。

ADMIN 指令
以下命令控制 Augeas 和 augtool 本身的行为。

帮助
打印此帮助文本

加载
根据“/augas/load”中的转换加载文件。

退出
退出程序

取回
使用镜头 LENS 将 PATH 中的树转换回文本并存储结果字符串
在 NODE_OUT。 假设树最初是用相同的镜头读入的，并且
字符串存储在 NODE_IN 作为输入。

保存
将所有挂起的更改保存到磁盘。 除非 -b or -n 命令行选项是
给定，文件就地更改。

商店
使用 LENS 解析节点并将结果树存储在 PATH 中。

改造
使用 LENS 为 FILE 添加转换。 LENS 可以是模块名称或全镜头
姓名。 如果给出了模块名称，则“lns”将是假定的镜头。 过滤器
必须是“包括”或“不包括”。 如果过滤器是“incl”，文件将被解析
镜头。 如果过滤器是“excl”，则 FILE 将从 LENS 中排除。 文件可能
包含通配符。

读 指令
以下命令用于从 Augeas 树中检索数据。

转储-xml [ ]
将树中的条目打印为 XML。 如果给出 PATH，则从那里开始打印，否则
整棵树都被打印出来了。

得到
打印与 PATH 关联的值

标签
获取并打印与 PATH 关联的标签

ls
列出 PATH 的直接子代

匹配 [ ]
查找与 PATTERN 匹配的所有路径。 如果给出了 VALUE，则只有匹配的路径
打印值等于 VALUE

打印 [ ]
打印树中的条目。 如果给出了 PATH，则从那里开始打印，否则打印
打印整棵树

跨度
打印生成节点 PATH 的文件的名称，以及
有关文件中与标签、值和值相对应的位置的信息
整个节点。 PATH 必须与一个节点完全匹配。

您需要在加载文件之前运行“set /augeas/span enable”以启用录制
跨度信息。 默认情况下它是禁用的。

您是我们的客人？ 指令
以下命令用于修改 Augeas 树。

清除
将 PATH 的值设置为 NULL。 如果 PATH 还没有在树中，它和它的所有
祖先将被创造。

清除
在一次操作中清除多个节点值。 通过以下方式查找或创建与 SUB 匹配的节点
将 SUB 解释为相对于匹配 BASE 的每个节点的路径表达式。 如果 SUB 是
'.'，匹配BASE的节点将被修改。

插件
在 PATH 之前或之后将带有标签 LABEL 的新节点插入到树中。 在哪里
必须是“之前”或“之后”。

插
别名 插件.

mv
将节点 SRC 移至 DST。 SRC 必须与树中的一个节点完全匹配。 夏令时必须要么
完全匹配树中的一个节点，或者可能还不存在。 如果 DST 已经存在，它
并删除其所有后代。 如果 DST 尚不存在，则它及其所有缺失
祖先被创造出来。

移动
别名 mv.

cp
将节点 SRC 复制到 DST。 SRC 必须与树中的一个节点完全匹配。 夏令时必须要么
完全匹配树中的一个节点，或者可能还不存在。 如果 DST 已经存在，它
并删除其所有后代。 如果 DST 尚不存在，则它及其所有缺失
祖先被创造出来。

复制
别名 cp.

重命名
将所有匹配 SRC 的节点的标签重命名为 LBL。

rm
从树中删除 PATH 及其所有子项

集
将 VALUE 与 PATH 关联。 如果 PATH 还没有在树中，它和它的所有祖先
将被创建。

设置 [ ]
一次操作设置多个节点。 通过以下方式查找或创建与 SUB 匹配的节点
将 SUB 解释为相对于匹配 BASE 的每个节点的路径表达式。 如果 SUB 是
'.'，匹配BASE的节点将被修改。

触摸
如果它还不在树中，则创建值为 NULL 的 PATH。 它的所有祖先都会
也被创建。 这些新的树条目将出现在它们的同级中的最后。

PATH 表达 指令
以下命令有助于处理路径表达式。

定义节点 [ ]
将变量NAME 定义为评估EXPR 的结果，它必须是一个节点集。 如果
尚不存在匹配 EXPR 的节点，创建一个节点，NAME 将引用它。 如果值
给出，这与'set EXPR VALUE'相同； 如果未给出 VALUE，则节点为
创建就像使用“clear EXPR”一样，NAME 指的是那个节点。

定义变量
将变量 N​​AME 定义为评估 EXPR 的结果。 该变量可用于
路径表达式为 $NAME。 请注意，在定义变量时评估 EXPR，
不是在使用的时候。

环境 变数

AUGEAS_ROOT
文件系统根目录，默认为“/”。 可以用 -r 命令行
选项

AUGEAS_LENS_LIB
带有镜头的以冒号分隔的目录列表。 这里指定的目录是
在使用设置的任何目录之后搜索 -I 命令行选项，但在
默认目录 /usr/share/augeas/镜头 和 /usr/share/augeas/镜头/距离

诊断

通常，退出状态为 0。如果一个或多个命令失败，退出状态将设置为非
零值。

请注意，无法加载由转换指定的某些文件
“/augeas/load”不被视为失败。 如果重要的是要知道所有文件都是
加载后，您需要在加载后发出“match /augeas//error”以了解有关详细信息
无法加载哪些文件以及原因。

示例

# 命令行模式
augtool 打印 /files/etc/hosts/

#交互模式
工具
辅助工具> 帮助
augtool> 打印 /files/etc/hosts/

# 从第二个 AcceptEnv 行打印第三个条目
augtool 打印 '/files/etc/ssh/sshd_config/AcceptEnv[2]/3'

# 在 inittab 中使用 action 'initdefault' 查找条目
augtool> 匹配 /files/etc/inittab/*/action initdefault

# 打印每个条目的最后一个别名 / etc / hosts文件
augtool> 打印 /files/etc/hosts/*/alias[last()]

使用 onworks.net 服务在线使用 augtool