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

プログラム：

NAME

guestfish - ゲストファイルシステムシェル

SYNOPSIS

guestfish [--options] [コマンド]

ゲストフィッシュ

guestfish [--ro|--rw] -a ディスク.img

guestfish [--ro|--rw] -a ディスク.img -m dev[:マウントポイント]

guestfish -d libvirt-domain

guestfish [--ro|--rw] -a ディスク.img -i

guestfish -d libvirt-domain -i

警告

ライブ仮想マシン上で書き込みモードで「guestfish」を使用するか、他のディスクと同時に使用する
編集ツールは危険であり、ディスクの破損を引き起こす可能性があります。 仮想マシン
このコマンドを使用する前にシャットダウンする必要があり、ディスクイメージを編集しないでください
同時に。

--ろ （読み取り専用）ディスクイメージまたは仮想マシンが
マシンが稼働している可能性があります。 実行すると、奇妙な結果や一貫性のない結果が表示される場合があります
他の変更と同時に実行しますが、このオプションを使用すると、ディスクが破損するリスクはありません。

DESCRIPTION

Guestfishは仮想マシンを検査および変更するためのシェルおよびコマンドラインツールです。
ファイルシステム。libguestfsを使用し、guestfs APIのすべての機能を公開します。
ゲストとします。

Guestfishは、シェルスクリプトまたは
コマンドラインまたは対話形式で実行できます。破損した仮想マシンイメージを修復したい場合は、
見るべき 仮想レスキュー（1）コマンド。

例

As an 相互作用的 shell
$ ゲストフィッシュ

guestfishへようこそ。ゲストファイルシステムシェル
仮想マシンのファイルシステムを編集します。

コマンド一覧を表示するには「help」と入力してください
マニュアルを読む「男」
シェルを終了するには「終了」

>アドロディスク.img
>> 走る
>ファイルシステムのリスト
/dev/sda1: ext4
/dev/vg_guest/lv_root: ext4
/dev/vg_guest/lv_swap: スワップ
> /dev/vg_guest/lv_root をマウントします。
>猫 /etc/fstab
# /etc/fstab
# アナコンダによって作成されました
[...]
>> 出口

shell スクリプト
新しいを作成します /etc/motd ゲストまたはディスク イメージ内のファイル:

ゲストフィッシュ <<_EOF_
ディスク.img を追加
ラン
/dev/vg_guest/lv_root をマウントします。
/etc/motd に「ようこそ、新規ユーザー様」と書き込みます
_EOF_

ディスク イメージ内の LVM 論理ボリュームを一覧表示します。

guestfish -a ディスク.img --ro <<_EOF_
ラン
lvs
_EOF_

ディスク イメージ内のすべてのファイルシステムを一覧表示します。

guestfish -a ディスク.img --ro <<_EOF_
ラン
ファイルシステムのリスト
_EOF_

On XNUMXつ command ライン
更新 /etc/resolv.conf ゲストの場合：

ゲストフィッシュ \
ディスク.img を追加: 実行: mount /dev/vg_guest/lv_root /: \
書きます /etc/resolv.conf 「ネームサーバー 1.2.3.4」

編集 /boot/grub/grub.conf インタラクティブに：

guestfish --rw --add ディスク.img \
--mount /dev/vg_guest/lv_root \
--mount /dev/sda1:/ブート \
/boot/grub/grub.confを編集する

マウント ディスク 自動的に
-i 仮想マシンからディスクを自動的にマウントするオプション:

guestfish --ro -a ディスク.img -i cat /etc/group

guestfish --ro -d libvirt-domain -i cat /etc/group

編集する別の方法 /boot/grub/grub.conf インタラクティブには次のとおりです。

guestfish --rw -a disk.img -i /boot/grub/grub.conf を編集する

As a スクリプト 通訳
ext100 形式のパーティションを含む 2 MB のディスクを作成します。

#!/usr/bin/guestfish -f
スパース test1.img 100M
ラン
部分ディスク /dev/sda mbr
mkfs ext2 /dev/sda1

お気軽にご連絡ください 　 a 準備 ディスク
100MBのディスクを作成する別の方法は、 テスト1.img 単一の
ext2形式のパーティション:

ゲストフィッシュ -N fs

利用可能なものを一覧表示するには、次の手順を実行します。

guestfish -N ヘルプ | 少ない

リモート ドライブ
ssh を使用してリモート ディスクにアクセスします。

guestfish -a ssh：//example.com/path/to/disk.img

リモート コントロール
「`guestfish --listen`」を評価する
guestfish --remote add-ro ディスク.img
guestfish --remote 実行
guestfish --remote lvs

OPTIONS

- 助けて
オプションに関する一般的なヘルプを表示します。

-h
--cmd-ヘルプ
利用可能なすべての guestfish コマンドを一覧表示します。

-h CMD
--cmd-ヘルプ CMD
単一のコマンド「cmd」の詳細なヘルプを表示します。

-a 画像
- 追加 画像
ブロック デバイスまたは仮想マシン イメージをシェルに追加します。

ディスクイメージのフォーマットは自動検出されます。 これをオーバーライドして強制するには
特定の形式は --format =。。 オプションを選択します。

このフラグの使用は、"readonly:true" を指定した "add" コマンドの使用とほぼ同じです。
もし --ろ フラグが指定され、"format:..."の場合は --format=... フラグが与えられました。

-a URI
- 追加 URI
リモートディスクを追加します。「リモートストレージの追加」を参照してください。

-c URI
- 接続 URI
と組み合わせて使用​​する場合 -d オプションの場合、これは使用するlibvirtURIを指定します。
デフォルトでは、デフォルトのlibvirt接続が使用されます。

--csh
使用している場合 - 聞く オプションとcshのようなシェルを使用する場合は、このオプションを使用してください。セクションを参照してください。
以下、「リモート コントロールと CSH」。

-d libvirt-ドメイン
- ドメイン libvirt-ドメイン
指定されたlibvirtドメインからディスクを追加します。 の場合 --ろ オプションも使用され、その後、
libvirtドメインを使用できます。 ただし、書き込みモードでは、libvirtドメインのみが
シャットダウンはここで名前を付けることができます。

名前の代わりにドメインUUIDを使用できます。

このフラグの使用は、"add-domain"コマンドの使用とほぼ同じで、
「readonly:true」の場合 --ろ フラグが指定され、"format:..."の場合は --format=...
フラグが与えられました。

-エコーキー
キーとパスフレーズを要求するとき、guestfishは通常エコーをオフにするので、
入力している内容がわかりません。 テンペストの攻撃を心配していない場合
部屋には他に誰もいないので、このフラグを指定して入力内容を確認できます。

-f file
- ファイル file
「ファイル」からコマンドを読み込みます。純粋なguestfishスクリプトを書くには、以下を使用します。

#!/usr/bin/guestfish -f

--format = raw | qcow2 |。。
- フォーマット
のデフォルト -a オプションは、ディスクイメージのフォーマットを自動検出することです。 使用する
これにより、ディスクフォーマットが強制されます -a コマンドラインに続くオプション。 使用する
- フォーマット 引数なしで、後続の自動検出に戻ります -a オプション。

具体的な例を挙げますと、以下の通りです。

guestfish --format=raw -a ディスク.img

のraw形式（自動検出なし）を強制します ディスク.img.

guestfish --format=raw -a ディスク.img --format -a 別の.img

のraw形式（自動検出なし）を強制します ディスク.img の自動検出に戻ります
別の.img.

信頼できないraw形式のゲストディスクイメージがある場合は、このオプションを使用して次のことを行う必要があります。
ディスクフォーマットを指定します。 これにより、悪意のあるセキュリティ問題の可能性を回避できます
ゲスト（CVE-2010-3851）。「add」も参照してください。

-i
-検査官
使い方 virt-インスペクター（1）コード、オペレーティングシステムを探しているディスクを検査し、
実際の仮想マシンにマウントされるのと同じようにファイルシステムをマウントします。

典型的な使用法は次のいずれかです。

ゲストフィッシュ -d マイゲスト -i

（非アクティブなlibvirtドメインの場合 マイゲスト）、 また：

guestfish --ro -d myguest -i

(アクティブドメインの場合は読み取り専用)、またはブロックデバイスを直接指定します。

guestfish --rw -a /dev/Guests/MyGuest -i

コマンドライン構文は guestfish の古いバージョンと比べて若干変更されていることに注意してください。
古い構文も引き続き使用できます。

guestfish [--ro] -i ディスク.img

guestfish [--ro] -i libvirt-domain

このフラグの使用は、"inspect-os"コマンドを使用してから
見つかったファイルシステムをマウントするためのその他のコマンド。

--標準入力からのキー
stdinからキーまたはパスフレーズのパラメーターを読み取ります。 デフォルトでは、読み込もうとします
開くことによるユーザーからのパスフレーズ / dev / tty.

- 聞く
バックグラウンドにフォークし、リモートコマンドをリッスンします。「リモートコントロール」セクションを参照してください。
下の「GUESTFISH OVER A SOCKET」をご覧ください。

- 住む
ライブ仮想マシンに接続します。 （実験的、「実行中のデーモンへのアタッチ」を参照してください。
in ゲスト（3））。

-m dev [：mountpoint [：options [：fstype]]]
- マウント dev [：mountpoint [：options [：fstype]]]
指定されたマウントポイントに名前付きパーティションまたは論理ボリュームをマウントします。

マウントポイントを省略すると、デフォルトで次のようになります。 /.

何かをマウントする必要がある / ほとんどのコマンドが機能する前に。

もしあれば -m or - マウント オプションが指定されると、ゲストは自動的に起動されます。

ディスクイメージに含まれるファイルシステムがわからない場合は、guestfishを実行できます。
このオプションがない場合は、使用可能なパーティション、ファイルシステム、およびLVを一覧表示します（を参照）。
「list-partitions」、「list-filesystems」、「lvs」コマンド）、または
virt-ファイルシステム（1）プログラム。

マウントパラメータのXNUMX番目の（そしてめったに使用されない）部分は、マウントオプションのリストです。
基盤となるファイルシステムをマウントするために使用されます。 これが指定されていない場合、マウントオプション
空の文字列または「ro」（後者の場合は後者）のいずれかです --ろ フラグが使用されます）。 に
マウントオプションを指定すると、このデフォルトの選択を上書きします。 おそらく唯一
これを使用するのは、ファイルシステムの場合にACLや拡張属性を有効にするためです。
それらをサポートできます：

-m / dev / sda1：/：acl、user_xattr

このフラグを使用することは、「mount-options」コマンドを使用することと同じです。

パラメータの3番目の部分は、「extXNUMX」や
「ntfs」。 これが必要になることはめったにありませんが、複数のドライバーが有効な場合に役立ちます。
ファイルシステム（例：「ext2」および「ext3」）、またはlibguestfsがファイルシステムを誤認した場合。

- 通信網
ゲストで QEMU ユーザー ネットワークを有効にします。

-N [ファイル名=]タイプ
- 新着 [ファイル名=]タイプ
-N 助けます
「type」でフォーマットされた新しいディスクイメージを用意します。これは、 -a
オプション：一方 -a 既存のディスクを追加します。 -N フォーマット済みのディスクを作成します
ファイルシステムを作成し、それを追加します。下記の「準備されたディスクイメージ」を参照してください。

-n
--同期なし
自動同期を無効にします。これはデフォルトで有効になっています。自動同期については、
ゲスト（3）マンページ。

--no-dest-paths
ゲストファイルシステム上のパスをタブ補完しないでください。
Tabキーでゲストファイルシステム上のパスを補完できますが、これにより余分な「隠し」が発生します。
guestfs 呼び出しが行われるように、このオプションはこの機能を無効にするために用意されています。

--パイプエラー
パイプコマンドへの書き込みに失敗した場合（以下の「パイプ」を参照）、コマンドは
エラー。

デフォルトでは (歴史的な理由により) このようなエラーは無視され、次のようになります。

>出力の多いコマンド | ヘッド

エラーは発生しません。

--プログレスバー
guestfish が非対話型で使用される場合でも、進行状況バーを有効にします。

guestfish を対話型シェルとして使用する場合、進捗状況バーはデフォルトで有効になります。

--プログレスバーなし
進捗バーを無効にします。

--remote[=pid]
リモートコマンドを$GUESTFISH_PIDまたは「pid」に送信します。「リモートコントロール」セクションを参照してください。
下の「GUESTFISH OVER A SOCKET」をご覧ください。

-r
--ろ
これにより、 -a, -d 　 -m ディスクが追加され、マウントが行われるようにするオプション
読み取り専用。

ディスクイメージまたは仮想マシンが実行されている可能性がある場合は、このオプションを常に使用する必要があります。
通常、ディスクへの書き込みアクセスが必要ない場合に推奨されます。

準備されたディスクイメージは、 -N このオプションの影響を受けません。また
「add」のようなコマンドは影響を受けません - 「readonly:true」オプションを指定する必要があります
必要であれば明示的に指定してください。

下記の「ディスクを読み取りおよび書き込み用に開く」も参照してください。

--セリナックス
ゲストのSELinuxサポートを有効にします。「SELINUX」を参照してください。 ゲストとします。

-v
-詳細
非常に詳細なメッセージを有効にします。これはバグを発見した場合に特に便利です。

-V
- バージョン
guestfish / libguestfs のバージョン番号を表示して終了します。

-w
--rw
これにより、 -a, -d 　 -m ディスクが追加され、マウントが行われるようにするオプション
読み書き。

下記の「ディスクを読み取りおよび書き込み用に開く」を参照してください。

-x 各コマンドを実行する前にエコーします。

コマンド ON COMMAND LINE

追加の（オプション以外の）引数は、実行するコマンドとして扱われます。

実行するコマンドはコロン（":"）で区切る必要があります。コロンは
パラメータ。つまり、

guestfish cmd [args...] : cmd [args...] : cmd [args...] ...

追加の引数がない場合は、対話型シェルまたは
プロンプト（入力が端末の場合）または非対話型シェルを使用します。

コマンドラインモードまたは非対話型シェルのいずれの場合も、
エラーが発生するとシェル全体が終了します。対話モード（プロンプト付き）では、コマンド
失敗した場合でも、コマンドの入力を続行できます。

使用する 起動する （また 走る）

屈折計と同様に、この類の検証は官能評価と並行して行うべきです。一般的に、抽出が進むにつれて高温になる抽出方法は、抽出が成功する確率が低い傾向にあります。 ゲスト（3）まずディスクを追加してゲストを設定し、起動する必要があります。
次に必要なディスクをマウントし、最後にアクション/コマンドを実行します。一般的な手順は次のようになります。
今日のテーマは：

· 追加または -a/--add

· 起動（実行）

· マウントまたは -m/--マウント

· その他のコマンド

「run」は「launch」の同義語です。マウントする前にゲストを「launch」（または「run」）する必要があります。
またはその他のコマンドを実行します。

唯一の例外は、 -i, -m, - マウント, -N or - 新着 選択肢が与えられた
「実行」は自動的に実行されます。これは単にguestfishがあなたが指定したアクションを実行できないためです。
これを行わずに要求されました。

開設 ディスク FOR お客様の声は そして レビューを

ゲストフィッシュ、 ゲストマウント（1）と 仮想レスキュー（1）オプション --ろ 　 --rw 影響を与えるかどうか
その他のコマンドラインオプション -a, -c, -d, -i 　 -m ディスクイメージを読み取り専用または
執筆。

libguestfs ≤ 1.10では、guestfish、guestmount、virt-rescueはデフォルトでディスクを開くように設定されていました。
書き込み用にコマンドラインで指定されたイメージ。ディスクイメージを読み取り専用で開くには、
do -a 画像 --ろ.

これは重要です。誤ってライブVMディスクイメージを書き込み可能に開くと、
回復不可能なディスク破損。

将来のlibguestfsでは、デフォルトを逆に変更する予定です。ディスクイメージは
読み取り専用で開かれます。 ゲストフィッシュ --rw, ゲストマウント --rw, ヴァート-
レスキュー用機材 --rwまたは、ディスクイメージへの書き込みアクセスを取得するために設定ファイルを変更する
その他のコマンドラインオプションによって指定されます。

このバージョンのguestfish、guestmount、virt-rescueには --rw 何もしないオプション
（これはすでにデフォルトです）。ただし、このオプションを使用することを強くお勧めします。
書き込みアクセスが必要であることを示して、このオプションが実行される日に備えてスクリプトを準備します。
書き込みアクセスには必要となります。

注意： これはありません 「add」や「mount」などのコマンド、あるいは他のlibguestfsコマンドに影響します。
guestfish と guestmount 以外のプログラム。

見積り

通常のパラメータは、一重引用符または二重引用符で囲むことができます。例:

「スペースのあるファイル.img」を追加

rm '/ファイル名'

rm '/"'

いくつかのコマンドでは文字列のリストを渡す必要があります。これらのコマンドには、空白文字を使用してください。
引用符で囲まれた区切りのリスト。空白を含む文字列はそのまま渡される。
一重引用符で囲む必要があります。一重引用符そのものは、
バックスラッシュ。

vgcreate VG "/dev/sda1 /dev/sdb1"
指図 "/ bin / echo 「フーバー」
指図 "/ bin / echo \'foo\'"

エスケープ シーケンス IN ダブル 見積り 議論
二重引用符で囲まれた引数の場合のみ、バックスラッシュを使用して特殊文字を挿入します。

「\a」
警告（ベル）文字。

"\b"
バックスペース文字。

"\f"
フォームフィード文字。

"\ n"
改行文字。

"\r"
復帰文字。

"\ t"
水平タブ文字。

"\v"
垂直タブ文字。

"\""
リテラルの二重引用符文字。

「\ooo」
8進数値を持つ文字 または3進数は正確にXNUMX桁でなければなりません（Cとは異なります）。

「\xhh」
16進数値を持つ文字 hh2 進数は正確に XNUMX 桁である必要があります。

現在の実装では、「\000」と「\x00」は文字列で使用できません。

「\\」
文字通りのバックスラッシュ文字。

オプション 議論

一部のコマンドではオプションの引数を取ることができます。これらの引数はこのドキュメントでは次のように表記されます。
"[argname:..]"。以下の例のように使用できます。

ファイル名を追加

ファイル名にreadonly:trueを追加

ファイル名の形式を追加:qcow2 読み取り専用:false

オプション引数はそれぞれ1回だけ使用できます。すべてのオプション引数は、
必要なもの。

NUMBERS

このセクションは、整数をパラメータとして受け取ることができるすべてのコマンドに適用されます。

サイズ サフィックス
コマンドがバイト単位で測定されたパラメータを取る場合、次のいずれかを使用できます。
キロバイト、メガバイト、およびそれ以上のサイズを指定するためのサフィックス:

k or K or KiB
キロバイト単位のサイズ（1024 倍）。

KB SI 1000 バイト単位でのサイズ。

M or Eb
メガバイト単位のサイズ（1048576 倍）。

MB SI 1000000 バイト単位でのサイズ。

G or GiB
ギガバイト単位のサイズ（2**30 倍）。

GB SI 10**9 バイト単位でのサイズ。

T or TiB
テラバイト単位のサイズ（2**40 倍）。

TB SI 10**12 バイト単位でのサイズ。

P or ピブ
ペタバイト単位のサイズ（2**50 倍）。

PB SI 10**15 バイト単位でのサイズ。

E or エイビー
エクサバイト単位のサイズ（2**60 倍）。

EB SI 10**18 バイト単位でのサイズ。

Z or ジブ
ゼタバイト単位のサイズ（2**70 倍）。

ZB SI 10**21 バイト単位でのサイズ。

Y or YiB
ヨタバイト単位のサイズ（2**80 倍）。

YB SI 10**24 バイト単位でのサイズ。

具体的な例を挙げますと、以下の通りです。

切り捨てサイズ /file 1G

ファイルは 1 ギガバイトに切り捨てられます。

いくつかのコマンドはキロバイトまたはメガバイト単位でサイズを指定するので注意してください（例：パラメータ
「memsize」は既にメガバイト単位で指定されています。接尾辞を追加してもおそらく
あなたが期待するもの。

オクタル そして 16進数 NUMBERS
基数（基数）を指定するには、Cの規則を使用します。0進数の先頭に0を付ける、または「XNUMXx」を付けます。
16進数の先頭に付加します。例:

1234 1234進数 XNUMX
02322 1234進数、XNUMX進数XNUMXに相当
0x4d2 1234進数、XNUMX進数XNUMXに相当

「chmod」コマンドを使用する場合、ほとんどの場合、8進数で指定します。
モードでは、先頭に 0 を付ける必要があります (Unix とは異なり、 chmod（１）プログラム：

chmod 0777 /public # OK
chmod 777 /public # 間違っています! これはモード 777 (01411 進数) = XNUMX (XNUMX 進数) です。

数値を返すコマンドは通常、10進数で出力しますが、一部のコマンドでは
他の基数の数値（例：「umask」は、先頭に 0 を付けて XNUMX 進数でモードを出力します）。

ワイルドカード そして グロビング

guestfishもその基礎となるguestfs APIもワイルドカード拡張（グロブ）を実行しません。
デフォルトです。そのため、例えば次の例は期待どおりには動作しません。

rm-rf / home /*

文字通りディレクトリ名がないと仮定します / home /* 上記のコマンドは
エラーを返します。

ワイルドカード拡張を実行するには、「glob」コマンドを使用します。

グロブrm-rf / home /*

一致する各パスに対して「rm-rf」を実行します（つまり、コマンドを何度も実行する可能性があります）。
に相当：

rm-rf /home/jim
rm-rf /home/joe
rm-rf /home/mary

「glob」は単純なゲスト パスでのみ機能し、デバイス名では機能しません。

ワイルドカードを含む複数のパラメータがある場合、globは
デカルト積。

コメント

で始まる行は # 文字はコメントとして扱われ、無視されます。 # できる
必要に応じて空白を前に付けることもできるが、 コマンドによって。例:

＃これはコメントです
＃これはコメントです
foo # コメントではありません

空白行も無視されます。

ランニング コマンド ローカルに

で始まる行は ! 文字はローカルシェルに送られたコマンドとして扱われる
(/bin/sh または何でも 　（３）用途）。例えば：

!mkdir ローカル
tgz-out /remote local/remote-data.tar.gz

ホスト上に「local」ディレクトリを作成し、その内容をエクスポートします。 /リモート on
マウントされたファイルシステムを ローカル/リモートデータ.tar.gz（「tgz-out」を参照）。

ローカルディレクトリを変更するには、「lcd」コマンドを使用します。「!cd」は効果がありません。
Unix におけるサブプロセスの動作方法。

LOCAL コマンド WITH 列をなして 実行
行が <! シェルコマンドが実行されます（ !）だがその後
シェル コマンドの出力 (stdout) はすべて解析され、 guestfish コマンドとして実行されます。

このようにシェルスクリプトを使用して任意のguestfishコマンドを作成し、
guestfish によって解析されました。

たとえば、一連のファイル (例: ) を作成するのは面倒です。 /foo.1 　 /foo.100)
guestfishコマンドだけを使う場合。ただし、シェルスクリプトを使って作成すれば簡単です。
guestfish のコマンドは次の通りです:

<! for n in `seq 1 100`; do echo write /foo.$n $n; done

または次のような名前 /foo.001:

<! for n in `seq 1 100`; do printf "write /foo.%03d %d\n" $n $n; done

guestfishを対話的に使用する場合、最初にシェルスクリプトを実行すると便利です。
（つまり、最初の「<」文字を削除して、通常の ! ローカルコマンド）で何が起こっているか確認する
guestfishコマンドを実行し、それらに満足したら「<」を先頭に追加します。
guestfish コマンドを実際に実行するための文字。

パイプ

「コマンド」を使用する| コマンド」を使用して、最初のコマンド（guestfishコマンド）の出力をパイプします。
コマンド）を2番目のコマンド（任意のホストコマンド）に追加します。例：

cat /etc/passwd | awk -F: '$3 == 0 { 印刷 }'

（「cat」はguestfishのcatコマンドですが、「awk」はホストのawkプログラムです）。上記の
コマンドは、ゲストファイルシステム内のUID 0、つまりrootを持つすべてのアカウントを一覧表示します。
バックドアを含むアカウント。その他の例：

XNUMX進ダンプ / bin / ls | 頭
デバイス一覧 | 末尾 -1
tgz-out / - | tar ztf -

パイプ記号の前のスペースは必須ですが、パイプ記号の後のスペースはオプションです。
パイプ記号の後のすべてはホストシェルに直接渡されるので、
リダイレクト、グロブ、およびホスト側で意味を成すその他のものをすべて含めます。

パイプ記号で始まるリテラル引数を使用するには、引用符で囲む必要があります。例:

エコー "|"

ホーム ディレクトリ

パラメータが文字「~」で始まる場合、チルダはホームとして展開される可能性があります。
ディレクトリパス（現在のユーザーのホームディレクトリの場合は「~」、別のユーザーのホームディレクトリの場合は「~user」）
ユーザー）。

ホームディレクトリの拡張は、 on 　 hostゲストではない
ファイルシステム。

チルダで始まるリテラル引数を使用するには、次のように引用符で囲む必要があります。

エコー「〜」

暗号化 ディスク

LibguestfsはLinux Unified Keyに従って暗号化されたLinuxゲストをある程度サポートしています。
セットアップ（LUKS）標準には、ほぼすべてのディスク全体の暗号化システムが含まれています。
最新の Linux ゲスト。現在は LVM-on-LUKS のみがサポートされています。

「vfs-type」を使用して暗号化されたブロックデバイスとパーティションを識別します。

> vfsタイプ /dev/sda2
暗号_LUKS

次に「luks-open」を使ってこれらのデバイスを開きます。これにより、デバイスマッパーデバイスが作成されます。
/dev/mapper/luksdev.

> luks-open /dev/sda2 luksdev
キーまたはパスフレーズ（「キー」）を入力してください:

最後に、新しく作成されたマッパー デバイス上のボリューム グループをスキャンするように LVM に指示する必要があります。

vgscan
vg-activate-all が true

論理ボリュームは通常の方法でマウントできるようになりました。

LUKSデバイスを閉じる前に、そのデバイス上の論理ボリュームをアンマウントし、
各ボリュームグループに対して「vg-activate false VG」を呼び出します。その後、
マッパーデバイス:

vg-activate 偽 /dev/VG
luks-close /dev/mapper/luksdev

WINDOWS パス

パスの先頭に「win:」が付いている場合は、Windows形式のドライブ文字とパスを使用できます。
(一部制限あり) 以下のコマンドは同等です:

ファイル /WINDOWS/system32/config/system.LOG

ファイル win:\windows\system32\config\system.log

ファイル WIN:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG

パラメータは、ドライブの位置を検索することで「舞台裏で」書き換えられる。
マウントされ、パスの先頭に追加され、すべてのバックスラッシュ文字が前方に置き換えられます
スラッシュで区切られた文字列を「大文字小文字を区別するパス」で解決します。例えば、E:ドライブの場合
搭載された /e パラメータは次のように書き換えられるかもしれません:

win:e:\foo\bar => /e/FOO/bar

これは、パスを期待する引数の位置でのみ機能します。

アップロード中 そして ダウンロード ファイル

「upload」「download」「tar-in」「tar-out」などのアップロードを行うコマンドの場合
ローカルファイルからダウンロードする場合、特別なファイル名「-」を使用して「
「stdin」または「stdout」を指定します。例:

アップロード - /foo

stdinを読み取り、そこからファイルを作成する / foo ディスクイメージでは、次のようになります。

タールアウト の/ etc - | タールtf -

tarballを標準出力に書き出し、それを外部の「tar」コマンドにパイプします（
「パイプ」)。

stdinから読み込む際に「-」を使用する場合、入力はstdinの最後まで読み込まれます。また、
任意の終了マーカーまで読み込むには、特別な「ヒアドキュメント」のような構文を使用します。

アップロード -<
入力行1
入力行2
入力行3
終わり

「END」の代わりに任意の文字列を使用できます。終了マーカーは
先行文字や後続文字 (スペースも含まない) のない、独自の行。

「-<<」構文は、ローカルファイルのアップロードに使用されるパラメータにのみ適用されることに注意してください（つまり、
ジェネレーターでは「FileIn」パラメータと呼ばれます。

EXIT ON ERROR 動作

デフォルトでは、guestfishは対話モード（コマンド実行時など）ではエラーを無視します。
人間から端末経由で）非対話モードでは最初のエラーで終了します。
(スクリプト、コマンド ラインで指定されたコマンド)。

コマンドの前に - 文字の場合、そのコマンドはguestfishに
その (1 つの) コマンドがエラーを返した場合でも、終了します。

遠隔地 CONTROL ゲストフィッシュ OVER A ソケット

Guestfishはソケット経由でリモートコントロールできます。これは特にシェルで役立ちます。
ファイルシステムにいくつかの異なる変更を加えたいが、
毎回 guestfish プロセスを起動するオーバーヘッドを必要としません。

次を使用して guestfish サーバー プロセスを開始します。

「`guestfish --listen`」を評価する

そして、次のようにしてコマンドを送信します。

guestfish --remote cmd [...]

サーバーを終了するには、exit コマンドを送信します。

guestfish--リモート出口

コマンドにエラーが発生した場合、サーバーは通常終了します。
通常の方法でこれを実行します。「エラー時の終了動作」セクションを参照してください。

制御 複数 ゲストフィッシュ プロセス
「eval」文は環境変数$GUESTFISH_PIDを設定します。
-リモート オプションはコマンドの送信先を指定します。guestfishリスナーは複数設定できます。
以下を使用して実行中のプロセス:

「`guestfish --listen`」を評価する
pid1=$GUESTFISH_PID
「`guestfish --listen`」を評価する
pid2=$GUESTFISH_PID
...
guestfish --remote=$pid1 コマンド
guestfish --remote=$pid2 コマンド

遠隔地 CONTROL そして CSH
cshのようなシェル（csh、tcshなど）を使用する場合は、 --csh オプション：

「`guestfish --listen --csh`」を評価する

遠隔地 CONTROL 詳細
リモートコントロールはUnixドメインソケットを介して行われます。 /tmp/.guestfish-$UID/ソケット-$PID,
ここで、$UIDはプロセスの実効ユーザーID、$PIDは
サーバー。

Guestfish クライアントとサーバーのバージョンは完全に一致する必要があります。

guestfishの古いバージョンはCVE-2013-4419に対して脆弱でした（「CVE-2013-4419」を参照）。
ゲスト（3））。これは現在のバージョンで修正されています。

使用する 遠隔地 CONTROL 力強く FROM SHELL スクリプト
Bashからは、guestfishインスタンスを正しく作成する次のコードを使用できます。
コマンドラインを引用符で囲み、起動の失敗を処理し、スクリプトの実行時にguestfishをクリーンアップします。
出口:

#!/bin/bash -

セット-e

guestfish[0]="guestfish"
guestfish[1]="--聞く"
guestfish[2]="--ro"
ゲストフィッシュ[3]="-a"
guestfish[4]="disk.img"

GUESTFISH_PID=
$("${guestfish[@]}") を評価する
if [ -z "$GUESTFISH_PID" ]; then
echo "エラー: guestfish が起動しませんでした。上記のエラー メッセージを参照してください。"
1番出口
fi

cleanup_guestfish()
{
guestfish --remote -- exit >/dev/null 2>&1 ||:
}
トラップ cleanup_guestfish EXIT ERR

guestfish --remote -- 実行

＃..。

遠隔地 CONTROL DOES NOT 作業 WITH -a ETC。 OPTIONS
などのオプション -a, - 追加, -N, - 新着 など、リモート サポートと適切にやり取りできません。
これらはローカルで処理され、リモートのゲストフィッシュには送信されません。特に
これは期待通りに動作しません:

guestfish --remote --add ディスク.img

これらのオプションは使用しないでください。代わりに同等のコマンドを使用してください。例:

guestfish --remote add-drive ディスク.img

または：

guestfish --remote
>ディスク.img を追加

遠隔地 CONTROL RUN COMMAND ぶら下がっている
コマンド置換コンテキストでリモートから「run」（または「launch」）コマンドを使用するとハングする。
つまり、以下は行わないでください（バッククォートに注意してください）。

a=`guestfish --remote run`

「run」コマンドは標準出力に何も出力しないので、これはあまり役に立ちません。
詳細については、https://bugzilla.redhat.com/show_bug.cgi?id=592910 を参照してください。

準備された ディスク IMAGES

-N [ファイル名=]タイプ or - 新着 [ファイル名=]タイプ パラメータを使用して、
guestfishが作成するフォーマット済みのディスクイメージを使えば、入力の手間を省くことができます。これは
特にテスト目的に便利です。このオプションは、 -a オプション、
好きな -a 複数回出現することができる（そして、 -a).

新しいディスクは テスト1.img 最初の -N, テスト2.img 2番目も同様です。
現在のディレクトリ内の既存のファイルは 上書きされた別のファイル名を使用することもできます
タイプの前に「filename=」を指定します (以下の例を参照)。

タイプは、ディスクのサイズ、パーティション、ファイルシステムの構成を簡単に説明します。
作成するコンテンツの種類と追加方法を指定します。オプションでタイプを指定できます。
追加のパラメータは「:」（コロン）文字で区切られます。例えば、 -N fs を作成します
デフォルトの100MB、スパースに割り当てられたディスク、単一のパーティションを含む、パーティション
ext2 としてフォーマットされています。 -N fs:ext4:1G 同じですが、4GBのディスク上のext1ファイルシステムの場合です
を代わりにお使いください。

準備したファイルシステムはマウントされていないことに注意してください。通常は、
「mount /dev/sda1 /」コマンドを実行するか、 -m の/ dev / sda1 オプションを選択します。

もしあれば -N or - 新着 オプションが指定されると、libguestfs アプライアンスが自動的に起動します。

例
ext100形式のパーティションを持つ4MBのディスクを作成し、 テスト1.img 現在の
ディレクトリ：

guestfish -N fs：ext4

VFAT 形式のパーティションを持つ 32MB のディスクを作成し、マウントします。

ゲストフィッシュ -N fs:vfat:32M -m /dev/sda1

空の 200MB ディスクを作成します。

guestfish -N ディスク:200M

200MBの空のディスクを作成します。 空白ディスク.img （の代わりに テスト1.img):

guestfish -N 空白ディスク.img=ディスク:200M

-N ディスク - 作ります a ブランク ディスク
"ゲストフィッシュ -N [ファイル名=]ディスク[:サイズ]"

サイズが 100 MB (デフォルト) の空のディスクを作成します。

オプションのパラメータを指定することにより、デフォルトのサイズを変更できます。

オプションのパラメータは次のとおりです。

名前 デフォルト値
サイズ 100M ディスクイメージのサイズ

-N 部 - 作ります a 仕切られた ディスク
"ゲストフィッシュ -N [ファイル名=]part[:size[:partition]]"

単一のパーティションを持つディスクを作成します。デフォルトではディスクのサイズは100MB（
パーティション内の利用可能なスペースは少し小さくなります）そしてパーティションテーブルは
MBR (古い DOS スタイル) であること。

これらのデフォルトは、オプションのパラメータを指定することによって変更できます。

オプションのパラメータは次のとおりです。

名前 デフォルト値
サイズ 100M ディスクイメージのサイズ
パーティションMBRパーティションテーブルタイプ

-N fs - 作ります a ファイルシステム
"ゲストフィッシュ -N [ファイル名=]fs[:ファイルシステム[:サイズ[:パーティション]]]"

空のファイルシステムを含むパーティションを 1 つ持つディスクを作成します。
デフォルトでは100MBのディスクが作成されます（ファイルシステムの使用可能なスペースは
MBR (古い DOS スタイル) パーティション テーブルと ext2 ファイルシステムを備えた、少し小さいサイズです。

これらのデフォルトは、オプションのパラメータを指定することによって変更できます。

オプションのパラメータは次のとおりです。

名前 デフォルト値
ファイルシステム ext2 使用するファイルシステムの種類
サイズ 100M ディスクイメージのサイズ
パーティションMBRパーティションテーブルタイプ

-N lv - 作ります a ディスク 　 論理的な ボリューム
"ゲストフィッシュ -N [ファイル名=]lv[:名前[:サイズ[:パーティション]]]"

単一のパーティションを持つディスクを作成し、そのパーティションをLVM2物理ボリュームとして設定し、
そこにボリュームグループと論理ボリュームを配置します。デフォルトでは100MBの
VGとLVが「/dev/VG/LV」というディスク。VGとLVの名前は次のように変更できます。
最初のオプション パラメータとして代替名を指定します。

ただし、これはファイルシステムを作成しません。ファイルシステムを作成するには「lvfs」を使用してください。

オプションのパラメータは次のとおりです。

名前 デフォルト値
name /dev/VG/LV 使用するVGとLVの名前
サイズ 100M ディスクイメージのサイズ
パーティションMBRパーティションテーブルタイプ

-N lvfs - 作ります a ディスク 　 論理的な ボリューム 　 ファイルシステム
"ゲストフィッシュ -N [ファイル名=]lvfs[:名前[:ファイルシステム[:サイズ[:パーティション]]]]"

単一のパーティションを持つディスクを作成し、そのパーティションをLVM2物理ボリュームとして設定し、
そこにボリュームグループと論理ボリュームを配置します。そして、論理ボリュームを
ファイルシステム。デフォルトでは、VGとLVが100MBのディスクが作成されます。
ext2 ファイルシステムの「/dev/VG/LV」。

オプションのパラメータは次のとおりです。

名前 デフォルト値
name /dev/VG/LV 使用するVGとLVの名前
ファイルシステム ext2 使用するファイルシステムの種類
サイズ 100M ディスクイメージのサイズ
パーティションMBRパーティションテーブルタイプ

-N ブートルート - 作ります a ブート 　 ルート ファイルシステム
"ゲストフィッシュ -N [ファイル名=]bootroot[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]"

ブートとルートファイルシステム用の2つのパーティションを持つディスクを作成します。2つのパーティションをフォーマットします。
ファイルシステムを個別に制御します。正確な制御を行うためのオプションパラメータがいくつかあります。
レイアウトとファイルシステムの種類。

オプションのパラメータは次のとおりです。

名前 デフォルト値
bootfs ext2 ブートに使用するファイルシステムの種類
rootfs ext2 ルートに使用するファイルシステムの種類
サイズ 100M ディスクイメージのサイズ
bootsize 32M ブートファイルシステムのサイズ
パーティションMBRパーティションテーブルタイプ

-N ブートルートlv - 作ります a ブート 　 ルート ファイルシステム LVM
「ゲストフィッシュ -N
[ファイル名=]bootrootlv[:名前[:bootfs[:rootfs[:サイズ[:bootsize[:パーティション]]]]]]"

これは「bootroot」と同じですが、ルートファイルシステム（のみ）が論理ドライブに配置されます。
ボリュームはデフォルトで「/dev/VG/LV」という名前です。オプションパラメータがいくつかあります。
正確なレイアウトを制御します。

オプションのパラメータは次のとおりです。

名前 デフォルト値
name /dev/VG/LV ルートのVGとLVの名前
bootfs ext2 ブートに使用するファイルシステムの種類
rootfs ext2 ルートに使用するファイルシステムの種類
サイズ 100M ディスクイメージのサイズ
bootsize 32M ブートファイルシステムのサイズ
パーティションMBRパーティションテーブルタイプ

追加 遠隔地 STORAG​​E

APIレベル ドキュメント on この トピック、 「guestfs_add_drive_opts」 in ゲスト(3) 　
「リモート ストレージ" in ゲスト(3).

コマンドラインでは、 -a URIを使用してネットワークブロックデバイスを追加するオプション
スタイル形式、例:

guestfish -a ssh://[メール保護]/ディスク.img

URI 「add」コマンドと一緒に使用できます。APIを直接使用する同等のコマンドは
次のとおりです。

> /disk.img を追加 プロトコル:ssh サーバー:tcp:example.com ユーザー名:root

可能性 -a URI 形式については以下で説明します。

-a ディスク.img
-a ファイル：///path/to/disk.img
ローカルディスクイメージ（またはデバイス）を追加します ディスク.img.

-a ftp://[user@]example.com[:port]/disk.img
-a ftps://[user@]example.com[:port]/disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp://[user@]example.com[:port]/disk.img
リモート FTP、HTTP、または TFTP サーバーにあるディスクを追加します。

同等の API コマンドは次のようになります。

> /disk.img を追加 プロトコル:(ftp|...) サーバー:tcp:example.com

-a gluster://example.com[:port]/volname/image
GlusterFS ストレージにあるディスク イメージを追加します。

サーバーは「glusterd」を実行しているサーバーであり、「localhost」である可能性があります。

同等の API コマンドは次のようになります。

>ボリューム名/イメージプロトコル:Glusterサーバー:tcp:example.comを追加します

-a iscsi://example.com[:ポート]/ターゲットIQN名[/lun]
iSCSI サーバー上にあるディスクを追加します。

同等の API コマンドは次のようになります。

>ターゲットIQN名/LUNプロトコル:iscsiサーバー:tcp:example.comを追加します。

-a nbd://example.com[:ポート]
-a nbd://example.com[:ポート]/エクスポート名
-a nbd://?socket=/socket
-a nbd:///エクスポート名?socket=/socket
ネットワーク ブロック デバイス (nbd) ストレージにあるディスクを追加します。

当学校区の /エクスポート名 URI の一部は NBD エクスポート名を指定しますが、通常は空のままになります。

オプション ？ソケット パラメータは、通信するUnixドメインソケットを指定するために使用できます。
NBDサーバーを終了してください。サーバー名（TCP/IPなど）とソケットパスを混在させることはできません。

同等の API コマンドは次のようになります (エクスポート名なし)。

> "" を追加 プロトコル:nbd サーバー:[tcp:example.com|unix:/socket]

-a rbd:///プール/ディスク
-a rbd://example.com[:ポート]/pool/disk
Ceph (RBD/librbd) ストレージ ボリュームにあるディスク イメージを追加します。

libguestfsとCephは複数のサーバーをサポートしていますが、
この URI 構文を使用するときに指定します。

同等の API コマンドは次のようになります。

>プール/ディスクを追加 プロトコル:rbd サーバー:tcp:example.com:ポート

-a sheepdog://[example.com[:port]]/volume/image
Sheepdog ボリュームにあるディスク イメージを追加します。

サーバー名はオプションです。libguestfsとSheepdogは複数のサーバーをサポートしていますが、
この URI 構文を使用する場合、指定できるサーバーは最大 1 つだけです。

同等の API コマンドは次のようになります。

>ボリュームを追加 protocol:sheepdog [server:tcp:example.com]

-a ssh://[user@]example.com[:port]/disk.img
セキュア シェル (ssh) SFTP を使用してアクセスしたリモート サーバーにあるディスク イメージを追加します。
プロトコル。SFTP はすべての主要な SSH サーバーですぐにサポートされます。

同等の API コマンドは次のようになります。

> /disk プロトコル:ssh サーバー:tcp:example.com [ユーザー名:user] を追加します

進捗 バー

一部の（すべてではない）長時間実行コマンドは、実行時に進行状況通知メッセージを送信します。
実行中。Guestfish はこれらのメッセージをプログレスバーに変換します。

進捗バーをサポートするコマンドの実行に2秒以上かかる場合、
進行状況バーが有効になっている場合は、コマンドの下に進行状況バーが表示されます。

>コピーサイズ / 大きなファイル / 別のファイル 2048M
/ 10% [#####-----------------------------------------] 00:30

左側のスピナーは、進捗状況の通知ごとに1回転します。
バックエンドから受信したコマンドは、（ほぼ）確実に実行され、
進捗バーが動いていなくても「何かやっている」とコマンドが判断できるからです。
進捗通知を送信します。バーが100%に達し、コマンドが完了すると、
スピナーが消えます。

guestfishを対話的に使用すると、プログレスバーはデフォルトで有効になります。
非対話型モードでも使用できます --プログレスバー無効にすることもできます
完全に使用 --プログレスバーなし.

PROMPT

デフォルトのプロンプトの色を変更したり追加したりできます（"> 」を設定することで
「GUESTFISH_PS1」環境変数。XNUMX番目の文字列（「GUESTFISH_OUTPUT」）が出力されます。
コマンドを入力した後、出力の前に、
出力の色。3番目の文字列（「GUESTFISH_INIT」）は、ウェルカムメッセージの前に表示されます。
メッセージの色を制御できます。4番目の文字列
guestfish が終了する前に ("GUESTFISH_RESTORE") が印刷されます。

「GUESTFISH_PS1」を別の文字列に設定することで、簡単なプロンプトを設定できます。

$ GUESTFISH_PS1='(コマンドを入力)'
$ エクスポート GUESTFISH_PS1
$ ゲストフィッシュ
[...]
（コマンドを入力）▂

次の表に示すように、特殊なエスケープ シーケンスを使用することもできます。

\\ 文字通りのバックスラッシュ文字。

\[
\] (これらは「GUESTFISH_PS1」でのみ使用してください。)

印刷されない文字（例：色の端末制御コード）を次の間に置く。
「\[...\]」。これは何を意味しているのでしょうか？ 読み込まれた行（３）扱うべき図書館
このサブシーケンスをゼロ幅として扱い、コマンドラインの再表示や編集などが機能するようにします。

\a ベル文字。

\e ASCII ESC (エスケープ) 文字。

\n 改行。

\ rキャリッジリターン。

\NNN
コードが 8 進数値 NNN である ASCII 文字。

\xNN
コードが 16 進数値 NN である ASCII 文字。

例 OF プロンプト
これらには ANSI エスケープ コードをサポートする端末が必要であることに注意してください。

·

GUESTFISH_PS1='\[\e[1;30m\]><fs>\[\e[0;30m\] '

通常のプロンプトの太字の黒バージョンです。

·

GUESTFISH_PS1='\[\e[1;32m\]><fs>\[\e[0;31m\] '
GUESTFISH_OUTPUT='\e[0m'
GUESTFISH_RESTORE="$GUESTFISH_OUTPUT"
GUESTFISH_INIT='\e[1;34m'

青いウェルカムテキスト、緑のプロンプト、赤のコマンド、黒のコマンド出力。

WINDOWS 8

Windows 8の「高速スタートアップ」により、GuestfishがNTFSパーティションをマウントできなくなる場合があります。
「WINDOWSHIBERNATIONANDWINDOWS8FASTSTARTUP」の ゲストとします。

ゲストフィッシュ コマンド

このセクションのコマンドはguestfishの便利なコマンドです。言い換えれば、
の一部ではない ゲスト（3）API。

助けます
助けます
ヘルプコマンド

パラメータがない場合、一般的なヘルプが提供されます。

「cmd」パラメータを使用すると、そのコマンドの詳細なヘルプが表示されます。

終了する
やめます
このコマンドでguestfishを終了します。「^D」キーも使用できます。

割り当てる
割り当てる
ファイル名のサイズを割り当てる

これは、指定されたサイズの空の（ゼロ化された）ファイルを作成し、さらに追加できるようにします。
調べた。

より高度なイメージ作成については、「disk-create」を参照してください。

サイズは標準のサフィックスを使用して指定できます (例: 「1M」)。

スパースファイルを作成するには、代わりに「sparse」を使用してください。準備されたディスクイメージを作成するには、
「準備されたディスク イメージ」。

コピーイン
ローカルにコピーイン [ローカル ...] /remotedir

「コピーイン」は、ローカルファイルまたはディレクトリをディスクイメージに再帰的にコピーし、
というディレクトリに /リモートディレクトリ （存在する必要があります）。このguestfishメタコマンドは
必要に応じて、「tar-in」やその他のコマンドのシーケンスに変換します。

複数のローカルファイルとディレクトリを指定できますが、最後のパラメータは常に
リモートディレクトリである必要があります。ワイルドカードは使用できません。

コピーアウト
コピーアウト リモート [リモート ...] localdir

「コピーアウト」は、リモートファイルまたはディレクトリをディスクイメージから再帰的にコピーし、
ホストディスク上の「localdir」というローカルディレクトリ（必ず存在する）に保存します。
guestfish メタコマンドは、「download」、「tar-out」などのコマンドのシーケンスになります。
必要に応じて。

複数のリモートファイルとディレクトリを指定できますが、最後のパラメータは常に
ローカルディレクトリにダウンロードします。現在のディレクトリにダウンロードするには、次のように「.」を使用します。

コピーアウト /ホーム .

ワイルドカードは通常のコマンドでは使用できませんが、
「glob」は次のようになります:

グロブコピーアウト / home /*。

削除イベント
削除イベント名

以前に「name」として登録されたイベントハンドラを削除します。複数のイベントハンドラがある場合は、
同じ名前でハンドラーが登録されている場合、それらはすべて削除されます。

guestfish コマンドの「event」および「list-events」も参照してください。

ディスプレイ
ファイル名を表示

画像ファイルを表示するには、「display」（グラフィカル表示プログラム）を使用します。
ファイルを作成し、それに対して「display」を実行します。

代替プログラムを使用するには、「GUESTFISH_DISPLAY_IMAGE」環境変数を設定します。
たとえば、GNOME ディスプレイ プログラムを使用するには、次のようにします。

GUESTFISH_DISPLAY_IMAGE=eog をエクスポート

参照 ディスプレイとします。

echo
echo [パラメータ...]

これにより、パラメータが端末にエコーされます。

edit
vi
エマックス
ファイル名を編集

これはファイルを編集するために使われます。ファイルをダウンロードし、エディタを使ってローカルで編集します。
結果をアップロードします。

エディタは$EDITORです。ただし、代替コマンドの「vi」や「emacs」を使用する場合は、
対応するエディターを取得します。

イベント
イベント名 eventset "shell script ..."

イベントが発生したときに実行されるシェルスクリプトを登録します。
「guestfs_set_event_callback」の ゲスト（3）イベントAPIの詳細については、
libguestfs。

「name」パラメータは、このイベントハンドラに付ける名前です。任意の文字列を指定できます。
（空の文字列であっても）これは単に、
guestfish "delete-event" コマンド。

「eventset」パラメータは、1つ以上のイベントをカンマで区切ったリストです。例:
「close」または「close,trace」。特別な値「*」はすべてのイベントを意味します。

3番目で最後のパラメータは、シェルスクリプトフラグメント（または外部コマンド）です。
イベントセット内のいずれかのイベントが発生したときに実行されます。これは「$SHELL
-c"、または$SHELLが設定されていない場合は /bin/sh -c.

シェルスクリプトのフラグメントは、コールバックパラメータを引数$1、$2などとして受け取ります。
呼び出された実際のイベントは、環境変数 $EVENT で確認できます。

イベント「閉じる」エコー閉じられました
イベント メッセージ アプライアンス、ライブラリ、トレース "echo $@"
イベント "" progress "エコー進捗状況: $3/$4"
イベント "" * "echo $EVENT $@"

guestfish コマンド「delete-event」および「list-events」も参照してください。

地球
glob コマンド引数...

argsリスト内の任意のパスのワイルドカードを展開し、各パスに対して「command」を繰り返し実行します。
一致するパス。

「ワイルドカードとグロビング」を参照してください。

ヘキサエディット
ヘックスエディット
ヘックスエディット
ヘックスエディット

バイナリ ファイルまたはブロック デバイスの全部または一部を編集するには、hexedit (16 進エディター) を使用します。

このコマンドは、ファイルまたはデバイス全体をダウンロードし、それを編集することで機能します。
ローカルで保存してからアップロードします。ファイルやデバイスが大きい場合は、どのデバイスで保存するかを指定する必要があります。
「max」および/または「start」「max」パラメータを使用して編集したい部分を選択します。「start」と「max」
バイト単位で指定され、「1M」(1 メガバイト) などの通常の修飾子が許可されます。

たとえば、ディスクの最初の数セクターを編集するには、次のようにします。

1進編集 /dev/sda XNUMXM

これにより、ディスクの最初のメガバイト内の任意の場所を編集できるようになります。

ext2ファイルシステムのスーパーブロックを編集するには の/ dev / sda1、 行う：

1進編集 /dev/sda0 400x0 400xXNUMX

(スーパーブロックが標準の場所にあると仮定します)。

このコマンドには外部 ヘキサエディット（１）プログラム。別のプログラムを指定して
「HEXEDITOR」環境変数を設定して使用します。

「hexdump」も参照してください。

液晶
液晶ディレクトリ

ローカル ディレクトリ、つまり guestfish 自体の現在のディレクトリを変更します。

「!cd」は期待どおりには動作しないことに注意してください。

リストイベント
リストイベント

guestfish の「event」コマンドを使用して登録されたイベント ハンドラーを一覧表示します。

man
マニュアル
man

guestfish のマニュアル ページを開きます。

よ
less
ファイル名の詳細

ファイル名が少ない

ファイルを表示するために使用されます。

デフォルトのビューアは$PAGERです。ただし、代替コマンド「less」を使用すると、
具体的には、「less」コマンドを取得します。

再び開きます
再び開きます

libguestfsハンドルを閉じて再度開きます。通常、これを使用する必要はありません。
ゲストフィッシュが退出するとハンドルはきちんと閉じられます。ただし、これは時々役立ちます
テスト用。

設定環境
setenv VAR値

環境変数「VAR」を文字列「value」に設定します。

環境変数の値を出力するには、次のようなシェル コマンドを使用します。

!echo $VAR

まばらな
スパースファイル名のサイズ

これは、指定されたサイズの空のスパースファイルを作成し、さらに
調べた。

イメージファイルが
ディスクブロックは、ファイルが作成されるまでファイルに割り当てられないことを意味します。
必要です。スパースディスクファイルは、書き込むときにのみスペースを使用しますが、遅く、
書き込み操作中に実際のディスク領域が不足する危険性があります。

より高度なイメージ作成については、「disk-create」を参照してください。

サイズは標準のサフィックスを使用して指定できます (例: 「1M」)。

guestfish の「scratch」コマンドも参照してください。

。
。

このコマンドはデーモンが認識しているオプショングループのリストを返し、
libguestfs アプライアンスのこのビルドでサポートされているもの。

「在庫状況」も参照してください ゲストとします。

時間
時間コマンド引数...

通常通りコマンドを実行しますが、その後に経過時間を表示します。これは次のような場合に便利です。
ベンチマーク操作。

設定解除
unsetenv 変数

環境から「VAR」を削除します。

コマンド

acl-delete-def ファイル
acl-delete-def-file dir

この関数は、ディレクトリに添付されたデフォルトのPOSIXアクセス制御リスト（ACL）を削除します。
「ディレクトリ」。

acl-get-ファイル
acl-get-file パス acltype

この関数は、"path"に付与されたPOSIXアクセス制御リスト（ACL）を返します。ACLは
「長いテキスト形式」で返されます（ acl（5））。

「acltype」パラメータは次のようになります。

"アクセス"
任意のファイル、ディレクトリ、またはその他のファイルシステム オブジェクトの通常の (アクセス) ACL を返します。

"デフォルト"
デフォルトのACLを返します。通常、これは「path」がディレクトリの場合にのみ意味を持ちます。

acl セット ファイル
acl-set-file パス acltype acl

この関数は、「path」に添付された POSIX アクセス制御リスト (ACL) を設定します。

「acltype」パラメータは次のようになります。

"アクセス"
任意のファイル、ディレクトリ、またはその他のファイルシステム オブジェクトに対して通常の (アクセス) ACL を設定します。

"デフォルト"
デフォルトのACLを設定します。通常、これは「path」がディレクトリの場合にのみ意味を持ちます。

「acl」パラメータは、「長いテキスト形式」または「短いテキスト形式」の新しいACLです（
acl（5）新しいACLは、ファイル上の以前のACLを完全に置き換えます。ACLは
完全な Unix 権限が含まれます (例: "u::rwx,g::rx,o::rx")。

個々のユーザーまたはグループを指定する場合は、マスクフィールドも必須です。
(例: "m::rwx") の後に "u:ID:..." および/または「g:ID:..." フィールド。完全なACL文字列
したがって、次のようになります。

u::rwx、g::rwx、o::rwx、m::rwx、u:500:rwx、g:500:rwx
\ Unix パーミッション / \ マスク / \ ACL /

数値のUIDとGIDを使用してください。ユーザー名とグループ名を正しいUIDとGIDにマッピングするには、
ゲストのコンテキストにおける数値 ID を取得するには、Augeas 関数を使用します (「aug-init」を参照)。

CD-ROMの追加
add-cdrom ファイル名

この機能は、ゲストに仮想 CD-ROM ディスク イメージを追加します。

イメージは読み取り専用ドライブとして追加されるため、この機能は「add-drive-ro」と同等です。

この function is 非推奨。 新しいコードでは、代わりに「add-drive-ro」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ドメイン追加
ドメイン
ドメイン dom を追加 [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..] [cachemode:..] [discard:..] [copyonread:true|false]

この関数は、libvirtドメイン「dom」にディスクを追加します。
libvirtに接続し、libvirtからドメインとドメインXMLを要求し、それを解析して
ディスクを作成し、各ディスクに対して「add-drive-opts」を呼び出します。

追加されたディスクの数が返されます。この操作はアトミックです。エラーが返された場合は、
ディスクは追加されません。

この関数は、libvirtドメインが実行していないことを確認するための最小限のチェックを実行します。
（「readonly」がtrueの場合を除く）。将来のバージョンでは、libvirtロックを取得しようとする予定です。
各ディスクに。

ディスクはローカルでアクセス可能でなければなりません。これは、多くの場合、リモートからディスクを追加することが
libvirt接続（参照 http://libvirt.org/remote.html）は、これらのディスクが
ローカルでも同じデバイス パス経由でアクセスできます。

オプションの「libvirturi」パラメータはlibvirt URIを設定します（
http://libvirt.org/uri.html）。これが設定されていない場合は、デフォルトのlibvirtに接続します。
URI（または環境変数で設定されたもの。詳細についてはlibvirtのドキュメントを参照）
詳細）。

オプションの「live」フラグは、この呼び出しが実行中のサーバーに接続しようとするかどうかを制御します。
仮想マシンの「guestfsd」プロセスは適切なlibvirtの要素
XML定義。デフォルト（フラグが省略されている場合）では試行は行われません。「
デーモンの実行 ゲスト（3）詳細については。

「allowuuid」フラグがtrue（デフォルトはfalse）の場合、UUID かもしれません 代わりに通過する
ドメイン名。「dom」文字列はまずUUIDとして扱われ、検索され、
検索に失敗した場合は、「dom」を通常どおり名前として扱います。

オプションの「readonlydisk」パラメータは、マークされたディスクに対して何を行うかを制御します。
libvirt XML で。可能な値は次のとおりです。

readonlydisk = "エラー"
「readonly」が false の場合:

ディスクにエラーが発生した場合、呼び出し全体がエラーで中止されます。旗は
発見した。

「readonly」が true の場合:

ディスクにはフラグは読み取り専用で追加されます。

readonlydisk = "読み取り"
「readonly」が false の場合:

ディスクにはフラグは読み取り専用として追加されます。その他のディスクは
読み書き。

「readonly」が true の場合:

ディスクにはフラグは読み取り専用で追加されます。

readonlydisk = "write" (デフォルト)
「readonly」が false の場合:

ディスクにはフラグが読み取り/書き込みに追加されます。

「readonly」が true の場合:

ディスクにはフラグは読み取り専用で追加されます。

readonlydisk = "無視"
「readonly」が true または false の場合:

ディスクにはフラグはスキップされます。

その他のオプション パラメータは、「add-drive-opts」に直接渡されます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ドライブの追加
加えます
ドライブオプションの追加
add-drive ファイル名 [読み取り専用:true|false] [フォーマット:..] [iface:..] [名前:..] [ラベル:..] [プロトコル:..] [サーバー:..] [ユーザー名:..] [シークレット:..] [キャッシュモード:..] [破棄:..] [読み取り時のコピー:true|false]

この関数は、 ファイル名 ハンドルに。 ファイル名 定期的に
ホスト ファイルまたはホスト デバイス。

この関数が「起動」の前に呼び出された場合（通常の場合）、最初に呼び出すときに
この関数では、ディスクはAPIで次のように表示されます。 / dev / sdaに、2回目として / dev / sdb,
というように。

libguestfs ≥ 1.20では、起動後にこの関数を呼び出すこともできます（ただし、
制限事項）。これは「ホットプラグ」と呼ばれます。ホットプラグを行う場合は、
新しいディスクに予測可能な名前が付けられるように、「ラベル」を作成します。詳細については、
「ホットプラグ」 ゲストとします。

libguestfsを使用する際に必ずしもrootになる必要はありません。しかし、明らかにrootになる必要があります。
どのような操作を行うにも、ファイル名にアクセスするための十分な権限が必要です。
実行します（つまり、イメージを読み込むだけの場合は読み取りアクセス、書き込む場合は書き込みアクセス）。
画像を変更します。

この呼び出しは、 ファイル名 存在しています。

ファイル名 特別な文字列「/dev/null」が使用される場合があります。「NULLディスク」を参照してください。 ゲストとします。

オプションの引数は次のとおりです。

「読み取り専用」
trueの場合、イメージは読み取り専用として扱われます。書き込みは許可されますが、
一時的なスナップショットオーバーレイに保存され、最後に破棄されます。ディスク
追加したものは変更されません。

"フォーマット"
イメージフォーマットを強制します。これを省略した場合（または「add-drive」または「add-drive-ro」を使用した場合）
フォーマットは自動的に検出されます。可能なフォーマットは「raw」と
「qcow2」。

フォーマットの自動検出は、次のような場合に潜在的なセキュリティホールを引き起こす可能性があります。
信頼できないRAW形式の画像の処理。CVE-2010-3851およびRHBZ#642934を参照してください。
フォーマットを指定すると、このセキュリティ ホールが閉じられます。

「iface」
このあまり使用されないオプションを使用すると、廃止された「add-drive-
with-if"呼び出し（qv）

"名前"
元のゲストでのドライブの名前、例： / dev / sdbこれはヒントとして使われます
ゲスト検査プロセスが利用可能な場合。

"ラベル"
ディスクにラベルを付けます。ラベルは、一意の短い文字列である必要があります。 の ASCII
"[a-zA-Z]"という文字。APIでの通常の名称（ / dev / sdaに）
ドライブの名前も /dev/disk/guestfs/ラベル.

「ディスクラベル」を参照してください ゲストとします。

"プロトコル"
オプションのプロトコル引数を使用して、代替ソース プロトコルを選択できます。

参照：「リモートストレージ」 ゲストとします。

「プロトコル = 「ファイル」」
ファイル名 ローカルファイルまたはデバイスとして解釈されます。これは、
オプションのプロトコルパラメータが省略されています。

「プロトコル = "ftp"|"ftps"|"http"|"https"|"tftp"」
リモートFTP、HTTP、またはTFTPサーバーに接続します。「server」パラメータも指定する必要があります。
付属 - 下記参照。

参照：「FTP、HTTP、TFTP」 ゲスト(3)

「プロトコル = 「gluster」」
GlusterFSサーバーに接続します。「server」パラメータも指定する必要があります。
下記参照。

参照：「GLUSTER」 ゲスト(3)

「プロトコル = "iscsi"」
iSCSIサーバーに接続します。「server」パラメータも指定する必要があります。
下記を参照してください。「ユーザー名」パラメータを指定することもできます。下記を参照してください。「秘密」
パラメータを指定することもできます。以下を参照してください。

参照: 「ISCSI」 ゲストとします。

「プロトコル = "nbd"」
ネットワークブロックデバイスサーバーに接続します。「server」パラメータも
付属 - 下記参照。

参照: 「ネットワークブロックデバイス」 ゲストとします。

「プロトコル = "rbd"」
Ceph (librbd/RBD)サーバーに接続します。「server」パラメータも必要です。
指定 - 下記参照。「ユーザー名」パラメータを指定することもできます。下記参照。
「secret」パラメータを指定することもできます。以下を参照してください。

参照：「CEPH」 ゲストとします。

「プロトコル = 「シープドッグ」」
Sheepdogサーバーに接続します。「server」パラメータも指定できます。
を参照してください。

参照：「SHEEPDOG」 ゲストとします。

「プロトコル = "ssh"」
Secure Shell (ssh) サーバーに接続します。

「server」パラメータは必ず指定してください。「username」パラメータは
付属。下記参照。

参照: 「SSH」 ゲストとします。

"サーバ"
リモート サーバーへのアクセスを必要とするプロトコルの場合、これはサーバーのリストになります。

プロトコル 必要なサーバーの数
-------- --------------------------
ファイルリストは空であるか、パラメータがまったく使用されていない必要があります
ftp|ftps|http|https|tftp 正確に1つ
輝き まさに1つ
iscsi 正確に1つ
1つだけ
rbd 0以上
牧羊犬 0以上
ssh 正確に1つ

各リスト要素はサーバを指定する文字列です。文字列は次のいずれかである必要があります。
次の形式：

hostname
ホスト名：ポート
tcp:ホスト名
tcp:ホスト名:ポート
unix:/path/to/socket

ポート番号を省略した場合は、プロトコルの標準ポート番号が使用されます。
（参照してください /etc/services).

「ユーザー名」
「ftp」、「ftps」、「http」、「https」、「iscsi」、「rbd」、「ssh」、「tftp」プロトコルの場合、
これはリモートユーザー名を指定します。

指定しない場合は、ローカルユーザー名が「ssh」に使用され、認証は行われません。
ceph で試しました。ただし、予期しない結果になる場合があることに注意してください。たとえば、
libvirtバックエンドを使用しており、libvirtバックエンドが起動するように設定されている場合
qemuアプライアンスを「qemu.qemu」のような特別なユーザーとしてログインします。不明な場合は、リモートの
希望するユーザー名。

"秘密の"
「rbd」プロトコルの場合のみ、接続時に使用する「秘密」を指定します。
リモートデバイス。base64でエンコードされている必要があります。

指定しない場合は、指定されたユーザー名に一致する秘密が検索されます。
デフォルトのキーチェーンの場所、またはユーザー名が指定されていない場合は認証は行われません
中古。

「キャッシュモード」
libguestfs が同期操作に従うかどうかを選択します (安全ですが遅い)
（安全ではないが高速）。この文字列に使用できる値は次のとおりです。

「キャッシュモード = 「ライトバック」」
これがデフォルトです。

APIの書き込み操作は、 書きます（２）通話は
ホスト [ただし、これはディスクに何かが書き込まれることを意味するものではありません]。

ファイルシステムによる暗黙的な同期を含む、API での同期操作
ジャーナリングは、 fdatasync（２）ホスト側で呼び出しが完了し、
データがディスクにコミットされたことを示します。

「キャッシュモード = "安全ではありません"」
このモードでは保証はありません。Libguestfsは何でもキャッシュし、無視する可能性があります。
同期リクエスト。これはスクラッチディスクまたは一時ディスクにのみ適しています。

"破棄"
このドライブの破棄（トリムまたはアンマップ）サポートを有効または無効にします。有効にすると、
「fstrim」のような操作は、
基になるホスト ファイルまたはデバイス。

可能な破棄設定は次のとおりです。

「破棄 = 「無効にする」」
破棄サポートを無効にします。これがデフォルトです。

「破棄 = 「有効にする」」
破棄サポートを有効にします。破棄が不可能な場合は失敗します。

「破棄 = 「最善の努力」」
可能な場合は破棄サポートを有効にしますが、サポートされていない場合は失敗しません。

すべてのバックエンドとすべての基盤システムが破棄をサポートしているわけではないので、これは
可能であれば捨て札を使いたいなら良い選択だが、そうでなくても気にしない
作業。

「コピーオンリード」
ブールパラメータ「copyonread」はコピーオンリードのサポートを有効にします。これは以下の場合にのみ影響します。
バックアップファイルを持つディスクフォーマットで、読み取りがオーバーレイに保存される
レイヤーにより、ディスクの同じ領域に対する複数の読み取りが高速化されます。

デフォルトはfalseです。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ドライブを追加
アドロ
add-drive-ro ファイル名

この関数は、オプションパラメータを指定して「add-drive-opts」を呼び出すのと同等です。
「GUESTFS_ADD_DRIVE_OPTS_READONLY」が1に設定されているため、ディスクは読み取り専用で追加され、
フォーマットは自動的に検出されます。

if でドライブ ro を追加
ファイル名 iface でドライブ ro を追加

これは「add-drive-ro」と同じですが、QEMUインターフェースを指定できます。
実行時に使用するエミュレーション。

この function is 非推奨。 新しいコードでは、代わりに「add-drive」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

スクラッチドライブの追加
スクラッチ
add-drive-scratch size [名前:..] [ラベル:..]

このコマンドは、ハンドルに一時的なスクラッチドライブを追加します。「size」パラメータは
仮想サイズ（バイト単位）。スクラッチドライブは最初は空です（すべての読み取りはゼロを返します）。
書き込みを開始するまで、ドライブは消去されません。ハンドルが閉じられると、ドライブは削除されます。

オプションの引数「name」と「label」は「add-drive」に渡されます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

if文でドライブを追加する
ドライブを追加、ファイル名は iface で指定します

これは「add-drive」と同じですが、QEMUインターフェースエミュレーションを指定できます。
実行時に使用します。

この function is 非推奨。 新しいコードでは、代わりに「add-drive」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

8月クリア
aug-clear augpath

「path」に関連付けられた値を「NULL」に設定します。これは、 オーグツール(1)
「クリア」コマンド。

8月終了
8月終了

現在のAugeasハンドルを閉じ、そのハンドルで使用されているリソースを解放します。これを呼び出した後、
他の Augeas 関数を使用する前に、もう一度 "aug-init" を呼び出す必要があります。

aug-defnode
aug-defnode 名 式 値

「expr」を評価した結果を値とする変数「name」を定義します。

「expr」が空のノードセットに評価された場合、ノードが作成されます。これは「aug-
set" "expr", "value" です。 "name" はその単一のノードを含むノードセットになります。

成功した場合、これはノードセット内のノードの数と、
ノードが作成されたかどうかを示すブールフラグ。

補助定義変数
増分定義変数名式

Augeas変数「name」を定義します。その値は「expr」を評価した結果です。
「expr」が NULL の場合、「name」は未定義になります。

成功した場合、これは「expr」内のノードの数を返します。または、「expr」が次のように評価された場合は0を返します。
ノードセットではないもの。

オーグゲット
aug-get augpath

「path」に関連付けられた値を検索します。「path」が1つのノードに一致する場合、「value」は
返されます。

aug-init
aug-initルートフラグ

設定ファイルを編集するための新しいAugeasハンドルを作成します。以前の
Augeas ハンドルがこの guestfs セッションに関連付けられている場合は閉じられます。

他の「aug-*」コマンドを使用する前にこれを呼び出す必要があります。

「root」はファイルシステムのルートです。「root」はNULLであってはなりません。 / を代わりにお使いください。

フラグは、 、論理的な or 次の
整数：

「AUG_SAVE_BACKUP」 = 1
元のファイルは「.augsave」拡張子を付けて保存してください。

「AUG_SAVE_NEWFILE」 = 2
変更を拡張子「.augnew」のファイルに保存し、元のファイルを上書きしないでください。
「AUG_SAVE_BACKUP」を上書きします。

「AUG_TYPE_CHECK」= 4
レンズのタイプチェック。

このオプションはAugeasレンズのデバッグ時にのみ役立ちます。このオプションを使用すると
libguestfsアプライアンスには追加のメモリが必要です。
「LIBGUESTFS_MEMSIZE」環境変数を設定するか、「set-memsize」を呼び出します。

"AUG_NO_STDINC" = 8
モジュールには標準のロード パスを使用しないでください。

"AUG_SAVE_NOOP" = 16
保存を何も行わず、変更された内容のみを記録するようにします。

"AUG_NO_LOAD" = 32
「aug-init」でツリーをロードしないでください。

ハンドルを閉じるには、「aug-close」を呼び出します。

Augeasの詳細については、 http://augeas.net/.

追加挿入
aug-insert augpath ラベル true|false

「パス」の新しい兄弟「ラベル」を作成し、それを「パス」の前または後にツリーに挿入します。
(ブールフラグ「before」によって異なります)。

「path」はツリー内の既存のノードの 1 つと正確に一致する必要があり、「label」はラベルである必要があります。
含まない /、 "*" または角括弧で囲まれたインデックス "[N]" で終わります。

XNUMX月ラベル
aug-label augpath

Augeas パス式「augpath」のラベル (最後の要素の名前) が返されます。
「augpath」は 1 つのノードと正確に一致する必要があります。そうでない場合、この関数はエラーを返します。

増強負荷
増強負荷

ファイルをツリーにロードします。

完全な詳細については、Augeas ドキュメントの「aug_load」を参照してください。

8月-ls
aug-ls augpath

これは「aug-match」「path/*」をリストし、結果のノードをソートするための単なるショートカットです。
アルファベット順に並べます。

オーグマッチ
aug-match augpath

パス式「path」に一致するパスのリストを返します。返されるパスは以下のとおりです。
現在のツリー内の 1 つのノードと正確に一致するように十分に修飾されています。

8月-MV
aug-mv ソース 宛先

ノード「src」を「dest」に移動します。「src」は1つのノードと正確に一致する必要があります。「dest」は上書きされます。
存在する場合。

拡張rm
aug-rm augpath

「path」とそのすべての子を削除します。

成功した場合、削除されたエントリの数を返します。

8月保存
8月保存

これにより、保留中のすべての変更がディスクに書き込まれます。

「aug-init」に渡されたフラグは、ファイルの保存方法に正確に影響します。

8セット
aug-set augpath val

「path」に関連付けられた値を「val」に設定します。

Augeas APIでは、値をNULLに設定することでノードをクリアすることができます。
libguestfs APIの監視のため、この呼び出しではこれを行うことはできません。代わりに、
「警報解除」の呼びかけ。

XNUMX月-setm
aug-setm 基数サブ値

複数のAugeasノードを1回の操作で変更します。「base」は一致する式です。
複数のノード。「sub」は「base」を基準としたパス式です。「base」に一致するすべてのノード
が見つかり、各ノードの「sub」が「val」に変更されます。「sub」は「NULL」になることもあります。
この場合、「ベース」ノードが変更されます。

変更されたノードの数を返します。

利用できます
利用可能な「グループ...」

このコマンドは、いくつかの機能グループの可用性を確認するために使用されます。
アプライアンスですが、libguestfs アプライアンスのすべてのビルドで提供できるわけではありません。

libguestfsグループと、それらのグループに対応する関数は、
「在庫状況」 ゲスト（3）実行時にこのリストを取得するには、
「すべてのグループで利用可能」。

引数「groups」はグループ名のリストです。例: "["inotify", "augeas"]"はチェックします。
Linuxのinotify関数とAugeas（設定ファイル）の可用性について
編集機能を備えています。

コマンドは、次の場合にはエラーを返しません。 を 要求されたグループは利用可能です。

要求されたグループの1つ以上が利用できない場合はエラーが発生し、
アプライアンス。

グループのリストに不明なグループ名が含まれている場合は、常にエラーが発生します。
戻ってきた。

注意：

· "feature-available" はこの呼び出しと同じですが、API の使用が少し簡単になります。
その呼び出しは、エラーをスローする代わりに、ブール値の true/false を返します。

· この関数を呼び出す前に「launch」を呼び出す必要があります。

理由は、アプライアンス/デーモンがどのグループをサポートしているか分からないからです。
実行されてクエリできるようになるまで。

· 関数のグループが利用可能であっても、必ずしもそれらが
個々のAPI関数を呼び出す際にエラーをチェックする必要がある。
利用可能な場合。

· 完全な機能をディストリビューションパッケージに組み込むのは通常、ディストリビューションパッケージ作成者の仕事です。
libguestfsアプライアンス。アップストリームlibguestfs（すべての要件を満たしたソースからビルドした場合）
満足です、全てサポートします。

· この呼び出しはバージョン1.0.80で追加されました。libguestfsの以前のバージョンでは、
できることは、デーモンが
実装しました。「バージョン」も参照してください。

「filesystem-available」も参照してください。

すべてのグループで利用可能
すべてのグループで利用可能

このコマンドは、このデーモンが認識しているすべてのオプショングループのリストを返します。注
これはサポートされているグループとサポートされていないグループの両方を返します。デーモンがどのグループを見つけることができるかを知るには
実際にサポートするには、各メンバーで「available」/「feature-available」を呼び出す必要があります。
返されたリスト。

「available」、「feature-available」および「AVAILABILITY」も参照してください。 ゲストとします。

base64入力
base64-in (base64file|-) ファイル名

このコマンドは、base64でエンコードされたデータを「base64file」からアップロードします。 ファイル名.

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

base64出力
base64出力ファイル名 (base64file|-)

このコマンドは、 ファイル名ローカルファイル「base64file」に書き出します。
base64 としてエンコードされます。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

ブロック破棄
blkdiscardデバイス

これにより、ブロックデバイス「デバイス」上のすべてのブロックが破棄され、空き領域が
ホスト。

この操作には、libguestfs、ホストファイルシステム、qemu、ホストのサポートが必要です。
カーネル。このサポートがない場合、エラーが発生したり、実行しているように見えても実際には実行されないことがあります。
何もしません。また、基盤となるドライブに「discard」属性を設定する必要があります（「add-
ドライブオプション」を参照してください。

blkdiscardzeroes
blkdiscardzeroesデバイス

この呼び出しは、呼び出しによって破棄された「デバイス」上のブロックの場合にtrueを返します。
「blkdiscard」は、次回読み取られるときにゼロバイトのブロックとして返されます。

falseを返す場合、破棄されたブロックは古いものまたはランダムなものと読み取られている可能性があります。
データ。

blkid
blkidデバイス

このコマンドは、「デバイス」のブロックデバイス属性を返します。以下のフィールドは
返されるハッシュには通常存在します。他のフィールドも存在する場合があります。

「UUID」
このデバイスの UUID。

"ラベル"
このデバイスのラベル。

"バージョン"
blkid コマンドのバージョン。

"タイプ"
このデバイスのファイルシステムの種類または RAID。

"使用法"
このデバイスの使用法 (例:「ファイルシステム」または「raid」)。

ブロックデバイスフラッシュバッファ
blockdev-flushbufs デバイス

これはカーネルに、「デバイス」に関連付けられた内部バッファをフラッシュするように指示します。

これは ブロック開発（8）コマンド。

ブロックデバイス-getbsz
blockdev-getbszデバイス

これはデバイスのブロック サイズを返します。

注: これは両方とは異なります サイズ in ブロック 　 ファイルシステム コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の サイズ。 またこれ
この設定は実際には何にも使用されていません。おそらく何にも使用しない方が良いでしょう。
ファイルシステムには、選択するブロック サイズに関する独自の考え方があります。

これは ブロック開発（8）コマンド。

ブロックデブ-getro
blockdev-getroデバイス

ブロックデバイスが読み取り専用かどうかを示すブール値を返します（読み取り専用の場合はtrue、読み取り専用の場合はfalse）。
ない）。

これは ブロック開発（8）コマンド。

ブロックデバイス-getsize64
blockdev-getsize64 デバイス

これはデバイスのサイズをバイト単位で返します。

「blockdev-getsz」も参照してください。

これは ブロック開発（8）コマンド。

ブロックデバイス取得
blockdev-getssデバイス

ブロックデバイスのセクターサイズを返します。通常は512ですが、
最新のデバイス。

(注意: これはセクター単位のサイズではありません。セクター単位のサイズには「blockdev-getsz」を使用してください)。

これは ブロック開発（8）コマンド。

ブロックデバイス-getsz
blockdev-getszデバイス

これは、デバイスのサイズを512バイトセクター単位で返します（セクターサイズが
512 バイトではありません...奇妙です。

デバイスの実際のセクターサイズについては「blockdev-getss」、また「blockdev-getsize64」も参照してください。
より便利なもののために サイズ in バイト.

これは ブロック開発（8）コマンド。

ブロックデバイス再読み込み
blockdev-rereadptデバイス

「デバイス」のパーティション テーブルを再読み込みします。

これは ブロック開発（8）コマンド。

ブロックデバイスセットbsz
blockdev-setbsz デバイスのブロックサイズ

この呼び出しは何も実行せず、blockdev のバグのため、これまで何も実行されませんでした。 Do
つかいます ボーマンは

ファイルシステムのブロック サイズを設定する必要がある場合は、「mkfs」の「blocksize」オプションを使用します。

この function is 非推奨。 新しいコードでは、代わりに「mkfs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ブロックデブセトラ
blockdev-setraデバイスセクター

デバイスの先読み (512 バイト セクター単位) を設定します。

これは ブロック開発（8）コマンド。

ブロックデブセトロ
blockdev-setroデバイス

「device」という名前のブロックデバイスを読み取り専用に設定します。

これは ブロック開発（8）コマンド。

ブロックデバイス setrw
blockdev-setrwデバイス

「device」という名前のブロックデバイスを読み取り/書き込み可能に設定します。

これは ブロック開発（8）コマンド。

btrfsバランスキャンセル
btrfs-balance-cancel パス

btrfs ファイルシステム上の実行中の残高をキャンセルします。

btrfsバランス一時停止
btrfs-balance-pause パス

btrfs ファイルシステム上で実行中の残高を一時停止します。

btrfsバランス再開
btrfs-balance-resume パス

btrfs ファイルシステム上の一時停止されたバランスを再開します。

btrfsバランスステータス
btrfs-balance-status パス

btrfs ファイルシステム上の実行中または一時停止中のバランスのステータスを表示します。

btrfsデバイスの追加
btrfs-device-add 'デバイス...' fs

「devices」内のデバイスのリストを「fs」にマウントされたbtrfsファイルシステムに追加します。
「devices」は空のリストなので、何も起こりません。

btrfsデバイスの削除
btrfs-device-delete 'デバイス...' fs

「fs」にマウントされたbtrfsファイルシステムから「devices」を削除します。「devices」が空の場合
リストでは何も起こりません。

btrfsファイルシステムのバランス
btrfsバランス
btrfsファイルシステムバランスfs

基盤となるデバイス間で、「fs」にマウントされた btrfs ファイルシステム内のチャンクをバランスさせます。

btrfsファイルシステムのデフラグ
btrfs-ファイルシステムのデフラグパス [flush:true|false] [compress:..]

btrfs ファイルシステム上のファイルまたはディレクトリをデフラグします。compress は zlib または lzo のいずれかです。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfsファイルシステムのサイズ変更
btrfs-filesystem-resize マウントポイント [サイズ:N]

このコマンドは、btrfs ファイルシステムのサイズを変更します。

他のサイズ変更呼び出しとは異なり、ファイルシステムがマウントされている必要があり、パラメータは
デバイスではなくマウントポイント (これは btrfs 自体の要件です)。

オプションのパラメータは次のとおりです。

"サイズ"
ファイルシステムの新しいサイズ（バイト単位）。省略した場合、ファイルシステムは次のようにサイズ変更されます。
最大サイズ。

参照 BTRFSとします。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfsファイルシステム同期
btrfs-ファイルシステム同期fs

「fs」にマウントされた btrfs ファイルシステムの同期を強制します。

btrfs-fsck
btrfs-fsck デバイス [スーパーブロック:N] [修復:true|false]

btrfsファイルシステムをチェックするために使用されます。「デバイス」はファイルシステムが存在するデバイスファイルです。
保存されます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfsイメージ
btrfs-image 'ソース ...' イメージ [圧縮レベル:N]

これはbtrfsファイルシステムのイメージを作成するために使用されます。すべてのデータはゼロで初期化されますが、
メタデータなどは保存されます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfs-qgroup-assign
btrfs-qgroup-assign src dst パス

qgroup「src」を親qgroup「dst」に追加します。このコマンドは複数のqgroupを1つのグループにまとめることができます。
共通の制限を共有する親 qgroup。

btrfs-qgroup-create
btrfs-qgroup-create qgroupid サブボリューム

「subvolume」にサブボリュームのクォータ グループ (qgroup) を作成します。

btrfs-qgroup-destroy
btrfs-qgroup-destroy qgroupid サブボリューム

クォータ グループを破棄します。

btrfs-qgroup-limit
btrfs-qgroup-limit サブボリューム サイズ

パスが「subvolume」であるサブボリュームのサイズを制限します。「size」には G、M などの接尾辞を付けることができます。
またはK。

btrfs-qgroup-remove
btrfs-qgroup-remove src dst パス

親 qgroup "dst" から qgroup "src" を削除します。

btrfs-qgroup-show
btrfs-qgroup-show パス

btrfs ファイルシステム内のすべてのサブボリューム クォータ グループとその使用状況を表示します。

btrfsクォータを有効にする
btrfs-quota-enable fs 真|偽

「path」を含むファイルシステムのサブボリューム クォータ サポートを有効または無効にします。

btrfsクォータ再スキャン
btrfs-quota-rescan fs

すべての qgroup 番号を破棄し、現在の構成でメタデータを再度スキャンします。

btrfs-replace
btrfs-replace srcdev targetdev mntpoint

btrfsファイルシステムのデバイスを交換します。ライブファイルシステムでは、データを複製し、
ターゲットデバイスに現在ソースデバイスに保存されているデータ。完了後
この操作を実行すると、ソースデバイスは消去され、ファイルシステムから削除されます。

「targetdev」は「srcdev」と同じかそれ以上のサイズである必要があります。
現在マウントされているデバイスは、「targetdev」として使用することはできません。

btrfs レスキュー チャンク リカバリ
btrfs-rescue-chunk-recoverデバイス

デバイスを 1 つずつスキャンして、btrfs ファイルシステムのチャンク ツリーを回復します。

btrfs-rescue-super-recover
btrfs-rescue-super-recover デバイス

正常なコピーから不良スーパーブロックを回復します。

btrfs-スクラブ-キャンセル
btrfs-scrub-cancel パス

btrfs ファイルシステムで実行中のスクラブをキャンセルします。

btrfs スクラブ再開
btrfs-scrub-resume パス

btrfs ファイルシステム上で以前にキャンセルまたは中断されたスクラブを再開します。

btrfs-スクラブ開始
btrfs-scrub-start パス

ファイルシステム上のすべてのデータとメタデータを読み取り、チェックサムと重複データを使用します。
RAID ストレージからコピーして、破損したデータを識別して修復します。

btrfsスクラブステータス
btrfs-scrub-status パス

btrfs ファイルシステム上で実行中または完了したスクラブのステータスを表示します。

btrfs-set-seeding
btrfs-set-seedingデバイス true|false

btrfs ファイルシステムを含むデバイスのシード機能を有効または無効にします。

btrfsサブボリュームの作成
btrfs サブボリューム作成オプション
btrfs-サブボリューム-作成先 [qgroupid:..]

btrfsサブボリュームを作成します。「dest」引数は保存先ディレクトリで、名前は
サブボリュームの形式 /path/to/dest/nameオプションパラメータ「qgroupid」
新しく作成されたサブボリュームが追加される qgroup を表します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfsサブボリュームの削除
btrfs-subvolume-サブボリュームの削除

名前付き btrfs サブボリュームまたはスナップショットを削除します。

btrfs サブボリュームのデフォルト取得
btrfs サブボリュームのデフォルトファイルシステムの取得

「マウントポイント」にマウントされたファイルシステムのデフォルトのサブボリュームまたはスナップショットを取得します。

btrfsサブボリュームリスト
btrfsサブボリュームリストfs

「fs」にマウントされている btrfs ファイルシステムの btrfs スナップショットとサブボリュームを一覧表示します。

btrfsサブボリュームセットのデフォルト
btrfs サブボリュームセットのデフォルト ID fs

デフォルトでマウントされるbtrfsファイルシステムのサブボリューム「fs」を設定します。
「btrfs-subvolume-list」でサブボリュームのリストを取得します。

btrfs サブボリューム表示
btrfs-サブボリューム-サブボリュームを表示

サブボリュームの詳細情報を返します。

btrfs サブボリューム スナップショット
btrfsサブボリュームスナップショットオプション
btrfs サブボリューム スナップショットのソース宛先 [ro:true|false] [qgroupid:..]

btrfsサブボリューム「source」のスナップショットを作成します。「dest」引数は保存先です。
ディレクトリとスナップショットの名前を次の形式で指定します。 /path/to/dest/name。 デフォルトでは
新しく作成されたスナップショットは書き込み可能であり、オプションパラメータ「ro」の値がtrueの場合、
読み取り専用スナップショットが作成されます。オプションパラメータ「qgroupid」は、qgroupを表します。
新しく作成されたスナップショットが追加されます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

btrfstune 拡張 inode 参照を有効にする
btrfstune-enable-extended-inode-refsデバイス

これにより、拡張 inode 参照が有効になります。

btrfstune でスキニーメタデータエクステント参照を有効にする
btrfstune-enable-skinny-metadata-extent-refsデバイス

これにより、スキニー メタデータ エクステント参照が有効になります。

btrfstune-シーディング
btrfstune-seedingデバイス true|false

btrfsデバイスのシードを有効にすると、fsが読み取り専用になり、次の用途に使用できるようになります。
他のファイルシステムを構築します。

Cポインタ
Cポインタ

C言語以外のバインディングでは、これにより、
ハンドル（つまり「h *」）を使用します。これは、他のライブラリが相互に連携できるようにするためです。
libguestfs。

正規デバイス名
正規デバイス名デバイス

このユーティリティ関数は、デバイス名をユーザーに表示するときに役立ちます。
不規則なデバイス名の数を、一貫した形式で返します。

/ dev / hdX
/dev/vdX
これらは次のように返されます / dev / sdXこれはデバイス名とパーティション名にも適用されます。
これは「ブロックデバイスの命名」で説明されているアルゴリズムのほぼ逆です。
in ゲストとします。

/dev/mapper/VG-LV
/dev/dm-N
に変換 / dev / VG / LV 「lvm-canonical-lv-name」を使用する形式。

その他の文字列は変更されずに返されます。

キャップ取得ファイル
cap-get-file パス

この関数は、"path"に付与されたLinuxのケーパビリティを返します。ケーパビリティセットは
テキスト形式で返されます（ テキストのキャップ（3））。

ファイルに機能が添付されていない場合は、空の文字列が返されます。

キャップ セット ファイル
cap-set-file パス キャップ

この関数は、"path"に付与されたLinuxの権限を設定します。権限は"cap"に設定されます。
テキスト形式で渡す必要があります（ キャップからのテキスト（3））。

大文字と小文字を区別するパス
大文字と小文字を区別するパス

これは、大文字と小文字を区別しないファイルシステム上のパスを解決するために使用できます。
敏感です。使用例は、Windowsから読み込んだパスを解決することです
構成ファイルまたは Windows レジストリを実際のパスに変更します。

このコマンドはLinux ntfs-3gファイルシステムドライバの特殊性（おそらく
つまり、基盤となるファイルシステムは大文字と小文字を区別しませんが、ドライバは
大文字と小文字を区別してファイルシステムを Linux にエクスポートします。

その結果、次のような特別なディレクトリが C:\windows として表示される場合があります
/ウィンドウズ or /ウィンドウズ （または他のもの）は、どのように行われたかの正確な詳細に応じて
作成されました。Windows 自体では、これは問題にはなりません。

バグか機能か？決めるのはあなたです: http://www.tuxera.com/community/ntfs-3g-faq/#posixファイル名1

「case-sensitive-path」は、パス内の各要素の大文字と小文字を区別して解決しようとします。
フルパスまたはその親ディレクトリが存在する場合、解決されたパスを返します。
親ディレクトリは存在するがフルパスがない場合は、親ディレクトリの場合は
正しく解決され、残りは変更されずに追加されます。例えば、ファイル
「/Windows/System32/netkvm.sys」が存在します:

「大文字と小文字を区別するパス」（「/windows/system32/netkvm.sys」）
「Windows/System32/netkvm.sys」

「大文字と小文字を区別するパス」（「/windows/system32/NoSuchFile」）
「Windows/System32/NoSuchFile」

「大文字と小文字を区別するパス」（「/windows/system33/netkvm.sys」）
ERROR

注意: 上記の動作のため、「case-sensitive-path」は、
ファイルの存在。

注意: この関数はドライブ名やバックスラッシュなどを処理しません。

「realpath」も参照してください。

cat
猫の道

「path」という名前のファイルの内容を返します。

Cではこの関数は「char *」を返すため、
ファイル内の「\0」文字と文字列の末尾。バイナリファイルを扱うには、「read-file」を使用してください。
または「ダウンロード」機能。

チェックサム
チェックサム csumtype パス

この呼び出しは、「path」という名前のファイルの MD5、SHAx、または CRC チェックサムを計算します。

計算するチェックサムの種類は「csumtype」パラメータで指定します。
次の値の：

「CRC」
「cksum」コマンドに対して POSIX で指定された巡回冗長検査 (CRC) を計算します。

「md5」
MD5 ハッシュを計算します (「md5sum」プログラムを使用)。

「sha1」
SHA1 ハッシュを計算します (「sha1sum」プログラムを使用)。

「sha224」
SHA224 ハッシュを計算します (「sha224sum」プログラムを使用)。

「sha256」
SHA256 ハッシュを計算します (「sha256sum」プログラムを使用)。

「sha384」
SHA384 ハッシュを計算します (「sha384sum」プログラムを使用)。

「sha512」
SHA512 ハッシュを計算します (「sha512sum」プログラムを使用)。

チェックサムは印刷可能な文字列として返されます。

デバイスのチェックサムを取得するには、「checksum-device」を使用します。

多数のファイルのチェックサムを取得するには、「checksums-out」を使用します。

チェックサムデバイス
チェックサムデバイス csumtype デバイス

この呼び出しは、指定されたデバイスの内容のMD5、SHAx、またはCRCチェックサムを計算します。
「デバイス」。サポートされているチェックサムの種類については、「チェックサム」コマンドを参照してください。

チェックサム出力
チェックサム出力 csumtype ディレクトリ (sumsfile|-)

このコマンドは、すべての通常ファイルのチェックサムを計算します。 ディレクトリにジョブを開始します。 そして、
これらのチェックサムのリストをローカル出力ファイル「sumsfile」に出力します。

これは仮想マシンの整合性を検証するために使用できます。ただし、正しく
安全のためには、チェックサムコマンドの出力に注意する必要があります（これは、
GNU coreutilsから）。特にファイル名が印刷できない場合、coreutilsは
特殊なバックスラッシュ構文。詳細については、GNU coreutils の info ファイルを参照してください。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

chmod
chmodモードパス

「path」のモード（権限）を「mode」に変更します。数値モードのみがサポートされています。

注意: guestfishからこのコマンドを使用する場合、「mode」はデフォルトで10進数になります。
0 進数にするには、先頭に 0700 を付けます。つまり、700 ではなく XNUMX を使用します。

実際に設定されるモードは umask によって影響を受けます。

chown
chown 所有者グループパス

ファイルの所有者を「owner」に、グループを「group」に変更します。

数値のUIDとGIDのみがサポートされています。名前を使用する場合は、
パスワード ファイルを自分で解析します (Augeas サポートにより、これは比較的簡単に行えます)。

バックエンド設定をクリアする
クリアバックエンド設定名

「name」に一致するか「name=」で始まるバックエンド設定文字列がある場合、
文字列はバックエンド設定から削除されます。

この呼び出しは、削除された文字列の数を返します（0、1、またはそれ以上の可能性があります）。
1 より小さい)。

「バックエンド」を参照してください ゲスト（３）「バックエンド設定」 ゲストとします。

command
コマンド '引数...'

この呼び出しはゲストファイルシステムからコマンドを実行します。ファイルシステムはマウントされている必要があり、
互換性のあるオペレーティングシステム（Linuxなど）を搭載している必要があります。
互換性のあるプロセッサ アーキテクチャ)。

単一のパラメータはargv形式の引数リストです。最初の要素は
実行するプログラム。後続の要素はパラメータです。リストは空であってはいけません（つまり、
プログラム名を含める必要があります。コマンドは直接実行され、 経由して呼び出される
シェル（「sh」を参照）。

戻り値は、 (Linuxで言うところのstdout） コマンドによって。

コマンドがゼロ以外の終了ステータスを返す場合、この関数はエラーを返します。
メッセージ。エラーメッセージ文字列は、 stderr コマンドから。

$PATH環境変数には少なくとも / usr / bin 　 / binに. 必要な場合は
別の場所からプログラムを実行する場合は、最初のパラメータに完全なパスを指定する必要があります。

プログラムに必要な共有ライブラリとデータファイルはファイルシステム上で利用可能でなければならない
正しい位置に取り付けられていることを確認してください。発信者は、すべての
必要なファイルシステムが適切な場所にマウントされます。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

コマンドライン
コマンドラインの「引数...」

これは「コマンド」と同じですが、結果を行のリストに分割します。

参照：「sh-lines」

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

圧縮デバイス出力
compress-device-out ctypeデバイス (zdevice|-) [レベル:N]

このコマンドは、「device」を圧縮し、ローカル ファイル「zdevice」に書き出します。

「ctype」およびオプションの「level」パラメータは、「compress-out」の場合と同じ意味を持ちます。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

圧縮アウト
ctypeファイルを圧縮出力（zfile|-） [レベル:N]

このコマンドは圧縮します file それをローカルファイルに書き出す zファイル.

使用される圧縮プログラムは「ctype」パラメータによって制御されます。現在、この
「compress」、「gzip」、「bzip2」、「xz」、「lzop」などが含まれます。一部の圧縮形式はサポートされない場合があります。
libguestfsの特定のビルドでサポートされています。その場合はエラーが発生します。
「サポートされていません」という部分文字列が含まれます。

オプションの「level」パラメータは圧縮レベルを制御します。
このパラメータは、使用されている圧縮プログラムによって異なります。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

設定
config hvparam hvvalue

これは、以下の形式の任意のハイパーバイザーパラメータを追加するために使用できます。 -パラメータ 値.
実際には、それは完全に恣意的ではありません。いくつかのパラメータを設定することはできません。
私たちが使用するパラメータに干渉することになります。

「hvparam」文字列の最初の文字は「-」(ダッシュ) である必要があります。

「hvvalue」は NULL にすることができます。

コピー属性
コピー属性 src dest [all:true|false] [mode:true|false] [xattributes:true|false] [ownership:true|false]

パス (ファイルまたはディレクトリ) の属性を別のパスにコピーします。

デフォルトでは「no」属性はコピーされないので、コピーする場合は必ずany（または「all」）を指定してください。
すべての）。

オプションの引数は、コピーできる属性を指定します。

"モード"
ファイルモードの一部を「ソース」から「宛先」にコピーします。UNIXパーミッションのみ
また、sticky/setuid/setgid ビットをコピーすることもできます。

「xattributes」
Linux拡張属性（xattrs）を「source」から「destination」にコピーします。このフラグは
何もしない場合は Linux属性 機能は利用できません (「feature-available」を参照)。

"所有"
「source」の所有者 uid とグループ gid を「destination」にコピーします。

"すべて"
コピー を 「ソース」から「宛先」までの属性を設定します。これを有効にすると、
まだ指定されていない場合は他のフラグ。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

デバイス間のコピー
デバイス間のコピー src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [append:true|false]

4つの呼び出し「copy-device-to-device」、「copy-device-to-file」、「copy-file-to-device」、および
「ファイルからファイルへのコピー」を使用すると、ソース（デバイス|ファイル）から宛先にコピーできます。
（デバイス|ファイル）。

コピー元オフセット、コピー先をオプションで指定できるので、部分的なコピーも可能
コピーするオフセットとサイズ。これらの値はすべてバイト単位で指定します。指定しない場合は、
オフセットは両方ともデフォルトでゼロに設定され、サイズは可能な限りコピーされるようになります。
ソースの終わりに到達しました。

ソースとターゲットは同じオブジェクトである可能性があります。ただし、重複領域は
正しくコピーされました。

宛先がファイルの場合、必要に応じて作成されます。宛先ファイルがない場合は
十分な大きさなので拡張します。

宛先がファイルであり、「追加」フラグが設定されていない場合、宛先ファイルは
切り捨てられます。「append」フラグが設定されている場合は、コピーは宛先ファイルに追加されます。
現在、デバイスに対して「追加」フラグを設定することはできません。

「sparse」フラグがtrueの場合、呼び出しはゼロのみを含むブロックの書き込みを回避します。
これは、バックアップディスクがシンプロビジョニングされている場合に役立ちます。
ターゲットがすでにゼロ化されていない限り、このオプションを使用すると、コピーが正しく行われません。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

デバイスからファイルへのコピー
コピーデバイスからファイルへ src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [append:true|false]

この呼び出しの概要については、「copy-device-to-device」を参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ファイルをデバイスにコピーする
ファイルのデバイスへのコピー src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [append:true|false]

この呼び出しの概要については、「copy-device-to-device」を参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ファイルからファイルへのコピー
ファイルの複製 src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [append:true|false]

この呼び出しの概要については、「copy-device-to-device」を参照してください。

これは ファイルのコピーに必要な機能。これは、ブロックをコピーするためのものです。
既存のファイル。一般的なファイルのコピーおよび移動機能については、「cp」、「cp-a」、「mv」を参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

コピーサイズ
コピーサイズ src dest サイズ

このコマンドは、1つのソースデバイスまたはファイル「src」から別のソースデバイスまたはファイルへ正確に「size」バイトをコピーします。
宛先デバイスまたはファイル「dest」。

ソースが短すぎる場合、または宛先が十分な大きさでない場合、これは失敗することに注意してください。

この function is 非推奨。 新しいコードでは、代わりに「copy-device-to-device」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

cp
cp ソース 宛先

これはファイルを「src」から「dest」にコピーします。「dest」はコピー先のファイル名または
宛先ディレクトリ。

cp-a
cp-a ソース 宛先

これは「cp -a」を使用して「src」から「dest」にファイルまたはディレクトリを再帰的にコピーします。


CP-R
cp-r ソース 宛先

これは「cp -rP」を使用してファイルまたはディレクトリを「src」から「dest」に再帰的にコピーします。


ほとんどのユーザーは代わりに「cp-a」を使うべきです。このコマンドは、
ターゲットファイルシステムがそれをサポートしていないため、パーミッションを保持します（主に
DOS FAT ファイルシステムへの書き込み)。

cpio出力
cpio出力ディレクトリ (cpiofile|-) [形式:..]

このコマンドは、 ディレクトリにジョブを開始します。 それをローカルファイル「cpiofile」にダウンロードします。

オプションの「format」パラメータを使用してフォーマットを選択できます。以下の場合にのみ
現在許可されている形式は次のとおりです:

「ニューク」
新しい（SVR4）ポータブルフォーマット。このフォーマットはcpioのようなフォーマットと互換性があります。
Linux カーネルが initramfs に使用する形式。

これがデフォルトの形式です。

「CRC」
チェックサム付きの新しい (SVR4) ポータブル フォーマット。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

dd
dd ソース 宛先

このコマンドは、1つのソースデバイスまたはファイル「src」から別の宛先デバイスまたはファイルにコピーします。
ファイル「dest」。通常、デバイスやパーティションへのコピーや、デバイスやパーティションからのコピーに使用します。
ファイルシステムを複製する例。

宛先がデバイスの場合、ソースファイルと同じかそれより大きいサイズである必要があります。
コピーに失敗します。このコマンドは部分的なコピーは行えません（「コピー」を参照）。
デバイス間通信)。

この function is 非推奨。 新しいコードでは、代わりに「copy-device-to-device」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

デバイスインデックス
デバイスインデックスデバイス

この関数はデバイス名（例：「/dev/sdb」）を受け取り、デバイスのインデックスを返します。
デバイスのリスト。

インデックス番号は0から始まります。指定されたデバイスは、例えば返される文字列として存在している必要があります。
「list-devices」から。

「list-devices」、「part-to-dev」も参照してください。

df
df

このコマンドは、「df」コマンドを実行して、使用されているディスク容量を報告します。

このコマンドは主に対話型セッションで役立ちます。 試してみることを意図した
出力文字列を解析します。プログラムからは「statvfs」を使用してください。

df-h
df-h

このコマンドは、「df -h」コマンドを実行して、使用されているディスク容量を人間が読める形式で報告します。

このコマンドは主に対話型セッションで役立ちます。 試してみることを意図した
出力文字列を解析します。プログラムからは「statvfs」を使用してください。

ディスク作成
ディスク作成ファイル名フォーマットサイズ[backingfile:..] [backingformat:..] [preallocation:..] [compat:..] [clustersize:N]

空のディスクイメージを作成します ファイル名 （ホストファイル）形式「format」（通常は
（「raw」または「qcow2」）サイズは「size」バイトです。

オプションの「backingfile」パラメータと一緒に使用すると、スナップショットは
バックアップファイル。この場合、「size」には「-1」を渡す必要があります。スナップショットのサイズは
自動的に検出されるバックアップファイルのサイズと同じです。
「backingfile」の形式を記述するために「backingformat」も渡すことをお勧めします。

If ファイル名 ブロックデバイスを参照する場合、デバイスはフォーマットされます。「サイズ」は無視されます
ブロックデバイスには固有のサイズがあるためです。

その他のオプションパラメータは次のとおりです。

「事前割り当て」
フォーマットが「raw」の場合、これは「off」（または「sparse」）または「full」のいずれかで作成できます。
それぞれスパースファイルまたは完全割り当てファイルです。デフォルトは「オフ」です。

フォーマットが「qcow2」の場合、これは「オフ」（または「スパース」、「メタデータ」、または「フル」になります。
メタデータを事前に割り当てると、大量の書き込みを行うときに速度が速くなりますが、使用するスペースも多くなります。
デフォルトは「オフ」です。

「コンパット」
"qcow2"のみ: qemuでサポートされている高度なqcow1.1形式を使用するには、文字列2を渡します≥
1.1.

「クラスタサイズ」
「qcow2」のみ: qcow2のクラスタサイズを変更します。デフォルトは65536（バイト）です。
設定は 512 から 2097152 までの XNUMX の累乗になります。

この呼び出しでは、新しいディスクがハンドルに追加されるわけではないことに注意してください。「add-
「drive-opts」を別途指定します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ディスクフォーマット
ディスク形式のファイル名

ディスクイメージのフォーマットを検出して返す ファイル名. ファイル名 することもできます
ホストデバイスなど。画像のフォーマットが検出できなかった場合は、「不明」となります。
戻ってきた。

ディスクフォーマットの検出は、状況によっては安全ではない場合があることに注意してください。
「CVE-2010-3851」 ゲストとします。

参照: 「ディスクイメージフォーマット」 ゲスト(3)

ディスクにはバッキングファイルがあります
ディスクにバックアップファイルがあるファイル名

ディスクイメージが ファイル名 バックアップファイルがあります。

ディスク機能の検出は、状況によっては安全ではない場合があることに注意してください。
「CVE-2010-3851」 ゲストとします。

ディスク仮想サイズ
ディスク仮想サイズファイル名

ディスクイメージの仮想サイズをバイト単位で検出して返します。 ファイル名.

ディスク機能の検出は、状況によっては安全ではない場合があることに注意してください。
「CVE-2010-3851」 ゲストとします。

dmesg
dmesg

これはゲストカーネルからのカーネルメッセージ（「dmesg」出力）を返します。これは
問題の拡張デバッグに役立つ場合があります。

同じ情報を取得する別の方法は、「set-verbose」で詳細メッセージを有効にすることです。
または、プログラムを実行する前に環境変数「LIBGUESTFS_DEBUG=1」を設定します。

ダウンロード
ダウンロード リモートファイル名 (ファイル名|-)

ファイルをダウンロード リモートファイル名 保存する ファイル名 ローカルマシン上。

ファイル名 名前付きパイプにすることもできます。

「upload」、「cat」も参照してください。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

ダウンロードオフセット
ダウンロードオフセット リモートファイル名 (ファイル名|-) オフセットサイズ

ファイルをダウンロード リモートファイル名 保存する ファイル名 ローカルマシン上。

リモートファイル名 「オフセット」から始まる「サイズ」バイトが読み取られます（この領域は
ファイルまたはデバイス)。

この呼び出しでダウンロードできるデータの量には制限がないことに注意してください。
「pread」とは異なり、この呼び出しではエラーが発生しない限り常に全額が読み取られます。

「download」、「pread」も参照してください。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

ドロップキャッシュ
ドロップキャッシュ whattodrop

これは、ゲスト カーネルにページ キャッシュ、および/または dentry と inode キャッシュを削除するように指示します。
パラメータ「whattodrop」はカーネルに何をドロップするかを正確に指示します。
http://linux-mm.org/Drop_Caches

「whattodrop」を 3 に設定すると、すべてがドロップされます。

これは自動的に sync（２）操作前に、ゲストメモリが最大になるように
解放されました。

du
デュパス

このコマンドは、「du -s」コマンドを実行して、「path」のファイルスペース使用量を推定します。

「パス」はファイルまたはディレクトリです。「パス」がディレクトリの場合、推定には以下が含まれます。
ディレクトリとすべてのサブディレクトリの内容 (再帰的)。

その結果は、 キロバイト (つまり、1024 バイト単位)。

e2fsck
e2fsckデバイス [correct:true|false] [forceall:true|false]

これは「デバイス」上でext2/ext3ファイルシステムチェッカーを実行します。以下のコマンドを実行できます。
オプションの引数：

"正しい"
ファイルシステムを自動的に修復します。このオプションを選択すると、e2fsckは自動的に
人間の介入なしに安全に修正できるファイルシステムの問題を修正します。

このオプションは、「forceall」オプションと同時に指定することはできません。

「フォースオール」
すべての質問に「はい」と答えると仮定します。e2fsckを非セキュアモードで使用できるようにします。
インタラクティブに。

このオプションは、「正しい」オプションと同時に指定することはできません。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

e2fsck-f
e2fsck-fデバイス

これは「e2fsck -p -f device」を実行します。つまり、「device」上でext2/ext3ファイルシステムチェッカーを実行します。
非対話型（-p）、ファイルシステムがクリーンに見えても（-f).

この function is 非推奨。 新しいコードでは、代わりに「e2fsck」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

エコーデーモン
echo-daemon 'words ...'

このコマンドは、渡された「単語」のリストを、間に1つのスペースを入れて連結し、
結果の文字列を返します。

このコマンドを使用して、デーモンへの接続をテストできます。

「ping-daemon」も参照してください。

egrep
egrep 正規表現パス

これは外部の「egrep」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

エグレピ
egrepi 正規表現パス

これは外部の「egrep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

等しい
ファイル1とファイル2が等しい

これは2つのファイルを比較します file1 　 file2 内容が正確に一致する場合はtrueを返します
等しい場合は false、そうでない場合は false になります。

外部 CMP（１）プログラムを比較に用いた。

存在
パスが存在する

これは、指定されたファイル、ディレクトリ（または何か）が存在する場合にのみ「true」を返します。
「パス」名。

「is-file」、「is-dir」、「stat」も参照してください。

extlinux
extlinuxディレクトリ

マウントされたデバイスにSYSLINUXブートローダーをインストールします。 ディレクトリにジョブを開始します。「syslinux」とは異なり
FAT ファイルシステムが必要ですが、ext2/3/4 または btrfs ファイルシステムでも使用できます。

当学校区の ディレクトリにジョブを開始します。 パラメータにはマウントポイント、またはマウントポイント内のディレクトリのいずれかを指定できます。

また、パーティションを「アクティブ」（「part-set-bootable」）としてマークし、マスターブートを設定する必要があります。
レコードは全体の最初のセクターにインストールする必要があります（例：「pwrite-device」を使用）。
ディスク。SYSLINUXパッケージには、適切なマスターブートレコードがいくつか付属しています。
extlinux（1）詳細についてはmanページを参照してください。

SYSLINUXに追加の設定をするには、次のファイルを置く必要があります。
extlinux.conf ファイルシステム上の ディレクトリにジョブを開始します。詳細については、
このファイルの内容については、 extlinuxとします。

「syslinux」も参照してください。

ファロケート
fallocate パス長

このコマンドは、サイズが「len」バイトの「path」という名前のファイル (0 バイトを含む) を事前に割り当てます。
ファイルがすでに存在する場合は上書きされます。

これを、guestfish特有の「alloc」コマンドと混同しないでください。このコマンドは、
ホストに接続し、デバイスとして接続します。

この function is 非推奨。 新しいコードでは、代わりに "fallocate64" 呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ファロケート64
fallocate64 パス長

このコマンドは、サイズが「len」バイトの「path」という名前のファイル (0 バイトを含む) を事前に割り当てます。
ファイルがすでに存在する場合は上書きされます。

この呼び出しはファイル用のディスクブロックを割り当てることに注意してください。スパースファイルを作成するには、
代わりに「truncate-size」を使用してください。

非推奨の呼び出し「fallocate」も同様の機能を果たすが、見落としにより、
30ビットの長さを指定することにより、作成されるファイルの最大サイズを効果的に制限します。
その呼び出しを通じて 1GB になります。

これをguestfish特有の「alloc」や「sparse」コマンドと混同しないでください。
ホスト内のファイルをデバイスとして接続します。

機能-利用可能
機能が利用可能な「グループ...」

これは「available」と同じですが、その呼び出しとは異なり、単純なtrue/falseを返します。
機能が見つからない場合に例外をスローするのではなく、ブール値の結果を返します。その他の
ドキュメントについては「利用可能」を参照してください。

fgrep
fgrepパターンパス

これは外部の「fgrep」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

fgrepi
fgrepiパターンパス

これは外部の「fgrep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

file
ファイルパス

この呼び出しは標準の file（１）ファイルの種類や内容を確認するコマンド。

この呼び出しでは、さまざまな種類の圧縮ファイルの内部も透過的に確認されます。

実行されるコマンドは「file -zb path」です。特にファイル名が
出力の先頭に追加されない（ -b オプション）。

出力は基礎となる file（１）コマンドと変更可能
将来は私たちの制御を超えた方法で変化します。言い換えれば、出力は保証されていません。
アビ。

も参照してください。 file（1）、「vfs-type」、「lstat」、「is-file」、「is-blockdev」（など）、「is-zero」。

ファイルアーキテクチャ
ファイルアーキテクチャファイル名

これはバイナリのアーキテクチャを検出します ファイル名、既知の場合はそれを返します。

現在定義されているアーキテクチャは次のとおりです。

「i386」
この文字列は、すべての32ビットi386、i486、i586、i686バイナリに返されます。
バイナリの正確なプロセッサ要件。

「x86_64」
64 ビット x86-64。

「スパルク」
32 ビット SPARC。

「sparc64」
64 ビット SPARC V9 以上。

「ia64」
インテル Itanium。

「ppc」
32 ビット Power PC。

「ppc64」
64 ビット Power PC。

"アーム"
32 ビット ARM。

「aarch64」
64 ビット ARM。

Libguestfs は将来的に他のアーキテクチャ文字列を返す可能性があります。

この機能は、少なくとも次の種類のファイルで動作します。

· さまざまな種類の Un*x および Linux バイナリ

· さまざまな種類の Un*x および Linux 共有ライブラリ

· Windows Win32 および Win64 バイナリ

· Windows Win32 および Win64 DLL

Win32 バイナリと DLL は "i386" を返します。

Win64 バイナリと DLL は "x86_64" を返します。

· Linuxカーネルモジュール

· Linux の新しいスタイルの initrd イメージ

· 一部の非x86 Linux vmlinuzカーネル

現在できないこと:

· 静的ライブラリ (libfoo.a)

· Linux の旧式の initrd を圧縮された ext2 ファイルシステムとして (RHEL 3)

· x86 Linux vmlinuz カーネル

x86 vmlinuzイメージ（bzImage形式）は、16ビット、32ビット、圧縮されたコードの組み合わせで構成されています。
そして、解読するのは非常に困難です。カーネルのアーキテクチャを知りたい場合は、
代わりに、関連付けられている initrd またはカーネル モジュールのアーキテクチャを使用します。

ファイルサイズ
ファイルサイズ

このコマンドは、 file バイト単位。

ファイルに関する他の統計情報を取得するには、「stat」、「lstat」、「is-dir」、「is-file」などを使用します。
ブロックデバイスのサイズを調べるには、「blockdev-getsize64」を使用します。

ファイルシステム-利用可能
ファイルシステム利用可能なファイルシステム

libguestfsが指定されたファイルシステムをサポートしているかどうかを確認します。引数「filesystem」は
ファイルシステム名（「ext3」など）。

このコマンドを使用する前に「launch」を呼び出す必要があります。

これは主に否定テストとして役立ちます。これが真を返したとしても、
特定のファイルシステムを作成またはマウントすることはできません。ファイルシステムは他のファイルシステムでは失敗する可能性があるためです。
ファイルシステムの新しいバージョンである、または互換性がないなどの理由により、
機能が不足しているか、適切な mkfs が不足しています。fs> ツール。

「available」、「feature-available」、「AVAILABILITY」も参照してください。 ゲストとします。

埋める
塗りつぶし c len パス

このコマンドは「path」という新しいファイルを作成します。ファイルの初期内容は「len」です。
「c」のオクテット。「c」は「[0..255]」の範囲の数値でなければなりません。

ファイルをゼロバイト（まばらに）で埋めるには、「truncate-
「サイズ」。バイトを繰り返すパターンを持つファイルを作成するには、「fill-pattern」を使用します。

フィルディレクトリ
fill-dir ディレクトリ番号

この関数はファイルシステムのテストに役立ち、ディレクトリに「nr」個の空のファイルを作成します。
「dir」は00000000から「nr-1」までの名前を持ちます（つまり、各ファイル名は8桁で、
ゼロ)。

塗りつぶしパターン
塗りつぶしパターン パターン長さ パス

この関数は「fill」に似ていますが、長さ「len」の新しいファイルを作成し、
「パターン」内のバイトの繰り返しパターン。必要に応じてパターンは切り捨てられる。
ファイルの長さが正確に「len」バイトであることを確認します。

find
ディレクトリを見つける

このコマンドは、以下のファイルとディレクトリを再帰的にリストします。 ディレクトリにジョブを開始します。。 それ
シェルコマンド「find directory -print」を実行するのと本質的に同じですが、
出力に対して後処理が行われます。詳細は以下を参照してください。

これは文字列のリストを返します 無し どれか 接頭辞. つまり、ディレクトリ構造が次のようになっているとします。

/tmp/a
/tmp/b
/tmp/c/d

「find」から返されたリスト / tmpに 4つの要素になります:

a
b
c
CD

If ディレクトリにジョブを開始します。 ディレクトリでない場合、このコマンドはエラーを返します。

返されるリストはソートされています。

見つける0
find0 ディレクトリ (ファイル|-)

このコマンドは、以下のファイルとディレクトリを再帰的にリストします。 ディレクトリにジョブを開始します。,
結果のリストを外部ファイルに格納する ファイル.

このコマンドは、次の例外を除いて「find」と同じように動作します。

· 結果のリストは外部ファイルに書き込まれます。

· 結果内の項目（ファイル名）は「\0」文字で区切られます。 find（1）オプション
-print0.

· 結果リストはソートされていません。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

findfs-ラベル
findfs-label ラベル

このコマンドはファイルシステムを検索し、指定されたラベルを持つファイルシステムを返します。
そのようなファイルシステムが見つからない場合はエラーが返されます。

ファイルシステムのラベルを見つけるには、「vfs-label」を使用します。

findfs-uuid
findfs-uuid uuid

このコマンドはファイルシステムを検索し、指定されたUUIDを持つファイルシステムを返します。
そのようなファイルシステムが見つからない場合はエラーが返されます。

ファイルシステムの UUID を見つけるには、「vfs-uuid」を使用します。

fsck
fsck fstypeデバイス

これはファイルシステムタイプを持つ「デバイス」上でファイルシステムチェッカー（fsck）を実行します。
「fstype」です。

返される整数はステータスです。 fsck(8)「fsck」からのステータスコードのリスト。

注意：

· 複数のステータス コードを合計することができます。

· ゼロ以外の戻りコードは「成功」を意味する場合があります。たとえば、エラーが修正された場合などです。
ファイルシステム上。

· NTFS ボリュームのチェックまたは修復はサポートされていません (linux-ntfs による)。

このコマンドは、「fsck -a -t fstype device」を実行するのと完全に同等です。

fstream
fstrim マウントポイント [オフセット:N] [長さ:N] [最小空き領域:N]

「マウントポイント」にマウントされたファイルシステムの空き領域を削減します。ファイルシステムは
読み取り/書き込みでマウントされます。

ファイルシステムの内容は影響を受けませんが、ファイルシステム内の空き領域は
「トリミング」、つまりホストデバイスに返され、ディスクイメージがよりスパースになります。
qcow2 ファイル内の未使用スペースを再利用できるようにするなど。

この操作には、libguestfs、マウントされたファイルシステム、ホストでのサポートが必要です。
ファイルシステム、QEMU、ホストカーネル。このサポートがない場合、エラーが発生する可能性があります。
あるいは実行しているように見えても何も実行しません。

「zero-free-space」も参照してください。これは空き領域をゼロにする少し異なる操作です。
ファイルシステム内のデータをゼロに置き換える。fstrimは、
「ゼロ空き領域」を呼び出します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

取得-追加
取得-追加

libguestfsアプライアンスカーネルに追加された追加のカーネルオプションを返します。
コマンドライン。

「NULL」の場合、オプションは追加されません。

get-attachメソッド
get-attachメソッド

現在のバックエンドを返します。

「set-backend」と「BACKEND」を参照してください。 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「get-backend」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

自動同期の取得
自動同期の取得

自動同期フラグを取得します。

バックエンドを取得する
バックエンドを取得する

現在のバックエンドを返します。

このハンドル プロパティは、以前は「アタッチ メソッド」と呼ばれていました。

「set-backend」と「BACKEND」を参照してください。 ゲストとします。

バックエンド設定の取得
get-backend-setting の名前

「name」または「name=」で始まるバックエンド設定文字列を検索します。「name」の場合、
これは文字列「1」を返します。「name=」の場合は、等号の後の部分が返されます。
(空の文字列の場合もあります)。

そのような設定が見つからない場合、この関数はエラーをスローします。errno（「last-errno」を参照）
この場合は「ESRCH」になります。

「バックエンド」を参照してください ゲスト（３）「バックエンド設定」 ゲストとします。

バックエンド設定の取得
バックエンド設定の取得

現在のバックエンド設定を返します。

この呼び出しはすべてのバックエンド設定文字列を返します。単一のバックエンドを検索する場合は
設定については、「get-backend-setting」を参照してください。

「バックエンド」を参照してください ゲスト（３）「バックエンド設定」 ゲストとします。

キャッシュディレクトリを取得
キャッシュディレクトリを取得

アプライアンス キャッシュを保存するためにハンドルが使用するディレクトリを取得します。

直接入手
直接入手

直接アプライアンス モード フラグを返します。

取得-e2attrs
get-e2attrs ファイル

これは、関連付けられているファイル属性を返します。 file.

属性は各inodeに関連付けられたビットのセットであり、inodeの動作に影響します。
ファイル属性は文字列として返されます（後述）。
文字列が空の場合、このファイルにファイル属性が設定されていないことを示します。

これらの属性は、ファイルが ext2/3/4 ファイルシステム上にある場合にのみ存在します。
他のファイルシステム タイプでこの呼び出しを使用すると、エラーが発生します。

返される文字列の文字 (ファイル属性) は現在次のとおりです。

'A' ファイルにアクセスしても、その atime は変更されません。

'a' ファイルは追加専用です。

'c' ファイルはディスク上で圧縮されています。

「D」(ディレクトリのみ) このディレクトリへの変更はディスクに同期的に書き込まれます。

'd' ファイルはバックアップの候補ではありません（ ダンプ（8））。

「E」ファイルに圧縮エラーがあります。

'e' ファイルはエクステントを使用しています。

'h' ファイルはファイルシステムのブロックサイズ単位でブロックを保存しています。
セクター。

「I」(ディレクトリのみ) ディレクトリはハッシュ ツリーを使用しています。

'i' ファイルは変更不可です。変更、削除、名前変更はできません。リンクは作成できません。
このファイルに作成されました。

'j' ファイルはデータジャーナル化されています。

's' ファイルが削除されると、そのすべてのブロックがゼロになります。

'S' このファイルへの変更はディスクに同期的に書き込まれます。

'T' (ディレクトリのみ) これは、サブディレクトリがブロックアロケータに与えるヒントです。
このディレクトリに含まれる内容は複数のブロックに分散されている必要があります。存在しない場合、ブロックは
アロケータはサブディレクトリをグループ化しようとします。

't' ファイルの場合、末尾マージを無効にします。（上流実装では使用されません）
（内線2）

'u' ファイルが削除されると、そのブロックが保存され、ファイルを元に戻すことができます。

「X」圧縮ファイルの生の内容にアクセスできる可能性があります。

「Z」圧縮ファイルはダーティです。

このリストには今後さらにファイル属性が追加される可能性があります。すべてのファイル属性を設定できるわけではありません。
あらゆる種類のファイルに対応しています。詳細については、 おしゃべり（1）マニュアルページ。

「set-e2attrs」も参照してください。

これらの属性を拡張属性と混同しないでください (「getxattr」を参照)。

ゲットe2ジェネレーション
get-e2generationファイル

これはファイルのext2ファイル世代を返します。世代（以前は
バージョン番号は、inodeに関連付けられた番号です。これはNFSで最もよく使用されます。
サーバー。

この世代は、ファイルがext2/3/4ファイルシステムにある場合にのみ存在します。
他のファイルシステム タイプでこの呼び出しを行うと、エラーが発生します。

「set-e2generation」を参照してください。

e2ラベルを取得する
get-e2labelデバイス

これは、「デバイス」上のファイルシステムの ext2/3/4 ファイルシステム ラベルを返します。

この function is 非推奨。 新しいコードでは、代わりに「vfs-label」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

e2uuid を取得する
get-e2uuidデバイス

これは、「デバイス」上のファイルシステムの ext2/3/4 ファイルシステム UUID を返します。

この function is 非推奨。 新しいコードでは、代わりに "vfs-uuid" 呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ゲット-hv
ゲット-hv

現在のハイパーバイザーバイナリを返します。

これは常にNULLではありません。まだ設定されていない場合は、デフォルトのQEMUを返します。
バイナリ名。

識別子の取得
識別子の取得

ハンドル識別子を取得します。「set-identifier」を参照してください。

get-libvirt-requested-credential-challenge
get-libvirt-requested-credential-challenge インデックス

libvirtによって提供されるチャレンジを、"index"番目に要求された認証情報に対して取得します。
libvirt がチャレンジを提供しなかった場合、空の文字列 "" が返されます。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

get-libvirt-requested-credential-defresult
get-libvirt-requested-credential-defresult インデックス

要求された認証情報「index」番目に対して、デフォルトの結果（libvirtによって提供される）を取得します。
libvirt はデフォルトの結果を提供しなかったため、空の文字列 "" を返します。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

get-libvirt-requested-credential-prompt
get-libvirt-requested-credential-prompt インデックス

libvirtが提供する「index」番目に要求された認証情報を求めるプロンプトを取得します。libvirtの場合
プロンプトを提供しなかった場合は、空の文字列 "" を返します。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

libvirt-要求された認証情報の取得
libvirt-要求された認証情報の取得

これは、次のタイプのイベントのイベントコールバック中にのみ呼び出されます。
「GUESTFS_EVENT_LIBVIRT_AUTH」です。

libvirtが要求する認証情報のリストを返します。可能な値は、
「set-libvirt-supported-credentials」を呼び出したときに提供される文字列。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

メモリサイズを取得する
メモリサイズを取得する

これは、ハイパーバイザーに割り当てられたメモリ サイズをメガバイト単位で取得します。

このハンドルで「set-memsize」が呼び出されず、「LIBGUESTFS_MEMSIZE」が設定されていない場合、
すると、コンパイルされた memsize のデフォルト値が返されます。

libguestfsのアーキテクチャの詳細については、以下を参照してください。 ゲストとします。

ネットワークを取得する
ネットワークを取得する

これは、ネットワーク有効化フラグを返します。

パス取得
パス取得

現在の検索パスを返します。

これは常にNULLではありません。まだ設定されていない場合は、デフォルト値を返します。
パス。

取得pgroup
取得pgroup

これはプロセス グループ フラグを返します。

取得PID
ピッド
取得PID

ハイパーバイザーのプロセスIDを返します。ハイパーバイザーが動作していない場合は、
エラーを返します。

これはデバッグとテストのために使用される内部呼び出しです。

取得プログラム
取得プログラム

プログラム名を取得します。「set-program」を参照してください。

ゲットQEMU
ゲットQEMU

現在のハイパーバイザー バイナリ (通常は qemu) を返します。

これは常にNULLではありません。まだ設定されていない場合は、デフォルトのQEMUを返します。
バイナリ名。

この function is 非推奨。 新しいコードでは、代わりに「get-hv」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

リカバリプロセスを取得する
リカバリプロセスを取得する

回復プロセス有効フラグを返します。

selinux を取得する
selinux を取得する

これはアプライアンスに渡されるselinuxフラグの現在の設定を返します。
起動時。「set-selinux」を参照してください。

libguestfsのアーキテクチャの詳細については、以下を参照してください。 ゲストとします。

ゲット・エスエムピー
ゲット・エスエムピー

アプライアンスに割り当てられた仮想 CPU の数を返します。

取得-tmpdir
取得-tmpdir

ハンドルが一時ファイルを保存するために使用するディレクトリを取得します。

トレースを取得
トレースを取得

コマンド トレース フラグを返します。

umask を取得する
umask を取得する

現在のumaskを返します。デフォルトでは、umaskは022ですが、
「umask」。

詳細な情報を取得する
詳細な情報を取得する

これは、詳細メッセージ フラグを返します。

ゲットコン
ゲットコン

これはデーモンの SELinux セキュリティ コンテキストを取得します。

SELINUXに関するドキュメントは以下を参照してください。 ゲスト（３）そして「セットコン」

getxattr
getxattr パス名

ファイル「path」から「name」という名前の拡張属性を1つ取得します。この呼び出しは
シンボリックリンク。シンボリックリンク自体の拡張属性を参照したい場合は、
「lgetxattr」。

通常、ファイルからすべての拡張属性を一度に取得するには、
しかし、Linuxファイルシステムの実装にはバグがあり、
属性の一覧表示方法。これらのファイルシステム（特にntfs-3g）では、
事前に必要な拡張属性の名前を指定して、この関数を呼び出します。

拡張属性値はバイナリデータの塊です。拡張属性がない場合
「name」という名前の場合、エラーが返されます。

参照: 「getxattrs」、「lgetxattr」 ATTRとします。

getxattrs
getxattrs パス

この呼び出しは、ファイルまたはディレクトリの「パス」の拡張属性を一覧表示します。

システムコールレベルでは、これは リスト属性（2）と getxattr（2）呼び出し。

参照: 「lgetxattrs」 ATTRとします。

グロブ展開
glob-expandパターン

このコマンドはワイルドカードに従って「パターン」に一致するすべてのパス名を検索します。
シェルが使用する展開規則。

一致するパスがない場合は、空のリストが返されます (注: エラーではありません)。

これはCを包むだけのものである 地球（3）フラグ「GLOB_MARK|GLOB_BRACE」を指定した関数。
詳細についてはそのマニュアルページを参照してください。

デバイス名を拡張するための同等のコマンドがないことに注意してください (例: / dev / sd *).
代わりに「list-devices」、「list-partitions」などの関数を使用してください。

grep
grep-opts
grep 正規表現パス [拡張:true|false] [固定:true|false] [無差別:true|false] [圧縮:true|false]

これは外部の「grep」プログラムを呼び出し、一致する行を返します。

オプションのフラグは次のとおりです。

「拡張」
拡張正規表現を使用します。これは、 -E フラグ。

"修理済み"
固定一致（正規表現は使用しないでください）。これは、 -F フラグ。

「無神経」
大文字と小文字を区別せずに一致します。これは、 -i フラグ。

「圧縮された」
「grep」の代わりに「zgrep」を使用してください。これにより、入力を圧縮またはgzipで圧縮できます。
圧縮されています。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

グレピ
grepi正規表現パス

これは外部の「grep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

grub-install
grub-install ルートデバイス

このコマンドは、GRUB 1（Grand Unified Bootloader）を「デバイス」にインストールし、ルートディレクトリは
ディレクトリは「root」です。

注意：

· 現在、APIには、ほとんどの最新のOSで使用されているgrub2をインストールする方法がありません。
Linuxゲスト。ゲストからgrub2コマンドを実行することは可能ですが、
「コマンド実行」の注意事項 ゲストとします。

· これはホストから「grub-install」を使用します。残念ながらgrubは常に互換性があるとは限りません。
それ自体では機能しないため、これはかなり限られた状況でしか機能しません。慎重にテストしてください。
各ゲストバージョンをお勧めします。

· grub-installが「生成されたデバイスに適切なドライブが見つかりませんでした」というエラーを報告した場合
マップを作成する必要があるかもしれません /boot/grub/デバイス.map まず最初に
GRUBデバイス名とLinuxデバイス名のマッピングが含まれています。通常は
以下を含むファイルを作成すれば十分です。

(hd0) /dev/vda

交換 /dev/vda インストールデバイスの名前を入力します。


ヘッドパス

このコマンドは、ファイルの最初の 10 行までを文字列のリストとして返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

ヘッドン
ヘッド-n nrlines パス

パラメータ「nrlines」が正の数の場合、これは最初の「nrlines」行を返します。
ファイルの「パス」。

パラメータ「nrlines」が負の数の場合、ファイル「path」から行を返します。
最後の「nrlines」行を除きます。

パラメータ「nrlines」がゼロの場合、空のリストが返されます。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

XNUMX進ダンプ
16進ダンプパス

これは指定された「パス」に対して「hexdump -C」を実行します。結果は人間が読める標準的な形式です。
ファイルの 16 進ダンプ。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

ハイベックスクローズ
ハイベックスクローズ

現在の hivex ハンドルを閉じます。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex コミット
hivex-commit ファイル名

ハイブへの変更をコミット（書き込み）します。

オプションの ファイル名 パラメータがnullの場合、変更は同じものに書き戻されます
開かれたハイブ。これがnullでない場合、代替ファイル名に書き込まれます。
与えられ、元の巣はそのまま残されます。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex-node-add-child
hivex-node-add-child 親の名前

「parent」に「name」という名前の子ノードを追加します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex-node-children
hivex-node-children ノード

「nodeh」のサブキーであるノードのリストを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex-node-delete-child
hivex-node-delete-child ノード

必要に応じて再帰的に「nodeh」を削除します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex-node-get-child
hivex-node-get-child ノード名

「nodeh」の子ノード「name」が存在する場合は返します。この場合は0を返します。
名前が見つかりませんでした。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex ノードの取得値
hivex-node-get-value ノードキー

「nodeh」に「key」という名前で付与された値が存在する場合、それを返します。これは
キーが見つからなかったことを意味する 0 を返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex ノード名
hivex-ノード名 nodeh

「nodeh」の名前を返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex ノードの親
hivex-node-parent ノード

「nodeh」の親ノードを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex ノード設定値
hivex-node-set-value ノードキー t 値

ノード「nodeh」の下にある単一の値を設定または置換します。「key」は名前、「t」は
型であり、「val」はデータです。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex ノード値
hivex-node-values ノード

「nodeh」に添付された (キー、データ型、データ) タプルの配列を返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

ハイベックスオープン
hivex-open ファイル名 [verbose:true|false] [debug:true|false] [write:true|false]

Windowsレジストリハイブファイルを開きます ファイル名以前に蜂巣炎があった場合
この guestfs セッションに関連付けられたハンドルがない場合は、閉じられます。

これは、 ハイベックス(3) 同じ名前の呼び方。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

hivex ルート
hivex ルート

ハイブのルート ノードを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex 値キー
hivex-値-キー値h

(キー、データ型、データ) タプルのキー (名前) フィールドを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex 値タイプ
hivex値型値h

(キー、データ型、データ) タプルからデータ型フィールドを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

hivex-value-utf8
hivex-value-utf8 値h

これは「hivex-value-value」（hivex 値タプルからデータ フィールドを返す）を呼び出します。
次に、フィールドがUTF-16LE文字列であると想定し、結果をUTF-8（または
これが不可能な場合はエラーを返します。

これはWindowsレジストリから文字列を読み取るのに便利です。ただし、
レジストリは厳密に型付けされておらず、フィールドには任意の値や
予期しないデータ。

hivex-値-値
hivex-値-値 valueh

(キー、データ型、データ) タプルのデータ フィールドを返します。

これは、 ハイベックス(3) 同じ名前の呼び方。

「hivex-value-utf8」も参照してください。

initrd-cat
initrd-cat initrdpath ファイル名

このコマンドはファイルを解凍します ファイル名 initrdファイルから initrdパスを選択します。
ファイル名を指定する必要があります 無し 初期 / 文字。

例えば、guestfishでは次のコマンドを使ってブートスクリプトを調べることができます。
（通常は /初期化) を Linux initrd または initramfs イメージに含めます。

initrd-cat /boot/initrd- .img 初期化

「initrd-list」も参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

initrdリスト
initrdリストパス

このコマンドは、initrd に含まれるファイルを一覧表示します。

ファイルは、初期値なしでリストされます / 文字。ファイルは
表示されます（必ずしもアルファベット順ではありません）。ディレクトリ名は個別の項目としてリストされます。

古いLinuxカーネル（2.4以前）では、圧縮されたext2ファイルシステムをinitrdとして使用していました。 の
新しい initramfs 形式 (圧縮された cpio ファイル) をサポートします。

inotify ウォッチの追加
inotify-add-watch パスマスク

「mask」にリストされているイベントの「path」を監視します。

「パス」がディレクトリの場合、そのディレクトリ内のイベントが監視されますが、
ありません 再帰的に発生します（サブディレクトリ内）。

C言語以外、またはLinux以外の言語で呼び出した場合の注意: inotifyイベントはLinuxカーネルによって定義されます。
ABIと記載されており、 /usr/include/sys/inotify.h.

inotify を閉じる
inotify を閉じる

これはinotify_initによって開かれたinotifyハンドルを閉じます。
すべての監視を行い、保留中のイベントを破棄し、すべてのリソースの割り当てを解除します。

inotify ファイル
inotify ファイル

この関数は「inotify-read」の便利なラッパーで、
タッチされたオブジェクトのパス名。返されたパス名はソートされ、
重複排除されました。

inotify-init
inotify-init 最大イベント数

このコマンドは新しいinotifyハンドルを作成します。inotifyサブシステムは通知に使用できます。
ゲストファイルシステム内のオブジェクトに発生するイベント。

「maxevents」は、呼び出しの間にキューに入れられるイベントの最大数です。
「inotify-read」または「inotify-files」。このパラメータに0が渡された場合、カーネル（または以前に
設定されたデフォルトが使用されます。Linux 2.6.29では、デフォルトは16384イベントでした。この制限を超えると、
カーネルはイベントを破棄しますが、破棄したという事実は、
返される構造体リストに「IN_Q_OVERFLOW」フラグを設定します（「inotify-read」を参照）。

イベントが生成される前に、内部監視リストにいくつかの監視を追加する必要があります。
参照: 「inotify-add-watch」および「inotify-rm-watch」。

キューに入れられたイベントは、「inotify-read」（または「inotify-files」）を呼び出して定期的に読み取る必要があります。
これは「inotify-read」の便利なラッパーです。イベントを読み出さない場合は
頻繁に行うと、内部キューがオーバーフローする危険があります。

使用後は「inotify-close」を呼び出してハンドルを閉じる必要があります。これにより、
自動的に監視します。

参照 inotify(7) Linuxで公開されているinotifyインターフェースの概要については、
カーネルはlibguestfsで公開されているものとほぼ同じです。グローバルな
libguestfs インスタンスごとの inotify ハンドル。

inotify 読み取り
inotify 読み取り

前回の読み取り呼び出し以降に発生したイベントの完全なキューを返します。

イベントが発生していない場合は、空のリストが返されます。

注意: すべてのイベントが読み取られたことを確認するには、この関数を呼び出す必要があります
空のリストが返されるまで繰り返します。これは、呼び出しによってイベントが読み取られるためです。
アプライアンスからホストへのメッセージの最大サイズまで送信し、残りのイベントをキューに残します。

inotify-rm-ウォッチ
inotify-rm-watch wd

以前に定義されたinotifyウォッチを削除します。「inotify-add-watch」を参照してください。

検査-取得-アーキテクチャ
検査-取得-アーチルート

これは検査されたオペレーティングシステムのアーキテクチャを返します。返される可能性のある値は
値は「file-architecture」の下にリストされます。

アーキテクチャを判別できなかった場合は、文字列「unknown」が返されます。

「検査」をお読みください ゲスト（3）詳細については。

ディストリビューションの検査
検査-取得-ディストリビューション ルート

検査されたオペレーティング システムのディストリビューションを返します。

現在定義されているディストリビューションは次のとおりです。

「アルパインリナックス」
アルパインリナックス。

「オルトリナックス」
オルトリナックス。

「アーチリナックス」
ArchLinux。

「ビルドルート」
Buildroot 由来のディストリビューションですが、私たちが具体的に認識しているものではありません。

「セントス」
CentOS。

「シロ」
シロス。

「コレオス」
コアOS。

「デビアン」
Debian

「フェドーラ」
Fedora。

「フリーBSD」
FreeBSD。

「フリードス」
フリーDOS。

「節約ウェア」
倹約的なウェア。

「ジェンツー」
Gentoo。

「リナックスミント」
Linux Mint。

「マゲイア」
マゲイア。

「マンドリバ」
マンドリバ。

「ミーゴ」
ミーゴー。

「ネットBSD」
ネットBSD。

「オープンBSD」
OpenBSD。

「オープンユース」
OpenSUSE。

「オラクルLinux」
OracleLinux。

「パルダス」
パルダス。

「pldlinux」
PLD Linux。

「RedHatベース」
Red Hat 由来のディストリビューション。

「レル」
Red Hat エンタープライズ Linux。

「サイエンティフィックリナックス」
科学的な Linux。

「スラックウェア」
Slackware。

「スレス」
SuSE Linux Enterprise Server またはデスクトップ。

「SUSEベース」
いくつかの openSuSE 由来のディストリビューション。

「ttylinux」
ttylinux。

「ウブントゥ」
Ubuntuの。

"未知"
ディストリビューションを特定できませんでした。

「窓」
Windowsにはディストリビューションがありません。OSの種類が
ウィンドウズ。

libguestfsの将来のバージョンでは、ここに別の文字列が返される可能性があります。呼び出し元は
あらゆる文字列を処理できるように準備されています。

「検査」をお読みください ゲスト（3）詳細については。

ドライブマッピングの検査
ドライブマッピングのルートの検査

この呼び出しは、ドライブ文字を割り当てる原始的なシステムを使用するWindowsに役立ちます。
（ C：\）パーティションへの侵入。この検査APIはWindowsレジストリを調べて、
ディスク/パーティションがドライブ文字にどのようにマッピングされているかを調べ、ハッシュテーブルを返します。
以下の例：

C => /dev/vda2
E => /dev/vdb1
F => /dev/vdc1

キーはドライブ文字であることに注意してください。Windowsの場合、キーは大文字と小文字を区別せず、
通常のコロン区切り文字を除いたドライブ文字が含まれます。

将来的には、ドライブ文字を使用する他のオペレーティングシステムもサポートする可能性がありますが、
これらのキーは大文字と小文字を区別しない可能性があり、1文字より長くなる可能性があります。
たとえば OS-9 では、ハードドライブは「h0」、「h1」などと名前が付けられていました。

Windows ゲストの場合、現在はハード ドライブのマッピングのみが返されます。リムーバブル ディスク (例:
DVD-ROM などのメディアは無視されます。

ドライブマッピングを使用しないゲストの場合、またはドライブマッピングができない場合は、
決定された場合、空のハッシュ テーブルが返されます。

「検査」をお読みください ゲスト（3）詳細については、「inspect-get-
「マウントポイント」、「inspect-get-filesystems」などです。

ファイルシステムの検査
ファイルシステムの検査と取得 ルート

これは、これに関連付けられていると思われるすべてのファイルシステムのリストを返します。
オペレーティングシステム。これにはルートファイルシステム、その他の通常のファイルシステム、および非
スワップ パーティションなどのマウントされたデバイス。

マルチブート仮想マシンの場合、ファイルシステムを共有することが可能です。
オペレーティング システム間。

「検査」をお読みください ゲスト（3）詳細については、「inspect-get-
「マウントポイント」。

検査-取得-フォーマット
ルートの検査-取得-フォーマット

検査したオペレーティングシステムのフォーマットを返します。これを使用して、
インストールイメージ、ライブ CD など。

現在定義されている形式は次のとおりです。

「インストール済み」
これはインストールされたオペレーティング システムです。

"インストーラ"
検査対象のディスクイメージはインストールされたオペレーティングシステムではなく、 起動可能な
インストール ディスク、ライブ CD、または同様のもの。

"未知"
このディスク イメージの形式は不明です。

libguestfsの将来のバージョンでは、ここに別の文字列が返される可能性があります。呼び出し元は
あらゆる文字列を処理できるように準備されています。

「検査」をお読みください ゲスト（3）詳細については。

ホスト名の検査と取得
ホスト名の検査と取得 ルート

この関数は、検査によって見つかったオペレーティングシステムのホスト名を返します。
ゲストの設定ファイル。

ホスト名を特定できなかった場合は、文字列「unknown」が返されます。

「検査」をお読みください ゲスト（3）詳細については。

検査-取得-アイコン
inspect-get-icon ルート [favicon:true|false] [highquality:true|false]

この関数は、検査したオペレーティングシステムに対応するアイコンを返します。アイコンは
PNG 画像 (必要に応じて PNG に再エンコード) を含むバッファとして返されます。

アイコンを取得できなかった場合、この関数は長さゼロ（NULL以外）を返します。
バッファ。 発信者 しなければなりません PowerSchoolで、緊急連絡先情報を定期的にチェックし、 の この 場合.

Libguestfsはまず、 /etc/favicon.png or C:\etc\favicon.png
正しい形式であれば、ファイルの内容が返されます。
オプションの「favicon」ブール値を false として渡すことで、ファビコンを無効にします (デフォルトは true)。

ファビコンが見つからない場合は、ゲスト内の他の場所で適切なものを探します。
のアイコンをクリックします。

オプションの「highquality」ブール値がtrueの場合、高品質のアイコンのみが返されます。
これは、アルファチャンネル付きの高解像度アイコンのみを意味します。デフォルト（false）は
たとえ品質が標準以下であっても、可能な限りアイコンを返します。

注意：

· 他のほとんどの検査API呼び出しとは異なり、ゲストのディスクは事前にマウントされている必要があります。
ゲストファイルシステムから情報を読み取る必要があるため、これを呼び出します。
コール。

· セキュリティ： アイコンデータは信頼できないゲストから取得されるため、
注意。PNGファイルには脆弱性が存在することが知られています。libpng（または他の
アイコンを処理または表示する前に、アイコン ファイル (.app) と関連するライブラリが完全に最新であることを確認してください。

· 返されるPNG画像は任意のサイズになります。正方形ではない可能性があります。Libguestfsは
利用可能な最大かつ最高品質のアイコンを返します。アプリケーションは、
アイコンを必要なサイズに変更します。

· Windowsゲストからアイコンを抽出するには、外部の「wrestool」プログラムが必要です。
「icoutils」パッケージと、いくつかのプログラム（「bmptopnm」、「pnmtopng」、「pamcut」）
「netpbm」パッケージ。これらは別途インストールする必要があります。

· オペレーティングシステムのアイコンは通常商標です。使用する前に法律の専門家にご相談ください。
アプリケーション内の商標。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

メジャーバージョンの検査
メジャーバージョンのルートを検査する

検査されたオペレーティング システムのメジャー バージョン番号を返します。

Windowsは一貫したバージョン管理方式を採用しており、 大衆に反映される
オペレーティングシステムで使用される名前。特に「Windows 7」として知られるオペレーティングシステムは
実際にはバージョン6.1（つまりメジャーバージョン6、マイナーバージョン1）です。実際のバージョンは
Wikipedia または MSDN を参照して、Windows のリリースに対応します。

バージョンを判別できなかった場合は、0 が返されます。

「検査」をお読みください ゲスト（3）詳細については。

マイナーバージョンの検査
マイナーバージョンルートの検査

検査されたオペレーティング システムのマイナー バージョン番号を返します。

バージョンを判別できなかった場合は、0 が返されます。

「検査」をお読みください ゲスト（3）詳細については、「inspect-get-major-
バージョン」を参照してください。

マウントポイントの検査
マウントポイントの検査 ルート

これは、このオペレーティングシステムに関連付けられているファイルシステムのハッシュを返します。
システムをマウントする必要があります。これはせいぜい推測に過ぎないことを留意してください。
次のような設定ファイルを読むことによって /etc/fstab . In 特定の 注意 これは
存在しないかマウントできないファイルシステムを返すので、呼び出し側は準備する必要がある
マウントしようとした場合に失敗を処理または無視します。

返されるハッシュテーブルの各要素には、マウントポイントのパスであるキーがあります (例:
/ブート) と、そこにマウントされるファイルシステムの値 (例: の/ dev / sda1).

スワップデバイスなどのマウントされていないデバイスは このリストに返されます。

Windowsのようなドライブ文字を使用するオペレーティングシステムの場合、この呼び出しは
マウントされている最初のドライブのエントリを返します /マッピングの詳細については、
ドライブ文字をパーティションに割り当てるには、「inspect-get-drive-mappings」を参照してください。

「検査」をお読みください ゲスト（3）詳細については、「inspect-get-
「ファイルシステム」。

パッケージ形式の検査
パッケージ形式の検査ルート

この関数と「inspect-get-package-management」はパッケージのフォーマットとパッケージを返します。
検査対象のオペレーティングシステムで使用される管理ツール。例えばFedoraの場合、これらは
関数は「rpm」（パッケージ形式）と「yum」または「dnf」（パッケージ管理）を返します。

パッケージ形式を判別できなかった場合は、「不明」という文字列を返します。 or もし
オペレーティング システムには実際のパッケージ システムがありません (例: Windows)。

使用可能な文字列には、「rpm」、「deb」、「ebuild」、「pisi」、「pacman」、「pkgsrc」、「apk」などがあります。
libguestfs の将来のバージョンでは、他の文字列が返される可能性があります。

「検査」をお読みください ゲスト（3）詳細については。

パッケージ管理の検査
パッケージ管理ルートの検査

「inspect-get-package-format」とこの関数はパッケージフォーマットとパッケージを返します
検査対象のオペレーティングシステムで使用される管理ツール。例えばFedoraの場合、これらは
関数は「rpm」（パッケージ形式）と「yum」または「dnf」（パッケージ管理）を返します。

パッケージ管理ツールを判別できなかった場合は、「不明」という文字列を返します。 or
オペレーティング システムに実際のパッケージ システムがない場合 (例: Windows)。

可能な文字列には、「yum」、「dnf」、「up2date」、「apt」（すべてのDebian派生版）などがあります。
「portage」、「pisi」、「pacman」、「urpmi」、「zypper」、「apk」。libguestfsの将来のバージョンでは、
他の文字列を返します。

「検査」をお読みください ゲスト（3）詳細については。

検査して製品名を取得する
検査-取得-製品名ルート

検査対象のオペレーティングシステムの製品名を返します。製品名は
一般的には、ユーザーに表示できるが、表示すべきではない自由形式の文字列である。
プログラムによって解析されます。

製品名を特定できなかった場合は、文字列「unknown」が返されます。

「検査」をお読みください ゲスト（3）詳細については。

検査して製品バリアントを取得する
検査-取得-製品バリアントルート

検査されたオペレーティング システムの製品バリアントを返します。

Windowsゲストの場合、これはレジストリキーの内容を返します。
「HKLM\Software\Microsoft\Windows NT\CurrentVersion」の「InstallationType」は通常
「Client」や「Server」などの文字列（他の値も可能）。これは、
同じバージョン番号を持つ Windows のコンシューマー バージョンとエンタープライズ バージョンを区別する
（例えば、Windows 7とWindows 2008 Serverはどちらもバージョン6.1ですが、前者は
（前者は「クライアント」、後者は「サーバー」です）。

エンタープライズLinuxゲストの場合、将来的には、次のような製品バリアントを返す予定です。
「デスクトップ」「サーバー」など。ただし、これは現時点では実装されていません。

製品のバリアントを特定できなかった場合は、文字列「unknown」が返されます。

「検査」をお読みください ゲスト（3）詳細については、「inspect-get-product-
「name」、「inspect-get-major-version」です。

ルートの検査
ルートの検査

この関数は、ルートデバイスのリストを取得するのに便利な方法です。
以前の「inspect-os」呼び出しと同じですが、検査プロセス全体をやり直す必要はありません。

ルートデバイスが見つからないか、呼び出し元がルートデバイスを持っていない場合は、空のリストを返します。
「inspect-os」と呼ばれます。

「検査」をお読みください ゲスト（3）詳細については。

検査-取得-型
検査-取得-型ルート

検査したオペレーティングシステムの種類を返します。現在定義されている型は以下のとおりです。

「リナックス」
任意の Linux ベースのオペレーティング システム。

「窓」
任意の Microsoft Windows オペレーティング システム。

「フリーBSD」
FreeBSD。

「ネットBSD」
ネットBSD。

「オープンBSD」
OpenBSD。

「ハード」
GNU/ハード。

「ドス」
MS-DOS、FreeDOS など。

「ミニックス」
ミニクス。

"未知"
オペレーティング システムの種類を特定できませんでした。

libguestfsの将来のバージョンでは、ここに別の文字列が返される可能性があります。呼び出し元は
あらゆる文字列を処理できるように準備されています。

「検査」をお読みください ゲスト（3）詳細については。

Windows の現在のコントロール セットを検査して取得する
検査 - 取得 - Windows - 現在のコントロール - ルートの設定

これは検査されたゲストのWindows CurrentControlSetを返します。CurrentControlSet
「ControlSet001」などのレジストリ キー名です。

この呼び出しは、ゲストがWindowsであり、レジストリが次のように検査できることを前提としています。
検査。そうでない場合はエラーが返されます。

「検査」をお読みください ゲスト（3）詳細については。

検査-取得-Windows-システムルート
検査-取得-Windows-システムルート ルート

これは検査対象ゲストのWindowsシステムルートを返します。システムルートはディレクトリです。
次のようなパス /ウィンドウズ.

この呼び出しは、ゲストがWindowsであり、システムルートが次のように決定できることを前提としています。
検査。そうでない場合はエラーが返されます。

「検査」をお読みください ゲスト（3）詳細については。

ライブ検査
ライブルートの検査

「inspect-get-format」が「installer」（これはインストールディスク）を返す場合、これは
ディスク上でライブイメージが検出された場合は true。

「検査」をお読みください ゲスト（3）詳細については。

検査がマルチパートである
検査-マルチパートルート

「inspect-get-format」が「installer」（これはインストールディスク）を返す場合、これは
ディスクがセットの一部である場合は true です。

「検査」をお読みください ゲスト（3）詳細については。

検査-is-netinst
検査-is-netinst ルート

「inspect-get-format」が「installer」（これはインストールディスク）を返す場合、これは
ディスクがネットワークインストーラーの場合、つまり自己完結型のインストールCDではなく、
インストールを完了するにはネットワーク アクセスが必要になる可能性があります。

「検査」をお読みください ゲスト（3）詳細については。

アプリケーションリストの検査
検査リストアプリケーションルート

オペレーティング システムにインストールされているアプリケーションのリストを返します。

注意： この呼び出しは検査APIの他の部分とは異なる動作をします。
「inspect-os」を呼び出し、次に「inspect-get-mountpoints」を呼び出し、ディスクをマウントしてから、
アプリケーションの一覧表示は、はるかに難しい操作であり、
ファイルシステム全体へのアクセス。また、他の「inspect-get-*」呼び出しとは異なり、
libguestfsハンドルにキャッシュされたデータを返すだけですが、この呼び出しは実際には
通話中にマウントされたファイルシステムの一部。

検査コードがリストを決定できなかった場合は空のリストを返します。
分野の様々なアプリケーションで使用されています。

アプリケーション構造には次のフィールドが含まれます。

「アプリ名」
アプリケーションの名前。Red Hat系およびDebian系のLinuxゲストの場合、
これはパッケージ名です。

「アプリ表示名」
アプリケーションの表示名。インストール言語に合わせてローカライズされる場合もあります。
ゲスト オペレーティング システム。

利用できない場合は、空の文字列 "" が返されます。
代わりに「app_name」を使用できます。

「アプリエポック」
エポックを使用するパッケージマネージャの場合、これにはパッケージのエポック（
整数）。利用できない場合は 0 が返されます。

"app_version"
アプリケーションまたはパッケージのバージョン文字列。入手できない場合は、次のように返されます。
空の文字列 ""。

「アプリリリース」
これを利用するパッケージ マネージャーのアプリケーションまたはパッケージのリリース文字列。
利用できない場合は、空の文字列 "" が返されます。

「アプリインストールパス」
アプリケーションのインストールパス（Windowsなどのオペレーティングシステムでは
インストールパスを使用します。このパスはゲストオペレーティングシステムで使用される形式です。
システムの場合、これは libguestfs パスではありません。

利用できない場合は、空の文字列 "" が返されます。

「アプリトランスパス」
libguestfsパスに変換されたインストールパス。利用できない場合はこれが返されます
空の文字列 "" として

「アプリパブリッシャー」
アプリケーションの発行者名（パッケージマネージャがこれを使用する場合）。
利用できない場合は、空の文字列 "" として返されます。

「アプリURL」
アプリケーションのURL（例：アップストリームURL）。利用できない場合は、
空の文字列 ""。

「アプリソースパッケージ」
これをサポートするパッケージングシステムの場合、ソースパッケージの名前。
利用できない場合は、空の文字列 "" として返されます。

「アプリ概要」
アプリケーションまたはパッケージの短い（通常は1行）説明。
これは空の文字列 "" として返されます。

「アプリの説明」
アプリケーションまたはパッケージの詳細な説明。入手できない場合は、この説明が返されます。
空の文字列 "" として

「検査」をお読みください ゲスト（3）詳細については。

この function is 非推奨。 新しいコードでは、「inspect-list-applications2」呼び出しを使用します
を代わりにお使いください。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

検査リストアプリケーション2
検査リストアプリケーション2 ルート

オペレーティング システムにインストールされているアプリケーションのリストを返します。

注意： この呼び出しは検査APIの他の部分とは異なる動作をします。
「inspect-os」を呼び出し、次に「inspect-get-mountpoints」を呼び出し、ディスクをマウントしてから、
アプリケーションの一覧表示は、はるかに難しい操作であり、
ファイルシステム全体へのアクセス。また、他の「inspect-get-*」呼び出しとは異なり、
libguestfsハンドルにキャッシュされたデータを返すだけですが、この呼び出しは実際には
通話中にマウントされたファイルシステムの一部。

検査コードがリストを決定できなかった場合は空のリストを返します。
分野の様々なアプリケーションで使用されています。

アプリケーション構造には次のフィールドが含まれます。

「アプリ2名」
アプリケーションの名前。Red Hat系およびDebian系のLinuxゲストの場合、
これはパッケージ名です。

「app2_display_name」
アプリケーションの表示名。インストール言語に合わせてローカライズされる場合もあります。
ゲスト オペレーティング システム。

利用できない場合は、空の文字列 "" が返されます。
代わりに「app2_name」を使用できます。

「app2_epoch」
エポックを使用するパッケージマネージャの場合、これにはパッケージのエポック（
整数）。利用できない場合は 0 が返されます。

「app2_バージョン」
アプリケーションまたはパッケージのバージョン文字列。入手できない場合は、次のように返されます。
空の文字列 ""。

「app2_リリース」
これを利用するパッケージ マネージャーのアプリケーションまたはパッケージのリリース文字列。
利用できない場合は、空の文字列 "" が返されます。

「app2_arch」
アプリケーションまたはパッケージのアーキテクチャ文字列（使用するパッケージマネージャの場合）
利用できない場合は空の文字列 "" が返されます。

「app2_インストールパス」
アプリケーションのインストールパス（Windowsなどのオペレーティングシステムでは
インストールパスを使用します。このパスはゲストオペレーティングシステムで使用される形式です。
システムの場合、これは libguestfs パスではありません。

利用できない場合は、空の文字列 "" が返されます。

「app2_trans_path」
libguestfsパスに変換されたインストールパス。利用できない場合はこれが返されます
空の文字列 "" として

「app2_publisher」
アプリケーションの発行者名（パッケージマネージャがこれを使用する場合）。
利用できない場合は、空の文字列 "" として返されます。

「app2_url」
アプリケーションのURL（例：アップストリームURL）。利用できない場合は、
空の文字列 ""。

「app2_ソース_パッケージ」
これをサポートするパッケージングシステムの場合、ソースパッケージの名前。
利用できない場合は、空の文字列 "" として返されます。

「app2_サマリー」
アプリケーションまたはパッケージの短い（通常は1行）説明。
これは空の文字列 "" として返されます。

「app2_description」
アプリケーションまたはパッケージの詳細な説明。入手できない場合は、この説明が返されます。
空の文字列 "" として

「検査」をお読みください ゲスト（3）詳細については。

検査OS
検査OS

この関数は他のlibguestfs関数と特定のヒューリスティックを使用して、
ディスク (通常は仮想マシンに属するディスク) でオペレーティング システムを検索します。

オペレーティング システムが見つからない場合、返されるリストは空になります。

1つのオペレーティングシステムが見つかった場合、これは1つの要素を持つリストを返します。
このオペレーティングシステムのルートファイルシステムの名前です。
複数の要素を含むリストを返す関数。これはデュアルブートまたは
マルチブート仮想マシンで、各要素は、
オペレーティングシステム。

返されたルート文字列を他の「inspect-get-*」関数に渡すことで、
名前やバージョンなど、各オペレーティング システムに関する詳細情報を照会します。

この関数は、"mount-ro"や"umount-all"などの他のlibguestfs機能を使用して、
ファイルシステムをマウントおよびアンマウントし、内容を確認します。これは、
現在マウントされているディスク。この関数はAugeasも使用する可能性があるため、既存のAugeasハンドルは
閉鎖されます。

この関数は暗号化されたディスクを復号できません。呼び出し側はまず復号を行う必要があります（
ディスクが暗号化されている場合は、必要なキーが必要になります。

「検査」をお読みください ゲスト（3）詳細については。

「list-filesystems」も参照してください。

ブロックデバイス
ブロックデバイスオプション
is-blockdev パス [followsymlinks:true|false]

指定された「パス」名を持つブロック デバイスが存在する場合にのみ、「true」を返します。

オプションフラグ「followsymlinks」がtrueの場合、
ブロックデバイスで終了する場合も、関数は true を返します。

この呼び出しはゲストファイルシステム内のファイルのみを参照します。Libguestfsパーティションと
ブロックデバイス（例： / dev / sdaに) は、この呼び出しの「パス」パラメータとして使用できません。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

イス・チャーデフ
is-chardev-opts
is-chardev パス [followsymlinks:true|false]

指定された「パス」名を持つ文字デバイスが存在する場合にのみ、「true」を返します。

オプションフラグ「followsymlinks」がtrueの場合、
chardev で終わる場合も、関数は true を返します。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

is-config
is-config

このハンドルが構成されている場合 (「CONFIG」状態)、 true を返します。

州の詳細については、 ゲストとします。

is-dir
is-dir-opts
is-dir パス [followsymlinks:true|false]

指定された「パス」名のディレクトリが存在する場合にのみ「true」を返します。注
ファイルなどの他のオブジェクトに対しては false を返します。

オプションフラグ「followsymlinks」がtrueの場合、
ディレクトリで終わる場合も、関数は true を返します。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

is-fifo
is-fifo-opts
is-fifo パス [followsymlinks:true|false]

これは、指定された「パス」を持つFIFO（名前付きパイプ）が存在する場合にのみ「true」を返します。
名前。

オプションフラグ「followsymlinks」がtrueの場合、
FIFO で終わる場合も、関数は true を返します。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

is-file
ファイルオプション
ファイルパス [followsymlinks:true|false]

指定された「パス」名を持つ通常のファイルが存在する場合にのみ、「true」を返します。
ディレクトリなどの他のオブジェクトの場合は false を返すことに注意してください。

オプションフラグ「followsymlinks」がtrueの場合、
ファイルで終わる場合も、関数は true を返します。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

is-lv
is-lvデバイス

このコマンドは「デバイス」が論理ボリュームであるかどうかをテストし、これが論理ボリュームである場合にtrueを返します。
場合。

ソケット
ソケットオプション
ソケットパス [followsymlinks:true|false]

これは、指定された「パス」を持つUnixドメインソケットが存在する場合にのみ「true」を返します。
名前。

オプションフラグ「followsymlinks」がtrueの場合、
ソケットで終了した場合も、関数は true を返します。

「stat」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

シンボリックリンク
シンボリックリンクパス

指定された「パス」名を持つシンボリック リンクが存在する場合にのみ、「true」を返します。

「stat」も参照してください。

is-全デバイス
デバイス全体であるデバイス

これは、「デバイス」がブロックデバイス全体を指す場合にのみ「true」を返します。つまり、
パーティションまたは論理デバイス。

ゼロ
ゼロパス

ファイルが存在し、そのファイルが空であるか、すべてゼロバイトである場合にのみ true を返します。

ゼロデバイス
is-zero-device デバイス

デバイスが存在し、すべてゼロバイトが含まれている場合にのみ true を返します。

大型デバイスの場合、実行に長い時間がかかる可能性があることに注意してください。

アイソインフォ
isoinfo isofile

これは「isoinfo-device」と同じですが、ISOファイルに対して機能します。
他のマウントされたファイルシステム。ISOファイルを追加した一般的なケースでは、
libguestfsデバイスとしてファイルを作成する場合は、 これを呼び出します。代わりに「isoinfo-
デバイス"。

isoinfoデバイス
isoinfo-device デバイス

「デバイス」はISOデバイスです。これはプライマリデバイスから読み取った情報の構造体を返します。
デバイスのボリューム記述子 (スーパーブロックの ISO 版)。

通常は、 アイソインフォ(1) コマンド -d ホスト上のオプション
libguestfs を経由する代わりに、ISO ファイルを分析します。

プライマリボリューム記述子フィールドの詳細については、
http://wiki.osdev.org/ISO_9660#プライマリボリューム記述子

ジャーナルクローズ
ジャーナルクローズ

ジャーナル ハンドルを閉じます。

ジャーナル取得
ジャーナル取得

現在のジャーナルエントリを読み取ります。ジャーナル内のすべてのフィールドを次のセットとして返します。
「(attrname, attrval)」のペア。「attrname」はフィールド名（文字列）です。

「attrval」はフィールド値（バイナリBLOB、多くの場合文字列ですが必ずしも文字列ではありません）です。
「attrval」はバイト配列であることに注意してください。 \0 で終了する C 文字列。

データの長さは、データしきい値に切り捨てられる可能性があります（「journal-set-data-
しきい値」、「journal-get-data-threshold」など)。

データしきい値を無制限（0）に設定すると、この呼び出しは次のジャーナルエントリを読み取ることができます。
任意のサイズ。つまり、libguestfs プロトコルによって制限されません。

ジャーナル取得データしきい値
ジャーナル取得データしきい値

ジャーナルエントリの読み取りに必要な現在のデータしきい値を取得します。これはジャーナルへのヒントです。
読み込む際にデータフィールドがこのサイズに切り捨てられる可能性があることに注意してください（また、
切り捨てます。これが 0 を返す場合、しきい値は無制限です。

「journal-set-data-threshold」も参照してください。

ジャーナル-get-realtime-usec
ジャーナル-get-realtime-usec

現在のジャーナル エントリのリアルタイム (壁時計) タイムスタンプを取得します。

ジャーナル・ネクスト
ジャーナル・ネクスト

次のジャーナルエントリに移動します。ジャーナルを開いた後、少なくとも1回は呼び出す必要があります。
データを読み取る前に処理する必要があります。

返されるブール値は、読み取るジャーナル レコードがさらにあるかどうかを示します。「true」
「false」は次のレコードを読み取れることを意味します（例えば「journal-get」を使用）。
日記の最後まで読みました。

ジャーナルオープン
ジャーナルオープンディレクトリ

以下の場所にあるsystemdジャーナルを開きます。 ディレクトリにジョブを開始します。以前に開かれたジャーナルハンドルは
閉じた。

ジャーナルの内容は、「journal-next」と「journal-get」を使用して読み取ることができます。

ジャーナルの使用を終えたら、次のように呼び出してハンドルを閉じる必要があります。
「ジャーナルクローズ」。

ジャーナル セット データしきい値
ジャーナルセットデータしきい値

ジャーナルエントリの読み取りに使用するデータしきい値を設定します。これはジャーナルにとって、
読み込む際にデータフィールドをこのサイズに切り捨てる場合があります（ただし、
切り捨てられます。これを 0 に設定すると、しきい値は無制限になります。

「journal-get-data-threshold」も参照してください。

ジャーナルスキップ
ジャーナルスキップスキップ

ジャーナル内を前方（"skip ≥ 0"）または後方（"skip < 0"）にスキップします。

実際にスキップされたエントリの数が返されます（「rskip ≥ 0」に注意してください）。これが
渡したスキップパラメータ（「|skip|」）の絶対値と同じであれば、それは
ジャーナルの最後または最初に到達しました。

サブプロセスを強制終了する
サブプロセスを強制終了する

これによりハイパーバイザーが停止します。

これを呼び出してはいけません。代わりに「shutdown」を参照してください。

この function is 非推奨。 新しいコードでは、代わりに「shutdown」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

起動する
ラン
起動する

ハンドルを設定した後（ドライブの追加など）、
何らかのアクションを実行します。

同じハンドルで「launch」を2回呼び出さないでください。エラーは発生しませんが（
歴史的な理由により、これを実行した場合の正確な動作は明確に定義されていません。
作成コストは非常に低いため、起動ごとに新しいものを作成します。

イチョウン
lchown 所有者グループパス

ファイルの所有者を「owner」に、グループを「group」に変更します。これは「chown」に似ていますが、「path」が
シンボリックリンクの場合は、ターゲットではなくリンク自体が変更されます。

数値のUIDとGIDのみがサポートされています。名前を使用する場合は、
パスワード ファイルを自分で解析します (Augeas サポートにより、これは比較的簡単に行えます)。

ldmtool-create-all
ldmtool-create-all

この機能は、すべてのブロックデバイスをスキャンしてWindowsのダイナミックディスクボリュームを検索し、
パーティションを作成し、見つかったものに対してデバイスを作成します。

すべてのデバイスを返すには、「list-ldm-volumes」と「list-ldm-partitions」を呼び出します。

あなたが しない これは自動的に実行されるため、通常は明示的に呼び出す必要があります。
「起動」時に。ただし、ホットプラグした場合はこの関数を呼び出す必要があるかもしれません。
ディスクがある場合、または Windows ダイナミック ディスクを作成したばかりの場合。

ldmtool-diskgroup-disks
ldmtool-diskgroup-disks ディスクグループ

Windowsダイナミックディスクグループ内のディスクを返します。「diskgroup」パラメータは
ディスク グループの GUID。「ldmtool-scan」によって返されるリストの 1 つの要素。

ldmtool ディスクグループ名
ldmtool-diskgroup-name ディスクグループ

Windowsダイナミックディスクグループの名前を返します。「diskgroup」パラメータは
ディスク グループの GUID。「ldmtool-scan」によって返されるリストの 1 つの要素。

ldmtool-ディスクグループ-ボリューム
ldmtool-diskgroup-volumes ディスクグループ

Windowsダイナミックディスクグループ内のボリュームを返します。「diskgroup」パラメータは
ディスク グループの GUID。これは、「ldmtool-scan」によって返されるリストの 1 つの要素です。

ldmtool-remove-all
ldmtool-remove-all

これは本質的に「ldmtool-create-all」の逆です。デバイスマッパーを削除します。
すべての Windows ダイナミック ディスク ボリュームのマッピング

ldmtool-スキャン
ldmtool-スキャン

この関数はWindowsのダイナミックディスクをスキャンし、識別子（GUID）のリストを返します。
見つかったすべてのディスクグループについて。これらの識別子は他の「ldmtool-*」に渡すことができます。
機能します。

この関数はすべてのブロックデバイスをスキャンします。ブロックデバイスのサブセットをスキャンするには、「ldmtool-
代わりに「scan-devices」を使用してください。

ldmtool-スキャンデバイス
ldmtool-scan-devices 'デバイス...'

この関数はWindowsのダイナミックディスクをスキャンし、識別子（GUID）のリストを返します。
見つかったすべてのディスクグループについて。これらの識別子は他の「ldmtool-*」に渡すことができます。
機能します。

パラメータ「devices」は、スキャンされるブロックデバイスのリストです。このリストが
空の場合、すべてのブロックデバイスがスキャンされます。

ldmtool-ボリュームヒント
ldmtool-volume-hint ディスクグループボリューム

GUIDのディスクグループ内の「volume」という名前のボリュームのヒントフィールドを返します。
「ディスクグループ」。定義されていない場合は空の文字列が返されます。
ヒント フィールドは、常にではありませんが、多くの場合、Windows ドライブの名前 (例:「E:」) になります。

ldmtool-ボリュームパーティション
ldmtool-ボリューム-パーティション ディスクグループ ボリューム

GUIDのディスクグループ内の「volume」という名前のボリューム内のパーティションのリストを返します。
「ディスクグループ」。

ldmtool-ボリュームタイプ
ldmtool-ボリュームタイプ ディスクグループ ボリューム

GUID が「diskgroup」のディスク グループ内の「volume」という名前のボリュームのタイプを返します。

ここで返される可能性のあるボリュームタイプには、「シンプル」、「スパン」、「ストライプ」などがあります。
「mirrored」、「raid5」。他のタイプも返される場合があります。

lgetxattr
lgetxattr パス名

ファイル「path」から「name」という名前の拡張属性を1つ取得します。「path」がシンボリックリンクの場合、
この呼び出しはシンボリックリンクから拡張属性を返します。

通常、ファイルからすべての拡張属性を一度に取得するには、
しかし、Linuxファイルシステムの実装にはバグがあり、
属性の一覧表示方法。これらのファイルシステム（特にntfs-3g）では、
事前に必要な拡張属性の名前を指定して、この関数を呼び出します。

拡張属性値はバイナリデータの塊です。拡張属性がない場合
「name」という名前の場合、エラーが返されます。

参照: 「lgetxattrs」、「getxattr」 ATTRとします。

lgetxattrs
lgetxattrs パス

これは「getxattrs」と同じですが、「path」がシンボリックリンクの場合は、
リンク自体の拡張属性。

リスト9ページ
リスト9ページ

ゲストに接続されているすべての9pファイルシステムを一覧表示します。マウントタグのリストが返されます。

デバイスのリスト
デバイスのリスト

すべてのブロックデバイスを一覧表示します。

完全なブロックデバイス名が返されます。例: / dev / sdaに.

「list-filesystems」も参照してください。

ディスクラベルの一覧
ディスクラベルの一覧

「add-drive-opts」のオプションの「label」パラメータを使用してドライブを追加する場合は、
この呼び出しは、ディスクラベルと生のブロックデバイスおよびパーティション名（
/ dev / sdaに 　 の/ dev / sda1).

これはハッシュテーブルを返します。キーはディスクラベルです（無し 　 /dev/disk/guestfs
プレフィックス）、値は完全な生のブロック デバイスとパーティション名です（例： / dev / sdaに
　 の/ dev / sda1).

DMデバイスのリスト
DMデバイスのリスト

すべてのデバイス マッパー デバイスを一覧表示します。

返されるリストには以下が含まれます /dev/mapper/* デバイス、例えば、以前の呼び出しによって作成されたもの
「luks-open」。

論理ボリュームに対応するデバイスマッパーデバイスは このリストに返されます。
論理ボリュームを一覧表示したい場合は、「lvs」を呼び出します。

ファイルシステムのリスト
ファイルシステムのリスト

この検査コマンドは、パーティション、ブロックデバイス、論理上のファイルシステムを検索します。
ボリューム、ファイルシステムとそのタイプを含む「マウント可能」のリストを返します。

戻り値はハッシュで、キーはファイルシステムを含むデバイスであり、
値はファイルシステムの種類です。例:

"/dev/sda1" => "ntfs"
"/dev/sda2" => "ext2"
"/dev/vg_guest/lv_root" => "ext4"
"/dev/vg_guest/lv_swap" => "スワップ"

キーは必ずしもブロックデバイスである必要はありません。また、不透明な「マウント可能な」文字列である場合もあります。
これを「mount」に渡すことができます。

値は「不明」という特別な値を持つ場合があり、これはデバイスの内容が
未確定または空。「swap」は Linux の swap パーティションを意味します。

このコマンドは、他のlibguestfsコマンド（「mount」や「umount」など）を実行します。
したがって、起動後すぐに、何もマウントされていない場合にのみこれを使用する必要があります。

返されるファイルシステムのすべてがマウント可能というわけではありません。特にスワップパーティションは
リストに返される。また、このコマンドは見つかった各ファイルシステムが
有効かつマウント可能ですが、一部のファイルシステムはマウント可能であっても特別なオプションが必要な場合があります。
ファイルシステムは、必ずしも単一の論理オペレーティングシステムに属しているとは限りません（「inspect-os」を使用して
OS を検索してください。

リスト-ldm-パーティション
リスト-ldm-パーティション

この関数は、起動時に見つかったすべての Windows ダイナミック ディスク パーティションを返します。
デバイス名のリストを返します。

リスト-ldm-ボリューム
リスト-ldm-ボリューム

この関数は起動時に見つかったすべてのWindowsダイナミックディスクボリュームを返します。
デバイス名のリストを返します。

mdデバイスのリスト
mdデバイスのリスト

すべての Linux md デバイスを一覧表示します。

リストパーティション
リストパーティション

すべてのブロック デバイスで検出されたすべてのパーティションを一覧表示します。

完全なパーティションデバイス名が返されます。例: の/ dev / sda1

これは論理ボリュームを返しません。論理ボリュームを返すには、「lvs」を呼び出す必要があります。

「list-filesystems」も参照してください。

ll
llディレクトリ

ファイルを一覧表示する ディレクトリにジョブを開始します。 （ルートディレクトリからの相対パス、cwdはありません）
'ls -la' の形式。

このコマンドは主に対話型セッションで役立ちます。 試してみることを意図した
出力文字列を解析します。

llz
llzディレクトリ

ファイルを一覧表示する ディレクトリにジョブを開始します。 'ls -laZ' の形式で。

このコマンドは主に対話型セッションで役立ちます。 試してみることを意図した
出力文字列を解析します。

ln
ln ターゲットリンク名

このコマンドは、「ln」コマンドを使用してハードリンクを作成します。

ln-f
ln-f ターゲット リンク名

このコマンドは「ln -f」コマンドを使用してハードリンクを作成します。 -f オプションはを削除します
リンク ("linkname") がすでに存在する場合。

ln-s
ln-s ターゲットリンク名

このコマンドは、「ln -s」コマンドを使用してシンボリック リンクを作成します。

ln-sf
ln-sf ターゲットリンク名

このコマンドは「ln -sf」コマンドを使用してシンボリックリンクを作成します。 -f オプションはを削除します
リンク ("linkname") がすでに存在する場合。

lremovexattr
lremovexattr xattr パス

これは「removexattr」と同じですが、「path」がシンボリックリンクの場合は、
リンク自体の拡張属性。

ls
lsディレクトリ

ファイルを一覧表示する ディレクトリにジョブを開始します。 (ルート ディレクトリに対して相対的であるため、cwd はありません)。 '.'
および '..' エントリは返されませんが、隠しファイルは表示されます。

ls0
ls0 dir (ファイル名|-)

この特殊なコマンドは、ディレクトリ「dir」内のファイル名のリストを取得するために使用されます。
ファイル名のリストはローカルファイルに書き込まれます ファイル名 (ホスト上)

出力ファイルでは、ファイル名は「\0」文字で区切られます。

「.」と「..」は返されません。ファイル名はソートされません。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

lsetxattr
lsetxattr xattr val vallen パス

これは「setxattr」と同じですが、「path」がシンボリックリンクの場合は拡張された
リンク自体の属性。

lstat
lstatパス

指定された「パス」のファイル情報を返します。

これは「stat」と同じですが、「path」がシンボリックリンクの場合、リンクは
参照するファイルではなく、stat されたファイルです。

これはと同じです lstat（2）システムコール。

この function is 非推奨。 新しいコードでは、代わりに "lstatns" 呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

lstatlist
lstatlist パス 'names ...'

この呼び出しにより、複数のファイルに対して「lstat」操作を実行できます。すべてのファイルは
ディレクトリ「path」にあります。「names」はこのディレクトリのファイルのリストです。

戻り値には、"names"に1対1で対応するstat構造体のリストが返されます。
リスト。名前が存在しないか、lstat できなかった場合、そのリストの「st_ino」フィールドは
構造は「-1」に設定されています。

この呼び出しは、ディレクトリの内容を効率的に一覧表示したいプログラムを対象としています。
何度も往復することなく。同様に効率的な呼び出しについては「lxattrlist」も参照してください。
拡張属性を取得します。

この function is 非推奨。 新しいコードでは、代わりに「lstatnslist」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

イスタトン
lstatnsパス

指定された「パス」のファイル情報を返します。

これは「statns」と同じですが、「path」がシンボリックリンクの場合、リンクは
参照するファイルではなく、stat されたファイルです。

これはと同じです lstat（2）システムコール。

lstatnslist
lstatnslist パス 'names ...'

この呼び出しにより、複数のファイルに対して「lstatns」操作を実行できます。すべてのファイルは
ディレクトリ「path」にあります。「names」はこのディレクトリのファイルのリストです。

戻り値には、"names"に1対1で対応するstat構造体のリストが返されます。
リスト。名前が存在しないか、lstat できなかった場合、そのリストの「st_ino」フィールドは
構造は「-1」に設定されています。

この呼び出しは、ディレクトリの内容を効率的に一覧表示したいプログラムを対象としています。
何度も往復することなく。同様に効率的な呼び出しについては「lxattrlist」も参照してください。
拡張属性を取得します。

luks-add-key
luks-add-key デバイス キースロット

このコマンドは、LUKSデバイス「device」に新しいキーを追加します。「key」は既存のキーで、
デバイスへのアクセスに使用されます。「newkey」は追加する新しいキーです。「keyslot」はキースロットです
置き換えられます。

「keyslot」にすでにキーが含まれている場合、このコマンドは失敗します。
まず「luks-kill-slot」を使用してそのキーを削除します。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

luks-close
luks-closeデバイス

これは、「luks-open」または「luks-open-ro」によって作成されたLUKSデバイスを閉じます。
「device」パラメータは、LUKS マッピングデバイスの名前である必要があります (つまり、 /dev/mapper/マップ名)
　 基礎となるブロックデバイスの名前。

luksフォーマット
luks形式のデバイスキース​​ロット

このコマンドは「デバイス」上の既存のデータを消去し、デバイスをLUKS暗号化デバイスとしてフォーマットします。
デバイス。「key」はキースロット「slot」に追加される初期キーです。（LUKSは8つの
キースロット（0～7の番号）。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

luks形式の暗号
luks-format-cipher デバイスキース​​ロット暗号

このコマンドは「luks-format」と同じですが、使用する「暗号」も設定できます。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

luks-kill-slot
luks-kill-slotデバイスキース​​ロット

このコマンドは、暗号化されたLUKSデバイスからキースロット「keyslot」内のキーを削除します。
「デバイス」。「キー」は次のいずれかである必要があります。 その他 キー。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

luks-オープン
luks-openデバイスマップ名

このコマンドは、Linux Unified 暗号化規格に従って暗号化されたブロックデバイスを開きます。
キーセットアップ（LUKS）標準。

「デバイス」は暗号化されたブロックデバイスまたはパーティションです。

呼び出し側は、LUKSブロックデバイスに関連付けられたキーの1つを「キー」に指定する必要があります。
パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

これにより、新しいブロックデバイスが作成されます。 /dev/mapper/マップ名. これに読み書きする
ブロック デバイスは、それぞれ基礎となる「デバイス」から復号化され、基礎となる「デバイス」に暗号化されます。

このブロックデバイスにLVMボリュームグループが含まれている場合、「vgscan」に続いて「vg-
「activate-all」を実行すると、それらが表示されます。

すべてのデバイス マッパー デバイスを一覧表示するには、「list-dm-devices」を使用します。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

luks-open-ro
luks-open-ro デバイスマップ名

これは、読み取り専用マッピングが作成される点を除いて、「luks-open」と同じです。

このコマンドには1つ以上のキーまたはパスフレーズパラメータがあります。Guestfishは
これらを別々に。

lvcreate
lvcreate logvol volgroup MBytes

これにより、ボリュームグループ「volgroup」上に「logvol」というLVM論理ボリュームが作成され、
「サイズ」メガバイト。

lvcreate-free
lvcreate-free logvol volgroup パーセント

LVM論理ボリュームを作成します /dev/volgroup/logvol約「パーセント」%を使用
ボリュームグループに残っている空き容量の割合。「パーセント」が100の場合に最も便利です。
これにより、可能な限り最大の LV が作成されます。

lvm-canonical-lv-name
lvm-canonical-lv-name lvname

これは、LVの代替命名スキームを標準的なものに変換します。
名前。例えば、 /dev/mapper/VG-LV に変換される / dev / VG / LV.

このコマンドは、「lvname」パラメータが論理名を参照していない場合、エラーを返します。
ボリューム。

「is-lv」、「canonical-device-name」も参照してください。

lvm クリアフィルター
lvm クリアフィルター

これにより、「lvm-set-filter」の効果は解除されます。LVM はすべてのブロックデバイスを認識できるようになります。

このコマンドは、LVM キャッシュをクリアし、ボリューム グループ スキャンも実行します。

lvm-remove-all
lvm-remove-all

このコマンドは、すべての LVM 論理ボリューム、ボリューム グループ、および物理ボリュームを削除します。

lvm-set-filter
lvm-set-filter 'デバイス...'

これはLVMデバイスフィルタを設定し、LVMがブロックデバイスのみを「見る」ことができるようにします。
リスト「デバイス」に含まれ、接続されている他のすべてのブロック デバイスは無視されます。

ディスクイメージに重複したPVまたはVGが含まれている場合、このコマンドはLVMを
重複を無視してください。そうしないとLVMが混乱する可能性があります。また、重複には2つの種類があります。
重複の可能性あり: 同一のUUIDを持つクローンPV/VG、または
クローンではなく、たまたま同じ名前になっているだけです。通常の操作では、
この状況では、LVMの外部で、例えばディスクイメージのクローンやビット単位で実行できます。
LVM メタデータ内部をいじります。

このコマンドは、LVM キャッシュをクリアし、ボリューム グループ スキャンも実行します。

ブロック デバイス全体または個々のパーティションをフィルターできます。

VGが現在使用中の場合（例：マウントされたファイルシステムが含まれている場合）はこれを使用できません。
VG をフィルタリングしない場合でも同様です。

lvremove
lvremoveデバイス

LVM論理ボリューム「デバイス」を削除します。「デバイス」はLVへのパスです。例:
/ dev / VG / LV.

VG名を指定してボリュームグループ内のすべてのLVを削除することもできます。 /dev/VG.

lvrename
lvrename logvol newlogvol

論理ボリューム「logvol」の名前を新しい名前「newlogvol」に変更します。

lvresize
lvresizeデバイス（メガバイト）

既存のLVM論理ボリュームのサイズを「メガバイト」に変更（拡大または縮小）します。
削減すると、削減された部分のデータが失われます。

lvresize-free
lvresize-free lv パーセント

これは既存の論理ボリューム「lv」を拡張し、残りの空き領域の「pc」%を埋めます。
ボリュームグループ内のスペース。通常はpc = 100で呼び出し、
ボリューム グループ内の残りの空き領域をすべて使用して、論理ボリュームを可能な限り拡張します。

lvs
lvs

検出されたすべての論理ボリュームを一覧表示します。これは、 lvs（8）コマンド。

これは論理ボリュームデバイス名のリストを返します (例: /dev/VolGroup00/LogVol00).

「lvs-full」、「list-filesystems」も参照してください。

レベルフル
レベルフル

検出されたすべての論理ボリュームを一覧表示します。これは、 lvs（８）命令。
「フル」バージョンにはすべてのフィールドが含まれます。

lvuuid
lvuuidデバイス

このコマンドは、LVM LV「デバイス」の UUID を返します。

lxattrlist
lxattrlist パス 'names ...'

この呼び出しにより、複数のファイルの拡張属性を取得できます。すべてのファイルは
ディレクトリ「path」内。「names」はこのディレクトリのファイルのリストです。

返されるときに、順番に解釈する必要がある xattr 構造体のフラットなリストが取得されます。
最初のxattr構造体は常に長さ0の「attrname」を持ちます。この構造体の「attrval」は
このファイルに対して「lgetxattr」を実行中にエラーが発生したことを示すゼロ長さ。 or はCです
10進数の文字列（このファイルの次の属性の数、
最初のxattr構造体の後に、0個以上の属性が続きます。
最初の名前付きファイル。2番目以降のファイルについても同様に繰り返します。

この呼び出しは、ディレクトリの内容を効率的に一覧表示したいプログラムを対象としています。
何度も往復することなく。同様に効率的な呼び出しについては「lstatlist」も参照してください。
標準的な統計を取得します。

最大ディスク
最大ディスク

ハンドルに追加できるディスクの最大数を返します（例："add-drive-opts"）
および同様の呼び出し。

この関数はlibguestfs 1.19.7で追加されました。libguestfsの以前のバージョンでは、
制限は25でした。

「ディスクの最大数」を参照してください ゲスト（３）このテーマに関する追加情報については、

md-create
md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [level:..]

リスト「devices」内のデバイスに「name」という名前の Linux md (RAID) デバイスを作成します。

オプションのパラメータは次のとおりです。

「ビットマップがありません」
不足しているデバイスのビットマップ。ビットが設定されている場合は、不足しているデバイスが追加されたことを意味します。
配列に追加します。最下位ビットは配列の最初のデバイスに対応します。

例として：

「devices = ["/dev/sda"]」かつ「missingbitmap = 0x1」の場合、結果の配列は次のようになります。
なれ "[ , "/dev/sda"]"。

「devices = ["/dev/sda"]」かつ「missingbitmap = 0x2」の場合、結果の配列は次のようになります。
"["/dev/sda", ]」を参照してください。

デフォルトは 0 (不足しているデバイスなし) です。

「デバイス」の長さ + 「missingbitmap」に設定されているビット数は等しくなければなりません
「nrdevices」+「spare」。

「nrデバイス」
アクティブな RAID デバイスの数。

設定されていない場合は、デフォルトで「デバイス」の長さと、
「ビットマップがありません」。

"スペア"
予備デバイスの数。

設定されていない場合はデフォルトで 0 になります。

"かたまり"
チャンク サイズ (バイト単位)。

"レベル"
RAID レベルは次のいずれかになります: 線形, raid0, 0, ストライプ, raid1, 1, ミラー,
raid4, 4, raid5, 5, raid6, 6, raid10, 10これらのいくつかは同義語であり、
将来的にレベルが追加される可能性があります。

設定されていない場合は、デフォルトで「raid1」になります。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

md-詳細
md-詳細 md

このコマンドは、「mdadm -DY」の出力を公開します。 '。以下のフィールドは通常
返されるハッシュに存在します。他のフィールドも存在する場合があります。

"レベル"
MD デバイスの RAID レベル。

「デバイス」
MD デバイス内の基礎となるデバイスの数。

「メタデータ」
使用されるメタデータのバージョン。

「UUID」
MD デバイスの UUID。

"名前"
MD デバイスの名前。

md-stat
md-stat md

この呼び出しは、単一のソフトウェアRAIDを構成する基礎となるデバイスのリストを返します。
アレイデバイス「md」。

ソフトウェア RAID デバイスのリストを取得するには、「list-md-devices」を呼び出します。

返される各構造体は、追加のステータスとともに1つのデバイスに対応します。
情報：

「mdstat_デバイス」
基盤となるデバイスの名前。

「mdstat_index」
配列内のこのデバイスのインデックス。

「mdstat_flags」
このデバイスに関連付けられたフラグ。これは以下の文字列（順不同）です。
次のフラグの 0 個以上:

「W」は主に書く

「F」デバイスに障害があります

「S」デバイスはRAIDスペアです

「R」の置き換え

mdストップ
md-stop md

このコマンドは、「md」という名前のMDアレイを非アクティブ化します。デバイスは停止しますが、
破壊またはゼロ化されました。

mkdir
mkdirパス

「path」という名前のディレクトリを作成します。

mkdirモード
mkdir-mode パスモード

このコマンドはディレクトリを作成し、そのディレクトリの初期権限を次のように設定します。
"モード"。

一般的なLinuxファイルシステムの場合、実際に設定されるモードは「mode & ~umask &
01777"。非ネイティブ Linux ファイルシステムでは、モードが別の方法で解釈される場合があります。

「mkdir」、「umask」も参照してください

mkdir-p
mkdir-p パス

「path」という名前のディレクトリを作成し、必要に応じて親ディレクトリを作成します。これは
「mkdir -p」シェルコマンドのように。

mkdtemp
mkdtemp tmpl

このコマンドは一時ディレクトリを作成します。「tmpl」パラメータは完全な
最後の 6 文字が "XXXXXX" である一時ディレクトリ名のパス名。

例えば、「/tmp/myprogXXXXXX」または「/Temp/myprogXXXXXX」、後者が適切です。
Windows ファイルシステム用。

作成された一時ディレクトリの名前が返されます。

一時ディレクトリはモード 0700 で作成され、root が所有します。

呼び出し元は、使用後に一時ディレクトリとその内容を削除する責任があります。

も参照してください。 mkdtemp(3)

mke2fs
mke2fs デバイス [ブロック数:N] [ブロックサイズ:N] [フラグサイズ:N] [グループあたりのブロック数:N] [グループ数:N] [ノードあたりのバイト数:N] [inodeサイズ:N] [ジャーナルサイズ:N] [inode数:N] [ストライドサイズ:N] [ストライプ幅:N] [最大オンラインサイズ:N] [予約ブロック率:N] [mmpupdateinterval:N] [ジャーナルデバイス:..] [ラベル:..] [最後にマウントされたディレクトリ:..] [creatoros:..] [ファイルシステムタイプ:..] [使用タイプ:..] [UUID:..] [forcecreate:true|false] [writesbandgrouponly:true|false] [lazyitableinit:true|false] [lazyjournalinit:true|false] [testfs:true|false] [discard:true|false] [quotatype:true|false] [extent:true|false] [filetype:true|false] [flexbg:true|false] [hasjournal:true|false] [journaldev:true|false] [largefile:true|false] [quota:true|false] [resizeinode:true|false] [sparsesuper:true|false] [uninitbg:true|false]

「mke2fs」は、「デバイス」上に ext2、ext3、または ext4 ファイルシステムを作成するために使用されます。

オプションの「blockscount」はファイルシステムのサイズをブロック単位で指定します。省略した場合は
デフォルトは「デバイス」のサイズです。ファイルシステムが小さすぎて
ジャーナルでは、代わりに「mke2fs」が ext2 ファイルシステムを黙って作成します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

mke2fs-J
mke2fs-J fstype ブロックサイズ デバイス ジャーナル

これは「デバイス」上にext2/3/4ファイルシステムを作成し、「ジャーナル」上に外部ジャーナルを作成します。
は次のコマンドと同等です:

mke2fs -t fstype -b ブロックサイズ -J デバイス=

「mke2journal」も参照してください。

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mke2fs-JL
mke2fs-JL fstype ブロックサイズ デバイスラベル

これは、ジャーナルに外部ジャーナルを持つ「デバイス」上に ext2/3/4 ファイルシステムを作成します。
「ラベル」というラベルが付けられています。

「mke2journal-L」も参照してください。

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mke2fs-JU
mke2fs-JU ファイルタイプ ブロックサイズ デバイス UUID

これは、ジャーナルに外部ジャーナルを持つ「デバイス」上に ext2/3/4 ファイルシステムを作成します。
UUIDは「uuid」です。

「mke2journal-U」も参照してください。

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mke2journal
mke2journal ブロッ​​クサイズデバイス

このコマンドは「デバイス」上に ext2 外部ジャーナルを作成します。これは以下のコマンドと同等です。

mke2fs -O journal_dev -b ブロックサイズデバイス

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mke2journal-L
mke2journal-L ブロックサイズ ラベル デバイス

これにより、「device」にラベル「label」の ext2 外部ジャーナルが作成されます。

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mke2journal-U
mke2journal-U ブロックサイズ UUID デバイス

これにより、UUID「uuid」を持つ「device」上に ext2 外部ジャーナルが作成されます。

この function is 非推奨。 新しいコードでは、代わりに「mke2fs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mkfifo
mkfifo モードパス

この呼び出しは、モードが「mode」である「path」という名前のFIFO（名前付きパイプ）を作成します。これは単なる
「mknod」を囲む便利なラッパー。

「mknod」とは異なり、「mode」 しなければなりません 権限ビットのみが含まれます。

実際に設定されるモードは umask によって影響を受けます。

mkfs
mkfs-opts
mkfs fstype デバイス [ブロックサイズ:N] [機能:..] [inode:N] [セクターサイズ:N] [ラベル:..]

この関数は「デバイス」上にファイルシステムを作成します。ファイルシステムの種類は「fstype」です。
例:「ext3」。

オプションの引数は次のとおりです。

「ブロックサイズ」
ファイルシステムのブロックサイズ。サポートされるブロックサイズはファイルシステムの種類によって異なりますが、
通常、Linux ext1024/2048 ファイルシステムの場合、これらは 4096、2、または 3 です。

VFAT および NTFS の場合、「blocksize」パラメータは要求されたクラスター サイズとして扱われます。

UFSブロックサイズについては、 mkfs.ufsとします。

"特徴"
これは -O 外部 mkfs プログラムへのパラメーター。

特定のファイルシステムの種類では、これにより追加のファイルシステム機能を選択できるようになります。
詳細はこちら： mke2fs（8）と mkfs.ufs（8）詳細については。

このオプション パラメータは、「gfs」または「gfs2」ファイルシステム タイプでは使用できません。

「iノード」
これは -I 外部パラメータ mke2fs(8) inodeを設定するプログラム
サイズ (現時点では ext2/3/4 ファイルシステムのみ)。

「セクターサイズ」
これは -S 外部パラメータ mkfs.ufs（8）セクターサイズを設定するプログラム
ufs ファイルシステム用。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

mkfs-b
mkfs-b fstype ブロックサイズ デバイス

この呼び出しは「mkfs」に似ていますが、ブロックサイズを制御できます。
結果として得られるファイルシステム。サポートされるブロックサイズはファイルシステムの種類によって異なりますが、通常は
それらは 1024、2048、または 4096 のみです。

VFAT および NTFS の場合、「blocksize」パラメータは要求されたクラスター サイズとして扱われます。

この function is 非推奨。 新しいコードでは、代わりに「mkfs」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mkfs-btrfs
mkfs-btrfs 'デバイス ...' [allocstart:N] [bytecount:N] [datatype:..] [leafsize:N] [label:..] [metadata:..] [nodesize:N] [sectorsize:N]

btrfsファイルシステムを作成し、すべての設定項目を設定できるようにします。詳細については、
オプションの引数については、 mkfs.btrfsとします。

btrfs ファイルシステムは複数のデバイスにまたがることができるため、空でないデバイスのリストが必要になります。

一般的なファイルシステムを作成するには、「mkfs」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

mk遺失物
mklost-and-found マウントポイント

通常は ext2/3/4 ファイルシステムのルート ディレクトリに「lost+found」ディレクトリを作成します。
「mountpoint」は、その下に「lost+found」ディレクトリを作成しようとするディレクトリです。

mkマウントポイント
mkmountpoint 免除パス

「mkmountpoint」と「rmmountpoint」は、追加のマウントポイントを作成するために使用できる特別な呼び出しです。
最初のファイルシステムをマウントする前にマウントポイントを設定します。

これらの呼び出しは の 非常に限られた状況で必要となる場合、主に
無関係なファイルシステムや読み取り専用ファイルシステムを組み合わせてマウントしたい場合。

例えば、ライブCDには、ファイルシステムの「ロシア人形」のようなネスト、ISOの外側の
レイヤーがあり、その中にsquashfsイメージがあり、その中にext2/3イメージがあります。解凍できます。
guestfish では次のようになります。

add-ro Fedora-11-i686-Live.iso
ラン
mkmountpoint /cd
mkmountpoint /sqsh
mkmountpoint /ext3fs
/dev/sda /cd をマウントする
マウントループ /cd/LiveOS/squashfs.img /sqsh
マウントループ /sqsh/LiveOS/ext3fs.img /ext3fs

内部ファイルシステムが /ext3fs マウントポイントの下に解凍されました。

「mkmountpoint」は「umount-all」と互換性がありません。予期しないエラーが発生する可能性があります。
これらの呼び出しを混在させないでください。ファイルシステムを手動でアンマウントして削除するのが最も安全です。
使用後のマウントポイント。

「umount-all」はパスが最も長い順にファイルシステムをアンマウントするので、これが機能するには
手動マウントポイントの場合、最も内側のマウントポイントが最も長いことを確認する必要があります。
上記のサンプルコードのように、パス名。

詳細については、https://bugzilla.redhat.com/show_bug.cgi?id=599503 を参照してください。

自動同期（「set-autosync」を参照してください。これはハンドルにデフォルトで設定されます）により、「umount-all」が
ハンドルが閉じられたときに呼び出され、これらの問題を引き起こす可能性もあります。

mknod
mknod モード devmajor devminor パス

この呼び出しは、ブロックまたは文字の特殊デバイス、または名前付きパイプ (FIFO) を作成します。

「mode」パラメータは標準定数を使用したモードである必要があります。「devmajor」と
「devminor」はデバイスのメジャー番号とマイナー番号で、ブロックを作成するときにのみ使用されます。
キャラクターの特殊デバイス。

注意してください、 mknod（2）モードはS_IFBLK、S_IFCHRとビット単位でOR演算される必要がある。
S_IFIFOまたはS_IFSOCK（それ以外の場合は、通常のファイルを作成するだけです）。これらの定数
標準のLinuxヘッダーファイルで利用可能です。または、「mknod-b」、「mknod-c」、または
「mkfifo」はこのコマンドのラッパーであり、適切なビットORで
あなたにとって一定です。

実際に設定されるモードは umask によって影響を受けます。

mknod-b
mknod-b モード devmajor devminor パス

この呼び出しは、モードが「mode」でデバイスが「path」というブロックデバイスノードを作成します。
メジャー/マイナーの「devmajor」と「devminor」。これは単に「mknod」を便利にラップしただけです。

「mknod」とは異なり、「mode」 しなければなりません 権限ビットのみが含まれます。

実際に設定されるモードは umask によって影響を受けます。

mknod-c
mknod-c モード devmajor devminor パス

この呼び出しは、モード「mode」とデバイスのメジャー/マイナーを持つ「path」という文字デバイスノードを作成します。
「devmajor」と「devminor」。これは単に「mknod」を便利にラップしただけです。

「mknod」とは異なり、「mode」 しなければなりません 権限ビットのみが含まれます。

実際に設定されるモードは umask によって影響を受けます。

mkswap
mkswap-opts
mkswap デバイス [ラベル:..] [uuid:..]

「デバイス」に Linux スワップ パーティションを作成します。

オプション引数「label」と「uuid」を使用すると、新しいラベルとUUIDを設定できます。
スワップパーティション。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

mkswap-L
mkswap-L ラベルデバイス

「device」にラベル「label」のスワップ パーティションを作成します。

ブロック デバイスにスワップ ラベルを添付することはできないことに注意してください (例: / dev / sdaに）、ちょうど
パーティション。これはカーネルまたはスワップツールの制限のようです。

この function is 非推奨。 新しいコードでは、代わりに「mkswap」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mkswap-U
mkswap-U uuid デバイス

UUID「uuid」で「device」にスワップ パーティションを作成します。

この function is 非推奨。 新しいコードでは、代わりに「mkswap」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

mkswapファイル
mkswapファイルパス

スワップファイルを作成します。

このコマンドは、既存のファイルにスワップファイルの署名を書き込むだけです。ファイルを作成するには
それ自体では、「fallocate」のようなものを使用します。

mktemp
mktemp tmpl [サフィックス:..]

このコマンドは一時ファイルを作成します。「tmpl」パラメータは、一時ファイルのフルパス名である必要があります。
最後の 6 文字が「XXXXXX」である一時ディレクトリ名。

例えば、「/tmp/myprogXXXXXX」または「/Temp/myprogXXXXXX」、後者が適切です。
Windows ファイルシステム用。

作成された一時ファイルの名前が返されます。

一時ファイルはモード 0600 で作成され、root が所有します。

使用後は呼び出し元が一時ファイルを削除する責任があります。

オプションの「suffix」パラメータが指定されている場合は、サフィックス（例：「.txt」）が
仮の名前。

「mkdtemp」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

modprobe
modprobe モジュール名

これにより、アプライアンスにカーネル モジュールがロードされます。

mount
マウント可能なマウントポイントをマウントする

ゲストディスクをファイルシステム内の任意の位置にマウントします。ブロックデバイスの名前は / dev / sdaに,
/ dev / sdb ゲストに追加されたブロックデバイスに
パーティションの場合は、通常の名前が付けられます (例: の/ dev / sda1）。また、LVM / dev / VG / LVスタイル
名前、または「list-filesystems」や「inspect-get-
「マウントポイント」。

ルールは mount（２）ファイルシステムはまずマウントされなければならない /
他のファイルシステムはマウントできません。他のファイルシステムは、すでにマウントされているディレクトリにのみマウントできます。
存在する。

マウントされたファイルシステムは、基盤となるファイルシステムに十分な権限がある場合、書き込み可能です。
デバイス。

libguestfs 1.13.16 より前では、この呼び出しによってオプション「sync」と「noatime」が暗黙的に追加されました。
「同期」オプションは書き込み速度を大幅に低下させ、ユーザーに多くの問題を引き起こしました。
プログラムはlibguestfsの古いバージョンで動作する必要があるかもしれないので、代わりに「mount-options」を使用してください。
(オプションが必要ない場合は、最初のパラメータに空の文字列を使用します)。

マウント-9p
mount-9p マウントタグ マウントポイント [オプション:..]

「mounttag」タグが付いた virtio-9p ファイルシステムを「mountpoint」ディレクトリにマウントします。

必要に応じて、「trans=virtio」が自動的にオプションに追加されます。その他のオプションは
必要な場合は、オプションの「options」パラメータで渡すことができます。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

マウントローカル
mount-local localmountpoint [読み取り専用:true|false] [オプション:..] [キャッシュタイムアウト:N] [デバッグコール:true|false]

この呼び出しは、libguestfs がアクセス可能なファイルシステムをローカルマウントポイント (ディレクトリ) にエクスポートします。
「localmountpoint」と呼ばれる。通常のファイルやディレクトリへの読み書きは、
「localmountpoint」は libguestfs を介してリダイレクトされます。

オプションの「readonly」フラグがtrueに設定されている場合、ファイルシステムへの書き込みはエラーを返します。
「EROFS」。

「options」はマウントオプションのカンマ区切りのリストです。 ゲストマウント（１）いくつかの有用な
オプション。

「cachetimeout」は、キャッシュされたディレクトリエントリのタイムアウト（秒単位）を設定します。デフォルトは
60秒。 ゲストマウント（1）詳細については。

「debugcalls」がtrueに設定されている場合、追加のデバッグ情報が生成されます。
すべての FUSE 呼び出し。

「mount-local」が返ってきたら、ファイルシステムは準備完了だが、リクエストは処理されていない。
(アクセスはブロックされます)。メインループを実行するには、「mount-local-run」を呼び出す必要があります。

「MOUNT LOCAL」を参照してください ゲスト（３）詳細な文書については、

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

マウントローカル実行
マウントローカル実行

カーネル呼び出しを libguestfs 呼び出しに変換するメイン ループを実行します。

これは「mount-local」が正常に終了した後にのみ呼び出す必要があります。
ファイルシステムがアンマウントされるまで戻ります。

注意 ログインする必要があります。 別のスレッドから同じハンドルに対して同時に libguestfs 呼び出しを実行します。

「mount-local」を呼び出したスレッドとは別のスレッドからこれを呼び出すことができます。
スレッドとlibguestfsの通常のルールに従う（「複数のハンドルと複数のスレッド」を参照）。
in ゲスト（3））。

「MOUNT LOCAL」を参照してください ゲスト（３）詳細な文書については、

マウントループ
マウントループファイルマウントポイント

このコマンドでマウントできます file （ファイル内のファイルシステムイメージ）をマウントポイントに置きます。
コマンド「mount -o loop file mountpoint」と完全に同等です。

マウントオプション
マウントオプション オプション マウント可能なマウントポイント

これは「mount」コマンドと同じですが、マウントオプションを設定できます。
　 mount(8) -o フラグ。

「options」パラメータが空の文字列の場合、オプションは渡されません（すべてのオプションが渡されます）。
デフォルトはファイルシステムが使用するものになります)。

マウントロ
mount-ro マウント可能なマウントポイント

これは「mount」コマンドと同じですが、ファイルシステムを読み取り専用でマウントします。
(-o ro） 国旗。

マウントvfs
mount-vfs オプション vfstype マウント可能なマウントポイント

これは「mount」コマンドと同じですが、マウントオプションの両方を設定できます。
そしてvfstypeは mount(8) -o 　 -t フラグ。

マウントポイント
マウントポイント

この呼び出しは「mounts」に似ています。その呼び出しはデバイスのリストを返します。これは
デバイス名とデバイスがマウントされているディレクトリのハッシュ テーブル (マップ)。

マウント
マウント

これは現在マウントされているファイルシステムのリストを返します。デバイスのリストを返します。
（例えば。 の/ dev / sda1, / dev / VG / LV).

一部の内部マウントは表示されません。

参照: 「マウントポイント」

mv
mv src dest

これはファイルを「src」から「dest」へ移動します。「dest」は移動先のファイル名または
宛先ディレクトリ。

「名前の変更」も参照してください。

nr デバイス
nr デバイス

追加されたブロックデバイスの数を返します。これは
「list-devices」を呼び出した場合に返されるデバイスの数。

追加できるデバイスの最大数を確認するには、「max-disks」を呼び出します。

ntfs-3g-プローブ
ntfs-3g-probe true|false デバイス

このコマンドは、 ntfs-3g.プローブ（8）NTFS「デバイス」を調査するコマンド
マウント可能。（すべてのNTFSボリュームが読み書きマウントできるわけではなく、一部はマウントできない
まったく）。

「rw」はブール値フラグです。ボリュームがマウント可能かどうかをテストする場合はtrueに設定します。
読み書き可能。ボリュームを読み取り専用でマウントできるかどうかをテストする場合は、false に設定してください。

戻り値は整数で、操作が成功した場合は0、そうでない場合は0以外の値になります。
文書化された価値 ntfs-3g.プローブ（8）マニュアルページ。

ntfsclone-in
ntfsclone-in (バックアップファイル|-) デバイス

「バックアップファイル」（前回の「ntfsclone-out」呼び出しから）を「デバイス」に復元します。
このデバイスの既存のコンテンツを上書きします。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

ntfsクローンアウト
ntfsclone-out デバイス (backupfile|-) [metadataonly:true|false] [rescue:true|false] [ignorefscheck:true|false] [preservetimestamps:true|false] [force:true|false]

NTFSファイルシステム「デバイス」をローカルファイル「バックアップファイル」にストリームします。
バックアップファイルは、 ntfsクローン（8）ツール。

オプションの「metadataonly」フラグがtrueの場合、 の メタデータは保存され、すべてが失われます
ユーザー データ (これは、一部のファイルシステムの問題を診断するのに役立ちます)。

オプションの「rescue」、「ignorefscheck」、「preservetimestamps」および「force」フラグは
正確な意味は ntfsクローン（8）マニュアルページ。

「ntfsclone-in」を使用して、ファイルを libguestfs デバイスに復元します。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ntfsfix
ntfsfix デバイス [clearbadsectors:true|false]

このコマンドは、NTFSの基本的な不整合を修復し、NTFSジャーナルファイルをリセットし、
Windows の最初の起動時に NTFS 整合性チェックをスケジュールします。

これは Windowsの「chkdsk」に相当する。 ファイルシステムをスキャンして
矛盾。

オプションの「clearbadsectors」フラグは不良セクタのリストをクリアします。これは、
不良セクタのあるディスクを新しいディスクに複製します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ntfsresize
ntfsresize-opts
ntfsresize デバイス [サイズ:N] [強制:true|false]

このコマンドはNTFSファイルシステムのサイズを変更し、ファイルシステムのサイズに合わせて拡大または縮小します。
基盤となるデバイス。

オプションのパラメータは次のとおりです。

"サイズ"
ファイルシステムの新しいサイズ（バイト単位）。省略した場合、ファイルシステムは次のようにサイズ変更されます。
コンテナに適合します（例：パーティション）。

"力"
このオプションがtrueの場合、ファイルシステムのサイズが
一貫性チェックが必要とマークされています。

サイズ変更操作後、ファイルシステムは常に一貫性を必要とするものとしてマークされます。
チェック（安全のため）。このチェックを実行してクリアするには、Windowsを起動する必要があります。
この状態。もしあなたが しない 「強制」オプションを設定すると、呼び出すことはできません
Windowsを起動せずに、単一のファイルシステムで「ntfsresize」を複数回実行する
各サイズ変更の間。

参照 ntfsresizeとします。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ntfsresize-サイズ
ntfsresize-size デバイスサイズ

このコマンドは「ntfsresize」と同じですが、新しいサイズを指定できる点が異なります。
(バイト単位) 明示的に指定します。

この function is 非推奨。 新しいコードでは、代わりに「ntfsresize」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

解析環境
解析環境

プログラムの環境を解析し、それに応じてハンドルにフラグを設定します。例えば、
「LIBGUESTFS_DEBUG=1」の場合、ハンドルに「詳細」フラグが設定されます。

ブリッジ プログラム do 必要 〜へ コール この「create」を呼び出すと暗黙的に実行されます。

「環境変数」を参照してください ゲスト（３）環境変数の一覧については
libguestfsのハンドルに影響します。「guestfs_create_flags」も参照してください。 ゲスト（３）そして「解析-
「環境リスト」。

パース環境リスト
parse-environment-list '環境...'

引数「環境」の文字列リストを解析し、ハンドルにフラグを設定します。
それに応じて。例えば、「LIBGUESTFS_DEBUG=1」がリスト内の文字列である場合、
ハンドルに「verbose」フラグが設定されています。

これは、明示的な文字列リストを解析することを除いて、「parse-environment」と同じです。
プログラムの環境の代わりに。

部分追加
part-add デバイス prlogex startsect endsect

このコマンドは「デバイス」にパーティションを追加します。デバイスにパーティションテーブルがない場合、
最初に「part-init」を呼び出します。

「prlogex」パラメータはパーティションの種類です。通常は「p」または「
ここでは「プライマリ」ですが、MBRパーティションテーブルでは「l」（または「論理」）と「e」（または「
「拡張」パーティション タイプ。

「startsect」と「endsect」はパーティションの開始と終了です。 セクター. 「エンドセクト」
負の値になる場合もあり、これはディスクの最後から逆方向にカウントすることを意味します（「-1」は
最後のセクター）。

ディスク全体をカバーするパーティションを作成するのは簡単ではありません。「part-disk」を使って
それ。

部分削除
パートデルデバイスパート番号

このコマンドは、「device」上の「partnum」番号のパーティションを削除します。

MBRパーティションの場合、拡張パーティションを削除すると、
含まれる論理パーティション。

部分ディスク
部分ディスクデバイス parttype

このコマンドは単に「part-init」と「part-add」を組み合わせて作成します。
ディスク全体をカバーする単一のプライマリ パーティション。

「parttype」はパーティションテーブルの種類で、通常は「mbr」または「gpt」ですが、他の値も考えられます。
「part-init」で説明されています。

一部起動可能
part-get-bootable device partnum

このコマンドは、「device」のパーティション「partnum」にブート可能フラグがある場合にtrueを返します。
設定します。

「part-set-bootable」も参照してください。

パート-get-gpt-guid
part-get-gpt-guid デバイス パーツ番号

番号付き GPT パーティション「partnum」の GUID を返します。

部分取得 gpt タイプ
part-get-gpt-type デバイス パート番号

番号付きGPTパーティション「partnum」のGUIDを返します。MBRパーティションの場合は、
MBRタイプに対応する適切なGUID。他のパーティションでは動作は未定義です。
タイプ。

パート-get-mbr-id
part-get-mbr-id デバイス パート番号

番号付きパーティションからMBRタイプバイト（IDバイトとも呼ばれる）を返します。
「partnum」。

MBR（旧DOSスタイル）パーティションのみにタイプバイトがあることに注意してください。
他のパーティション テーブル タイプの結果 (「part-get-parttype」を参照)。

パーツ取得MBRパーツタイプ
part-get-mbr-part-type デバイス パーツ番号

これは、デバイス「device」上の番号「partnum」の MBR パーティションのパーティション タイプを返します。

「プライマリ」、「論理」、または「拡張」を返します。

部分取得名
part-get-name デバイス パート番号

これは、デバイス「device」上の番号「partnum」のパーティションのパーティション名を取得します。注
パーティションは 1 から番号が付けられます。

パーティション名は特定の種類のパーティションテーブルでのみ読み取ることができます。これは
「gpt」ではサポートされますが、「mbr」パーティションでは使用できません。

パーツ取得パーツタイプ
part-get-parttype デバイス

このコマンドは「デバイス」のパーティションテーブルを調べ、パーティションテーブルの種類を返します。
(フォーマット) が使用されています。

一般的な戻り値には、「msdos」（DOS/WindowsスタイルのMBRパーティションテーブル）、「gpt」（
GPT/EFIスタイルのパーティションテーブル）。他の値も可能だが、一般的ではない。「part-
完全なリストについては、「init」を参照してください。

部分初期化
part-initデバイス parttype

これにより、リストされているパーティションタイプの1つである「デバイス」に空のパーティションテーブルが作成されます。
以下を参照してください。通常、「parttype」は「msdos」または「gpt」（大容量ディスクの場合）のいずれかになります。

最初はパーティションはありません。その後、各パーティションに対して「part-add」を呼び出します。
パーティションが必要です。

「parttype」に使用できる値は次のとおりです。

EFI
gpt Intel EFI / GPT パーティション テーブル。

これは、LinuxおよびIntelからアクセスされる2 TB以上のパーティションに推奨されます。
ベースの Mac OS X でのみサポートされます。また、「mbr」形式との下位互換性も限定的にあります。

MBR
MSDOS
MS-DOSとWindowsで使用される標準的なPC「マスターブートレコード」（MBR）形式。
パーティションタイプは の 最大2TBのデバイスサイズに対応しています。大容量ディスクの場合は
「gpt」の使用をお勧めします。

動作するかもしれないがサポートされていないその他のパーティション テーブル タイプは次のとおりです。

エクス AIX ディスク ラベル。

amigaの
RDB Amiga「リジッド ディスク ブロック」フォーマット。

bsd BSD ディスク ラベル。

DASD
IBM メインフレームで使用される DASD。

DVH MIPS/SGI ボリューム。

MAC 古い Mac のパーティション形式。最近の Mac では「gpt」が使用されています。

pc98
NEC PC-98 フォーマット。日本では一般的なようです。

太陽 Sun ディスクのラベル。

部品リスト
部品リストデバイス

このコマンドは「デバイス」のパーティションテーブルを解析し、パーティションのリストを返します。
発見した。

返される構造体のフィールドは次のとおりです。

部品番号
パーティション番号（1 からカウント）。

パート開始
パーティションの開始 in バイトセクターを取得するには、デバイスの
セクターサイズについては、「blockdev-getss」を参照してください。

パート終了
パーティションの終了位置（バイト単位）。

パーツサイズ
パーティションのサイズ（バイト単位）。

パーツセット起動可能
part-set-bootable device partnum true|false

これは、デバイス「device」のパーティション番号「partnum」にブート可能フラグを設定します。
パーティションは 1 から番号が付けられます。

ブート可能フラグは、一部のオペレーティングシステム（特にWindows）で、どのオペレーティングシステムがブート可能かを判断するために使用されます。
起動するパーティション。必ずしも普遍的に認識されているわけではありません。

パーツセットgpt-guid
part-set-gpt-guid デバイス パーツ番号 guid

番号付きGPTパーティション「partnum」のGUIDを「guid」に設定します。
「デバイス」のパーティション テーブルが GPT ではないか、「guid」が有効な GUID ではありません。

パーツセット gpt タイプ
part-set-gpt-type デバイス パーツ番号 GUID

番号付きGPTパーティション「partnum」のGUIDタイプを「guid」に設定します。
「デバイス」のパーティション テーブルが GPT ではないか、「guid」が有効な GUID ではありません。

詳細はこちら： http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs は便利な
タイプ GUID のリスト。

パーツセットMBRID
part-set-mbr-id デバイス パート番号 idbyte

番号付きパーティション「partnum」のMBRタイプバイト（IDバイトとも呼ばれる）を次のように設定します。
「idbyte」。ほとんどのドキュメントで引用されている型バイトは実際には16進数であることに注意してください。
数字ですが、通常は先頭に「0x」を付けずに記述されるため、混乱を招く可能性があります。

MBR（旧DOSスタイル）パーティションのみにタイプバイトがあることに注意してください。
他のパーティション テーブル タイプの結果 (「part-get-parttype」を参照)。

部品セット名
部品セット名 デバイス 部品番号名

これは、デバイス「device」上の番号「partnum」のパーティションにパーティション名を設定します。注
パーティションは 1 から番号が付けられます。

パーティション名は特定の種類のパーティションテーブルでのみ設定できます。これは
「gpt」ではサポートされますが、「mbr」パーティションでは使用できません。

部品から開発へ
パーツからデバイスへのパーティション

この関数はパーティション名（例：/dev/sdb1）を受け取り、パーティション番号を削除します。
デバイス名を返します (例: "/dev/sdb")。

名前付きパーティションは、たとえば「list-partitions」から返される文字列として存在している必要があります。

「part-to-partnum」、「device-index」も参照してください。

パートタイム
パート間パーティション

この関数はパーティション名（例：/dev/sdb1）を受け取り、パーティション番号を返します。
（例1）。

名前付きパーティションは、たとえば「list-partitions」から返される文字列として存在している必要があります。

「part-to-dev」も参照してください。

pingデーモン
pingデーモン

これは、libguestfs アプライアンス内で実行されている guestfs デーモンへのテスト プローブです。
この関数を呼び出すと、デーモンがpingメッセージに応答するかどうかがチェックされます。
デーモンまたは接続されたブロック デバイスに他の方法で影響を与えることはありません。

読む
プレッドパスカウントオフセット

このコマンドはファイルの一部を読み込むことができます。ファイルの「count」バイトを読み込み、
ファイル「path」からの「offset」の位置。

要求されたバイト数よりも少ないバイト数を読み出す可能性があります。詳細については、 読む(2) システム
コール。

「pwrite」、「pread-device」も参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

プレッドデバイス
プレッドデバイスデバイスカウントオフセット

このコマンドはブロックデバイスの一部を読み取ることができます。「デバイス」の「count」バイトを読み取ります。
「オフセット」から始まります。

要求されたバイト数よりも少ないバイト数を読み出す可能性があります。詳細については、 読む(2) システム
コール。

「pread」も参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

pvchange-uuid
pvchange-uuid デバイス

物理ボリューム「デバイス」の新しいランダム UUID を生成します。

pvchange-uuid-all
pvchange-uuid-all

すべての物理ボリュームに対して新しいランダム UUID を生成します。

pv作成
pvcreateデバイス

これは「デバイス」という名前のLVM物理ボリュームを作成します。「デバイス」は通常
パーティション名は次のようになります の/ dev / sda1.

pvremove
pvremoveデバイス

これにより、物理ボリューム「デバイス」が消去され、LVM がそれを認識できなくなります。

実装では「pvremove」コマンドを使用し、物理ボリュームの消去を拒否します。
ボリューム グループが含まれていないので、最初にそれらを削除する必要があります。

プレビューサイズ
pvresizeデバイス

これは、既存のLVM物理ボリュームのサイズを変更（拡大または縮小）して、新しいサイズに合わせます。
基盤となるデバイス。

pvresize-サイズ
pvresize-size デバイスサイズ

このコマンドは「pvresize」と同じですが、新しいサイズを指定できる点が異なります。
(バイト単位) 明示的に指定します。

pvs
pvs

検出されたすべての物理ボリュームを一覧表示します。これは、 pvs（8）コマンド。

これは、PV を含むデバイス名のみのリストを返します (例: の/ dev / sda2).

「pvs-full」も参照してください。

pvs-full
pvs-full

検出されたすべての物理ボリュームを一覧表示します。これは、 pvs（8）コマンド。
「フル」バージョンにはすべてのフィールドが含まれます。

プライベート
プライベートデバイス

このコマンドは、LVM PV「デバイス」の UUID を返します。

書き込む
pwriteパスコンテンツオフセット

このコマンドはファイルの一部に書き込みます。データバッファの「内容」をファイルに書き込みます。
「path」はオフセット「offset」から始まります。

このコマンドは、 書き込む（２）システムコールであり、そのシステムコールのように
要求されたデータをすべて書き込みます。戻り値は実際に書き込まれたバイト数です。
ファイルに書き込まれた。これは0になることもあるが、通常の書き込みでは短い書き込みは起こりにくい。
通常の状況でのファイル。

「pread」、「pwrite-device」も参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

pwrite-デバイス
pwrite-device デバイスコンテンツオフセット

このコマンドはデバイスの一部に書き込みます。データバッファの「コンテンツ」を「デバイス」に書き込みます。
オフセット「offset」から開始します。

このコマンドは、 書き込む（２）システムコールであり、そのシステムコールのように
要求されたデータをすべて書き込む（ただし、ディスクデバイスやパーティションへの短い書き込みは
おそらく標準の Linux カーネルでは不可能です)。

「pwrite」も参照してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

ファイルの読み取り
読み取りファイルパス

この呼び出しは、ファイル「path」の内容をバッファとして返します。

「cat」とは異なり、この関数は埋め込まれたASCII NULを含むファイルを正しく処理できます。
文字。

読み取り行
読み取り行パス

「path」という名前のファイルの内容を返します。

ファイルの内容は行のリストとして返されます。末尾の「LF」と「CRLF」文字は
シーケンスは 戻ってきた。

この関数はバイナリファイル（具体的には
文字列の末尾として扱われる「\0」文字を含む）には、
「read-file」関数を使用して、バッファを自分で行に分割します。

読み取り
readdir ディレクトリ

これは、ディレクトリ「dir」内のディレクトリ エントリのリストを返します。

ディレクトリ内のすべてのエントリが返されます（「.」と「..」を含む）。エントリは
ソートされていますが、基礎となるファイルシステムと同じ順序で返されます。

また、この呼び出しは各ファイルの基本ファイルタイプ情報を返します。「ftyp」フィールドは
次のいずれかの文字が含まれます。

'b' ブロックスペシャル

'c' Charスペシャル

'd' ディレクトリ

'f' FIFO（名前付きパイプ）

'l' シンボリックリンク

'r' 通常ファイル

's'ソケット

'u' 不明なファイルタイプ

「？」その 読み取り（3）呼び出しは予期しない値を持つ「d_type」フィールドを返しました

この関数は主にプログラムでの使用を目的としています。単純な名前のリストを取得するには、
「ls」を使用してください。人間が利用できるように印刷可能なディレクトリを取得するには、「ll」を使用してください。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

リードリンク
読み取りリンクパス

このコマンドは、シンボリック リンクのターゲットを読み取ります。

リンクリストを読む
readlinklist パス 'names ...'

この呼び出しにより、すべてのファイルが
ディレクトリ「path」内。「names」はこのディレクトリのファイルのリストです。

返されるときに、「名前」リストと 1 対 1 に対応する文字列のリストが取得されます。
各文字列はシンボリック リンクの値です。

Status リードリンク（２）いずれかの名前で操作が失敗した場合、対応する結果文字列は
空文字列 "" が存在しても、操作全体は完了します。
リードリンク（２）エラーが発生するので、この関数は、
これらはすでにシンボリック リンクです (ただし、効率は少し低くなります)。

この呼び出しは、ディレクトリの内容を効率的に一覧表示したいプログラムを対象としています。
何度も往復することなく。

リアルパス
リアルパスパス

「path」の正規化された絶対パス名を返します。返されるパスには「.」、「..」は含まれません。
またはシンボリック リンク パス要素。

再マウント
マウントポイントを再マウントする [rw:true|false]

この呼び出しにより、すでにマウントされているファイルの「rw」（読み取り専用/読み書き）フラグを変更できます。
「マウントポイント」のファイルシステム、読み取り専用ファイルシステムを読み書き可能に変換する、またはその逆
逆もまた同様です。

現時点では「オプション」の「rw」パラメータを指定する必要があります。将来的には
他のフラグを調整できるようにします。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ドライブの取り外し
ドライブラベルの削除

この関数は概念的には「add-drive-opts」の逆です。
以前はラベル「label」で追加されました。

ドライブを削除するには、ラベルを付けて追加する必要があることに注意してください（オプションの
（「add-drive-opts」の「label」引数で指定します）。ラベルを使用しなかった場合は、
除去された。

この関数はハンドルを起動する前でも後でも呼び出すことができます。起動後に呼び出された場合は、
バックエンドがサポートしている場合は、ドライブのホットプラグを試みます。「HOTPLUGGING」を参照してください。
ゲスト（３）ディスク しなければなりません これを行う際は、使用中（マウントされているなど）である必要があります。
ディスクが使用中の場合は、これを実行できないようにします。

削除属性
removexattr xattr パス

この呼び出しは、ファイル「path」の「xattr」という名前の拡張属性を削除します。

参照: "lremovexattr", ATTRとします。

リネーム
古いパスを新しいパスに名前変更

同じファイルシステム上の新しい場所にファイルの名前を変更します。これはLinuxの
リネーム(2) システムコール。ほとんどの場合、代わりに「mv」を使用する方が適切です。

サイズ変更2fs
resize2fsデバイス

これは、基礎となるデバイスのサイズに合わせて、ext2、ext3、または ext4 ファイルシステムのサイズを変更します。

「RESIZE2FSエラー」も参照してください。 ゲストとします。

resize2fs-M
resize2fs-Mデバイス

このコマンドは「resize2fs」と同じですが、ファイルシステムは最小サイズに変更されます。
サイズ。これは -M 「resize2fs」コマンドのオプション。

ファイルシステムの最終的なサイズを取得するには、「tune2fs-l」を呼び出して、
「ブロックサイズ」と「ブロック数」の値。これら2つの数値を掛け合わせると、
最小ファイルシステムの結果サイズ（バイト単位）。

「RESIZE2FSエラー」も参照してください。 ゲストとします。

resize2fs-サイズ
resize2fs-size デバイスサイズ

このコマンドは「resize2fs」と同じですが、新しいサイズを指定できる点が異なります。
(バイト単位) 明示的に指定します。

「RESIZE2FSエラー」も参照してください。 ゲストとします。

rm
rm パス

単一のファイル「パス」を削除します。

RM-F
rm-f パス

ファイル「path」を削除します。

ファイルが存在しない場合は、そのエラーは無視されます。（その他のエラー、例：I/Oエラーや不正な
パスは無視されません）

この呼び出しではディレクトリを削除できません。空のディレクトリを削除するには「rmdir」、そうでない場合は「rm-rf」を使用してください。
ディレクトリを再帰的に削除します。

rm-rf
rm-rfパス

ファイルまたはディレクトリの「パス」を削除します。ディレクトリの場合は内容を再帰的に削除します。
これは「rm -rf」シェルコマンドに似ています。

rmdir
rmdir パス

単一のディレクトリ「path」を削除します。

rmmountpoint
rmmountpoint 免除パス

この呼び出しは、以前に「mkmountpoint」で作成されたマウントポイントを削除します。
詳細については、「mkmountpoint」を参照してください。

rsync
rsync src dest [アーカイブ:true|false] [削除済み:true|false]

この呼び出しは、同じlibguestfsの下にある2つのディレクトリをコピーまたは同期するために使用できます。
ハンドル。これは rsync（１）コピーを回避する高速アルゴリズムを使用するプログラム
ファイルを不必要に保存します。

「src」と「dest」はそれぞれコピー元とコピー先のディレクトリです。ファイルは「src」からコピーされます。
「dest」へ。

オプションの引数は次のとおりです。

"アーカイブ"
アーカイブモードをオンにします。これは、 - 記録 フラグを「rsync」に設定します。

「最も削除された」
ソースに存在しないファイルを宛先で削除します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

rsync-in
rsync-in リモート dest [アーカイブ:true|false] [削除済み:true|false]

この呼び出しは、ホストまたはリモートのファイルシステムをコピーまたは同期するために使用できます。
libguestfs内のファイルシステムを持つコンピュータ。これは rsync（１）プログラムを使用する
不必要なファイルのコピーを回避する高速アルゴリズム。

この呼び出しはネットワークが有効になっている場合にのみ機能します。「set-network」または - 通信網 オプション
さまざまなツールに ゲストフィッシュとします。

ファイルは「remote」で指定されたリモートサーバーとディレクトリからコピーされます。
宛先ディレクトリ「dest」。

リモートサーバ文字列のフォーマットは次のように定義されます。 rsync（１）注意すべきことは、
パスワードまたはパスフレーズを入力する必要があるため、ターゲットではパスワードまたはパスフレーズを必要としないように設定する必要があります。

オプションの引数は「rsync」のものと同じです。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

rsync-out
rsync-out src リモート [アーカイブ:true|false] [削除済み:true|false]

この呼び出しは、libguestfs内のファイルシステムをコピーまたは同期するために使用できます。
ホストまたはリモートコンピュータ上のファイルシステム。これは rsync（１）プログラムを使用する
不必要なファイルのコピーを回避する高速アルゴリズム。

この呼び出しはネットワークが有効になっている場合にのみ機能します。「set-network」または - 通信網 オプション
さまざまなツールに ゲストフィッシュとします。

ファイルはソースディレクトリ「src」からリモートサーバーとディレクトリにコピーされます
「remote」で指定します。

リモートサーバ文字列のフォーマットは次のように定義されます。 rsync（１）注意すべきことは、
パスワードまたはパスフレーズを入力する必要があるため、ターゲットではパスワードまたはパスフレーズを必要としないように設定する必要があります。

オプションの引数は「rsync」のものと同じです。

「src」パラメータではグロブは行われません。APIを直接使用するプログラムでは
ワイルドカードは自分で展開する必要があります（「glob-expand」を参照）。guestfishでは、
「glob」コマンド（「glob」を参照）の例：

> glob rsync-out /* rsync://remote/

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

スクラブ装置
スクラブデバイス

このコマンドは、データの取得をより困難にするために、「デバイス」にパターンを書き込みます。

これは、 スクラブ（1）プログラム。詳細についてはマニュアルページを参照してください。

スクラブファイル
スクラブファイルファイル

このコマンドは、データの取得をより困難にするためにファイルにパターンを書き込みます。

ファイルは 削除 こすった後。

これは、 スクラブ（1）プログラム。詳細についてはマニュアルページを参照してください。

スクラブフリースペース
scrub-freespace dir

このコマンドはディレクトリ「dir」を作成し、ファイルシステムがいっぱいになるまでファイルを埋めていきます。
ファイルがいっぱいになった場合は、「scrub-file」のファイルと同様にファイルをスクラブして削除します。その目的は、
「dir」を含むパーティション上の空き領域をすべて削除します。

これは、 スクラブ（1）プログラム。詳細についてはマニュアルページを参照してください。

追加設定
アペンド
set-append 追加

この関数は、libguestfsアプライアンスカーネルコマンドに追加オプションを追加するために使用されます。
ライン。

デフォルトは「LIBGUESTFS_APPEND」環境変数の設定によって上書きされない限り「NULL」です。
変数に保存します．

「append」を「NULL」に設定すると、 いいえ 追加のオプションが渡されます（libguestfsは常に
独自のものもいくつかあります。

アタッチメソッドの設定
添付方法
set-attach-method バックエンド

libguestfs がバックエンドの guestfsd デーモンに接続するために使用する方法を設定します。

「バックエンド」を参照してください ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「set-backend」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

自動同期の設定
自動同期
自動同期を設定する true|false

「autosync」がtrueの場合、自動同期が有効になります。Libguestfsは最善を尽くして同期を試みます。
ハンドルが閉じられたときにファイルシステムの一貫性と同期を保つため（
プログラムはハンドルを閉じずに終了します)。

これはデフォルトで有効になっています（libguestfs 1.5.24以降、以前は
デフォルト）。

バックエンドの設定
バックエンド
set-backend バックエンド

libguestfs がバックエンドの guestfsd デーモンに接続するために使用する方法を設定します。

このハンドル プロパティは、以前は「アタッチ メソッド」と呼ばれていました。

「バックエンド」を参照してください ゲストとします。

バックエンド設定の設定
バックエンド設定名の値を設定する

バックエンド設定の文字列リストに「name=value」を追加します。ただし、文字列がすでに存在する場合は
「name」に一致するか「name=」で始まる設定が存在する場合、その設定は置き換えられます。

「バックエンド」を参照してください ゲスト（３）「バックエンド設定」 ゲストとします。

バックエンド設定の設定
set-backend-settings '設定...'

現在のバックエンドに渡される0個以上の設定のリストを設定します。各
設定はバックエンド固有の方法で解釈される文字列であり、そうでない場合は無視されます。
バックエンドによって理解されます。

環境変数が設定されていない限り、デフォルト値は空のリストです。
ハンドルの作成時に「LIBGUESTFS_BACKEND_SETTINGS」が設定されました。この環境
変数にはコロンで区切られた設定のリストが含まれています。

この呼び出しはすべてのバックエンド設定を置き換えます。単一のバックエンド設定を置き換えたい場合は、
「set-backend-setting」を参照してください。単一のバックエンド設定をクリアしたい場合は、「clear-
「backend-setting」を参照してください。

「バックエンド」を参照してください ゲスト（３）「バックエンド設定」 ゲストとします。

セットキャッシュディレクトリ
キャッシュディレクトリ
set-cachedir キャッシュディレクトリ

スーパーミニマムを使用する場合、アプライアンスのキャッシュを保存するためにハンドルが使用するディレクトリを設定します。
アプライアンス。アプライアンスはキャッシュされ、同じ名前を持つすべてのハンドル間で共有されます。
有効なユーザーID。

環境変数「LIBGUESTFS_CACHEDIR」と「TMPDIR」はデフォルト値を制御します。
「LIBGUESTFS_CACHEDIR」が設定されている場合はそれがデフォルトです。「TMPDIR」が設定されている場合は
これがデフォルトです。それ以外の場合は / var / tmp デフォルトです。

直接設定
直接
直接設定 true|false

直接アプライアンスモードフラグが有効になっている場合、stdinとstdoutが直接渡されます。
アプライアンスが起動されるとすぐに、アプライアンスに送信されます。

その結果、ログメッセージはライブラリによってキャッチされず、
「set-log-message-callback」ですが、stdout に直接出力されます。

何をしているのかわかっていない限り、おそらくこれを使用しないほうがよいでしょう。

デフォルトは無効になっています。

e2attrs を設定する
set-e2attrs ファイル属性 [clear:true|false]

これは、inodeに関連付けられたファイル属性「attrs」を設定またはクリアします。 file.

「attrs」はファイル属性を表す文字列です。詳細は「get-e2attrs」を参照してください。
可能な属性のリスト。すべての属性を変更できるわけではありません。

オプションのブール値「clear」が存在しないか偽の場合、リストされている「attrs」は次のように設定されます。
iノード。

「clear」が true の場合、リストされている「attrs」が inode 内でクリアされます。

どちらの場合も、「attrs」文字列に存在しない他の属性は変更されません。

これらの属性は、ファイルが ext2/3/4 ファイルシステム上にある場合にのみ存在します。
他のファイルシステム タイプでこの呼び出しを使用すると、エラーが発生します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

セットe2世代
set-e2generation ファイル生成

これは、ファイルの ext2 ファイル生成を設定します。

「get-e2generation」を参照してください。

e2ラベルを設定する
set-e2label デバイスラベル

これにより、「device」上のファイルシステムの ext2/3/4 ファイルシステム ラベルが「label」に設定されます。
ファイルシステムのラベルは 16 文字に制限されています。

「tune2fs-l」または「get-e2label」のいずれかを使用して、既存のラベルを返すことができます。
ファイルシステム。

この function is 非推奨。 新しいコードでは、代わりに「set-label」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

e2uuid を設定する
set-e2uuid デバイスUUID

これは「デバイス」上のファイルシステムのext2/3/4ファイルシステムUUIDを「uuid」に設定します。
UUIDの形式と「クリア」、「ランダム」、「時間」などの代替手段については、
　 tune2fs（8）マンページ。

「vfs-uuid」を使用すると、ファイルシステムの既存の UUID を返すことができます。

この function is 非推奨。 新しいコードでは、代わりに「set-uuid」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

hv を設定する
hv
セット-hv hv

使用するハイパーバイザーバイナリを設定します。ハイパーバイザーはバックエンドに依存しますが、
通常はQEMU/KVMハイパーバイザーの場所です。UMLバックエンドの場合は、
「linux」または「vmlinux」バイナリの。

デフォルトは、ライブラリが configure スクリプトによってコンパイルされたときに選択されます。

「LIBGUESTFS_HV」環境変数を設定することでこれを上書きすることもできます。

ハンドルを作成した後、できるだけ早くこの関数を呼び出す必要があることに注意してください。
これは、いくつかの起動前操作がqemu機能のテスト（実行による）に依存しているためです。
「qemu -help」を参照してください。qemuバイナリが変更された場合、機能の再テストは行われないため、
結果に一貫性がありません。環境変数「LIBGUESTFS_HV」を使用するのが最も安全です。
ハンドルが作成されると同時に qemu バイナリが選択されるためです。

セット識別子
識別子
セット識別子識別子

これは、呼び出し側がハンドルに任意で設定できる情報文字列です。
さまざまな場所に印刷され、デバッグ時に現在のハンドルを識別できるようにします。
出力。

重要なのは、トレースが有効になっているかどうかです。識別子文字列が空でない場合、
文字列の場合、トレース メッセージは次のように変更されます。

libguestfs: トレース: get_tmpdir
libguestfs: トレース: get_tmpdir = "/ tmpに"

：これに

libguestfs: トレース: ID: get_tmpdir
libguestfs: トレース: ID: get_tmpdir = "/ tmpに"

ここで、「ID」はこの呼び出しによって設定される識別子文字列です。

識別子には、英数字の ASCII 文字、アンダースコア、マイナス記号のみを含める必要があります。
デフォルトは空の文字列です。

「set-program」、「set-trace」、「get-identifier」も参照してください。

ラベル設定
セットラベルマウント可能ラベル

「mountable」のファイルシステムラベルを「label」に設定します。

一部のファイルシステムタイプのみがラベルをサポートしており、libguestfsはラベルの設定を
これらのサブセット。

ext2、ext3、ext4
ラベルは 16 バイトに制限されます。

NTFS
ラベルは 128 個の Unicode 文字に制限されます。

XFS ラベルは12バイトに制限されています。ファイルシステムをマウントしている状態では、
ラベルを設定します。

BTRFS
ラベルは255バイトまでに制限されており、一部の文字は使用できません。
btrfsサブボリュームのラベルは、その親ファイルシステムのラベルを設定します。
ラベルを設定するときは、ファイルシステムをマウントしないでください。

fat ラベルは 11 バイトに制限されます。

指定されたファイルシステムの種類のラベルを変更するサポートがない場合、
set_label は失敗し、errno が ENOTSUP に設定されます。

ファイルシステム上のラベルを読み取るには、「vfs-label」を呼び出します。

set-libvirt-requested-credential
set-libvirt-requested-credential インデックス cred

ユーザから「インデックス」番目の認証情報を要求した後、この関数を呼び出して
libvirt に返答します。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

set-libvirt-supported-credentials
set-libvirt-supported-credentials 'creds ...'

「GUESTFS_EVENT_LIBVIRT_AUTH」のイベントハンドラを設定する前にこの関数を呼び出して、
プログラムが処理できる資格情報タイプのリストを提供します。

「creds」リストは空でない文字列のリストである必要があります。指定可能な文字列は以下のとおりです。

「ユーザー名」
「認証名」
"言語"
「コノンス」
「パスフレーズ」
「エコープロンプト」
「ノーエコープロンプト」
「レルム」
"外部の"

これらの資格情報タイプの意味については、libvirt のドキュメントを参照してください。

「LIBVIRT認証」を参照してください ゲスト（3）ドキュメントとサンプルコード。

メモリサイズの設定
メモリサイズ
set-memsize メモリサイズ

ハイパーバイザーに割り当てるメモリサイズをメガバイト単位で設定します。
「launch」の前に呼び出された場合の効果。

環境変数「LIBGUESTFS_MEMSIZE」を設定することでこれを変更することもできます。
ハンドルが作成されます。

libguestfsのアーキテクチャの詳細については、以下を参照してください。 ゲストとします。

ネットワーク設定
ネットワーク
ネットワーク設定 true|false

「network」がtrueの場合、libguestfsアプライアンスでネットワークが有効になっています。
デフォルトはfalseです。

これはコマンドがネットワークにアクセスできるかどうかに影響します（「コマンドの実行」を参照）。
ゲスト（3））。

「launch」を呼び出す前にこれを呼び出す必要があります。そうでない場合は効果がありません。

パス設定
path
set-path 検索パス

libguestfs がカーネルと initrd.img を検索するパスを設定します。

デフォルトは「$libdir/guestfs」ですが、「LIBGUESTFS_PATH」の設定によって上書きされます。
環境変数。

「path」を「NULL」に設定すると、デフォルトのパスが復元されます。

pgroup の設定
pグループ
set-pgroup 真|偽

「pgroup」が true の場合、子プロセスは独自のプロセス グループに配置されます。

この実際的な結果は、「SIGINT」（ユーザーが「^C」を押した際に発生する）のような信号が
子プロセスでは受信されません。

このフラグのデフォルトは false です。これは、通常、サブプロセスを強制終了するには "^C" を使用するためです。
Guestfishは対話的に使用する場合にこのフラグをtrueに設定し、「^C」で長押しをキャンセルできるようにします。
コマンドを正常に実行します (「user-cancel」を参照)。

セットプログラム
プログラム
プログラム設定プログラム

プログラム名を設定します。これはメインプログラムがオプションで使用できる情報文字列です。
ハンドルにセットします。

ハンドルが作成されると、ハンドル内のプログラム名は、
「argv[0]」。それが不可能な場合は、空の文字列が設定されます（ただし、「NULL」にはなりません）。

セットQEMU
qemu
セットQEMU HV

使用するハイパーバイザー バイナリ (通常は qemu) を設定します。

デフォルトは、ライブラリが configure スクリプトによってコンパイルされたときに選択されます。

「LIBGUESTFS_HV」環境変数を設定することでこれを上書きすることもできます。

「hv」を「NULL」に設定すると、デフォルトの qemu バイナリが復元されます。

ハンドルを作成した後、できるだけ早くこの関数を呼び出す必要があることに注意してください。
これは、いくつかの起動前操作がqemu機能のテスト（実行による）に依存しているためです。
「qemu -help」を参照してください。qemuバイナリが変更された場合、機能の再テストは行われないため、
結果に一貫性がありません。環境変数「LIBGUESTFS_HV」を使用するのが最も安全です。
ハンドルが作成されると同時に qemu バイナリが選択されるためです。

この function is 非推奨。 新しいコードでは、代わりに "set-hv" 呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

リカバリプロセスの設定
リカバリプロセス
リカバリプロシージャの設定 true|false

これをパラメータ「false」で呼び出した場合、「launch」はリカバリを作成しません。
プロセス。回復プロセスの目的は、暴走したハイパーバイザープロセスを停止することです。
メインプログラムが突然中止する場合。

これは、「launch」の前に呼び出された場合にのみ効果があり、デフォルトは true です。

これを無効にしたいのは、メインプロセスがフォークする場合のみです。
自身をバックグラウンドに移動する（デーモン化する）。この場合、回復プロセスは
メインプログラムが消えてハイパーバイザーが停止してしまうのは、あまり良いことではありません。
役に立ちます。

selinux の設定
セリナックス
set-selinux true|false

起動時にアプライアンスに渡されるselinuxフラグを設定します。デフォルトは
「selinux=0」（無効）。

SELinux が有効になっている場合は、常に Permissive モード ("enforcing=0") になることに注意してください。

libguestfsのアーキテクチャの詳細については、以下を参照してください。 ゲストとします。

セット-smp
smp
set-smp smp

アプライアンスに割り当てられている仮想CPUの数を変更します。デフォルトは1です。
これを増やすとパフォーマンスが向上する可能性がありますが、効果がないことがよくあります。

この関数は「起動」の前に呼び出す必要があります。

セット-tmpdir
tmpdir
set-tmpdir tmpdir

ハンドルが一時ファイルを保存するために使用するディレクトリを設定します。

環境変数「LIBGUESTFS_TMPDIR」と「TMPDIR」はデフォルト値を制御します。
「LIBGUESTFS_TMPDIR」が設定されている場合は、それがデフォルトです。「TMPDIR」が設定されている場合は、それが
デフォルトです。それ以外の場合は / tmpに デフォルトです。

トレース設定
トレース
トレース設定 true|false

コマンドトレースフラグが1に設定されている場合、libguestfsの呼び出し、パラメータ、戻り値は
追跡されます。

libguestfs（および他のライブラリ）へのC API呼び出しをトレースしたい場合は、
より良い方法は外部を使うことです 追跡する（1）コマンド。

環境変数「LIBGUESTFS_TRACE」が定義されていない限り、コマンドトレースは無効になります。
1 に設定します。

トレースメッセージは通常、「stderr」に送信されますが、コールバックを登録して送信する場合を除きます。
他の場所（「set-event-callback」を参照）。

UUID設定
set-uuid デバイスUUID

「device」のファイルシステムUUIDを「uuid」に設定します。これが失敗し、errnoがENOTSUPの場合、
指定されたタイプのUUIDの変更はサポートされていないことを意味します
ファイルシステム。

一部のファイルシステム タイプのみが UUID の設定をサポートしています。

ファイルシステム上の UUID を読み取るには、「vfs-uuid」を呼び出します。

UUIDをランダムに設定する
set-uuid-randomデバイス

「デバイス」のファイルシステムUUIDをランダムUUIDに設定します。これが失敗し、errnoが
ENOTSUPは、UUIDの変更がサポートされていないことを意味します。
指定されたファイルシステム。

一部のファイルシステム タイプのみが UUID の設定をサポートしています。

ファイルシステム上の UUID を読み取るには、「vfs-uuid」を呼び出します。

詳細設定
詳細
詳細設定 true|false

「verbose」が true の場合、詳細メッセージが有効になります。

環境変数「LIBGUESTFS_DEBUG」が設定されていない限り、詳細なメッセージは無効になります。
定義され、1 に設定されます。

詳細なメッセージは通常「stderr」に送信されますが、コールバックを登録して送信する場合を除きます。
他の場所に配置します (「set-event-callback」を参照)。

セットコン
setcon コンテキスト

これにより、デーモンの SELinux セキュリティ コンテキストが文字列「context」に設定されます。

SELINUXに関するドキュメントは以下を参照してください。 ゲストとします。

属性設定
setxattr xattr val vallen パス

この呼び出しは、ファイル「path」の「xattr」という名前の拡張属性を値「val」に設定します。
（長さは「vallen」）。値は任意の8ビットデータです。

参照: "lsetxattr", ATTRとします。

sfディスク
sfdisk デバイス シリンダ ヘッド セクター '行...'

これは、 sfディスク（8）ブロック上にパーティションを作成するプログラム
デバイス。

「デバイス」はブロックデバイスである必要があります。例: / dev / sdaに.

「シリンダ」、「ヘッド」、「セクター」は、ディスク上のシリンダ、ヘッド、セクターの数です。
デバイスはsfdiskに直接渡され、 -C, -H 　 -S パラメータを渡します。
いずれの場合も0の場合、対応するパラメータは省略されます。通常、「大きい」
ディスクの場合は0を渡すだけで済みますが、小さい（フロッピーサイズ）ディスクの場合はsfdisk（または
むしろ、カーネルは正しいジオメトリを計算できないので、それを伝える必要があります。

「lines」は「sfdisk」に渡す行のリストです。詳細については、
sfディスク（8）マンページ。

ディスク全体を占める単一のパーティションを作成するには、「行」を単一の
要素リスト（単一の要素が文字列「,」（カンマ）である場合）。

参照: 「sfdisk-l」、「sfdisk-N」、「part-init」

この function is 非推奨。 新しいコードでは、代わりに「part-add」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

sfdiskM
sfdiskM デバイス '行...'

これは「sfdisk」コマンドの簡略化されたインターフェースであり、パーティションサイズは
メガバイトのみで指定（最も近いシリンダに丸められる）し、
そもそもめったに使用されない cyls、heads、sectors パラメータを指定します。

参照: 「sfdisk」 sfディスク（8）manページと「part-disk」

この function is 非推奨。 新しいコードでは、代わりに「part-add」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

sfdisk-N
sfdisk-N デバイス パーツ番号 シリンダ数 ヘッド数 セクター数 行

これが走る sfディスク（８）単一のパーティション「n」だけを変更するオプション（注：「n」は
1）。

その他のパラメータについては「sfdisk」を参照してください。通常はシリンダ数、ヘッド数、セクタ数に0を指定します。
パラメーター。

参照：「part-add」

この function is 非推奨。 新しいコードでは、代わりに「part-add」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

sfdisk ディスクジオメトリ
sfdisk-ディスクジオメトリデバイス

これはパーティションテーブルから読み取った「デバイス」のディスクジオメトリを表示します。特に
基礎となるブロックデバイスのサイズが変更された場合、これは次のものとは異なる場合があります。
カーネルのジオメトリの考え方 (「sfdisk-kernel-geometry」を参照)。

結果は人間が読める形式であり、解析できるようには設計されていません。

sfdisk-カーネルジオメトリ
sfdisk-kernel-geometry デバイス

これは、カーネルの「デバイス」のジオメトリの考え方を表示します。

結果は人間が読める形式であり、解析できるようには設計されていません。

sfdisk-l
sfdisk-l デバイス

これは、人間が読める形式で「デバイス」上のパーティションテーブルを表示します。
sfディスク（8）コマンド。解析されることを意図したものではありません。

参照：「部品リスト」

この function is 非推奨。 新しいコードでは、代わりに「part-list」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

sh
shコマンド

この呼び出しはゲストのファイルシステムからゲストの /bin/sh.

これは「コマンド」に似ていますが、コマンドを次のものに渡します。

/bin/sh -c "コマンド"

ゲストのシェルに応じて、ワイルドカードが展開され、シェル
補間される表現など。

この呼び出しには、「コマンド」に関するすべての条件が適用されます。

sh-line
sh-lines コマンド

これは「sh」と同じですが、結果を行のリストに分割します。

参照: 「コマンドライン」

shutdown
shutdown

これは「launch」の反対です。バックエンドを規則的にシャットダウンします。
プロセス。自動同期フラグが設定されている場合（デフォルト）、ディスクイメージは
同期。

サブプロセスがエラーで終了した場合、この関数はエラーを返します。
すべき 無視してください（ディスクイメージを書き出せなかったことを示している可能性があります）
きちんと）。

これを複数回呼び出しても安全です。余分な呼び出しは無視されます。

この呼び出しは ハンドルを閉じるか解放します。それでも「close」を呼び出す必要があります
その後。

明示的に実行しない場合、「close」はこれを呼び出しますが、エラーは無視されることに注意してください。
その場合は。

眠る
睡眠秒数

「secs」秒間スリープします。

STAT
統計パス

指定された「パス」のファイル情報を返します。

これはと同じです STAT（2）システムコール。

この function is 非推奨。 新しいコードでは、代わりに "statns" 呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

スタトン
スタンズパス

指定された「パス」のファイル情報を返します。

これはと同じです STAT（2）システムコール。

ステータスファイル
statvfs パス

マウントされたファイルシステムのファイルシステム統計を返します。「パス」はファイルまたは
マウントされたファイルシステム内のディレクトリ（通常はマウントポイント自体ですが、
必ずしもそうである必要はありません。

これはと同じです ステータスファイル（2）システムコール。

ストリング
文字列パス

これは実行されます ストリング（１）ファイルに対してコマンドを実行し、印刷可能な文字列のリストを返す
発見した。

「strings」コマンドは、過去に信頼できないファイルの解析で問題を抱えていました。これらの
libguestfsの現在のバージョンでは軽減されていますが、 ゲストとします。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

弦楽器-e
文字列-eエンコーディングパス

これは「strings」コマンドに似ていますが、文字列のエンコードを指定できます。
ソースファイルの「パス」で検索されます。

許可されるエンコーディングは次のとおりです:

ASCIIやISO-8859-XのASCII互換部分のような単一の7ビットバイト文字
(これは「文字列」が使用するものです)。

S 単一の 8 ビットバイト文字。

b UTF-16BE または UCS-2BE でエンコードされた 16 ビット ビッグ エンディアン文字列。

l（小文字のL）
UTF-16LEやUCS-2LEなどの16ビットリトルエンディアン。これは、
Windows ゲスト内のバイナリ。

B UCS-4BE などの 32 ビット ビッグ エンディアン。

L UCS-4LE などの 32 ビット リトルエンディアン。

返される文字列は UTF-8 にトランスコードされます。

「strings」コマンドは、過去に信頼できないファイルの解析で問題を抱えていました。これらの
libguestfsの現在のバージョンでは軽減されていますが、 ゲストとします。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

スワップオフデバイス
swapoff-device デバイス

このコマンドは、「device」という名前の libguestfs アプライアンスのスワップ デバイスまたはパーティションを無効にします。
「swapon-device」を参照してください。

swapoffファイル
swapoff-file ファイル

このコマンドは、libguestfs アプライアンスのファイルスワップを無効にします。

swapoff-label
swapoff-label ラベル

このコマンドは、ラベルの付いた swap パーティション上の libguestfs アプライアンス swap を無効にします。

swapoff-uuid
swapoff-uuid uuid

このコマンドは、指定された UUID を持つ libguestfs アプライアンスのスワップ パーティションを無効にします。

swaponデバイス
swapon-device デバイス

このコマンドは、libguestfsアプライアンスが次の名前のスワップデバイスまたはパーティションを使用できるようにします。
「デバイス」。増加したメモリは、例えば以下のコマンドで利用できるようになります。
「command」または「sh」を使用します。

ゲストスワップパーティションをスワップする必要がない限り、既存のゲストスワップパーティションにスワップしないでください。
休止状態に関する情報やゲストが知っているその他の情報が含まれている可能性があります。
ゲストはあなたにゴミを捨ててほしくありません。また、ホストに関する情報がゲストに漏れるリスクもあります。
この方法。代わりに、新しいホストデバイスをゲストに接続し、それをスワップします。

swaponファイル
swapon-file ファイル

このコマンドはファイルへのスワップを有効にします。その他の注意事項については「swapon-device」を参照してください。

スワポンラベル
swapon-label ラベル

このコマンドはラベル付きスワップパーティションへのスワップを有効にします。詳細については「swapon-device」を参照してください。
を参照ください。

swapon-uuid
swapon-uuid uuid

このコマンドは、指定されたUUIDのスワップパーティションへのスワップを有効にします。「swapon-device」を参照してください。
その他の注意事項については。

sync
sync

これによりディスクが同期され、すべての書き込みが基礎となるディスク イメージにフラッシュされるようになります。

ディスク イメージを変更した場合は、ハンドルを閉じる前に必ずこれを呼び出す必要があります。

syslinux
syslinux デバイス [ディレクトリ:..]

「デバイス」に SYSLINUX ブートローダーをインストールします。

デバイスパラメータは、FATファイルシステムとしてフォーマットされたディスク全体、または
FATファイルシステムとしてフォーマットされたパーティション。後者の場合、パーティションは
「アクティブ」（「part-set-bootable」）としてマークされており、マスター ブート レコードがインストールされている必要があります（例：
ディスク全体の最初のセクターに「pwrite-device」を使用して書き込みます。SYSLINUXパッケージには
適切なマスターブートレコードをいくつか用意してください。 syslinux（1）詳細についてはmanページをご覧ください
情報を表示します。

オプションの引数は次のとおりです。

ディレクトリにジョブを開始します。
SYSLINUXを、ルートディレクトリではなく、指定されたサブディレクトリにインストールします。
FAT ファイルシステム。

SYSLINUXに追加の設定をするには、次のファイルを置く必要があります。 syslinux.cfg
FATファイルシステム上のルートディレクトリまたは ディレクトリにジョブを開始します。 それがオプションの場合
引数が使用されています。このファイルの内容の詳細については、
syslinuxとします。

「extlinux」も参照してください。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

tail
テールパス

このコマンドは、ファイルの最後の 10 行までを文字列のリストとして返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

テールn
末尾n行パス

パラメータ「nrlines」が正の数の場合、これは最後の「nrlines」行を返します。
ファイルの「パス」。

パラメータ「nrlines」が負の数の場合、ファイル「path」から行を返します。
「-nrlines」行目から始まります。

パラメータ「nrlines」がゼロの場合、空のリストが返されます。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

タールイン
tar-in-opts
tar-in (tarfile|-) ディレクトリ [compress:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

このコマンドは、ローカルファイル「tarfile」をアップロードして解凍します。 ディレクトリにジョブを開始します。.

オプションの「compress」フラグは圧縮を制御します。指定しない場合は、入力は
圧縮されていないtarファイル。それ以外の場合は、以下のいずれかの文字列を指定して選択できます。
入力ファイルの圧縮タイプ: "compress", "gzip", "bzip2", "xz", "lzop"。(注
(libguestfs のすべてのビルドがこれらすべての圧縮タイプをサポートするわけではないことに注意してください)。

その他のオプションの引数は次のとおりです。

「xattrs」
true に設定すると、拡張属性が tar ファイルから復元されます。

「セリナックス」
true に設定すると、SELinux コンテキストが tar ファイルから復元されます。

「ACL」
true に設定すると、POSIX ACL が tar ファイルから復元されます。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

タールアウト
tar-out-opts
tar出力ディレクトリ (tarfile|-) [compress:..] [numericowner:true|false] [excludes:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

このコマンドは、 ディレクトリにジョブを開始します。 それをローカルファイル「tarfile」にダウンロードします。

オプションの「compress」フラグは圧縮を制御します。指定しない場合は、出力は次のようになります。
圧縮されていないtarファイル。それ以外の場合は、以下のいずれかの文字列を指定して選択できます。
出力ファイルの圧縮タイプ: "compress", "gzip", "bzip2", "xz", "lzop"。(注
(libguestfs のすべてのビルドがこれらすべての圧縮タイプをサポートするわけではないことに注意してください)。

その他のオプションの引数は次のとおりです。

「除外」
ワイルドカードのリスト。ワイルドカードのいずれかに一致するファイルは除外されます。

「数値所有者」
trueに設定すると、出力tarファイルにはユーザー/グループではなくUID/GID番号が含まれます。
名前。

「xattrs」
true に設定すると、拡張属性が出力 tar に保存されます。

「セリナックス」
true に設定すると、SELinux コンテキストが出力 tar に保存されます。

「ACL」
true に設定すると、POSIX ACL が出力 tar に保存されます。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

tgz-in
tgz-in (tarball|-) ディレクトリ

このコマンドは、ローカルファイル「tarball」（ gzip 圧縮された tarファイル）に
ディレクトリにジョブを開始します。.

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

この function is 非推奨。 新しいコードでは、代わりに「tar-in」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

tgz-out
tgz-out ディレクトリ (tarball|-)

このコマンドは、 ディレクトリにジョブを開始します。 それをローカルファイル「tarball」にダウンロードします。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

この function is 非推奨。 新しいコードでは、代わりに「tar-out」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

touch
タッチパス

タッチは、 touch（1）コマンド。ファイルのタイムスタンプを更新するために使用できます。
または、ファイルが存在しない場合は、長さ 0 の新しいファイルを作成します。

このコマンドは通常のファイルに対してのみ機能し、他のファイルタイプ、例えば
ディレクトリ、シンボリックリンク、ブロック特殊など。

切り詰める
パスを切り捨てる

このコマンドは、長さがゼロのファイルへの「パス」を切り捨てます。 ファイルはすでに存在している必要があります。

切り捨てサイズ
切り捨てサイズ パスサイズ

このコマンドは「path」を「size」バイトに切り捨てます。ファイルは既に存在している必要があります。

現在のファイルサイズが「サイズ」より小さい場合、ファイルは必要なサイズまで拡張されます。
0バイトのサイズ。これによりスパースファイルが作成されます（つまり、ディスクブロックは割り当てられません）。
書き込むまでファイルに保存されます。ゼロの非スパースファイルを作成するには、「fallocate64」を使用します。
を代わりにお使いください。

tune2fs
tune2fs デバイス [force:true|false] [最大マウント数:N] [マウント数:N] [エラー動作:..] [グループ:N] [チェック間隔:N] [予約ブロック率:N] [最後にマウントされたディレクトリ:..] [予約ブロック数:N] [ユーザー:N]

この呼び出しにより、ext2/ext3/ext4のさまざまなファイルシステムパラメータを調整できます。
「デバイス」と呼ばれるファイルシステム。

オプションのパラメータは次のとおりです。

"力"
エラーが発生してもtune2fsに操作を完了させる。これは
tune2fs の "-f" オプションとして。

「最大マウント数」
ファイルシステムをチェックするマウント回数を設定します。 e2fsck(8)。 これなら
0の場合、マウント数は無視されます。これはtune2fsの「-c」オプションと同じです。
オプションを選択します。

「マウントカウント」
ファイルシステムがマウントされた回数を設定します。これは
tune2fs "-C" オプション。

「エラー動作」
エラーが検出された場合のカーネルコードの動作を変更します。可能な値
現時点では「continue」「remount-ro」「panic」の3種類があります。実際にはこれらのオプションは
特に書き込みエラーの場合、実際には違いはありません。

これは tune2fs の "-e" オプションと同じです。

"グループ"
予約済みのファイルシステムブロックを使用できるグループを設定します。これは
tune2fs の "-g" オプションとは異なり、数値としてのみ指定できます。

「チェック間の間隔」
ファイルシステムチェックの最大間隔（秒単位）を調整します。オプションが
0 が渡された場合、時間依存のチェックは無効になります。

これは tune2fs の "-i" オプションと同じです。

「予約ブロックの割合」
特権ユーザーのみ割り当てられるファイルシステムの割合を設定します
プロセス。これはtune2fsの「-m」オプションと同じです。

「最後にマウントされたディレクトリ」
最後にマウントされたディレクトリを設定します。これはtune2fsの「-M」オプションと同じです。

"reservedblockscount" 予約済みファイルシステムブロックの数を設定します。これは
tune2fs "-r" オプション。
"ユーザー"
予約済みのファイルシステムブロックを使用できるユーザーを設定します。これは
tune2fs の "-u" オプションとは異なり、数値としてのみ指定できます。

ファイルシステムパラメータの現在の値を取得するには、「tune2fs-l」を参照してください。正確な詳細については
tune2fsの仕組みについては、 tune2fs（8）マニュアルページ。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

tune2fs-l
tune2fs-l デバイス

これは、「デバイス」上の ext2、ext3、または ext4 ファイルシステム スーパーブロックの内容を返します。

これは「tune2fs -l device」を実行するのと同じです。 tune2fs（8）詳細についてはmanページを参照してください。
返されるフィールドのリストは明確に定義されておらず、
libguestfs が構築された「tune2fs」とファイルシステム自体。

txz-in
txz-in (tarball|-) ディレクトリ

このコマンドは、ローカルファイル「tarball」（ xz 圧縮された tarファイル）に
ディレクトリにジョブを開始します。.

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

この function is 非推奨。 新しいコードでは、代わりに「tar-in」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

txz-out
txz-out ディレクトリ (tarball|-)

このコマンドは、 ディレクトリにジョブを開始します。 そしてそれをローカルファイル「tarball」（
xz 圧縮された tar アーカイブ)。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

この function is 非推奨。 新しいコードでは、代わりに「tar-out」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

umask
umaskマスク

この関数は、新しいファイルとデバイス ノードを作成するために使用されるマスクを「mask & 0777」に設定します。

典型的なumask値は022で、次のような権限を持つ新しいファイルを作成します。
「-rw-r--r--」または「-rwxr-xr-x」、および002は次のような権限で新しいファイルを作成します。
「-rw-rw-r--」または「-rwxrwxr-x」。

デフォルトのumaskは022です。これは、ディレクトリとデバイスが
0777 を指定した場合でも、ノードは 0644 または 0755 モードで作成されます。

「get-umask」も参照してください。 umask（２）「mknod」、「mkdir」

この呼び出しは以前の umask を返します。

umount
アンマウント
umount-opts
パスまたはデバイスのマウント解除 [force:true|false] [lazyunmount:true|false]

指定されたファイルシステムをアンマウントします。ファイルシステムは、
マウントポイント (パス) またはファイルシステムを含むデバイス。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

すべてアンマウント
すべてアンマウント
すべてアンマウント

これにより、マウントされているすべてのファイルシステムがアンマウントされます。

一部の内部マウントはこの呼び出しではマウント解除されません。

ローカルアンマウント
umount-local [再試行:true|false]

libguestfs がローカルマウントポイントでファイルシステムをエクスポートしている場合は、これをアンマウントします。

「MOUNT LOCAL」を参照してください ゲスト（３）詳細な文書については、

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

upload
アップロード (ファイル名|-) リモートファイル名

ローカルファイルをアップロードする ファイル名 〜へ リモートファイル名 ファイルシステム上。

ファイル名 名前付きパイプにすることもできます。

「ダウンロード」も参照してください。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

アップロードオフセット
アップロードオフセット (ファイル名|-) リモートファイル名オフセット

ローカルファイルをアップロードする ファイル名 〜へ リモートファイル名 ファイルシステム上。

リモートファイル名 指定されたバイト「オフセット」から上書きされます。意図は
既存のファイルやデバイスの一部を上書きしますが、存在しないファイルの場合は
指定された場合、「オフセット」の前に「ホール」が作成されます。書き込まれるデータのサイズは
ソースのサイズに暗黙的に含まれる ファイル名.

この呼び出しでアップロードできるデータの量には制限がないことに注意してください。
「pwrite」とは異なり、この呼び出しではエラーが発生しない限り常に全額が書き込まれます。

「upload」、「pwrite」も参照してください。

stdin/stdout から読み取り/書き込みを行うには、ファイル名の代わりに「-」を使用します。

ユーザーキャンセル
ユーザーキャンセル

この関数は、現在のアップロードまたはダウンロード操作をキャンセルします。

他のほとんどのlibguestfs呼び出しとは異なり、この関数はシグナルセーフかつスレッドセーフです。
ロックを行う必要なしに、シグナル ハンドラーまたは別のスレッドから呼び出します。

進行中の転送（ある場合）はすぐに停止し、
エラーを返します。errno（「guestfs_last_errno」を参照）は「EINTR」に設定されるため、テストすることができます。
これにより、操作がキャンセルされたのか、別のエラーのために失敗したのかがわかります。

クリーンアップは実行されません。たとえば、ファイルがアップロードされていた場合、キャンセル後に
部分的にアップロードされたファイルが存在する可能性があります。その場合は呼び出し元がクリーンアップする必要があります。
必要。

「ユーザーキャンセル」を呼び出す一般的な場所は 2 つあります。

対話型テキストベースのプログラムでは、「SIGINT」シグナルハンドラから呼び出すことができるので、
「^C」を押すと現在の操作がキャンセルされます。（また、
子プロセスが「^C」シグナルを受信しないように、「guestfs_set_pgroup」を設定します。

グラフィカルプログラムでは、メインスレッドがキャンセルボタン付きの進行状況バーを表示しているとき
ボタンの場合は、キャンセル ボタンを接続してこの関数を呼び出します。

用事
utimens パス atsecs atnsecs mtsecs mtnsecs

このコマンドは、ファイルのタイムスタンプをナノ秒の精度で設定します。

「atsecs、atnsecs」は、エポックからの秒数とナノ秒数で表した最終アクセス時間 (atime) です。

「mtsecs, mtnsecs」は、最終変更時刻（mtime）を秒とナノ秒で表したものです。
エポック。

*nsecsフィールドに特別な値「-1」が含まれている場合、対応するタイムスタンプは
現在の時刻に設定されます。(この場合、 *secs フィールドは無視されます)。

*nsecsフィールドに特別な値「-2」が含まれている場合、対応するタイムスタンプは
変更されません。(この場合、*secs フィールドは無視されます)。

いつのまにか
いつのまにか

アプライアンスのカーネルバージョンを返します（利用可能な場合）。
情報はデバッグにのみ役立ちます。返される構造体には定義されていないものが含まれています。
API。

バージョン
バージョン

プログラムがリンクされている libguestfs のバージョン番号を返します。

動的リンクのため、これは必ずしもlibguestfsのバージョンではないことに注意してください。
コンパイルしたプログラムに対して。プログラムをコンパイルし、実行時に動的に
全く異なるものに対するリンク libguestfs.so としょうかん。

この呼び出しはバージョン1.0.58で追加されました。libguestfsの以前のバージョンでは、
バージョン番号を取得する方法。Cコードから動的リンカー関数を使用して、
このシンボルが存在するかどうかを確認します (存在しない場合は、以前のバージョンです)。

呼び出しは4つの要素を持つ構造体を返します。最初の3つ（「major」、「minor」、そして
（リリース）は数字で、通常のバージョントリプレットに対応します。4番目の要素は
("extra")は文字列で通常は空ですが、ディストリビューション固有の場合に使用できます。
情報を表示します。

元のバージョン文字列を構築するには: "$major.$minor.$release$extra"

参照: 「LIBGUESTFSバージョン番号」 ゲストとします。

注意： この呼び出しは機能の可用性をテストするために使用しないでください。エンタープライズでは
ディストリビューションでは、後のバージョンの機能を以前のバージョンにバックポートすることで、
機能をテストするための信頼性の低い方法です。代わりに「available」または「feature-available」を使用してください。

vfsラベル
vfsラベルマウント可能

これは、ファイルシステムの「マウント可能」ラベルを返します。

ファイルシステムにラベルが付いていない場合は、空の文字列を返します。

ラベルからファイルシステムを見つけるには、「findfs-label」を使用します。

vfsの最小サイズ
vfs 最小サイズマウント可能

ファイルシステムの最小サイズをバイト単位で取得します。これは、
ファイルシステムが縮小しています。

指定されたファイルシステムの最小サイズの取得がサポートされていない場合、これは失敗し、
errno は ENOTSUP になります。

参照 ntfsresize（8） サイズ変更2fs（8） BTRFS（8） xfs_infoとします。

VFSタイプ
VFSタイプマウント可能

このコマンドは、「マウント可能」なファイルシステムに対応するファイルシステム タイプを取得します。

ほとんどのファイルシステムでは、結果はLinux VFSモジュールの名前となり、
ファイルシステムの種類を指定せずにマウントした場合、このファイルシステムをマウントできません。
たとえば、「ext3」や「ntfs」などの文字列。

vfs-uuid
uuid を取得する
vfs-uuid マウント可能

これは、「マウント可能」なファイルシステムのファイルシステム UUID を返します。

ファイルシステムに UUID がない場合、空の文字列を返します。

UUID からファイルシステムを見つけるには、「findfs-uuid」を使用します。

vg-アクティベート
vg-activate true|false 'volgroups ...'

このコマンドは、すべての論理ボリュームをアクティブ化するか（「activate」がfalseの場合）、非アクティブ化します。
ボリューム グループ「volgroups」をリストしました。

このコマンドは、「vgchange -ay|n volgroups...」を実行するのと同じです。

「volgroups」が空のリストの場合、 を ボリュームグループがアクティブ化されるか、
非アクティブ化されました。

vg-activate-all
vg-activate-all 真|偽

このコマンドは、すべての論理ボリュームをアクティブ化または（「activate」がfalseの場合）非アクティブ化します。
ボリューム グループ。

このコマンドは「vgchange -ay|n」を実行するのと同じです。

vgchange-uuid
vgchange-uuid vg

ボリューム グループ「vg」の新しいランダム UUID を生成します。

vgchange-uuid-all
vgchange-uuid-all

すべてのボリューム グループに対して新しいランダム UUID を生成します。

vgcreate
vgcreate volgroup 'physvols ...'

これは、物理ボリュームの空でないリストから「volgroup」と呼ばれるLVMボリュームグループを作成します。
ボリューム「physvols」。

vglvuuids
vglvuuids vgname

「vgname」というVGを指定すると、作成されたすべての論理ボリュームのUUIDが返されます。
このボリューム グループ。

これを「lvs」および「lvuuid」呼び出しと一緒に使用して、論理ボリュームと
ボリューム グループ。

「vgpvuuids」も参照してください。

vgmeta
vgmeta vgname

「vgname」はLVMボリュームグループです。このコマンドはボリュームグループを調べ、そのボリュームグループを返します。
メタデータ

メタデータはLVMが使用する内部構造であり、いつでも変更される可能性があることに注意してください。
時間であり、情報提供のみを目的としています。

vgpvuuids
vgpvuuids vgname

「vgname」というVGを指定すると、このVGに含まれるすべての物理ボリュームのUUIDを返します。
ボリューム グループが存在します。

これを「pvs」および「pvuuid」呼び出しと一緒に使用して、物理ボリュームと
ボリューム グループ。

「vglvuuids」も参照してください。

vgremove
vgremove vgname

LVM ボリューム グループ「vgname」(たとえば「VG」) を削除します。

これにより、ボリューム グループ内のすべての論理ボリューム (存在する場合) も強制的に削除されます。

vgrename
vgrename volgroup 新しいvolgroup

ボリューム グループ「volgroup」の名前を新しい名前「newvolgroup」に変更します。

vgs
vgs

検出されたボリュームグループをすべて一覧表示します。これは、 vgs（8）コマンド。

これにより、検出されたボリューム グループ名のみのリストが返されます (例:「VolGroup00」)。

「vgs-full」も参照してください。

vgs-フル
vgs-フル

検出されたボリュームグループをすべて一覧表示します。これは、 vgs（８）命令。
「フル」バージョンにはすべてのフィールドが含まれます。

vgscan
vgscan

これにより、すべてのブロックデバイスが再スキャンされ、LVM物理ボリューム、ボリュームのリストが再構築されます。
グループと論理ボリューム。

vguuid
vguuid vgname

このコマンドは、「vgname」という名前の LVM VG の UUID を返します。

トイレ
WC-Cパス

このコマンドは、「wc -c」外部コマンドを使用してファイル内の文字数をカウントします。

トイレ-l
wc-l パス

このコマンドは、「wc -l」外部コマンドを使用してファイル内の行数をカウントします。

トイレ
トイレ-Wパス

このコマンドは、「wc -w」外部コマンドを使用して、ファイル内の単語数をカウントします。

ワイプフス
wipefsデバイス

このコマンドは、指定された「デバイス」からファイルシステムまたはRAID署名を消去し、
ファイルシステムは libblkid には表示されません。

これによってファイルシステム自体や「デバイス」のその他のデータは消去されません。

デバイスの最初の数ブロックをゼロにする「ゼロ」と比較してください。

書きます
書き込みパスの内容

この呼び出しは「path」というファイルを作成します。ファイルの内容は文字列「content」です。
(任意の 8 ビット データを含めることができます)。

「write-append」も参照してください。

書き込み追加
パスコンテンツへの書き込み追加

この呼び出しは、ファイル「path」の末尾に「content」を追加します。「path」が存在しない場合は、
新しいファイルが作成されます。

「書き込み」も参照してください。

書き込みファイル
書き込みファイルパスコンテンツサイズ

この呼び出しは「path」というファイルを作成します。ファイルの内容は文字列「content」です。
(任意の 8 ビット データを含めることができます)、長さは「size」です。

特別なケースとして、「size」が0の場合、長さは「strlen」を使用して計算されます（つまり、この
この場合、コンテンツには埋め込まれた ASCII NUL を含めることはできません。

NB。 バグのため、ASCII NUL文字を含むコンテンツを書き込むと、 たとえ仕事であっても
長さが指定されます。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「write」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

xfs管理者
xfs-admin デバイス [extunwritten:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [label:..] [uuid:..]

「デバイス」上の XFS ファイルシステムのパラメータを変更します。

マウントされたデバイスは変更できません。管理者はファイルシステムをアンマウントする必要があります。
この呼び出しの前にパラメータを変更できます。

マウントされたファイルシステムのパラメータの一部は、
「xfs-info」および「xfs-growfs」呼び出し。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

xfs-growfs
xfs-growfs パス [datasec:true|false] [logsec:true|false] [rtsec:true|false] [datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]

「path」にマウントされた XFS ファイルシステムを拡張します。

返される構造体にはジオメトリ情報が含まれます。欠落しているフィールドは「-1」として返されます。
(数値フィールドの場合) または空の文字列。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

xfs情報
xfs-info パスまたはデバイス

「pathordevice」はマウントされたXFSファイルシステムまたはXFSファイルシステムを含むデバイスです。
コマンドはファイルシステムのジオメトリを返します。

返される構造体にはジオメトリ情報が含まれます。欠落しているフィールドは「-1」として返されます。
(数値フィールドの場合) または空の文字列。

xfs修復
xfs-修復デバイス [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride:N] [logdev:..] [rtdev:..]

「デバイス」上の破損または損傷した XFS ファイルシステムを修復します。

ファイルシステムは「デバイス」引数を使用して指定されます。これは、
ファイルシステムを含むディスクパーティションまたはボリューム。ブロック名を指定した場合
デバイスの場合、「xfs_repair」は指定されたデバイスに関連付けられたrawデバイスを検索します。
ブロックデバイスではなく、代わりに raw デバイスを使用します。

いずれにせよ、修復するファイルシステムはアンマウントする必要があります。そうしないと、結果として
ファイルシステムが不整合または破損している可能性があります。

返されるステータスは、ファイルシステムの破損が検出されたか（1を返す）、
検出されませんでした（0 を返します）。

このコマンドには1つ以上のオプション引数があります。「オプション引数」を参照してください。

ゼグレップ
zegrep 正規表現パス

これは外部の「zegrep」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ゼグレピ
zegrepi正規表現パス

これは外部の「zegrep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ゼロ
ゼロデバイス

このコマンドは、「デバイス」の最初の数ブロックにゼロを書き込みます。

いくつのブロックがゼロになるかは指定されていない（ただし、 しっかりと拭き取るのに十分な
デバイス）。パーティションテーブル、ファイルシステムのスーパーブロックを削除するだけで十分です。
などがあります。

ブロックがすでにゼロになっている場合、このコマンドはゼロの書き込みを回避します。これにより、
基盤となるデバイスが非スパース状態になったり、不必要に大きくなったりすることを防ぎます。

参照: 「zero-device」、「scrub-device」、「is-zero-device」

ゼロデバイス
ゼロデバイスデバイス

このコマンドは「デバイス」全体にゼロを書き込みます。「ゼロ」は
デバイスの最初の数ブロックをゼロにします。

ブロックがすでにゼロになっている場合、このコマンドはゼロの書き込みを回避します。これにより、
基盤となるデバイスが非スパース状態になったり、不必要に大きくなったりすることを防ぎます。

空き容量ゼロ
空き容量ゼロのディレクトリ

マウントされたファイルシステムの空き領域をゼロにする ディレクトリにジョブを開始します。ファイルシステムは
読み取り/書き込みでマウントされます。

ファイルシステムの内容は影響を受けませんが、ファイルシステム内の空き領域は解放されます。

空き領域は「トリミング」されません。代わりに「fstrim」を呼び出すこともできます。
要件に応じて、これを実行、またはこれを呼び出した後で実行します。

ゼロフリー
ゼロフリーデバイス

これは実行されます ゼロフリー 「デバイス」上のプログラム。このプログラムは未使用のinodeをゼロにし、
ext2/3ファイルシステム上のディスクブロック。これにより、ファイルシステムを圧縮することが可能になります。
より効果的に。

あなたがすべき ファイルシステムがマウントされている場合は、このプログラムを実行します。

このプログラムを使用すると、ファイルシステムまたはデータが破損する可能性があります。
ファイルシステム。

zfgrep
zfgrep パターンパス

これは外部の「zfgrep」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

zfgrepi
zfgrepiパターンパス

これは外部の「zfgrep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

zファイル
zfile meth パス

このコマンドは file まず「method」を使用して「path」を解凍した後。

「method」は「gzip」、「compress」、または「bzip2」のいずれかである必要があります。

1.0.63 以降では、代わりに「file」を使用して、圧縮ファイルを処理できるようになりました。

この function is 非推奨。 新しいコードでは、代わりに「file」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

zgrep
zgrep 正規表現パス

これは外部の「zgrep」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

ズグレピ
zgrepi 正規表現パス

これは外部の「zgrep -i」プログラムを呼び出し、一致する行を返します。

メッセージプロトコルのため、転送制限は2MBから
4MB。「プロトコル制限」を参照 ゲストとします。

この function is 非推奨。 新しいコードでは、代わりに「grep」呼び出しを使用します。

非推奨の関数はAPIから削除されませんが、
deprecated は、これらの関数の正しい使用に問題があることを示します。

EXIT ステータス

guestfish は、コマンドがエラーなしで完了した場合は 0 を返し、エラーがあった場合は 1 を返します。

ENVIRONMENT 変数

環境変数EDITOR
「edit」コマンドはエディタとして$EDITORを使用します。設定されていない場合は「vi」を使用します。

ゲストフィッシュ_ディスプレイ_画像
「display」コマンドは$GUESTFISH_DISPLAY_IMAGEを使用して画像を表示します。設定されていない場合は
使用されます ディスプレイとします。

ゲストフィッシュ_INIT
guestfish の起動時に表示されます。「PROMPT」を参照してください。

GUESTFISH_OUTPUT
guestfishの出力の前に表示されます。「PROMPT」を参照してください。

ゲストフィッシュ_PID
と一緒に使用 -リモート 制御するリモート guestfish プロセスを指定するオプション。
「ソケット経由でゲストフィッシュをリモートコントロールする」セクション。

ゲストフィッシュ_PS1
コマンドプロンプトを設定します。「PROMPT」を参照してください。

ゲストフィッシュ_リストア
guestfish が終了する前に出力されます。「PROMPT」を参照してください。

ヘクセディター
"hexedit"コマンドは外部16進エディタとして$HEXEDITORを使用します。指定されていない場合は、
外部 ヘキサエディット（１）プログラムを使用する。

ホーム
GNU readlineサポート付きでコンパイルした場合、ホームディレクトリ内のさまざまなファイルを
使用されます。「FILES」を参照してください。

LIBGUESTFS_APPEND
ゲスト カーネルに追加のオプションを渡します。

LIBGUESTFS_ATTACH_METHOD
これは「LIBGUESTFS_BACKEND」を設定する古い方法です。

LIBGUESTFS_BACKEND
アプライアンスを作成するためのデフォルトの方法を選択します。「guestfs_set_backend」を参照してください。
ゲストとします。

LIBGUESTFS_BACKEND_SETTINGS
バックエンド固有の設定をコロンで区切ったリスト。「BACKEND」を参照してください。 ゲスト（3）
「バックエンド設定」 ゲストとします。

LIBGUESTFS_CACHEDIR
supermin を使用する場合に libguestfs がアプライアンスをキャッシュする場所
アプライアンス。アプライアンスはキャッシュされ、同じ名前を持つすべてのハンドル間で共有されます。
有効なユーザーID。

「LIBGUESTFS_CACHEDIR」が設定されていない場合、「TMPDIR」が使用されます。「TMPDIR」が設定されていない場合、
その後 / var / tmp 使用されている。

「LIBGUESTFS_TMPDIR」、「set-cachedir」も参照してください。

LIBGUESTFS_DEBUG
詳細なメッセージを有効にするには、「LIBGUESTFS_DEBUG=1」を設定します。これは、
-v オプションを選択します。

LIBGUESTFS_HV
libguestfsが使用するデフォルトのハイパーバイザー（通常はqemu）バイナリを設定します。設定されていない場合は、
次に、コンパイル時に configure スクリプトによって検出された qemu が使用されます。

LIBGUESTFS_MEMSIZE
QEMUプロセスに割り当てるメモリをメガバイト単位で設定します。例：

LIBGUESTFS_MEMSIZE=700

LIBGUESTFS_PATH
guestfishがカーネルとinitrd.imgを検索するために使用するパスを設定します。
パスの議論 ゲストとします。

LIBGUESTFS_QEMU
これは「LIBGUESTFS_HV」を設定する古い方法です。

LIBGUESTFS_TMPDIR
libguestfs が各ハンドルで使用される一時ファイルを保存する場所。

「LIBGUESTFS_TMPDIR」が設定されていない場合、「TMPDIR」が使用されます。「TMPDIR」が設定されていない場合、
その後 / tmpに 使用されている。

「LIBGUESTFS_CACHEDIR」、「set-tmpdir」も参照してください。

LIBGUESTFS_TRACE
コマンド トレースを有効にするには、「LIBGUESTFS_TRACE=1」を設定します。

PAGER
「more」コマンドはページャーとして$PAGERを使用します。設定されていない場合は「more」を使用します。

パス
Libguestfsとguestfishは外部プログラムを実行する可能性があり、$PATHが設定されている必要があります。
適切な値に設定してください。libvirtバックエンドを使用している場合、libvirtは全く動作しません。
$PATH に qemu/KVM のパスが含まれていない場合。

スーパーミンカーネル
SUPERMIN_KERNEL_VERSION
SUPERMIN_MODULES
これらの3つの環境変数により、libguestfsが使用するカーネルは
アプライアンスが選択されます。$SUPERMIN_KERNELが設定されていない場合は、最新のホスト
カーネルが選択されます。カーネルの選択の詳細については、 スーパーミンとします。

TMPDIR
「LIBGUESTFS_CACHEDIR」、「LIBGUESTFS_TMPDIR」を参照してください。

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