augtool - クラウド上のオンライン

プログラム：

NAME

augtool - 構成ファイルの検査と変更

SYNOPSIS

augtool [オプション] [コマンド]

DESCRIPTION

Augeas は構成編集ツールです。 構成ファイルをネイティブで解析します
フォーマットしてツリーに変換します。 設定の変更は操作によって行われます
このツリーをネイティブ構成ファイルに保存し直します。

augtool は、生成されたツリーへのコマンド ライン インターフェイスを提供します。 COMMAND は XNUMX つで構いません
「コマンド」で説明されているコマンドを実行します。 COMMAND を指定せずに呼び出すと、次からコマンドを読み取ります。
ファイルの終わりに達するまで標準入力を続けます。

OPTIONS

-c, --タイプチェック
タイプチェックレンズ。 これは非常に時間がかかる可能性があるため、デフォルトでは実行されませんが、
開発中に強くお勧めします。

-b, - バックアップ
ファイルが変更された場合、元のファイルは拡張子「.augsave」が付いたファイルに保存されます。

-n, - 新着
拡張子「.augnew」が付いたファイルに変更を保存します。元のファイルは変更しないでください

-r, - 根=ROOT
ファイルシステムのルートとしてディレクトリ ROOT を使用します。 ルートセットよりも優先されます
AUGEAS_ROOT 環境変数を使用します。

-I, - 含む=DIR
DIR をモジュールのロードパスに追加します。 複数回与えることも可能です。 ここで設定したディレクトリ
AUGEAS_LENS_LIB 環境で指定されたディレクトリより前に検索されます。
変数、およびデフォルトのディレクトリの前 /usr/share/augeas/レンズ &
/usr/share/augeas/lenses/dist.

-t, - 変身=XFM
ファイル変換を追加します。 「transform」コマンド構文を使用します。例: "-t 'Fstab incl
/etc/fstab.bak'"。

-f, - ファイル=FILE
ファイルからコマンドを読み取ります。

-i, - 相互の作用
ターミナルからコマンドを読み取ります。 と組み合わせると -f または標準入力のリダイレクト、ドロップ
ファイルからコマンドを実行した後、対話型セッションに移行します。

-e, - エコー
標準入力経由でファイルからコマンドを読み取る場合、コマンドを出力する前にコマンドをエコーし​​ます。
出力。

-s, -自動保存
セッションの終了時にすべての変更を自動的に保存します。

-S, --nostdinc
デフォルトのディレクトリでモジュールを検索しないでください。 このオプションを設定すると、
で明示的に指定されたディレクトリのみ -I またはで指定されます AUGEAS_LENS_LIB なります
モジュールを検索しました。

-L, --noload
起動時にファイルをロードしないでください。 これは通常、どのファイルを保存するかを微調整するために使用されます。
ロードするには、「/augeas/load」内のエントリを変更し、「load」コマンドを発行します。

-A, --noautoload
起動時にレンズ モジュールをロードしないでください。したがって、ファイルもロードしません。 これにより、何も作成されません
「/augeas/load」の下のエントリ。 ファイルを読み取るには、設定する必要があります
手動でロードし、ロードは「load」コマンドで開始する必要があります。 このオプションを使用すると、
最速の起動。

- スパン
元のファイルに関連するツリー内のノードのスパン位置をロードします。
の使用を有効にします。 スパン 位置データを取得するコマンドです。

- バージョン
バージョン情報を出力して終了します。 バージョンは以下のツリーにもあります
「/augeas/バージョン」。

コマンド

対話型モードでは、「TAB」を押すとコマンドとパスを完成させることができます。

コマンドによって引数として受け入れられるパスは、XPath パス式の小さなサブセットを使用します。
パス式は、「/」で区切られた複数のセグメントで構成されます。 各セグメントでは、
文字「*」を使用すると、ラベルに関係なくすべてのノードと一致します。 兄弟ノード
同一のラベルは、ラベルに「[N]」を追加して N 番目のラベルと一致させることで区別できます。
このようなラベルが付いた兄弟。 特定のラベルを持つ最後の兄弟には、次のようにしてアクセスできます。
"[最後（）]"。 この例については、「例」を参照してください。

管理人 コマンド
次のコマンドは、Augeas と augtool 自体の動作を制御します。

助けます
このヘルプテキストを印刷する

負荷
「/augeas/load」の変換に従ってファイルをロードします。

やめます
プログラムを終了します

検索する
レンズ LENS を使用して PATH のツリーをテキストに変換し、結果の文字列を保存します
NODE_OUTで。 ツリーが最初に同じレンズで読み込まれ、
NODE_IN に入力として保存された文字列。

保存
保留中の変更をすべてディスクに保存します。 いずれかの場合を除き、 -b or -n コマンドラインオプションは
指定すると、ファイルはその場で変更されます。

店舗
LENS を使用して NODE を解析し、結果のツリーを PATH に保存します。

変換
LENS を使用して FILE の変換を追加します。 LENS はモジュール名または完全なレンズの場合があります
名前。 モジュール名が指定されている場合、「lns」が想定されるレンズになります。 フィルター
「incl」または「excl」のいずれかである必要があります。 フィルタが「incl」の場合、ファイルは次のように解析されます。
レンズ。 フィルタが「excl」の場合、ファイルは LENS から除外されます。 ファイルは可能性があります
ワイルドカードが含まれています。

お客様の声は コマンド
次のコマンドは、Augeas ツリーからデータを取得するために使用されます。

ダンプ-xml [ 】
ツリー内のエントリを XML として出力します。 PATH が指定されている場合は、そこから印刷が開始されます。そうでない場合は、
木全体が印刷されます。

取得する
PATH に関連付けられた値を出力します。

ラベル
PATH に関連付けられたラベルを取得して印刷します

ls
PATH の直接の子をリストします。

match [ 】
PATTERN に一致するすべてのパスを検索します。 VALUE が指定された場合、一致するパスのみが
VALUE に等しい値が出力されます

印刷 [ 】
ツリー内のエントリを出力します。 PATH が指定されている場合は、そこから印刷が開始されます。そうでない場合は、
木全体がプリントされています

スパン
ノード PATH の生成元となったファイルの名前と、
ラベル、値、および値に対応するファイル内の位置に関する情報
ノード全体。 PATH は XNUMX つのノードと正確に一致する必要があります。

録音を有効にするには、ファイルをロードする前に「set /augeas/span enable」を実行する必要があります。
スパン情報の。 デフォルトでは無効になっています。

レビューを コマンド
Augeas ツリーを変更するには、次のコマンドを使用します。

クリア
PATH の値を NULL に設定します。 PATH がまだツリーにない場合は、そのパスとそのすべてが
先祖が作られます。

クリアム
XNUMX 回の操作で複数のノード値をクリアします。 SUB に一致するノードを検索または作成します。
SUB を、BASE に一致する各ノードに相対的なパス式として解釈します。 SUBの場合
「.」、BASE に一致するノードが変更されます。

プラグイン
ラベル LABEL を持つ新しいノードを PATH の直前または直後にツリーに挿入します。 どこ
「前」または「後」のいずれかである必要があります。

insert
のエイリアス プラグイン.

mv
ノード SRC を DST に移動します。 SRC はツリー内の XNUMX つのノードと正確に一致する必要があります。 DST は次のいずれかを行う必要があります
ツリー内の XNUMX つのノードに正確に一致するか、まだ存在しない可能性があります。 DST がすでに存在する場合は、
そしてその子孫はすべて削除されます。 DST がまだ存在しない場合は、DST とその不足しているすべてのものが存在します。
先祖が作られます。


のエイリアス mv.

cp
ノード SRC を DST にコピーします。 SRC はツリー内の XNUMX つのノードと正確に一致する必要があります。 DST は次のいずれかを行う必要があります
ツリー内の XNUMX つのノードに正確に一致するか、まだ存在しない可能性があります。 DST がすでに存在する場合は、
そしてその子孫はすべて削除されます。 DST がまだ存在しない場合は、DST とその不足しているすべてのものが存在します。
先祖が作られます。

copy
のエイリアス cp.

リネーム
SRC に一致するすべてのノードのラベル名を LBL に変更します。

rm
PATH とそのすべての子をツリーから削除します

セッションに
VALUE を PATH に関連付けます。 PATH がまだツリー内にない場合は、PATH とそのすべての祖先
作成されます。

セット [ 】
複数のノードを一度の操作で設定します。 SUB に一致するノードを検索または作成します。
SUB を、BASE に一致する各ノードに相対的なパス式として解釈します。 SUBの場合
「.」、BASE に一致するノードが変更されます。

touch
PATH がまだツリーにない場合は、値 NULL を使用して PATH を作成します。 その先祖全員が
も作成されます。 これらの新しいツリー エントリは、兄弟の中で最後に表示されます。

パス 表現 コマンド
次のコマンドは、パス式を操作する場合に役立ちます。

デフノード [ 】
変数 NAME を EXPR の評価結果に定義します。これはノードセットである必要があります。 もしも
EXPR に一致するノードはまだ存在しないため、ノードが作成され、NAME がそれを参照します。 値の場合
が与えられた場合、これは「set EXPR VALUE」と同じです。 VALUE が指定されていない場合、ノードは
「clear EXPR」を使用したかのように作成され、NAME はそのノードを参照します。

デフバー
EXPRの評価結果を変数NAMEに定義します。 変数は以下で使用できます
パス式を $NAME として使用します。 EXPR は変数の定義時に評価されることに注意してください。
使用時ではありません。

ENVIRONMENT 変数

AUGEAS_ROOT
ファイル システムのルート。デフォルトは「/」です。 でオーバーライドできます -r コマンドライン
オプション

AUGEAS_LENS_LIB
レンズを含むディレクトリのコロン区切りのリスト。 ここで指定するディレクトリは、
で設定されたディレクトリの後に検索されます。 -I コマンドラインオプション、ただし、
デフォルトのディレクトリ /usr/share/augeas/レンズ & /usr/share/augeas/lenses/dist

診断

通常、終了ステータスは 0 です。XNUMX つ以上のコマンドが失敗した場合、終了ステータスは非ステータスに設定されます。
ゼロ値。

ただし、変換で指定された一部のファイルのロードに失敗することに注意してください。
「/augeas/load」は失敗とみなされません。 すべてのファイルが保存されていることを知ることが重要な場合は、
ロードされている場合は、ロード後に「match /augeas//error」を発行して詳細を確認する必要があります。
ロードできなかったファイルとその理由。

例

# コマンドラインモード
augtool print /files/etc/hosts/

# インタラクティブモード
オーグツール
オーグツール>ヘルプ
augtool> print /files/etc/hosts/

# XNUMX 番目の AcceptEnv 行から XNUMX 番目のエントリを出力します。
augtool print '/files/etc/ssh/sshd_config/AcceptEnv[2]/3'

# inittab でアクション「initdefault」を持つエントリを検索します
augtool> match /files/etc/inittab/*/action initdefault

# 各エントリの最後のエイリアスを出力します。 /etc/hosts
augtool> print /files/etc/hosts/*/alias[last()]

onworks.net サービスを使用してオンラインで augtool を使用する