augtool（1）-Linux手册页

augtool（1）-Linux手册页

名称

augtool-检查和修改配置文件

概要

augtool [ 选项 ] [ 命令 ]

描述

Augeas是配置编辑工具。它以其本机格式解析配置文件，并将其转换为树。通过操作此树并将其保存回本机配置文件中，可以进行配置更改。

augtool为生成的树提供命令行界面。COMMAND可以是单个命令，如“ 命令 ”中所述。在不使用COMMAND的情况下调用时，它将从标准输入读取命令，直到遇到文件结尾。

选件

-c，-- typecheck

类型检查镜头。这可能非常慢，因此默认情况下不做，但是在开发过程中强烈建议这样做。

-b，- 备份

更改文件后，将原始文件保存在扩展名为“ .augsave”的文件中

-n，-新

用扩展名“ .augnew”保存更改，请勿修改原始文件

-r，-- root = 根

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

-I，-- include = DIR

将DIR添加到模块加载路径。可以多次给予。在AUGEAS_LENS_LIB环境变量中指定的任何目录之前和默认目录/ usr / share / augeas / lenses之前，都将搜索此处 设置的目录。

-f，-- file = 文件

从FILE读取命令。

-i，-- interactive

从终端读取命令。与-f或stdin重定向一起使用时，在执行文件中的命令后，请进入交互式会话。

-e

通过stdin从文件读取命令时，在打印命令输出之前先回显命令。

-s，- 自动保存

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

-S，-- nostdinc

不要在任何默认目录中搜索模块。设置此选项后，将仅搜索用-I明确指定或在AUGEAS_LENS_LIB中指定的 目录。

-L，- 空载

启动时不要加载任何文件。通常通过修改“ / augeas / load”中的条目，然后发出“ load”命令来微调要加载的文件。

-A，-- noautoload

在启动时，请勿加载任何镜头模块，因此不要加载文件。这不会在“ / augeas / load”下创建任何条目。要读取任何文件，需要手动设置它们，并且必须使用“ load”命令启动加载。使用此选项可提供最快的启动速度。

- 版

打印版本信息并退出。该版本也位于树中“ / augeas / version”下。

指令

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

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

放弃

退出程序

ls < 路径 >

列出PATH的直接子代

匹配 < 模式 > [< 值 >]

查找与PATTERN匹配的所有路径。如果指定了VALUE，则仅打印 其值等于VALUE的匹配路径

rm < 路径 >

从树中删除PATH及其所有子级

mv < SRC > < DST >

将节点SRC移至DST。SRC必须与树中的一个节点完全匹配。DST必须与树中的一个节点完全匹配，或者可能不存在。如果DST已经存在，则将其及其所有后代删除。如果DST尚不存在，则会创建它及其所有缺少的祖先。

设置 < 路径 > < 值 >

将VALUE与PATH关联。如果PATH不在树中，则将创建它及其所有祖先。

清除 < 路径 >

将PATH的值设置为NULL。如果PATH不在树中，则将创建它及其所有祖先。

获取 < PATH >

打印与PATH相关的值

打印 [< PATH >]

在树中打印条目。如果给出PATH，则从那里开始打印，否则将打印整个树

插件 < LABEL > < WHERE > < PATH >

在PATH之前或之后，将带有标签LABEL的新节点插入树中。WHERE必须在“之前”或“之后”。

救

将所有未完成的更改保存到磁盘。除非给出-b或-n命令行选项，否则文件将被更改。

加载

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

defvar < 名称 > < EXPR >

将变量NAME定义为评估EXPR的结果。该变量可以在路径表达式中用作$ NAME。请注意，在定义变量时（而不是在使用变量时）将评估EXPR。

defnode < 名称 > < EXPR > [< 值 >]

为评估EXPR的结果定义变量NAME，该值必须是节点集。如果 尚不存在匹配EXPR的节点，则将创建一个节点，NAME将对其进行引用。如果给定VALUE，则与“ set EXPR VALUE ”相同；如果 未提供VALUE，则创建该节点的方式就像使用'clear EXPR '一样，并且NAME引用该节点。

救命

打印此帮助文本

环境变量

AUGEAS_ROOT

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

AUGEAS_LENS_LIB

用冒号分隔的带有目录的目录列表。在使用-I命令行选项设置的任何目录之后，但在默认目录/ usr / share / augeas / lenses之前，将搜索此处指定的目录。

诊断程序

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

例子

＃命令行模式

augtool打印/ files / etc / hosts /

 

＃互动模式

奥古斯特

augtool>帮助

augtool>打印/ files / etc / hosts /

 

＃从第二行AcceptEnv打印第三行

augtool打印'/ files / etc / ssh / sshd_config / AcceptEnv [2] / 3'

 

＃使用操作'initdefault'在inittab中找到条目

augtool>匹配/ files / etc / inittab / * / action initdefault

 

＃打印/ etc / hosts中每个条目的最后一个别名

augtool>打印/ files / etc / hosts / * / alias [last（）]

档案

/ usr / share / augeas / lenses中的镜头和架构定义

作者

大卫·卢特科特（David Lutterkort）< dlutter@redhat.com >

版权和许可

版权所有2007、2008 Red Hat Inc.

Augeas（和augtool）是根据GNU较宽松通用公共许可证（LGPL）发行的