guestmount - クラウドでオンライン

プログラム：

NAME

guestmount - FUSE と libguestfs を使用してホストにゲスト ファイルシステムをマウントします

SYNOPSIS

ゲストマウント [--オプション] -a disk.img -m デバイス [--ro] マウントポイント

guestmount [--options] -a disc.img -i [--ro] マウントポイント

guestmount [--options] -d Guest -i [--ro] マウントポイント

警告

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

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

DESCRIPTION

guestmount プログラムを使用して、仮想マシンのファイルシステムやその他のディスクをマウントできます。
ホスト上のイメージ。 ゲスト ファイルシステムへのアクセスには libguestfs を使用し、FUSE (
「ユーザー空間のファイルシステム」) を追加して、マウント可能なデバイスとして表示します。

他のオプションと合わせて、少なくとも XNUMX つのデバイスを指定する必要があります (-a オプション) または libvirt
ドメイン（-d オプション)、および少なくとも XNUMX つのマウントポイント (-m オプション）または、 -i 検査
オプションまたは - 住む オプション。 これがどのように機能するかについては、 ゲストフィッシュ(1)
マニュアルページを参照するか、以下の例を参照してください。

FUSE を使用すると、ファイルシステムを非 root としてマウントできます。 マウントポイントはあなたが所有する必要があり、
ファイルシステムは、特定のグローバル設定をしない限り、他のユーザーには表示されません。
構成の変更 /etc/fuse.conf。 ファイルシステムをアンマウントするには、
ゲストアンマウント（1）コマンド。

例

最初のパーティションにメイン ファイルシステムがある一般的な Windows ゲストの場合:

guestmount -a windows.img -m /dev/sda1 --ro / mnt

一般的な Linux ゲストの場合、 /ブート 最初のパーティション上のファイルシステム、および
論理ボリューム上のルート ファイルシステム:

ゲストマウント -a linux.img -m /dev/VG/LV -m /dev/sda1:/ブート --ろ / mnt

libguestfs にゲストのマウントポイントを検出させるには:

guestmount -a guest.img -i --ro / mnt

「Guest」という名前の libvirt ゲストの場合、次のように実行できます。

guestmount -d ゲスト -i --ro / mnt

ゲストまたはディスク イメージにどのようなファイル システムが含まれているかがわからない場合は、次を使用します。
virt-ファイルシステム(1) まず:

virt-filesystems -d MyGuest

過剰なデバッグ情報を持たずに libguestfs 呼び出しをトレースしたい場合は、
お勧め：

ゲストマウント [...] --trace / mnt

プログラムをデバッグしたい場合は、次のことをお勧めします。

ゲストマウント [...] --trace --verbose / mnt

ファイルシステムを使用した後にアンマウントするには:

ゲストアンマウント / mnt

注意事項

その他 users 　 ファイルシステム by デフォルト
ファイルシステムを XNUMX 人のユーザー (root など) としてマウントすると、他のユーザーはファイルシステムを参照できなくなります。
デフォルトでそれです。 修正するには、マウント時に FUSE の「allow_other」オプションを追加します。

sudo ゲストマウント [...] -o allow_other / mnt

有効にします FUSE
一部のディストリビューションでは、事前に特別なグループ (例: 「fuse」) に自分自身を追加する必要がある場合があります。
任意の FUSE ファイルシステムを使用できます。 これは Debian および派生製品で必要です。

他のディストリビューションでは、特別なグループは必要ありません。 Fedora や Red Hat では必要ありません
エンタープライズ Linux。

フューザーマウント エラー： "デバイス or リソースを追加する。 忙しい"
このエラーは、システム上の別のプロセスがマウントポイントにジャンプしたときに発生します。
作成したばかりなので、開いたままにしてアンマウントできなくなります。 いつもの
犯人は、さまざまな GUI の「インデックス作成」プログラムです。

この問題に対する一般的な回避策は、「fusermount -u」コマンドを数回再試行することです。
機能するまでの回数 (ゲストアンマウント(1) はこれを行います)。 残念ながら、これはそうではありません
(たとえば) マウントされたファイルシステムが特に大きく、
侵入プログラムは特に執拗です。

適切な修正は、を使用して新しいマウント名前空間を作成し、プライベート マウントポイントを使用することです。
Linux 固有の （2）/unshare(2) フラグ「CLONE_NEWNS」。 残念ながら現時点ではこれ
root が必要なので、それを機能として guestmount に追加することも必要になるでしょう。

レース 条件 可能 いつ シャットダウン ダウン 　 接続
日時 ゲストアンマウント（1）/フューザーマウント(1) 終了します。ゲストマウントはまだ実行中でクリーンアップ中である可能性があります。
マウントポイント。 ディスクイメージは完全にはファイナライズされていません。

これは、次のようなスクリプトには厄介な競合状態があることを意味します。

ゲストマウント -a ディスク.img -i / mnt
# 内容をコピーします / mnt
ゲストアンマウント / mnt
# すぐに「disk.img」を使用してみます ** 安全ではありません **

解決策は、 --pid-ファイル guestmount PID をファイルに書き込むオプション、その後
ゲストアンマウント後、この PID が終了するのを待機してスピンします。

guestmount -a disc.img -i --pid-file guestmount.pid / mnt

＃..。
＃..。

# guestunmount を呼び出す前に、guestmount の PID を保存します。
pid="$(猫ゲストマウント.pid)"

# ファイルシステムをアンマウントします。
ゲストアンマウント / mnt

タイムアウト= 10

カウント=$タイムアウト
while kill -0 "$pid" 2>/dev/null && [ $count -gt 0 ]; する
スリープ1
（（カウント - ））
行われ
if [ $count -eq 0 ]; それから
echo "$0: $timeout 秒後にゲストマウントの終了を待機できませんでした"
1番出口
fi

# これで、ディスク イメージを安全に使用できるようになりました。

「guestfs_mount_local」API を直接使用する場合は注意してください (「MOUNT LOCAL」を参照)
ゲスト(3)) であれば、安全で競合のないプログラムを書くのがはるかに簡単になります。

OPTIONS

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

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

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

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

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

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

--dir-キャッシュタイムアウト N
readdir キャッシュのタイムアウトを次のように設定します。 N 秒、デフォルトは 60 秒です。 読み取りディレクトリ
キャッシュ [実際には、半独立したキャッシュがいくつかあります] は、
読み取り(2) ディレクトリ内のファイルの stat および拡張属性を使用して呼び出します。
すぐに要求されることを予期して。

FUSE によって実装される別の属性キャッシュもあります (FUSE オプションを参照) -o
attr_timeout)、ただし、FUSE キャッシュは将来のリクエストを予測せず、キャッシュのみを行います。
既存のもの。

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

--fd=FD
パイプまたはeventfdファイル記述子を指定します。 マウントポイントを使用する準備ができたら、
guestmount は、このファイル記述子に XNUMX バイトを書き込みます。 これは次のような用途に使用できます。
と組み合わせて -フォークなし 別のプロセスで guestmount captive を実行するため。

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

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

--fuse-ヘルプ
特別な FUSE オプションに関するヘルプを表示します (「 -o 下）。

- 助けて
簡単なヘルプを表示して終了します。

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

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

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

-m dev[:マウントポイント[:オプション[:fstype]]]
- マウント dev [：mountpoint [：options [：fstype]]]
指定されたパーティションまたは論理ボリュームを指定されたマウントポイントにマウントします。 in 　 ゲスト （この
ホストのマウントポイントとは関係ありません)。

マウントポイントを省略すると、デフォルトで次のようになります。 /。 何かを取り付ける必要があります /.

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

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

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

-フォークなし
デーモン化 (またはバックグラウンドへのフォーク) しないでください。

-n
--同期なし
デフォルトでは、FUSE マウントポイントがアンマウントされているときにゲスト ディスクの同期を試みます。
このオプションを指定すると、ディスクの同期は試行されません。 を参照してください。
の自動同期についての説明 ゲスト（3）マンページ。

-o オプション
- オプション オプション
追加のオプションを FUSE に渡します。

FUSE でサポートされているすべての追加オプションのリストを取得するには、以下のコマンドを使用します。 注記
ヒューズのみ -o オプションを渡すことができますが、そのうちの一部のみが良いアイデアです。

ゲストマウント --fuse-help

潜在的に役立ついくつかの FUSE オプション:

-o 他を許可する
他のユーザーがファイルシステムを参照できるようにします。

-o attr_timeout=N
FUSE による属性キャッシュを有効にし、タイムアウトを次のように設定します。 N 秒です。

-o カーネルキャッシュ
カーネルがファイルをキャッシュできるようにします (必要な読み取り回数を減らします)
スルー ゲスト(3) API)。 余裕があれば、これは一般的に良い考えです
余分なメモリ使用量。

-o uid = N -o gid = N
これらのオプションを使用して、ゲスト ファイル システム内のすべての UID と GID を
選択された値。

-o use_ino
基礎となるファイルシステムの i ノード番号を保持します。

このオプションを使用しない場合、FUSE は独自の i ノード番号を作成します。 i ノード番号は
を参照してください STAT(2)、「ls -i」などは、基礎となるファイルシステムの i ノード番号ではありません。

注意 基礎となるファイルシステムが以下で構成されている場合、このオプションは潜在的に危険です。
複数のマウントポイント。重複した i ノード番号が表示される場合があります。
ヒューズ。 このオプションを使用すると、一部のソフトウェアが混乱する可能性があります。

--pid-ファイル ファイル名
guestmount ワーカープロセスの PID を「filename」に書き込みます。

-r
--ろ
デバイスを追加し、すべてを読み取り専用でマウントします。 また、書き込みを禁止してディスクを作成します
FUSE に対しては読み取り専用として表示されます。

ゲスト ディスクを編集しない場合は、これを強くお勧めします。 ゲストの場合
が実行中であり、このオプションは 供給されている場合、ディスクが破損する危険性が高くなります。
ゲストの破損。 私たちはこのようなことが起こらないよう努めていますが、常にそうなるとは限りません
可能。

の「読み取りおよび書き込み用のディスクを開く」も参照してください。 ゲストフィッシュとします。

--セリナックス
ゲストの SELinux サポートを有効にします。

-v
-詳細
基礎となる libguestfs からの詳細メッセージを有効にします。

-V
- バージョン
プログラムのバージョンを表示して終了します。

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

の「読み取りおよび書き込み用のディスクを開く」を参照してください。 ゲストフィッシュとします。

-x
- 痕跡
libguestfs 呼び出しと各 FUSE 関数へのエントリをトレースします。

これにより、デーモンがバックグラウンドにフォークすることも停止します (「 -フォークなし).

onworks.net サービスを使用してオンラインでゲストマウントを使用する