guestfish - Online di Cloud

Jalankan guestfish di penyedia hosting gratis OnWorks melalui Ubuntu Online, Fedora Online, emulator online Windows, atau emulator online MAC OS

Ini adalah perintah guestfish yang dapat dijalankan di penyedia hosting gratis OnWorks menggunakan salah satu dari beberapa stasiun kerja online gratis kami seperti Ubuntu Online, Fedora Online, emulator online Windows atau emulator online MAC OS

Jalankan di Ubuntu Jalankan di Fedora Jalankan di Windows Sim Jalankan di MACOS Sim

PROGRAM:

NAMA

guestfish - shell sistem file tamu

RINGKASAN

ikan tamu [--opsi] [perintah]

ikan tamu

ikan tamu [--ro|--rw] -a disk.img

ikan tamu [--ro|--rw] -a disk.img -m dev[:mountpoint]

ikan tamu -d libvirt-domain

ikan tamu [--ro|--rw] -a disk.img -i

ikan tamu -d libvirt-domain -i

PERINGATAN

Menggunakan "guestfish" 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 "guestfish" 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

Guestfish adalah alat shell dan baris perintah untuk memeriksa dan memodifikasi mesin virtual
sistem file. Ini menggunakan libguestfs dan memperlihatkan semua fungsionalitas API guestfs,
melihat tamu(3).

Guestfish memberi Anda akses terstruktur ke libguestfs API, dari skrip shell atau
baris perintah atau secara interaktif. Jika Anda ingin menyelamatkan gambar mesin virtual yang rusak, Anda
harus melihat virt-penyelamatan(1) perintah.

CONTOH

As an interaktif tempurung
$ ikan tamu

Selamat datang di guestfish, shell sistem file tamu untuk
mengedit sistem file mesin virtual.

Ketik: 'help' untuk daftar perintah
'pria' untuk membaca manual
'berhenti' untuk keluar dari shell

> add-ro disk.img
> Lari
> daftar-filesystem
/dev/sda1:ext4
/dev/vg_guest/lv_root: ext4
/dev/vg_guest/lv_swap: tukar
> pasang /dev/vg_guest/lv_root /
> kucing / etc / fstab
# / etc / fstab
# Dibuat oleh anaconda
[...]
> keluar

Mulai dari tempurung script
Buat yang baru /etc/motd file dalam gambar tamu atau disk:

ikan tamu <<_EOF_
tambahkan disk.img
menjalankan
pasang /dev/vg_guest/lv_root /
tulis /etc/motd "Selamat datang, pengguna baru"
_EOF_

Daftar volume logis LVM dalam gambar disk:

ikan tamu -a disk.img --ro <<_EOF_
menjalankan
ls
_EOF_

Daftar semua sistem file dalam gambar disk:

ikan tamu -a disk.img --ro <<_EOF_
menjalankan
daftar-filesystem
_EOF_

On satu Command line
Memperbarui / Etc / resolv.conf dalam tamu:

ikan tamu \
tambahkan disk.img : jalankan : mount /dev/vg_guest/lv_root / : \
menulis / Etc / resolv.conf "server nama 1.2.3.4"

Sunting /boot/grub/grub.conf secara interaktif:

ikan tamu --rw --tambahkan disk.img \
--mount /dev/vg_guest/lv_root \
--mount /dev/sda1:/ boot \
edit /boot/grub/grub.conf

bukit disk secara otomatis
Gunakan -i opsi untuk memasang disk secara otomatis dari mesin virtual:

ikan tamu --ro -a disk.img -i kucing / etc / group

ikan tamu --ro -d libvirt-domain -i cat / etc / group

Cara lain untuk mengedit /boot/grub/grub.conf secara interaktif adalah:

guestfish --rw -a disk.img -saya edit /boot/grub/grub.conf

As a naskah penerjemah
Buat disk 100MB yang berisi partisi berformat ext2:

#!/usr/bin/guestfish -f
tes jarang1.img 100M
menjalankan
bagian-disk /dev/sda mbr
mkfs ext2 /dev/sda1

Start dengan a siap cakram
Cara alternatif untuk membuat disk 100MB disebut tes1.img mengandung satu
partisi berformat ext2:

ikan tamu -N fs

Untuk membuat daftar apa yang tersedia lakukan:

guestfish -N bantuan | lebih sedikit

terpencil drive
Akses disk jarak jauh menggunakan ssh:

ikan tamu -a ssh://example.com/path/to/disk.img

terpencil kontrol
eval "`guestfish --listen`"
ikan tamu --tambahan jarak jauh disk.img
ikan tamu --lari jarak jauh
ikan tamu --remote lvs

PILIHAN

--membantu
Menampilkan bantuan umum pada opsi.

-h
--cmd-bantuan
Daftar semua perintah guestfish yang tersedia.

-h cmd
--cmd-bantuan cmd
Menampilkan bantuan terperinci pada satu perintah "cmd".

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

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

Menggunakan flag ini sebagian besar setara dengan menggunakan perintah "add", dengan "readonly:true"
jika --ro bendera diberikan, dan dengan "format:..." jika --format=... bendera diberikan.

-a URI
--Menambahkan URI
Tambahkan disk jarak jauh. Lihat "MENAMBAH PENYIMPANAN JAUH".

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

--csh
Jika menggunakan --mendengarkan opsi dan shell seperti csh, gunakan opsi ini. Lihat bagian
"REMOTE CONTROL DAN CSH" di bawah ini.

-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.

Menggunakan tanda ini sebagian besar setara dengan menggunakan perintah "tambah domain", dengan
"readonly:true" jika --ro bendera diberikan, dan dengan "format:..." jika --format=...
bendera diberikan.

--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.

-f fillet
--mengajukan fillet
Baca perintah dari "file". Untuk menulis skrip guestfish murni, gunakan:

#!/usr/bin/guestfish -f

--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.

Sebagai contoh:

ikan tamu --format=raw -a disk.img

memaksa format mentah (tidak ada deteksi otomatis) untuk disk.img.

ikan tamu --format=raw -a disk.img --format -a another.img

memaksa format mentah (tidak ada deteksi otomatis) untuk disk.img dan kembali ke deteksi otomatis untuk
lain.img.

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 "menambah".

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

Penggunaan tipikal adalah:

ikan tamu -d myguest -i

(untuk domain libvirt tidak aktif yang disebut tamu saya), atau:

ikan tamu --ro -d myguest -i

(untuk domain aktif, hanya baca), atau tentukan perangkat blokir secara langsung:

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

Perhatikan bahwa sintaks baris perintah sedikit berubah di atas guestfish versi lama.
Anda masih dapat menggunakan sintaks lama:

ikan tamu [--ro] -i disk.img

ikan tamu [--ro] -i libvirt-domain

Menggunakan flag ini sebagian besar setara dengan menggunakan perintah "inspect-os" dan kemudian menggunakan
perintah lain untuk memasang sistem file yang ditemukan.

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

--mendengarkan
Garpu ke latar belakang dan dengarkan perintah jarak jauh. Lihat bagian "KONTROL JARAK JAUH
GUESTFISH OVER A SOCKET" di bawah ini.

--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.

Jika mountpoint dihilangkan, defaultnya adalah /.

Anda harus memasang sesuatu di / sebelum sebagian besar perintah akan bekerja.

Jika ada -m or --Gunung pilihan diberikan, tamu secara otomatis diluncurkan.

Jika Anda tidak tahu sistem file apa yang terdapat dalam image disk, Anda dapat menjalankan guestfish
tanpa opsi ini, lalu buat daftar partisi, sistem file, dan LV yang tersedia (lihat
perintah "list-partitions", "list-filesystems" dan "lvs"), atau Anda dapat menggunakan
virt-filesystem(1) program.

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

Menggunakan flag ini sama dengan menggunakan perintah "mount-options".

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.

--jaringan
Aktifkan jaringan pengguna QEMU di tamu.

-N [nama file=]jenis
--baru [nama file=]jenis
-N membantu
Siapkan gambar disk baru yang diformat sebagai "ketik". Ini adalah alternatif untuk -a
pilihan: sedangkan -a menambahkan disk yang ada, -N membuat disk yang telah diformat sebelumnya dengan a
sistem file dan menambahkannya. Lihat "GAMBAR DISK YANG DIPERSIAPKAN" di bawah.

-n
--tidak ada sinkronisasi
Nonaktifkan sinkronisasi otomatis. Ini diaktifkan secara default. Lihat pembahasan autosync di
tamu(3) halaman manual.

--tanpa-jalan-tujuan
Jangan melengkapi tab jalur pada sistem file tamu. Hal ini berguna untuk dapat memukul
tombol tab untuk menyelesaikan jalur pada sistem file tamu, tetapi ini menyebabkan tambahan "tersembunyi"
panggilan tamu untuk dilakukan, jadi opsi ini ada di sini untuk memungkinkan fitur ini dinonaktifkan.

--pipa-kesalahan
Jika penulisan gagal untuk menyalurkan perintah (lihat "PIPE" di bawah), maka perintah tersebut mengembalikan sebuah
kesalahan.

Standarnya (juga karena alasan historis) adalah mengabaikan kesalahan tersebut sehingga:

> command_with_lots_of_output | kepala

tidak memberikan kesalahan.

--progress-bar
Aktifkan bilah kemajuan, bahkan ketika guestfish digunakan secara non-interaktif.

Progress bar diaktifkan secara default saat guestfish digunakan sebagai shell interaktif.

--tidak ada kemajuan-bar
Nonaktifkan bilah kemajuan.

--jauh[=pid]
Kirim perintah jarak jauh ke $GUESTFISH_PID atau "pid". Lihat bagian "KONTROL JARAK JAUH
GUESTFISH OVER A SOCKET" di bawah ini.

-r
--ro
Ini mengubah -a, -d dan -m opsi sehingga disk ditambahkan dan pemasangan selesai
hanya baca.

Opsi harus selalu digunakan jika gambar disk atau mesin virtual mungkin sedang berjalan,
dan umumnya direkomendasikan dalam kasus di mana Anda tidak memerlukan akses tulis ke disk.

Perhatikan bahwa gambar disk yang disiapkan dibuat dengan -N tidak terpengaruh oleh opsi ini. Juga
perintah seperti "tambah" tidak terpengaruh - Anda harus menentukan opsi "hanya baca: benar"
secara eksplisit jika Anda membutuhkannya.

Lihat juga "BUKA DISK UNTUK MEMBACA DAN MENULIS" di bawah ini.

--selinux
Aktifkan dukungan SELinux untuk tamu. Lihat "SELINUX" di tamu(3).

-v
--bertele-tele
Aktifkan pesan yang sangat bertele-tele. Ini sangat berguna jika Anda menemukan bug.

-V
--Versi: kapan
Tampilkan nomor versi guestfish / libguestfs 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 bawah ini.

-x Gema setiap perintah sebelum menjalankannya.

PERINTAH ON COMMAND GARIS

Setiap argumen tambahan (non-opsi) diperlakukan sebagai perintah untuk dieksekusi.

Perintah untuk mengeksekusi harus dipisahkan oleh titik dua (":"), di mana titik dua adalah yang terpisah
parameter. Dengan demikian:

ikan tamu cmd [args...] : cmd [args...] : cmd [args...] ...

Jika tidak ada argumen tambahan, maka kita masukkan shell, baik shell interaktif
dengan prompt (jika inputnya adalah terminal) atau shell non-interaktif.

Baik dalam mode baris perintah atau shell non-interaktif, perintah pertama yang memberikan
kesalahan menyebabkan seluruh Shell keluar. Dalam mode interaktif (dengan prompt) jika ada perintah
gagal, Anda dapat terus memasukkan perintah.

MENGGUNAKAN jalankan (ATAU Lari)

Seperti tamu(3), Anda harus terlebih dahulu mengonfigurasi tamu Anda dengan menambahkan disk, lalu meluncurkannya,
kemudian pasang semua disk yang Anda butuhkan, dan terakhir keluarkan tindakan/perintah. Jadi urutan umumnya
hari adalah:

· tambahkan atau -a/--tambahkan

· luncurkan (alias lari)

· pasang atau -m/--mount

· perintah lainnya

"lari" adalah sinonim untuk "meluncurkan". Anda harus "meluncurkan" (atau "menjalankan") tamu Anda sebelum memasang
atau melakukan perintah lainnya.

Satu-satunya pengecualian adalah jika salah satu dari -i, -m, --Gunung, -N or --baru pilihan yang diberikan
kemudian "jalankan" dilakukan secara otomatis, hanya karena guestfish tidak dapat melakukan tindakan yang Anda lakukan
diminta tanpa melakukan ini.

PEMBUKAAN DISK UNTUK BACA BACA DAN MENULIS

Ikan tamu, gunung tamu(1) dan virt-penyelamatan(1) pilihan --ro dan --rw mempengaruhi apakah
opsi baris perintah lainnya -a, -c, -d, -i dan -m buka gambar disk hanya-baca atau untuk
penulisan.

Di libguestfs 1.10, guestfish, guestmount, dan virt-rescue secara default membuka disk
gambar yang disediakan pada baris perintah untuk menulis. Untuk membuka gambar disk hanya-baca, Anda harus
do -a gambar --ro.

Ini penting: Jika Anda secara tidak sengaja membuka gambar disk VM langsung yang dapat ditulis maka Anda akan menyebabkan
kerusakan disk yang ireversibel.

Di libguestfs mendatang, kami bermaksud mengubah default dengan cara lain. Gambar disk akan menjadi
dibuka hanya-baca. Anda harus menentukan ikan tamu --rw, gunung tamu --rw, kebajikan-
menyelamatkan --rw, atau ubah file konfigurasi untuk mendapatkan akses tulis untuk gambar disk
ditentukan oleh opsi baris perintah lainnya.

Versi guestfish, guestmount, dan virt-rescue ini memiliki --rw opsi yang tidak melakukan apa-apa
(ini sudah menjadi default). Namun sangat disarankan agar Anda menggunakan opsi ini untuk
tunjukkan bahwa Anda memerlukan akses tulis, dan siapkan skrip Anda untuk hari ketika opsi ini
akan diperlukan untuk akses tulis.

Catatan: Ini tidak tidak mempengaruhi perintah seperti "tambah" dan "mount", atau libguestfs lainnya
program selain guestfish dan guestmount.

KUTIPAN

Anda dapat mengutip parameter biasa menggunakan tanda kutip tunggal atau ganda. Sebagai contoh:

tambahkan "file dengan spasi.img"

rm '/nama file'

rm'/"'

Beberapa perintah memerlukan daftar string yang akan dilewati. Untuk ini, gunakan spasi-
daftar terpisah, terlampir dalam tanda kutip. String yang berisi spasi putih untuk dilewati
harus diapit oleh tanda kutip tunggal. Kutipan tunggal literal harus diloloskan dengan
garis miring terbalik.

vgcreate VG "/dev/sda1 /dev/sdb1"
memerintah "/ bin / gema 'bar makanan'"
memerintah "/ bin / gema \'foo\'"

ESCAPE URUTAN IN DUA KALI LIPAT DITERIMA ARGUMEN
Dalam argumen yang dikutip ganda (hanya) gunakan garis miring terbalik untuk menyisipkan karakter khusus:

"\A"
Karakter peringatan (bel).

"\B"
Karakter spasi mundur.

"\F"
Bentuk karakter umpan.

"\n"
Karakter baris baru.

"\R"
Karakter carriage return.

"\T"
Karakter tab horizontal.

"\v"
Karakter tab vertikal.

"\""
Karakter kutipan ganda literal.

"\ooo"
Karakter dengan nilai oktal ooo. Harus ada tepat 3 digit oktal (tidak seperti C).

"\xhh"
Karakter dengan nilai heksadesimal hh. Harus ada tepat 2 digit heksagonal.

Dalam implementasi saat ini "\000" dan "\x00" tidak dapat digunakan dalam string.

"\\"
Karakter garis miring terbalik.

OPSIONAL ARGUMEN

Beberapa perintah mengambil argumen opsional. Argumen ini muncul dalam dokumentasi ini sebagai
"[nama argumen:..]". Anda dapat menggunakannya seperti dalam contoh berikut:

tambahkan nama file

tambahkan nama file readonly:true

tambahkan format nama file: qcow2 readonly: false

Setiap argumen opsional dapat muncul paling banyak satu kali. Semua argumen opsional harus muncul setelah
yang dibutuhkan.

ANGKA

Bagian ini berlaku untuk semua perintah yang dapat mengambil bilangan bulat sebagai parameter.

UKURAN AKHIRAN
Saat perintah mengambil parameter yang diukur dalam byte, Anda dapat menggunakan salah satu dari yang berikut:
akhiran untuk menentukan kilobyte, megabyte, dan ukuran yang lebih besar:

k or K or KiB
Ukuran dalam kilobyte (dikalikan dengan 1024).

KB Ukuran dalam satuan SI 1000 byte.

M or eb
Ukurannya dalam megabita (dikalikan dengan 1048576).

MB Ukuran dalam satuan SI 1000000 byte.

G or GiB
Ukuran dalam gigabyte (dikalikan dengan 2**30).

GB Ukuran dalam SI 10**9 satuan byte.

T or TiB
Ukuran dalam terabyte (dikalikan dengan 2**40).

TB Ukuran dalam SI 10**12 satuan byte.

P or PiB
Ukuran dalam petabyte (dikalikan dengan 2**50).

PB Ukuran dalam SI 10**15 satuan byte.

E or EiB
Ukuran dalam exabytes (dikalikan dengan 2**60).

EB Ukuran dalam SI 10**18 satuan byte.

Z or ZiB
Ukuran dalam zettabytes (dikalikan dengan 2**70).

ZB Ukuran dalam SI 10**21 satuan byte.

Y or YiB
Ukuran dalam yottabytes (dikalikan dengan 2**80).

YB Ukuran dalam SI 10**24 satuan byte.

Sebagai contoh:

ukuran terpotong /file 1G

akan memotong file menjadi 1 gigabyte.

Hati-hati karena beberapa perintah mengambil ukuran dalam kilobyte atau megabyte (misalnya parameter
untuk "memsize" sudah ditentukan dalam megabyte). Menambahkan sufiks mungkin tidak akan berhasil
apa yang Anda harapkan.

OKTAL DAN heksadesimal ANGKA
Untuk menentukan radix (basis) gunakan konvensi C: 0 untuk mengawali angka oktal atau "0x"
untuk mengawali bilangan heksadesimal. Sebagai contoh:

1234 bilangan desimal 1234
02322 bilangan oktal, setara dengan desimal 1234
0x4d2 angka heksadesimal, setara dengan desimal 1234

Saat menggunakan perintah "chmod", Anda hampir selalu ingin menentukan bilangan oktal untuk
mode, dan Anda harus mengawalinya dengan 0 (tidak seperti Unix chmod(1) program):

chmod 0777 /publik # OK
chmod 777 /publik # SALAH! Ini adalah mode 777 desimal = 01411 oktal.

Perintah yang mengembalikan angka biasanya mencetaknya dalam desimal, tetapi beberapa perintah mencetak
angka dalam radiks lain (misalnya "umask" mencetak mode dalam oktal, didahului oleh 0).

KARTU LIAR DAN GLOBING

Baik guestfish maupun guestfs API yang mendasarinya tidak melakukan ekspansi wildcard (globbing) dengan
bawaan. Jadi misalnya berikut ini tidak akan melakukan apa yang Anda harapkan:

rm-rf /rumah/*

Dengan asumsi Anda tidak memiliki direktori yang disebut secara harfiah /rumah/* maka perintah di atas akan
mengembalikan kesalahan.

Untuk melakukan ekspansi wildcard, gunakan perintah "glob".

bola rm-rf /rumah/*

menjalankan "rm-rf" di setiap jalur yang cocok (mis. berpotensi menjalankan perintah berkali-kali),
setara dengan:

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

"glob" hanya berfungsi pada jalur tamu sederhana dan bukan pada nama perangkat.

Jika Anda memiliki beberapa parameter, masing-masing berisi wildcard, maka glob akan melakukan a
produk kartesius.

KOMENTAR

Setiap baris yang dimulai dengan a # karakter diperlakukan sebagai komentar dan diabaikan. NS # bisa
opsional didahului oleh spasi, tapi tidak oleh sebuah perintah. Sebagai contoh:

#ini adalah komentar
#ini adalah komentar
foo # BUKAN komentar

Baris kosong juga diabaikan.

RUNNING PERINTAH LOKAL

Setiap baris yang dimulai dengan a ! karakter diperlakukan sebagai perintah yang dikirim ke shell lokal
(/ Bin / sh atau terserah sistem(3) menggunakan). Sebagai contoh:

!mkdir lokal
tgz-out /lokal jarak jauh/data-jauh.tar.gz

akan membuat direktori "lokal" di host, dan kemudian mengekspor konten /terpencil on
sistem file yang dipasang ke lokal/data jarak jauh.tar.gz. (Lihat "tgz-out").

Untuk mengubah direktori lokal, gunakan perintah "lcd". "!cd" tidak akan berpengaruh, karena
cara kerja subproses di Unix.

LOKAL PERINTAH DENGAN DI BARISAN EKSEKUSI
Jika sebuah garis dimulai dengan <! kemudian perintah shell dijalankan (seperti untuk !), tetapi selanjutnya
setiap output (stdout) dari perintah shell diurai dan dieksekusi sebagai perintah guestfish.

Dengan demikian Anda dapat menggunakan skrip Shell untuk membuat perintah guestfish sewenang-wenang yang kemudian
diurai oleh ikan tamu.

Misalnya membosankan untuk membuat urutan file (mis. /foo.1 melalui /foo.100)
menggunakan perintah guestfish saja. Namun ini sederhana jika kita menggunakan skrip shell untuk membuat
perintah guestfish untuk kita:

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

atau dengan nama seperti /foo.001:

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

Saat menggunakan guestfish secara interaktif, akan sangat membantu jika menjalankan skrip Shell terlebih dahulu
(mis. hapus karakter awal "<" jadi itu hanya biasa ! perintah lokal), lihat apa
perintah guestfish itu akan berjalan, dan ketika Anda senang dengan itu tambahkan "<"
karakter untuk menjalankan perintah guestfish secara nyata.

PIPA

Gunakan "perintah | command" untuk menyalurkan output dari perintah pertama (sebuah guestfish
perintah) ke perintah kedua (perintah host apa saja). Sebagai contoh:

kucing / etc / passwd | awk -F: '$3 == 0 { print }'

(di mana "cat" adalah perintah guestfish cat, tetapi "awk" adalah program host awk). Di atas
perintah akan mencantumkan semua akun di sistem file tamu yang memiliki UID 0, yaitu. akar
akun termasuk backdoors. Contoh lain:

hexdump /bin/ls | kepala
daftar-perangkat | ekor -1
tgz-keluar / - | tar ztf -

Spasi sebelum simbol pipa diperlukan, spasi apa pun setelah simbol pipa bersifat opsional.
Semuanya setelah simbol pipa baru saja diteruskan langsung ke shell host, sehingga bisa
berisi pengalihan, gumpalan, dan hal lain yang masuk akal di sisi Host.

Untuk menggunakan argumen literal yang dimulai dengan simbol pipa, Anda harus mengutipnya, misalnya:

gema "|"

HOME DIREKTORI

Jika parameter dimulai dengan karakter "~" maka tilde dapat diperluas sebagai rumah
jalur direktori (baik "~" untuk direktori home pengguna saat ini, atau "~user" untuk yang lain
pengguna).

Perhatikan bahwa perluasan direktori home terjadi untuk pengguna yang dikenal on itu tuan rumah, bukan di tamu
berkas sistem.

Untuk menggunakan argumen literal yang dimulai dengan tilde, Anda harus mengutipnya, misalnya:

gema "~"

TERENKRIPSI DISK

Libguestfs memiliki beberapa dukungan untuk tamu Linux yang dienkripsi sesuai dengan Kunci Terpadu Linux
Standar Setup (LUKS), yang mencakup hampir semua sistem enkripsi disk yang digunakan oleh
tamu Linux modern. Saat ini hanya LVM-on-LUKS yang didukung.

Identifikasi perangkat blok terenkripsi dan partisi menggunakan "vfs-type":

> tipe vfs /dev/sda2
crypto_LUKS

Kemudian buka perangkat tersebut menggunakan "luks-open". Ini menciptakan perangkat pemetaan perangkat yang disebut
/dev/mapper/luksdev.

> luks-open /dev/sda2 luksdev
Masukkan kunci atau frasa sandi ("kunci"):

Terakhir, Anda harus memberi tahu LVM untuk memindai grup volume pada perangkat mapper yang baru dibuat:

vgscan
vg-aktifkan-semua benar

Volume logis sekarang dapat dipasang dengan cara biasa.

Sebelum menutup perangkat LUKS, Anda harus melepas semua volume logis di dalamnya dan menonaktifkan
grup volume dengan memanggil "vg-activate VG palsu" pada masing-masing grup. Kemudian Anda dapat menutup
perangkat pembuat peta:

vg-aktifkan false /dev/VG
luks-close /dev/mapper/luksdev

WINDOWS JALAN

Jika jalur diawali dengan "win:" maka Anda dapat menggunakan huruf dan jalur drive bergaya Windows
(dengan beberapa batasan). Perintah berikut setara:

file /WINDOWS/system32/config/system.LOG

file menang:\windows\system32\config\system.log

file MENANG:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG

Parameter ditulis ulang "di belakang layar" dengan mencari posisi di mana drive
sudah terpasang, menambahkannya ke jalur, mengubah semua karakter garis miring terbalik ke depan
slash, lalu selesaikan hasilnya menggunakan "case-sensitive-path". Misalnya jika E: drive
dipasang pada /e maka parameternya mungkin ditulis ulang seperti ini:

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

Ini hanya berfungsi di posisi argumen yang mengharapkan jalur.

MENGUnggah DAN MENGUNDUH FILE

Untuk perintah seperti "upload", "download", "tar-in", "tar-out" dan lain-lain yang meng-upload
dari atau mengunduh ke file lokal, Anda dapat menggunakan nama file khusus "-" yang berarti "dari
stdin" atau "ke stdout". Misalnya:

unggah - /foo

membaca stdin dan membuat file dari itu / foo dalam gambar disk, dan:

tar keluar / Etc - | tar tf -

menulis tarball ke stdout dan kemudian menyalurkannya ke perintah "tar" eksternal (lihat
"PIPA").

Saat menggunakan "-" untuk membaca dari stdin, input dibaca hingga akhir stdin. Anda juga bisa
gunakan sintaks khusus seperti "heredoc" untuk membaca hingga beberapa penanda akhir yang sewenang-wenang:

unggah -<
jalur masukan 1
jalur masukan 2
jalur masukan 3
AKHIR

String karakter apa pun dapat digunakan sebagai ganti "END". Penanda akhir harus muncul di a
barisnya sendiri, tanpa karakter sebelum atau sesudahnya (bahkan spasi).

Perhatikan bahwa sintaks "-<<" hanya berlaku untuk parameter yang digunakan untuk mengunggah file lokal (jadi-
disebut parameter "FileIn" di generator).

EXIT ON ERROR TINGKAH LAKU

Secara default, guestfish akan mengabaikan kesalahan apa pun saat dalam mode interaktif (mis. mengambil perintah
dari manusia melalui tty), dan akan keluar pada kesalahan pertama dalam mode non-interaktif
(skrip, perintah yang diberikan pada baris perintah).

Jika Anda mengawali perintah dengan a - karakter, maka perintah itu tidak akan menyebabkan guestfish untuk
keluar, bahkan jika (satu) perintah itu mengembalikan kesalahan.

TERPENCIL PENGENDALIAN IKAN TAMU LEBIH A STOPKONTAK

Ikan tamu dapat dikendalikan dari jarak jauh melalui soket. Ini berguna terutama di shell
skrip di mana Anda ingin membuat beberapa perubahan berbeda pada sistem file, tetapi Anda tidak melakukannya
ingin overhead memulai proses guestfish setiap kali.

Mulai proses server guestfish menggunakan:

eval "`guestfish --listen`"

dan kemudian kirimkan perintah dengan melakukan:

ikan tamu --remote cmd [...]

Untuk menyebabkan server keluar, kirimkan perintah keluar:

ikan tamu --pintu keluar jarak jauh

Perhatikan bahwa server biasanya akan keluar jika ada kesalahan dalam suatu perintah. Anda dapat mengubah
ini dengan cara biasa. Lihat bagian "KELUAR PADA PERILAKU KESALAHAN".

PENGENDALIAN GANDA IKAN TAMU PROSES
Pernyataan "eval" menetapkan variabel lingkungan $GUESTFISH_PID, yang merupakan cara
--terpencil opsi tahu ke mana harus mengirim perintah. Anda dapat memiliki beberapa pendengar ikan tamu
proses yang berjalan menggunakan:

eval "`guestfish --listen`"
pid1=$GUESTFISH_PID
eval "`guestfish --listen`"
pid2=$GUESTFISH_PID
...
ikan tamu --remote=$pid1 cmd
ikan tamu --remote=$pid2 cmd

TERPENCIL PENGENDALIAN DAN CSH
Saat menggunakan shell seperti csh (csh, tcsh dll) Anda harus menambahkan --csh opsi:

eval "`guestfish --listen --csh`"

TERPENCIL PENGENDALIAN RINCIAN
Remote control terjadi melalui soket domain Unix yang disebut /tmp/.guestfish-$UID/socket-$PID,
di mana $UID adalah ID pengguna efektif dari proses, dan $PID adalah ID proses dari
Server.

Versi klien dan server Guestfish harus sama persis.

Guestfish versi lama rentan terhadap CVE-2013-4419 (lihat "CVE-2013-4419" di
tamu(3)). Ini diperbaiki dalam versi saat ini.

MENGGUNAKAN TERPENCIL PENGENDALIAN dengan kuat DARI SHELL SKRIP
Dari Bash, Anda dapat menggunakan kode berikut yang membuat instance guestfish, dengan benar
mengutip baris perintah, menangani kegagalan untuk memulai, dan membersihkan guestfish saat skrip
keluar:

#!/ bin / bash -

mengatur -e

ikan tamu[0]="ikan tamu"
ikan tamu[1]="--dengarkan"
ikan tamu[2]="--ro"
ikan tamu[3]="-a"
ikan tamu[4]="disk.img"

GUESTFISH_PID=
eval $("${guestfish[@]}")
jika [ -z "$GUESTFISH_PID" ]; kemudian
echo "error: guestfish tidak bisa dijalankan, lihat pesan error di atas"
keluar 1
fi

pembersihan_ikan tamu()
{
guestfish --remote -- exit >/dev/null 2>&1 ||:
}
perangkap cleanup_guestfish KELUAR ERR

ikan tamu --jauh -- lari

# ...

TERPENCIL PENGENDALIAN TIDAK JANGAN BEKERJA DENGAN -a ETC. PILIHAN
Pilihan seperti -a, --Menambahkan, -N, --baru dll tidak berinteraksi dengan baik dengan dukungan jarak jauh.
Mereka diproses secara lokal, dan tidak dikirim ke guestfish jarak jauh. Secara khusus
ini tidak akan melakukan apa yang Anda harapkan:

ikan tamu --remote --tambahkan disk.img

Jangan gunakan opsi ini. Gunakan perintah yang setara sebagai gantinya, misalnya:

guestfish --tambahan jarak jauh disk.img

atau:

ikan tamu --remote
> tambahkan disk.img

TERPENCIL PENGENDALIAN MENJALANKAN COMMAND GANTUNG
Menggunakan perintah "jalankan" (atau "luncurkan") dari jarak jauh dalam konteks substitusi perintah hang,
yaitu. jangan lakukan (perhatikan backquotes):

a=`guestfish --lari jarak jauh`

Karena perintah "run" tidak menghasilkan output pada stdout, ini tidak berguna. Untuk
informasi lebih lanjut lihat https://bugzilla.redhat.com/show_bug.cgi?id=592910.

SIAP DISK GAMBAR

Gunakan -N [nama file=]jenis or --baru [nama file=]jenis parameter untuk memilih salah satu dari kumpulan
gambar disk yang telah diformat sebelumnya yang dapat dibuat guestfish agar Anda dapat menghemat pengetikan. Ini adalah
sangat berguna untuk tujuan pengujian. Opsi ini digunakan sebagai pengganti -a pilihan,
Dan suka -a dapat muncul beberapa kali (dan dapat dicampur dengan -a).

Disk baru disebut tes1.img untuk yang pertama -N, tes2.img untuk yang kedua dan seterusnya.
File yang ada di direktori saat ini adalah ditimpa. Anda dapat menggunakan nama file yang berbeda
dengan menentukan "filename=" sebelum jenisnya (lihat contoh di bawah).

Jenis secara singkat menjelaskan bagaimana disk harus berukuran, dipartisi, bagaimana sistem file
harus dibuat, dan bagaimana konten harus ditambahkan. Secara opsional jenisnya dapat diikuti
oleh parameter tambahan, dipisahkan oleh karakter ":" (titik dua). Sebagai contoh, -N fs menciptakan a
default 100MB, disk yang jarang dialokasikan, berisi satu partisi, dengan partisi
diformat sebagai ext2. -N fs:ext4:1G adalah sama, tetapi untuk sistem file ext4 pada disk 1GB
sebagai gantinya.

Perhatikan bahwa sistem file yang disiapkan tidak dipasang. Anda biasanya harus menggunakan
"mount /dev/sda1 /" perintah atau tambahkan -m / Dev / sda1 .

Jika ada -N or --baru opsi diberikan, alat libguestfs diluncurkan secara otomatis.

CONTOH
Buat disk 100MB dengan partisi berformat ext4, yang disebut tes1.img pada saat ini
direktori:

ikan tamu -N fs:ext4

Buat disk 32MB dengan partisi berformat VFAT, dan pasang:

ikan tamu -N fs:vfat:32M -m /dev/sda1

Buat disk kosong 200MB:

ikan tamu -N disk: 200M

Buat disk kosong 200MB bernama blankdisk.img (dari pada tes1.img):

ikan tamu -N blankdisk.img=disk:200M

-N cakram - membuat a kosong cakram
"ikan tamu -N [nama file=]disk[:ukuran]"

Buat disk kosong, ukuran 100MB (secara default).

Ukuran default dapat diubah dengan menyediakan parameter opsional.

Parameter opsional adalah:

Nama Nilai default
ukuran 100M ukuran gambar disk

-N bagian - membuat a dipartisi cakram
"ikan tamu -N [nama file=]bagian[:ukuran[:partisi]]"

Buat disk dengan satu partisi. Secara default, ukuran disk adalah 100MB (
ruang yang tersedia di partisi akan sedikit lebih kecil) dan tabel partisi akan
menjadi MBR (gaya DOS lama).

Default ini dapat diubah dengan menyediakan parameter opsional.

Parameter opsional adalah:

Nama Nilai default
ukuran 100M ukuran gambar disk
partisi mbr tipe tabel partisi

-N fs - membuat a berkas sistem
"ikan tamu -N [namafile=]fs[:sistemfile[:ukuran[:partisi]]]"

Buat disk dengan satu partisi, dengan partisi yang berisi sistem file kosong.
Ini default untuk membuat disk 100MB (ruang yang tersedia di sistem file akan menjadi:
sedikit lebih kecil) dengan tabel partisi MBR (gaya DOS lama) dan sistem file ext2.

Default ini dapat diubah dengan menyediakan parameter opsional.

Parameter opsional adalah:

Nama Nilai default
filesystem ext2 jenis sistem file yang digunakan
ukuran 100M ukuran gambar disk
partisi mbr tipe tabel partisi

-N lv - membuat a cakram dengan logis volume
"ikan tamu -N [namafile=]lv[:nama[:ukuran[:partisi]]]"

Buat disk dengan satu partisi, atur partisi sebagai volume fisik LVM2,
dan tempatkan grup volume dan volume logis di sana. Ini default untuk membuat 100MB
disk dengan VG dan LV yang disebut "/ dev/VG/LV". Anda dapat mengubah nama VG dan LV dengan
memberikan nama alternatif sebagai parameter opsional pertama.

Perhatikan ini tidak membuat sistem file. Gunakan 'lvfs' untuk melakukan itu.

Parameter opsional adalah:

Nama Nilai default
beri nama /dev/VG/LV nama VG dan LV yang akan digunakan
ukuran 100M ukuran gambar disk
partisi mbr tipe tabel partisi

-N lvfs - membuat a cakram dengan logis volume dan berkas sistem
"ikan tamu -N [filename=]lvfs[:name[:filesystem[:size[:partition]]]]"

Buat disk dengan satu partisi, atur partisi sebagai volume fisik LVM2,
dan tempatkan grup volume dan volume logis di sana. Kemudian format LV dengan a
berkas sistem. Ini default untuk membuat disk 100MB dengan VG dan LV yang disebut
"/ dev/VG/LV", dengan sistem file ext2.

Parameter opsional adalah:

Nama Nilai default
beri nama /dev/VG/LV nama VG dan LV yang akan digunakan
filesystem ext2 jenis sistem file yang digunakan
ukuran 100M ukuran gambar disk
partisi mbr tipe tabel partisi

-N bootroot - membuat a booting dan akar berkas sistem
"ikan tamu -N [filename=]bootroot[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]"

Buat disk dengan dua partisi, untuk sistem file boot dan root. Format keduanya
sistem file secara mandiri. Ada beberapa parameter opsional yang mengontrol persis
tata letak dan jenis sistem file.

Parameter opsional adalah:

Nama Nilai default
bootfs ext2 jenis sistem file yang digunakan untuk boot
rootfs ext2 jenis sistem file yang digunakan untuk root
ukuran 100M ukuran gambar disk
bootsize 32M ukuran sistem file boot
partisi mbr tipe tabel partisi

-N bootrootlv - membuat a booting dan akar berkas sistem menggunakan LVM
"ikan tamu -N
[filename=]bootrootlv[:name[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]]"

Ini sama dengan "bootroot" tetapi sistem file root (hanya) ditempatkan pada logika
volume, dinamai secara default "/ dev/VG/LV". Ada beberapa parameter opsional yang
mengontrol tata letak yang tepat.

Parameter opsional adalah:

Nama Nilai default
nama /dev/VG/LV nama VG dan LV untuk root
bootfs ext2 jenis sistem file yang digunakan untuk boot
rootfs ext2 jenis sistem file yang digunakan untuk root
ukuran 100M ukuran gambar disk
bootsize 32M ukuran sistem file boot
partisi mbr tipe tabel partisi

MENAMBAHKAN TERPENCIL PENYIMPANAN

Untuk tingkat API dokumentasi on ini tema, melihat "guestfs_add_drive_opts" in tamu(3) dan
"TERPENCIL PENYIMPANAN" in tamu(3).

Di baris perintah, Anda dapat menggunakan -a opsi untuk menambahkan perangkat blok jaringan menggunakan URI-
format gaya, misalnya:

ikan tamu -a ssh://[email dilindungi]/disk.img

URI tidak bisa digunakan dengan perintah "tambah". Perintah yang setara menggunakan API secara langsung
adalah:

> tambahkan /disk.img protokol:ssh server:tcp:example.com nama pengguna:root

Mungkin -a URI format dijelaskan di bawah ini.

-a disk.img
-a file:///path/ke/disk.img
Tambahkan image disk lokal (atau perangkat) yang disebut disk.img.

-a ftp://[pengguna@]contoh.com[:port]/disk.img
-a ftps://[pengguna@]contoh.com[:port]/disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp://[pengguna@]contoh.com[:port]/disk.img
Tambahkan disk yang terletak di server FTP, HTTP, atau TFTP jarak jauh.

Perintah API yang setara adalah:

> tambahkan /disk.img protokol:(ftp|...) server:tcp:example.com

-a gluster://example.com[:port]/volname/image
Tambahkan gambar disk yang terletak di penyimpanan GlusterFS.

Server adalah yang menjalankan "glusterd", dan mungkin "localhost".

Perintah API yang setara adalah:

> tambahkan volname/protokol gambar: server gluster: tcp: contoh.com

-a iscsi://example.com[:port]/target-iqn-name[/lun]
Tambahkan disk yang terletak di server iSCSI.

Perintah API yang setara adalah:

> tambahkan protokol target-iqn-name/lun: server iscsi:tcp:example.com

-a nbd://contoh.com[:port]
-a nbd://example.com[:port]/nama ekspor
-a nbd://?socket=/socket
-a nbd:///nama ekspor?socket=/socket
Tambahkan disk yang terletak di penyimpanan Network Block Device (nbd).

/nama ekspor bagian dari URI menentukan nama ekspor NBD, tetapi biasanya dibiarkan kosong.

Opsional ?stopkontak parameter dapat digunakan untuk menentukan soket domain Unix yang kita ajak bicara
server NBD berakhir. Perhatikan bahwa Anda tidak dapat mencampur nama server (mis. TCP/IP) dan jalur soket.

Perintah API yang setara adalah (tanpa nama ekspor):

> tambahkan protokol "":nbd server:[tcp:example.com|unix:/socket]

-a rbd:///pool/disk
-a rbd://example.com[:port]/pool/disk
Tambahkan image disk yang terletak di volume penyimpanan Ceph (RBD/librbd).

Meskipun libguestfs dan Ceph mendukung banyak server, hanya satu server yang dapat
ditentukan saat menggunakan sintaks URI ini.

Perintah API yang setara adalah:

> tambahkan pool/disk protokol:rbd server:tcp:example.com:port

-a anjing gembala://[example.com[:port]]/volume/image
Tambahkan gambar disk yang terletak di volume Anjing Gembala.

Nama server bersifat opsional. Meskipun libguestfs dan Sheepdog mendukung banyak server,
hanya paling banyak satu server yang dapat ditentukan saat menggunakan sintaks URI ini.

Perintah API yang setara adalah:

> tambahkan protokol volume: anjing gembala [server: tcp: example.com]

-a ssh://[pengguna@]contoh.com[:port]/disk.img
Tambahkan gambar disk yang terletak di server jauh, diakses menggunakan SFTP Secure Shell (ssh)
protokol. SFTP didukung langsung oleh semua server SSH utama.

Perintah API yang setara adalah:

> tambahkan /disk protokol:ssh server:tcp:example.com [nama pengguna:pengguna]

KEMAJUAN BAR

Beberapa (tidak semua) perintah yang berjalan lama mengirim pesan pemberitahuan kemajuan sebagaimana adanya
berlari. Guestfish mengubah pesan-pesan ini menjadi bilah kemajuan.

Saat perintah yang mendukung bilah kemajuan membutuhkan waktu lebih dari dua detik untuk dijalankan, dan jika
bilah kemajuan diaktifkan, maka Anda akan melihat yang muncul di bawah perintah:

> ukuran salin /file besar /file lain 2048M
/ 10% [#####----------------------------------------- ] 00:30

Pemintal di sisi kiri bergerak sekali untuk setiap pemberitahuan kemajuan
diterima dari backend. Ini adalah jaminan emas (cukup) bahwa perintahnya adalah
"melakukan sesuatu" bahkan jika bilah kemajuan tidak bergerak, karena perintahnya dapat
mengirim pemberitahuan kemajuan. Ketika bilah mencapai 100% dan perintah selesai,
pemintal menghilang.

Bilah kemajuan diaktifkan secara default saat guestfish digunakan secara interaktif. Anda dapat mengaktifkan
mereka bahkan untuk mode non-interaktif menggunakan --progress-bar, dan Anda dapat menonaktifkannya
sepenuhnya menggunakan --tidak ada kemajuan-bar.

PROMPT

Anda dapat mengubah atau menambahkan warna ke prompt default ("> ") dengan mengatur
Variabel lingkungan "GUESTFISH_PS1". String kedua ("GUESTFISH_OUTPUT") dicetak
setelah perintah dimasukkan dan sebelum output, memungkinkan Anda untuk mengontrol
warna keluaran. String ketiga ("GUESTFISH_INIT") dicetak sebelum sambutan
pesan, memungkinkan Anda untuk mengontrol warna pesan itu. Sebuah string keempat
("GUESTFISH_RESTORE") dicetak sebelum guestfish keluar.

Prompt sederhana dapat diatur dengan menyetel "GUESTFISH_PS1" ke string alternatif:

$ GUESTFISH_PS1='(ketik perintah) '
$ ekspor GUESTFISH_PS1
$ ikan tamu
[...]
(ketik perintah)

Anda juga dapat menggunakan urutan pelarian khusus, seperti yang dijelaskan dalam tabel di bawah ini:

\\ Karakter garis miring terbalik literal.

\[
\] (Ini hanya boleh digunakan di "GUESTFISH_PS1".)

Tempatkan karakter non-cetak (mis. kode kontrol terminal untuk warna) di antara
"\[...\]". Apa ini untuk memberitahu garis baca(3) perpustakaan yang harus dirawat
urutan ini sebagai lebar nol, sehingga baris perintah menampilkan ulang, mengedit, dll. berfungsi.

\a Karakter lonceng.

\e Karakter ASCII ESC (escape).

\n Baris baru.

\r Pengembalian kereta.

\NN
Karakter ASCII yang kodenya adalah nilai oktal NNN.

\xNN
Karakter ASCII yang kodenya adalah nilai hex NN.

CONTOH OF PERMINTAAN
Perhatikan bahwa ini memerlukan terminal yang mendukung kode pelarian ANSI.

·

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

Versi hitam tebal dari prompt biasa.

·

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

Teks sambutan biru, prompt hijau, perintah merah, output perintah hitam.

WINDOWS 8

Windows 8 "startup cepat" dapat mencegah guestfish memasang partisi NTFS. Lihat
"WINDOWS HIBERNATION DAN WINDOWS 8 FAST STARTUP" di tamu(3).

IKAN TAMU PERINTAH

Perintah di bagian ini adalah perintah kenyamanan guestfish, dengan kata lain, mereka adalah
bukan bagian dari tamu(3) API.

membantu
membantu
bantu cmd

Tanpa parameter apa pun, ini memberikan bantuan umum.

Dengan parameter "cmd", ini menampilkan bantuan terperinci untuk perintah itu.

keluar
berhenti
Ini keluar dari guestfish. Anda juga dapat menggunakan tombol "^D".

mengalokasikan
mengalokasikan
alokasikan ukuran nama file

Ini membuat file kosong (nol) dengan ukuran yang diberikan, dan kemudian menambahkannya sehingga bisa lebih jauh
diperiksa.

Untuk pembuatan gambar lebih lanjut, lihat "pembuatan disk".

Ukuran dapat ditentukan menggunakan sufiks standar, mis. "1 jt".

Untuk membuat file sparse, gunakan "sparse". Untuk membuat image disk yang sudah disiapkan, lihat
"GAMBAR DISK YANG DIPERSIAPKAN".

salinan
copy-in lokal [lokal ...] /remotedir

"copy-in" menyalin file atau direktori lokal secara rekursif ke dalam gambar disk, menempatkannya
di direktori bernama /remotedir (yang harus ada). Perintah meta guestfish ini berubah
menjadi urutan "tar-in" dan perintah lain yang diperlukan.

Beberapa file dan direktori lokal dapat ditentukan, tetapi parameter terakhir harus selalu
menjadi direktori jarak jauh. Wildcard tidak dapat digunakan.

salinan
salin jarak jauh [jarak jauh ...] direktori lokal

"copy-out" menyalin file atau direktori jarak jauh secara rekursif dari gambar disk, menempatkan
mereka pada disk host di direktori lokal yang disebut "localdir" (yang harus ada). Ini
perintah meta guestfish berubah menjadi urutan "unduh", "tar-out" dan perintah lainnya
seperlunya.

Beberapa file dan direktori jarak jauh dapat ditentukan, tetapi parameter terakhir harus selalu
menjadi direktori lokal. Untuk mengunduh ke direktori saat ini, gunakan "." seperti dalam:

salinan / Home .

Wildcard tidak dapat digunakan dalam perintah biasa, tetapi Anda dapat menggunakannya dengan bantuan
"glob" seperti ini:

salinan glob /rumah/*.

hapus-acara
hapus nama acara

Hapus event handler yang sebelumnya terdaftar sebagai "nama". Jika beberapa acara
penangan terdaftar dengan nama yang sama, semuanya dihapus.

Lihat juga perintah guestfish "event" dan "list-events".

pameran
tampilkan nama file

Gunakan "display" (program tampilan grafis) untuk menampilkan file gambar. Ini mengunduh
file, dan menjalankan "tampilan" di atasnya.

Untuk menggunakan program alternatif, setel variabel lingkungan "GUESTFISH_DISPLAY_IMAGE".
Misalnya untuk menggunakan program tampilan GNOME:

ekspor GUESTFISH_DISPLAY_IMAGE=eog

Lihat juga pameran(1).

gema
gema [param ...]

Ini menggemakan parameter ke terminal.

mengedit
vi
emacs
edit nama file

Ini digunakan untuk mengedit file. Ini mengunduh file, mengeditnya secara lokal menggunakan editor Anda,
kemudian upload hasilnya.

Editornya adalah $EDITOR. Namun jika Anda menggunakan perintah alternatif "vi" atau "emacs" Anda akan
dapatkan editor yang sesuai.

peristiwa
nama acara eventset "skrip shell ..."

Daftarkan fragmen skrip shell yang dieksekusi ketika suatu peristiwa dimunculkan. Lihat
"guestfs_set_event_callback" di tamu(3) untuk diskusi tentang API acara di
libguestfs.

Parameter "name" adalah nama yang Anda berikan ke event handler ini. Itu bisa berupa string apa saja
(bahkan string kosong) dan hanya ada di sana sehingga Anda dapat menghapus handler menggunakan
perintah "hapus-acara" guestfish.

Parameter "eventset" adalah daftar yang dipisahkan koma dari satu atau lebih peristiwa, misalnya
"tutup" atau "tutup, lacak". Nilai khusus "*" berarti semua peristiwa.

Parameter ketiga dan terakhir adalah fragmen skrip shell (atau perintah eksternal apa pun) yang
dieksekusi ketika salah satu peristiwa di eventset terjadi. Itu dieksekusi menggunakan "$SHELL
-c", atau jika $SHELL tidak disetel maka / Bin / sh -c.

Fragmen skrip shell menerima parameter panggilan balik sebagai argumen $1, $2, dll
kejadian aktual yang dipanggil tersedia di variabel lingkungan $EVENT.

acara "" tutup "gema ditutup"
alat pesan acara,perpustakaan,trace "echo $@"
acara "" kemajuan "kemajuan gema: $3/$4"
acara "" * "echo $EVENT $@"

Lihat juga perintah guestfish "delete-event" dan "list-events".

bola
perintah glob argumen...

Perluas wildcard di jalur mana pun di daftar argumen, dan jalankan "perintah" berulang kali di setiap jalur
jalur yang cocok.

Lihat "KARTU LIAR DAN GLOBBING".

com.hexedit
hexedit
hexedit
hexedit

Gunakan hexedit (editor hex) untuk mengedit semua atau sebagian file biner atau memblokir perangkat.

Perintah ini berfungsi dengan mengunduh secara potensial seluruh file atau perangkat, mengeditnya
lokal, lalu mengunggahnya. Jika file atau perangkatnya besar, Anda harus menentukan yang mana
bagian yang ingin Anda edit dengan menggunakan parameter "maks" dan/atau "mulai" "maks". "mulai" dan "maks"
ditentukan dalam byte, dengan pengubah biasa yang diizinkan seperti "1M" (1 megabyte).

Misalnya untuk mengedit beberapa sektor pertama disk yang mungkin Anda lakukan:

hexedit /dev/sda 1M

yang akan memungkinkan Anda untuk mengedit di mana saja dalam megabyte pertama dari disk.

Untuk mengedit superblok sistem file ext2 di / Dev / sda1, melakukan:

hexedit /dev/sda1 0x400 0x400

(dengan asumsi superblok berada di lokasi standar).

Perintah ini membutuhkan eksternal com.hexedit(1) program. Anda dapat menentukan program lain untuk
gunakan dengan mengatur variabel lingkungan "HEXEDITOR".

Lihat juga "hexdump".

lcd
direktori lcd

Ubah direktori lokal, mis. direktori saat ini dari guestfish itu sendiri.

Perhatikan bahwa "!cd" tidak akan melakukan apa yang Anda harapkan.

daftar-acara
daftar-acara

Buat daftar event handler yang terdaftar menggunakan perintah "event" guestfish.

pria
panduan
pria

Membuka halaman manual untuk guestfish.

lebih
kurang
lebih banyak nama file

nama file lebih sedikit

Ini digunakan untuk melihat file.

Penampil default adalah $PAGER. Namun jika Anda menggunakan perintah alternatif "kurang" Anda akan
dapatkan perintah "kurang" secara khusus.

buka kembali
buka kembali

Tutup dan buka kembali pegangan libguestfs. Tidak perlu menggunakan ini secara normal, karena
pegangan ditutup dengan benar saat guestfish keluar. Namun ini terkadang berguna
untuk pengujian

settenv
setenv nilai VAR

Setel variabel lingkungan "VAR" ke string "nilai".

Untuk mencetak nilai variabel lingkungan gunakan perintah shell seperti:

!gema $VAR

jarang
ukuran nama file yang jarang

Ini membuat file sparse kosong dengan ukuran yang diberikan, dan kemudian menambahkannya sehingga bisa lebih jauh
diperiksa.

Dalam semua hal ini berfungsi sama dengan perintah "alloc", kecuali bahwa file gambarnya adalah
dialokasikan jarang, yang berarti bahwa blok disk tidak ditugaskan ke file sampai mereka
dibutuhkan. File disk yang jarang hanya menggunakan ruang saat ditulis, tetapi lebih lambat dan
ada bahaya Anda bisa kehabisan ruang disk nyata selama operasi tulis.

Untuk pembuatan gambar lebih lanjut, lihat "pembuatan disk".

Ukuran dapat ditentukan menggunakan sufiks standar, mis. "1 jt".

Lihat juga perintah "scratch" guestfish.

didukung
didukung

Perintah ini mengembalikan daftar grup opsional yang diketahui daemon, dan menunjukkan
mana yang didukung oleh build alat libguestfs ini.

Lihat juga "TERSEDIA" di tamu(3).

waktu
perintah waktu argumen...

Jalankan perintah seperti biasa, tetapi cetak waktu yang telah berlalu sesudahnya. Ini bisa berguna untuk
operasi benchmarking.

tidak disetelv
VAR tidak diatur

Hapus "VAR" dari lingkungan.

PERINTAH

acl-hapus-def-file
direktori acl-delete-def-file

Fungsi ini menghapus POSIX Access Control List (ACL) default yang dilampirkan ke direktori
"dir".

acl-dapatkan-file
jalur acl-get-file acltype

Fungsi ini mengembalikan POSIX Access Control List (ACL) yang dilampirkan ke "jalur". ACL adalah
dikembalikan dalam "bentuk teks panjang" (lihat acl(5)).

Parameter "acltype" mungkin:

"mengakses"
Kembalikan ACL (akses) biasa untuk file, direktori, atau objek sistem file lainnya.

"bawaan"
Kembalikan ACL default. Biasanya ini hanya masuk akal jika "path" adalah direktori.

acl-set-file
jalur acl-set-file acltype acl

Fungsi ini mengatur POSIX Access Control List (ACL) yang dilampirkan ke "path".

Parameter "acltype" mungkin:

"mengakses"
Atur ACL (akses) biasa untuk file, direktori, atau objek sistem file lainnya.

"bawaan"
Setel ACL default. Biasanya ini hanya masuk akal jika "path" adalah direktori.

Parameter "acl" adalah ACL baru baik dalam "bentuk teks panjang" atau "bentuk teks pendek" (lihat
acl(5)). ACL baru sepenuhnya menggantikan ACL sebelumnya pada file. ACL harus
berisi izin Unix penuh (mis. "u::rwx,g::rx,o::rx").

Jika Anda menentukan pengguna individu atau grup, maka bidang topeng juga diperlukan
(mis. "m::rwx"), diikuti oleh "u:INDO:..." dan/atau "g:INDO:..." bidang. Sebuah string ACL penuh
karena itu mungkin terlihat seperti ini:

u::rwx,g::rwx,o::rwx,m::rwx,u:500:rwx,g:500:rwx
\ Izin Unix / \mask/ \ ACL /

Anda harus menggunakan UID dan GID numerik. Untuk memetakan nama pengguna dan nama grup ke yang benar
ID numerik dalam konteks tamu, gunakan fungsi Augeas (lihat "aug-init").

tambahkan-cdrom
tambahkan-cdrom nama file

Fungsi ini menambahkan image disk CD-ROM virtual ke guest.

Gambar ditambahkan sebagai drive hanya-baca, jadi fungsi ini setara dengan "tambah-drive-ro".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "add-drive-ro".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

tambah domain
domain
add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..] [cachemode:..] [ buang:..] [copyonread:true|false]

Fungsi ini menambahkan disk yang dilampirkan ke domain libvirt bernama "dom". Ini bekerja dengan
menghubungkan ke libvirt, meminta domain dan domain XML dari libvirt, menguraikannya untuk
disk, dan memanggil "add-drive-opts" pada masing-masing disk.

Jumlah disk yang ditambahkan dikembalikan. Operasi ini atomik: jika kesalahan dikembalikan,
maka tidak ada disk yang ditambahkan.

Fungsi ini melakukan beberapa pemeriksaan minimal untuk memastikan domain libvirt tidak berjalan
(kecuali "hanya baca" benar). Di versi mendatang kami akan mencoba mendapatkan kunci libvirt
pada setiap disk.

Disk harus dapat diakses secara lokal. Ini sering berarti bahwa menambahkan disk dari jarak jauh
koneksi libvirt (lihat http://libvirt.org/remote.html) akan gagal kecuali disk tersebut
dapat diakses melalui jalur perangkat yang sama secara lokal juga.

Parameter "libvirturi" opsional menyetel URI libvirt (lihat
http://libvirt.org/uri.html). Jika ini tidak disetel maka kami terhubung ke libvirt default
URI (atau satu set melalui variabel lingkungan, lihat dokumentasi libvirt untuk selengkapnya
rincian).

Bendera "langsung" opsional mengontrol apakah panggilan ini akan mencoba menyambung ke yang sedang berjalan
proses "guestfsd" mesin virtual jika terlihat cocok elemen dalam libvirt
definisi XML. Standarnya (jika bendera dihilangkan) adalah jangan pernah mencoba. Lihat "MELampirkan ke
MENJALANKAN DAEMON" di tamu(3) untuk informasi lebih lanjut.

Jika bendera "allowuuid" benar (default salah) maka UUID mungkin dilewati bukannya
nama domainnya. String "dom" diperlakukan sebagai UUID terlebih dahulu dan dicari, dan jika itu
pencarian gagal maka kami memperlakukan "dom" sebagai nama seperti biasa.

Parameter "readonlydisk" opsional mengontrol apa yang kami lakukan untuk disk yang ditandai
di libvirt XML. Nilai yang mungkin adalah:

readonlydisk = "kesalahan"
Jika "hanya baca" salah:

Seluruh panggilan dibatalkan dengan kesalahan jika ada disk dengan bendera adalah
ditemukan.

Jika "hanya-baca" benar:

Disk dengan bendera ditambahkan hanya-baca.

readonlydisk = "baca"
Jika "hanya baca" salah:

Disk dengan bendera ditambahkan hanya-baca. Disk lain ditambahkan
Baca tulis.

Jika "hanya-baca" benar:

Disk dengan bendera ditambahkan hanya-baca.

readonlydisk = "tulis" (default)
Jika "hanya baca" salah:

Disk dengan bendera ditambahkan baca/tulis.

Jika "hanya-baca" benar:

Disk dengan bendera ditambahkan hanya-baca.

readonlydisk = "abaikan"
Jika "readonly" benar atau salah:

Disk dengan bendera dilewati.

Parameter opsional lainnya diteruskan langsung ke "add-drive-opts".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tambah-drive
menambahkan
tambahkan-drive-opts
add-drive nama file [readonly:true|false] [format:..] [iface:..] [name:..] [label:..] [protocol:..] [server:..] [username: ..] [rahasia:..] [cachemode:..] [buang:..] [copyonread:true|false]

Fungsi ini menambahkan gambar disk yang disebut nama file ke pegangan. nama file mungkin biasa
file host atau perangkat host.

Ketika fungsi ini dipanggil sebelum "diluncurkan" (kasus biasa) maka pertama kali Anda menelepon
fungsi ini, disk muncul di API sebagai / Dev / sda, kedua kalinya sebagai / dev / sdb, dan
begitu seterusnya.

Di libguestfs 1.20 Anda juga dapat memanggil fungsi ini setelah peluncuran (dengan beberapa
pembatasan). Ini disebut "hotplugging". Saat hotplugging, Anda harus menentukan a
"label" sehingga disk baru mendapatkan nama yang dapat diprediksi. Untuk informasi lebih lanjut lihat
"HOTPLUGGING" di tamu(3).

Anda tidak perlu menjadi root saat menggunakan libguestfs. Namun Anda jelas melakukannya
memerlukan izin yang memadai untuk mengakses nama file untuk operasi apa pun yang Anda inginkan
lakukan (mis. akses baca jika Anda hanya ingin membaca gambar atau akses tulis jika Anda ingin
memodifikasi gambar).

Panggilan ini memeriksa bahwa nama file ada

nama file mungkin string khusus "/ dev/null". Lihat "NULL DISK" di tamu(3).

Argumen opsional adalah:

"hanya bisa dibaca"
Jika benar maka gambar diperlakukan sebagai hanya-baca. Menulis masih diperbolehkan, tetapi mereka
disimpan dalam overlay snapshot sementara yang dibuang di akhir. disk
yang Anda tambahkan tidak diubah.

"format"
Ini memaksa format gambar. Jika Anda menghilangkan ini (atau menggunakan "add-drive" atau "add-drive-ro")
maka format secara otomatis terdeteksi. Format yang memungkinkan termasuk "mentah" dan
"qcow2".

Deteksi otomatis format membuka Anda ke lubang keamanan potensial ketika
berurusan dengan gambar format mentah yang tidak tepercaya. Lihat CVE-2010-3851 dan RHBZ#642934.
Menentukan format menutup lubang keamanan ini.

"saya menghadapi"
Opsi yang jarang digunakan ini memungkinkan Anda meniru perilaku "add-drive-
dengan-jika" panggilan (qv)

"nama"
Nama drive yang ada di tamu asli, misalnya / dev / sdb. Ini digunakan sebagai petunjuk
untuk proses pemeriksaan tamu jika tersedia.

"label"
Beri label pada disk. Label harus berupa string pendek yang unik menggunakan hanya ASCII
karakter "[a-zA-Z]". Serta nama biasa di API (seperti / Dev / sda), Yang
drive juga akan diberi nama /dev/disk/guestfs/label.

Lihat "LABEL DISK" di tamu(3).

"protokol"
Argumen protokol opsional dapat digunakan untuk memilih protokol sumber alternatif.

Lihat juga: "PENYIMPANAN JAUH" di tamu(3).

"protokol = "berkas""
nama file ditafsirkan sebagai file atau perangkat lokal. Ini adalah default jika
parameter protokol opsional dihilangkan.

"protokol = "ftp"|"ftps"|"http"|"https"|"tftp""
Sambungkan ke server FTP, HTTP, atau TFTP jarak jauh. Parameter "server" juga harus
disediakan - lihat di bawah.

Lihat juga: "FTP, HTTP DAN TFTP" di tamu(3)

"protokol = "kilau""
Hubungkan ke server GlusterFS. Parameter "server" juga harus disediakan -
Lihat di bawah.

Lihat juga: "GLUSTER" di tamu(3)

"protokol = "iscsi""
Hubungkan ke server iSCSI. Parameter "server" juga harus disediakan - lihat
di bawah. Parameter "nama pengguna" mungkin diberikan. Lihat di bawah. Rahasia"
parameter dapat diberikan. Lihat di bawah.

Lihat juga: "ISCSI" di tamu(3).

"protokol = "nbd""
Sambungkan ke server Perangkat Blok Jaringan. Parameter "server" juga harus
disediakan - lihat di bawah.

Lihat juga: "PERANGKAT BLOK JARINGAN" di tamu(3).

"protokol = "rbd""
Hubungkan ke server Ceph (librbd/RBD). Parameter "server" juga harus
disediakan - lihat di bawah. Parameter "nama pengguna" mungkin diberikan. Lihat di bawah. NS
parameter "rahasia" mungkin diberikan. Lihat di bawah.

Lihat juga: "CEPH" di tamu(3).

"protokol = "anjing gembala""
Hubungkan ke server Anjing Gembala. Parameter "server" juga dapat diberikan - lihat
di bawah.

Lihat juga: "SHEEPDOG" di tamu(3).

"protokol = "ssh""
Hubungkan ke server Secure Shell (ssh).

Parameter "server" harus disertakan. Parameter "nama pengguna" mungkin
dipasok. Lihat di bawah.

Lihat juga: "SSH" di tamu(3).

"pelayan"
Untuk protokol yang memerlukan akses ke server jauh, ini adalah daftar server.

Protokol Jumlah server yang dibutuhkan
-------- ---------------
file Daftar harus kosong atau param tidak digunakan sama sekali
ftp|ftps|http|https|tftp Tepat satu
kilau Tepat satu
iscsi Tepat satu
nbd Tepat satu
rbd Nol atau lebih
anjing gembala Nol atau lebih
ssh Tepat satu

Setiap elemen daftar adalah string yang menentukan server. String harus berada di salah satu dari
format berikut:

hostname
nama host: port
tcp: nama host
tcp: nama host: port
unix:/path/ke/socket

Jika nomor port dihilangkan, maka nomor port standar untuk protokol digunakan
(Lihat / etc / services).

"nama pengguna"
Untuk protokol "ftp", "ftps", "http", "https", "iscsi", "rbd", "ssh" dan "tftp",
ini menentukan nama pengguna jarak jauh.

Jika tidak diberikan, maka nama pengguna lokal digunakan untuk "ssh", dan tidak ada otentikasi
mencoba untuk ceph. Tetapi perhatikan ini terkadang dapat memberikan hasil yang tidak terduga, misalnya
jika menggunakan backend libvirt dan jika backend libvirt dikonfigurasi untuk memulai
alat qemu sebagai pengguna khusus seperti "qemu.qemu". Jika ragu, tentukan remote
nama pengguna yang Anda inginkan.

"rahasia"
Hanya untuk protokol "rbd", ini menentukan 'rahasia' untuk digunakan saat menghubungkan ke
perangkat jarak jauh. Itu harus dikodekan base64.

Jika tidak diberikan, maka rahasia yang cocok dengan nama pengguna yang diberikan akan dicari di
lokasi gantungan kunci default, atau jika tidak ada nama pengguna yang diberikan, maka tidak akan ada otentikasi
bekas.

"mode cache"
Pilih apakah libguestfs akan mematuhi operasi sinkronisasi (aman tapi lambat) atau tidak
(tidak aman tapi cepat). Nilai yang mungkin untuk string ini adalah:

"cachemode = "tulis balik""
Ini adalah default.

Operasi tulis di API tidak kembali sampai a menulis(2) panggilan telah selesai di
tuan rumah [tetapi perhatikan ini tidak berarti bahwa apa pun akan ditulis ke disk].

Operasi sinkronisasi di API, termasuk sinkronisasi implisit yang disebabkan oleh sistem file
penjurnalan, tidak akan kembali sampai sinkronisasi data(2) panggilan telah selesai di host,
menunjukkan bahwa data telah dikomit ke disk.

"cachemode = "tidak aman""
Dalam mode ini, tidak ada jaminan. Libguestfs dapat menyimpan apa pun dan mengabaikannya
permintaan sinkronisasi. Ini hanya cocok untuk disk awal atau disk sementara.

"membuang"
Aktifkan atau nonaktifkan dukungan buang (alias trim atau unmap) pada drive ini. Jika diaktifkan,
operasi seperti "fstrim" akan dapat membuang / membuat lubang tipis / melubangi
file atau perangkat host yang mendasarinya.

Pengaturan pembuangan yang mungkin adalah:

"buang = "nonaktifkan""
Nonaktifkan buang dukungan. Ini adalah default.

"buang = "aktifkan""
Aktifkan dukungan buang. Gagal jika membuang tidak memungkinkan.

"buang = "usaha terbaik""
Aktifkan dukungan buang jika memungkinkan, tetapi jangan gagal jika tidak didukung.

Karena tidak semua backend dan tidak semua sistem yang mendasari mendukung pembuangan, ini adalah
pilihan bagus jika Anda ingin menggunakan buang jika memungkinkan, tetapi tidak masalah jika tidak
kerja.

"copyonread"
Parameter boolean "copyonread" mengaktifkan dukungan copy-on-read. Ini hanya mempengaruhi
format disk yang memiliki file pendukung, dan menyebabkan pembacaan disimpan dalam overlay
lapisan, mempercepat banyak pembacaan pada area disk yang sama.

Nilai defaultnya salah.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tambah-drive-ro
tambahan
tambahkan-drive-ro nama file

Fungsi ini sama dengan memanggil "add-drive-opts" dengan parameter opsional
"GUESTFS_ADD_DRIVE_OPTS_READONLY" disetel ke 1, sehingga disk ditambahkan hanya-baca, dengan
format terdeteksi secara otomatis.

tambahkan-drive-ro-dengan-jika
add-drive-ro-with-if nama file iface

Ini sama dengan "add-drive-ro" tetapi memungkinkan Anda untuk menentukan antarmuka QEMU
emulasi untuk digunakan pada saat run time.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tambah drive".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

tambah-drive-gores
menggaruk
add-drive-scratch size [nama:..] [label:..]

Perintah ini menambahkan drive awal sementara ke pegangan. Parameter "ukuran" adalah
ukuran virtual (dalam byte). Drive awal kosong pada awalnya (semua pembacaan mengembalikan nol
sampai Anda mulai menulisnya). Drive dihapus ketika pegangan ditutup.

Argumen opsional "name" dan "label" diteruskan ke "add-drive".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tambahkan-drive-dengan-jika
add-drive-with-if nama file iface

Ini sama dengan "add-drive" tetapi memungkinkan Anda untuk menentukan emulasi antarmuka QEMU
untuk digunakan pada waktu berjalan.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tambah drive".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

agus-jelas
Agustus-bersihkan Agustus

Tetapkan nilai yang terkait dengan "jalur" ke "NULL". Ini sama dengan alat tambahan(1)
perintah "jelas".

tutup agustus
tutup agustus

Tutup pegangan Augeas saat ini dan bebaskan semua sumber daya yang digunakan olehnya. Setelah menelepon ini,
Anda harus memanggil "aug-init" lagi sebelum Anda dapat menggunakan fungsi Augeas lainnya.

Agustus-defnode
aug-defnode nama expr val

Mendefinisikan variabel "nama" yang nilainya merupakan hasil evaluasi "expr".

Jika "expr" mengevaluasi ke nodeset kosong, sebuah node dibuat, setara dengan memanggil "aug-
set" "expr", "value". "name" akan menjadi nodeset yang berisi node tunggal tersebut.

Jika berhasil, ini mengembalikan pasangan yang berisi jumlah node di nodeset, dan a
flag boolean jika sebuah node dibuat.

Agustus-defvar
aug-defvar nama expr

Mendefinisikan "nama" variabel Augeas yang nilainya merupakan hasil evaluasi "expr". Jika
"expr" adalah NULL, lalu "name" tidak terdefinisi.

Jika berhasil, ini mengembalikan jumlah node dalam "expr", atau 0 jika "expr" bernilai
sesuatu yang bukan nodeset.

ag-get
agustus-dapatkan augpath

Cari nilai yang terkait dengan "jalur". Jika "jalur" cocok dengan tepat satu simpul, "nilai"
dikembalikan.

agustus ini
flag root aug-init

Buat pegangan Augeas baru untuk mengedit file konfigurasi. Jika ada sebelumnya
Augeas menangani yang terkait dengan sesi guestfs ini, kemudian ditutup.

Anda harus memanggil ini sebelum menggunakan perintah "aug-*" lainnya.

"root" adalah root sistem file. "root" tidak boleh NULL, gunakan / sebagai gantinya.

Bendera sama dengan bendera yang didefinisikan di , yang logis or berikut ini
bilangan bulat:

"AUG_SAVE_BACKUP" = 1
Simpan file asli dengan ekstensi ".augsave".

"AUG_SAVE_NEWFILE" = 2
Simpan perubahan ke dalam file dengan ekstensi ".augnew", dan jangan timpa yang asli.
Mengganti "AUG_SAVE_BACKUP".

"AUG_TYPE_CHECK" = 4
Lensa Typecheck.

Opsi ini hanya berguna saat men-debug lensa Augeas. Penggunaan opsi ini dapat
memerlukan memori tambahan untuk alat libguestfs. Anda mungkin perlu mengatur
Variabel lingkungan "LIBGUESTFS_MEMSIZE" atau panggil "set-memsize".

"AUG_NO_STDINC" = 8
Jangan gunakan jalur beban standar untuk modul.

"AUG_SAVE_NOOP" = 16
Buat save no-op, cukup rekam apa yang akan diubah.

"AUG_NO_LOAD" = 32
Jangan memuat pohon di "aug-init".

Untuk menutup pegangan, Anda dapat memanggil "aug-close".

Untuk mengetahui lebih lanjut tentang Augeas, lihat http://augeas.net/.

ag-masukkan
aug-masukkan label augpath true|false

Buat "label" saudara baru untuk "jalur", masukkan ke dalam pohon sebelum atau sesudah "jalur"
(tergantung pada flag boolean "sebelum").

"jalur" harus sama persis dengan satu simpul yang ada di pohon, dan "label" harus berupa label, mis.
tidak mengandung /, "*" atau diakhiri dengan indeks tanda kurung "[N]".

ag-label
aug-label augpath

Label (nama elemen terakhir) dari ekspresi jalur Augeas "augpath" dikembalikan.
"augpath" harus cocok dengan tepat satu node, jika tidak, fungsi ini akan mengembalikan kesalahan.

ag-load
ag-load

Muat file ke dalam pohon.

Lihat "aug_load" di dokumentasi Augeas untuk detail lengkapnya.

agustus
agustus-l agustus

Ini hanyalah jalan pintas untuk mendaftar "aug-match" "path/*" dan menyortir node yang dihasilkan
ke dalam urutan abjad.

pertandingan agustus
aug-pertandingan augpath

Mengembalikan daftar jalur yang cocok dengan ekspresi jalur "jalur". Jalur yang dikembalikan adalah
cukup memenuhi syarat sehingga mereka cocok dengan tepat satu simpul di pohon saat ini.

Agustus-mv
aug-mv src tujuan

Pindahkan simpul "src" ke "tujuan". "src" harus cocok dengan tepat satu node. "tujuan" ditimpa
jika itu ada.

Agustus-rm
Agustus-rm Agustus

Hapus "jalan" dan semua anak-anaknya.

Jika berhasil, ini mengembalikan jumlah entri yang telah dihapus.

agus-simpan
agus-simpan

Ini menulis semua perubahan yang tertunda ke disk.

Bendera yang diteruskan ke "aug-init" memengaruhi persis bagaimana file disimpan.

ag-set
setel Agustus augpath val

Tetapkan nilai yang terkait dengan "jalur" ke "val".

Di Augeas API, dimungkinkan untuk menghapus node dengan menyetel nilainya ke NULL. Karena sebuah
pengawasan di libguestfs API Anda tidak dapat melakukannya dengan panggilan ini. Sebaliknya Anda harus menggunakan
panggilan "jelas-agustus".

Agustus-setm
aug-setm basis sub val

Ubah beberapa node Augeas dalam satu operasi. "dasar" adalah pencocokan ekspresi
beberapa node. "sub" adalah ekspresi jalur relatif terhadap "basis". Semua node yang cocok dengan "basis"
ditemukan, dan kemudian untuk setiap node, "sub" diubah menjadi "val". "sub" mungkin juga "NULL" di
dalam hal ini node "dasar" dimodifikasi.

Ini mengembalikan jumlah node yang dimodifikasi.

tersedia
tersedia 'grup ...'

Perintah ini digunakan untuk memeriksa ketersediaan beberapa grup fungsionalitas di
alat, yang tidak dapat disediakan oleh semua perangkat libguestfs.

Grup libguestfs, dan fungsi yang terkait dengan grup tersebut, tercantum di
"TERSEDIA" di tamu(3). Anda juga dapat mengambil daftar ini saat runtime dengan menelepon
"tersedia-semua-grup".

Argumen "grup" adalah daftar nama grup, misalnya: "["notify", "augeas"]" akan memeriksa
untuk ketersediaan fungsi inotify Linux dan Augeas (file konfigurasi
mengedit) fungsi.

Perintah tidak mengembalikan kesalahan jika semua kelompok yang diminta tersedia.

Gagal dengan kesalahan jika satu atau lebih grup yang diminta tidak tersedia di
alat.

Jika nama grup yang tidak dikenal termasuk dalam daftar grup maka kesalahan selalu
dikembalikan.

Catatan:

· "fitur-tersedia" sama dengan panggilan ini, tetapi dengan API yang sedikit lebih sederhana:
panggilan itu mengembalikan boolean true/false alih-alih membuat kesalahan.

· Anda harus memanggil "launch" sebelum memanggil fungsi ini.

Alasannya karena kita tidak tahu grup apa yang didukung oleh alat/daemon
sampai berjalan dan dapat ditanyakan.

· Jika sekelompok fungsi tersedia, ini tidak berarti bahwa mereka akan
bekerja. Anda masih harus memeriksa kesalahan saat memanggil fungsi API individual bahkan
jika tersedia.

· Biasanya tugas pembuat paket distro untuk membangun fungsionalitas lengkap ke dalam
alat libguestfs. Libguestfs hulu, jika dibuat dari sumber dengan semua persyaratan
puas, akan mendukung semuanya.

· Panggilan ini telah ditambahkan di versi 1.0.80. Di versi libguestfs sebelumnya, Anda semua
yang bisa dilakukan adalah secara spekulatif menjalankan perintah untuk mengetahui apakah daemon
menerapkannya. Lihat juga "versi".

Lihat juga "sistem file-tersedia".

tersedia-semua-grup
tersedia-semua-grup

Perintah ini mengembalikan daftar semua grup opsional yang diketahui daemon ini. Catatan
ini mengembalikan grup yang didukung dan tidak didukung. Untuk mengetahui mana yang daemon dapat
sebenarnya mendukung Anda harus memanggil "tersedia" / "fitur-tersedia" pada setiap anggota
daftar kembali.

Lihat juga "tersedia", "tersedia fitur" dan "TERSEDIA" di tamu(3).

base64-in
base64-in (base64file|-) nama file

Perintah ini mengunggah data yang disandikan base64 dari "base64file" ke nama file.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

base64-keluar
nama file base64-out (base64file|-)

Perintah ini mengunduh konten nama file, menuliskannya ke file lokal "base64file"
dikodekan sebagai base64.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

buang blk
perangkat blkdiscard

Ini membuang semua blok pada "perangkat" perangkat blok, memberikan ruang kosong kembali ke
tuan rumah.

Operasi ini memerlukan dukungan di libguestfs, sistem file host, qemu, dan host
inti. Jika dukungan ini tidak ada, ini mungkin memberikan kesalahan atau bahkan tampak berjalan tetapi lakukan
Tidak ada apa-apa. Anda juga harus mengatur atribut "discard" pada drive yang mendasarinya (lihat "add-
drive-opt").

blkdiscardzeroes
perangkat blkdiscardzeroes

Panggilan ini mengembalikan nilai true jika blok pada "perangkat" yang telah dibuang oleh panggilan ke
"blkdiscard" dikembalikan sebagai blok nol byte saat dibaca di lain waktu.

Jika mengembalikan false, maka mungkin blok yang dibuang dibaca sebagai basi atau acak
Data.

blkid
perangkat blkid

Perintah ini mengembalikan atribut perangkat blok untuk "perangkat". Bidang berikut adalah
biasanya ada di hash yang dikembalikan. Bidang lain mungkin juga ada.

"UUID"
Uuid perangkat ini.

"LABEL"
Label perangkat ini.

"VERSI: KAPAN"
Versi perintah blkid.

"TIPE"
Jenis sistem file atau RAID perangkat ini.

"PENGGUNAAN"
Penggunaan perangkat ini, misalnya "filesystem" atau "raid".

blockdev-flushbufs
perangkat blockdev-flushbufs

Ini memberitahu kernel untuk menyiram buffer internal yang terkait dengan "perangkat".

Ini menggunakan blockdev(8) perintah.

blockdev-getbsz
perangkat blockdev-getbsz

Ini mengembalikan ukuran blok perangkat.

Catatan: ini berbeda dari keduanya ukuran in blok dan berkas sistem blok ukuran. Juga ini
pengaturan tidak benar-benar digunakan oleh apa pun. Anda mungkin tidak boleh menggunakannya untuk apa pun.
Sistem file memiliki ide sendiri tentang ukuran blok yang harus dipilih.

Ini menggunakan blockdev(8) perintah.

blockdev-getro
perangkat blockdev-getro

Mengembalikan boolean yang menunjukkan apakah perangkat blok hanya-baca (true jika hanya-baca, salah jika
bukan).

Ini menggunakan blockdev(8) perintah.

blockdev-getsize64
perangkat blockdev-getsize64

Ini mengembalikan ukuran perangkat dalam byte.

Lihat juga "blockdev-getsz".

Ini menggunakan blockdev(8) perintah.

blockdev-gets
perangkat blockdev-getss

Ini mengembalikan ukuran sektor pada perangkat blok. Biasanya 512, tetapi bisa lebih besar untuk
perangkat modern.

(Catatan, ini bukan ukuran di sektor, gunakan "blockdev-getsz" untuk itu).

Ini menggunakan blockdev(8) perintah.

blockdev-getsz
perangkat blockdev-getsz

Ini mengembalikan ukuran perangkat dalam satuan sektor 512-byte (bahkan jika ukuran sektor
bukan 512 byte ... aneh).

Lihat juga "blockdev-getss" untuk ukuran sektor riil perangkat, dan "blockdev-getsize64"
untuk lebih bermanfaat ukuran in byte.

Ini menggunakan blockdev(8) perintah.

blockdev-baca ulang
perangkat baca ulang blockdev

Baca ulang tabel partisi pada "perangkat".

Ini menggunakan blockdev(8) perintah.

blockdev-setbsz
blockdev-setbsz ukuran blok perangkat

Panggilan ini tidak melakukan apa pun dan tidak pernah melakukan apa pun karena bug di blockdev. Do tidak
menggunakan .

Jika Anda perlu mengatur ukuran blok sistem file, gunakan opsi "blocksize" dari "mkfs".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mkfs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

blockdev-setra
sektor perangkat blockdev-setra

Atur readahead (dalam sektor 512-byte) untuk perangkat.

Ini menggunakan blockdev(8) perintah.

blockdev-setro
perangkat blockdev-setro

Menyetel perangkat blok bernama "perangkat" ke hanya-baca.

Ini menggunakan blockdev(8) perintah.

blockdev-setrw
perangkat blockdev-setrw

Menyetel perangkat blok bernama "perangkat" ke baca-tulis.

Ini menggunakan blockdev(8) perintah.

btrfs-balance-batal
jalur btrfs-balance-batal

Batalkan saldo berjalan pada sistem file btrfs.

btrfs-keseimbangan-jeda
jalur btrfs-balance-pause

Jeda saldo yang berjalan pada sistem file btrfs.

btrfs-saldo-resume
jalur btrfs-balance-resume

Lanjutkan saldo yang dijeda pada sistem file btrfs.

btrfs-keseimbangan-status
jalur status-keseimbangan btrfs

Tampilkan status saldo yang berjalan atau dijeda pada sistem file btrfs.

btrfs-perangkat-tambahkan
btrfs-device-add 'perangkat ...' fs

Tambahkan daftar perangkat di "perangkat" ke sistem file btrfs yang dipasang di "fs". Jika
"perangkat" adalah daftar kosong, ini tidak melakukan apa-apa.

btrfs-perangkat-hapus
btrfs-device-delete 'perangkat ...' fs

Hapus "perangkat" dari sistem file btrfs yang dipasang di "fs". Jika "perangkat" kosong
daftar, ini tidak apa-apa.

keseimbangan sistem file btrfs
keseimbangan btrfs
btrfs-filesystem-keseimbangan fs

Seimbangkan potongan dalam sistem file btrfs yang dipasang di "fs" di seluruh perangkat yang mendasarinya.

btrfs-filesystem-defragment
btrfs-filesystem-defragment path [flush:true|false] [kompres:..]

Defragment file atau direktori pada sistem file btrfs. kompres adalah salah satu dari zlib atau lzo.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfs-filesystem-mengubah ukuran
btrfs-filesystem-resize mountpoint [ukuran:N]

Perintah ini mengubah ukuran sistem file btrfs.

Perhatikan bahwa tidak seperti panggilan pengubahan ukuran lainnya, sistem file harus dipasang dan parameternya adalah
mountpoint bukan perangkat (ini adalah persyaratan btrfs itu sendiri).

Parameter opsional adalah:

"ukuran"
Ukuran baru (dalam byte) dari sistem file. Jika dihilangkan, sistem file diubah ukurannya menjadi
ukuran maksimum.

Lihat juga btrfs(8).

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfs-filesystem-sinkronisasi
btrfs-filesystem-sinkronisasi fs

Paksa sinkronisasi pada sistem file btrfs yang dipasang di "fs".

btrfs-fsck
perangkat btrfs-fsck [superblock:N] [perbaikan:true|false]

Digunakan untuk memeriksa sistem file btrfs, "perangkat" adalah file perangkat tempat sistem file berada
disimpan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfs-gambar
btrfs-image 'sumber ...' gambar [compresslevel:N]

Ini digunakan untuk membuat gambar sistem file btrfs. Semua data akan di-nolkan, tapi
metadata dan sejenisnya dipertahankan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfs-qgroup-assign
btrfs-qgroup-tetapkan jalur src dst

Tambahkan qgroup "src" ke induk qgroup "dst". Perintah ini dapat mengelompokkan beberapa qgroup menjadi a
induk qgroup untuk berbagi batas umum.

btrfs-qgroup-buat
btrfs-qgroup-buat subvolume qgroupid

Buat grup kuota (qgroup) untuk subvolume di "subvolume".

btrfs-qgroup-hancurkan
btrfs-qgroup-hancurkan qgroupid subvolume

Hancurkan grup kuota.

btrfs-qgroup-batas
btrfs-qgroup-limit ukuran subvolume

Batasi ukuran subvolume yang jalurnya adalah "subvolume". "ukuran" dapat memiliki akhiran G, M,
atau K

btrfs-qgroup-hapus
btrfs-qgroup-hapus jalur src dst

Hapus qgroup "src" dari induk qgroup "dst".

btrfs-qgroup-show
jalur btrfs-qgroup-show

Tampilkan semua grup kuota subvolume dalam sistem file btrfs, termasuk penggunaannya.

btrfs-kuota-aktifkan
btrfs-kuota-aktifkan fs true|false

Mengaktifkan atau menonaktifkan dukungan kuota subvolume untuk sistem file yang berisi "jalur".

btrfs-kuota-pindai ulang
btrfs-kuota-pindai ulang fs

Buang semua nomor qgroup dan pindai metadata lagi dengan konfigurasi saat ini.

btrfs-ganti
btrfs-ganti srcdev targetdev mntpoint

Ganti perangkat sistem file btrfs. Pada sistem file langsung, duplikat data ke
perangkat target yang saat ini disimpan di perangkat sumber. Setelah selesai
operasi, perangkat sumber dihapus dan dihapus dari sistem file.

"targetdev" harus berukuran sama atau lebih besar dari "srcdev". Perangkat yang
saat ini terpasang tidak pernah diizinkan untuk digunakan sebagai "targetdev".

btrfs-penyelamatan-potongan-pemulihan
perangkat btrfs-rescue-chunk-recover

Pulihkan pohon potongan sistem file btrfs dengan memindai perangkat satu per satu.

btrfs-penyelamatan-super-pulih
perangkat btrfs-rescue-super-recover

Pulihkan superblok yang buruk dari salinan yang baik.

btrfs-scrub-batal
btrfs-scrub-batal jalur

Batalkan scrub yang sedang berjalan pada sistem file btrfs.

btrfs-scrub-resume
jalur btrfs-scrub-resume

Lanjutkan scrub yang sebelumnya dibatalkan atau terputus pada sistem file btrfs.

btrfs-scrub-mulai
jalur btrfs-scrub-start

Membaca semua data dan metadata pada sistem file, dan menggunakan checksum dan duplikat
salinan dari penyimpanan RAID untuk mengidentifikasi dan memperbaiki data yang rusak.

btrfs-scrub-status
jalur status btrfs-scrub

Tampilkan status scrub yang sedang berjalan atau selesai pada sistem file btrfs.

btrfs-set-pembibitan
perangkat penyemaian btrfs-set-benar|salah

Mengaktifkan atau menonaktifkan fitur penyemaian perangkat yang berisi sistem file btrfs.

btrfs-subvolume-buat
btrfs-subvolume-buat-pilihan
btrfs-subvolume-buat tujuan [qgroupid:..]

Buat subvolume btrfs. Argumen "tujuan" adalah direktori tujuan dan nama
dari subvolume, dalam bentuk /jalan/ke/tujuan/nama. Parameter opsional "qgroupid"
mewakili qgroup yang akan ditambahkan subvolume yang baru dibuat.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfs-subvolume-hapus
btrfs-subvolume-hapus subvolume

Hapus subvolume atau snapshot btrfs bernama.

btrfs-subvolume-dapatkan-default
btrfs-subvolume-dapatkan-default fs

Dapatkan subvolume default atau snapshot dari sistem file yang dipasang di "mountpoint".

btrfs-subvolume-daftar
btrfs-subvolume-daftar fs

Buat daftar snapshot btrfs dan subvolume dari sistem file btrfs yang dipasang di "fs".

btrfs-subvolume-set-default
btrfs-subvolume-set-default id fs

Atur subvolume dari sistem file btrfs "fs" yang akan di-mount secara default. Melihat
"btrfs-subvolume-list" untuk mendapatkan daftar subvolume.

btrfs-subvolume-show
btrfs-subvolume-tampilkan subvolume

Kembalikan informasi rinci dari subvolume.

btrfs-subvolume-snapshot
btrfs-subvolume-snapshot-opts
btrfs-subvolume-snapshot sumber tujuan [ro:true|false] [qgroupid:..]

Buat snapshot dari "sumber" subvolume btrfs. Argumen "tujuan" adalah tujuan
direktori dan nama snapshot, dalam bentuk /jalan/ke/tujuan/nama. Secara default
snapshot yang baru dibuat dapat ditulis, jika nilai parameter opsional "ro" benar, maka
snapshot readonly dibuat. Parameter opsional "qgroupid" mewakili qgroup
tempat snapshot yang baru dibuat akan ditambahkan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

btrfstune-enable-extend-inode-refs
perangkat btrfstune-enable-extended-inode-refs

Ini akan Mengaktifkan referensi inode yang diperluas.

btrfstune-aktifkan-kurus-metadata-luas-ref
perangkat btrfstune-enable-kurus-metadata-luas-ref

Ini memungkinkan referensi tingkat metadata kurus.

penyemaian btrfstune
perangkat penyemaian btrfstune benar|salah

Aktifkan penyemaian perangkat btrfs, ini akan memaksa fs readonly sehingga Anda dapat menggunakannya untuk
membangun sistem file lain.

penunjuk c
penunjuk c

Dalam binding bahasa non-C, ini memungkinkan Anda untuk mengambil pointer C yang mendasarinya ke
menangani (yaitu. "h *"). Tujuannya adalah untuk memungkinkan perpustakaan lain untuk berinteraksi dengan
libguestfs.

nama-perangkat-kanonik
perangkat nama-perangkat-kanonik

Fungsi utilitas ini berguna saat menampilkan nama perangkat kepada pengguna. Dibutuhkan
jumlah nama perangkat yang tidak teratur dan mengembalikannya dalam format yang konsisten:

/dev/hdX
/dev/vdX
Ini dikembalikan sebagai / dev / sdX. Catatan ini berfungsi untuk nama perangkat dan nama partisi.
Ini kira-kira kebalikan dari algoritma yang dijelaskan dalam "BLOCK DEVICE NAMING"
in tamu(3).

/dev/mapper/VG-LV
/dev/dm-N
Dikonversi ke /dev/VG/LV formulir menggunakan "lvm-canonical-lv-name".

String lainnya dikembalikan tanpa dimodifikasi.

cap-get-file
jalur cap-get-file

Fungsi ini mengembalikan kemampuan Linux yang dilampirkan ke "jalur". Kemampuan yang ditetapkan adalah
dikembalikan dalam bentuk teks (lihat cap_to_text(3)).

Jika tidak ada kemampuan yang dilampirkan ke file, string kosong akan dikembalikan.

cap-set-file
batas jalur cap-set-file

Fungsi ini mengatur kemampuan Linux yang dilampirkan ke "jalur". Kemampuan mengatur "batas"
harus diteruskan dalam bentuk teks (lihat cap_from_text(3)).

jalur peka huruf besar/kecil
jalur case-sensitive-path

Ini dapat digunakan untuk menyelesaikan jalur case-insensitive pada sistem file yang case
peka. Kasus penggunaannya adalah untuk menyelesaikan jalur yang telah Anda baca dari Windows
file konfigurasi atau Registry Windows, ke jalur yang benar.

Perintah menangani kekhasan driver sistem file ntfs-3g Linux (dan mungkin
lainnya), yaitu bahwa meskipun sistem file yang mendasarinya tidak peka huruf besar-kecil, driver
mengekspor sistem file ke Linux sebagai case-sensitive.

Salah satu konsekuensinya adalah direktori khusus seperti C:\windows mungkin muncul sebagai
/JENDELA or /jendela (atau hal-hal lain) tergantung pada detail yang tepat tentang bagaimana mereka
dibuat. Di Windows sendiri ini tidak akan menjadi masalah.

Bug atau fitur? Kamu putuskan: http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1

"case-sensitive-path" mencoba menyelesaikan kasus sebenarnya dari setiap elemen di jalur. Dia
akan mengembalikan jalur yang diselesaikan jika jalur lengkap atau direktori induknya ada. jika
direktori induk ada tetapi path lengkapnya tidak, kasus direktori induk akan
diselesaikan dengan benar, dan sisanya ditambahkan tanpa dimodifikasi. Misalnya, jika file
"/Windows/System32/netkvm.sys" ada:

"case-sensitive-path" ("/windows/system32/netkvm.sys")
"Windows/System32/netkvm.sys"

"case-sensitive-path" ("/windows/system32/NoSuchFile")
"Windows/System32/NoSuchFile"

"case-sensitive-path" ("/windows/system33/netkvm.sys")
ERROR

Note: Karena perilaku di atas, "case-sensitive-path" tidak dapat digunakan untuk memeriksa
keberadaan file.

Note: Fungsi ini tidak menangani nama drive, garis miring terbalik, dll.

Lihat juga "jalur nyata".

kucing
jalan kucing

Kembalikan konten file bernama "path".

Karena, di C, fungsi ini mengembalikan "char *", tidak ada cara untuk membedakan antara
karakter "\0" dalam file dan akhir string. Untuk menangani file biner, gunakan "read-file"
atau fungsi "unduh".

checksum
checksum csumtype jalur

Panggilan ini menghitung checksum MD5, SHAx atau CRC dari file bernama "path".

Jenis checksum yang akan dihitung diberikan oleh parameter "csumtype" yang harus memilikinya
dari nilai berikut:

"crc"
Hitung pemeriksaan redundansi siklik (CRC) yang ditentukan oleh POSIX untuk perintah "cksum".

"md5"
Hitung hash MD5 (menggunakan program "md5sum").

"sha1"
Hitung hash SHA1 (menggunakan program "sha1sum").

"sha224"
Hitung hash SHA224 (menggunakan program "sha224sum").

"sha256"
Hitung hash SHA256 (menggunakan program "sha256sum").

"sha384"
Hitung hash SHA384 (menggunakan program "sha384sum").

"sha512"
Hitung hash SHA512 (menggunakan program "sha512sum").

Checksum dikembalikan sebagai string yang dapat dicetak.

Untuk mendapatkan checksum untuk perangkat, gunakan "checksum-device".

Untuk mendapatkan checksum untuk banyak file, gunakan "checksums-out".

checksum-perangkat
perangkat csumtype checksum-perangkat

Panggilan ini menghitung checksum MD5, SHAx atau CRC dari konten perangkat bernama
"perangkat". Untuk jenis checksum yang didukung, lihat perintah "checksum".

checksum keluar
checksum-out direktori csumtype (sumsfile|-)

Perintah ini menghitung checksum dari semua file biasa di direktori dan kemudian memancarkan
daftar checksum tersebut ke file output lokal "sumsfile".

Ini dapat digunakan untuk memverifikasi integritas mesin virtual. Namun untuk menjadi benar
aman Anda harus memperhatikan output dari perintah checksum (menggunakan yang
dari GNU coreutils). Khususnya ketika nama file tidak dapat dicetak, coreutils menggunakan a
sintaks garis miring terbalik khusus. Untuk informasi lebih lanjut, lihat file info GNU coreutils.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

chmod
jalur mode chmod

Ubah mode (izin) dari "path" menjadi "mode". Hanya mode numerik yang didukung.

Note: Saat menggunakan perintah ini dari guestfish, "mode" secara default akan menjadi desimal, kecuali
Anda awali dengan 0 untuk mendapatkan oktal, yaitu. pakai 0700 bukan 700.

Mode yang sebenarnya diatur dipengaruhi oleh umask.

chown
jalur grup pemilik chown

Ubah pemilik file menjadi "pemilik" dan grup menjadi "grup".

Hanya uid dan gid numerik yang didukung. Jika Anda ingin menggunakan nama, Anda harus mencari
dan urai sendiri file kata sandinya (dukungan Augeas membuat ini relatif mudah).

pengaturan backend yang jelas
nama pengaturan backend yang jelas

Jika ada string pengaturan backend yang cocok dengan "nama" atau dimulai dengan "nama=", maka itu
string dihapus dari pengaturan backend.

Panggilan ini mengembalikan jumlah string yang telah dihapus (yang mungkin 0, 1 atau lebih besar
dari 1).

Lihat "BACKEND" di tamu(3), "SETTING BACKEND" di tamu(3).

Command
perintah 'argumen ...'

Panggilan ini menjalankan perintah dari sistem file tamu. Sistem file harus di-mount, dan
harus berisi sistem operasi yang kompatibel (mis. sesuatu Linux, dengan or yang sama)
arsitektur prosesor yang kompatibel).

Parameter tunggal adalah daftar argumen gaya argv. Elemen pertama adalah nama
program yang akan dijalankan. Elemen selanjutnya adalah parameter. Daftar tidak boleh kosong (mis.
harus berisi nama program). Perhatikan bahwa perintah berjalan secara langsung, dan adalah tidak dipanggil melalui
cangkangnya (lihat "sh").

Nilai yang dikembalikan adalah apa pun yang dicetak ke stdout oleh perintah.

Jika perintah mengembalikan status keluar bukan nol, maka fungsi ini mengembalikan kesalahan
pesan. String pesan kesalahan adalah konten dari stderr dari perintah.

Variabel lingkungan $PATH akan berisi setidaknya / usr / bin dan /tempat sampah. Jika Anda membutuhkan
program dari lokasi lain, Anda harus memberikan path lengkap di parameter pertama.

Pustaka bersama dan file data yang diperlukan oleh program harus tersedia di sistem file
yang dipasang di tempat yang benar. Adalah tanggung jawab penelepon untuk memastikan semua
sistem file yang diperlukan dipasang di lokasi yang tepat.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

baris perintah
baris perintah 'argumen ...'

Ini sama dengan "perintah", tetapi membagi hasilnya menjadi daftar baris.

Lihat juga: "sh-lines"

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

kompres-perangkat-keluar
kompres-perangkat-keluar perangkat ctype (zdevice|-) [level:N]

Perintah ini mengompresi "perangkat" dan menuliskannya ke file lokal "zdevice".

Parameter "ctype" dan "level" opsional memiliki arti yang sama seperti pada "compress-out".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

kompres keluar
kompres file ctype (zfile|-) [level:N]

Perintah ini mengompres fillet dan menulisnya ke file lokal file z.

Program kompresi yang digunakan dikontrol oleh parameter "ctype". Saat ini
termasuk: "kompres", "gzip", "bzip2", "xz" atau "lzop". Beberapa jenis kompresi mungkin tidak
didukung oleh build libguestfs tertentu, dalam hal ini Anda akan mendapatkan kesalahan
berisi substring "tidak didukung".

Parameter "level" opsional mengontrol level kompresi. Arti dan default untuk
parameter ini tergantung pada program kompresi yang digunakan.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

config
konfigurasi hvparam hvvalue

Ini dapat digunakan untuk menambahkan parameter hypervisor arbitrer dari formulir -param nilai.
Sebenarnya ini tidak sembarangan - kami mencegah Anda mengatur beberapa parameter yang
akan mengganggu parameter yang kita gunakan.

Karakter pertama dari string "hvparam" harus berupa "-" (tanda hubung).

"hvvalue" bisa NULL.

copy-atribut
copy-attributes src dest [all:true|false] [mode:true|false] [xattributes:true|false] [kepemilikan:true|false]

Salin atribut jalur (yang dapat berupa file atau direktori) ke jalur lain.

Secara default atribut "tidak" disalin, jadi pastikan untuk menentukan apa saja (atau "semua" untuk disalin
semuanya).

Argumen opsional menentukan atribut mana yang dapat disalin:

"mode"
Salin bagian dari mode file dari "sumber" ke "tujuan". Hanya izin UNIX
dan bit sticky/setuid/setgid dapat disalin.

"xatribut"
Salin atribut perluasan Linux (xattrs) dari "sumber" ke "tujuan". Bendera ini
tidak melakukan apa-apa jika linuxxattrs fitur tidak tersedia (lihat "fitur-tersedia").

"kepemilikan"
Salin uid pemilik dan gid grup dari "sumber" ke "tujuan".

"semua"
Copy semua atribut dari "sumber" ke "tujuan". Mengaktifkannya memungkinkan semua
flag lain, jika belum ditentukan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

salin-perangkat-ke-perangkat
salin-perangkat-ke-perangkat src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [tambahkan:true|false]

Empat panggilan "salin-perangkat-ke-perangkat", "salin-perangkat-ke-file", "salin-file-ke-perangkat", dan
"copy-file-to-file" memungkinkan Anda menyalin dari sumber (perangkat|file) ke tujuan
(perangkat|berkas).

Salinan sebagian dapat dibuat karena Anda dapat menentukan secara opsional offset sumber, tujuan
offset dan ukuran untuk disalin. Nilai-nilai ini semua ditentukan dalam byte. Jika tidak diberikan,
offset keduanya default ke nol, dan ukuran default untuk menyalin sebanyak mungkin sampai
kami mencapai akhir sumbernya.

Sumber dan tujuan mungkin objek yang sama. Namun wilayah yang tumpang tindih mungkin tidak
disalin dengan benar.

Jika tujuannya adalah file, itu dibuat jika diperlukan. Jika file tujuan tidak
cukup besar, itu diperpanjang.

Jika tujuannya adalah file dan tanda "tambahkan" tidak disetel, maka file tujuan
terpotong. Jika bendera "tambahkan" disetel, maka salinan akan ditambahkan ke file tujuan.
Bendera "tambahkan" saat ini tidak dapat disetel untuk perangkat.

Jika flag "sparse" benar maka panggilan menghindari blok penulisan yang hanya berisi nol,
yang dapat membantu dalam beberapa situasi di mana backing disk sangat tipis. Perhatikan bahwa
kecuali target sudah di-nolkan, menggunakan opsi ini akan menghasilkan penyalinan yang salah.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

salin-perangkat-ke-file
salin-perangkat-ke-file src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [tambahkan:true|false]

Lihat "salin-perangkat-ke-perangkat" untuk gambaran umum panggilan ini.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

salin-file-ke-perangkat
salin-file-ke-perangkat src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [tambahkan:true|false]

Lihat "salin-perangkat-ke-perangkat" untuk gambaran umum panggilan ini.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

salin-file-ke-file
salin-file-ke-file src dest [srcoffset:N] [destoffset:N] [size:N] [sparse:true|false] [tambahkan:true|false]

Lihat "salin-perangkat-ke-perangkat" untuk gambaran umum panggilan ini.

Ini adalah tidak fungsi yang Anda inginkan untuk menyalin file. Ini untuk menyalin blok di dalam
file yang ada. Lihat "cp", "cp-a" dan "mv" untuk fungsi penyalinan dan pemindahan file umum.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

ukuran salinan
salin ukuran src ukuran tujuan

Perintah ini menyalin persis "ukuran" byte dari satu perangkat sumber atau file "src" ke yang lain
perangkat tujuan atau file "tujuan".

Catatan ini akan gagal jika sumbernya terlalu pendek atau jika tujuannya tidak cukup besar.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "salin-perangkat-ke-perangkat".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

cp
tujuan cp src

Ini menyalin file dari "src" ke "dest" di mana "dest" adalah nama file tujuan atau
direktori tujuan.

cp-a
tujuan cp-a src

Ini menyalin file atau direktori dari "src" ke "dest" secara rekursif menggunakan "cp -a"
perintah.

cp-r
tujuan cp-r src

Ini menyalin file atau direktori dari "src" ke "dest" secara rekursif menggunakan "cp -rP"
perintah.

Sebagian besar pengguna harus menggunakan "cp-a" sebagai gantinya. Perintah ini berguna ketika Anda tidak ingin
pertahankan izin, karena sistem file target tidak mendukungnya (terutama ketika
menulis ke sistem file DOS FAT).

cpio-out
direktori cpio-out (cpiofile|-) [format:..]

Perintah ini mengemas konten direktori dan mengunduhnya ke file lokal "cpiofile".

Parameter "format" opsional dapat digunakan untuk memilih format. Hanya berikut ini
format yang diizinkan saat ini:

"baru"
Format portabel baru (SVR4). Format ini kebetulan kompatibel dengan cpio-like
format yang digunakan oleh kernel Linux untuk initramfs.

Ini adalah format default.

"crc"
Format portabel baru (SVR4) dengan checksum.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

dd
tujuan dd src

Perintah ini menyalin dari satu perangkat sumber atau file "src" ke perangkat tujuan lain atau
file "tujuan". Biasanya Anda akan menggunakan ini untuk menyalin ke atau dari perangkat atau partisi, untuk
contoh untuk menduplikasi sistem file.

Jika tujuannya adalah perangkat, itu harus lebih besar atau lebih besar dari file sumber atau
perangkat, jika tidak, penyalinan akan gagal. Perintah ini tidak dapat melakukan salinan sebagian (lihat "salin-
perangkat-ke-perangkat").

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "salin-perangkat-ke-perangkat".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

indeks perangkat
perangkat indeks perangkat

Fungsi ini mengambil nama perangkat (mis. "/ dev/sdb") dan mengembalikan indeks perangkat di
daftar perangkat.

Nomor indeks dimulai dari 0. Perangkat bernama harus ada, misalnya sebagai string yang dikembalikan
dari "daftar-perangkat".

Lihat juga "daftar-perangkat", "part-to-dev".

df
df

Perintah ini menjalankan perintah "df" untuk melaporkan ruang disk yang digunakan.

Perintah ini sebagian besar berguna untuk sesi interaktif. Dia tidak dimaksudkan agar Anda mencoba
untuk mengurai string keluaran. Gunakan "statvfs" dari program.

df-h
df-h

Perintah ini menjalankan perintah "df -h" untuk melaporkan ruang disk yang digunakan dalam format yang dapat dibaca manusia.

Perintah ini sebagian besar berguna untuk sesi interaktif. Dia tidak dimaksudkan agar Anda mencoba
untuk mengurai string keluaran. Gunakan "statvfs" dari program.

pembuatan disk
disk-buat ukuran format nama file [backingfile:..] [backingformat:..] [preallocation:..] [compat:..] [clustersize:N]

Buat gambar disk kosong yang disebut nama file (file host) dengan format "format" (biasanya
"mentah" atau "qcow2"). Ukurannya adalah "ukuran" byte.

Jika digunakan dengan parameter "backingfile" opsional, maka snapshot dibuat di atas
file pendukung. Dalam hal ini, "ukuran" harus diteruskan sebagai "-1". Ukuran snapshot
sama dengan ukuran file pendukung, yang ditemukan secara otomatis. Anda
didorong untuk juga melewati "backingformat" untuk menggambarkan format "backingfile".

If nama file mengacu pada perangkat blok, kemudian perangkat diformat. "Ukuran" diabaikan
karena perangkat blok memiliki ukuran intrinsik.

Parameter opsional lainnya adalah:

"praalokasi"
Jika formatnya "mentah", maka ini bisa berupa "mati" (atau "jarang") atau "penuh" untuk membuat
file jarang atau sepenuhnya dialokasikan masing-masing. Standarnya adalah "mati".

Jika formatnya adalah "qcow2", maka ini bisa berupa "mati" (atau "jarang"), "metadata" atau "penuh".
Pra-alokasi metadata bisa lebih cepat saat melakukan banyak penulisan, tetapi menggunakan lebih banyak ruang.
Standarnya adalah "mati".

"cocok"
"qcow2" only: Teruskan string 1.1 untuk menggunakan format qcow2 lanjutan yang didukung oleh qemu
1.1.

"ukuran kelompok"
"qcow2" only: Mengubah ukuran cluster qcow2. Standarnya adalah 65536 (byte) dan ini
pengaturan dapat berupa kekuatan apa pun dari dua antara 512 dan 2097152.

Perhatikan bahwa panggilan ini tidak menambahkan disk baru ke pegangan. Anda mungkin perlu memanggil "add-
drive-opts" secara terpisah.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

format disk
nama file format disk

Deteksi dan kembalikan format gambar disk yang disebut nama file. nama file bisa juga menjadi
perangkat host, dll. Jika format gambar tidak dapat dideteksi, maka "tidak diketahui" adalah
dikembalikan.

Perhatikan bahwa mendeteksi format disk mungkin tidak aman dalam beberapa keadaan. Melihat
"CVE-2010-3851" di tamu(3).

Lihat juga: "FORMAT GAMBAR DISK" di tamu(3)

disk-memiliki-backing-file
disk-memiliki-backing-file nama file

Deteksi dan kembalikan apakah gambar disk nama file memiliki file cadangan.

Perhatikan bahwa mendeteksi fitur disk mungkin tidak aman dalam beberapa keadaan. Melihat
"CVE-2010-3851" di tamu(3).

disk-virtual-ukuran
nama file ukuran virtual disk

Deteksi dan kembalikan ukuran virtual dalam byte dari gambar disk yang disebut nama file.

Perhatikan bahwa mendeteksi fitur disk mungkin tidak aman dalam beberapa keadaan. Melihat
"CVE-2010-3851" di tamu(3).

dmesg
dmesg

Ini mengembalikan pesan kernel (output "dmesg") dari kernel tamu. Ini
terkadang berguna untuk debugging masalah yang diperpanjang.

Cara lain untuk mendapatkan informasi yang sama adalah dengan mengaktifkan pesan verbose dengan "set-verbose"
atau dengan mengatur variabel lingkungan "LIBGUESTFS_DEBUG=1" sebelum menjalankan program.

Download
unduh remotefilename (nama file|-)

Unduh berkas namafile jarak jauh dan simpan sebagai nama file pada mesin lokal.

nama file juga bisa menjadi pipa bernama.

Lihat juga "mengunggah", "kucing".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

unduh-offset
unduh-offset nama file jarak jauh (nama file|-) ukuran offset

Unduh berkas namafile jarak jauh dan simpan sebagai nama file pada mesin lokal.

namafile jarak jauh dibaca untuk "ukuran" byte mulai dari "offset" (wilayah ini harus berada dalam
file atau perangkat).

Perhatikan bahwa tidak ada batasan jumlah data yang dapat diunduh dengan panggilan ini,
tidak seperti "membaca", dan panggilan ini selalu membaca jumlah penuh kecuali terjadi kesalahan.

Lihat juga "unduh", "baca".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

drop-cache
drop-cache whattodrop

Ini menginstruksikan kernel tamu untuk menghapus cache halamannya, dan/atau dentries dan cache inode.
Parameter "whattodrop" memberi tahu kernel apa yang harus dijatuhkan, lihat
http://linux-mm.org/Drop_Caches

Mengatur "whattodrop" ke 3 harus menghapus semuanya.

Ini secara otomatis memanggil sinkronisasi(2) sebelum operasi, sehingga memori tamu maksimum adalah
dibebaskan.

du
jalan du

Perintah ini menjalankan perintah "du -s" untuk memperkirakan penggunaan ruang file untuk "path".

"path" dapat berupa file atau direktori. Jika "jalur" adalah direktori maka perkiraannya termasuk
isi direktori dan semua subdirektori (secara rekursif).

Hasilnya adalah perkiraan ukuran dalam Kilobyte (yaitu. unit 1024 byte).

e2fsck.dll
perangkat e2fsck [benar: benar|salah] [paksa: benar|salah]

Ini menjalankan pemeriksa sistem file ext2/ext3 pada "perangkat". Ini dapat mengambil yang berikut ini:
argumen opsional:

"benar"
Memperbaiki sistem file secara otomatis. Opsi ini akan menyebabkan e2fsck otomatis
perbaiki masalah sistem file apa pun yang dapat diperbaiki dengan aman tanpa campur tangan manusia.

Opsi ini mungkin tidak ditentukan bersamaan dengan opsi "forceall".

"paksa"
Asumsikan jawaban 'ya' untuk semua pertanyaan; memungkinkan e2fsck untuk digunakan non-
secara interaktif.

Opsi ini mungkin tidak ditentukan bersamaan dengan opsi "benar".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

e2fsck-f
perangkat e2fsck-f

Ini menjalankan "e2fsck -p -f device", mis. menjalankan pemeriksa sistem file ext2/ext3 pada "perangkat",
noninteraktif (-p), bahkan jika sistem file tampak bersih (-f).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "e2fsck".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

echo-daemon
echo-daemon 'kata-kata ...'

Perintah ini menggabungkan daftar "kata" yang diteruskan dengan spasi tunggal di antara mereka dan
mengembalikan string yang dihasilkan.

Anda dapat menggunakan perintah ini untuk menguji koneksi ke daemon.

Lihat juga "ping-daemon".

Egrep
jalur regex egrep

Ini memanggil program "egrep" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

egrepi
jalur regex egrepi

Ini memanggil program eksternal "egrep -i" dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

sama
sama file1 file2

Ini membandingkan dua file file1 dan file2 dan mengembalikan true jika kontennya persis
sama, atau salah sebaliknya.

Eksternal CMP(1) program digunakan untuk perbandingan.

ada
ada jalan

Ini mengembalikan "benar" jika dan hanya jika ada file, direktori (atau apa pun) dengan yang diberikan
nama "jalan".

Lihat juga "is-file", "is-dir", "stat".

exlinux
direktori extlinux

Instal bootloader SYSLINUX pada perangkat yang dipasang di direktori. Tidak seperti "syslinux"
yang memerlukan sistem file FAT, ini dapat digunakan pada sistem file ext2/3/4 atau btrfs.

direktori parameter dapat berupa mountpoint, atau direktori di dalam mountpoint.

Anda juga harus menandai partisi sebagai "aktif" ("part-set-bootable") dan Master Boot
Rekaman harus diinstal (misalnya menggunakan "pwrite-device") pada sektor pertama dari keseluruhan
disk. Paket SYSLINUX dilengkapi dengan beberapa Master Boot Record yang sesuai. Lihat
exlinux(1) halaman manual untuk informasi lebih lanjut.

Konfigurasi tambahan dapat diberikan ke SYSLINUX dengan menempatkan file bernama
extlinux.conf pada sistem file di bawah direktori. Untuk informasi lebih lanjut tentang
isi file ini, lihat exlinux(1).

Lihat juga "syslinux".

salah
pilih jalur len

Perintah ini mengalokasikan file sebelumnya (berisi nol byte) bernama "path" dengan ukuran "len" byte.
Jika file sudah ada, itu akan ditimpa.

Jangan bingung dengan perintah "alloc" khusus guestfish yang mengalokasikan file di
host dan melampirkannya sebagai perangkat.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "fallocate64" sebagai gantinya.

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

salah alokasi64
jalur fallocate64 len

Perintah ini mengalokasikan file sebelumnya (berisi nol byte) bernama "path" dengan ukuran "len" byte.
Jika file sudah ada, itu akan ditimpa.

Perhatikan bahwa panggilan ini mengalokasikan blok disk untuk file. Untuk membuat file yang jarang, gunakan
"ukuran terpotong" sebagai gantinya.

Panggilan usang "fallocate" melakukan hal yang sama, tetapi karena pengawasan itu hanya diperbolehkan
Panjang 30 bit harus ditentukan, secara efektif membatasi ukuran maksimum file yang dibuat
melalui panggilan itu ke 1GB.

Jangan bingung dengan perintah "alloc" dan "sparse" khusus guestfish yang membuat
file di host dan melampirkannya sebagai perangkat.

fitur-tersedia
'grup ...' yang tersedia fitur

Ini sama dengan "tersedia", tetapi tidak seperti panggilan itu, ia mengembalikan true/false yang sederhana
hasil boolean, alih-alih melempar pengecualian jika fitur tidak ditemukan. Untuk yang lain
dokumentasi lihat "tersedia".

fgrep
jalur pola fgrep

Ini memanggil program "fgrep" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

fgrepi
jalur pola fgrepi

Ini memanggil program "fgrep -i" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

fillet
jalur file

Panggilan ini menggunakan standar fillet(1) perintah untuk menentukan jenis atau isi file.

Panggilan ini juga akan secara transparan melihat ke dalam berbagai jenis file terkompresi.

Perintah persis yang dijalankan adalah "file -zb path". Perhatikan khususnya bahwa nama filenya adalah
tidak ditambahkan ke output ( -b pilihan).

Outputnya tergantung pada output yang mendasarinya fillet(1) perintah dan itu bisa berubah
masa depan dengan cara di luar kendali kita. Dengan kata lain, output tidak dijamin oleh
ABI.

Lihat juga: fillet(1), "vfs-type", "lstat", "is-file", "is-blockdev" (dll), "is-zero".

file-arsitektur
nama file arsitektur file

Ini mendeteksi arsitektur biner nama file, dan mengembalikannya jika diketahui.

Arsitektur yang didefinisikan saat ini adalah:

"i386"
String ini dikembalikan untuk semua binari 32 bit i386, i486, i586, i686 terlepas dari
persyaratan prosesor yang tepat dari biner.

"x86_64"
64bit x86-64.

"spar"
SPARC 32 bit.

"sparc64"
64 bit SPARC V9 dan di atasnya.

"ia64"
Intel Itanium.

"ppc"
PC Daya 32 bit.

"ppc64"
PC Daya 64 bit.

"lengan"
ARM 32bit.

"aarch64"
ARM 64bit.

Libguestfs dapat mengembalikan string arsitektur lain di masa mendatang.

Fungsi ini bekerja setidaknya pada jenis file berikut:

· banyak jenis biner Un*x dan Linux

· banyak jenis perpustakaan bersama Un*x dan Linux

· Binari Windows Win32 dan Win64

· Windows Win32 dan Win64 DLL

Binari dan DLL Win32 mengembalikan "i386".

Binari dan DLL Win64 mengembalikan "x86_64".

· Modul kernel Linux

· Gambar initrd gaya baru Linux

· beberapa kernel vmlinuz Linux non-x86

Apa yang tidak dapat dilakukannya saat ini:

· perpustakaan statis (libfoo.a)

· Initrd gaya lama Linux sebagai sistem file ext2 terkompresi (RHEL 3)

· kernel x86 Linux vmlinuz

x86 gambar vmlinuz (format bzImage) terdiri dari campuran 16-, 32- dan kode terkompresi,
dan sangat sulit untuk dibongkar. Jika Anda ingin menemukan arsitektur kernel,
gunakan arsitektur modul initrd atau kernel terkait.

ukuran file
file ukuran file

Perintah ini mengembalikan ukuran fillet dalam byte.

Untuk mendapatkan statistik lain tentang sebuah file, gunakan "stat", "lstat", "is-dir", "is-file" dll. Untuk mendapatkan
ukuran perangkat blok, gunakan "blockdev-getsize64".

sistem file-tersedia
sistem file yang tersedia sistem file

Periksa apakah libguestfs mendukung sistem file bernama. Argumen "sistem file" adalah
nama sistem file, seperti "ext3".

Anda harus memanggil "launch" sebelum menggunakan perintah ini.

Ini terutama berguna sebagai tes negatif. Jika ini mengembalikan true, itu tidak berarti bahwa a
sistem file tertentu dapat dibuat atau dipasang, karena sistem file dapat gagal untuk yang lain
alasan seperti itu menjadi versi sistem file yang lebih baru, atau tidak kompatibel
fitur, atau kekurangan mkfs yang tepat.fs> alat.

Lihat juga "tersedia", "tersedia fitur", "TERSEDIA" di tamu(3).

mengisi
isi c len path

Perintah ini membuat file baru bernama "path". Isi awal file adalah "len"
oktet "c", di mana "c" harus berupa angka dalam rentang "[0..255]".

Untuk mengisi file dengan nol byte (jarang), jauh lebih efisien menggunakan "truncate-
size". Untuk membuat file dengan pola pengulangan byte, gunakan "fill-pattern".

isi-dir
isi-dir dir nr

Fungsi ini, berguna untuk menguji sistem file, membuat file kosong "nr" di direktori
"dir" dengan nama 00000000 hingga "nr-1" (yaitu setiap nama file memiliki panjang 8 digit yang diisi dengan
nol).

pola isi
pola pola isi jalur len

Fungsi ini seperti "mengisi" kecuali ia membuat file baru dengan panjang "len" yang berisi
pola berulang byte dalam "pola". Polanya dipotong jika perlu untuk
memastikan panjang file persis "len" byte.

menemukan
temukan direktori

Perintah ini mencantumkan semua file dan direktori, secara rekursif, mulai dari direktori. Itu
pada dasarnya setara dengan menjalankan perintah shell "find directory -print" tetapi beberapa
pasca-pemrosesan terjadi pada output, dijelaskan di bawah ini.

Ini mengembalikan daftar string tanpa Apa pun awalan. Jadi jika struktur direktori adalah:

/tmp/a
/tmp/b
/tmp/c/d

kemudian daftar yang dikembalikan dari "temukan" / Tmp akan menjadi 4 elemen:

a
b
c
CD

If direktori bukan direktori, maka perintah ini mengembalikan kesalahan.

Daftar yang dikembalikan diurutkan.

temukan0
find0 direktori (file|-)

Perintah ini mencantumkan semua file dan direktori, secara rekursif, mulai dari direktori,
menempatkan daftar yang dihasilkan dalam file eksternal yang disebut arsip.

Perintah ini bekerja dengan cara yang sama seperti "find" dengan pengecualian berikut:

· Daftar yang dihasilkan ditulis ke file eksternal.

· Item (nama file) dalam hasil dipisahkan oleh karakter "\0". Melihat menemukan(1) pilihan
-cetak0.

· Daftar hasil tidak diurutkan.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

findfs-label
label label findfs

Perintah ini mencari sistem file dan mengembalikan yang memiliki label yang diberikan. Sebuah
kesalahan dikembalikan jika tidak ada sistem file seperti itu yang dapat ditemukan.

Untuk menemukan label sistem file, gunakan "vfs-label".

temukanfs-uuid
temukanfs-uuid uuid

Perintah ini mencari sistem file dan mengembalikan yang memiliki UUID yang diberikan. Sebuah
kesalahan dikembalikan jika tidak ada sistem file seperti itu yang dapat ditemukan.

Untuk menemukan UUID sistem file, gunakan "vfs-uuid".

fsck
perangkat fsck fstype

Ini menjalankan pemeriksa sistem file (fsck) pada "perangkat" yang seharusnya memiliki tipe sistem file
"fstype".

Bilangan bulat yang dikembalikan adalah status. Melihat fsck(8) untuk daftar kode status dari "fsck".

Catatan:

· Beberapa kode status dapat dijumlahkan.

· Kode pengembalian bukan nol dapat berarti "berhasil", misalnya jika kesalahan telah diperbaiki
pada sistem file.

· Memeriksa atau memperbaiki volume NTFS tidak didukung (oleh linux-ntfs).

Perintah ini sepenuhnya setara dengan menjalankan "fsck -a -t fstype device".

fstream
fstrim mountpoint [offset:N] [panjang:N] [minimumfreeextent:N]

Pangkas ruang kosong di sistem file yang dipasang di "mountpoint". Sistem file harus
terpasang baca-tulis.

Konten sistem file tidak terpengaruh, tetapi ruang kosong apa pun di sistem file
"dipangkas", yaitu, diberikan kembali ke perangkat host, sehingga membuat gambar disk lebih jarang,
memungkinkan ruang yang tidak digunakan dalam file qcow2 untuk digunakan kembali, dll.

Operasi ini memerlukan dukungan di libguestfs, sistem file yang dipasang, host
sistem file, qemu dan kernel host. Jika dukungan ini tidak ada, mungkin akan terjadi kesalahan
atau bahkan tampak berlari tetapi tidak melakukan apa-apa.

Lihat juga "ruang bebas-nol". Itu adalah operasi yang sedikit berbeda yang mengubah ruang kosong
dalam sistem file menjadi nol. Itu valid untuk memanggil "fstrim" baik sebagai ganti, atau setelah
memanggil "ruang bebas-nol".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

dapatkan-tambahkan
dapatkan-tambahkan

Kembalikan opsi kernel tambahan yang ditambahkan ke kernel alat libguestfs
garis komando.

Jika "NULL" maka tidak ada opsi yang ditambahkan.

dapatkan-lampirkan-metode
dapatkan-lampirkan-metode

Kembalikan backend saat ini.

Lihat "set-backend" dan "BACKEND" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "get-backend".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

dapatkan-sinkronisasi otomatis
dapatkan-sinkronisasi otomatis

Dapatkan tanda sinkronisasi otomatis.

dapatkan-backend
dapatkan-backend

Kembalikan backend saat ini.

Properti handle ini sebelumnya disebut "attach method".

Lihat "set-backend" dan "BACKEND" di tamu(3).

dapatkan-backend-pengaturan
nama pengaturan get-backend

Temukan string pengaturan backend yang berupa "nama" atau dimulai dengan "nama=". Jika "nama",
ini mengembalikan string "1". Jika "name=", ini mengembalikan bagian setelah tanda sama dengan
(yang mungkin berupa string kosong).

Jika tidak ada pengaturan seperti itu yang ditemukan, fungsi ini akan memunculkan kesalahan. Errno (lihat "terakhir-errno")
akan menjadi "ESRCH" dalam kasus ini.

Lihat "BACKEND" di tamu(3), "SETTING BACKEND" di tamu(3).

dapatkan-backend-pengaturan
dapatkan-backend-pengaturan

Kembalikan pengaturan backend saat ini.

Panggilan ini mengembalikan semua string pengaturan backend. Jika Anda ingin menemukan satu backend
pengaturan, lihat "pengaturan get-backend".

Lihat "BACKEND" di tamu(3), "SETTING BACKEND" di tamu(3).

dapatkan-cachedir
dapatkan-cachedir

Dapatkan direktori yang digunakan oleh pegangan untuk menyimpan cache alat.

langsung
langsung

Kembalikan tanda mode peralatan langsung.

dapatkan-e2attrs
file get-e2attrs

Ini mengembalikan atribut file yang terkait dengan fillet.

Atribut adalah satu set bit yang terkait dengan setiap inode yang mempengaruhi perilaku
berkas. Atribut dikembalikan sebagai string huruf (dijelaskan di bawah). Itu
string mungkin kosong, menunjukkan bahwa tidak ada atribut file yang disetel untuk file ini.

Atribut-atribut ini hanya ada ketika file berada di sistem file ext2/3/4.
Menggunakan panggilan ini pada jenis sistem file lain akan menghasilkan kesalahan.

Karakter (atribut file) dalam string yang dikembalikan saat ini adalah:

'A' Ketika file diakses, waktunya tidak diubah.

'a' File hanya-tambahkan.

'c' File dikompresi pada disk.

'D' (Direktori saja.) Perubahan ke direktori ini ditulis secara sinkron ke disk.

'd' File bukan kandidat untuk cadangan (lihat membuang(8)).

'E' File memiliki kesalahan kompresi.

'e' File menggunakan ekstensi.

'h' File menyimpan bloknya dalam satuan ukuran blok sistem file, bukan
sektor.

'I' (Direktori saja.) Direktori menggunakan pohon hash.

'i' File tidak dapat diubah. Itu tidak dapat diubah, dihapus atau diganti namanya. Tidak ada tautan yang bisa
dibuat ke file ini.

'j' File adalah jurnal data.

's' Saat file dihapus, semua bloknya akan di-nolkan.

'S' Perubahan pada file ini ditulis secara sinkron ke disk.

'T' (Hanya direktori.) Ini adalah petunjuk untuk pengalokasi blok bahwa subdirektori
terkandung dalam direktori ini harus tersebar di seluruh blok. Jika tidak ada, blok
pengalokasi akan mencoba mengelompokkan subdirektori bersama.

't' Untuk file, ini menonaktifkan penggabungan ekor. (Tidak digunakan oleh implementasi hulu dari
ext2.)

'u' Ketika file dihapus, blok-bloknya akan disimpan, memungkinkan file tidak terhapus.

'X' Isi mentah dari file terkompresi dapat diakses.

'Z' File terkompresi kotor.

Atribut file lainnya dapat ditambahkan ke daftar ini nanti. Tidak semua atribut file dapat disetel
untuk semua jenis file. Untuk informasi rinci, konsultasikan dengan obrolan(1) halaman manual.

Lihat juga "set-e2attrs".

Jangan bingung atribut ini dengan atribut yang diperluas (lihat "getxattr").

dapatkan-e2generasi
file get-e2generation

Ini mengembalikan pembuatan file ext2 dari sebuah file. Generasi (yang dulu disebut
"versi") adalah nomor yang terkait dengan sebuah inode. Ini paling sering digunakan oleh NFS
Server.

Generasi hanya ada ketika file berada di sistem file ext2/3/4. Menggunakan
panggilan ini pada jenis sistem file lain akan menghasilkan kesalahan.

Lihat "set-e2generation".

dapatkan-e2label
perangkat get-e2label

Ini mengembalikan label sistem file ext2/3/4 dari sistem file pada "perangkat".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "vfs-label".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

dapatkan-e2uuid
perangkat get-e2uuid

Ini mengembalikan UUID sistem file ext2/3/4 dari sistem file pada "perangkat".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "vfs-uuid".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

dapatkan-hv
dapatkan-hv

Kembalikan biner hypervisor saat ini.

Ini selalu non-NULL. Jika belum disetel, maka ini akan mengembalikan qemu . default
nama biner.

dapatkan pengenal
dapatkan pengenal

Dapatkan pengidentifikasi pegangan. Lihat "pengidentifikasi set".

dapatkan-libvirt-requested-credential-challenge
indeks get-libvirt-requested-credential-challenge

Dapatkan tantangan (disediakan oleh libvirt) untuk kredensial "indeks" yang diminta. Jika
libvirt tidak memberikan tantangan, ini mengembalikan string kosong "".

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

dapatkan-libvirt-diminta-kredensial-defresult
get-libvirt-requested-credential-defresult indeks

Dapatkan hasil default (disediakan oleh libvirt) untuk kredensial yang diminta "indeks". Jika
libvirt tidak memberikan hasil default, ini mengembalikan string kosong "".

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

dapatkan-libvirt-diminta-kredensial-Prompt
get-libvirt-requested-credential-Prompt indeks

Dapatkan prompt (disediakan oleh libvirt) untuk kredensial yang diminta "indeks". Jika libvirt
tidak memberikan Prompt, ini mengembalikan string kosong "".

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

dapatkan-libvirt-diminta-kredensial
dapatkan-libvirt-diminta-kredensial

Ini seharusnya hanya dipanggil selama panggilan balik acara untuk acara jenis
"GUESTFS_EVENT_LIBVIRT_AUTH".

Kembalikan daftar kredensial yang diminta oleh libvirt. Nilai yang mungkin adalah subset dari
string yang disediakan saat Anda memanggil "set-libvirt-supported-credentials".

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

dapatkan-memsize
dapatkan-memsize

Ini mendapatkan ukuran memori dalam megabyte yang dialokasikan ke hypervisor.

Jika "set-memsize" tidak dipanggil pada pegangan ini, dan jika "LIBGUESTFS_MEMSIZE" tidak disetel,
maka ini mengembalikan nilai default yang dikompilasi untuk memsize.

Untuk informasi lebih lanjut tentang arsitektur libguestfs, lihat tamu(3).

dapatkan-jaringan
dapatkan-jaringan

Ini mengembalikan bendera jaringan aktifkan.

mendapatkan-jalan
mendapatkan-jalan

Kembalikan jalur pencarian saat ini.

Ini selalu non-NULL. Jika belum disetel, maka ini akan mengembalikan default
jalan.

dapatkan-pgroup
dapatkan-pgroup

Ini mengembalikan bendera grup proses.

dapatkan-pid
pid
dapatkan-pid

Kembalikan ID proses hypervisor. Jika tidak ada hypervisor yang berjalan, maka ini
akan mengembalikan kesalahan.

Ini adalah panggilan internal yang digunakan untuk debugging dan pengujian.

dapatkan-program
dapatkan-program

Dapatkan nama programnya. Lihat "program-set".

dapatkan-qemu
dapatkan-qemu

Kembalikan biner hypervisor saat ini (biasanya qemu).

Ini selalu non-NULL. Jika belum disetel, maka ini akan mengembalikan qemu . default
nama biner.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "get-hv".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

dapatkan-pemulihan-proc
dapatkan-pemulihan-proc

Kembalikan bendera yang diaktifkan proses pemulihan.

dapatkan-selinux
dapatkan-selinux

Ini mengembalikan pengaturan flag selinux saat ini yang diteruskan ke alat di
waktu booting. Lihat "set-selinux".

Untuk informasi lebih lanjut tentang arsitektur libguestfs, lihat tamu(3).

dapatkan-smp
dapatkan-smp

Ini mengembalikan jumlah CPU virtual yang ditetapkan ke alat.

dapatkan-tmpdir
dapatkan-tmpdir

Dapatkan direktori yang digunakan oleh pegangan untuk menyimpan file-file sementara.

dapatkan-jejak
dapatkan-jejak

Kembalikan tanda jejak perintah.

dapatkan-umask
dapatkan-umask

Kembalikan umask saat ini. Secara default umask adalah 022 kecuali telah disetel dengan memanggil
"umas".

bertele-tele
bertele-tele

Ini mengembalikan bendera pesan verbose.

dapatkancon
dapatkancon

Ini mendapatkan konteks keamanan SELinux dari daemon.

Lihat dokumentasi tentang SELINUX di tamu(3), dan "setcon"

getxattr
getxattr nama jalur

Dapatkan satu atribut tambahan dari file "path" bernama "name". Panggilan ini mengikuti
symlink. Jika Anda ingin mencari atribut yang diperluas untuk symlink itu sendiri, gunakan
"lgetxattr".

Biasanya lebih baik untuk mendapatkan semua atribut yang diperluas dari file sekaligus dengan menelepon
"getxattr". Namun beberapa implementasi sistem file Linux bermasalah dan tidak menyediakan
cara untuk membuat daftar atribut. Untuk sistem file ini (terutama ntfs-3g), Anda harus mengetahui:
nama atribut yang diperluas yang Anda inginkan sebelumnya dan panggil fungsi ini.

Nilai atribut yang diperluas adalah gumpalan data biner. Jika tidak ada atribut yang diperluas
bernama "nama", ini mengembalikan kesalahan.

Lihat juga: "getxattrs", "lgetxattr", attr(5).

getxattrs
jalur getxattrs

Panggilan ini mencantumkan atribut yang diperluas dari "jalur" file atau direktori.

Pada tingkat panggilan sistem, ini adalah kombinasi dari daftarxattr(2) dan getxattr(2) panggilan.

Lihat juga: "lgetxattrs", attr(5).

memperluas glob
pola glob-expand

Perintah ini mencari semua nama path yang cocok dengan "pola" menurut wildcard
aturan ekspansi yang digunakan oleh shell.

Jika tidak ada jalur yang cocok, maka ini mengembalikan daftar kosong (catatan: bukan kesalahan).

Itu hanya pembungkus di sekitar C bola(3) berfungsi dengan tanda "GLOB_MARK|GLOB_BRACE". Melihat
halaman manual itu untuk lebih jelasnya.

Perhatikan bahwa tidak ada perintah yang setara untuk memperluas nama perangkat (mis. /dev/sd*).
Gunakan fungsi "daftar-perangkat", "daftar-partisi" dll.

grep
grep-opts
grep jalur regex [diperpanjang: benar|salah] [diperbaiki: benar|salah] [tidak peka: benar|salah] [dikompresi:benar|salah]

Ini memanggil program "grep" eksternal dan mengembalikan baris yang cocok.

Bendera opsional adalah:

"diperpanjang"
Gunakan ekspresi reguler yang diperluas. Ini sama dengan menggunakan -E bendera.

"tetap"
Kecocokan tetap (jangan gunakan ekspresi reguler). Ini sama dengan menggunakan -F bendera.

"tidak peka"
Cocokkan peka huruf besar/kecil. Ini sama dengan menggunakan -i bendera.

"terkompresi"
Gunakan "zgrep" alih-alih "grep". Ini memungkinkan input menjadi kompres- atau gzip-
dikompresi.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

grpi
jalur regex grepi

Ini memanggil program "grep -i" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

grub-instal
grub-instal perangkat root

Perintah ini menginstal GRUB 1 (Grand Unified Bootloader) di "perangkat", dengan root
direktori menjadi "root".

Catatan:

· Saat ini tidak ada cara di API untuk menginstal grub2, yang digunakan oleh kebanyakan orang modern
tamu Linux. Dimungkinkan untuk menjalankan perintah grub2 dari tamu, meskipun lihat
peringatan di "MENJALANKAN PERINTAH" di tamu(3).

· Ini menggunakan "grub-install" dari host. Sayangnya grub tidak selalu kompatibel
dengan dirinya sendiri, jadi ini hanya berfungsi dalam keadaan yang agak sempit. Pengujian hati-hati dengan
setiap versi tamu disarankan.

· Jika grub-install melaporkan kesalahan "Tidak ada drive yang sesuai ditemukan di perangkat yang dihasilkan
peta." mungkin Anda perlu membuat /boot/grub/device.map ajukan dulu itu
berisi pemetaan antara nama perangkat grub dan nama perangkat Linux. Biasanya
cukup untuk membuat file yang berisi:

(hd0) /dev/vda

Mengganti / dev / vda dengan nama perangkat instalasi.

kepala
jalan utama

Perintah ini mengembalikan hingga 10 baris pertama file sebagai daftar string.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

kepala-n
jalur head-n nrlines

Jika parameter "nrlines" adalah angka positif, ini mengembalikan baris "nrlines" pertama dari
file "jalan".

Jika parameter "nrlines" adalah angka negatif, ini mengembalikan baris dari file "path",
tidak termasuk baris "nrlines" terakhir.

Jika parameter "nrlines" adalah nol, ini mengembalikan daftar kosong.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

hexdump
jalur hexdump

Ini menjalankan "hexdump -C" pada "jalur" yang diberikan. Hasilnya adalah kanonik yang dapat dibaca manusia
hex dump dari file.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

hivex-tutup
hivex-tutup

Tutup pegangan hivex saat ini.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-komit
nama file komit hivex

Komit (tulis) perubahan ke sarang.

Jika opsional nama file parameternya nol, maka perubahannya ditulis kembali ke yang sama
sarang yang dibuka. Jika ini bukan null maka mereka ditulis ke nama file alternatif
diberikan dan sarang asli dibiarkan tak tersentuh.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-tambah-anak
hivex-node-add-anak nama orang tua

Tambahkan simpul anak ke "induk" bernama "nama".

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-anak-anak
hivex-node-anak nodeh

Kembalikan daftar node yang merupakan subkunci dari "nodeh".

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-hapus-anak
hivex-node-hapus-anak nodeh

Hapus "nodeh", secara rekursif jika perlu.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-simpul-dapatkan-anak
hivex-node-get-child nodeh nama

Kembalikan anak "nodeh" dengan nama "nama", jika ada. Ini dapat mengembalikan 0 arti
namanya tidak ditemukan.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-dapatkan-nilai
kunci simpul hivex-node-get-value

Kembalikan nilai yang dilampirkan ke "nodeh" yang memiliki nama "kunci", jika ada. Ini bisa
return 0 artinya kunci tidak ditemukan.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-nama
hivex-simpul-nama nodeh

Kembalikan nama "nodeh".

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-orang tua
nodeh-simpul-induk hivex

Kembalikan simpul induk dari "nodeh".

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-set-nilai
hivex-node-set-value kunci simpul t val

Tetapkan atau ganti satu nilai di bawah simpul "nodeh". "Kunci" adalah nama, "t" adalah
ketik, dan "val" adalah datanya.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex-node-nilai
hivex-node-values nodeh

Kembalikan larik tupel (kunci, tipe data, data) yang dilampirkan ke "nodeh".

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

hivex terbuka
hivex-buka nama file [verbose:true|false] [debug:true|false] [tulis:true|false]

Buka file kumpulan Windows Registry bernama nama file. Jika ada hivex sebelumnya
handle yang terkait dengan sesi guestfs ini, lalu ditutup.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

hivex-root
hivex-root

Kembalikan simpul akar sarang.

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

kunci-nilai-hivex
nilai kunci-nilai hivexh

Kembalikan bidang kunci (nama) dari tupel (kunci, tipe data, data).

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

tipe nilai hivex
nilai tipe nilai hivexh

Kembalikan bidang tipe data dari tupel (kunci, tipe data, data).

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

nilai-hivex-utf8
nilai hivex-utf8 nilai

Ini memanggil "nilai-nilai-hivex" (yang mengembalikan bidang data dari tupel nilai hivex).
Kemudian diasumsikan bahwa bidang tersebut adalah string UTF-16LE dan mengonversi hasilnya menjadi UTF-8 (atau
jika ini tidak memungkinkan, ia mengembalikan kesalahan).

Ini berguna untuk membaca string dari registri Windows. Namun tidak
sangat mudah karena registri tidak diketik dengan kuat dan bidang dapat berisi arbitrer atau
data yang tidak terduga.

hivex-nilai-nilai
hivex-nilai-nilai-nilaih

Mengembalikan bidang data dari tupel (kunci, tipe data, data).

Ini adalah pembungkus di sekitar sarang lebah(3) panggilan dengan nama yang sama.

Lihat juga: "hivex-nilai-utf8".

initrd-kucing
initrd-cat nama file initrdpath

Perintah ini membongkar file nama file dari file initrd bernama initrdpath. itu
nama file harus diberikan tanpa awal / karakter.

Misalnya, di guestfish Anda dapat menggunakan perintah berikut untuk memeriksa skrip boot
(biasa dipanggil / init) yang terdapat dalam gambar initrd atau initramfs Linux:

initrd-cat /boot/initrd- .img init

Lihat juga "initrd-list".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

daftar initrd
jalur initrd-list

Perintah ini mencantumkan file yang terdapat dalam initrd.

File terdaftar tanpa inisial apa pun / karakter. File tercantum dalam urutan
mereka muncul (tidak harus abjad). Nama direktori terdaftar sebagai item terpisah.

Kernel Linux lama (2.4 dan sebelumnya) menggunakan sistem file ext2 terkompresi sebagai initrd. Kami hanya
mendukung format initramfs yang lebih baru (file cpio terkompresi).

beri tahu-tambah-jam tangan
masker jalur inotify-add-watch

Perhatikan "jalur" untuk acara yang tercantum di "topeng".

Perhatikan bahwa jika "jalur" adalah direktori, maka acara di dalam direktori itu akan ditonton, tetapi ini
tidak tidak terjadi secara rekursif (dalam subdirektori).

Catatan untuk penelepon non-C atau non-Linux: event inotify ditentukan oleh kernel Linux
ABI dan terdaftar di /usr/include/sys/notify.h.

inotifikasi-tutup
inotifikasi-tutup

Ini menutup pegangan inotify yang sebelumnya dibuka oleh inotify_init. Ini menghilangkan
semua jam tangan, membuang acara yang tertunda, dan membatalkan alokasi semua sumber daya.

file inotify
file inotify

Fungsi ini adalah pembungkus yang berguna di sekitar "notify-read" yang baru saja mengembalikan daftar
nama jalur objek yang disentuh. Nama path yang dikembalikan diurutkan dan
digandakan.

beri tahu-init
inotify-init maxevents

Perintah ini membuat pegangan inotify baru. Subsistem inotify dapat digunakan untuk memberi tahu
peristiwa yang terjadi pada objek di sistem file tamu.

"maxevents" adalah jumlah maksimum acara yang akan diantrekan di antara panggilan ke
"notify-read" atau "notify-files". Jika ini dilewatkan sebagai 0, maka kernel (atau sebelumnya
set) default digunakan. Untuk Linux 2.6.29 defaultnya adalah 16384 peristiwa. Di luar batas ini,
kernel membuang peristiwa, tetapi mencatat fakta bahwa ia membuangnya dengan menyetel a
tandai "IN_Q_OVERFLOW" di daftar struktur yang dikembalikan (lihat "notify-read").

Sebelum acara apa pun dibuat, Anda harus menambahkan beberapa jam tangan ke daftar tontonan internal.
Lihat: "notify-add-watch" dan "notify-rm-watch".

Acara yang diantrekan harus dibaca secara berkala dengan memanggil "notify-read" (atau "notify-files"
yang hanya merupakan pembungkus yang membantu di sekitar "notify-read"). Jika Anda tidak membaca acaranya
cukup sering maka Anda berisiko antrian internal meluap.

Pegangan harus ditutup setelah digunakan dengan memanggil "notify-close". Ini juga menghapus semua
jam tangan secara otomatis.

Lihat juga batalkan(7) untuk ikhtisar antarmuka inotify seperti yang diekspos oleh Linux
kernel, yang kira-kira seperti yang kami paparkan melalui libguestfs. Perhatikan bahwa ada satu global
inotify handle per instance libguestfs.

inotify-baca
inotify-baca

Kembalikan antrean lengkap peristiwa yang telah terjadi sejak panggilan baca sebelumnya.

Jika tidak ada peristiwa yang terjadi, ini mengembalikan daftar kosong.

Note: Untuk memastikan bahwa semua acara telah dibaca, Anda harus memanggil fungsi ini
berulang kali sampai mengembalikan daftar kosong. Alasannya adalah panggilan itu akan membaca acara
hingga ukuran pesan alat-ke-host maksimum dan meninggalkan acara yang tersisa dalam antrian.

beri tahu-rm-watch
beri tahu-rm-watch wd

Hapus jam tangan inotify yang ditentukan sebelumnya. Lihat "notify-add-watch".

periksa-dapatkan-lengkungan
inspeksi-get-arch root

Ini mengembalikan arsitektur sistem operasi yang diperiksa. Kemungkinan pengembalian
nilai terdaftar di bawah "arsitektur file".

Jika arsitektur tidak dapat ditentukan, maka string "tidak diketahui" dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-get-distro
periksa-get-distro root

Ini mengembalikan distro (distribusi) dari sistem operasi yang diperiksa.

Distro yang didefinisikan saat ini adalah:

"alpinelinux"
Linux Alpen.

"altlinux"
ALT Linux.

"archlinux"
Linux Arch.

"buildroot"
Distro yang diturunkan dari buildroot, tetapi bukan yang kami kenali secara khusus.

"sento"
CentOS

"sirros"
Cirro.

"coreo"
CoreOS.

"debian"
Debian.

"fedora"
fedora.

"freebsd"
GratisBSD.

"kebebasan"
DOS gratis.

"peralatan hemat"
Barang-barang hemat.

"gentoo"
Gentoo.

"linuxmint"
Linux Mint.

"maggia"
Magia.

"mandriva"
Mandriva.

"meego"
MeeGo.

"netbsd"
NetBSD.

"openbsd"
BukaBSD.

"penggunaan terbuka"
BukaSUSE.

"oraclelinux"
OracleLinux.

"pardus"
Pardus.

"pldlinux"
PL Linux.

"berbasis redhat"
Beberapa distro turunan Red Hat.

"rhel"
RedHat Enterprise Linux.

"linux ilmiah"
Linux ilmiah.

"slackware"
slackware.

"sles"
SuSE Linux Enterprise Server atau Desktop.

"berbasis penggunaan"
Beberapa distro turunan openSuSE.

"ttylinux"
ttylinux.

"ubuntu"
Ubuntu

"tidak dikenal"
Distro tidak dapat ditentukan.

"jendela"
Windows tidak memiliki distribusi. String ini dikembalikan jika tipe OS-nya adalah
Windows.

Versi libguestfs yang akan datang dapat mengembalikan string lain di sini. Peneleponnya harus
siap untuk menangani string apapun.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

inspeksi-get-drive-pemetaan
periksa-get-drive-pemetaan root

Panggilan ini berguna untuk Windows yang menggunakan sistem primitif dalam menetapkan huruf drive
(seperti C: \) ke partisi. API inspeksi ini memeriksa Windows Registry untuk mengetahui
bagaimana disk/partisi dipetakan ke huruf drive, dan mengembalikan tabel hash seperti di
contoh di bawah ini:

C => /dev/vda2
E => /dev/vdb1
F => /dev/vdc1

Perhatikan bahwa kunci adalah huruf drive. Untuk Windows, kuncinya tidak peka huruf besar-kecil dan adil
berisi huruf drive, tanpa karakter pemisah titik dua biasa.

Di masa mendatang kami mungkin mendukung sistem operasi lain yang juga menggunakan huruf drive, tetapi
kunci untuk itu mungkin tidak peka huruf besar-kecil dan mungkin lebih panjang dari 1 karakter. Untuk
contoh di OS-9, hard drive diberi nama "h0", "h1" dll.

Untuk tamu Windows, saat ini hanya pemetaan hard drive yang dikembalikan. Disk yang dapat dilepas (mis.
DVD-ROM) diabaikan.

Untuk tamu yang tidak menggunakan pemetaan drive, atau jika pemetaan drive tidak dapat
ditentukan, ini mengembalikan tabel hash kosong.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya. Lihat juga "inspeksi-dapatkan-
mountpoints", "inspect-get-filesystems".

periksa-get-filesystem
inspeksi-get-filesystem root

Ini mengembalikan daftar semua sistem file yang menurut kami terkait dengan ini
sistem operasi. Ini termasuk sistem file root, sistem file biasa lainnya, dan non-
perangkat yang dipasang seperti partisi swap.

Dalam kasus mesin virtual multi-boot, sistem file dimungkinkan untuk dibagikan
antar sistem operasi.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya. Lihat juga "inspeksi-dapatkan-
titik mount".

periksa-dapatkan-format
periksa-get-format root

Ini mengembalikan format sistem operasi yang diperiksa. Anda dapat menggunakannya untuk mendeteksi
instal gambar, live CD, dan sejenisnya.

Format yang ditentukan saat ini adalah:

"terpasang"
Ini adalah sistem operasi yang diinstal.

"pemasang"
Gambar disk yang diperiksa bukanlah sistem operasi yang diinstal, tetapi a dapat di-boot
instal disk, live CD, atau sejenisnya.

"tidak dikenal"
Format gambar disk ini tidak diketahui.

Versi libguestfs yang akan datang dapat mengembalikan string lain di sini. Peneleponnya harus
siap untuk menangani string apapun.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-get-hostname
periksa-get-hostname root

Fungsi ini mengembalikan nama host dari sistem operasi seperti yang ditemukan dengan inspeksi dari
file konfigurasi tamu.

Jika nama host tidak dapat ditentukan, maka string "tidak diketahui" dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapat-ikon
inspeksi-get-ikon root [favicon:true|false] [highquality:true|false]

Fungsi ini mengembalikan ikon yang sesuai dengan sistem operasi yang diperiksa. Ikon
dikembalikan sebagai buffer yang berisi gambar PNG (dikodekan ulang ke PNG jika perlu).

Jika tidak mungkin mendapatkan ikon, fungsi ini mengembalikan panjang nol (non-NULL)
penyangga. Penelepon harus memeriksa untuk ini kasus.

Libguestfs akan mulai dengan mencari file bernama /etc/favicon.png or C:\etc\favicon.png
dan jika memiliki format yang benar, isi file ini akan dikembalikan. Kamu bisa
nonaktifkan favicons dengan melewatkan boolean "favicon" opsional sebagai false (default adalah true).

Jika menemukan favicon gagal, maka kami mencari di tempat lain di tamu untuk yang cocok
icon.

Jika boolean "kualitas tinggi" opsional benar, maka hanya ikon berkualitas tinggi yang dikembalikan,
yang berarti hanya ikon resolusi tinggi dengan saluran alfa. Standarnya (salah) adalah
untuk mengembalikan ikon apa pun yang kami bisa, meskipun kualitasnya di bawah standar.

Catatan:

· Tidak seperti kebanyakan panggilan API inspeksi lainnya, disk tamu harus dipasang terlebih dahulu
Anda menyebutnya ini, karena perlu membaca informasi dari sistem file tamu selama
panggilan.

· Keamanan: Data ikon berasal dari tamu yang tidak dipercaya, dan harus diperlakukan dengan
peringatan. File PNG diketahui mengandung eksploitasi. Pastikan bahwa libpng (atau lainnya
perpustakaan yang relevan) sepenuhnya mutakhir sebelum mencoba memproses atau menampilkan ikon.

· Gambar PNG yang dikembalikan dapat dalam berbagai ukuran. Mungkin tidak persegi. Libguestfs mencoba untuk
mengembalikan ikon terbesar, kualitas tertinggi yang tersedia. Aplikasi harus menskalakan
ikon ke ukuran yang diinginkan.

· Mengekstrak ikon dari tamu Windows memerlukan program "wrestool" eksternal dari
paket "icoutils", dan beberapa program ("bmptopnm", "pnmtopng", "pamcut") dari
paket "netpbm". Ini harus dipasang secara terpisah.

· Ikon sistem operasi biasanya merupakan merek dagang. Carilah nasihat hukum sebelum menggunakan
merek dagang dalam aplikasi.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

periksa-get-mayor-versi
periksa-get-versi-utama root

Ini mengembalikan nomor versi utama dari sistem operasi yang diperiksa.

Windows menggunakan skema versi yang konsisten yaitu tidak tercermin dalam masyarakat populer
nama yang digunakan oleh sistem operasi. Terutama sistem operasi yang dikenal sebagai "Windows 7" adalah
benar-benar versi 6.1 (mis. mayor = 6, minor = 1). Anda dapat mengetahui versi aslinya
sesuai dengan rilis Windows dengan berkonsultasi dengan Wikipedia atau MSDN.

Jika versi tidak dapat ditentukan, maka 0 dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapatkan-versi-kecil
periksa-dapatkan-versi minor root

Ini mengembalikan nomor versi minor dari sistem operasi yang diperiksa.

Jika versi tidak dapat ditentukan, maka 0 dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya. Lihat juga "inspect-get-major-
Versi: kapan".

periksa-dapatkan-mountpoints
inspeksi-get-mountpoints root

Ini mengembalikan hash di mana kami pikir sistem file yang terkait dengan operasi ini
sistem harus dipasang. Penelepon harus mencatat bahwa ini adalah tebakan terbaik yang dibuat
dengan membaca file konfigurasi seperti / etc / fstab. In tertentu mencatat bahwa ini mungkin
mengembalikan sistem file yang tidak ada atau tidak dapat dipasang dan penelepon harus disiapkan
untuk menangani atau mengabaikan kegagalan jika mereka mencoba memasangnya.

Setiap elemen dalam hashtable yang dikembalikan memiliki kunci yang merupakan jalur mountpoint (mis.
/ boot) dan nilai yang merupakan sistem file yang akan dipasang di sana (mis. / Dev / sda1).

Perangkat yang tidak dipasang seperti perangkat swap adalah tidak dikembalikan dalam daftar ini.

Untuk sistem operasi seperti Windows yang masih menggunakan huruf drive, panggilan ini hanya akan
kembalikan entri untuk drive pertama "dipasang" /. Untuk informasi tentang pemetaan
huruf drive ke partisi, lihat "inspect-get-drive-mappings".

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya. Lihat juga "inspeksi-dapatkan-
sistem file".

periksa-dapatkan-paket-format
inspeksi-get-paket-format root

Fungsi ini dan "inspect-get-package-management" mengembalikan format dan paket paket
alat manajemen yang digunakan oleh sistem operasi yang diperiksa. Misalnya untuk Fedora ini
fungsi akan mengembalikan "rpm" (format paket), dan "yum" atau "dnf" (manajemen paket).

Ini mengembalikan string "tidak diketahui" jika kami tidak dapat menentukan format paket or jika
sistem operasi tidak memiliki sistem pengemasan nyata (mis. Windows).

Kemungkinan string termasuk: "rpm", "deb", "ebuild", "pisi", "pacman", "pkgsrc", "apk".
Versi libguestfs yang akan datang dapat mengembalikan string lain.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapatkan-paket-manajemen
periksa-dapatkan-paket-manajemen root

"inspect-get-package-format" dan fungsi ini mengembalikan format dan paket paket
alat manajemen yang digunakan oleh sistem operasi yang diperiksa. Misalnya untuk Fedora ini
fungsi akan mengembalikan "rpm" (format paket), dan "yum" atau "dnf" (manajemen paket).

Ini mengembalikan string "tidak diketahui" jika kami tidak dapat menentukan alat manajemen paket or
jika sistem operasi tidak memiliki sistem pengemasan nyata (mis. Windows).

Kemungkinan string termasuk: "yum", "dnf", "up2date", "apt" (untuk semua turunan Debian),
"portage", "pisi", "pacman", "urpmi", "zypper", "apk". Versi libguestfs yang akan datang mungkin
mengembalikan string lainnya.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapatkan-nama-produk
periksa-dapatkan-produk-nama root

Ini mengembalikan nama produk dari sistem operasi yang diperiksa. Nama produk adalah
umumnya beberapa string bentuk bebas yang dapat ditampilkan kepada pengguna, tetapi tidak boleh
diuraikan oleh program.

Jika nama produk tidak dapat ditentukan, maka string "tidak diketahui" dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapatkan-produk-varian
periksa-dapatkan-produk-varian root

Ini mengembalikan varian produk dari sistem operasi yang diperiksa.

Untuk tamu Windows, ini mengembalikan konten kunci Registri
"HKLM\Software\Microsoft\Windows NT\CurrentVersion" "InstallationType" yang biasanya merupakan
string seperti "Klien" atau "Server" (nilai lain dimungkinkan). Ini dapat digunakan untuk
membedakan versi konsumen dan perusahaan Windows yang memiliki nomor versi yang sama
(misalnya, Windows 7 dan Windows 2008 Server keduanya versi 6.1, tetapi yang pertama adalah
"Klien" dan yang terakhir adalah "Server").

Untuk tamu Linux perusahaan, di masa depan kami bermaksud untuk mengembalikan varian produk seperti:
sebagai "Desktop", "Server" dan seterusnya. Tapi ini tidak diterapkan saat ini.

Jika varian produk tidak dapat ditentukan, maka string "tidak diketahui" dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya. Lihat juga "inspeksi-dapatkan-produk-
name", "inspect-get-major-version".

periksa-get-roots
periksa-get-roots

Fungsi ini adalah cara mudah untuk mendapatkan daftar perangkat root, seperti yang dikembalikan dari a
panggilan sebelumnya ke "inspect-os", tetapi tanpa mengulang seluruh proses inspeksi.

Ini mengembalikan daftar kosong jika tidak ada perangkat root yang ditemukan atau pemanggil belum
disebut "inspeksi-os".

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-dapatkan-tipe
periksa-dapatkan-jenis root

Ini mengembalikan jenis sistem operasi yang diperiksa. Jenis yang ditentukan saat ini adalah:

"linux"
Setiap sistem operasi berbasis Linux.

"jendela"
Setiap sistem operasi Microsoft Windows.

"freebsd"
GratisBSD.

"netbsd"
NetBSD.

"openbsd"
BukaBSD.

"keras"
GNU/Hurd.

"dos"
MS-DOS, FreeDOS dan lain-lain.

"minix"
MINIX.

"tidak dikenal"
Jenis sistem operasi tidak dapat ditentukan.

Versi libguestfs yang akan datang dapat mengembalikan string lain di sini. Peneleponnya harus
siap untuk menangani string apapun.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-get-windows-current-control-set
inspeksi-get-windows-current-control-set root

Ini mengembalikan Windows CurrentControlSet dari tamu yang diperiksa. Set Kontrol Saat Ini
adalah nama kunci registri seperti "ControlSet001".

Panggilan ini mengasumsikan bahwa tamu adalah Windows dan Registry dapat diperiksa oleh
inspeksi. Jika hal ini tidak terjadi maka kesalahan dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-get-windows-systemroot
periksa-get-windows-systemroot root

Ini mengembalikan systemroot Windows dari tamu yang diperiksa. Systemroot adalah direktori
jalan seperti /JENDELA.

Panggilan ini mengasumsikan bahwa tamu adalah Windows dan root sistem dapat ditentukan oleh:
inspeksi. Jika hal ini tidak terjadi maka kesalahan dikembalikan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-is-live
periksa-is-live root

Jika "inspect-get-format" mengembalikan "installer" (ini adalah disk instalasi), maka ini mengembalikan
benar jika gambar hidup terdeteksi pada disk.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-adalah-multipart
periksa-adalah-multipart root

Jika "inspect-get-format" mengembalikan "installer" (ini adalah disk instalasi), maka ini mengembalikan
benar jika disk adalah bagian dari satu set.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-adalah-netinst
periksa-adalah-netinst root

Jika "inspect-get-format" mengembalikan "installer" (ini adalah disk instalasi), maka ini mengembalikan
benar jika disk adalah penginstal jaringan, mis. bukan CD instalasi mandiri tetapi CD yang
kemungkinan memerlukan akses jaringan untuk menyelesaikan penginstalan.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

periksa-daftar-aplikasi
periksa-daftar-aplikasi root

Kembalikan daftar aplikasi yang terinstal di sistem operasi.

Catatan: Panggilan ini bekerja secara berbeda dari bagian lain dari API inspeksi. Kamu harus
panggil "inspect-os", lalu "inspect-get-mountpoints", lalu pasang disk, sebelum menelepon
ini. Mendaftar aplikasi adalah operasi yang jauh lebih sulit yang membutuhkan
akses ke sistem file lengkap. Perhatikan juga bahwa tidak seperti panggilan "inspect-get-*" lainnya
yang baru saja mengembalikan data yang di-cache di pegangan libguestfs, panggilan ini sebenarnya berbunyi
bagian dari sistem file yang dipasang selama panggilan.

Ini mengembalikan daftar kosong jika kode inspeksi tidak dapat menentukan daftar
aplikasi.

Struktur aplikasi berisi bidang-bidang berikut:

"nama aplikasi"
Nama aplikasi. Untuk tamu Linux yang diturunkan dari Red Hat dan Debian,
ini nama paketnya

"nama_tampilan_aplikasi"
Nama tampilan aplikasi, terkadang dilokalkan ke bahasa penginstalan
sistem operasi tamu.

Jika tidak tersedia ini dikembalikan sebagai string kosong "". Penelepon perlu menampilkan
sesuatu dapat menggunakan "app_name" sebagai gantinya.

"app_epoch"
Untuk manajer paket yang menggunakan epoch, ini berisi epoch dari paket (dan
bilangan bulat). Jika tidak tersedia, ini dikembalikan sebagai 0.

"versi_aplikasi"
String versi dari aplikasi atau paket. Jika tidak tersedia ini dikembalikan sebagai
string kosong "".

"aplikasi_rilis"
String rilis aplikasi atau paket, untuk manajer paket yang menggunakan ini.
Jika tidak tersedia ini dikembalikan sebagai string kosong "".

"app_install_path"
Jalur penginstalan aplikasi (pada sistem operasi seperti Windows yang
menggunakan jalur instalasi). Jalur ini dalam format yang digunakan oleh tamu yang beroperasi
sistem, ini bukan jalur libguestfs.

Jika tidak tersedia ini dikembalikan sebagai string kosong "".

"app_trans_path"
Jalur instal diterjemahkan ke dalam jalur libguestfs. Jika tidak tersedia ini dikembalikan
sebagai string kosong "".

"penerbit_aplikasi"
Nama penerbit aplikasi, untuk pengelola paket yang menggunakan ini. Jika
tidak tersedia ini dikembalikan sebagai string kosong "".

"app_url"
URL (mis. URL upstream) aplikasi. Jika tidak tersedia ini dikembalikan sebagai
string kosong "".

"paket_sumber_aplikasi"
Untuk sistem pengemasan yang mendukung ini, nama paket sumber. Jika
tidak tersedia ini dikembalikan sebagai string kosong "".

"ringkasan_aplikasi"
Deskripsi singkat (biasanya satu baris) dari aplikasi atau paket. Jika tidak tersedia
ini dikembalikan sebagai string kosong "".

"deskripsi_aplikasi"
Deskripsi yang lebih panjang dari aplikasi atau paket. Jika tidak tersedia ini dikembalikan
sebagai string kosong "".

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "inspect-list-applications2"
sebagai gantinya.

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

periksa-daftar-aplikasi2
periksa-daftar-aplikasi2 root

Kembalikan daftar aplikasi yang terinstal di sistem operasi.

Catatan: Panggilan ini bekerja secara berbeda dari bagian lain dari API inspeksi. Kamu harus
panggil "inspect-os", lalu "inspect-get-mountpoints", lalu pasang disk, sebelum menelepon
ini. Mendaftar aplikasi adalah operasi yang jauh lebih sulit yang membutuhkan
akses ke sistem file lengkap. Perhatikan juga bahwa tidak seperti panggilan "inspect-get-*" lainnya
yang baru saja mengembalikan data yang di-cache di pegangan libguestfs, panggilan ini sebenarnya berbunyi
bagian dari sistem file yang dipasang selama panggilan.

Ini mengembalikan daftar kosong jika kode inspeksi tidak dapat menentukan daftar
aplikasi.

Struktur aplikasi berisi bidang-bidang berikut:

"nama_aplikasi"
Nama aplikasi. Untuk tamu Linux yang diturunkan dari Red Hat dan Debian,
ini nama paketnya

"app2_display_name"
Nama tampilan aplikasi, terkadang dilokalkan ke bahasa penginstalan
sistem operasi tamu.

Jika tidak tersedia ini dikembalikan sebagai string kosong "". Penelepon perlu menampilkan
sesuatu dapat menggunakan "app2_name" sebagai gantinya.

"app2_epoch"
Untuk manajer paket yang menggunakan epoch, ini berisi epoch dari paket (dan
bilangan bulat). Jika tidak tersedia, ini dikembalikan sebagai 0.

"aplikasi2_versi"
String versi dari aplikasi atau paket. Jika tidak tersedia ini dikembalikan sebagai
string kosong "".

"aplikasi2_rilis"
String rilis aplikasi atau paket, untuk manajer paket yang menggunakan ini.
Jika tidak tersedia ini dikembalikan sebagai string kosong "".

"app2_arch"
String arsitektur aplikasi atau paket, untuk manajer paket yang menggunakan
ini. Jika tidak tersedia ini dikembalikan sebagai string kosong "".

"app2_install_path"
Jalur penginstalan aplikasi (pada sistem operasi seperti Windows yang
menggunakan jalur instalasi). Jalur ini dalam format yang digunakan oleh tamu yang beroperasi
sistem, ini bukan jalur libguestfs.

Jika tidak tersedia ini dikembalikan sebagai string kosong "".

"app2_trans_path"
Jalur instal diterjemahkan ke dalam jalur libguestfs. Jika tidak tersedia ini dikembalikan
sebagai string kosong "".

"app2_penerbit"
Nama penerbit aplikasi, untuk pengelola paket yang menggunakan ini. Jika
tidak tersedia ini dikembalikan sebagai string kosong "".

"app2_url"
URL (mis. URL upstream) aplikasi. Jika tidak tersedia ini dikembalikan sebagai
string kosong "".

"app2_source_package"
Untuk sistem pengemasan yang mendukung ini, nama paket sumber. Jika
tidak tersedia ini dikembalikan sebagai string kosong "".

"aplikasi2_ringkasan"
Deskripsi singkat (biasanya satu baris) dari aplikasi atau paket. Jika tidak tersedia
ini dikembalikan sebagai string kosong "".

"app2_description"
Deskripsi yang lebih panjang dari aplikasi atau paket. Jika tidak tersedia ini dikembalikan
sebagai string kosong "".

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

inspeksi-os
inspeksi-os

Fungsi ini menggunakan fungsi libguestfs lain dan heuristik tertentu untuk memeriksa
disk(s) (biasanya disk milik mesin virtual), mencari sistem operasi.

Daftar yang dikembalikan kosong jika tidak ada sistem operasi yang ditemukan.

Jika satu sistem operasi ditemukan, maka ini mengembalikan daftar dengan satu elemen, yang
adalah nama sistem file root dari sistem operasi ini. Bisa juga untuk ini
berfungsi untuk mengembalikan daftar yang berisi lebih dari satu elemen, yang menunjukkan dual-boot atau
mesin virtual multi-boot, dengan setiap elemen menjadi sistem file root dari salah satu
sistem operasi.

Anda dapat meneruskan string root yang dikembalikan ke fungsi "inspect-get-*" lainnya untuk
menanyakan informasi lebih lanjut tentang setiap sistem operasi, seperti nama dan versi.

Fungsi ini menggunakan fitur libguestfs lain seperti "mount-ro" dan "umount-all" secara berurutan
untuk memasang dan melepas sistem file dan melihat isinya. Ini harus disebut dengan no
disk yang saat ini terpasang. Fungsi ini juga dapat menggunakan Augea, jadi setiap Augea yang ada menangani
akan ditutup.

Fungsi ini tidak dapat mendekripsi disk terenkripsi. Penelepon harus melakukannya terlebih dahulu (menyediakan
kunci yang diperlukan) jika disk dienkripsi.

Silakan baca "INSPEKSI" di tamu(3) untuk lebih jelasnya.

Lihat juga "daftar-sistem file".

is-blockdev
is-blockdev-opts
jalur is-blockdev [followsymlinks:true|false]

Ini mengembalikan "benar" jika dan hanya jika ada perangkat blok dengan nama "jalur" yang diberikan.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan perangkat blok juga menyebabkan fungsi kembali benar.

Panggilan ini hanya melihat file dalam sistem file tamu. partisi Libguestfs dan
memblokir perangkat (mis. / Dev / sda) tidak dapat digunakan sebagai parameter "jalur" dari panggilan ini.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

is-chardev
is-chardev-opts
jalur is-chardev [followsymlinks:true|false]

Ini mengembalikan "benar" jika dan hanya jika ada perangkat karakter dengan nama "jalur" yang diberikan.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan chardev juga menyebabkan fungsi kembali benar.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

is-config
is-config

Ini mengembalikan true jika pegangan ini sedang dikonfigurasi (dalam status "CONFIG").

Untuk informasi lebih lanjut tentang negara bagian, lihat tamu(3).

adalah-dir
is-dir-opts
jalur is-dir [followsymlinks:true|false]

Ini mengembalikan "true" jika dan hanya jika ada direktori dengan nama "path" yang diberikan. Catatan
bahwa itu mengembalikan false untuk objek lain seperti file.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan direktori juga menyebabkan fungsi kembali benar.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

adalah-fifo
is-fifo-opts
jalur is-fifo [followsymlinks:true|false]

Ini mengembalikan "benar" jika dan hanya jika ada FIFO (pipa bernama) dengan "jalur" yang diberikan
Nama.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan FIFO juga menyebabkan fungsi kembali benar.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

adalah-file
is-file-opts
jalur file-is [followsymlinks:true|false]

Ini mengembalikan "true" jika dan hanya jika ada file biasa dengan nama "path" yang diberikan.
Perhatikan bahwa itu mengembalikan false untuk objek lain seperti direktori.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan file juga menyebabkan fungsi kembali benar.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

adalah-lv
perangkat is-lv

Perintah ini menguji apakah "perangkat" adalah volume logis, dan mengembalikan true jika ini adalah
kasus.

adalah soket
is-socket-opts
jalur is-socket [followsymlinks:true|false]

Ini mengembalikan "benar" jika dan hanya jika ada soket domain Unix dengan "jalur" yang diberikan
Nama.

Jika flag opsional "followsymlinks" benar, maka symlink (atau rantai symlink) yang
diakhiri dengan soket juga menyebabkan fungsi kembali benar.

Lihat juga "stat".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

adalah-symlink
jalur is-symlink

Ini mengembalikan "benar" jika dan hanya jika ada tautan simbolis dengan nama "jalur" yang diberikan.

Lihat juga "stat".

adalah-seluruh-perangkat
adalah perangkat seluruh perangkat

Ini mengembalikan "benar" jika dan hanya jika "perangkat" merujuk ke seluruh perangkat blok. Artinya, bukan
partisi atau perangkat logis.

adalah-nol
jalan adalah-nol

Ini mengembalikan true jika file ada dan file kosong atau berisi semua nol byte.

adalah-nol-perangkat
perangkat adalah-nol-perangkat

Ini mengembalikan true jika perangkat ada dan berisi semua nol byte.

Perhatikan bahwa untuk perangkat besar ini bisa memakan waktu lama untuk dijalankan.

isoinfo
isoinfo isofile

Ini sama dengan "isoinfo-device" kecuali ini berfungsi untuk file ISO yang terletak di dalam
beberapa sistem file terpasang lainnya. Perhatikan bahwa dalam kasus umum di mana Anda telah menambahkan ISO
file sebagai perangkat libguestfs, Anda akan tidak sebut ini. Alih-alih, Anda akan memanggil "isoinfo-
perangkat".

perangkat isoinfo
perangkat perangkat isoinfo

"perangkat" adalah perangkat ISO. Ini mengembalikan struct informasi yang dibaca dari yang utama
deskriptor volume (setara dengan ISO dari superblok) perangkat.

Biasanya lebih efisien menggunakan isoinfo(1) perintah dengan -d pilihan pada tuan rumah
untuk menganalisis file ISO, alih-alih melalui libguestfs.

Untuk informasi tentang bidang deskriptor volume utama, lihat
http://wiki.osdev.org/ISO_9660#Deskriptor_Volume_Utama_

jurnal-tutup
jurnal-tutup

Tutup pegangan jurnal.

jurnal-get
jurnal-get

Baca entri jurnal saat ini. Ini mengembalikan semua bidang dalam jurnal sebagai satu set
Pasangan "(nama attr, attrval)". The "attrname" adalah nama bidang (string).

"attrval" adalah nilai bidang (gumpalan biner, sering kali tetapi tidak selalu berupa string). Silahkan
perhatikan bahwa "attrval" adalah array byte, tidak string C yang diakhiri \0.

Panjang data dapat dipotong ke ambang data (lihat: "journal-set-data-
ambang", "jurnal-dapatkan-data-ambang").

Jika Anda mengatur ambang batas data menjadi tidak terbatas (0) maka panggilan ini dapat membaca entri jurnal dari
ukuran apa pun, mis. itu tidak dibatasi oleh protokol libguestfs.

jurnal-dapatkan-data-ambang
jurnal-dapatkan-data-ambang

Dapatkan ambang batas data saat ini untuk membaca entri jurnal. Ini adalah petunjuk untuk jurnal
bahwa itu dapat memotong bidang data ke ukuran ini saat membacanya (perhatikan juga bahwa itu mungkin tidak
potong mereka). Jika ini mengembalikan 0, maka ambang batas tidak terbatas.

Lihat juga "set jurnal-data-ambang".

jurnal-get-realtime-penggunaan
jurnal-get-realtime-penggunaan

Dapatkan stempel waktu (jam dinding) waktu nyata dari entri jurnal saat ini.

jurnal-berikutnya
jurnal-berikutnya

Pindah ke entri jurnal berikutnya. Anda harus menelepon ini setidaknya sekali setelah membuka
menangani sebelum Anda dapat membaca data.

Boolean yang dikembalikan memberi tahu Anda jika ada catatan jurnal lagi untuk dibaca. "benar"
berarti Anda dapat membaca catatan berikutnya (misalnya menggunakan "journal-get"), dan "false" berarti Anda telah
mencapai akhir jurnal.

jurnal terbuka
direktori terbuka jurnal

Buka jurnal systemd yang terletak di direktori. Setiap pegangan jurnal yang dibuka sebelumnya adalah
Tutup.

Isi jurnal dapat dibaca dengan menggunakan "journal-next" dan "journal-get".

Setelah Anda selesai menggunakan jurnal, Anda harus menutup pegangan dengan memanggil
"menutup jurnal".

jurnal-set-data-ambang
ambang batas jurnal-set-data

Tetapkan ambang batas data untuk membaca entri jurnal. Ini adalah petunjuk untuk jurnal bahwa itu
dapat memotong bidang data ke ukuran ini saat membacanya (perhatikan juga bahwa mungkin tidak
potong mereka). Jika Anda mengatur ini ke 0, maka ambang batas tidak terbatas.

Lihat juga "journal-get-data-threshold".

jurnal-lewati
lompati jurnal

Lewati ke depan ("lewati 0") atau ke belakang ("lewati < 0") dalam jurnal.

Jumlah entri yang benar-benar dilewati akan dikembalikan (perhatikan "rskip 0"). Jika ini bukan
sama dengan nilai absolut dari parameter lewati ("|lewati|") yang Anda berikan maka itu artinya
Anda telah mencapai akhir atau awal jurnal.

membunuh-subproses
membunuh-subproses

Ini membunuh hypervisor.

Jangan sebut ini. Lihat: "shutdown" sebagai gantinya.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "shutdown".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

jalankan
menjalankan
jalankan

Anda harus memanggil ini setelah mengonfigurasi pegangan (mis. menambahkan drive) tetapi sebelumnya
melakukan tindakan apa pun.

Jangan panggil "luncurkan" dua kali pada pegangan yang sama. Meskipun tidak akan memberikan kesalahan (untuk
alasan historis), perilaku yang tepat ketika Anda melakukan ini tidak didefinisikan dengan baik. Menangani
sangat murah untuk dibuat, jadi buat yang baru untuk setiap peluncuran.

lchown
jalur grup pemilik lchown

Ubah pemilik file menjadi "pemilik" dan grup menjadi "grup". Ini seperti "chown" tetapi jika "jalan"
adalah symlink maka tautannya sendiri yang diubah, bukan targetnya.

Hanya uid dan gid numerik yang didukung. Jika Anda ingin menggunakan nama, Anda harus mencari
dan urai sendiri file kata sandinya (dukungan Augeas membuat ini relatif mudah).

ldmtool-buat-semua
ldmtool-buat-semua

Fungsi ini memindai semua perangkat blok yang mencari volume disk dinamis Windows dan
partisi, dan membuat perangkat untuk semua yang ditemukan.

Panggil "list-ldm-volumes" dan "list-ldm-partitions" untuk mengembalikan semua perangkat.

Perhatikan bahwa Anda tidak biasanya perlu memanggil ini secara eksplisit, karena dilakukan secara otomatis
pada waktu "peluncuran". Namun Anda mungkin ingin memanggil fungsi ini jika Anda memiliki hotplugged
disk atau baru saja membuat disk dinamis Windows.

ldmtool-diskgroup-disk
ldmtool-diskgroup-disksdiskgroup

Kembalikan disk dalam grup disk dinamis Windows. Parameter "diskgroup" harus menjadi
GUID grup disk, satu elemen dari daftar yang dikembalikan oleh "ldmtool-scan".

ldmtool-diskgroup-nama
ldmtool-diskgroup-nama diskgroup

Kembalikan nama grup disk dinamis Windows. Parameter "diskgroup" harus menjadi
GUID grup disk, satu elemen dari daftar yang dikembalikan oleh "ldmtool-scan".

ldmtool-diskgroup-volume
ldmtool-diskgroup-volume diskgroup

Kembalikan volume dalam grup disk dinamis Windows. Parameter "diskgroup" seharusnya
GUID grup disk, satu elemen dari daftar yang dikembalikan oleh "ldmtool-scan".

ldmtool-hapus-semua
ldmtool-hapus-semua

Ini pada dasarnya kebalikan dari "ldmtool-create-all". Ini menghapus pemetaan perangkat
pemetaan untuk semua volume disk dinamis Windows

pemindaian ldmtool
pemindaian ldmtool

Fungsi ini memindai disk dinamis Windows. Ini mengembalikan daftar pengidentifikasi (GUID)
untuk semua grup disk yang ditemukan. Pengidentifikasi ini dapat diteruskan ke "ldmtool-*" lainnya
fungsi.

Fungsi ini memindai semua perangkat blok. Untuk memindai subset perangkat blok, panggil "ldmtool-
scan-perangkat" sebagai gantinya.

ldmtool-scan-perangkat
ldmtool-scan-devices 'perangkat ...'

Fungsi ini memindai disk dinamis Windows. Ini mengembalikan daftar pengidentifikasi (GUID)
untuk semua grup disk yang ditemukan. Pengidentifikasi ini dapat diteruskan ke "ldmtool-*" lainnya
fungsi.

Parameter "perangkat" adalah daftar perangkat blok yang dipindai. Jika daftar ini adalah
kosong, semua perangkat blok dipindai.

ldmtool-volume-petunjuk
ldmtool-volume-petunjuk volume diskgroup

Kembalikan bidang petunjuk volume bernama "volume" di grup disk dengan GUID
"diskgroup". Ini mungkin tidak ditentukan, dalam hal ini string kosong dikembalikan. Itu
bidang petunjuk sering, meskipun tidak selalu, nama drive Windows, mis. "E:".

ldmtool-volume-partisi
ldmtool-volume-partitions volume diskgroup

Kembalikan daftar partisi dalam volume bernama "volume" di grup disk dengan GUID
"diskgroup".

ldmtool-volume-type
ldmtool-volume-jenis volume diskgroup

Kembalikan jenis volume bernama "volume" di grup disk dengan GUID "diskgroup".

Kemungkinan jenis volume yang dapat dikembalikan di sini meliputi: "sederhana", "terentang", "bergaris",
"cermin", "serangan5". Jenis lain juga dapat dikembalikan.

lgetxattr
nama jalur lgxattr

Dapatkan satu atribut tambahan dari file "path" bernama "name". Jika "jalur" adalah symlink,
maka panggilan ini mengembalikan atribut yang diperluas dari symlink.

Biasanya lebih baik untuk mendapatkan semua atribut yang diperluas dari file sekaligus dengan menelepon
"getxattr". Namun beberapa implementasi sistem file Linux bermasalah dan tidak menyediakan
cara untuk membuat daftar atribut. Untuk sistem file ini (terutama ntfs-3g), Anda harus mengetahui:
nama atribut yang diperluas yang Anda inginkan sebelumnya dan panggil fungsi ini.

Nilai atribut yang diperluas adalah gumpalan data biner. Jika tidak ada atribut yang diperluas
bernama "nama", ini mengembalikan kesalahan.

Lihat juga: "lgetxattrs", "getxattr", attr(5).

lgetxattrs
jalur lgxattrs

Ini sama dengan "getxattrs", tetapi jika "path" adalah tautan simbolis, maka ia mengembalikan
atribut yang diperluas dari tautan itu sendiri.

daftar-9p
daftar-9p

Daftar semua sistem file 9p yang dilampirkan ke tamu. Daftar tag pemasangan dikembalikan.

daftar-perangkat
daftar-perangkat

Daftar semua perangkat blok.

Nama perangkat blok lengkap dikembalikan, mis. / Dev / sda.

Lihat juga "daftar-sistem file".

daftar-disk-label
daftar-disk-label

Jika Anda menambahkan drive menggunakan parameter "label" opsional dari "add-drive-opts", Anda dapat menggunakan
panggilan ini untuk memetakan antara label disk, dan perangkat blok mentah dan nama partisi (seperti
/ Dev / sda dan / Dev / sda1).

Ini mengembalikan hashtable, di mana kunci adalah label disk (tanpa itu /dev/disk/guestfs
awalan), dan nilainya adalah perangkat blok mentah lengkap dan nama partisi (mis. / Dev / sda
dan / Dev / sda1).

daftar-dm-perangkat
daftar-dm-perangkat

Daftar semua perangkat pemetaan perangkat.

Daftar yang dikembalikan berisi /dev/pemeta/* perangkat, mis. yang dibuat oleh panggilan sebelumnya ke
"luks-buka".

Perangkat pemetaan perangkat yang sesuai dengan volume logis adalah tidak dikembalikan dalam daftar ini.
Panggil "lvs" jika Anda ingin membuat daftar volume logis.

daftar-filesystem
daftar-filesystem

Perintah inspeksi ini mencari sistem file pada partisi, perangkat blok dan logika
volume, mengembalikan daftar "mountables" yang berisi sistem file dan tipenya.

Nilai kembalian adalah hash, di mana kuncinya adalah perangkat yang berisi sistem file, dan
nilai adalah tipe sistem file. Sebagai contoh:

"/dev/sda1" => "ntfs"
"/dev/sda2" => "ext2"
"/dev/vg_guest/lv_root" => "ext4"
"/dev/vg_guest/lv_swap" => "tukar"

Kuncinya belum tentu perangkat blok. Ini juga bisa berupa string 'dapat dipasang' yang buram
yang dapat diteruskan ke "mount".

Nilainya dapat memiliki nilai khusus "tidak diketahui", artinya konten perangkat adalah
tidak ditentukan atau kosong. "swap" berarti partisi swap Linux.

Perintah ini menjalankan perintah libguestfs lainnya, yang mungkin termasuk "mount" dan "umount", dan
oleh karena itu Anda harus menggunakan ini segera setelah peluncuran dan hanya ketika tidak ada yang dipasang.

Tidak semua sistem file yang dikembalikan dapat dipasang. Secara khusus, partisi swap adalah
dikembalikan dalam daftar. Juga perintah ini tidak memeriksa bahwa setiap sistem file yang ditemukan adalah
valid dan dapat dipasang, dan beberapa sistem file mungkin dapat dipasang tetapi memerlukan opsi khusus.
Sistem file mungkin tidak semuanya milik satu sistem operasi logis (gunakan "inspect-os" untuk
mencari OS).

daftar-ldm-partisi
daftar-ldm-partisi

Fungsi ini mengembalikan semua partisi disk dinamis Windows yang ditemukan pada waktu peluncuran.
Ini mengembalikan daftar nama perangkat.

daftar-ldm-volume
daftar-ldm-volume

Fungsi ini mengembalikan semua volume disk dinamis Windows yang ditemukan pada waktu peluncuran. Dia
mengembalikan daftar nama perangkat.

daftar-md-perangkat
daftar-md-perangkat

Daftar semua perangkat Linux md.

daftar-partisi
daftar-partisi

Daftar semua partisi yang terdeteksi pada semua perangkat blok.

Nama perangkat partisi lengkap dikembalikan, mis. / Dev / sda1

Ini tidak mengembalikan volume logis. Untuk itu Anda perlu memanggil "lvs".

Lihat juga "daftar-sistem file".

ll
ll direktori

Daftar file di direktori (relatif terhadap direktori root, tidak ada cwd) di
format 'ls -la'.

Perintah ini sebagian besar berguna untuk sesi interaktif. Dia tidak dimaksudkan agar Anda mencoba
untuk mengurai string keluaran.

llz
direktori llz

Daftar file di direktori dalam format 'ls -laZ'.

Perintah ini sebagian besar berguna untuk sesi interaktif. Dia tidak dimaksudkan agar Anda mencoba
untuk mengurai string keluaran.

ln
Dalam nama tautan target

Perintah ini membuat tautan keras menggunakan perintah "ln".

ln-f
Nama tautan target ln-f

Perintah ini membuat tautan keras menggunakan perintah "ln -f". Itu -f opsi menghapus
link ("linkname") jika sudah ada.

ln-s
nama tautan target ln-s

Perintah ini membuat tautan simbolis menggunakan perintah "ln -s".

ln-sf
Nama tautan target ln-sf

Perintah ini membuat tautan simbolis menggunakan perintah "ln -sf", The -f opsi menghapus
link ("linkname") jika sudah ada.

lremovexattr
jalur lremovexattr xattr

Ini sama dengan "removexattr", tetapi jika "path" adalah tautan simbolis, maka itu akan menghapus
atribut yang diperluas dari tautan itu sendiri.

ls
ls direktori

Daftar file di direktori (relatif terhadap direktori root, tidak ada cwd). '.'
dan entri '..' tidak dikembalikan, tetapi file tersembunyi ditampilkan.

ls0
ls0 dir (nama file|-)

Perintah khusus ini digunakan untuk mendapatkan daftar nama file di direktori "dir".
Daftar nama file ditulis ke file lokal nama file (pada tuan rumah).

Dalam file output, nama file dipisahkan oleh karakter "\0".

"." dan ".." tidak dikembalikan. Nama file tidak diurutkan.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

lsetxattr
lsetxattr xattr val vallen jalur

Ini sama dengan "setxattr", tetapi jika "jalur" adalah tautan simbolis, maka ia menetapkan perpanjangan
atribut tautan itu sendiri.

status
jalur terakhir

Mengembalikan informasi file untuk "jalur" yang diberikan.

Ini sama dengan "stat" kecuali jika "path" adalah tautan simbolik, maka tautannya adalah
stat-ed, bukan file yang dirujuk.

Ini sama dengan status(2) panggilan sistem.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "lstatns".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

daftar status
lstatlist jalur 'nama ...'

Panggilan ini memungkinkan Anda untuk melakukan operasi "lstat" pada banyak file, di mana semua file
berada di direktori "path". "names" adalah daftar file dari direktori ini.

Sebagai imbalannya Anda mendapatkan daftar stat struct, dengan korespondensi satu-ke-satu dengan "nama"
Daftar. Jika ada nama yang tidak ada atau tidak dapat dicantumkan, maka bidang "st_ino" dari itu
struktur diatur ke "-1".

Panggilan ini ditujukan untuk program yang ingin membuat daftar isi direktori secara efisien
tanpa melakukan banyak perjalanan pulang pergi. Lihat juga "lxattrlist" untuk panggilan yang sama efisiennya untuk
mendapatkan atribut yang diperluas.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "lstatnslist".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

lstatn
jalur lstatn

Mengembalikan informasi file untuk "jalur" yang diberikan.

Ini sama dengan "statns" kecuali jika "path" adalah tautan simbolik, maka tautannya adalah
stat-ed, bukan file yang dirujuk.

Ini sama dengan status(2) panggilan sistem.

daftar status
lstatnslist jalur 'nama ...'

Panggilan ini memungkinkan Anda untuk melakukan operasi "lstatns" pada banyak file, di mana semua file
berada di direktori "path". "names" adalah daftar file dari direktori ini.

Sebagai imbalannya Anda mendapatkan daftar stat struct, dengan korespondensi satu-ke-satu dengan "nama"
Daftar. Jika ada nama yang tidak ada atau tidak dapat dicantumkan, maka bidang "st_ino" dari itu
struktur diatur ke "-1".

Panggilan ini ditujukan untuk program yang ingin membuat daftar isi direktori secara efisien
tanpa melakukan banyak perjalanan pulang pergi. Lihat juga "lxattrlist" untuk panggilan yang sama efisiennya untuk
mendapatkan atribut yang diperluas.

luks-tambah-kunci
luks-tambahkan-kunci kunci perangkat

Perintah ini menambahkan kunci baru pada "perangkat" perangkat LUKS. "kunci" adalah kunci yang ada, dan adalah
digunakan untuk mengakses perangkat. "newkey" adalah kunci baru untuk ditambahkan. "slot kunci" adalah slot kunci
yang akan diganti.

Perhatikan bahwa jika "keyslot" sudah berisi kunci, maka perintah ini akan gagal. Kamu harus
gunakan "luks-kill-slot" terlebih dahulu untuk menghapus kunci itu.

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

luks-dekat
luks-close perangkat

Ini menutup perangkat LUKS yang dibuat sebelumnya oleh "luks-open" atau "luks-open-ro". Itu
Parameter "perangkat" harus berupa nama perangkat pemetaan LUKS (mis. /dev/mapper/nama peta)
dan tidak nama perangkat blok yang mendasarinya.

format-luks
slot kunci perangkat format luks

Perintah ini menghapus data yang ada di "perangkat" dan memformat perangkat sebagai LUKS yang dienkripsi
perangkat. "kunci" adalah kunci awal, yang ditambahkan ke slot kunci "slot". (LUKS mendukung 8
slot kunci, bernomor 0-7).

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

luks-format-cipher
luks-format-cipher perangkat keylot cipher

Perintah ini sama dengan "luks-format" tetapi juga memungkinkan Anda untuk mengatur "cipher" yang digunakan.

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

luks-kill-slot
slot kunci perangkat luks-kill-slot

Perintah ini menghapus kunci di slot kunci "keyslot" dari perangkat LUKS terenkripsi
"perangkat". "kunci" harus menjadi salah satu dari lain kunci.

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

luks-terbuka
luks-buka nama peta perangkat

Perintah ini membuka perangkat blok yang telah dienkripsi menurut Linux Unified
Pengaturan Kunci (LUKS) standar.

"perangkat" adalah perangkat blok terenkripsi atau partisi.

Penelepon harus menyediakan salah satu kunci yang terkait dengan perangkat blok LUKS, di "kunci"
parameter.

Ini menciptakan perangkat blok baru yang disebut /dev/mapper/nama peta. Membaca dan menulis untuk ini
perangkat blok didekripsi dari dan dienkripsi ke "perangkat" yang mendasarinya masing-masing.

Jika perangkat blok ini berisi grup volume LVM, maka panggil "vgscan" diikuti dengan "vg-
aktifkan-semua" akan membuatnya terlihat.

Gunakan "daftar-dm-perangkat" untuk mendaftar semua perangkat pemetaan perangkat.

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

luks-buka-ro
nama peta perangkat luks-open-ro

Ini sama dengan "luks-open" kecuali bahwa pemetaan hanya-baca dibuat.

Perintah ini memiliki satu atau lebih parameter kunci atau frasa sandi. Guestfish akan meminta
ini secara terpisah.

lvcreate
lvcreate logvol volgroup mbytes

Ini membuat volume logis LVM yang disebut "logvol" pada grup volume "volgroup", dengan
"ukuran" megabyte.

lvcreate-bebas
persen volgroup logvol bebas lvcreate

Buat volume logis LVM yang disebut /dev/volgroup/logvol, menggunakan kira-kira "persen" %
dari ruang kosong yang tersisa di grup volume. Paling berguna, ketika "persen" adalah 100
ini akan membuat LV sebesar mungkin.

lvm-kanonik-lv-nama
lvm-canonical-lv-nama lvname

Ini mengubah skema penamaan alternatif untuk LV yang mungkin Anda temukan ke kanonik
nama. Sebagai contoh, /dev/mapper/VG-LV dikonversi ke /dev/VG/LV.

Perintah ini mengembalikan kesalahan jika parameter "lvname" tidak merujuk ke logika
volume.

Lihat juga "is-lv", "canonical-device-name".

lvm-clear-filter
lvm-clear-filter

Ini membatalkan efek "lvm-set-filter". LVM akan dapat melihat setiap perangkat blok.

Perintah ini juga membersihkan cache LVM dan melakukan pemindaian grup volume.

lvm-hapus-semua
lvm-hapus-semua

Perintah ini menghapus semua volume logis LVM, grup volume, dan volume fisik.

lvm-set-filter
lvm-set-filter 'perangkat ...'

Ini menetapkan filter perangkat LVM sehingga LVM hanya dapat "melihat" perangkat yang diblokir
dalam daftar "perangkat", dan akan mengabaikan semua perangkat blok terlampir lainnya.

Jika gambar disk berisi PV atau VG duplikat, perintah ini berguna untuk membuat LVM
abaikan duplikatnya, jika tidak, LVM bisa menjadi bingung. Perhatikan juga ada dua jenis
kemungkinan duplikasi: baik PV/VG kloning yang memiliki UUID identik; atau VG yang
tidak dikloning tetapi kebetulan memiliki nama yang sama. Dalam operasi normal Anda tidak dapat membuat
situasi ini, tetapi Anda dapat melakukannya di luar LVM, mis. dengan mengkloning gambar disk atau dengan bit
memutar-mutar di dalam metadata LVM.

Perintah ini juga membersihkan cache LVM dan melakukan pemindaian grup volume.

Anda dapat memfilter seluruh perangkat blok atau partisi individual.

Anda tidak dapat menggunakan ini jika ada VG yang sedang digunakan (misalnya berisi sistem file terpasang),
bahkan jika Anda tidak menyaring VG itu.

hapus
hapus perangkat

Hapus "perangkat" volume logis LVM, di mana "perangkat" adalah jalur ke LV, seperti
/dev/VG/LV.

Anda juga dapat menghapus semua LV dalam grup volume dengan menentukan nama VG, /dev/VG.

ganti nama
lvrename logvol newlogvol

Ganti nama volume logis "logvol" dengan nama baru "newlogvol".

ukuran lv
lvresize perangkat mbyte

Ini mengubah ukuran (memperluas atau mengecilkan) volume logis LVM yang ada menjadi "mbyte". Kapan
reduksi, data di bagian yang direduksi hilang.

lvresize-bebas
lv persen lv bebas ukuran

Ini memperluas volume logis "lv" yang ada sehingga mengisi "pc"% dari sisa gratis
ruang dalam kelompok volume. Biasanya Anda akan menyebutnya dengan pc = 100 yang memperluas
volume logis sebanyak mungkin, menggunakan semua ruang kosong yang tersisa di grup volume.

ls
ls

Daftar semua volume logis yang terdeteksi. Ini setara dengan ls(8) perintah.

Ini mengembalikan daftar nama perangkat volume logis (mis. /dev/VolGroup00/LogVol00).

Lihat juga "lvs-full", "list-filesystems".

lvs-penuh
lvs-penuh

Daftar semua volume logis yang terdeteksi. Ini setara dengan ls(8) perintah. Itu
versi "penuh" mencakup semua bidang.

lvuid
perangkat lvuid

Perintah ini mengembalikan UUID dari "perangkat" LVM LV.

lxattrlist
lxattrlist jalur 'nama ...'

Panggilan ini memungkinkan Anda untuk mendapatkan atribut yang diperluas dari banyak file, di mana semua file berada
di direktori "jalan". "names" adalah daftar file dari direktori ini.

Saat kembali, Anda mendapatkan daftar datar struct xattr yang harus ditafsirkan secara berurutan.
Struct xattr pertama selalu memiliki "attrname" dengan panjang nol. "attrval" dalam struktur ini adalah
nol-panjang untuk menunjukkan ada kesalahan melakukan "lgetxattr" untuk file ini, or adalah C
string yang merupakan angka desimal (jumlah atribut berikut untuk file ini, yang
bisa menjadi "0"). Kemudian setelah struct xattr pertama adalah nol atau lebih atribut untuk
file bernama pertama. Ini berulang untuk file kedua dan selanjutnya.

Panggilan ini ditujukan untuk program yang ingin membuat daftar isi direktori secara efisien
tanpa melakukan banyak perjalanan pulang pergi. Lihat juga "lstatlist" untuk panggilan yang sama efisiennya untuk
mendapatkan statistik standar.

max-disk
max-disk

Kembalikan jumlah maksimum disk yang dapat ditambahkan ke pegangan (misalnya dengan "add-drive-opts"
dan panggilan serupa).

Fungsi ini telah ditambahkan di libguestfs 1.19.7. Di versi libguestfs sebelumnya,
batasnya adalah 25.

Lihat "JUMLAH DISK MAKSIMUM" di tamu(3) untuk informasi tambahan tentang topik ini.

md-buat
md-buat nama 'perangkat ...' [missingbitmap:N] [nrdevices:N] [cadangan:N] [potongan:N] [level:..]

Buat perangkat Linux md (RAID) bernama "nama" pada perangkat dalam daftar "perangkat".

Parameter opsional adalah:

"peta bit hilang"
Bitmap perangkat yang hilang. Jika sedikit diatur itu berarti perangkat yang hilang ditambahkan
ke array. Bit paling tidak signifikan sesuai dengan perangkat pertama dalam larik.

Sebagai contoh:

Jika "devices = ["/dev/sda"]" dan "missingbitmap = 0x1" maka array yang dihasilkan akan
menjadi "[ , "/dev/sda"]".

Jika "devices = ["/dev/sda"]" dan "missingbitmap = 0x2" maka array yang dihasilkan akan
menjadi "["/dev/sda", ]".

Ini default ke 0 (tidak ada perangkat yang hilang).

Panjang "perangkat" + jumlah bit yang diatur dalam "bitmap yang hilang" harus sama
"nrperangkat" + "cadangan".

"nrperangkat"
Jumlah perangkat RAID aktif.

Jika tidak disetel, ini default ke panjang "perangkat" ditambah jumlah bit yang disetel
"peta bit hilang".

"meluangkan"
Jumlah perangkat cadangan.

Jika tidak disetel, defaultnya adalah 0.

"bingkah"
Ukuran potongan dalam byte.

"tingkat"
Tingkat RAID, yang dapat berupa salah satu dari: linear, serangan0, 0, garis, serangan1, 1, cermin,
serangan4, 4, serangan5, 5, serangan6, 6, serangan10, 10. Beberapa di antaranya sinonim, dan banyak lagi
tingkat dapat ditambahkan di masa depan.

Jika tidak disetel, defaultnya adalah "raid1".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

md-detail
md-detail md

Perintah ini memperlihatkan output dari 'mdadm -DY '. Bidang-bidang berikut biasanya:
hadir dalam hash yang dikembalikan. Bidang lain mungkin juga ada.

"tingkat"
Tingkat serangan perangkat MD.

"perangkat"
Jumlah perangkat yang mendasari di perangkat MD.

"metadata"
Versi metadata yang digunakan.

"uuid"
UUID perangkat MD.

"nama"
Nama perangkat MD.

md-stat
md-stat md

Panggilan ini mengembalikan daftar perangkat dasar yang membentuk RAID perangkat lunak tunggal
perangkat larik "md".

Untuk mendapatkan daftar perangkat RAID perangkat lunak, panggil "list-md-devices".

Setiap struktur yang dikembalikan sesuai dengan satu perangkat bersama dengan status tambahan
informasi:

"mdstat_device"
Nama perangkat yang mendasarinya.

"mdstat_index"
Indeks perangkat ini dalam larik.

"mdstat_flags"
Bendera yang terkait dengan perangkat ini. Ini adalah string yang mengandung (tanpa urutan tertentu)
nol atau lebih dari tanda berikut:

"W" menulis-kebanyakan

Perangkat "F" rusak

Perangkat "S" adalah cadangan RAID

pengganti "R"

md-berhenti
md-berhenti md

Perintah ini menonaktifkan array MD bernama "md". Perangkat dihentikan, tetapi tidak
dimusnahkan atau dinolkan.

mkdir
jalur mkdir

Buat direktori bernama "path".

mode mkdir
mode jalur mode mkdir

Perintah ini membuat direktori, mengatur izin awal direktori ke
"mode".

Untuk sistem file Linux umum, mode aktual yang disetel adalah "mode & ~umask &
01777". Sistem file non-asli-Linux dapat menginterpretasikan mode dengan cara lain.

Lihat juga "mkdir", "umask"

mkdir-p
jalur mkdir-p

Buat direktori bernama "path", buat direktori induk apa pun yang diperlukan. Ini
seperti perintah shell "mkdir -p".

mkdtemp
mkdtemp tmpl

Perintah ini membuat direktori sementara. Parameter "tmpl" harus penuh
pathname untuk nama direktori sementara dengan enam karakter terakhir adalah "XXXXXX".

Misalnya: "/tmp/myprogXXXXXX" atau "/Temp/myprogXXXXXX", yang kedua cocok
untuk sistem file Windows.

Nama direktori sementara yang dibuat dikembalikan.

Direktori sementara dibuat dengan mode 0700 dan dimiliki oleh root.

Penelepon bertanggung jawab untuk menghapus direktori sementara dan isinya setelah digunakan.

Lihat juga: mkdtemp(3)

mke2fs
perangkat mke2fs [blockscount:N] [blocksize:N] [fragsize:N] [blockspergroup:N] [numberofgroups:N] [bytesperinode:N] [inodesize:N] [journalsize:N] [numberofinodes:N] [ukuran langkah: N] [stripewidth:N] [maxonlineresize:N] [reservedblockspercentage:N] [mmpupdateinterval:N] [journaldevice:..] [label:..] [lastmounteddir:..] [creatoros:..] [fstype:. .] [usagetype:..] [uuid:..] [forcecreate:true|false] [writesbandgrouponly:true|false] [lazyitableinit:true|false] [lazyjournalinit:true|false] [testfs:true|false] [ buang: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" digunakan untuk membuat sistem file ext2, ext3, atau ext4 pada "perangkat".

Opsional "blockscount" adalah ukuran sistem file dalam blok. Jika dihilangkan
default ke ukuran "perangkat". Perhatikan jika sistem file terlalu kecil untuk memuat
jurnal, "mke2fs" diam-diam akan membuat sistem file ext2.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mke2fs-J
mke2fs-J fstype memblokir ukuran jurnal perangkat

Ini membuat sistem file ext2/3/4 di "perangkat" dengan jurnal eksternal di "jurnal". Dia
setara dengan perintah:

mke2fs -t fstype -b ukuran blok -J device=

Lihat juga "mke2journal".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mke2fs-JL
mke2fs-JL fstype memblokir ukuran label perangkat

Ini membuat sistem file ext2/3/4 di "perangkat" dengan jurnal eksternal di jurnal
berlabel "label".

Lihat juga "mke2journal-L".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mke2fs-JU
mke2fs-JU fstype memblokir ukuran perangkat uuid

Ini membuat sistem file ext2/3/4 di "perangkat" dengan jurnal eksternal di jurnal
dengan UUID "uuid".

Lihat juga "mke2journal-U".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mke2journal
perangkat pemblokiran mke2journal

Ini membuat jurnal eksternal ext2 di "perangkat". Ini setara dengan perintah:

mke2fs -O journal_dev -b memblokir ukuran perangkat

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mke2jurnal-L
mke2journal-L perangkat label ukuran blok

Ini membuat jurnal eksternal ext2 pada "perangkat" dengan label "label".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mke2jurnal-U
mke2journal-U memblokir ukuran perangkat uuid

Ini membuat jurnal eksternal ext2 pada "perangkat" dengan UUID "uuid".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mke2fs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mkfifo
jalur mode mkfifo

Panggilan ini membuat FIFO (pipa bernama) yang disebut "jalur" dengan mode "mode". Itu hanya sebuah
pembungkus yang nyaman di sekitar "mknod".

Berbeda dengan "mknod", "mode" harus hanya berisi bit izin.

Mode yang sebenarnya diatur dipengaruhi oleh umask.

mkfs
mkfs-opts
mkfs fstype device [ukuran blok:N] [fitur:..] [inode:N] [ukuran sektor:N] [label:..]

Fungsi ini membuat sistem file pada "perangkat". Jenis sistem file adalah "fstype", untuk
contoh "ext3".

Argumen opsional adalah:

"Ukuran blok"
Ukuran blok sistem file. Ukuran blok yang didukung bergantung pada jenis sistem file, tetapi
biasanya mereka adalah 1024, 2048 atau 4096 untuk sistem file Linux ext2/3.

Untuk VFAT dan NTFS parameter "blocksize" diperlakukan sebagai ukuran cluster yang diminta.

Untuk ukuran blok UFS, silakan lihat mkfs.ufs(8).

"fitur"
Ini melewati -O parameter ke program mkfs eksternal.

Untuk jenis sistem file tertentu, ini memungkinkan fitur sistem file tambahan untuk dipilih.
Lihat mke2fs(8) dan mkfs.ufs(8) untuk lebih jelasnya.

Anda tidak dapat menggunakan parameter opsional ini dengan jenis sistem file "gfs" atau "gfs2".

"inode"
Ini melewati -I parameter ke eksternal mke2fs(8) program yang mengatur inode
size (hanya untuk sistem file ext2/3/4 saat ini).

"ukuran sektor"
Ini melewati -S parameter ke eksternal mkfs.ufs(8) program, yang menetapkan ukuran sektor
untuk sistem file ufs.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mkfs-b
mkfs-b fstype memblokir ukuran perangkat

Panggilan ini mirip dengan "mkfs", tetapi memungkinkan Anda untuk mengontrol ukuran blok dari
sistem file yang dihasilkan. Ukuran blok yang didukung bergantung pada jenis sistem file, tetapi biasanya
mereka hanya 1024, 2048 atau 4096.

Untuk VFAT dan NTFS parameter "blocksize" diperlakukan sebagai ukuran cluster yang diminta.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mkfs".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mkfs-btrfs
mkfs-btrfs 'perangkat ...' [allocstart:N] [bytecount:N] [tipe data:..] [leafsize:N] [label:..] [metadata:..] [nodesize:N] [ukuran sektor: N]

Buat sistem file btrfs, memungkinkan semua yang dapat dikonfigurasi untuk disetel. Untuk informasi lebih lanjut tentang
argumen opsional, lihat mkfs.btrfs(8).

Karena sistem file btrfs dapat menjangkau banyak perangkat, ini membutuhkan daftar perangkat yang tidak kosong.

Untuk membuat sistem file umum, gunakan "mkfs".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mklost-dan-ditemukan
titik pemasangan mklost-dan-ditemukan

Buat direktori "lost+found", biasanya di direktori root sistem file ext2/3/4.
"mountpoint" adalah direktori tempat kami mencoba membuat direktori "lost+found".

mkmountpoint
jalur bebas mkmountpoint

"mkmountpoint" dan "rmmountpoint" adalah panggilan khusus yang dapat digunakan untuk membuat tambahan
mountpoints sebelum memasang sistem file pertama.

Panggilan ini adalah hanya diperlukan dalam beberapa keadaan yang sangat terbatas, terutama dalam kasus di mana:
Anda ingin memasang campuran sistem file yang tidak terkait dan/atau hanya-baca bersama-sama.

Misalnya, live CD sering berisi kumpulan sistem file "boneka Rusia", sebuah ISO luar
layer, dengan gambar squashfs di dalamnya, dengan gambar ext2/3 di dalamnya. Anda dapat membongkar
ini sebagai berikut di guestfish:

tambahkan-ro Fedora-11-i686-Live.iso
menjalankan
mkmountpoint /cd
mkmountpoint /sqsh
mkmountpoint /ext3fs
pasang /dev/sda /cd
mount-loop /cd/LiveOS/squashfs.img /sqsh
mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs

Sistem file bagian dalam sekarang dibongkar di bawah mountpoint /ext3fs.

"mkmountpoint" tidak kompatibel dengan "umount-all". Anda mungkin mendapatkan kesalahan tak terduga jika Anda
mencoba untuk mencampur panggilan ini. Yang paling aman adalah meng-unmount filesystem secara manual dan menghapus
mountpoint setelah digunakan.

"umount-all" melepas sistem file dengan mengurutkan jalur terpanjang terlebih dahulu, jadi agar ini berfungsi
untuk mountpoint manual, Anda harus memastikan bahwa mountpoint terdalam memiliki yang terpanjang
nama path, seperti pada contoh kode di atas.

Untuk lebih jelasnya lihat https://bugzilla.redhat.com/show_bug.cgi?id=599503

Sinkronisasi otomatis [lihat "set-autosync", ini disetel secara default pada pegangan] dapat menyebabkan "umount-all" menjadi
dipanggil ketika pegangan ditutup yang juga dapat memicu masalah ini.

mknod
mknod mode devmajor jalur devminor

Panggilan ini membuat perangkat khusus blok atau karakter, atau pipa bernama (FIFO).

Parameter "mode" harus menjadi mode, menggunakan konstanta standar. "devmajor" dan
"devminor" adalah nomor mayor dan minor perangkat, hanya digunakan saat membuat blok dan
perangkat khusus karakter.

Perhatikan bahwa, seperti mknod(2), mode harus bitwise ATAU dengan S_IFBLK, S_IFCHR,
S_IFIFO atau S_IFSOCK (jika tidak, panggilan ini hanya membuat file biasa). Konstanta ini
tersedia di file header Linux standar, atau Anda dapat menggunakan "mknod-b", "mknod-c" atau
"mkfifo" yang membungkus perintah ini yang bitwise OR yang sesuai
konstan untuk Anda.

Mode yang sebenarnya diatur dipengaruhi oleh umask.

mknod-b
mknod-b mode devmajor jalur devminor

Panggilan ini membuat simpul perangkat blok yang disebut "jalur" dengan mode "mode" dan perangkat
mayor/minor "devmajor" dan "devminor". Ini hanya pembungkus yang nyaman di sekitar "mknod".

Berbeda dengan "mknod", "mode" harus hanya berisi bit izin.

Mode yang sebenarnya diatur dipengaruhi oleh umask.

mknod-c
mknod-c mode devmajor jalur devminor

Panggilan ini membuat simpul perangkat karakter yang disebut "jalur" dengan mode "mode" dan perangkat mayor/minor
"devmajor" dan "devminor". Ini hanya pembungkus yang nyaman di sekitar "mknod".

Berbeda dengan "mknod", "mode" harus hanya berisi bit izin.

Mode yang sebenarnya diatur dipengaruhi oleh umask.

mkswap
mkswap-opts
mkswap perangkat [label:..] [uuid:..]

Buat partisi swap Linux di "perangkat".

Argumen opsi "label" dan "uuid" memungkinkan Anda untuk mengatur label dan/atau UUID dari yang baru
partisi swap.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mkswap-L
perangkat label mkswap-L

Buat partisi swap pada "perangkat" dengan label "label".

Perhatikan bahwa Anda tidak dapat melampirkan label swap ke perangkat blok (mis. / Dev / sda), hanya untuk
partisi. Ini tampaknya merupakan batasan dari kernel atau alat swap.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mkswap".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mkswap-U
mkswap-U perangkat uuid

Buat partisi swap pada "perangkat" dengan UUID "uuid".

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "mkswap".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

file mkswap
jalur file mkswap

Buat file swap.

Perintah ini hanya menulis tanda tangan file swap ke file yang ada. Untuk membuat file
sendiri, gunakan sesuatu seperti "fallocate".

mktemp
mktemp tmpl [akhiran:..]

Perintah ini membuat file sementara. Parameter "tmpl" harus berupa nama path lengkap untuk
nama direktori sementara dengan enam karakter terakhir adalah "XXXXXX".

Misalnya: "/tmp/myprogXXXXXX" atau "/Temp/myprogXXXXXX", yang kedua cocok
untuk sistem file Windows.

Nama file sementara yang dibuat dikembalikan.

File sementara dibuat dengan mode 0600 dan dimiliki oleh root.

Penelepon bertanggung jawab untuk menghapus file sementara setelah digunakan.

Jika parameter "suffix" opsional diberikan, maka suffix (mis. ".txt") ditambahkan ke
nama sementara.

Lihat juga: "mkdtemp".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

modprobe
nama modul modprobe

Ini memuat modul kernel di alat.

meningkat
pasang titik pemasangan yang dapat dipasang

Pasang disk tamu pada posisi di sistem file. Perangkat blok diberi nama / Dev / sda,
/ dev / sdb dan seterusnya, saat mereka ditambahkan ke tamu. Jika perangkat blok itu berisi
partisi, mereka akan memiliki nama yang biasa (mis. / Dev / sda1). Juga LVM /dev/VG/LVGaya
nama dapat digunakan, atau string 'dapat dipasang' dikembalikan oleh "list-filesystems" atau "inspect-get-
titik mount".

Aturannya sama dengan untuk meningkat(2): Sistem file harus dipasang terlebih dahulu pada / sebelum
lain dapat dipasang. Sistem file lain hanya dapat dipasang pada direktori yang sudah
ada.

Sistem file yang dipasang dapat ditulis, jika kami memiliki izin yang cukup pada dasarnya
perangkat.

Sebelum libguestfs 1.13.16, panggilan ini secara implisit menambahkan opsi "sinkronisasi" dan "noatime".
Opsi "sinkronisasi" sangat memperlambat penulisan dan menyebabkan banyak masalah bagi pengguna. Jika Anda
program mungkin perlu bekerja dengan versi libguestfs yang lebih lama, gunakan "mount-options" sebagai gantinya
(menggunakan string kosong untuk parameter pertama jika Anda tidak menginginkan opsi apa pun).

gunung-9p
mount-9p mounttag mountpoint [opsi:..]

Mount filesystem virtio-9p dengan tag "mounttag" pada direktori "mountpoint".

Jika diperlukan, "trans=virtio" akan otomatis ditambahkan ke opsi. Pilihan lainnya
diperlukan dapat diteruskan dalam parameter "opsi" opsional.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

gunung-lokal
mount-local localmountpoint [readonly:true|false] [opsi:..] [cachetimeout:N] [debugcalls:true|false]

Panggilan ini mengekspor sistem file yang dapat diakses libguestfs ke mountpoint (direktori) lokal
disebut "localmountpoint". Biasa membaca dan menulis ke file dan direktori di bawah
"localmountpoint" dialihkan melalui libguestfs.

Jika flag "readonly" opsional disetel ke true, maka tulis ke kesalahan pengembalian sistem file
"EROF".

"options" adalah daftar opsi pemasangan yang dipisahkan koma. Melihat gunung tamu(1) untuk beberapa berguna
Pilihan.

"cachetimeout" menetapkan batas waktu (dalam detik) untuk entri direktori yang di-cache. Standarnya adalah
60 detik. Melihat gunung tamu(1) untuk informasi lebih lanjut.

Jika "debugcalls" disetel ke true, maka informasi debug tambahan dibuat untuk
setiap panggilan FUSE.

Ketika "mount-local" kembali, sistem file sudah siap, tetapi tidak memproses permintaan
(akses ke sana akan diblokir). Anda harus memanggil "mount-local-run" untuk menjalankan loop utama.

Lihat "GUNUNG LOKAL" di tamu(3) untuk dokumentasi lengkap.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mount-local-run
mount-local-run

Jalankan loop utama yang menerjemahkan panggilan kernel ke panggilan libguestfs.

Ini hanya boleh dipanggil setelah "mount-local" berhasil kembali. Panggilan tidak akan
kembali sampai sistem file dilepas.

Note kamu harus tidak buat panggilan libguestfs bersamaan pada pegangan yang sama dari utas lain.

Anda dapat memanggil ini dari utas yang berbeda dari yang disebut "mount-local", subject
ke aturan yang biasa untuk utas dan libguestfs (lihat "GANDA PELANGGARAN DAN GANDA BELANJA"
in tamu(3)).

Lihat "GUNUNG LOKAL" di tamu(3) untuk dokumentasi lengkap.

mount-loop
mount-loop berkas mountpoint

Perintah ini memungkinkan Anda memasang fillet (gambar sistem file dalam file) pada titik pemasangan. Dia
sepenuhnya setara dengan perintah "mount -o loop file mountpoint".

opsi pemasangan
opsi mount-opsi mountpoint yang dapat dipasang

Ini sama dengan perintah "mount", tetapi memungkinkan Anda untuk mengatur opsi mount seperti untuk
itu meningkat(8) -o bendera.

Jika parameter "opsi" adalah string kosong, maka tidak ada opsi yang dilewatkan (semua opsi
default untuk apa pun yang digunakan sistem file).

gunung-ro
mount-ro mountpoint yang dapat dipasang

Ini sama dengan perintah "mount", tetapi me-mount sistem file dengan read-only
(-o ro) bendera.

mount-vfs
opsi mount-vfs vfstype mountpoint yang dapat dipasang

Ini sama dengan perintah "mount", tetapi memungkinkan Anda untuk mengatur kedua opsi mount
dan vfstype untuk meningkat(8) -o dan -t bendera.

titik mount
titik mount

Panggilan ini mirip dengan "mount". Panggilan itu mengembalikan daftar perangkat. Yang ini kembali
tabel hash (peta) nama perangkat ke direktori tempat perangkat dipasang.

Gunung
Gunung

Ini mengembalikan daftar sistem file yang saat ini dipasang. Ini mengembalikan daftar perangkat
(misalnya. / Dev / sda1, /dev/VG/LV).

Beberapa dudukan internal tidak ditampilkan.

Lihat juga: "mountpoints"

mv
tujuan mv src

Ini memindahkan file dari "src" ke "dest" di mana "dest" adalah nama file tujuan atau
direktori tujuan.

Lihat juga: "ganti nama".

nr-perangkat
nr-perangkat

Ini mengembalikan jumlah seluruh perangkat blok yang ditambahkan. Ini sama dengan
jumlah perangkat yang akan dikembalikan jika Anda memanggil "daftar-perangkat".

Untuk mengetahui jumlah maksimum perangkat yang dapat ditambahkan, panggil "max-disks".

ntfs-3g-probe
ntfs-3g-probe true|perangkat salah

Perintah ini menjalankan ntfs-3g.probe(8) perintah yang menyelidiki "perangkat" NTFS untuk
kemampuan untuk dipasang. (Tidak semua volume NTFS dapat dipasang baca-tulis, dan beberapa tidak dapat dipasang
sama sekali).

"rw" adalah bendera boolean. Setel ke true jika Anda ingin menguji apakah volume dapat dipasang
Baca tulis. Setel ke false jika Anda ingin menguji apakah volume dapat dipasang hanya-baca.

Nilai kembalian adalah bilangan bulat yang 0 jika operasi akan berhasil, atau bukan nol
nilai yang didokumentasikan dalam ntfs-3g.probe(8) halaman manual.

ntfsclone-in
ntfsclone-in (file cadangan|-) perangkat

Kembalikan "backupfile" (dari panggilan sebelumnya ke "ntfsclone-out") ke "device",
menimpa konten yang ada dari perangkat ini.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

ntfsclone-keluar
perangkat ntfsclone-out (backupfile|-) [metadataonly:true|false] [rescue:true|false] [ignorefscheck:true|false] [preservetimestamps:true|false] [force:true|false]

Streaming "perangkat" sistem file NTFS ke "file cadangan" lokal. Format yang digunakan untuk
file cadangan adalah format khusus yang digunakan oleh ntfsclone(8) alat.

Jika flag opsional "metadataonly" benar, maka hanya metadata disimpan, kehilangan semua
data pengguna (ini berguna untuk mendiagnosis beberapa masalah sistem file).

Bendera opsional "penyelamatan", "ignorefscheck", "preservetimestamps" dan "force" memiliki
makna yang tepat dirinci dalam ntfsclone(8) halaman manual.

Gunakan "ntfsclone-in" untuk memulihkan file kembali ke perangkat libguestfs.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

perbaikan ntfs
perangkat ntfsfix [clearbadsectors:true|false]

Perintah ini memperbaiki beberapa inkonsistensi NTFS mendasar, mengatur ulang file jurnal NTFS,
dan menjadwalkan pemeriksaan konsistensi NTFS untuk boot pertama ke Windows.

Ini adalah tidak setara dengan Windows "chkdsk". memang tidak pindai sistem file untuk
inkonsistensi.

Bendera "clearbadsectors" opsional menghapus daftar sektor buruk. Ini berguna setelah
mengkloning disk dengan bad sector ke disk baru.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

ntfsresize
ntfsresize-opts
ntfsresize perangkat [ukuran:N] [force:true|false]

Perintah ini mengubah ukuran sistem file NTFS, memperluas atau mengecilkannya ke ukuran
perangkat yang mendasari.

Parameter opsional adalah:

"ukuran"
Ukuran baru (dalam byte) dari sistem file. Jika dihilangkan, sistem file diubah ukurannya menjadi
pas dengan wadah (mis. partisi).

"memaksa"
Jika opsi ini benar, maka paksa pengubahan ukuran sistem file meskipun sistem file
ditandai sebagai memerlukan pemeriksaan konsistensi.

Setelah operasi pengubahan ukuran, sistem file selalu ditandai membutuhkan konsistensi
periksa (untuk keamanan). Anda harus boot ke Windows untuk melakukan pemeriksaan ini dan menghapus
keadaan ini. Jika kamu tidak atur opsi "paksa" maka tidak mungkin untuk menelepon
"ntfsresize" beberapa kali pada sistem file tunggal tanpa boot ke Windows
antara setiap pengubahan ukuran.

Lihat juga ntfsresize(8).

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

ntfsresize-ukuran
ukuran perangkat ukuran ntfsresize

Perintah ini sama dengan "ntfsresize" kecuali memungkinkan Anda untuk menentukan ukuran baru
(dalam byte) secara eksplisit.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "ntfsresize".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

mengurai-lingkungan
mengurai-lingkungan

Parsing lingkungan program dan atur flag di pegangan yang sesuai. Misalnya jika
"LIBGUESTFS_DEBUG=1" maka bendera 'verbose' diatur di pegangan.

jembatan program do tidak perlu untuk panggilan ini. Itu dilakukan secara implisit ketika Anda memanggil "buat".

Lihat "VARIABEL LINGKUNGAN" di tamu(3) untuk daftar variabel lingkungan yang dapat
mempengaruhi pegangan libguestfs. Lihat juga "guestfs_create_flags" di tamu(3), dan "mengurai-
daftar lingkungan".

parsing-daftar-lingkungan
parse-environment-list 'lingkungan ...'

Parsing daftar string dalam argumen "lingkungan" dan atur flag di pegangan
demikian. Misalnya jika "LIBGUESTFS_DEBUG=1" adalah string dalam daftar, maka
bendera 'verbose' diatur di pegangan.

Ini sama dengan "parse-environment" kecuali bahwa ia mem-parsing daftar string yang eksplisit
alih-alih lingkungan program.

bagian-tambahkan
bagian-tambahkan perangkat prlogex startect endect

Perintah ini menambahkan partisi ke "perangkat". Jika tidak ada tabel partisi pada perangkat,
panggil "part-init" terlebih dahulu.

Parameter "prlogex" adalah jenis partisi. Biasanya Anda harus melewati "p" atau
"utama" di sini, tetapi tabel partisi MBR juga mendukung "l" (atau "logis") dan "e" (atau
jenis partisi "diperpanjang").

"startsect" dan "endsect" adalah awal dan akhir dari partisi di sektor. "bagian akhir"
mungkin negatif, yang berarti menghitung mundur dari ujung disk ("-1" adalah
sektor terakhir).

Membuat partisi yang mencakup seluruh disk tidaklah mudah. Gunakan "part-disk" untuk melakukannya
bahwa.

bagian-del
part-del perangkat partnum

Perintah ini menghapus partisi bernomor "partnum" pada "perangkat".

Perhatikan bahwa dalam kasus partisi MBR, menghapus partisi yang diperluas juga menghapus semua
partisi logis yang dikandungnya.

bagian-disk
parttype perangkat part-disk

Perintah ini hanyalah kombinasi dari "part-init" diikuti oleh "part-add" untuk membuat a
partisi primer tunggal yang mencakup seluruh disk.

"parttype" adalah tipe tabel partisi, biasanya "mbr" atau "gpt", tetapi nilai lain yang mungkin
dijelaskan dalam "bagian-init".

bagian-get-bootable
bagian-dapatkan-bagian perangkat yang dapat di-boot

Perintah ini mengembalikan nilai true jika partisi "partnum" pada "perangkat" memiliki flag yang dapat di-boot
ditetapkan.

Lihat juga "part-set-bootable".

bagian-get-gpt-guid
part-get-gpt-guid perangkat partnum

Kembalikan GUID dari partisi GPT bernomor "partnum".

bagian-get-gpt-type
partnum perangkat tipe part-get-gpt

Kembalikan jenis GUID dari partisi GPT bernomor "partnum". Untuk partisi MBR, kembalikan
GUID yang sesuai dengan tipe MBR. Perilaku tidak ditentukan untuk partisi lain
jenis.

bagian-get-mbr-id
part-get-mbr-id perangkat partnum

Mengembalikan byte tipe MBR (juga dikenal sebagai byte ID) dari partisi bernomor
"nomor pasangan".

Perhatikan bahwa hanya partisi MBR (gaya DOS lama) yang memiliki tipe byte. Anda akan mendapatkan tidak terdefinisi
hasil untuk tipe tabel partisi lainnya (lihat "part-get-parttype").

bagian-dapatkan-mbr-jenis-bagian
part-get-mbr-part-type perangkat partnum

Ini mengembalikan jenis partisi dari partisi MBR bernomor "partnum" pada "perangkat" perangkat.

Ini mengembalikan "primer", "logis", atau "diperpanjang".

bagian-get-nama
part-get-name perangkat partnum

Ini mendapatkan nama partisi pada partisi bernomor "partnum" pada perangkat "perangkat". Catatan
bahwa partisi diberi nomor dari 1.

Nama partisi hanya dapat dibaca pada jenis tabel partisi tertentu. Ini bekerja pada
"gpt" tetapi tidak pada partisi "mbr".

bagian-dapatkan-tipe bagian
perangkat part-get-parttype

Perintah ini memeriksa tabel partisi pada "perangkat" dan mengembalikan tipe tabel partisi
(format) yang digunakan.

Nilai pengembalian umum meliputi: "msdos" (tabel partisi MBR gaya DOS/Windows), "gpt" (a
tabel partisi gaya GPT/EFI). Nilai-nilai lain yang mungkin, meskipun tidak biasa. Lihat "bagian-
init" untuk daftar lengkap.

bagian-init
parttype perangkat bagian-init

Ini membuat tabel partisi kosong pada "perangkat" dari salah satu jenis partisi yang terdaftar
di bawah. Biasanya "parttype" harus berupa "msdos" atau "gpt" (untuk diska besar).

Awalnya tidak ada partisi. Setelah ini, Anda harus memanggil "part-add" untuk masing-masing
partisi diperlukan.

Kemungkinan nilai untuk "parttype" adalah:

efi
gpt Tabel partisi Intel EFI / GPT.

Ini direkomendasikan untuk >= 2 TB partisi yang akan diakses dari Linux dan Intel-
berbasis Mac OS X. Ini juga memiliki kompatibilitas mundur terbatas dengan format "mbr".

mbr
msdos
Format "Master Boot Record" (MBR) PC standar yang digunakan oleh MS-DOS dan Windows. Ini
jenis partisi akan hanya bekerja untuk ukuran perangkat hingga 2 TB. Untuk disk besar kami
merekomendasikan menggunakan "gpt".

Jenis tabel partisi lain yang mungkin berfungsi tetapi tidak didukung meliputi:

ayx label disk AIX.

amiga
rdb Format "Blok Disk Kaku" Amiga.

bsd label disk BSD.

DASD
DASD, digunakan pada mainframe IBM.

dvh volume MIPS/SGI.

mac Format partisi Mac lama. Mac modern menggunakan "gpt".

pc98
Format NEC PC-98, tampaknya umum di Jepang.

matahari Label cakram matahari.

daftar bagian
perangkat daftar bagian

Perintah ini mem-parsing tabel partisi pada "perangkat" dan mengembalikan daftar partisi
ditemukan.

Bidang dalam struktur yang dikembalikan adalah:

nomor_bagian
Nomor partisi, dihitung dari 1.

bagian_mulai
Mulai dari partisi in byte. Untuk mendapatkan sektor, Anda harus membaginya dengan perangkat
ukuran sektor, lihat "blockdev-getss".

bagian_akhir
Akhir partisi dalam byte.

bagian_ukuran
Ukuran partisi dalam byte.

bagian-set-bootable
part-set-perangkat yang dapat di-boot partnum benar|salah

Ini menetapkan flag yang dapat di-boot pada partisi bernomor "partnum" pada "perangkat" perangkat. Perhatikan bahwa
partisi diberi nomor dari 1.

Bendera yang dapat di-boot digunakan oleh beberapa sistem operasi (terutama Windows) untuk menentukan:
partisi untuk boot dari. Ini sama sekali tidak diakui secara universal.

bagian-set-gpt-panduan
panduan part-set-gpt-guid perangkat partnum

Setel GUID partisi GPT bernomor "partnum" ke "guid". Kembalikan kesalahan jika
tabel partisi "perangkat" bukan GPT, atau jika "panduan" bukan GUID yang valid.

bagian-set-gpt-type
panduan partnum perangkat part-set-gpt-type

Setel jenis GUID dari partisi GPT bernomor "partnum" menjadi "guid". Kembalikan kesalahan jika
tabel partisi "perangkat" bukan GPT, atau jika "panduan" bukan GUID yang valid.

Lihat http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs untuk yang bermanfaat
daftar tipe GUID.

bagian-set-mbr-id
part-set-mbr-id perangkat partnum idbyte

Setel byte tipe MBR (juga dikenal sebagai byte ID) dari partisi bernomor "partnum" ke
"idbyte". Perhatikan bahwa jenis byte yang dikutip di sebagian besar dokumentasi sebenarnya adalah heksadesimal
angka, tetapi biasanya didokumentasikan tanpa awalan "0x" yang mungkin membingungkan.

Perhatikan bahwa hanya partisi MBR (gaya DOS lama) yang memiliki tipe byte. Anda akan mendapatkan tidak terdefinisi
hasil untuk tipe tabel partisi lainnya (lihat "part-get-parttype").

bagian-set-nama
bagian-set-name perangkat nama partnum

Ini menetapkan nama partisi pada partisi bernomor "partnum" pada "perangkat" perangkat. Catatan
bahwa partisi diberi nomor dari 1.

Nama partisi hanya dapat diatur pada jenis tabel partisi tertentu. Ini bekerja pada
"gpt" tetapi tidak pada partisi "mbr".

bagian-ke-dev
partisi part-to-dev

Fungsi ini mengambil nama partisi (mis. "/ dev/sdb1") dan menghapus nomor partisi,
mengembalikan nama perangkat (mis. "/ dev/sdb").

Partisi bernama harus ada, misalnya sebagai string yang dikembalikan dari "daftar-partisi".

Lihat juga "part-to-partnum", "device-index".

bagian-ke-partnum
partisi part-to-partnum

Fungsi ini mengambil nama partisi (mis. "/ dev/sdb1") dan mengembalikan nomor partisi
(mis. 1).

Partisi bernama harus ada, misalnya sebagai string yang dikembalikan dari "daftar-partisi".

Lihat juga "part-to-dev".

ping-daemon
ping-daemon

Ini adalah pemeriksaan uji ke daemon guestfs yang berjalan di dalam alat libguestfs.
Memanggil fungsi ini memeriksa apakah daemon merespons pesan ping, tanpa
mempengaruhi daemon atau perangkat blok yang terpasang dengan cara lain.

membacakan
offset jumlah jalur pra-baca

Perintah ini memungkinkan Anda membaca bagian dari file. Bunyinya "hitung" byte file, mulai
di "offset", dari file "path".

Ini mungkin membaca lebih sedikit byte daripada yang diminta. Untuk lebih jelasnya lihat membacakan(2) sistem
panggilan.

Lihat juga "pwrite", "pread-device".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

pra-perangkat
offset jumlah perangkat pra-perangkat

Perintah ini memungkinkan Anda membaca bagian dari perangkat blok. Bunyinya "hitung" byte "perangkat",
mulai dari "penggantian".

Ini mungkin membaca lebih sedikit byte daripada yang diminta. Untuk lebih jelasnya lihat membacakan(2) sistem
panggilan.

Lihat juga "membaca".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

pvchange-uuid
perangkat pvchange-uuid

Hasilkan UUID acak baru untuk "perangkat" volume fisik.

pvchange-uuid-semua
pvchange-uuid-semua

Hasilkan UUID acak baru untuk semua volume fisik.

bahan pvc
membuat perangkat pvc

Ini menciptakan volume fisik LVM pada "perangkat" bernama, di mana "perangkat" biasanya
menjadi nama partisi seperti / Dev / sda1.

hapus
hapus perangkat

Ini menghapus "perangkat" volume fisik sehingga LVM tidak akan mengenalinya lagi.

Implementasinya menggunakan perintah "pvremove" yang menolak untuk menghapus volume fisik yang
berisi grup volume apa pun, jadi Anda harus menghapusnya terlebih dahulu.

ukuran
perangkat pvresize

Ini mengubah ukuran (memperluas atau mengecilkan) volume fisik LVM yang ada agar sesuai dengan ukuran baru
perangkat yang mendasarinya.

ukuran-pvresize
ukuran perangkat ukuran pvresize

Perintah ini sama dengan "pvresize" kecuali memungkinkan Anda untuk menentukan ukuran baru
(dalam byte) secara eksplisit.

pv
pv

Daftar semua volume fisik yang terdeteksi. Ini setara dengan pv(8) perintah.

Ini mengembalikan daftar hanya nama perangkat yang berisi PV (mis. / Dev / sda2).

Lihat juga "pvs-penuh".

pvs-penuh
pvs-penuh

Daftar semua volume fisik yang terdeteksi. Ini setara dengan pv(8) perintah.
Versi "penuh" mencakup semua bidang.

pvuuid
perangkat pvuuid

Perintah ini mengembalikan UUID dari "perangkat" LVM PV.

menulis
offset konten jalur tulis

Perintah ini menulis ke bagian dari file. Itu menulis "konten" buffer data ke file
"path" dimulai dari offset "offset".

Perintah ini mengimplementasikan menulis(2) panggilan sistem, dan panggilan sistem seperti itu mungkin tidak
tuliskan data lengkap yang diminta. Nilai kembalian adalah jumlah byte yang sebenarnya
ditulis ke file. Ini bahkan bisa menjadi 0, meskipun penulisan pendek tidak mungkin untuk reguler
file dalam keadaan biasa.

Lihat juga "pread", "pwrite-device".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

pwrite-perangkat
offset konten perangkat perangkat pwrite

Perintah ini menulis ke bagian perangkat. Itu menulis "konten" buffer data ke "perangkat"
mulai dari offset "offset".

Perintah ini mengimplementasikan menulis(2) panggilan sistem, dan panggilan sistem seperti itu mungkin tidak
tulis data lengkap yang diminta (walaupun penulisan singkat ke perangkat disk dan partisi adalah
mungkin tidak mungkin dengan kernel Linux standar).

Lihat juga "pwrite".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

baca-file
jalur baca-file

Panggilan ini mengembalikan isi file "path" sebagai buffer.

Tidak seperti "cat", fungsi ini dapat menangani file yang berisi ASCII NUL yang disematkan dengan benar
karakter.

garis baca
jalur baca-baris

Kembalikan konten file bernama "path".

Isi file dikembalikan sebagai daftar baris. Trailing "LF" dan "CRLF" karakter
urutannya adalah tidak dikembalikan.

Perhatikan bahwa fungsi ini tidak dapat menangani file biner dengan benar (khususnya, file
berisi karakter "\0" yang diperlakukan sebagai akhir string). Bagi mereka yang perlu Anda gunakan
fungsi "baca-file" dan pisahkan buffer menjadi beberapa baris sendiri.

bacadir
baca dir

Ini mengembalikan daftar entri direktori di direktori "dir".

Semua entri dalam direktori dikembalikan, termasuk "." dan "..". Entrinya adalah tidak
diurutkan, tetapi dikembalikan dalam urutan yang sama dengan sistem file yang mendasarinya.

Juga panggilan ini mengembalikan informasi tipe file dasar tentang setiap file. Bidang "ftyp" akan
mengandung salah satu karakter berikut:

'b' Blok khusus

'c' Char spesial

Direktori 'd'

'f' FIFO (bernama pipa)

'l' Tautan simbolis

'r' File biasa

soket 's'

'u' Jenis file tidak dikenal

'?' Itu bacadir(3) panggilan mengembalikan bidang "d_type" dengan nilai yang tidak terduga

Fungsi ini terutama ditujukan untuk digunakan oleh program. Untuk mendapatkan daftar nama sederhana,
gunakan "ls". Untuk mendapatkan direktori yang dapat dicetak untuk konsumsi manusia, gunakan "ll".

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

tautan baca
jalur tautan baca

Perintah ini membaca target tautan simbolik.

daftar tautan baca
readlinklist path 'nama ...'

Panggilan ini memungkinkan Anda untuk melakukan operasi "readlink" pada banyak file, di mana semua file berada
di direktori "jalan". "names" adalah daftar file dari direktori ini.

Sebagai imbalannya Anda mendapatkan daftar string, dengan korespondensi satu-ke-satu ke daftar "nama".
Setiap string adalah nilai dari tautan simbolik.

Jika tautan baca(2) operasi gagal pada nama apa pun, maka string hasil yang sesuai adalah
string kosong "". Namun seluruh operasi selesai bahkan jika ada
tautan baca(2) kesalahan, sehingga Anda dapat memanggil fungsi ini dengan nama yang Anda tidak tahu apakah
mereka sudah menjadi tautan simbolik (walaupun sedikit kurang efisien).

Panggilan ini ditujukan untuk program yang ingin membuat daftar isi direktori secara efisien
tanpa melakukan banyak perjalanan pulang pergi.

jalan nyata
jalur jalan nyata

Kembalikan nama path absolut kanonik dari "path". Jalur yang dikembalikan tidak memiliki ".", ".."
atau elemen jalur tautan simbolik.

memasang kembali
remount mountpoint [rw:benar|salah]

Panggilan ini memungkinkan Anda untuk mengubah tanda "rw" (hanya baca/baca-tulis) pada yang sudah terpasang
filesystem di "mountpoint", mengubah sistem file readonly menjadi read-write, atau sebaliknya
sebaliknya.

Perhatikan bahwa saat ini Anda harus menyediakan parameter "rw" "opsional". Di masa depan kita mungkin
memungkinkan bendera lain untuk disesuaikan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

hapus-drive
hapus label drive

Fungsi ini secara konseptual kebalikan dari "add-drive-opts". Ini menghapus drive yang
sebelumnya ditambahkan dengan label "label".

Perhatikan bahwa untuk menghapus drive, Anda harus menambahkannya dengan label (lihat opsional
argumen "label" ke "add-drive-opts"). Jika Anda tidak menggunakan label, maka itu tidak mungkin
dihapus.

Anda dapat memanggil fungsi ini sebelum atau setelah meluncurkan pegangan. Jika dipanggil setelah peluncuran,
jika backend mendukungnya, kami mencoba untuk mencabut drive: lihat "HOTPLUGGING" di
tamu(3). disk harus tidak sedang digunakan (mis. dipasang) saat Anda melakukan ini. Kami mencoba mendeteksi
jika disk sedang digunakan dan menghentikan Anda melakukan ini.

hapusxattr
hapus jalur xattr xattr

Panggilan ini menghapus atribut yang diperluas bernama "xattr" dari file "path".

Lihat juga: "lremovexattr", attr(5).

mengubah nama
ganti nama oldpath newpath

Ganti nama file ke tempat baru pada sistem file yang sama. Ini sama dengan Linux
mengubah nama(2) panggilan sistem. Dalam kebanyakan kasus, Anda lebih baik menggunakan "mv".

ubah ukuran2fs
perangkat resize2fs

Ini mengubah ukuran sistem file ext2, ext3 atau ext4 agar sesuai dengan ukuran perangkat yang mendasarinya.

Lihat juga "RESIZE2FS ERRORS" di tamu(3).

ubah ukuran2fs-M
resize2fs-M perangkat

Perintah ini sama dengan "resize2fs", tetapi sistem file diubah ukurannya menjadi minimum
ukuran. Ini bekerja seperti -M opsi untuk perintah "resize2fs".

Untuk mendapatkan ukuran sistem file yang dihasilkan, Anda harus memanggil "tune2fs-l" dan membaca:
Nilai "Ukuran blok" dan "Jumlah blok". Kedua angka ini, dikalikan bersama-sama, memberikan
ukuran yang dihasilkan dari sistem file minimal dalam byte.

Lihat juga "RESIZE2FS ERRORS" di tamu(3).

ubah ukuran2fs-ukuran
resize2fs-ukuran ukuran perangkat

Perintah ini sama dengan "resize2fs" kecuali memungkinkan Anda untuk menentukan ukuran baru
(dalam byte) secara eksplisit.

Lihat juga "RESIZE2FS ERRORS" di tamu(3).

rm
jalan rm

Hapus satu file "path".

rm-f
jalur rm-f

Hapus file "jalur".

Jika file tidak ada, kesalahan itu diabaikan. (Kesalahan lain, misalnya kesalahan I/O atau buruk
jalan, tidak diabaikan)

Panggilan ini tidak dapat menghapus direktori. Gunakan "rmdir" untuk menghapus direktori kosong, atau "rm-rf"
untuk menghapus direktori secara rekursif.

rm-rf
jalur rm-rf

Hapus file atau direktori "path", secara rekursif menghapus konten jika itu adalah direktori.
Ini seperti perintah shell "rm -rf".

adalah rm
jalur rmdir

Hapus direktori tunggal "path".

rmmountpoint
jalur bebas rmmountpoint

Panggilan ini menghapus mountpoint yang sebelumnya dibuat dengan "mkmountpoint". Melihat
"mkmountpoint" untuk detail selengkapnya.

rsync
rsync src dest [arsip: benar|salah] [terhapus: benar|salah]

Panggilan ini dapat digunakan untuk menyalin atau menyinkronkan dua direktori di bawah libguestfs yang sama
menangani. Ini menggunakan rsync(1) program yang menggunakan algoritma cepat yang menghindari penyalinan
file yang tidak perlu.

"src" dan "dest" adalah direktori sumber dan tujuan. File disalin dari "src"
ke "tujuan".

Argumen opsional adalah:

"Arsip"
Mengaktifkan mode arsip. Ini sama dengan melewati --Arsip tandai ke "rsync".

"terhapus"
Hapus file di tujuan yang tidak ada di sumbernya.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

rsync-in
rsync-in remote dest [arsip: benar|salah] [terhapus: benar|salah]

Panggilan ini dapat digunakan untuk menyalin atau menyinkronkan sistem file pada host atau pada remote
komputer dengan sistem file di dalam libguestfs. Ini menggunakan rsync(1) program yang menggunakan
algoritma cepat yang menghindari penyalinan file yang tidak perlu.

Panggilan ini hanya berfungsi jika jaringan diaktifkan. Lihat "mengatur jaringan" atau --jaringan Option
ke berbagai alat seperti ikan tamu(1).

File disalin dari server jauh dan direktori yang ditentukan oleh "jarak jauh" ke
direktori tujuan "tujuan".

Format string server jauh ditentukan oleh rsync(1). Perhatikan bahwa tidak ada cara
untuk memberikan kata sandi atau frasa sandi sehingga target harus diatur agar tidak memerlukannya.

Argumen opsional sama dengan argumen "rsync".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

rsync-out
rsync-out src remote [arsip: benar|salah] [terhapus: benar|salah]

Panggilan ini dapat digunakan untuk menyalin atau menyinkronkan sistem file dalam libguestfs dengan a
sistem file di host atau di komputer jarak jauh. Ini menggunakan rsync(1) program yang menggunakan
algoritma cepat yang menghindari penyalinan file yang tidak perlu.

Panggilan ini hanya berfungsi jika jaringan diaktifkan. Lihat "mengatur jaringan" atau --jaringan Option
ke berbagai alat seperti ikan tamu(1).

File disalin dari direktori sumber "src" ke server dan direktori jarak jauh
ditentukan oleh "jarak jauh".

Format string server jauh ditentukan oleh rsync(1). Perhatikan bahwa tidak ada cara
untuk memberikan kata sandi atau frasa sandi sehingga target harus diatur agar tidak memerlukannya.

Argumen opsional sama dengan argumen "rsync".

Globbing tidak terjadi pada parameter "src". Dalam program yang menggunakan API secara langsung
anda harus memperluas sendiri wildcard (lihat "glob-expand"). Di guestfish Anda dapat menggunakan
perintah "glob" (lihat "glob"), misalnya:

> glob rsync-out /* rsync://remote/

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

scrub-perangkat
perangkat scrub-perangkat

Perintah ini menulis pola di atas "perangkat" untuk membuat pengambilan data lebih sulit.

Ini adalah antarmuka ke menggosok(1) program. Lihat halaman manual itu untuk lebih jelasnya.

file scrub
file scrub

Perintah ini menulis pola di atas file untuk membuat pengambilan data lebih sulit.

Filenya adalah dihapus setelah menggosok.

Ini adalah antarmuka ke menggosok(1) program. Lihat halaman manual itu untuk lebih jelasnya.

ruang bebas gosok
direktori scrub-freespace

Perintah ini membuat direktori "dir" dan kemudian mengisinya dengan file hingga sistem file
penuh, dan menggosok file seperti untuk "scrub-file", dan menghapusnya. Tujuannya adalah untuk
gosok semua ruang kosong pada partisi yang berisi "dir".

Ini adalah antarmuka ke menggosok(1) program. Lihat halaman manual itu untuk lebih jelasnya.

set-tambahkan
menambahkan
set-tambahkan tambahkan

Fungsi ini digunakan untuk menambahkan opsi tambahan ke perintah kernel alat libguestfs
line.

Standarnya adalah "NULL" kecuali diganti dengan menyetel lingkungan "LIBGUESTFS_APPEND"
variabel.

Mengatur "tambahkan" ke "NULL" berarti tidak opsi tambahan dilewatkan (libguestfs selalu menambahkan
beberapa miliknya sendiri).

set-lampirkan-metode
melampirkan-metode
set-lampirkan-metode backend

Setel metode yang digunakan libguestfs untuk terhubung ke daemon backend guestfsd.

Lihat "BACKEND" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "set-backend".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

atur-sinkronisasi otomatis
sinkronisasi otomatis
set-sinkronisasi otomatis benar|salah

Jika "sinkronisasi otomatis" benar, ini akan mengaktifkan sinkronisasi otomatis. Libguestfs akan melakukan upaya terbaik
untuk membuat sistem file konsisten dan tersinkronisasi saat pegangan ditutup (juga jika
program keluar tanpa menutup pegangan).

Ini diaktifkan secara default (sejak libguestfs 1.5.24, sebelumnya dinonaktifkan oleh
bawaan).

set-backend
backend
set-backend backend

Setel metode yang digunakan libguestfs untuk terhubung ke daemon backend guestfsd.

Properti handle ini sebelumnya disebut "attach method".

Lihat "BACKEND" di tamu(3).

set-backend-pengaturan
set-backend-pengaturan nama val

Tambahkan "name=value" ke daftar string pengaturan backend. Namun jika string sudah
ada yang cocok dengan "nama" atau dimulai dengan "nama=", lalu setelan itu diganti.

Lihat "BACKEND" di tamu(3), "SETTING BACKEND" di tamu(3).

set-backend-setting
set-backend-settings 'pengaturan ...'

Tetapkan daftar nol atau lebih pengaturan yang diteruskan ke backend saat ini. Setiap
pengaturan adalah string yang ditafsirkan dengan cara khusus backend, atau diabaikan jika tidak
dipahami oleh backend.

Nilai default adalah daftar kosong, kecuali variabel lingkungan
"LIBGUESTFS_BACKEND_SETTINGS" disetel saat pegangan dibuat. Lingkungan ini
variabel berisi daftar pengaturan yang dipisahkan titik dua.

Panggilan ini menggantikan semua pengaturan backend. Jika Anda ingin mengganti satu pengaturan backend,
lihat "set-backend-setting". Jika Anda ingin menghapus satu pengaturan backend, lihat "menghapus-
pengaturan backend".

Lihat "BACKEND" di tamu(3), "SETTING BACKEND" di tamu(3).

set-cachedir
cachedir
set-cachedir cachedir

Setel direktori yang digunakan oleh pegangan untuk menyimpan cache alat, saat menggunakan supermin
alat. Alat di-cache dan dibagikan di antara semua pegangan yang memiliki kesamaan
ID pengguna yang efektif.

Variabel lingkungan "LIBGUESTFS_CACHEDIR" dan "TMPDIR" mengontrol nilai default: Jika
"LIBGUESTFS_CACHEDIR" diatur, maka itu adalah default. Lain jika "TMPDIR" diatur, maka
itu adalah defaultnya. Lain / var / tmp adalah defaultnya.

set-langsung
langsung
set-langsung benar|salah

Jika tanda mode alat langsung diaktifkan, maka stdin dan stdout diteruskan secara langsung
ke alat setelah diluncurkan.

Salah satu konsekuensinya adalah bahwa pesan log tidak ditangkap oleh perpustakaan dan ditangani oleh
"set-log-message-callback", tetapi langsung ke stdout.

Anda mungkin tidak ingin menggunakan ini kecuali Anda tahu apa yang Anda lakukan.

Standarnya dinonaktifkan.

set-e2attrs
file set-e2attrs attrs [clear:true|false]

Ini menetapkan atau menghapus atribut file "attrs" yang terkait dengan inode fillet.

"attrs" adalah string karakter yang mewakili atribut file. Lihat "get-e2attrs" untuk
daftar atribut yang mungkin. Tidak semua atribut dapat diubah.

Jika opsional boolean "clear" tidak ada atau salah, maka "attrs" yang terdaftar akan diatur dalam
inode.

Jika "clear" benar, maka "attrs" yang terdaftar akan dihapus di inode.

Dalam kedua kasus, atribut lain yang tidak ada dalam string "attrs" dibiarkan tidak berubah.

Atribut-atribut ini hanya ada ketika file berada di sistem file ext2/3/4.
Menggunakan panggilan ini pada jenis sistem file lain akan menghasilkan kesalahan.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

set-e2generasi
pembuatan file set-e2generation

Ini menetapkan pembuatan file ext2 dari suatu file.

Lihat "get-e2generation".

set-e2label
set-e2label label perangkat

Ini menetapkan label sistem file ext2/3/4 dari sistem file pada "perangkat" menjadi "label".
Label sistem file dibatasi hingga 16 karakter.

Anda dapat menggunakan "tune2fs-l" atau "get-e2label" untuk mengembalikan label yang ada pada
berkas sistem.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "set-label".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

set-e2uuid
set-e2uuid perangkat uuid

Ini menetapkan UUID sistem file ext2/3/4 dari sistem file pada "perangkat" menjadi "uuid". Itu
format UUID dan alternatif seperti "jelas", "acak" dan "waktu" dijelaskan dalam
itu tune2fs(8) halaman manual.

Anda dapat menggunakan "vfs-uuid" untuk mengembalikan UUID sistem file yang ada.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "set-uuid" sebagai gantinya.

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

set-hv
hv
set-hv hv

Atur biner hypervisor yang akan kita gunakan. Hypervisor bergantung pada backend, tetapi adalah
biasanya lokasi hypervisor qemu/KVM. Untuk backend uml, ini adalah lokasinya
dari biner "linux" atau "vmlinux".

Default dipilih ketika perpustakaan dikompilasi oleh skrip configure.

Anda juga dapat menimpanya dengan menyetel variabel lingkungan "LIBGUESTFS_HV".

Perhatikan bahwa Anda harus memanggil fungsi ini sedini mungkin setelah membuat pegangan.
Ini karena beberapa operasi pra-peluncuran bergantung pada pengujian fitur qemu (dengan menjalankan
"qemu -bantuan"). Jika biner qemu berubah, kami tidak menguji ulang fitur, dan Anda mungkin melihat
hasil yang tidak konsisten. Menggunakan variabel lingkungan "LIBGUESTFS_HV" adalah yang paling aman
karena itu mengambil biner qemu pada saat yang sama saat pegangan dibuat.

set-pengidentifikasi
identifier
set-identifier pengenal

Ini adalah string informatif yang dapat diatur secara opsional oleh penelepon di pegangan. Dia
dicetak di berbagai tempat, memungkinkan pegangan saat ini diidentifikasi dalam debugging
output.

Satu tempat penting adalah saat pelacakan diaktifkan. Jika string pengenal bukan kosong
string, lalu lacak pesan berubah dari ini:

libguestfs: jejak: get_tmpdir
libguestfs: jejak: get_tmpdir = "/ Tmp"

ini:

libguestfs: jejak: ID: get_tmpdir
libguestfs: jejak: ID: get_tmpdir = "/ Tmp"

di mana "ID" adalah string pengenal yang disetel oleh panggilan ini.

Pengenal hanya boleh berisi karakter ASCII alfanumerik, garis bawah, dan tanda minus.
Standarnya adalah string kosong.

Lihat juga "set-program", "set-trace", "get-identifier".

set-label
set-label label yang dapat dipasang

Atur label sistem file pada "mountable" menjadi "label".

Hanya beberapa jenis sistem file yang mendukung label, dan libguestfs hanya mendukung pengaturan label
subset dari ini.

ext2, ext3, ext4
Label dibatasi hingga 16 byte.

NTFS
Label dibatasi hingga 128 karakter unicode.

XFS Label dibatasi hingga 12 byte. Sistem file tidak boleh di-mount saat mencoba
mengatur labelnya.

btrfs
Label dibatasi hingga 255 byte dan beberapa karakter tidak diperbolehkan. Mengatur
label pada subvolume btrfs akan mengatur label pada sistem file induknya. Itu
filesystem tidak boleh di-mount ketika mencoba mengatur label.

fat Label dibatasi hingga 11 byte.

Jika tidak ada dukungan untuk mengubah label untuk jenis sistem file yang ditentukan,
set_label akan gagal dan menetapkan errno sebagai ENOTSUP.

Untuk membaca label pada sistem file, panggil "vfs-label".

set-libvirt-diminta-kredensial
set-libvirt-requested-credential indeks kredensial

Setelah meminta kredensial "indeks"' dari pengguna, panggil fungsi ini untuk meneruskan
jawab kembali ke libvirt.

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

set-libvirt-didukung-kredensial
set-libvirt-supported-credentials 'kredensial ...'

Panggil fungsi ini sebelum menyetel pengendali acara untuk "GUESTFS_EVENT_LIBVIRT_AUTH", ke
berikan daftar jenis kredensial yang dapat diproses oleh program.

Daftar "creds" harus berupa daftar string yang tidak kosong. Kemungkinan string adalah:

"nama pengguna"
"nama asli"
"bahasa"
"semoga"
"frasa sandi"
"echoprompt"
"noechoprompt"
"dunia"
"luar"

Lihat dokumentasi libvirt untuk mengetahui arti dari jenis kredensial ini.

Lihat "Otentikasi LIBVIRT" di tamu(3) untuk dokumentasi dan kode contoh.

set-memsize
ukuran
set-memukur memsize

Ini menetapkan ukuran memori dalam megabyte yang dialokasikan ke hypervisor. Ini hanya memiliki
efek jika dipanggil sebelum "peluncuran".

Anda juga dapat mengubah ini dengan mengatur variabel lingkungan "LIBGUESTFS_MEMSIZE" sebelumnya
pegangan dibuat.

Untuk informasi lebih lanjut tentang arsitektur libguestfs, lihat tamu(3).

set-jaringan
jaringan
set-jaringan benar|salah

Jika "jaringan" benar, maka jaringan diaktifkan di alat libguestfs. Itu
defaultnya salah.

Ini mempengaruhi apakah perintah dapat mengakses jaringan (lihat "MENJALANKAN PERINTAH" di
tamu(3)).

Anda harus memanggil ini sebelum memanggil "peluncuran", jika tidak maka tidak akan berpengaruh.

set-jalur
path
jalur pencarian set-path

Setel jalur yang dicari libguestfs untuk kernel dan initrd.img.

Standarnya adalah "$libdir/guestfs" kecuali diganti dengan mengatur "LIBGUESTFS_PATH"
variabel lingkungan.

Menyetel "jalur" ke "NULL" mengembalikan jalur default.

set-pgroup
grup p
set-pgroup benar|salah

Jika "pgroup" benar, proses anak ditempatkan ke dalam grup proses mereka sendiri.

Hasil praktis dari ini adalah sinyal seperti "SIGINT" (dari pengguna yang menekan "^C")
tidak akan diterima oleh proses anak.

Default untuk flag ini adalah false, karena biasanya Anda ingin "^C" mematikan subproses.
Guestfish menyetel tanda ini ke true saat digunakan secara interaktif, sehingga "^C" dapat membatalkan lama-
menjalankan perintah dengan anggun (lihat "pembatalan pengguna").

set-program
program
program set-program

Tetapkan nama program. Ini adalah string informatif yang dapat dipilih oleh program utama secara opsional
diatur dalam pegangan.

Saat pegangan dibuat, nama program di pegangan diatur ke nama dasar dari
"argv[0]". Jika itu tidak mungkin, itu disetel ke string kosong (tetapi tidak pernah "NULL").

set-qemu
qemu
set-qemu hv

Atur binary hypervisor (biasanya qemu) yang akan kita gunakan.

Default dipilih ketika perpustakaan dikompilasi oleh skrip configure.

Anda juga dapat menimpanya dengan menyetel variabel lingkungan "LIBGUESTFS_HV".

Mengatur "hv" ke "NULL" mengembalikan biner qemu default.

Perhatikan bahwa Anda harus memanggil fungsi ini sedini mungkin setelah membuat pegangan.
Ini karena beberapa operasi pra-peluncuran bergantung pada pengujian fitur qemu (dengan menjalankan
"qemu -bantuan"). Jika biner qemu berubah, kami tidak menguji ulang fitur, dan Anda mungkin melihat
hasil yang tidak konsisten. Menggunakan variabel lingkungan "LIBGUESTFS_HV" adalah yang paling aman
karena itu mengambil biner qemu pada saat yang sama saat pegangan dibuat.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "set-hv".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

set-pemulihan-proc
proses pemulihan
set-recovery-proc benar|salah

Jika ini disebut dengan parameter "salah" maka "peluncuran" tidak membuat pemulihan
proses. Tujuan dari proses pemulihan adalah untuk menghentikan proses hypervisor yang tidak terkendali di
kasus di mana program utama dibatalkan secara tiba-tiba.

Ini hanya berpengaruh jika dipanggil sebelum "peluncuran", dan defaultnya adalah true.

Tentang satu-satunya waktu ketika Anda ingin menonaktifkan ini adalah jika proses utama akan bercabang
dirinya ke latar belakang ("daemonize" itu sendiri). Dalam hal ini proses pemulihan berpikir
bahwa program utama telah menghilang dan membunuh hypervisor, yang tidak terlalu
membantu.

set-selinux
selinux
set-selinux benar|salah

Ini menetapkan flag selinux yang diteruskan ke alat saat boot. Standarnya adalah
"selinux=0" (dinonaktifkan).

Perhatikan bahwa jika SELinux diaktifkan, selalu dalam mode Permisif ("menegakkan = 0").

Untuk informasi lebih lanjut tentang arsitektur libguestfs, lihat tamu(3).

set-smp
SMP
set-smp smp

Ubah jumlah CPU virtual yang ditetapkan ke alat. Standarnya adalah 1.
Meningkatkan ini dapat meningkatkan kinerja, meskipun seringkali tidak berpengaruh.

Fungsi ini harus dipanggil sebelum "diluncurkan".

set-tmpdir
tmpdir
set-tmpdir tmpdir

Atur direktori yang digunakan oleh pegangan untuk menyimpan file-file sementara.

Variabel lingkungan "LIBGUESTFS_TMPDIR" dan "TMPDIR" mengontrol nilai default: Jika
"LIBGUESTFS_TMPDIR" diatur, maka itu adalah default. Lain jika "TMPDIR" disetel, maka itu
adalah default. Lain / Tmp adalah defaultnya.

set-jejak
jejak
set-trace benar|salah

Jika tanda jejak perintah diatur ke 1, maka libguestfs memanggil, parameter, dan mengembalikan nilai
dilacak.

Jika Anda ingin melacak panggilan C API ke libguestfs (dan perpustakaan lain) maka mungkin a
cara yang lebih baik adalah dengan menggunakan eksternal jejak(1) perintah.

Jejak perintah dinonaktifkan kecuali variabel lingkungan "LIBGUESTFS_TRACE" didefinisikan
dan atur ke 1.

Pesan jejak biasanya dikirim ke "stderr", kecuali Anda mendaftarkan panggilan balik untuk mengirimnya
di tempat lain (lihat "set-event-callback").

set-uuid
set-uuid perangkat uuid

Setel UUID sistem file pada "perangkat" ke "uuid". Jika ini gagal dan kesalahannya adalah ENOTSUP,
berarti tidak ada dukungan untuk mengubah UUID untuk jenis yang ditentukan
berkas sistem.

Hanya beberapa jenis sistem file yang mendukung pengaturan UUID.

Untuk membaca UUID pada sistem file, panggil "vfs-uuid".

set-uuid-acak
set-uuid-perangkat acak

Setel UUID sistem file pada "perangkat" ke UUID acak. Jika ini gagal dan kesalahannya adalah
ENOTSUP, artinya tidak ada dukungan untuk mengubah UUID untuk jenis
sistem file yang ditentukan.

Hanya beberapa jenis sistem file yang mendukung pengaturan UUID.

Untuk membaca UUID pada sistem file, panggil "vfs-uuid".

set-verbose
bertele-tele
set-verbose benar|salah

Jika "verbose" benar, ini akan mengaktifkan pesan verbose.

Pesan verbose dinonaktifkan kecuali variabel lingkungan "LIBGUESTFS_DEBUG" adalah
ditentukan dan disetel ke 1.

Pesan verbose biasanya dikirim ke "stderr", kecuali jika Anda mendaftarkan panggilan balik untuk mengirim
mereka di tempat lain (lihat "set-event-callback").

setkon
konteks setcon

Ini menetapkan konteks keamanan SELinux daemon ke string "konteks".

Lihat dokumentasi tentang SELINUX di tamu(3).

setxattr
setxattr xattr val vallen jalur

Panggilan ini menetapkan atribut yang diperluas bernama "xattr" dari file "path" ke nilai "val"
(panjangnya "vallen"). Nilainya adalah data 8 bit sewenang-wenang.

Lihat juga: "lsetxattr", attr(5).

sfdisk
perangkat sfdisk cyls mengepalai sektor 'garis ...'

Ini adalah antarmuka langsung ke sfdisk(8) program untuk membuat partisi di blok
perangkat.

"perangkat" harus berupa perangkat blok, misalnya / Dev / sda.

"silinder", "kepala" dan "sektor" adalah jumlah silinder, kepala, dan sektor pada
perangkat, yang diteruskan langsung ke sfdisk sebagai -C, -H dan -S parameter. Jika kamu lulus
0 untuk semua ini, maka parameter yang sesuai dihilangkan. Biasanya untuk 'besar'
disk, Anda dapat meneruskan 0 untuk ini, tetapi untuk disk kecil (berukuran floppy), sfdisk (atau
bukan, kernel) tidak dapat menemukan geometri yang tepat dan Anda harus memberitahukannya.

"lines" adalah daftar baris yang kita masukkan ke "sfdisk". Untuk informasi lebih lanjut lihat
sfdisk(8) halaman manual.

Untuk membuat satu partisi yang menempati seluruh disk, Anda akan melewatkan "baris" sebagai satu
daftar elemen, ketika elemen tunggal menjadi string "," (koma).

Lihat juga: "sfdisk-l", "sfdisk-N", "part-init"

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "part-add".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

sfdiskM
sfdiskM perangkat 'baris ...'

Ini adalah antarmuka yang disederhanakan untuk perintah "sfdisk", di mana ukuran partisi adalah
ditentukan dalam megabita saja (dibulatkan ke silinder terdekat) dan Anda tidak perlu
tentukan parameter cyls, head, dan sektor yang jarang jika pernah digunakan.

Lihat juga: "sfdisk", the sfdisk(8) halaman manual dan "part-disk"

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "part-add".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

sfdisk-N
sfdisk-N perangkat partnum cyls memimpin garis sektor

Ini berjalan sfdisk(8) opsi untuk memodifikasi hanya satu partisi "n" (catatan: "n" dihitung dari
1).

Untuk parameter lainnya, lihat "sfdisk". Anda biasanya harus melewati 0 untuk cyls/heads/sektor
parameter.

Lihat juga: "tambahan sebagian"

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "part-add".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

sfdisk-disk-geometri
perangkat sfdisk-disk-geometri

Ini menampilkan geometri disk dari "perangkat" yang dibaca dari tabel partisi. Terutama di
kasus di mana perangkat blok yang mendasarinya telah diubah ukurannya, ini bisa berbeda dari
ide kernel tentang geometri (lihat "sfdisk-kernel-geometry").

Hasilnya dalam format yang dapat dibaca manusia, dan tidak dirancang untuk diuraikan.

sfdisk-kernel-geometri
perangkat sfdisk-kernel-geometry

Ini menampilkan ide kernel tentang geometri "perangkat".

Hasilnya dalam format yang dapat dibaca manusia, dan tidak dirancang untuk diuraikan.

sfdisk-l
perangkat sfdisk-l

Ini menampilkan tabel partisi pada "perangkat", dalam output yang dapat dibaca manusia dari
sfdisk(8) perintah. Itu tidak dimaksudkan untuk diuraikan.

Lihat juga: "daftar bagian"

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "daftar bagian".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

sh
perintah sh

Panggilan ini menjalankan perintah dari sistem file tamu melalui tamu / Bin / sh.

Ini seperti "perintah", tetapi meneruskan perintah ke:

/ Bin / sh -c "perintah"

Tergantung pada shell tamu, ini biasanya menghasilkan wildcard yang diperluas, shell
ekspresi yang diinterpolasi dan sebagainya.

Semua ketentuan tentang "perintah" berlaku untuk panggilan ini.

garis-sh
perintah sh-lines

Ini sama dengan "sh", tetapi membagi hasilnya menjadi daftar baris.

Lihat juga: "baris perintah"

penutupan
penutupan

Ini adalah kebalikan dari "peluncuran". Ini melakukan shutdown backend secara teratur
proses. Jika tanda sinkronisasi otomatis diatur (yang merupakan default) maka gambar disk adalah
disinkronkan.

Jika subproses keluar dengan kesalahan maka fungsi ini akan mengembalikan kesalahan, yang
harus tidak diabaikan (ini mungkin menunjukkan bahwa gambar disk tidak dapat dihapus
dengan baik).

Aman untuk memanggil ini beberapa kali. Panggilan ekstra diabaikan.

Panggilan ini tidak tidak tutup atau lepaskan pegangannya. Anda masih perlu menelepon "tutup"
setelah itu.

"close" akan memanggil ini jika Anda tidak melakukannya secara eksplisit, tetapi perhatikan bahwa kesalahan apa pun akan diabaikan
dalam hal itu.

tidur
detik tidur

Tidur selama "detik" detik.

Stat
jalur statistik

Mengembalikan informasi file untuk "jalur" yang diberikan.

Ini sama dengan Stat(2) panggilan sistem.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "statns".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

statistik
jalur statistik

Mengembalikan informasi file untuk "jalur" yang diberikan.

Ini sama dengan Stat(2) panggilan sistem.

statvfs
jalur statvfs

Mengembalikan statistik sistem file untuk sistem file apa pun yang dipasang. "path" harus berupa file atau
direktori di sistem file yang dipasang (biasanya itu adalah titik pemasangan itu sendiri, tetapi itu
tidak perlu).

Ini sama dengan statvfs(2) panggilan sistem.

string
jalur senar

Ini menjalankan string(1) perintah pada file dan mengembalikan daftar string yang dapat dicetak
ditemukan.

Perintah "strings", di masa lalu, memiliki masalah dengan mem-parsing file yang tidak dipercaya. Ini
dimitigasi dalam versi libguestfs saat ini, tetapi lihat "CVE-2014-8484" di tamu(3).

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

string-e
jalur penyandian string-e

Ini seperti perintah "string", tetapi memungkinkan Anda untuk menentukan pengkodean string yang
dicari di file sumber "path".

Pengkodean yang diizinkan adalah:

s Karakter 7-bit-byte tunggal seperti ASCII dan bagian yang kompatibel dengan ASCII dari ISO-8859-X
(inilah yang digunakan "string").

S Karakter tunggal 8-bit-byte.

b string big endian 16-bit seperti yang dikodekan dalam UTF-16BE atau UCS-2BE.

l (huruf kecil L)
Little endian 16-bit seperti UTF-16LE dan UCS-2LE. Ini berguna untuk memeriksa
binari di tamu Windows.

B 32-bit big endian seperti UCS-4BE.

L 32-bit little endian seperti UCS-4LE.

String yang dikembalikan ditranskode ke UTF-8.

Perintah "strings", di masa lalu, memiliki masalah dengan mem-parsing file yang tidak dipercaya. Ini
dimitigasi dalam versi libguestfs saat ini, tetapi lihat "CVE-2014-8484" di tamu(3).

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

swapoff-perangkat
perangkat swapoff-perangkat

Perintah ini menonaktifkan perangkat swap alat libguestfs atau partisi bernama "perangkat".
Lihat "swapon-perangkat".

swapoff-file
file swapoff

Perintah ini menonaktifkan swap alat libguestfs pada file.

label swapoff
label label swapoff

Perintah ini menonaktifkan swap alat libguestfs pada partisi swap berlabel.

swapoff-uuid
swapoff-uuid uuid

Perintah ini menonaktifkan partisi swap alat libguestfs dengan UUID yang diberikan.

swapon-perangkat
perangkat swapon-perangkat

Perintah ini memungkinkan alat libguestfs untuk menggunakan perangkat swap atau partisi bernama
"perangkat". Memori yang ditingkatkan tersedia untuk semua perintah, misalnya yang dijalankan
menggunakan "perintah" atau "sh".

Perhatikan bahwa Anda tidak boleh menukar ke partisi swap tamu yang ada kecuali Anda tahu apa yang Anda
sedang melakukan. Mereka mungkin berisi informasi hibernasi, atau informasi lain yang tamu
tidak ingin kamu menjadi sampah. Anda juga berisiko membocorkan informasi tentang tuan rumah kepada tamu
cara ini. Sebagai gantinya, lampirkan perangkat host baru ke tamu dan tukar itu.

swapon-file
file swapon-file

Perintah ini memungkinkan swap ke file. Lihat "swapon-device" untuk catatan lainnya.

label swapon
label label swapon

Perintah ini memungkinkan swap ke partisi swap berlabel. Lihat "swapon-device" untuk yang lainnya
catatan.

swapon-uuid
swapon-uuid uuid

Perintah ini memungkinkan swap ke partisi swap dengan UUID yang diberikan. Lihat "swapon-perangkat"
untuk catatan lainnya.

sinkronisasi
sinkronisasi

Tindakan ini akan menyinkronkan disk, sehingga penulisan apa pun dialirkan ke image disk yang mendasarinya.

Anda harus selalu memanggil ini jika Anda telah memodifikasi gambar disk, sebelum menutup pegangan.

syslinux
perangkat syslinux [direktori:..]

Instal bootloader SYSLINUX di "perangkat".

Parameter perangkat harus berupa seluruh disk yang diformat sebagai sistem file FAT, atau sebagai
partisi diformat sebagai sistem file FAT. Dalam kasus terakhir, partisi harus
ditandai sebagai "aktif" ("part-set-bootable") dan Master Boot Record harus diinstal (mis.
menggunakan "pwrite-device") pada sektor pertama dari seluruh disk. Paket SYSLINUX datang
dengan beberapa Master Boot Record yang sesuai. Lihat syslinux(1) halaman manual untuk lebih lanjut
informasi.

Argumen opsional adalah:

direktori
Instal SYSLINUX di subdirektori bernama, bukan di direktori root dari
sistem file FAT.

Konfigurasi tambahan dapat diberikan ke SYSLINUX dengan menempatkan file bernama syslinux.cfg
pada sistem file FAT, baik di direktori root, atau di bawah direktori jika itu opsional
argumen sedang digunakan. Untuk informasi lebih lanjut tentang isi file ini, lihat
syslinux(1).

Lihat juga "extlinux".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

ekor
jalur ekor

Perintah ini mengembalikan hingga 10 baris terakhir file sebagai daftar string.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

ekor-n
jalur tail-n nrlines

Jika parameter "nrlines" adalah angka positif, ini mengembalikan baris "nrlines" terakhir dari
file "jalan".

Jika parameter "nrlines" adalah angka negatif, ini mengembalikan baris dari file "path",
dimulai dengan baris ke-"-nrlines".

Jika parameter "nrlines" adalah nol, ini mengembalikan daftar kosong.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

tar-in
tar-in-opts
tar-in (tarfile|-) direktori [kompres:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Perintah ini mengunggah dan membongkar file lokal "tarfile" ke dalam direktori.

Bendera "kompres" opsional mengontrol kompresi. Jika tidak diberikan, maka inputnya harus
file tar yang tidak terkompresi. Jika tidak, salah satu dari string berikut dapat diberikan untuk dipilih:
jenis kompresi file input: "kompres", "gzip", "bzip2", "xz", "lzop". (Catatan
bahwa tidak semua build libguestfs akan mendukung semua jenis kompresi ini).

Argumen opsional lainnya adalah:

"xattr"
Jika disetel ke true, atribut yang diperluas akan dipulihkan dari file tar.

"selinux"
Jika disetel ke true, konteks SELinux dipulihkan dari file tar.

"acls"
Jika disetel ke true, POSIX ACL dipulihkan dari file tar.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tar keluar
tar-out-opts
direktori tar-out (tarfile|-) [kompres:..] [numericowner:true|false] [tidak termasuk:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Perintah ini mengemas konten direktori dan mengunduhnya ke file lokal "tarfile".

Bendera "kompres" opsional mengontrol kompresi. Jika tidak diberikan, maka outputnya adalah
file tar yang tidak terkompresi. Jika tidak, salah satu dari string berikut dapat diberikan untuk dipilih:
jenis kompresi file keluaran: "kompres", "gzip", "bzip2", "xz", "lzop". (Catatan
bahwa tidak semua build libguestfs akan mendukung semua jenis kompresi ini).

Argumen opsional lainnya adalah:

"tidak termasuk"
Daftar wildcard. File dikecualikan jika cocok dengan salah satu wildcard.

"pemilik angka"
Jika disetel ke true, file tar keluaran akan berisi nomor UID/GID alih-alih pengguna/grup
nama.

"xattr"
Jika disetel ke true, atribut yang diperluas disimpan di tar keluaran.

"selinux"
Jika disetel ke true, konteks SELinux disimpan di tar keluaran.

"acls"
Jika disetel ke true, POSIX ACL disimpan di tar keluaran.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tgz-in
tgz-in (tarball|-) direktori

Perintah ini mengunggah dan membongkar file lokal "tarball" (a gzip dikompresi file tar) ke dalam
direktori.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tar-in".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

tgz-keluar
direktori tgz-out (tarball|-)

Perintah ini mengemas konten direktori dan mengunduhnya ke file lokal "tarball".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tar-out".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

menyentuh
jalur sentuh

Sentuhan bertindak seperti menyentuh(1) perintah. Ini dapat digunakan untuk memperbarui cap waktu pada file,
atau, jika file tidak ada, untuk membuat file panjang nol baru.

Perintah ini hanya berfungsi pada file biasa, dan akan gagal pada jenis file lain seperti
direktori, tautan simbolik, blok khusus, dll.

memotong
memotong jalan

Perintah ini memotong "jalur" ke file dengan panjang nol. File harus sudah ada.

ukuran terpotong
ukuran jalur ukuran terpotong

Perintah ini memotong "jalur" ke ukuran "ukuran" byte. File harus sudah ada.

Jika ukuran file saat ini kurang dari "ukuran" maka file tersebut diperluas ke yang diperlukan
ukuran dengan nol byte. Ini membuat file jarang (mis. blok disk tidak dialokasikan untuk
file sampai Anda menulisnya). Untuk membuat file nol yang tidak jarang, gunakan "fallocate64"
sebagai gantinya.

tune2fs
perangkat tune2fs [force:true|false] [maxmountcount:N] [mountcount:N] [errorbehavior:..] [group:N] [intervalbetweenchecks:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N ] [pengguna:N]

Panggilan ini memungkinkan Anda untuk menyesuaikan berbagai parameter sistem file dari ext2/ext3/ext4
sistem file yang disebut "perangkat".

Parameter opsional adalah:

"memaksa"
Paksa tune2fs untuk menyelesaikan operasi bahkan dalam menghadapi kesalahan. Ini sama
sebagai opsi tune2fs "-f".

"jumlah maxmount"
Atur jumlah mount setelah sistem file diperiksa oleh e2fsck.dll(8). Jika ini
adalah 0 maka jumlah tunggangan diabaikan. Ini sama dengan tune2fs "-c"
.

"jumlah gunung"
Atur berapa kali sistem file telah dipasang. Ini sama dengan
opsi tune2fs "-C".

"perilaku kesalahan"
Ubah perilaku kode kernel ketika kesalahan terdeteksi. Nilai yang mungkin
saat ini adalah: "lanjutkan", "remount-ro", "panik". Dalam praktiknya, opsi ini tidak
benar-benar membuat perbedaan, terutama untuk kesalahan penulisan.

Ini sama dengan opsi "-e" tune2fs.

"kelompok"
Setel grup yang dapat menggunakan blok sistem file yang dicadangkan. Ini sama dengan
tune2fs "-g" pilihan kecuali bahwa itu hanya dapat ditentukan sebagai angka.

"intervalantarpemeriksaan"
Sesuaikan waktu maksimal antara dua pemeriksaan sistem file (dalam detik). Jika pilihannya adalah
diteruskan sebagai 0 maka pemeriksaan yang bergantung pada waktu dinonaktifkan.

Ini sama dengan opsi "-i" tune2fs.

"persentase blok yang dipesan"
Tetapkan persentase sistem file yang hanya dapat dialokasikan oleh hak istimewa
proses. Ini sama dengan opsi "-m" tune2fs.

"direktori yang dipasang terakhir"
Setel direktori yang terakhir dipasang. Ini sama dengan opsi "-M" tune2fs.

"reservedblockscount" Mengatur jumlah blok sistem file yang dicadangkan. Ini sama dengan
opsi tune2fs "-r".
"pengguna"
Tetapkan pengguna yang dapat menggunakan blok sistem file yang dicadangkan. Ini sama dengan
tune2fs "-u" pilihan kecuali bahwa itu hanya dapat ditentukan sebagai angka.

Untuk mendapatkan nilai parameter sistem file saat ini, lihat "tune2fs-l". Untuk detail yang tepat
tentang cara kerja tune2fs, lihat tune2fs(8) halaman manual.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

tune2fs-l
perangkat tune2fs-l

Ini mengembalikan konten superblok sistem file ext2, ext3 atau ext4 pada "perangkat".

Ini sama dengan menjalankan "tune2fs -l device". Lihat tune2fs(8) halaman manual untuk lebih jelasnya.
Daftar bidang yang dikembalikan tidak ditentukan dengan jelas, dan bergantung pada kedua versi
"tune2fs" tempat libguestfs dibangun, dan sistem file itu sendiri.

terima kasih
txz-in (tarball|-) direktori

Perintah ini mengunggah dan membongkar file lokal "tarball" (dan xz dikompresi file tar) ke dalam
direktori.

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tar-in".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

terima kasih
direktori txz-out (tarball|-)

Perintah ini mengemas konten direktori dan mengunduhnya ke file lokal "tarball" (sebagai
arsip tar terkompresi xz).

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tar-out".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

umask
topeng umask

Fungsi ini mengatur mask yang digunakan untuk membuat file baru dan node perangkat ke "mask & 0777".

Nilai umask tipikal adalah 022 yang membuat file baru dengan izin seperti
"-rw-r--r--" atau "-rwxr-xr-x", dan 002 yang membuat file baru dengan izin seperti
"-rw-rw-r--" atau "-rwxrwxr-x".

Umask default adalah 022. Ini penting karena ini berarti direktori dan perangkat
node akan dibuat dengan mode 0644 atau 0755 bahkan jika Anda menentukan 0777.

Lihat juga "get-umask", umask(2), "mknod", "mkdir".

Panggilan ini mengembalikan umask sebelumnya.

jumlah
unmount
umount-opts
umount pathordevice [force:true|false] [lazyunmount:true|false]

Ini meng-unmount sistem file yang diberikan. Sistem file dapat ditentukan baik oleh
mountpoint (jalur) atau perangkat yang berisi sistem file.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

umount-semua
unmount-semua
umount-semua

Ini meng-unmount semua sistem file yang dipasang.

Beberapa pemasangan internal tidak dilepas oleh panggilan ini.

umount-lokal
umount-local [coba lagi: benar|salah]

Jika libguestfs mengekspor sistem file pada titik mount lokal, maka ini akan melepasnya.

Lihat "GUNUNG LOKAL" di tamu(3) untuk dokumentasi lengkap.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

mengunggah
unggah (nama file|-) namafile jarak jauh

Unggah file lokal nama file untuk namafile jarak jauh pada sistem file.

nama file juga bisa menjadi pipa bernama.

Lihat juga "unduh".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

unggah-offset
unggah-offset (nama file|-) offset namafile jarak jauh

Unggah file lokal nama file untuk namafile jarak jauh pada sistem file.

namafile jarak jauh ditimpa mulai dari byte "offset" yang ditentukan. Niatnya adalah
untuk menimpa bagian dari file atau perangkat yang ada, meskipun jika file yang tidak ada
ditentukan maka dibuat dengan "lubang" sebelum "offset". Ukuran data yang ditulis
tersirat dalam ukuran sumber nama file.

Perhatikan bahwa tidak ada batasan jumlah data yang dapat diunggah dengan panggilan ini,
tidak seperti dengan "pwrite", dan panggilan ini selalu menulis jumlah penuh kecuali terjadi kesalahan.

Lihat juga "upload", "pwrite".

Gunakan "-" sebagai ganti nama file untuk membaca/menulis dari stdin/stdout.

batalkan pengguna
batalkan pengguna

Fungsi ini membatalkan operasi pengunggahan atau pengunduhan saat ini.

Tidak seperti kebanyakan panggilan libguestfs lainnya, fungsi ini aman untuk sinyal dan aman untuk thread. Kamu bisa
panggil saja dari penangan sinyal atau dari utas lain, tanpa perlu melakukan penguncian apa pun.

Transfer yang sedang berlangsung (jika ada) akan segera dihentikan, dan akan
mengembalikan kesalahan. Errno (lihat "guestfs_last_errno") disetel ke "EINTR", sehingga Anda dapat menguji
untuk ini untuk mengetahui apakah operasi dibatalkan atau gagal karena kesalahan lain.

Tidak ada pembersihan yang dilakukan: misalnya, jika file sedang diunggah maka setelah pembatalan
mungkin ada file yang diunggah sebagian. Adalah tanggung jawab penelepon untuk membersihkan jika
perlu.

Ada dua tempat umum yang mungkin Anda sebut "pembatalan pengguna":

Dalam program berbasis teks interaktif, Anda dapat memanggilnya dari pengendali sinyal "SIGINT" jadi
bahwa menekan "^C" membatalkan operasi saat ini. (Anda juga perlu menelepon
"guestfs_set_pgroup" sehingga proses anak tidak menerima sinyal "^C").

Dalam program grafis, ketika utas utama menampilkan bilah kemajuan dengan pembatalan
hubungkan tombol batal untuk memanggil fungsi ini.

peralatan
utimens path atsecs mtsecs mtnsecs

Perintah ini mengatur stempel waktu file dengan presisi nanodetik.

"atsecs, atnsecs" adalah waktu akses terakhir (atime) dalam detik dan nanodetik dari zaman.

"mtsecs, mtnsecs" adalah waktu modifikasi terakhir (mtime) dalam detik dan nanodetik dari
masa.

Jika bidang *nsecs berisi nilai khusus "-1" maka stempel waktu yang sesuai adalah
diatur ke waktu saat ini. (Bidang *secs diabaikan dalam kasus ini).

Jika bidang *nsecs berisi nilai khusus "-2" maka stempel waktu yang sesuai adalah
dibiarkan tidak berubah. (Bidang *secs diabaikan dalam kasus ini).

nama panggilan
nama panggilan

Ini mengembalikan versi kernel alat, di mana ini tersedia. Ini
informasi hanya berguna untuk debugging. Tidak ada dalam struktur yang dikembalikan yang ditentukan oleh
API.

versi
versi

Kembalikan nomor versi libguestfs yang ditautkan dengan program.

Perhatikan bahwa karena penautan dinamis, ini belum tentu versi libguestfs
yang Anda kompilasi melawan. Anda dapat mengkompilasi program, dan kemudian saat runtime secara dinamis
link terhadap yang sama sekali berbeda libguestfs.so Perpustakaan.

Panggilan ini telah ditambahkan di versi 1.0.58. Di versi libguestfs sebelumnya tidak ada
cara untuk mendapatkan nomor versi. Dari kode C Anda dapat menggunakan fungsi tautan dinamis untuk menemukan
keluar jika simbol ini ada (jika tidak, maka itu adalah versi sebelumnya).

Panggilan mengembalikan struktur dengan empat elemen. Tiga yang pertama ("mayor", "minor" dan
"rilis") adalah angka dan sesuai dengan versi triplet biasa. Elemen keempat
("ekstra") adalah string dan biasanya kosong, tetapi dapat digunakan untuk distro-spesifik
informasi.

Untuk membuat string versi asli: "$major.$minor.$release$extra"

Lihat juga: "NOMOR VERSI LIBGUESTFS" di tamu(3).

Catatan: Jangan gunakan panggilan ini untuk menguji ketersediaan fitur. Di perusahaan
distribusi kami mendukung fitur dari versi yang lebih baru ke versi sebelumnya, menjadikannya
cara yang tidak dapat diandalkan untuk menguji fitur. Gunakan "tersedia" atau "tersedia fitur" sebagai gantinya.

vfs-label
vfs-label dapat dipasang

Ini mengembalikan label sistem file pada "mountable".

Jika sistem file tidak berlabel, ini mengembalikan string kosong.

Untuk menemukan sistem file dari label, gunakan "findfs-label".

vfs-minimum-ukuran
vfs-ukuran minimum yang dapat dipasang

Dapatkan ukuran minimum sistem file dalam byte. Ini adalah ukuran minimum yang mungkin untuk
sistem file menyusut.

Jika mendapatkan ukuran minimum dari sistem file yang ditentukan tidak didukung, ini akan gagal dan disetel
errno sebagai ENOTSUP.

Lihat juga ntfsresize(8) ubah ukuran2fs(8) btrfs(8) xfs_info(8).

tipe vfs
dapat dipasang dengan tipe vfs

Perintah ini mendapatkan tipe sistem file yang sesuai dengan sistem file pada "mountable".

Untuk sebagian besar sistem file, hasilnya adalah nama modul VFS Linux yang akan digunakan
untuk memasang sistem berkas ini jika Anda memasangnya tanpa menentukan jenis sistem berkas. Untuk
contoh string seperti "ext3" atau "ntfs".

vfs-uuid
dapatkan-uuid
vfs-uuid dapat dipasang

Ini mengembalikan UUID sistem file dari sistem file pada "mountable".

Jika sistem file tidak memiliki UUID, ini akan mengembalikan string kosong.

Untuk menemukan sistem file dari UUID, gunakan "findfs-uuid".

vg-aktifkan
vg-aktifkan true|false 'volgroups ...'

Perintah ini mengaktifkan atau (jika "mengaktifkan" salah) menonaktifkan semua volume logis di
grup volume terdaftar "volgroup".

Perintah ini sama dengan menjalankan "vgchange -ay|n volgroups..."

Perhatikan bahwa jika "volgroups" adalah daftar kosong maka semua grup volume diaktifkan atau
dinonaktifkan.

vg-aktifkan-semua
vg-aktifkan-semua benar|salah

Perintah ini mengaktifkan atau (jika "mengaktifkan" salah) menonaktifkan semua volume logis di semua
kelompok volume.

Perintah ini sama dengan menjalankan "vgchange -ay|n"

vgchange-uuid
vgchange-uuid vg

Buat UUID acak baru untuk grup volume "vg".

vgchange-uuid-semua
vgchange-uuid-semua

Hasilkan UUID acak baru untuk semua grup volume.

vgcreate
vgcreate volgroup 'physvols ...'

Ini membuat grup volume LVM yang disebut "volgroup" dari daftar fisik yang tidak kosong
volume "physvols".

vglvuuid
vglvuid vgname

Diberikan VG yang disebut "vgname", ini mengembalikan UUID dari semua volume logis yang dibuat di
kelompok volume ini.

Anda dapat menggunakan ini bersama dengan panggilan "lvs" dan "lvuuid" untuk mengaitkan volume logis dan
kelompok volume.

Lihat juga "vgpvuuids".

vgmeta
vgmeta vgname

"vgname" adalah grup volume LVM. Perintah ini memeriksa grup volume dan mengembalikannya
metadata.

Perhatikan bahwa metadata adalah struktur internal yang digunakan oleh LVM, dapat berubah sewaktu-waktu
waktu, dan disediakan untuk informasi saja.

vgpvuuid
vgpvuuids vgname

Diberikan VG yang disebut "vgname", ini mengembalikan UUID dari semua volume fisik yang ini
grup volume berada.

Anda dapat menggunakan ini bersama dengan panggilan "pvs" dan "pvuuid" untuk mengaitkan volume fisik dan
kelompok volume.

Lihat juga "vglvuuids".

vgremove
vgremove vgname

Hapus grup volume LVM "vgname", (misalnya "VG").

Ini juga secara paksa menghapus semua volume logis dalam grup volume (jika ada).

vgrename
vgrename volgroup newvolgroup

Ganti nama grup volume "volgroup" dengan nama baru "newvolgroup".

dll.
dll.

Daftar semua grup volume yang terdeteksi. Ini setara dengan dll.(8) perintah.

Ini mengembalikan daftar hanya nama grup volume yang terdeteksi (mis. "VolGroup00").

Lihat juga "vgs-penuh".

vgs-penuh
vgs-penuh

Daftar semua grup volume yang terdeteksi. Ini setara dengan dll.(8) perintah. Itu
versi "penuh" mencakup semua bidang.

vgscan
vgscan

Ini memindai ulang semua perangkat blok dan membangun kembali daftar volume fisik LVM, volume
kelompok dan volume logis.

vguuid
vguuid vgname

Perintah ini mengembalikan UUID dari LVM VG bernama "vgname".

toilet-c
jalur wc-c

Perintah ini menghitung karakter dalam file, menggunakan perintah eksternal "wc -c".

toilet-l
jalan wc-l

Perintah ini menghitung baris dalam file, menggunakan perintah eksternal "wc -l".

wc-w
jalan wc-w

Perintah ini menghitung kata dalam file, menggunakan perintah eksternal "wc -w".

wipef
perangkat wipef

Perintah ini menghapus sistem file atau tanda tangan RAID dari "perangkat" yang ditentukan untuk membuat
sistem file tidak terlihat oleh libblkid.

Ini tidak menghapus sistem file itu sendiri atau data lain dari "perangkat".

Bandingkan dengan "nol" yang meniadakan beberapa blok pertama perangkat.

menulis
tulis konten jalur

Panggilan ini membuat file bernama "path". Isi file adalah string "konten"
(yang dapat berisi data 8 bit).

Lihat juga "tulis-tambahkan".

tulis-tambahkan
tulis-tambahkan konten jalur

Panggilan ini menambahkan "konten" ke akhir file "jalur". Jika "jalan" tidak ada, maka a
file baru dibuat.

Lihat juga "menulis".

file tulis
ukuran konten jalur file tulis

Panggilan ini membuat file bernama "path". Isi file adalah string "konten"
(yang dapat berisi data 8 bit apa pun), dengan panjang "ukuran".

Sebagai kasus khusus, jika "ukuran" adalah 0 maka panjangnya dihitung menggunakan "strlen" (jadi dalam hal ini
jika konten tidak dapat berisi ASCII NUL yang disematkan).

catatan Karena bug, menulis konten yang mengandung karakter ASCII NUL tidak tidak bekerja, bahkan jika
panjangnya ditentukan.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "tulis".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

xfs-admin
perangkat xfs-admin [extunwritten:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [label:..] [uuid:.. ]

Ubah parameter sistem file XFS pada "perangkat".

Perangkat yang dipasang tidak dapat dimodifikasi. Administrator harus meng-unmount sistem file
sebelum panggilan ini dapat mengubah parameter.

Beberapa parameter sistem file yang di-mount dapat diperiksa dan dimodifikasi menggunakan
panggilan "xfs-info" dan "xfs-growfs".

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

xfs-growfs
jalur xfs-growfs [datasec:true|false] [logsec:true|false] [rtsec:true|false] [datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]

Kembangkan sistem file XFS yang dipasang di "jalur".

Struktur yang dikembalikan berisi informasi geometri. Bidang yang hilang dikembalikan sebagai "-1"
(untuk bidang numerik) atau string kosong.

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

xfs-info
xfs-info perangkat path

"pathordevice" adalah sistem file XFS yang dipasang atau perangkat yang berisi sistem file XFS. Ini
perintah mengembalikan geometri sistem file.

Struktur yang dikembalikan berisi informasi geometri. Bidang yang hilang dikembalikan sebagai "-1"
(untuk bidang numerik) atau string kosong.

xfs-perbaikan
xfs-perbaikan perangkat [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride: N] [logdev:..] [rtdev:..]

Perbaiki sistem file XFS yang rusak atau rusak pada "perangkat".

Sistem file ditentukan menggunakan argumen "perangkat" yang seharusnya menjadi nama perangkat
partisi atau volume disk yang berisi sistem file. Jika diberi nama blok
perangkat, "xfs_repair" akan mencoba menemukan perangkat mentah yang terkait dengan yang ditentukan
memblokir perangkat dan akan menggunakan perangkat mentah sebagai gantinya.

Terlepas dari itu, sistem file yang akan diperbaiki harus di-unmount, jika tidak, hasilnya
sistem file mungkin tidak konsisten atau rusak.

Status yang dikembalikan menunjukkan apakah kerusakan sistem file terdeteksi (pengembalian 1) atau
tidak terdeteksi (mengembalikan 0).

Perintah ini memiliki satu atau lebih argumen opsional. Lihat "ARGUMEN OPSIONAL".

zegrep
jalur regex zegrep

Ini memanggil program "zegrep" eksternal dan mengembalikan garis yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

zegrepi
jalur regex zegrepi

Ini memanggil program "zegrep -i" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

nol
perangkat nol

Perintah ini menulis nol pada beberapa blok pertama "perangkat".

Berapa banyak blok yang di-nolkan tidak ditentukan (tapi itu tidak cukup untuk menyeka dengan aman
perangkat). Seharusnya cukup untuk menghapus semua tabel partisi, superblok sistem file
dan seterusnya.

Jika blok sudah nol, maka perintah ini menghindari penulisan nol. Ini mencegah
perangkat yang mendasari menjadi tidak jarang atau tumbuh tidak perlu.

Lihat juga: "perangkat-nol", "perangkat-gosok", "perangkat-nol"

perangkat nol
perangkat nol-perangkat

Perintah ini menulis nol di seluruh "perangkat". Bandingkan dengan "nol" yang hanya
nol beberapa blok pertama perangkat.

Jika blok sudah nol, maka perintah ini menghindari penulisan nol. Ini mencegah
perangkat yang mendasari menjadi tidak jarang atau tumbuh tidak perlu.

ruang bebas-nol
direktori zero-free-space

Nol ruang kosong di sistem file yang terpasang direktori. Sistem file harus
terpasang baca-tulis.

Konten sistem file tidak terpengaruh, tetapi ruang kosong apa pun di sistem file dibebaskan.

Ruang kosong tidak "dipangkas". Anda mungkin ingin memanggil "fstrim" sebagai alternatif untuk
ini, atau setelah memanggil ini, tergantung pada kebutuhan Anda.

bebas nol
perangkat bebas nol

Ini menjalankan bebas nol program pada "perangkat". Program ini mengklaim nol inode yang tidak digunakan dan
blok disk pada sistem file ext2/3, sehingga memungkinkan untuk mengompresi sistem file
lebih efektif.

Anda harus tidak jalankan program ini jika sistem file sudah terpasang.

Ada kemungkinan menggunakan program ini dapat merusak sistem file atau data pada
berkas sistem.

zfgrep
jalur pola zfgrep

Ini memanggil program "zfgrep" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

zfgrepi
jalur pola zfgrepi

Ini memanggil program "zfgrep -i" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

file z
jalur meth zfile

Perintah ini berjalan fillet setelah pertama kali mendekompresi "jalur" menggunakan "metode".

"metode" harus salah satu dari "gzip", "kompres" atau "bzip2".

Sejak 1.0.63, gunakan "file" sebagai gantinya yang sekarang dapat memproses file terkompresi.

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "file".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

zgrep
jalur regex zgrep

Ini memanggil program "zgrep" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

zgrepi
jalur regex zgrepi

Ini memanggil program "zgrep -i" eksternal dan mengembalikan baris yang cocok.

Karena protokol pesan, ada batas transfer antara 2MB dan
4MB. Lihat "BATASAN PROTOKOL" di tamu(3).

Kredensial mikro fungsi is usang. Dalam kode baru, gunakan panggilan "grep".

Fungsi yang tidak digunakan lagi tidak akan dihapus dari API, tetapi faktanya adalah
usang menunjukkan bahwa ada masalah dengan penggunaan yang benar dari fungsi-fungsi ini.

EXIT STATUS

guestfish mengembalikan 0 jika perintah selesai tanpa kesalahan, atau 1 jika ada kesalahan.

LINGKUNGAN VARIABEL

EDITOR
Perintah "edit" menggunakan $EDITOR sebagai editor. Jika tidak disetel, ia menggunakan "vi".

GUESTFISH_DISPLAY_IMAGE
Perintah "display" menggunakan $GUESTFISH_DISPLAY_IMAGE untuk menampilkan gambar. Jika tidak disetel, itu
kegunaan pameran(1).

GUESTFISH_INIT
Dicetak saat guestfish dimulai. Lihat "PROMT".

GUESTFISH_OUTPUT
Dicetak sebelum keluaran ikan tamu. Lihat "PROMT".

GUESTFISH_PID
Digunakan dengan --terpencil opsi untuk menentukan proses guestfish jarak jauh yang akan dikontrol. Lihat
bagian "REMOTE CONTROL GUESTFISH OVER A SOCKET".

TAMU IKAN_PS1
Setel prompt perintah. Lihat "PROMT".

GUESTFISH_RESTORE
Dicetak sebelum guestfish keluar. Lihat "PROMT".

HEXEDITOR
Perintah "hexedit" menggunakan $HEXEDITOR sebagai editor hex eksternal. Jika tidak ditentukan,
eksternal com.hexedit(1) program yang digunakan.

HOME
Jika dikompilasi dengan dukungan readline GNU, berbagai file di direktori home dapat
digunakan. Lihat "FILE".

LIBGUESTFS_APPEND
Berikan opsi tambahan ke kernel tamu.

LIBGUESTFS_ATTACH_METHOD
Ini adalah cara lama untuk menyetel "LIBGUESTFS_BACKEND".

LIBGUESTFS_BACKEND
Pilih cara default untuk membuat alat. Lihat "guestfs_set_backend" di
tamu(3).

LIBGUESTFS_BACKEND_SETTINGS
Daftar pengaturan khusus backend yang dipisahkan titik dua. Lihat "BACKEND" di tamu(3)
"PENGATURAN BACKEND" di tamu(3).

LIBGUESTFS_CACHEDIR
Lokasi di mana libguestfs akan men-cache peralatannya, saat menggunakan supermin
alat. Alat di-cache dan dibagikan di antara semua pegangan yang memiliki kesamaan
ID pengguna yang efektif.

Jika "LIBGUESTFS_CACHEDIR" tidak disetel, maka "TMPDIR" digunakan. Jika "TMPDIR" tidak disetel,
kemudian / var / tmp digunakan.

Lihat juga "LIBGUESTFS_TMPDIR", "set-cachedir".

LIBGUESTFS_DEBUG
Setel "LIBGUESTFS_DEBUG=1" untuk mengaktifkan pesan verbose. Ini memiliki efek yang sama dengan
menggunakan -v .

LIBGUESTFS_HV
Setel biner hypervisor (biasanya qemu) default yang digunakan libguestfs. Jika tidak disetel,
kemudian qemu yang ditemukan pada waktu kompilasi oleh skrip configure digunakan.

LIBGUESTFS_MEMSIZE
Atur memori yang dialokasikan untuk proses qemu, dalam megabyte. Sebagai contoh:

LIBGUESTFS_MEMSIZE=700

LIBGUESTFS_PATH
Setel jalur yang digunakan guestfish untuk mencari kernel dan initrd.img. Lihat
diskusi tentang jalan di tamu(3).

LIBGUESTFS_QEMU
Ini adalah cara lama untuk mengatur "LIBGUESTFS_HV".

LIBGUESTFS_TMPDIR
Lokasi di mana libguestfs akan menyimpan file-file sementara yang digunakan oleh masing-masing pegangan.

Jika "LIBGUESTFS_TMPDIR" tidak disetel, maka "TMPDIR" digunakan. Jika "TMPDIR" tidak disetel,
kemudian / Tmp digunakan.

Lihat juga "LIBGUESTFS_CACHEDIR", "set-tmpdir".

LIBGUESTFS_TRACE
Setel "LIBGUESTFS_TRACE=1" untuk mengaktifkan jejak perintah.

PAGER
Perintah "more" menggunakan $PAGER sebagai pager. Jika tidak disetel, ia menggunakan "lebih".

PATH
Libguestfs dan guestfish dapat menjalankan beberapa program eksternal, dan bergantung pada $PATH yang disetel
ke nilai yang wajar. Jika menggunakan backend libvirt, libvirt tidak akan berfungsi sama sekali
kecuali $PATH berisi jalur qemu/KVM.

SUPERMIN_KERNEL
SUPERMIN_KERNEL_VERSION
SUPERMIN_MODULES
Ketiga variabel lingkungan ini memungkinkan kernel yang digunakan libguestfs dalam
alat yang akan dipilih. Jika $SUPERMIN_KERNEL tidak disetel, maka host terbaru
kernel dipilih. Untuk informasi lebih lanjut tentang pemilihan kernel, lihat supermin(1).

TMPDIR
Lihat "LIBGUESTFS_CACHEDIR", "LIBGUESTFS_TMPDIR".

Gunakan guestfish online menggunakan layanan onworks.net