guestmount - Online di Cloud

PROGRAM:

NAMA

guestmount - Pasang sistem file tamu di host menggunakan FUSE dan libguestfs

RINGKASAN

guestmount [--options] -a disk.img -m perangkat [--ro] titik pemasangan

guestmount [--options] -a disk.img -i [--ro] titik pemasangan

guestmount [--options] -d Tamu -i [--ro] mountpoint

PERINGATAN

Menggunakan "guestmount" dalam mode tulis pada mesin virtual langsung, atau secara bersamaan dengan disk lain
alat pengeditan, bisa berbahaya, berpotensi menyebabkan kerusakan disk. Mesin virtual
harus dimatikan sebelum Anda menggunakan perintah ini, dan gambar disk tidak boleh diedit
bersamaan.

Gunakan --ro (hanya baca) opsi untuk menggunakan "guestmount" dengan aman jika gambar disk atau virtual
mesin mungkin hidup. Anda mungkin melihat hasil yang aneh atau tidak konsisten jika dijalankan
bersamaan dengan perubahan lain, tetapi dengan opsi ini Anda tidak akan mengambil risiko kerusakan disk.

DESKRIPSI

Program guestmount dapat digunakan untuk memasang sistem file mesin virtual dan disk lainnya
gambar pada tuan rumah. Ia menggunakan libguestfs untuk akses ke sistem file tamu, dan FUSE (the
"filesystem in userspace") untuk membuatnya tampak sebagai perangkat yang dapat dipasang.

Bersama dengan opsi lain, Anda harus memberikan setidaknya satu perangkat (-a opsi) atau libvirt
domain (-d opsi), dan setidaknya satu mountpoint (-m pilihan) atau gunakan -i pemeriksaan
pilihan atau --hidup pilihan. Cara kerjanya lebih baik dijelaskan di ikan tamu(1)
halaman manual, atau dengan melihat contoh di bawah ini.

FUSE memungkinkan Anda memasang sistem file sebagai non-root. Titik mount harus dimiliki oleh Anda, dan
sistem file tidak akan terlihat oleh pengguna lain kecuali Anda membuat global tertentu
konfigurasi berubah menjadi /etc/fuse.conf. Untuk meng-unmount sistem file, gunakan:
tamuunmount(1) perintah.

CONTOH

Untuk tamu Windows biasa yang memiliki sistem file utamanya di partisi pertama:

gunung tamu -a windows.img -m /dev/sda1 --ro / mnt

Untuk tamu Linux biasa yang memiliki / boot sistem file pada partisi pertama, dan
root filesystem pada volume logis:

gunung tamu -a linux.img -m /dev/VG/LV -m /dev/sda1:/ boot --ro / mnt

Untuk mendapatkan libguestfs untuk mendeteksi mountpoint tamu untuk Anda:

gunung tamu -a tamu.img -i --ro / mnt

Untuk tamu libvirt yang disebut "Tamu" Anda dapat melakukan:

guestmount -d Tamu -i --ro / mnt

Jika Anda tidak tahu sistem file apa yang terkandung dalam gambar tamu atau disk, gunakan
virt-filesystem(1) pertama:

virt-filesystem -d MyGuest

Jika Anda ingin melacak panggilan libguestfs tetapi tanpa informasi debug yang berlebihan, kami
sarankan:

gunung tamu [...] --trace / mnt

Jika Anda ingin men-debug program, kami sarankan:

mount tamu [...] --trace --verbose / mnt

Untuk melepas sistem file setelah menggunakannya:

tamuunmount / mnt

CATATAN

Lainnya Pengguna tidak bisa melihat itu berkas sistem by kegagalan
Jika Anda memasang sistem file sebagai satu pengguna (mis. root), maka pengguna lain tidak akan dapat melihat
secara default. Cara mengatasinya adalah dengan menambahkan opsi FUSE "allow_other" saat memasang:

sudo guestmount [...] -o izinkan_lainnya / mnt

Mengaktifkan SEKERING
Pada beberapa distro, Anda mungkin perlu menambahkan diri Anda ke grup khusus (mis. "fuse") sebelum Anda
dapat menggunakan sistem file FUSE apa pun. Ini diperlukan pada Debian dan turunannya.

Di distro lain, tidak diperlukan grup khusus. Tidak perlu di Fedora atau Red Hat
Linux Perusahaan.

gunung peleburan kesalahan: "Perangkat or sumber sibuk"
Anda dapat melihat kesalahan ini ketika proses lain pada sistem melompat ke mountpoint Anda
baru saja dibuat, menahannya agar tetap terbuka dan mencegah Anda melepasnya. Biasa
penyebabnya adalah berbagai program "pengindeksan" GUI.

Solusi populer untuk masalah ini adalah mencoba kembali beberapa perintah "fusermount -u"
kali sampai berhasil (tamuunmount(1) melakukan ini untuk Anda). Sayangnya ini bukan
perbaikan yang andal jika (misalnya) sistem file yang dipasang sangat besar dan
program yang mengganggu sangat gigih.

Perbaikan yang tepat adalah dengan menggunakan mountpoint pribadi dengan membuat namespace mount baru menggunakan
khusus Linux clone(2) /berhenti berbagi(2) tandai "CLONE_NEWNS". Sayangnya saat ini
membutuhkan root dan kami mungkin juga perlu menambahkannya sebagai fitur ke guestmount.

Ras Kondisi mungkin ketika menutup turun itu koneksi
Ketika tamuunmount(1) /gunung peleburan(1) keluar, guestmount mungkin masih berjalan dan membersihkan
titik mount. Gambar disk tidak akan sepenuhnya diselesaikan.

Ini berarti skrip seperti berikut memiliki kondisi balapan yang buruk:

gunung tamu -a disk.img -i / mnt
# salin sesuatu ke dalam / mnt
tamuunmount / mnt
# segera coba gunakan 'disk.img' ** TIDAK AMAN **

Solusinya adalah dengan menggunakan --pid-file opsi untuk menulis PID guestmount ke file, lalu
setelah guestunmount spin menunggu PID ini keluar.

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

# ...
# ...

# Simpan PID guestmount *sebelum* memanggil guestunmount.
pid="$(kucing guestmount.pid)"

# Lepaskan sistem file.
tamuunmount / mnt

timeout = 10

hitung=$waktu habis
while kill -0 "$pid" 2>/dev/null && [ $count -gt 0 ]; melakukan
tidur 1
((menghitung--))
dilakukan
jika [ $hitung -eq 0 ]; kemudian
echo "$0: tunggu sampai guestmount keluar gagal setelah $timeout detik"
keluar 1
fi

# Sekarang aman untuk menggunakan gambar disk.

Perhatikan bahwa jika Anda menggunakan API "guestfs_mount_local" secara langsung (lihat "MOUNT LOCAL" di
tamu(3)) maka jauh lebih mudah untuk menulis program yang aman dan bebas balapan.

PILIHAN

-a gambar
--Menambahkan gambar
Tambahkan perangkat blok atau gambar mesin virtual.

Format gambar disk terdeteksi secara otomatis. Untuk menimpa ini dan memaksa a
format tertentu menggunakan --format = .. .

-a URI
--Menambahkan URI
Tambahkan disk jarak jauh. Lihat "MENAMBAH PENYIMPANAN JAUH" di ikan tamu(1).

-c URI
--Menghubung URI
Jika digunakan bersama dengan -d opsi, ini menentukan libvirt URI yang akan digunakan.
Standarnya adalah menggunakan koneksi libvirt default.

-d libvirt-domain
--domain libvirt-domain
Tambahkan disk dari domain libvirt bernama. jika --ro opsi juga digunakan, lalu apa saja
domain libvirt dapat digunakan. Namun dalam mode tulis, hanya domain libvirt yang
menutup dapat disebutkan di sini.

UUID domain dapat digunakan sebagai pengganti nama.

--dir-cache-batas waktu habis N
Setel batas waktu cache readdir ke N detik, defaultnya adalah 60 detik. Bacaan
cache [sebenarnya, ada beberapa cache semi-independen] diisi setelah a
bacadir(2) panggilan dengan stat dan atribut yang diperluas dari file di direktori,
sebagai antisipasi bahwa mereka akan diminta segera setelah itu.

Ada juga cache atribut berbeda yang diterapkan oleh FUSE (lihat opsi FUSE -o
attr_timeout), tetapi cache FUSE tidak mengantisipasi permintaan di masa mendatang, hanya cache
yang sudah ada.

--echo-kunci
Saat meminta kunci dan frasa sandi, guestfish biasanya mematikan bergema sehingga Anda
tidak dapat melihat apa yang Anda ketik. Jika Anda tidak khawatir tentang serangan Tempest dan
tidak ada orang lain di ruangan Anda dapat menentukan bendera ini untuk melihat apa yang Anda ketik.

--fd=FD
Tentukan deskriptor file pipa atau eventfd. Saat mountpoint siap digunakan,
guestmount menulis satu byte ke deskriptor file ini. Ini dapat digunakan dalam
berhubungan dengan --tanpa-garpu untuk menjalankan captive guestmount di bawah proses lain.

--format=mentah|qcow2|..
--format
Default untuk -a pilihannya adalah mendeteksi secara otomatis format gambar disk. Menggunakan
ini memaksa format disk untuk -a opsi yang mengikuti pada baris perintah. Menggunakan
--format tanpa argumen beralih kembali ke deteksi otomatis untuk selanjutnya -a Pilihan.

Jika Anda memiliki image disk tamu format mentah yang tidak tepercaya, Anda harus menggunakan opsi ini untuk
menentukan format disk. Ini menghindari kemungkinan masalah keamanan dengan malware
tamu (CVE-2010-3851). Lihat juga "guestfs_add_drive_opts" di tamu(3).

--sekering-bantuan
Tampilkan bantuan pada opsi FUSE khusus (lihat -o bawah).

--membantu
Tampilkan bantuan singkat dan keluar.

-i
--inspektur
Menggunakan virt-inspektur(1) kode, periksa disk untuk mencari sistem operasi dan
mount filesystem seperti yang akan dipasang pada mesin virtual nyata.

--kunci-dari-stdin
Baca parameter kunci atau frasa sandi dari stdin. Standarnya adalah mencoba membaca
frasa sandi dari pengguna dengan membuka /dev/tty.

--hidup
Hubungkan ke mesin virtual langsung. (Eksperimental, lihat "MELANGKAH UNTUK MENJALANKAN DAEMON"
in tamu(3)).

-m dev[:mountpoint[:options[:fstype]]
--Gunung dev[:mountpoint[:options[:fstype]]]
Pasang partisi bernama atau volume logis pada titik mount yang diberikan in itu tamu (ini
tidak ada hubungannya dengan mountpoints di Host).

Jika mountpoint dihilangkan, defaultnya adalah /. Anda harus memasang sesuatu di /.

Bagian ketiga (dan jarang digunakan) dari parameter mount adalah daftar opsi mount
digunakan untuk memasang sistem file yang mendasarinya. Jika ini tidak diberikan, maka opsi pemasangan
adalah string kosong atau "ro" (yang terakhir jika --ro bendera digunakan). Oleh
menentukan opsi pemasangan, Anda mengganti pilihan default ini. Mungkin satu-satunya
waktu Anda akan menggunakan ini adalah untuk mengaktifkan ACL dan/atau atribut yang diperluas jika sistem file
dapat mendukung mereka:

-m /dev/sda1:/:acl,user_xattr

Bagian keempat dari parameter adalah driver sistem file yang akan digunakan, seperti "ext3" atau
"ntfs". Ini jarang diperlukan, tetapi dapat berguna jika beberapa driver valid untuk a
filesystem (misalnya: "ext2" dan "ext3"), atau jika libguestfs salah mengidentifikasi filesystem.

--tanpa-garpu
Jangan melakukan daemonisasi (atau bercabang ke latar belakang).

-n
--tidak ada sinkronisasi
Secara default, kami mencoba menyinkronkan disk tamu saat titik pemasangan FUSE dilepas.
Jika Anda menentukan opsi ini, maka kami tidak akan mencoba menyinkronkan disk. Lihat
diskusi tentang sinkronisasi otomatis di tamu(3) halaman manual.

-o Option
--pilihan Option
Berikan opsi tambahan ke FUSE.

Untuk mendapatkan daftar semua opsi tambahan yang didukung oleh FUSE, gunakan perintah di bawah ini. Catatan
itu hanya FUSE -o opsi dapat dilewati, dan hanya beberapa di antaranya yang merupakan ide bagus.

gunung tamu --fuse-help

Beberapa opsi FUSE yang berpotensi berguna:

-o izinkan_lainnya
Izinkan pengguna lain untuk melihat sistem file.

-o attr_timeout=N
Aktifkan cache atribut oleh FUSE, dan atur batas waktu ke N detik.

-o kernel_cache
Izinkan kernel untuk men-cache file (mengurangi jumlah pembacaan yang harus dilakukan
melalui tamu(3) API). Ini biasanya merupakan ide yang bagus jika Anda mampu membelinya
penggunaan memori ekstra.

-o uid=N -o gid=N
Gunakan opsi ini untuk memetakan semua UID dan GID di dalam sistem file tamu ke
nilai-nilai yang dipilih.

-o gunakan_ino
Pertahankan nomor inode dari sistem file yang mendasarinya.

Tanpa opsi ini, FUSE membuat nomor inodenya sendiri. Nomor inode Anda
lihat di Stat(2), "ls -i" dll bukan nomor inode dari sistem file yang mendasarinya.

Note opsi ini berpotensi berbahaya jika sistem file yang mendasarinya terdiri dari:
beberapa titik mount, karena Anda mungkin melihat nomor inode duplikat muncul melalui
SEKERING. Penggunaan opsi ini dapat membingungkan beberapa perangkat lunak.

--pid-file nama file
Tulis PID dari proses pekerja guestmount ke "nama file".

-r
--ro
Tambahkan perangkat dan pasang semuanya hanya-baca. Juga larang penulisan dan buat disk
muncul hanya-baca untuk FUSE.

Ini sangat disarankan jika Anda tidak akan mengedit disk tamu. Jika tamu
sedang berjalan dan opsi ini adalah tidak disediakan, maka ada risiko yang kuat dari disk
korupsi pada tamu. Kami mencoba untuk mencegah hal ini terjadi, tetapi tidak selalu
mungkin.

Lihat juga "BUKA DISK UNTUK MEMBACA DAN MENULIS" di ikan tamu(1).

--selinux
Aktifkan dukungan SELinux untuk tamu.

-v
--bertele-tele
Aktifkan pesan verbose dari libguestfs yang mendasarinya.

-V
--Versi: kapan
Tampilkan versi program dan keluar.

-w
--rw
Ini mengubah -a, -d dan -m opsi sehingga disk ditambahkan dan pemasangan selesai
Baca tulis.

Lihat "BUKA DISK UNTUK MEMBACA DAN MENULIS" di ikan tamu(1).

-x
--jejak
Lacak panggilan dan entri libguestfs ke setiap fungsi FUSE.

Ini juga menghentikan daemon dari forking ke latar belakang (lihat --tanpa-garpu).

Gunakan guestmount online menggunakan layanan onworks.net