guestfish - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

guestfish - เชลล์ระบบไฟล์แขก

เรื่องย่อ

guestfish [--ตัวเลือก] [คำสั่ง]

ปลาแขก

เกสต์ฟิช [--ro|--rw] -a disk.img

guestfish [--ro|--rw] -a disk.img -m dev[:จุดเมานท์]

Guestfish -d libvirt-โดเมน

เกสต์ฟิช [--ro|--rw] -a disk.img -i

เกสต์ฟิช -d libvirt-โดเมน -i

คำเตือน

การใช้ "guestfish" ในโหมดเขียนบนเครื่องเสมือนแบบสด หรือพร้อมกันกับดิสก์อื่น
เครื่องมือแก้ไขอาจเป็นอันตราย อาจทำให้ดิสก์เสียหายได้ เครื่องเสมือน
ต้องปิดตัวลงก่อนที่คุณจะใช้คำสั่งนี้ และต้องไม่แก้ไขภาพดิสก์
พร้อมกัน

ใช้ --ร (อ่านอย่างเดียว) ตัวเลือกในการใช้ "guestfish" ได้อย่างปลอดภัยหากดิสก์อิมเมจหรือ virtual
เครื่องอาจจะใช้งานได้ คุณอาจเห็นผลลัพธ์ที่แปลกหรือไม่สอดคล้องกันหากทำงาน
พร้อมกันกับการเปลี่ยนแปลงอื่นๆ แต่ด้วยตัวเลือกนี้ คุณจะไม่เสี่ยงกับความเสียหายของดิสก์

DESCRIPTION

Guestfish เป็นเครื่องมือเชลล์และบรรทัดคำสั่งสำหรับตรวจสอบและแก้ไขเครื่องเสมือน
ระบบไฟล์ มันใช้ libguestfs และเปิดเผยการทำงานทั้งหมดของ guestfs API
เห็น แขก(3)

Guestfish ให้การเข้าถึงแบบมีโครงสร้างแก่ libguestfs API จากเชลล์สคริปต์หรือ
บรรทัดคำสั่งหรือแบบโต้ตอบ หากคุณต้องการกู้อิมเมจเครื่องเสมือนที่เสียหาย คุณ
ควรดูที่ virt-กู้ภัย(1) คำสั่ง

ตัวอย่าง

As an การโต้ตอบ เปลือกหอย
$ปลาแขก

ยินดีต้อนรับสู่ guestfish เชลล์ระบบไฟล์ของแขกสำหรับ
การแก้ไขระบบไฟล์เครื่องเสมือน

ประเภท: 'help' สำหรับรายการคำสั่ง
'ผู้ชาย' ให้อ่านคู่มือ
'เลิก' เลิกเปลือก

> add-ro disk.img
> วิ่ง
> รายการระบบไฟล์
/dev/sda1: ext4
/dev/vg_guest/lv_root: ext4
/dev/vg_guest/lv_swap: สลับ
> เมานต์ /dev/vg_guest/lv_root /
> แมว / etc / fstab
# / etc / fstab
# สร้างโดย anaconda
[ ... ]
> ทางออก

ราคาเริ่มต้น เปลือกหอย สคริปต์
สร้างใหม่ /etc/motd ไฟล์ในแขกหรือดิสก์อิมเมจ:

ปลาแขก <<_EOF_
เพิ่ม disk.img
วิ่ง
เมานต์ /dev/vg_guest/lv_root /
เขียน /etc/motd "ยินดีต้อนรับผู้ใช้ใหม่"
_อีโอเอฟ_

แสดงรายการโลจิคัลวอลุ่ม LVM ในดิสก์อิมเมจ:

guestfish -a disk.img --ro <<_EOF_
วิ่ง
เลเวล
_อีโอเอฟ_

แสดงรายการระบบไฟล์ทั้งหมดในอิมเมจดิสก์:

guestfish -a disk.img --ro <<_EOF_
วิ่ง
รายการระบบไฟล์
_อีโอเอฟ_

On หนึ่ง คำสั่ง เส้น
บันทึก / etc / resolv.conf ในแขก:

ปลาแขก
add disk.img : run : mount /dev/vg_guest/lv_root / :
เขียน / etc / resolv.conf "เนมเซิร์ฟเวอร์ 1.2.3.4"

Edit /boot/grub/grub.conf โต้ตอบ:

guestfish --rw --add disk.img
--mount /dev/vg_guest/lv_root
--เมานต์ /dev/sda1:/ boot
แก้ไข /boot/grub/grub.conf

ติด ดิสก์ อัตโนมัติ
ใช้ -i ตัวเลือกในการติดตั้งดิสก์โดยอัตโนมัติจากเครื่องเสมือน:

เกสท์ฟิช --ro -a disk.img -i cat / etc / group

เกสต์ฟิช --ro -d libvirt-โดเมน -i cat / etc / group

อีกวิธีในการแก้ไข /boot/grub/grub.conf แบบโต้ตอบคือ:

guestfish --rw -a disk.img -i แก้ไข /boot/grub/grub.conf

As a ต้นฉบับ ล่าม
สร้างดิสก์ 100MB ที่มีพาร์ติชันที่จัดรูปแบบ ext2:

#!/usr/bin/guestfish -f
ทดสอบเบาบาง1.img 100M
วิ่ง
ส่วนดิสก์ /dev/sda mbr
mkfs ext2 /dev/sda1

เริ่มต้น สีสดสวย a เตรียม ดิสก์
วิธีอื่นในการสร้างดิสก์ 100MB ชื่อ ทดสอบ 1.img ที่มีเดียว
พาร์ติชันที่จัดรูปแบบ ext2:

เกสต์ฟิช -N fs

ในการแสดงรายการสิ่งที่มีอยู่ให้ทำ:

guestfish -N ช่วยด้วย | น้อย

ห่างไกล ไดรฟ์
เข้าถึงดิสก์ระยะไกลโดยใช้ ssh:

เกสต์ฟิช -a ssh://example.com/path/to/disk.img

ห่างไกล ควบคุม
eval "`guestfish - ฟัง`"
เกสต์ฟิช -- รีโมต add-ro disk.img
ปลาแขก -- การวิ่งระยะไกล
เกสต์ฟิช -- lvs ระยะไกล

OPTIONS

--ช่วยด้วย
แสดงความช่วยเหลือทั่วไปเกี่ยวกับตัวเลือก

-h
--cmd-ช่วย
แสดงรายการคำสั่ง guestfish ที่มีอยู่ทั้งหมด

-h cmd
--cmd-ช่วย cmd
แสดงความช่วยเหลือโดยละเอียดเกี่ยวกับคำสั่งเดียว "cmd"

-a ภาพ
--เพิ่ม ภาพ
เพิ่มอุปกรณ์บล็อกหรืออิมเมจเครื่องเสมือนให้กับเชลล์

รูปแบบของดิสก์อิมเมจถูกตรวจพบโดยอัตโนมัติ เพื่อแทนที่สิ่งนี้และบังคับ a
รูปแบบเฉพาะใช้ --รูปแบบ=.. ตัวเลือก

การใช้แฟล็กนี้ส่วนใหญ่เทียบเท่ากับการใช้คำสั่ง "add" โดยมี "readonly:true"
ถ้า --ร ธงได้รับและด้วย "รูปแบบ:..." ถ้า --รูปแบบ=... ธงได้รับ

-a URI
--เพิ่ม URI
เพิ่มดิสก์ระยะไกล ดู "การเพิ่มที่เก็บข้อมูลระยะไกล"

-c URI
--เชื่อมต่อ URI
เมื่อใช้ร่วมกับ -d ตัวเลือกนี้จะระบุ libvirt URI ที่จะใช้
ค่าเริ่มต้นคือการใช้การเชื่อมต่อ libvirt เริ่มต้น

--csh
หากใช้งาน --ฟัง ตัวเลือกและเชลล์เหมือน csh ใช้ตัวเลือกนี้ ดูหัวข้อ
"การควบคุมระยะไกลและ CSH" ด้านล่าง

-d libvirt โดเมน
--โดเมน libvirt โดเมน
เพิ่มดิสก์จากโดเมน libvirt ที่มีชื่อ ถ้า --ร นอกจากนี้ยังใช้ตัวเลือกใด ๆ
สามารถใช้โดเมน libvirt ได้ อย่างไรก็ตามในโหมดเขียน โดเมน libvirt เท่านั้นที่
สามารถตั้งชื่อการปิดตัวลงได้ที่นี่

สามารถใช้ UUID ของโดเมนแทนชื่อได้

การใช้แฟล็กนี้ส่วนใหญ่เทียบเท่ากับการใช้คำสั่ง "add-domain" with
"readonly:true" ถ้า --ร ธงได้รับและด้วย "รูปแบบ:..." ถ้า --รูปแบบ=...
ธงได้รับ

--echo-คีย์
เมื่อถามหาคีย์และข้อความรหัสผ่าน ปกติ guestfish จะปิดเสียงสะท้อน ดังนั้นคุณ
ไม่สามารถมองเห็นสิ่งที่คุณกำลังพิมพ์ หากคุณไม่กังวลเกี่ยวกับการโจมตีของพายุและ
ไม่มีใครในห้องอื่นที่คุณสามารถระบุแฟล็กนี้เพื่อดูว่าคุณกำลังพิมพ์อะไร

-f ไฟล์
--ไฟล์ ไฟล์
อ่านคำสั่งจาก "ไฟล์" ในการเขียนสคริปต์ guestfish ให้ใช้:

#!/usr/bin/guestfish -f

--format=raw|qcow2|..
--รูปแบบ
ค่าเริ่มต้นสำหรับ -a ตัวเลือกคือการตรวจจับรูปแบบของดิสก์อิมเมจโดยอัตโนมัติ โดยใช้
สิ่งนี้บังคับรูปแบบดิสก์สำหรับ -a ตัวเลือกที่เป็นไปตามบรรทัดคำสั่ง โดยใช้
--รูปแบบ โดยไม่มีอาร์กิวเมนต์สลับกลับไปเป็นการตรวจจับอัตโนมัติในภายหลัง -a ตัวเลือก

ตัวอย่างเช่น:

เกสต์ฟิช --format=raw -a disk.img

บังคับรูปแบบ raw (ไม่มีการตรวจหาอัตโนมัติ) สำหรับ ดิสก์.img.

เกสต์ฟิช --format=raw -a disk.img --format -a another.img

บังคับรูปแบบ raw (ไม่มีการตรวจหาอัตโนมัติ) สำหรับ ดิสก์.img และเปลี่ยนกลับเป็นการตรวจจับอัตโนมัติสำหรับ
อื่น.img.

หากคุณมีอิมเมจดิสก์แขกที่ไม่น่าเชื่อถือในรูปแบบ raw คุณควรใช้ตัวเลือกนี้เพื่อ
ระบุรูปแบบดิสก์ เพื่อหลีกเลี่ยงปัญหาด้านความปลอดภัยที่อาจเกิดขึ้นกับอันตราย
แขกรับเชิญ (CVE-2010-3851) ดูเพิ่มเติมที่ "เพิ่ม"

-i
--สารวัตร
การใช้ virt-สารวัตร(1) รหัส ตรวจสอบดิสก์ที่กำลังมองหาระบบปฏิบัติการและ
เมานต์ระบบไฟล์เนื่องจากจะติดตั้งบนเครื่องเสมือนจริง

การใช้งานทั่วไปคือ:

เกสต์ฟิช -d myguest -i

(สำหรับโดเมน libvirt ที่ไม่ใช้งานที่เรียกว่า มายเกสต์), หรือ:

เกสต์ฟิช --ro -d myguest -i

(สำหรับโดเมนที่ใช้งานอยู่ อ่านอย่างเดียว) หรือระบุอุปกรณ์บล็อกโดยตรง:

เกสต์ฟิช --rw -a /dev/Guests/MyGuest -i

โปรดทราบว่ารูปแบบคำสั่งของบรรทัดคำสั่งเปลี่ยนไปเล็กน้อยเมื่อเทียบกับ guestfish รุ่นเก่า
คุณยังสามารถใช้ไวยากรณ์เก่าได้:

เกสต์ฟิช [--ro] -i disk.img

เกสต์ฟิช [--ro] -i libvirt-domain

การใช้แฟล็กนี้ส่วนใหญ่เทียบเท่ากับการใช้คำสั่ง "inspect-os" แล้วใช้
คำสั่งอื่นๆ เพื่อต่อเชื่อมระบบไฟล์ที่พบ

--keys-จาก-stdin
อ่านพารามิเตอร์คีย์หรือข้อความรหัสผ่านจาก stdin ค่าเริ่มต้นคือพยายามอ่าน
ข้อความรหัสผ่านจากผู้ใช้โดยการเปิด /dev/tty.

--ฟัง
แยกเป็นพื้นหลังและฟังคำสั่งจากระยะไกล ดูหัวข้อ "การควบคุมระยะไกล
GUESTFISH OVER A SOCKET" ด้านล่าง

--มีชีวิต
เชื่อมต่อกับเครื่องเสมือนสด (ทดลองดู "การแนบไปกับ RUNNING DAEMONS"
in แขก(พ.ศ. 3)).

-m dev[:mountpoint[:ตัวเลือก[:fstype]]]
--เมา dev[:mountpoint[:ตัวเลือก[:fstype]]]
เมานต์พาร์ติชันหรือโลจิคัลวอลุ่มที่มีชื่อบนจุดต่อเชื่อมที่กำหนด

หากละเว้นจุดเชื่อมต่อ จะมีค่าเริ่มต้นเป็น /.

คุณต้องเมานต์บางอย่างบน / ก่อนที่คำสั่งส่วนใหญ่จะทำงาน

ถ้ามี -m or --เมา มีตัวเลือกให้แขกเปิดตัวโดยอัตโนมัติ

หากคุณไม่ทราบว่าดิสก์อิมเมจประกอบด้วยระบบไฟล์ใด คุณสามารถเรียกใช้ guestfish
หากไม่มีตัวเลือกนี้ ให้ทำรายการพาร์ติชั่น ระบบไฟล์ และ LV ที่พร้อมใช้งาน (ดู
"list-partitions", "list-filesystems" และ "lvs" คำสั่ง) หรือคุณสามารถใช้
ระบบไฟล์เสมือน(1) โปรแกรม

ส่วนที่สาม (และไม่ค่อยได้ใช้) ของพารามิเตอร์การเมานท์คือรายการตัวเลือกการเมานท์
ใช้เพื่อเมานต์ระบบไฟล์พื้นฐาน หากไม่ระบุตัวเลือกการเมานท์
เป็นสตริงว่างหรือ "ro" (หลังถ้า --ร ใช้แฟล็ก) โดย
การระบุตัวเลือกการต่อเชื่อม คุณจะแทนที่ตัวเลือกเริ่มต้นนี้ คงเป็นคนเดียวสินะ
เวลาที่คุณจะใช้นี้คือเพื่อเปิดใช้งาน ACL และ/หรือแอตทริบิวต์เพิ่มเติมหากระบบไฟล์
สามารถสนับสนุนพวกเขา:

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

การใช้แฟล็กนี้เทียบเท่ากับการใช้คำสั่ง "mount-options"

ส่วนที่สี่ของพารามิเตอร์คือไดรเวอร์ระบบไฟล์ที่ใช้ เช่น "ext3" หรือ
"เอ็นทีเอฟเอส" สิ่งนี้ไม่ค่อยมีความจำเป็น แต่จะมีประโยชน์หากไดรเวอร์หลายตัวถูกต้องสำหรับ a
ระบบไฟล์ (เช่น: "ext2" และ "ext3") หรือหาก libguestfs ระบุระบบไฟล์ผิดพลาด

--เครือข่าย
เปิดใช้งานเครือข่ายผู้ใช้ QEMU ในแขก

-N [ชื่อไฟล์=]ประเภท
--ใหม่ [ชื่อไฟล์=]ประเภท
-N ช่วย
เตรียมดิสก์อิมเมจใหม่ที่จัดรูปแบบเป็น "ประเภท" นี่เป็นทางเลือกแทน -a
ตัวเลือก: ในขณะที่ -a เพิ่มดิสก์ที่มีอยู่ -N สร้างดิสก์ที่ฟอร์แมตด้วย a
ระบบไฟล์และเพิ่ม ดู "ภาพดิสก์ที่เตรียมไว้" ด้านล่าง

-n
--ไม่มีการซิงค์
ปิดใช้งานการซิงค์อัตโนมัติ สิ่งนี้ถูกเปิดใช้งานโดยค่าเริ่มต้น ดูการอภิปรายของ autosync ใน
แขก(3) หน้าจัดการ

--no-dest-เส้นทาง
อย่ากรอกแท็บเส้นทางบนระบบไฟล์ของแขก มีประโยชน์ที่จะสามารถตี
ปุ่มแท็บเพื่อกรอกเส้นทางบนระบบไฟล์ของแขก แต่สิ่งนี้ทำให้ "ซ่อน" พิเศษ
จะต้องทำการเรียก guestfs ดังนั้นตัวเลือกนี้จึงอยู่ที่นี่เพื่ออนุญาตให้ปิดใช้งานคุณลักษณะนี้

--ท่อผิดพลาด
หากการเขียนคำสั่งไปป์ล้มเหลว (ดู "PIPES" ด้านล่าง) คำสั่งจะส่งคืน an
ความผิดพลาด

ค่าเริ่มต้น (ด้วยเหตุผลทางประวัติศาสตร์ด้วย) คือการละเว้นข้อผิดพลาดดังกล่าวเพื่อ:

> command_with_lots_of_output | ศีรษะ

ไม่ให้ข้อผิดพลาด

--แถบความคืบหน้า
เปิดใช้งานแถบความคืบหน้า แม้ว่าจะใช้งาน guestfish แบบไม่โต้ตอบก็ตาม

แถบความคืบหน้าจะเปิดใช้งานตามค่าเริ่มต้นเมื่อใช้ guestfish เป็นเชลล์แบบโต้ตอบ

--no-แถบความคืบหน้า
ปิดการใช้งานแถบความคืบหน้า

--รีโมท[=pid]
ส่งคำสั่งระยะไกลไปที่ $GUESTFISH_PID หรือ "pid" ดูหัวข้อ "การควบคุมระยะไกล
GUESTFISH OVER A SOCKET" ด้านล่าง

-r
--ร
สิ่งนี้เปลี่ยนไฟล์ -a, -d และ -m ตัวเลือกเพื่อเพิ่มดิสก์และเมานต์เสร็จสิ้น
อ่านเท่านั้น.

ต้องใช้ตัวเลือกนี้เสมอหากดิสก์อิมเมจหรือเครื่องเสมือนทำงานอยู่
และแนะนำโดยทั่วไปในกรณีที่คุณไม่จำเป็นต้องเข้าถึงการเขียนดิสก์

โปรดทราบว่าอิมเมจดิสก์ที่เตรียมไว้สร้างด้วย -N จะไม่ได้รับผลกระทบจากตัวเลือกนี้ อีกด้วย
คำสั่งเช่น "add" จะไม่ได้รับผลกระทบ - คุณต้องระบุตัวเลือก "readonly:true"
อย่างชัดเจนหากคุณต้องการ

ดูเพิ่มเติมที่ "การเปิดดิสก์เพื่ออ่านและเขียน" ด้านล่าง

--เซลินุกซ์
เปิดใช้งานการสนับสนุน SELinux สำหรับแขก ดู "SELINUX" ใน แขก(3)

-v
--รายละเอียด
เปิดใช้งานข้อความที่ละเอียดมาก สิ่งนี้มีประโยชน์อย่างยิ่งหากคุณพบข้อผิดพลาด

-V
--รุ่น
แสดงหมายเลขรุ่น guestfish / libguestfs และออก

-w
--รว
สิ่งนี้เปลี่ยนไฟล์ -a, -d และ -m ตัวเลือกเพื่อเพิ่มดิสก์และเมานต์เสร็จสิ้น
อ่านเขียน.

ดู "การเปิดดิสก์เพื่ออ่านและเขียน" ด้านล่าง

-x สะท้อนแต่ละคำสั่งก่อนดำเนินการ

คำสั่ง ON คำสั่ง จองทาง LINE

อาร์กิวเมนต์เพิ่มเติม (ไม่ใช่ตัวเลือก) จะถือเป็นคำสั่งที่จะดำเนินการ

คำสั่งที่จะดำเนินการควรคั่นด้วยเครื่องหมายทวิภาค (":") โดยที่โคลอนจะแยกจากกัน
พารามิเตอร์. ดังนั้น:

เกสต์ฟิช cmd [args...] : cmd [args...] : cmd [args...] ...

หากไม่มีอาร์กิวเมนต์เพิ่มเติม เราจะเข้าสู่เชลล์ ไม่ว่าจะเป็นเชลล์แบบโต้ตอบ
พร้อมพรอมต์ (หากอินพุตเป็นเทอร์มินัล) หรือเชลล์ที่ไม่โต้ตอบ

ในโหมดบรรทัดรับคำสั่งหรือเชลล์แบบไม่โต้ตอบ คำสั่งแรกที่ให้ an
ข้อผิดพลาดทำให้ทั้งเชลล์ออก ในโหมดโต้ตอบ (พร้อมพรอมต์) หากคำสั่ง
ล้มเหลว คุณสามารถดำเนินการต่อเพื่อป้อนคำสั่ง

ใช้ เปิดตัว (หรือ วิ่ง)

เช่นเดียวกับ แขก(3) คุณต้องกำหนดค่าแขกของคุณก่อนโดยเพิ่มดิสก์แล้วเปิดใช้งาน
จากนั้นเมานต์ดิสก์ใด ๆ ที่คุณต้องการ และสุดท้ายออกการดำเนินการ/คำสั่ง ดังนั้นคำสั่งทั่วไป
ของวันนี้คือ:

· เพิ่ม หรือ -a/--add

· เปิดตัว (เรียกอีกอย่างว่ารัน)

· เมานต์หรือ -m/--mount

· คำสั่งอื่นๆ

"run" เป็นคำพ้องความหมายสำหรับ "launch" คุณต้อง "เปิดตัว" (หรือ "วิ่ง") แขกของคุณก่อนทำการติดตั้ง
หรือดำเนินการคำสั่งอื่นๆ

ข้อยกเว้นประการเดียวคือถ้าข้อใดข้อหนึ่ง -i, -m, --เมา, -N or --ใหม่ มีตัวเลือกให้
จากนั้น "run" จะทำโดยอัตโนมัติ เพียงเพราะ guestfish ไม่สามารถดำเนินการกับคุณได้
ขอโดยไม่ทำเช่นนี้

เปิด ดิสก์ สำหรับ อ่าน AND เขียน

ปลาแขก, แขกรับเชิญ(1) และ virt-กู้ภัย(1) ตัวเลือก --ร และ --รว ส่งผลกระทบต่อว่าไฟล์
ตัวเลือกบรรทัดคำสั่งอื่นๆ -a, -c, -d, -i และ -m เปิดดิสก์อิมเมจแบบอ่านอย่างเดียวหรือสำหรับ
การเขียน

ใน libguestfs ≤ 1.10 guestfish, guestmount และ virt-rescue ตั้งค่าเริ่มต้นเป็นการเปิดดิสก์
อิมเมจที่ให้มาบนบรรทัดคำสั่งสำหรับเขียน ในการเปิดดิสก์อิมเมจแบบอ่านอย่างเดียว คุณต้อง
do -a ภาพ --ร.

เรื่องนี้: หากคุณเปิดดิสก์อิมเมจ VM แบบสดที่เขียนได้โดยไม่ได้ตั้งใจ คุณจะทำให้เกิด
ความเสียหายของดิสก์ที่ไม่สามารถย้อนกลับได้

ใน libguestfs ในอนาคต เราตั้งใจจะเปลี่ยนค่าเริ่มต้นเป็นอย่างอื่น ภาพดิสก์จะเป็น
เปิดอ่านอย่างเดียว คุณจะต้องระบุอย่างใดอย่างหนึ่ง ปลาแขก --รว, แขกรับเชิญ --รว, คุณธรรม -
ช่วยเหลือ --รวหรือเปลี่ยนไฟล์คอนฟิกูเรชันเพื่อรับสิทธิ์เขียนสำหรับอิมเมจดิสก์
ระบุโดยตัวเลือกบรรทัดคำสั่งอื่นๆ

รุ่นนี้ของ guestfish, guestmount และ virt-rescue มี --รว ตัวเลือกที่ไม่ทำอะไรเลย
(มันเป็นค่าเริ่มต้นอยู่แล้ว) อย่างไรก็ตาม ขอแนะนำอย่างยิ่งให้คุณใช้ตัวเลือกนี้เพื่อ
ระบุว่าคุณต้องเข้าถึงการเขียนและเตรียมสคริปต์ของคุณสำหรับวันที่ตัวเลือกนี้
จำเป็นสำหรับการเข้าถึงการเขียน

หมายเหตุ นี้ไม่ ไม่ ส่งผลกระทบต่อคำสั่งเช่น "เพิ่ม" และ "เมานต์" หรือ libguestfs . อื่น ๆ
โปรแกรมนอกเหนือจาก guestfish และ guestmount

ใบเสนอราคา

คุณสามารถอ้างอิงพารามิเตอร์ธรรมดาโดยใช้เครื่องหมายคำพูดเดี่ยวหรือสองครั้ง ตัวอย่างเช่น:

เพิ่ม "ไฟล์ที่มี space.img"

rm '/ชื่อไฟล์'

rm '/"'

บางคำสั่งต้องการรายการสตริงที่จะส่งผ่าน สำหรับสิ่งเหล่านี้ ให้ใช้ช่องว่าง-
แยกรายการอยู่ในเครื่องหมายคำพูด สตริงที่มีช่องว่างที่จะส่งผ่าน
ต้องอยู่ในเครื่องหมายคำพูดเดี่ยว อัญประกาศเดี่ยวตามตัวอักษรต้องหลีกเลี่ยงด้วย a
แบ็กสแลช

vgcreate VG "/dev/sda1 /dev/sdb1"
สั่งการ "/bin/เสียงสะท้อน 'ฟูบาร์'"
สั่งการ "/bin/เสียงสะท้อน \'foo\'"

ESCAPE ลำดับ IN ซ้อน ใบเสนอราคา อาร์กิวเมนต์
ในอาร์กิวเมนต์ที่มีเครื่องหมายอัญประกาศคู่ (เท่านั้น) ให้ใช้แบ็กสแลชเพื่อแทรกอักขระพิเศษ:

"\NS"
ตัวอักษรแจ้งเตือน (กระดิ่ง)

"\NS"
อักขระ Backspace

"\NS"
แบบฟอร์มฟีดอักขระ

"\NS"
อักขระขึ้นบรรทัดใหม่

"\NS"
ตัวละครส่งคืนรถ

"\NS"
อักขระแท็บแนวนอน

"\v"
อักขระแท็บแนวตั้ง

"\""
อักขระอัญประกาศคู่ตามตัวอักษร

"\ooo"
อักขระที่มีค่าฐานแปด OOO. ต้องมีเลขฐานแปด 3 ตัว (ไม่เหมือน C)

"\xhh"
ตัวละครที่มีค่าฐานสิบหก hh. ต้องมีเลขฐานสิบหก 2 หลัก

ในการใช้งานปัจจุบัน "\000" และ "\x00" ไม่สามารถใช้ในสตริงได้

"\\"
อักขระแบ็กสแลชตามตัวอักษร

ตัวเลือก อาร์กิวเมนต์

คำสั่งบางคำสั่งใช้อาร์กิวเมนต์ที่เป็นทางเลือก อาร์กิวเมนต์เหล่านี้ปรากฏในเอกสารนี้เป็น
"[ชื่อ:..]". คุณสามารถใช้ได้ในตัวอย่างเหล่านี้:

เพิ่มชื่อไฟล์

เพิ่มชื่อไฟล์อ่านอย่างเดียว:จริง

เพิ่มรูปแบบชื่อไฟล์:qcow2 อ่านอย่างเดียว:เท็จ

อาร์กิวเมนต์ที่ไม่บังคับแต่ละรายการสามารถปรากฏได้ไม่เกินหนึ่งครั้ง อาร์กิวเมนต์ที่ไม่บังคับทั้งหมดต้องปรากฏหลัง
คนที่จำเป็น

หมายเลข

ส่วนนี้ใช้กับคำสั่งทั้งหมดที่สามารถใช้จำนวนเต็มเป็นพารามิเตอร์ได้

ขนาด คำต่อท้าย
เมื่อคำสั่งใช้พารามิเตอร์ที่วัดเป็นไบต์ คุณสามารถใช้ตัวเลือกใดค่าหนึ่งต่อไปนี้
คำต่อท้ายเพื่อระบุกิโลไบต์ เมกะไบต์ และขนาดที่ใหญ่ขึ้น:

k or K or โอเค
ขนาดเป็นกิโลไบต์ (คูณด้วย 1024)

KB ขนาดในหน่วย SI 1000 ไบต์

M or เอ็บ
ขนาดเป็นเมกะไบต์ (คูณด้วย 1048576)

MB ขนาดในหน่วย SI 1000000 ไบต์

G or กิ๊บ
ขนาดเป็นกิกะไบต์ (คูณด้วย 2**30)

GB ขนาดในหน่วย SI 10**9 ไบต์

T or ทีบี
ขนาดเป็นเทราไบต์ (คูณด้วย 2**40)

TB ขนาดในหน่วย SI 10**12 ไบต์

P or พี่บี
ขนาดเป็นเพตาไบต์ (คูณด้วย 2**50)

PB ขนาดในหน่วย SI 10**15 ไบต์

E or อีบี
ขนาดเป็นเอกซาไบต์ (คูณด้วย 2**60)

EB ขนาดในหน่วย SI 10**18 ไบต์

Z or ซีบี
ขนาดเป็นเซตตะไบต์ (คูณด้วย 2**70)

ZB ขนาดในหน่วย SI 10**21 ไบต์

Y or ยีบี
ขนาดเป็นโยตตะไบต์ (คูณด้วย 2**80)

YB ขนาดในหน่วย SI 10**24 ไบต์

ตัวอย่างเช่น:

ตัดขนาด / ไฟล์ 1G

จะตัดไฟล์ให้เหลือ 1 กิกะไบต์

โปรดใช้ความระมัดระวังเนื่องจากคำสั่งบางคำสั่งมีขนาดเป็นกิโลไบต์หรือเมกะไบต์ (เช่น พารามิเตอร์
เป็น "memsize" ที่ระบุเป็นเมกะไบต์แล้ว) การเพิ่มคำต่อท้ายอาจจะไม่ทำ
สิ่งที่คุณคาดหวัง

แปด AND เลขฐานสิบหก หมายเลข
สำหรับการระบุฐาน (ฐาน) ให้ใช้แบบแผน C: 0 เพื่อนำหน้าเลขฐานแปดหรือ "0x"
เพื่อนำหน้าเลขฐานสิบหก ตัวอย่างเช่น:

1234 ทศนิยม 1234
02322 เลขฐานแปด เทียบเท่ากับทศนิยม 1234
0x4d2 เลขฐานสิบหก เทียบเท่ากับทศนิยม 1234

เมื่อใช้คำสั่ง "chmod" คุณมักจะต้องการระบุเลขฐานแปดสำหรับ
โหมดและคุณต้องนำหน้าด้วย 0 (ต่างจาก Unix chmod(1) โปรแกรม):

chmod 0777 /public # ตกลง
chmod 777 /public # ผิด! นี่คือโหมด 777 ทศนิยม = 01411 ฐานแปด

คำสั่งที่ส่งคืนตัวเลขมักจะพิมพ์เป็นทศนิยม แต่บางคำสั่งพิมพ์
ตัวเลขในรัศมีอื่น (เช่น "umask" พิมพ์โหมดในฐานแปด นำหน้าด้วย 0)

ไพ่นกกระจอก AND กลม

ทั้ง guestfish และ guestfs API ที่อยู่ภายใต้ไม่ได้ดำเนินการขยายไวด์การ์ด (globbing) โดย
ค่าเริ่มต้น. ตัวอย่างเช่น สิ่งต่อไปนี้จะไม่ทำสิ่งที่คุณคาดหวัง:

rm-rf /บ้าน/*

สมมติว่าคุณไม่มีไดเร็กทอรีที่เรียกตามตัวอักษร /บ้าน/* จากนั้นคำสั่งข้างต้นจะ
ส่งคืนข้อผิดพลาด

ในการขยายไวด์การ์ด ให้ใช้คำสั่ง "glob"

กลม rm-rf /บ้าน/*

รัน "rm-rf" ในแต่ละพาธที่ตรงกัน (เช่น อาจรันคำสั่งหลายครั้ง)
เทียบเท่ากับ:

rm-rf /home/จิม
rm-rf /โฮม/โจ
rm-rf /โฮม/แมรี่

"glob" ใช้งานได้กับเส้นทางผู้เยี่ยมชมทั่วไปเท่านั้น ไม่สามารถใช้กับชื่ออุปกรณ์ได้

หากคุณมีพารามิเตอร์หลายตัว แต่ละพารามิเตอร์มีอักขระตัวแทน glob จะดำเนินการ a
ผลิตภัณฑ์คาร์ทีเซียน

ความคิดเห็น

บรรทัดใดๆ ที่ขึ้นต้นด้วย a # อักขระถือเป็นความคิดเห็นและละเว้น NS # สามารถ
หรือไม่ก็ได้ นำหน้าด้วยช่องว่าง แต่ ไม่ โดยคำสั่ง ตัวอย่างเช่น:

#นี่คือความคิดเห็น
#นี่คือความคิดเห็น
foo # ไม่ใช่ความคิดเห็น

บรรทัดว่างจะถูกละเว้นด้วย

วิ่ง คำสั่ง ในท้องถิ่น

บรรทัดใดๆ ที่ขึ้นต้นด้วย a ! อักขระจะถือว่าเป็นคำสั่งที่ส่งไปยัง local shell
(bin / sh / หรืออะไรก็ตาม ระบบ(3) การใช้งาน) ตัวอย่างเช่น:

!mkdir ท้องถิ่น
tgz-out /remote local/remote-data.tar.gz

จะสร้างไดเร็กทอรี "local" บนโฮสต์แล้วส่งออกเนื้อหาของ /ระยะไกล on
ระบบไฟล์ที่เมาท์ไปยัง ท้องถิ่น/remote-data.tar.gz. (ดู "tgz-ออก")

หากต้องการเปลี่ยนโลคัลไดเร็กทอรี ให้ใช้คำสั่ง "lcd" "!cd" จะไม่มีผลใดๆ เนื่องจาก
วิธีการทำงานของกระบวนการย่อยใน Unix

รู้ลึก คำสั่ง กับ อินไลน์ การดำเนินการ
ถ้าบรรทัดขึ้นต้นด้วย <! จากนั้นคำสั่งเชลล์จะถูกดำเนินการ (สำหรับ !) แต่ต่อมา
เอาต์พุต (stdout) ของคำสั่งเชลล์จะถูกแยกวิเคราะห์และดำเนินการเป็นคำสั่ง guestfish

ดังนั้นคุณสามารถใช้เชลล์สคริปต์เพื่อสร้างคำสั่ง guestfish โดยพลการซึ่งก็คือ
แยกวิเคราะห์โดย guestfish

ตัวอย่างเช่น การสร้างลำดับของไฟล์นั้นน่าเบื่อ (เช่น /ฟู.1 ตลอด /ฟู.100)
ใช้คำสั่ง guestfish เพียงอย่างเดียว อย่างไรก็ตาม นี่เป็นเรื่องง่ายถ้าเราใช้เชลล์สคริปต์เพื่อสร้าง
คำสั่ง guestfish สำหรับเรา:

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

หรือมีชื่อเหมือน /ฟู.001:

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

เมื่อใช้ guestfish แบบโต้ตอบ การเรียกใช้เชลล์สคริปต์ก่อนจะเป็นประโยชน์
(เช่น ลบอักขระเริ่มต้น "<" ออก ดังนั้นมันจึงเป็นเพียงอักขระธรรมดา ! คำสั่งท้องถิ่น) ดูอะไร
คำสั่ง guestfish จะทำงานและเมื่อคุณพอใจกับคำสั่งเหล่านั้นให้เติม "<"
ตัวอักษรเพื่อรันคำสั่ง guestfish ได้จริง

ท่อ

ใช้ "คำสั่ง | คำสั่ง" เพื่อไพพ์เอาต์พุตของคำสั่งแรก (a guestfish
คำสั่ง) ไปยังคำสั่งที่สอง (คำสั่งโฮสต์ใด ๆ ) ตัวอย่างเช่น:

แมว / etc / passwd | awk -F: '$3 == 0 { พิมพ์ }'

(โดยที่ "cat" คือคำสั่ง guestfish cat แต่ "awk" เป็นโปรแกรมโฮสต์ awk) ข้างบน
คำสั่งจะแสดงรายการบัญชีทั้งหมดในระบบไฟล์แขกที่มี UID 0 เช่น ราก
บัญชีรวมทั้งแบ็คดอร์ ตัวอย่างอื่นๆ:

การถ่ายโอนข้อมูล /ถัง/ลิตร | ศีรษะ
รายการอุปกรณ์ | หาง -1
tgz-out / - | ทาร์ ztf -

ต้องเว้นวรรคก่อนสัญลักษณ์ไปป์ เว้นวรรคหลังสัญลักษณ์ไปป์หรือไม่ก็ได้
ทุกอย่างหลังจากสัญลักษณ์ไปป์ถูกส่งตรงไปยังโฮสต์เชลล์จึงทำได้
มีการเปลี่ยนเส้นทาง globs และสิ่งอื่น ๆ ที่เหมาะสมกับฝั่งโฮสต์

ในการใช้อาร์กิวเมนต์ตามตัวอักษรที่ขึ้นต้นด้วยสัญลักษณ์ไปป์ คุณต้องยกคำพูดนั้น เช่น:

เสียงสะท้อน "|"

หน้าหลัก ไดเรกทอรี

หากพารามิเตอร์ขึ้นต้นด้วยอักขระ "~" เครื่องหมายตัวหนอนอาจถูกขยายเป็นโฮม
เส้นทางไดเรกทอรี ("~" สำหรับโฮมไดเร็กทอรีของผู้ใช้ปัจจุบัน หรือ "~user" สำหรับ another
ผู้ใช้)

โปรดทราบว่าการขยายโฮมไดเร็กทอรีจะเกิดขึ้นสำหรับผู้ใช้ที่รู้จัก on เจ้าภาพ, ไม่ได้อยู่ในแขก
ระบบไฟล์

ในการใช้อาร์กิวเมนต์ตามตัวอักษรที่ขึ้นต้นด้วยตัวหนอน คุณต้องอ้างอิง เช่น:

เสียงสะท้อน "~"

เข้ารหัส ดิสก์

Libguestfs มีการสนับสนุนบางอย่างสำหรับแขก Linux ที่เข้ารหัสตาม Linux Unified Key
มาตรฐานการตั้งค่า (LUKS) ซึ่งรวมถึงระบบเข้ารหัสดิสก์เกือบทั้งหมดที่ใช้โดย
แขก Linux ที่ทันสมัย ปัจจุบันรองรับเฉพาะ LVM-on-LUKS เท่านั้น

ระบุอุปกรณ์บล็อกและพาร์ติชั่นที่เข้ารหัสโดยใช้ "vfs-type":

> vfs-type /dev/sda2
crypto_LUKS

จากนั้นเปิดอุปกรณ์เหล่านั้นโดยใช้ "luks-open" สิ่งนี้จะสร้างอุปกรณ์ตัวแมปอุปกรณ์ที่เรียกว่า
/dev/ผู้ทำแผนที่/luksdev.

> luks-open /dev/sda2 luksdev
ป้อนรหัสหรือข้อความรหัสผ่าน ("คีย์"):

สุดท้าย คุณต้องบอก LVM ให้สแกนหากลุ่มวอลุ่มบนอุปกรณ์ mapper ที่สร้างขึ้นใหม่:

วีจีสแกน
vg-เปิดใช้งาน-จริงทั้งหมด

ขณะนี้สามารถติดตั้งโลจิคัลวอลุ่มได้ตามปกติ

ก่อนปิดอุปกรณ์ LUKS คุณต้องยกเลิกการต่อเชื่อมโลจิคัลวอลุ่มใด ๆ บนอุปกรณ์นั้นและปิดใช้งาน
กลุ่มวอลุ่มโดยเรียก "vg-activate false VG" ในแต่ละอัน จากนั้นคุณสามารถปิด
อุปกรณ์ทำแผนที่:

vg-เปิดใช้งานเท็จ /dev/VG
luks-close /dev/mapper/luksdev

WINDOWS เส้นทาง

หากพาธขึ้นต้นด้วย "win:" คุณสามารถใช้อักษรระบุไดรฟ์และเส้นทางแบบ Windows ได้
(โดยมีข้อจำกัดบางประการ) คำสั่งต่อไปนี้เทียบเท่า:

ไฟล์ /WINDOWS/system32/config/system.LOG

ไฟล์ win:\windows\system32\config\system.log

WIN:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG

พารามิเตอร์ถูกเขียนใหม่ "เบื้องหลัง" โดยการค้นหาตำแหน่งที่ไดรฟ์
ถูกเมาท์ นำหน้าเส้นทางนั้น เปลี่ยนอักขระแบ็กสแลชทั้งหมดเป็นส่งต่อ
slash แล้วแก้ไขผลลัพธ์โดยใช้ "case-sensitive-path" ตัวอย่างเช่น ถ้า E: drive
ถูกติดตั้งบน /e พารามิเตอร์อาจถูกเขียนใหม่ดังนี้:

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

ใช้งานได้เฉพาะในตำแหน่งอาร์กิวเมนต์ที่คาดหวังเส้นทาง

กำลังอัพโหลด AND กำลังดาวน์โหลด ไฟล์

สำหรับคำสั่งเช่น "upload", "download", "tar-in", "tar-out" และอื่นๆ ที่อัพโหลด
จากหรือดาวน์โหลดไฟล์ในเครื่อง คุณสามารถใช้ชื่อไฟล์พิเศษ "-" เพื่อหมายถึง "จาก
stdin" หรือ "to stdout" ตัวอย่างเช่น

อัพโหลด - /foo

อ่าน stdin และสร้างจากไฟล์นั้น /ฟู ในดิสก์อิมเมจและ:

น้ำมันดิน / ฯลฯ - | น้ำมันดิน tf -

เขียน tarball ไปยัง stdout จากนั้นไพพ์ลงในคำสั่ง "tar" ภายนอก (ดู
"ท่อ").

เมื่อใช้ "-" เพื่ออ่านจาก stdin อินพุตจะถูกอ่านจนถึงจุดสิ้นสุดของ stdin นอกจากนี้คุณยังสามารถ
ใช้ไวยากรณ์ที่เหมือน "heredoc" พิเศษเพื่ออ่านเครื่องหมายสิ้นสุดตามอำเภอใจ:

อัพโหลด -<
อินพุตบรรทัด 1
อินพุตบรรทัด 2
อินพุตบรรทัด 3
END

สามารถใช้สตริงอักขระใดก็ได้แทน "END" เครื่องหมายสิ้นสุดต้องปรากฏบน a
บรรทัดของตัวเอง โดยไม่มีอักขระนำหน้าหรือตามหลัง (ไม่มีแม้แต่ช่องว่าง)

โปรดทราบว่าไวยากรณ์ "-<<" ใช้กับพารามิเตอร์ที่ใช้ในการอัปโหลดไฟล์ในเครื่องเท่านั้น (ดังนั้น-
เรียกว่าพารามิเตอร์ "FileIn" ในตัวสร้าง)

EXIT ON ข้อผิดพลาด พฤติกรรม

โดยค่าเริ่มต้น guestfish จะไม่สนใจข้อผิดพลาดใดๆ เมื่ออยู่ในโหมดโต้ตอบ (เช่น การรับคำสั่ง
จากมนุษย์มากกว่า tty) และจะออกจากข้อผิดพลาดครั้งแรกในโหมดไม่โต้ตอบ
(สคริปต์ คำสั่งที่ให้ไว้ในบรรทัดคำสั่ง)

หากคุณนำหน้าคำสั่งด้วย - อักขระแล้วคำสั่งนั้นจะไม่ทำให้ guestfish ถึง
ออกแม้ว่าคำสั่ง (หนึ่ง) จะส่งคืนข้อผิดพลาด

REMOTE ควบคุม ปลาแขก ไปที่ A เบ้า

Guestfish สามารถควบคุมระยะไกลผ่านซ็อกเก็ต สิ่งนี้มีประโยชน์โดยเฉพาะอย่างยิ่งในเชลล์
สคริปต์ที่คุณต้องการทำการเปลี่ยนแปลงต่างๆ ในระบบไฟล์ แต่คุณไม่ต้องการ
ต้องการค่าใช้จ่ายในการเริ่มต้นกระบวนการ guestfish ในแต่ละครั้ง

เริ่มกระบวนการเซิร์ฟเวอร์ guestfish โดยใช้:

eval "`guestfish - ฟัง`"

แล้วส่งคำสั่งโดยทำดังนี้

guestfish --remote cmd [... ]

ในการทำให้เซิร์ฟเวอร์ออก ให้ส่งคำสั่ง exit:

ปลาแขก -- ทางออกระยะไกล

โปรดทราบว่าโดยปกติเซิร์ฟเวอร์จะออกหากมีข้อผิดพลาดในคำสั่ง เปลี่ยนได้
นี้ในลักษณะปกติ ดูหัวข้อ "ออกจากการทำงานผิดพลาด"

การควบคุม หลาย ปลาแขก กระบวนการ
คำสั่ง "eval" ตั้งค่าตัวแปรสภาพแวดล้อม $GUESTFISH_PID ซึ่งเป็นวิธีที่
--ระยะไกล ตัวเลือกรู้ว่าจะส่งคำสั่งไปที่ใด คุณสามารถมีผู้ฟังปลาแขกได้หลายคน
กระบวนการทำงานโดยใช้:

eval "`guestfish - ฟัง`"
pid1=$GUESTFISH_PID
eval "`guestfish - ฟัง`"
pid2=$GUESTFISH_PID
...
เกสต์ฟิช --remote=$pid1 cmd
เกสต์ฟิช --remote=$pid2 cmd

REMOTE ควบคุม AND CSH
เมื่อใช้เชลล์แบบ csh (csh, tcsh เป็นต้น) คุณต้องเพิ่ม --csh ตัวเลือก:

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

REMOTE ควบคุม รายละเอียด
การควบคุมระยะไกลเกิดขึ้นบนซ็อกเก็ตโดเมน Unix ที่เรียกว่า /tmp/.guestfish-$UID/socket-$PID,
โดยที่ $UID คือ ID ผู้ใช้ที่มีประสิทธิภาพของกระบวนการ และ $PID คือ ID กระบวนการของ
เซิร์ฟเวอร์

เวอร์ชันไคลเอ็นต์และเซิร์ฟเวอร์ของ Guestfish ต้องตรงกันทุกประการ

guestfish เวอร์ชันเก่ามีความเสี่ยงต่อ CVE-2013-4419 (ดู "CVE-2013-4419" ใน
แขก(3)). สิ่งนี้ได้รับการแก้ไขในเวอร์ชันปัจจุบัน

ใช้ REMOTE ควบคุม แข็งแกร่ง จาก SHELL สคริปต์
จาก Bash คุณสามารถใช้รหัสต่อไปนี้ซึ่งสร้างอินสแตนซ์ guestfish อย่างถูกต้อง
อ้างถึงบรรทัดคำสั่ง จัดการกับความล้มเหลวในการเริ่มต้น และล้าง guestfish เมื่อสคริปต์
ออก:

#!/ bin / bash -

ตั้ง -e

guestfish[0]="guestfish"
guestfish[1]="--ฟัง"
guestfish[2]="--ro"
ปลาแขก[3]="-a"
guestfish[4]="disk.img"

GUESTFISH_PID=
eval $("${guestfish[@]}")
ถ้า [ -z "$GUESTFISH_PID" ]; แล้ว
echo "ข้อผิดพลาด: guestfish ไม่เริ่มทำงาน ดูข้อความแสดงข้อผิดพลาดด้านบน"
ทางออก 1
fi

cleanup_guestfish ()
{
guestfish --remote -- exit >/dev/null 2>&1 ||:
}
กับดัก cleanup_guestfish EXIT ERR

guestfish --remote -- วิ่ง

-

REMOTE ควบคุม ทำ ไม่ ทำงาน กับ -a อื่น ๆ OPTIONS
ตัวเลือกเช่น -a, --เพิ่ม, -N, --ใหม่ ฯลฯ ไม่โต้ตอบอย่างถูกต้องกับการสนับสนุนระยะไกล
พวกเขาได้รับการประมวลผลในเครื่องและไม่ส่งผ่านไปยัง guestfish ระยะไกล โดยเฉพาะอย่างยิ่ง
สิ่งนี้จะไม่ทำสิ่งที่คุณคาดหวัง:

เกสต์ฟิช -- รีโมต -- เพิ่ม disk.img

อย่าใช้ตัวเลือกเหล่านี้ ใช้คำสั่งที่เทียบเท่าแทน เช่น:

เกสต์ฟิช -- รีโมตไดรฟ์ add-drive disk.img

หรือ:

เกสต์ฟิช --remote
> เพิ่ม disk.img

REMOTE ควบคุม วิ่ง คำสั่ง แขวน
การใช้คำสั่ง "run" (หรือ "launch") จากระยะไกลในบริบทการแทนที่คำสั่งจะหยุดทำงาน
เช่น. อย่าทำ (สังเกต backquotes):

a=`เกสต์ฟิช -- รีโมตรัน`

เนื่องจากคำสั่ง "run" ไม่สร้างเอาต์พุตบน stdout จึงไม่มีประโยชน์อยู่ดี สำหรับ
ดูข้อมูลเพิ่มเติมได้ที่ https://bugzilla.redhat.com/show_bug.cgi?id=592910

เตรียมไว้ ดิสก์ ภาพ

ใช้ -N [ชื่อไฟล์=]ประเภท or --ใหม่ [ชื่อไฟล์=]ประเภท พารามิเตอร์เพื่อเลือกชุดหนึ่งของ
ภาพดิสก์ที่ฟอร์แมตไว้ล่วงหน้าที่ guestfish สามารถสร้างให้คุณบันทึกการพิมพ์ นี่คือ
มีประโยชน์อย่างยิ่งสำหรับการทดสอบ ใช้ตัวเลือกนี้แทน -a ตัวเลือก
และชอบ -a สามารถปรากฏได้หลายครั้ง (และสามารถผสมกับ -a).

ดิสก์ใหม่เรียกว่า ทดสอบ 1.img สำหรับครั้งแรก -N, ทดสอบ 2.img สำหรับครั้งที่สองและอื่น ๆ
ไฟล์ที่มีอยู่ในไดเร็กทอรีปัจจุบันคือ เขียนทับ. คุณสามารถใช้ชื่อไฟล์อื่นได้
โดยระบุ "filename=" ก่อนประเภท (ดูตัวอย่างด้านล่าง)

ประเภทอธิบายสั้น ๆ ว่าดิสก์ควรมีขนาด แบ่งพาร์ติชันอย่างไร ระบบไฟล์อย่างไร
ควรสร้างและควรเพิ่มเนื้อหาอย่างไร เลือกประเภทได้ตามต้องการ
โดยพารามิเตอร์พิเศษ คั่นด้วย ":" (เครื่องหมายทวิภาค) ตัวอย่างเช่น, -N fs สร้าง
ดีฟอลต์ 100MB, ดิสก์ที่จัดสรรแบบเบาบาง, มีพาร์ติชั่นเดียว, พร้อมพาร์ติชั่น
จัดรูปแบบเป็น ext2 -N fs:ext4:1G เหมือนกัน แต่สำหรับระบบไฟล์ ext4 บนดิสก์ 1GB
แทน.

โปรดทราบว่าไม่ได้ติดตั้งระบบไฟล์ที่เตรียมไว้ โดยปกติคุณจะต้องใช้
คำสั่ง "mount /dev/sda1 /" หรือเพิ่ม -m / dev / sda1 ตัวเลือก

ถ้ามี -N or --ใหม่ มีตัวเลือกให้ อุปกรณ์ libguestfs จะเปิดขึ้นโดยอัตโนมัติ

ตัวอย่าง
สร้างดิสก์ 100MB ด้วยพาร์ติชันที่ฟอร์แมต ext4 เรียกว่า ทดสอบ 1.img ในปัจจุบัน
ไดเรกทอรี:

เกสต์ฟิช -N fs:ext4

สร้างดิสก์ขนาด 32MB ด้วยพาร์ติชันที่จัดรูปแบบ VFAT และติดตั้ง:

เกสต์ฟิช -N fs:vfat:32M -m /dev/sda1

สร้างดิสก์เปล่า 200MB:

guestfish -N ดิสก์:200M

สร้างดิสก์เปล่า 200MB ชื่อ Blankdisk.img (แทน ทดสอบ 1.img):

เกสต์ฟิช -N blankdisk.img=disk:200M

-N ดิสก์ - สร้าง a ว่างเปล่า ดิสก์
"เกสต์ฟิช -N [ชื่อไฟล์=]ดิสก์[:ขนาด]"

สร้างดิสก์เปล่าขนาด 100MB (โดยค่าเริ่มต้น)

ขนาดเริ่มต้นสามารถเปลี่ยนแปลงได้โดยการจัดหาพารามิเตอร์ทางเลือก

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
ขนาด 100M ขนาดของดิสก์อิมเมจ

-N ส่วนหนึ่ง - สร้าง a แบ่งพาร์ติชัน ดิสก์
"เกสต์ฟิช -N [ชื่อไฟล์=]ส่วน[:ขนาด[:พาร์ทิชัน]]"

สร้างดิสก์ด้วยพาร์ติชั่นเดียว โดยค่าเริ่มต้น ขนาดของดิสก์คือ 100MB (the
พื้นที่ว่างในพาร์ติชั่นจะเล็กกว่าเล็กน้อย) และตารางพาร์ติชั่นจะ
เป็น MBR (รูปแบบ DOS แบบเก่า)

ค่าเริ่มต้นเหล่านี้สามารถเปลี่ยนแปลงได้โดยการจัดหาพารามิเตอร์ทางเลือก

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
ขนาด 100M ขนาดของดิสก์อิมเมจ
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

-N fs - สร้าง a ระบบแฟ้ม
"เกสต์ฟิช -N [filename=]fs[:filesystem[:size[:partition]]]"

สร้างดิสก์ที่มีพาร์ติชั่นเดียว โดยมีพาร์ติชั่นที่มีระบบไฟล์ว่าง
ค่าเริ่มต้นนี้จะสร้างดิสก์ 100MB (พื้นที่ว่างในระบบไฟล์จะเป็น a
เล็กกว่าเล็กน้อย) พร้อมตารางพาร์ติชั่น MBR (สไตล์ DOS แบบเก่า) และระบบไฟล์ ext2

ค่าเริ่มต้นเหล่านี้สามารถเปลี่ยนแปลงได้โดยการจัดหาพารามิเตอร์ทางเลือก

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
filesystem ext2 ประเภทของระบบไฟล์ที่จะใช้
ขนาด 100M ขนาดของดิสก์อิมเมจ
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

-N lv - สร้าง a ดิสก์ สีสดสวย ตรรกะ ปริมาณ
"เกสต์ฟิช -N [filename=]lv[:name[:size[:partition]]]"

สร้างดิสก์ที่มีพาร์ติชันเดียว ตั้งค่าพาร์ติชันเป็นฟิสิคัลวอลุ่ม LVM2
และวางกลุ่มวอลุ่มและโลจิคัลวอลุ่มไว้ที่นั่น ค่าเริ่มต้นนี้จะสร้าง 100MB
ดิสก์ที่มี VG และ LV ชื่อ "/dev/VG/LV" สามารถเปลี่ยนชื่อ VG และ LV ได้ โดย
การระบุชื่อสำรองเป็นพารามิเตอร์ทางเลือกตัวแรก

โปรดทราบว่าสิ่งนี้ไม่ได้สร้างระบบไฟล์ ใช้ 'lvfs' เพื่อทำเช่นนั้น

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
ชื่อ /dev/VG/LV ชื่อของ VG และ LV ที่จะใช้
ขนาด 100M ขนาดของดิสก์อิมเมจ
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

-N เลเวล - สร้าง a ดิสก์ สีสดสวย ตรรกะ ปริมาณ และ ระบบแฟ้ม
"เกสต์ฟิช -N [filename=]lvfs[:name[:filesystem[:size[:partition]]]]"

สร้างดิสก์ที่มีพาร์ติชันเดียว ตั้งค่าพาร์ติชันเป็นฟิสิคัลวอลุ่ม LVM2
และวางกลุ่มวอลุ่มและโลจิคัลวอลุ่มไว้ที่นั่น จากนั้นจัดรูปแบบ LV ด้วย a
ระบบไฟล์ ค่าเริ่มต้นนี้จะสร้างดิสก์ 100MB ด้วย VG และ LV ที่เรียกว่า
"/dev/VG/LV" พร้อมระบบไฟล์ ext2

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
ชื่อ /dev/VG/LV ชื่อของ VG และ LV ที่จะใช้
filesystem ext2 ประเภทของระบบไฟล์ที่จะใช้
ขนาด 100M ขนาดของดิสก์อิมเมจ
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

-N บูตรูท - สร้าง a รองเท้า และ ราก ระบบแฟ้ม
"เกสต์ฟิช -N [ชื่อไฟล์=]bootroot[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]"

สร้างดิสก์ที่มีสองพาร์ติชั่น สำหรับการบู๊ตและระบบไฟล์รูท จัดรูปแบบทั้งสอง
ระบบไฟล์อย่างอิสระ มีพารามิเตอร์ทางเลือกหลายตัวที่ควบคุมค่าที่แน่นอน
เลย์เอาต์และประเภทระบบไฟล์

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
bootfs ext2 ประเภทของระบบไฟล์ที่จะใช้สำหรับการบูต
rootfs ext2 ประเภทของระบบไฟล์ที่จะใช้สำหรับ root
ขนาด 100M ขนาดของดิสก์อิมเมจ
บูทขนาด 32M ขนาดของบูตระบบไฟล์
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

-N bootrootlv - สร้าง a รองเท้า และ ราก ระบบแฟ้ม ด้วย LVM
"ปลาแขก -N
[filename=]bootrootlv[:name[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]"

สิ่งนี้เหมือนกับ "bootroot" แต่ระบบไฟล์รูท (เท่านั้น) วางอยู่บนตรรกะ
ปริมาณ ตั้งชื่อตามค่าเริ่มต้น "/dev/VG/LV" มีพารามิเตอร์เสริมหลายตัวซึ่ง
ควบคุมรูปแบบที่แน่นอน

พารามิเตอร์ทางเลือกคือ:

ชื่อ ค่าเริ่มต้น
ชื่อ /dev/VG/LV ชื่อของ VG และ LV สำหรับรูท
bootfs ext2 ประเภทของระบบไฟล์ที่จะใช้สำหรับการบูต
rootfs ext2 ประเภทของระบบไฟล์ที่จะใช้สำหรับ root
ขนาด 100M ขนาดของดิสก์อิมเมจ
บูทขนาด 32M ขนาดของบูตระบบไฟล์
พาร์ติชั่น mbr ประเภทตารางพาร์ติชั่น

การเพิ่ม REMOTE การเก็บรักษา

ใช้เพื่อการ ระดับ API เอกสาร on นี้ หัวข้อ, เห็น "guestfs_add_drive_opts" in แขก(3) และ
"ระยะไกล พื้นที่จัดเก็บ" in แขก(3).

บนบรรทัดคำสั่ง คุณสามารถใช้คำสั่ง -a ตัวเลือกในการเพิ่มอุปกรณ์บล็อกเครือข่ายโดยใช้ URI-
รูปแบบรูปแบบ เช่น

เกสต์ฟิช -a ssh://root@example.com/disk.img

URI ไม่ได้ ใช้กับคำสั่ง "เพิ่ม" คำสั่งเทียบเท่าโดยใช้ API โดยตรง
คือ:

> เพิ่ม /disk.img protocol:ssh server:tcp:example.com username:root

ที่เป็นไปได้ -a URI รูปแบบอธิบายไว้ด้านล่าง

-a ดิสก์.img
-a ไฟล์:///path/to/disk.img
เพิ่มอิมเมจดิสก์ในเครื่อง (หรืออุปกรณ์) ที่เรียกว่า ดิสก์.img.

-a ftp://[user@]example.com[:พอร์ต]/disk.img
-a ftps://[user@]example.com[:พอร์ต]/disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp://[user@]example.com[:พอร์ต]/disk.img
เพิ่มดิสก์ที่อยู่บนเซิร์ฟเวอร์ FTP, HTTP หรือ TFTP ระยะไกล

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่ม /disk.img protocol:(ftp|...) server:tcp:example.com

-a gluster://example.com[:พอร์ต]/volname/image
เพิ่มดิสก์อิมเมจที่อยู่บนพื้นที่จัดเก็บ GlusterFS

เซิร์ฟเวอร์เป็นเซิร์ฟเวอร์ที่เรียกใช้ "glusterd" และอาจเป็น "localhost"

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่ม volname/image protocol:gluster server:tcp:example.com

-a iscsi://example.com[:พอร์ต]/target-iqn-name[/lun]
เพิ่มดิสก์ที่อยู่บนเซิร์ฟเวอร์ iSCSI

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่ม target-iqn-name/lun protocol:iscsi server:tcp:example.com

-a nbd://example.com[:พอร์ต]
-a nbd://example.com[:พอร์ต]/exportname
-a nbd://?socket=/ซ็อกเก็ต
-a nbd:///exportname?socket=/socket
เพิ่มดิสก์ที่อยู่ในที่เก็บข้อมูล Network Block Device (nbd)

การขอ /ชื่อส่งออก ส่วนหนึ่งของ URI ระบุชื่อการส่งออก NBD แต่โดยทั่วไปจะเว้นว่างไว้

ตัวเลือก ?เบ้า พารามิเตอร์สามารถใช้เพื่อระบุซ็อกเก็ตโดเมน Unix ที่เราพูดคุยด้วย
เซิร์ฟเวอร์ NBD จบลง โปรดทราบว่าคุณไม่สามารถผสมชื่อเซิร์ฟเวอร์ (เช่น TCP/IP) และพาธซ็อกเก็ต

คำสั่ง API ที่เทียบเท่าจะเป็น (ไม่มีชื่อส่งออก):

> เพิ่ม "" protocol:nbd เซิร์ฟเวอร์:[tcp:example.com|unix:/socket]

-a rbd:///พูล/disk
-a rbd://example.com[:พอร์ต]/pool/disk
เพิ่มภาพดิสก์ที่อยู่บนโวลุ่มการจัดเก็บ Ceph (RBD/librbd)

แม้ว่า libguestfs และ Ceph จะรองรับเซิร์ฟเวอร์หลายเครื่อง แต่สามารถเป็นเซิร์ฟเวอร์เดียวได้
ระบุไว้เมื่อใช้ไวยากรณ์ URI นี้

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่มโปรโตคอลพูล/ดิสก์:rbd เซิร์ฟเวอร์:tcp:example.com:port

-a แกะ: //[example.com[:port]]/volume/image
เพิ่มภาพดิสก์ที่อยู่ในโวลุ่ม Sheepdog

ชื่อเซิร์ฟเวอร์เป็นทางเลือก แม้ว่า libguestfs และ Sheepdog รองรับหลายเซิร์ฟเวอร์
สามารถระบุเซิร์ฟเวอร์ได้ไม่เกินหนึ่งเซิร์ฟเวอร์เมื่อใช้ไวยากรณ์ URI นี้

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่มโปรโตคอลระดับเสียง:sheepdog [เซิร์ฟเวอร์:tcp:example.com]

-a ssh://[user@]example.com[:พอร์ต]/disk.img
เพิ่มภาพดิสก์ที่อยู่บนเซิร์ฟเวอร์ระยะไกล เข้าถึงได้โดยใช้ Secure Shell (ssh) SFTP
มาตรการ. SFTP ได้รับการสนับสนุนโดยเซิร์ฟเวอร์ SSH หลักทั้งหมดตั้งแต่แกะกล่อง

คำสั่ง API ที่เทียบเท่าจะเป็น:

> เพิ่ม /disk protocol:ssh เซิร์ฟเวอร์:tcp:example.com [ชื่อผู้ใช้:ผู้ใช้]

ความคืบหน้า บาร์

คำสั่งที่ใช้เวลานานบางคำสั่ง (ไม่ใช่ทั้งหมด) ส่งข้อความแจ้งเตือนความคืบหน้าตามที่เป็นอยู่
วิ่ง. Guestfish เปลี่ยนข้อความเหล่านี้เป็นแถบความคืบหน้า

เมื่อคำสั่งที่รองรับแถบความคืบหน้าใช้เวลานานกว่าสองวินาทีในการรัน และ if
เปิดใช้งานแถบความคืบหน้า จากนั้นคุณจะเห็นแถบหนึ่งปรากฏขึ้นใต้คำสั่ง:

> ขนาดสำเนา / ไฟล์ขนาดใหญ่ / ไฟล์อื่น 2048M
/ 10% [#####----------------------------------------- ] 00:30

สปินเนอร์ทางด้านซ้ายมือจะเคลื่อนที่รอบหนึ่งครั้งสำหรับการแจ้งความคืบหน้าทุกครั้ง
ได้รับจากแบ็กเอนด์ นี่คือหลักประกัน (อย่างสมเหตุสมผล) ว่าคำสั่งคือ
"ทำอะไร" แม้ว่าแถบความคืบหน้าจะไม่เคลื่อนไหวเพราะคำสั่งสามารถ
ส่งการแจ้งเตือนความคืบหน้า เมื่อแถบถึง 100% และคำสั่งเสร็จสิ้น
สปินเนอร์หายไป

แถบความคืบหน้าจะเปิดใช้งานตามค่าเริ่มต้นเมื่อใช้ guestfish แบบโต้ตอบ คุณสามารถเปิดใช้งาน
แม้กระทั่งสำหรับโหมดที่ไม่โต้ตอบโดยใช้ --แถบความคืบหน้าและคุณสามารถปิดการใช้งานได้
ใช้อย่างเต็มที่ --no-แถบความคืบหน้า.

แจ้งให้

คุณสามารถเปลี่ยนหรือเพิ่มสีให้กับข้อความแจ้งเริ่มต้น ("> ") โดยการตั้งค่า
ตัวแปรสภาพแวดล้อม "GUESTFISH_PS1" พิมพ์สตริงที่สอง ("GUESTFISH_OUTPUT")
หลังจากป้อนคำสั่งและก่อนเอาต์พุต ให้คุณควบคุม
สีของเอาต์พุต สตริงที่สาม ("GUESTFISH_INIT") ถูกพิมพ์ก่อน welcome
ข้อความ ให้คุณควบคุมสีของข้อความนั้นได้ สายที่สี่
("GUESTFISH_RESTORE") จะพิมพ์ก่อนออกจาก guestfish

สามารถตั้งค่าพรอมต์อย่างง่ายโดยการตั้งค่า "GUESTFISH_PS1" เป็นสตริงสำรอง:

$ GUESTFISH_PS1='(พิมพ์คำสั่ง) '
$ ส่งออก GUESTFISH_PS1
$ปลาแขก
[ ... ]
(พิมพ์คำสั่ง) ▂

คุณยังสามารถใช้ Escape Sequence พิเศษได้ตามที่อธิบายไว้ในตารางด้านล่าง:

\\ อักขระแบ็กสแลชตามตัวอักษร

\[
\] (ควรใช้เฉพาะใน "GUESTFISH_PS1")

วางอักขระที่ไม่พิมพ์ (เช่น รหัสควบคุมเทอร์มินัลสำหรับสี) ระหว่าง
"\[...\]". มันบอกอะไร ReadLine(3) ห้องสมุดที่ควรปฏิบัติ
ลำดับย่อยนี้เป็นศูนย์ความกว้าง เพื่อให้บรรทัดคำสั่งแสดงซ้ำ การแก้ไข ฯลฯ ใช้งานได้

\a อักขระระฆัง

\e อักขระ ASCII ESC (หลบหนี)

\n ขึ้นบรรทัดใหม่

\r การคืนรถ

\NNN
อักขระ ASCII ที่มีรหัสเป็นค่าฐานแปด NNN

\xNN
อักขระ ASCII ที่มีรหัสเป็นค่าฐานสิบหก NN

ตัวอย่าง OF พร้อมท์
โปรดทราบว่าสิ่งเหล่านี้ต้องใช้เทอร์มินัลที่สนับสนุนรหัสหลีกเลี่ยง ANSI

·

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

พรอมต์ธรรมดารุ่นสีดำตัวหนา

·

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

ข้อความต้อนรับสีน้ำเงิน พรอมต์สีเขียว คำสั่งสีแดง เอาต์พุตคำสั่งสีดำ

WINDOWS 8

"การเริ่มต้นอย่างรวดเร็ว" ของ Windows 8 สามารถป้องกันไม่ให้ guestfish ติดตั้งพาร์ติชั่น NTFS ดู
"WINDOWS HIBERNATION และ WINDOWS 8 FAST STARTUP" ใน แขก(3)

ปลาแขก คำสั่ง

คำสั่งในส่วนนี้คือคำสั่งอำนวยความสะดวกของ guestfish กล่าวคือ
ไม่ใช่ส่วนหนึ่งของ แขก(3) เอพีไอ

ช่วย
ช่วย
ช่วย cmd

หากไม่มีพารามิเตอร์ใด ๆ สิ่งนี้จะให้ความช่วยเหลือทั่วไป

ด้วยพารามิเตอร์ "cmd" สิ่งนี้จะแสดงความช่วยเหลือโดยละเอียดสำหรับคำสั่งนั้น

ทางออก
เลิก
นี้ออกจาก guestfish คุณสามารถใช้ปุ่ม "^D" ได้เช่นกัน

จัดสรร
จัดสรร
จัดสรรขนาดชื่อไฟล์

สิ่งนี้จะสร้างไฟล์เปล่า (ศูนย์) ในขนาดที่กำหนด จากนั้นจึงเพิ่มเข้าไปอีก
การตรวจสอบ

สำหรับการสร้างอิมเมจขั้นสูง โปรดดูที่ "disk-create"

ขนาดสามารถกำหนดได้โดยใช้ส่วนต่อท้ายมาตรฐาน เช่น "1เอ็ม".

หากต้องการสร้างไฟล์แบบกระจาย ให้ใช้ "sparse" แทน ในการสร้างดิสก์อิมเมจที่เตรียมไว้ โปรดดูที่
"ภาพดิสก์ที่เตรียมไว้"

คัดลอกใน
คัดลอกในเครื่อง [ท้องถิ่น ...] /remotedir

"copy-in" คัดลอกไฟล์ในเครื่องหรือไดเร็กทอรีซ้ำๆ ลงในดิสก์อิมเมจ โดยวางไว้
ในไดเร็กทอรีชื่อ /remotedir (ซึ่งต้องมีอยู่แล้ว) คำสั่ง meta ของ guestfish เปลี่ยนไป
เป็นลำดับของ "tar-in" และคำสั่งอื่นๆ ตามความจำเป็น

สามารถระบุไฟล์และไดเร็กทอรีในเครื่องได้หลายไฟล์ แต่พารามิเตอร์สุดท้ายต้องเสมอ
เป็นไดเรกทอรีระยะไกล ไม่สามารถใช้สัญลักษณ์แทนได้

คัดลอกออก
คัดลอกออกระยะไกล [รีโมท ... ] localdir

"คัดลอกออก" คัดลอกไฟล์ระยะไกลหรือไดเร็กทอรีซ้ำๆ จากดิสก์อิมเมจ วาง
บนโฮสต์ดิสก์ในไดเร็กทอรีท้องถิ่นที่เรียกว่า "localdir" (ซึ่งต้องมีอยู่) นี้
คำสั่ง meta ของ guestfish เปลี่ยนเป็นลำดับของ "ดาวน์โหลด", "tar-out" และคำสั่งอื่นๆ
เท่าที่จำเป็น

สามารถระบุไฟล์และไดเร็กทอรีระยะไกลได้หลายไฟล์ แต่พารามิเตอร์สุดท้ายต้องเสมอ
เป็นไดเรกทอรีท้องถิ่น หากต้องการดาวน์โหลดไปยังไดเร็กทอรีปัจจุบัน ให้ใช้ "." เช่นเดียวกับใน:

คัดลอกออก / หน้าแรก .

ไม่สามารถใช้สัญลักษณ์แทนในคำสั่งธรรมดาได้ แต่คุณสามารถใช้สัญลักษณ์แทนได้ด้วย
"glob" ดังนี้:

glob คัดลอกออก /บ้าน/*.

ลบเหตุการณ์
ลบชื่อเหตุการณ์

ลบตัวจัดการเหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้เป็น "ชื่อ" ถ้าหลายเหตุการณ์
ตัวจัดการถูกลงทะเบียนด้วยชื่อเดียวกัน พวกเขาทั้งหมดจะถูกลบ

ดูเพิ่มเติมที่คำสั่ง guestfish "เหตุการณ์" และ "รายการเหตุการณ์"

รายการผลิตภัณฑ์
แสดงชื่อไฟล์

ใช้ "display" (โปรแกรมแสดงผลแบบกราฟิก) เพื่อแสดงไฟล์รูปภาพ มันดาวน์โหลด
ไฟล์และเรียกใช้ "แสดง" กับมัน

หากต้องการใช้โปรแกรมสำรอง ให้ตั้งค่าตัวแปรสภาพแวดล้อม "GUESTFISH_DISPLAY_IMAGE"
ตัวอย่างเช่น การใช้โปรแกรมแสดงผล GNOME:

ส่งออก GUESTFISH_DISPLAY_IMAGE=eog

ดูสิ่งนี้ด้วย รายการผลิตภัณฑ์(1)

เสียงสะท้อน
เสียงสะท้อน [params ... ]

สิ่งนี้สะท้อนพารามิเตอร์ไปยังเทอร์มินัล

แก้ไข
vi
emacs
แก้ไขชื่อไฟล์

ใช้สำหรับแก้ไขไฟล์ มันดาวน์โหลดไฟล์ แก้ไขในเครื่องโดยใช้โปรแกรมแก้ไขของคุณ
แล้วอัปโหลดผล

บรรณาธิการคือ $EDITOR อย่างไรก็ตาม หากคุณใช้คำสั่งสำรอง "vi" หรือ "emacs" คุณจะ
รับบรรณาธิการที่เกี่ยวข้องเหล่านั้น

เหตุการณ์
ชื่อเหตุการณ์ ชุดเหตุการณ์ "เชลล์สคริปต์ ... "

ลงทะเบียนส่วนย่อยของเชลล์สคริปต์ซึ่งดำเนินการเมื่อมีการยกเหตุการณ์ ดู
"guestfs_set_event_callback" ใน แขก(3) สำหรับการอภิปรายของเหตุการณ์ API ใน
libguestfs

พารามิเตอร์ "name" คือชื่อที่คุณตั้งให้กับตัวจัดการเหตุการณ์นี้ จะสายอะไรก็ได้
(แม้แต่สตริงว่าง) และอยู่ที่นั่นเพื่อให้คุณสามารถลบตัวจัดการโดยใช้
guestfish คำสั่ง "ลบเหตุการณ์"

พารามิเตอร์ "eventset" เป็นรายการที่คั่นด้วยเครื่องหมายจุลภาคของเหตุการณ์อย่างน้อยหนึ่งเหตุการณ์ ตัวอย่างเช่น
"ปิด" หรือ "ปิด ติดตาม" ค่าพิเศษ "*" หมายถึงเหตุการณ์ทั้งหมด

พารามิเตอร์ที่สามและสุดท้ายคือแฟรกเมนต์เชลล์สคริปต์ (หรือคำสั่งภายนอกใดๆ) ที่
จะดำเนินการเมื่อเหตุการณ์ใด ๆ ในชุดเหตุการณ์เกิดขึ้น ดำเนินการโดยใช้ "$SHELL
-c" หรือถ้า $SHELL ไม่ได้ตั้งค่าไว้ bin / sh / -c.

เชลล์สคริปต์แฟรกเมนต์ได้รับพารามิเตอร์การโทรกลับเป็นอาร์กิวเมนต์ $1, $2 เป็นต้น The
เหตุการณ์จริงที่ถูกเรียกนั้นมีอยู่ในตัวแปรสภาพแวดล้อม $EVENT

เหตุการณ์ "" ปิด "ปิดเสียงสะท้อน"
อุปกรณ์ข้อความเหตุการณ์, ห้องสมุด, ติดตาม "echo $@"
เหตุการณ์ "" ความคืบหน้า "ความคืบหน้าสะท้อน: $3/$4"
เหตุการณ์ "" * "สะท้อน $EVENT $@"

โปรดดูคำสั่ง guestfish "delete-event" และ "list-event" ด้วย

glob
glob คำสั่ง args...

ขยายไวด์การ์ดในเส้นทางใดก็ได้ในรายการ args และเรียกใช้ "command" ซ้ำๆ กันในแต่ละ
เส้นทางที่ตรงกัน

ดู "WILDCARDS และ GLOBBING"

เลขฐานสิบหก
เลขฐานสิบหก
เลขฐานสิบหก
เลขฐานสิบหก

ใช้ hexedit (ตัวแก้ไขฐานสิบหก) เพื่อแก้ไขไฟล์ไบนารีหรืออุปกรณ์บล็อกทั้งหมดหรือบางส่วน

คำสั่งนี้ทำงานโดยดาวน์โหลดไฟล์หรืออุปกรณ์ทั้งไฟล์และแก้ไข
ในเครื่องแล้วอัปโหลด หากไฟล์หรืออุปกรณ์มีขนาดใหญ่ ต้องระบุ
ส่วนที่คุณต้องการแก้ไขโดยใช้พารามิเตอร์ "max" และ/หรือ "start" "max" "เริ่มต้น" และ "สูงสุด"
ถูกระบุเป็นไบต์ โดยอนุญาตให้ใช้ตัวดัดแปลงปกติ เช่น "1M" (1 เมกะไบต์)

ตัวอย่างเช่น ในการแก้ไขเซกเตอร์สองสามส่วนแรกของดิสก์ คุณอาจทำ:

hexedit /dev/sda 1M

ซึ่งจะช่วยให้คุณสามารถแก้ไขที่ใดก็ได้ภายในเมกะไบต์แรกของดิสก์

ในการแก้ไข superblock ของระบบไฟล์ ext2 บน / dev / sda1, ทำ:

ฐานสิบหกแก้ไข /dev/sda1 0x400 0x400

(สมมติว่า superblock อยู่ในตำแหน่งมาตรฐาน)

คำสั่งนี้ต้องใช้ external เลขฐานสิบหก(1) โปรแกรม คุณสามารถระบุโปรแกรมอื่นเพื่อ
ใช้โดยการตั้งค่าตัวแปรสภาพแวดล้อม "HEXEDITOR"

ดูเพิ่มเติมที่ "hexdump"

จอแอลซีดี
ไดเรกทอรีจอแอลซีดี

เปลี่ยนไดเร็กทอรีท้องถิ่นเช่น ไดเร็กทอรีปัจจุบันของ guestfish เอง

โปรดทราบว่า "!cd" จะไม่ทำสิ่งที่คุณคาดหวัง

รายการเหตุการณ์
รายการเหตุการณ์

แสดงรายการตัวจัดการเหตุการณ์ที่ลงทะเบียนโดยใช้คำสั่ง "event" ของ guestfish

มนุษย์
คู่มือ
มนุษย์

เปิดหน้าคู่มือสำหรับ guestfish

ข้อมูลเพิ่มเติม
น้อยลง
ชื่อไฟล์เพิ่มเติม

ชื่อไฟล์น้อย

ใช้สำหรับดูไฟล์.

โปรแกรมดูเริ่มต้นคือ $PAGER แต่ถ้าคุณใช้คำสั่งอื่น "น้อย" คุณจะ
รับคำสั่ง "น้อย" โดยเฉพาะ

เปิดใหม่
เปิดใหม่

ปิดและเปิดที่จับ libguestfs อีกครั้ง ไม่จำเป็นต้องใช้สิ่งนี้ตามปกติเพราะ
ที่จับปิดอย่างถูกต้องเมื่อออกจาก guestfish อย่างไรก็ตามสิ่งนี้มีประโยชน์เป็นครั้งคราว
สำหรับการทดสอบ

เซเตน
ค่า setenv VAR

ตั้งค่าตัวแปรสภาพแวดล้อม "VAR" เป็นสตริง "value"

ในการพิมพ์ค่าของตัวแปรสภาพแวดล้อมให้ใช้คำสั่งเชลล์เช่น:

!เอคโค $VAR

กระจัดกระจาย
ขนาดไฟล์กระจัดกระจาย

การทำเช่นนี้จะสร้างไฟล์ว่างขนาดบางไฟล์ที่มีขนาดที่กำหนด แล้วจึงเพิ่มเข้าไปอีก
การตรวจสอบ

มันทำงานเหมือนกับคำสั่ง "alloc" ทุกประการ ยกเว้นว่าไฟล์รูปภาพคือ
จัดสรรอย่างกระจัดกระจาย ซึ่งหมายความว่าบล็อกดิสก์จะไม่ถูกกำหนดให้กับไฟล์จนกว่าพวกเขาจะ
ต้องการ. ไฟล์ดิสก์แบบกระจายจะใช้พื้นที่เมื่อเขียนเท่านั้น แต่จะช้ากว่าและ
อาจมีอันตรายที่เนื้อที่ดิสก์จริงอาจหมดระหว่างการดำเนินการเขียน

สำหรับการสร้างอิมเมจขั้นสูง โปรดดูที่ "disk-create"

ขนาดสามารถกำหนดได้โดยใช้ส่วนต่อท้ายมาตรฐาน เช่น "1เอ็ม".

ดูเพิ่มเติมที่คำสั่ง "scratch" ของ guestfish

ได้รับการสนับสนุน
ได้รับการสนับสนุน

คำสั่งนี้ส่งคืนรายการของกลุ่มทางเลือกที่รู้จักกับ daemon และบ่งชี้
ตัวใดที่ได้รับการสนับสนุนจากอุปกรณ์ libguestfs บิลด์นี้

ดูเพิ่มเติมที่ "ความพร้อมใช้งาน" ใน แขก(3)

เวลา
อาร์กิวเมนต์คำสั่งเวลา...

รันคำสั่งตามปกติ แต่พิมพ์เวลาที่ผ่านไปหลังจากนั้น สิ่งนี้มีประโยชน์สำหรับ
การดำเนินการเปรียบเทียบ

ยกเลิกการตั้งค่า
ยกเลิกการตั้งค่า VAR

ลบ "VAR" ออกจากสิ่งแวดล้อม

คำสั่ง

acl-ลบ-def-ไฟล์
ผู้อำนวยการ acl-delete-def-file

ฟังก์ชันนี้จะลบ POSIX Access Control List (ACL) เริ่มต้นที่แนบมากับไดเร็กทอรี
"เดียร์".

acl รับไฟล์
เส้นทาง acl-get-file acltype

ฟังก์ชันนี้ส่งคืน POSIX Access Control List (ACL) ที่แนบกับ "เส้นทาง" ACL คือ
ส่งคืนในรูปแบบข้อความยาว (ดู ACL(พ.ศ. 5)).

พารามิเตอร์ "acltype" อาจเป็น:

"เข้าไป"
ส่งคืน ACL (การเข้าถึง) ธรรมดาสำหรับไฟล์ ไดเร็กทอรี หรืออ็อบเจ็กต์ระบบไฟล์อื่นๆ

"ค่าเริ่มต้น"
คืนค่า ACL เริ่มต้น โดยปกติสิ่งนี้จะสมเหตุสมผลหาก "เส้นทาง" เป็นไดเร็กทอรี

acl-ชุดไฟล์
เส้นทาง acl-set-file acltype acl

ฟังก์ชันนี้ตั้งค่า POSIX Access Control List (ACL) ที่แนบกับ "เส้นทาง"

พารามิเตอร์ "acltype" อาจเป็น:

"เข้าไป"
ตั้งค่า ACL ธรรมดา (เข้าถึง) สำหรับไฟล์ ไดเร็กทอรี หรืออ็อบเจ็กต์ระบบไฟล์อื่นๆ

"ค่าเริ่มต้น"
ตั้งค่า ACL เริ่มต้น โดยปกติสิ่งนี้จะสมเหตุสมผลหาก "เส้นทาง" เป็นไดเร็กทอรี

พารามิเตอร์ "acl" คือ ACL ใหม่ใน "รูปแบบข้อความยาว" หรือ "รูปแบบข้อความสั้น" (ดู
ACL(5)). ACL ใหม่จะแทนที่ ACL ก่อนหน้าในไฟล์โดยสมบูรณ์ ACL ต้อง
มีการอนุญาต Unix แบบเต็ม (เช่น "u::rwx,g::rx,o::rx")

หากคุณกำลังระบุผู้ใช้หรือกลุ่มเป็นรายบุคคล ฟิลด์มาสก์ก็จำเป็นเช่นกัน
(เช่น "m::rwx") ตามด้วย "u:NS:..." และ/หรือ "ก:NS:..." ฟิลด์ สตริง ACL แบบเต็ม
จึงอาจมีลักษณะดังนี้:

คุณ::rwx,g::rwx,o::rwx,m::rwx,u:500:rwx,g:500:rwx
\ สิทธิ์ Unix / \mask/ \ ACL /

คุณควรใช้ UID ที่เป็นตัวเลขและ GID เพื่อจับคู่ชื่อผู้ใช้และชื่อกลุ่มให้ถูกต้อง
รหัสตัวเลขในบริบทของแขก ใช้ฟังก์ชัน Augeas (ดู "aug-init")

เพิ่ม cdrom
add-cdrom ชื่อไฟล์

ฟังก์ชันนี้เพิ่มอิมเมจดิสก์ซีดีรอมเสมือนให้กับแขก

รูปภาพถูกเพิ่มเป็นไดรฟ์แบบอ่านอย่างเดียว ดังนั้นฟังก์ชันนี้จึงเทียบเท่ากับ "add-drive-ro"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "add-drive-ro" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เพิ่มโดเมน
โดเมน
dom โดเมนเสริม [libvirturi:..] [อ่านอย่างเดียว:จริง|เท็จ] [iface:..] [สด:จริง|เท็จ] [อนุญาติ:จริง|เท็จ] [อ่านอย่างเดียวดิสก์:..] [โหมดแคช:..] [ ทิ้ง:..] [copyonread:true|false]

ฟังก์ชันนี้จะเพิ่มดิสก์ที่แนบมากับโดเมน libvirt ที่มีชื่อ "dom" มันทำงานโดย
เชื่อมต่อกับ libvirt ขอโดเมนและโดเมน XML จาก libvirt แยกวิเคราะห์สำหรับ
ดิสก์และเรียก "add-drive-opts" ในแต่ละอัน

ส่งคืนจำนวนดิสก์ที่เพิ่ม การดำเนินการนี้เป็นแบบปรมาณู: หากมีการส่งคืนข้อผิดพลาด
จากนั้นจะไม่มีการเพิ่มดิสก์

ฟังก์ชันนี้ทำการตรวจสอบเล็กน้อยเพื่อให้แน่ใจว่าโดเมน libvirt ไม่ทำงาน
(เว้นแต่ "อ่านอย่างเดียว" จะเป็นจริง) เราจะพยายามหา libvirt lock . ในเวอร์ชันต่อๆ ไป
ในแต่ละดิสก์

ดิสก์ต้องสามารถเข้าถึงได้ในเครื่อง ซึ่งมักจะหมายถึงการเพิ่มดิสก์จากรีโมท
การเชื่อมต่อ libvirt (ดู http://libvirt.org/remote.html) จะล้มเหลวเว้นแต่ว่าดิสก์เหล่านั้นเป็น
เข้าถึงได้ผ่านเส้นทางอุปกรณ์เดียวกันในเครื่องด้วย

พารามิเตอร์ทางเลือก "libvirturi" ตั้งค่า libvirt URI (ดู
http://libvirt.org/uri.html). หากไม่ได้ตั้งค่าไว้ เราจะเชื่อมต่อกับ libvirt . เริ่มต้น
URI (หรือชุดเดียวผ่านตัวแปรสภาพแวดล้อม ดูเอกสารประกอบ libvirt สำหรับ full
รายละเอียด).

แฟล็ก "สด" ที่เป็นตัวเลือกจะควบคุมว่าการโทรนี้จะพยายามเชื่อมต่อกับการทำงานหรือไม่
เครื่องเสมือนกระบวนการ "guestfsd" หากเห็นว่าเหมาะสม องค์ประกอบใน libvirt
คำจำกัดความ XML ค่าดีฟอลต์ (หากละเว้นแฟล็ก) คือไม่ต้องพยายาม ดู "การแนบกับ
RUNNING DAMONS" ใน แขก(3) สำหรับข้อมูลเพิ่มเติม

หากค่าสถานะ "allowuuid" เป็นจริง (ค่าเริ่มต้นเป็นเท็จ) แสดงว่า UUID อาจ ถูกส่งผ่านแทน
ชื่อโดเมน สตริง "dom" จะถือเป็น UUID ก่อนและค้นหา และถ้าเป็นเช่นนั้น
การค้นหาล้มเหลวแล้วเราจะถือว่า "ดอม" เป็นชื่อตามปกติ

พารามิเตอร์ "readonlydisk" ที่เป็นตัวเลือกจะควบคุมสิ่งที่เราทำสำหรับดิสก์ที่มีเครื่องหมาย
ใน libvirt XML ค่าที่เป็นไปได้คือ:

readonlydisk = "ข้อผิดพลาด"
หาก "อ่านอย่างเดียว" เป็นเท็จ:

การโทรทั้งหมดจะถูกยกเลิกโดยมีข้อผิดพลาดหากมีดิสก์ใดที่มี ธงคือ
พบว่า

หาก "อ่านอย่างเดียว" เป็นจริง:

ดิสก์ที่มี เพิ่มแฟล็กเป็นแบบอ่านอย่างเดียว

readonlydisk = "อ่าน"
หาก "อ่านอย่างเดียว" เป็นเท็จ:

ดิสก์ที่มี เพิ่มแฟล็กเป็นแบบอ่านอย่างเดียว มีการเพิ่มดิสก์อื่น ๆ
อ่านเขียน.

หาก "อ่านอย่างเดียว" เป็นจริง:

ดิสก์ที่มี เพิ่มแฟล็กเป็นแบบอ่านอย่างเดียว

readonlydisk = "เขียน" (ค่าเริ่มต้น)
หาก "อ่านอย่างเดียว" เป็นเท็จ:

ดิสก์ที่มี ธงจะถูกเพิ่มอ่าน/เขียน

หาก "อ่านอย่างเดียว" เป็นจริง:

ดิสก์ที่มี เพิ่มแฟล็กเป็นแบบอ่านอย่างเดียว

readonlydisk = "ละเว้น"
หาก "อ่านอย่างเดียว" เป็นจริงหรือเท็จ:

ดิสก์ที่มี ธงถูกข้าม

พารามิเตอร์ทางเลือกอื่นๆ จะถูกส่งต่อโดยตรงไปยัง "add-drive-opts"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เพิ่มไดรฟ์
เพิ่ม
เพิ่มไดรฟ์ตัวเลือก
ชื่อไฟล์ add-drive [อ่านอย่างเดียว:จริง|เท็จ] [รูปแบบ:..] [iface:..] [ชื่อ:..] [ป้ายกำกับ:..] [โปรโตคอล:..] [เซิร์ฟเวอร์:..] [ชื่อผู้ใช้: ..] [ความลับ:..] [โหมดแคช:..] [ทิ้ง:..] [copyonread:true|false]

ฟังก์ชันนี้จะเพิ่มดิสก์อิมเมจที่เรียกว่า ชื่อไฟล์ ไปที่ด้ามจับ ชื่อไฟล์ อาจจะเป็นประจำ
ไฟล์โฮสต์หรืออุปกรณ์โฮสต์

เมื่อฟังก์ชันนี้ถูกเรียกก่อน "launch" (กรณีปกติ) แสดงว่าในครั้งแรกที่คุณโทร
ฟังก์ชันนี้ ดิสก์จะปรากฏใน API เป็น / dev / SDAครั้งที่สองเช่น dev / sdb /และ
เป็นต้น

ใน libguestfs ≥ 1.20 คุณสามารถเรียกใช้ฟังก์ชันนี้หลังจากเปิดตัว (ด้วย some
ข้อ จำกัด). สิ่งนี้เรียกว่า "การเสียบปลั๊กร้อน" เมื่อเสียบปลั๊กต้องระบุ a
"label" เพื่อให้ดิสก์ใหม่ได้รับชื่อที่คาดเดาได้ ดูข้อมูลเพิ่มเติมได้ที่
"HOTPLUGING" ใน แขก(3)

คุณไม่จำเป็นต้องรูทเมื่อใช้ libguestfs อย่างไรก็ตามคุณเห็นได้ชัดว่าทำ
ต้องการสิทธิ์ที่เพียงพอในการเข้าถึงชื่อไฟล์สำหรับการดำเนินการใด ๆ ที่คุณต้องการ
ดำเนินการ (เช่น การเข้าถึงแบบอ่านหากคุณต้องการอ่านรูปภาพหรือการเข้าถึงแบบเขียนหากคุณต้องการ
แก้ไขภาพ)

การโทรนี้ตรวจสอบว่า ชื่อไฟล์ ที่มีอยู่

ชื่อไฟล์ อาจเป็นสตริงพิเศษ "/dev/null" ดู "NULL DISKS" ใน แขก(3)

อาร์กิวเมนต์ที่เป็นทางเลือกคือ:

"อ่านเท่านั้น"
หากเป็น True จะถือว่ารูปภาพเป็นแบบอ่านอย่างเดียว อนุญาตให้เขียนได้ แต่
ถูกจัดเก็บไว้ในการซ้อนทับสแนปชอตชั่วคราวซึ่งจะถูกละทิ้งในตอนท้าย ดิสก์
ที่คุณเพิ่มจะไม่ถูกแก้ไข

"รูปแบบ"
สิ่งนี้บังคับรูปแบบภาพ หากคุณข้ามสิ่งนี้ (หรือใช้ "add-drive" หรือ "add-drive-ro")
จากนั้นระบบจะตรวจจับรูปแบบโดยอัตโนมัติ รูปแบบที่เป็นไปได้ ได้แก่ "ดิบ" และ
"qcow2".

การตรวจจับรูปแบบอัตโนมัติจะทำให้คุณมีช่องโหว่ด้านความปลอดภัยเมื่อ
การจัดการกับรูปภาพรูปแบบ raw ที่ไม่น่าเชื่อถือ ดู CVE-2010-3851 และ RHBZ#642934
การระบุรูปแบบจะเป็นการปิดช่องโหว่ความปลอดภัยนี้

"ไอเฟซ"
ตัวเลือกที่ไม่ค่อยได้ใช้นี้ช่วยให้คุณจำลองพฤติกรรมของ "add-drive- ที่เลิกใช้แล้ว
กับ-ถ้า" โทร (qv)

"ชื่อ"
ชื่อไดรฟ์ในแขกเดิมเช่น dev / sdb /. ใช้เป็นคำใบ้
สู่กระบวนการตรวจสอบแขกหากมี

"ฉลาก"
กำหนดป้ายกำกับให้กับดิสก์ ป้ายกำกับควรเป็นสตริงสั้นๆ ที่ไม่ซ้ำกันโดยใช้ เพียง ASCII
อักขระ "[a-zA-Z]" เช่นเดียวกับชื่อปกติใน API (เช่น / dev / SDA)
ไดรฟ์ก็จะมีชื่อว่า /dev/disk/guestfs/label.

ดู "ป้ายกำกับดิสก์" ใน แขก(3)

"มาตรการ"
สามารถใช้อาร์กิวเมนต์โปรโตคอลทางเลือกเพื่อเลือกโปรโตคอลต้นทางสำรองได้

ดูเพิ่มเติม: "REMOTE STORAGE" ใน แขก(3)

"โปรโตคอล = "ไฟล์""
ชื่อไฟล์ ถูกตีความว่าเป็นไฟล์หรืออุปกรณ์ในเครื่อง นี่เป็นค่าเริ่มต้นถ้า
ละเว้นพารามิเตอร์โปรโตคอลทางเลือก

"โปรโตคอล = "ftp"|"ftps"|"http"|"https"|"tftp""
เชื่อมต่อกับเซิร์ฟเวอร์ FTP, HTTP หรือ TFTP ระยะไกล พารามิเตอร์ "เซิร์ฟเวอร์" ต้องเป็น .ด้วย
ที่ให้มา - ดูด้านล่าง

ดูเพิ่มเติม: "FTP, HTTP และ TFTP" ใน แขก(3)

"โปรโตคอล = "แวววาว""
เชื่อมต่อกับเซิร์ฟเวอร์ GlusterFS ต้องระบุพารามิเตอร์ "เซิร์ฟเวอร์" ด้วย -
ดูด้านล่าง

ดูเพิ่มเติม: "GLUSTER" ใน แขก(3)

"โปรโตคอล = "iscsi""
เชื่อมต่อกับเซิร์ฟเวอร์ iSCSI ต้องระบุพารามิเตอร์ "เซิร์ฟเวอร์" ด้วย - see
ด้านล่าง. อาจมีการระบุพารามิเตอร์ "ชื่อผู้ใช้" ดูด้านล่าง ความลับ"
อาจมีการจัดหาพารามิเตอร์ ดูด้านล่าง

ดูเพิ่มเติม: "ISCSI" ใน แขก(3)

"โปรโตคอล = "nbd""
เชื่อมต่อกับเซิร์ฟเวอร์ Network Block Device พารามิเตอร์ "เซิร์ฟเวอร์" ต้องเป็น .ด้วย
ที่ให้มา - ดูด้านล่าง

ดูเพิ่มเติม: "NETWORK BLOCK DEVICE" ใน แขก(3)

"โปรโตคอล = "rbd""
เชื่อมต่อกับเซิร์ฟเวอร์ Ceph (librbd/RBD) พารามิเตอร์ "เซิร์ฟเวอร์" ต้องเป็น .ด้วย
ที่ให้มา - ดูด้านล่าง อาจมีการระบุพารามิเตอร์ "ชื่อผู้ใช้" ดูด้านล่าง NS
อาจมีการระบุพารามิเตอร์ "ความลับ" ดูด้านล่าง

ดูเพิ่มเติม: "CEPH" ใน แขก(3)

"โปรโตคอล = "สุนัขต้อนแกะ""
เชื่อมต่อกับเซิร์ฟเวอร์ Sheepdog อาจมีการระบุพารามิเตอร์ "เซิร์ฟเวอร์" - ดู
ด้านล่าง

ดูเพิ่มเติม: "SHEEPDOG" ใน แขก(3)

"โปรโตคอล = "ssh""
เชื่อมต่อกับเซิร์ฟเวอร์ Secure Shell (ssh)

ต้องระบุพารามิเตอร์ "เซิร์ฟเวอร์" พารามิเตอร์ "ชื่อผู้ใช้" อาจเป็น
ที่ให้มา ดูด้านล่าง

ดูเพิ่มเติม: "SSH" ใน แขก(3)

"เซิร์ฟเวอร์"
สำหรับโปรโตคอลที่ต้องการการเข้าถึงเซิร์ฟเวอร์ระยะไกล นี่คือรายการเซิร์ฟเวอร์

โปรโตคอล จำนวนเซิร์ฟเวอร์ที่ต้องการ
-
file รายการต้องว่างเปล่าหรือไม่ได้ใช้ param เลย
ftp|ftps|http|https|tftp อย่างเดียว
แวววาวทีเดียว
iscsi หนึ่งเดียว
nbd หนึ่งเดียว
rbd ศูนย์หรือมากกว่า
ชีพด็อก Zero หรือมากกว่า
ssh หนึ่งเดียว

อิลิเมนต์รายการแต่ละรายการเป็นสตริงที่ระบุเซิร์ฟเวอร์ สตริงต้องอยู่ในตัวใดตัวหนึ่ง
รูปแบบต่อไปนี้:

ชื่อโฮสต์
ชื่อโฮสต์:port
tcp:ชื่อโฮสต์
tcp:ชื่อโฮสต์:พอร์ต
ยูนิกซ์:/path/to/socket

หากไม่ระบุหมายเลขพอร์ต ระบบจะใช้หมายเลขพอร์ตมาตรฐานสำหรับโปรโตคอล
(ดู / etc / บริการ).

"ชื่อผู้ใช้"
สำหรับโปรโตคอล "ftp", "ftps", "http", "https", "iscsi", "rbd", "ssh" และ "tftp"
นี่ระบุชื่อผู้ใช้ระยะไกล

หากไม่ระบุ ระบบจะใช้ชื่อผู้ใช้ในเครื่องสำหรับ "ssh" และไม่มีการตรวจสอบสิทธิ์
พยายามสำหรับ ceph แต่โปรดทราบว่าบางครั้งอาจให้ผลลัพธ์ที่ไม่คาดคิด เช่น
หากใช้แบ็กเอนด์ libvirt และหากตั้งค่าแบ็คเอนด์ libvirt ให้เริ่ม
อุปกรณ์ qemu ในฐานะผู้ใช้พิเศษ เช่น "qemu.qemu" หากสงสัยให้ระบุรีโมท
ชื่อผู้ใช้ที่คุณต้องการ

"ความลับ"
สำหรับโปรโตคอล "rbd" เท่านั้น ซึ่งจะระบุ 'ความลับ' ที่จะใช้เมื่อเชื่อมต่อกับ
อุปกรณ์ระยะไกล จะต้องเข้ารหัส base64

หากไม่ระบุ ความลับที่ตรงกับชื่อผู้ใช้ที่ระบุจะถูกค้นหาใน
ตำแหน่งพวงกุญแจเริ่มต้น หรือหากไม่มีการระบุชื่อผู้ใช้ จะไม่มีการตรวจสอบสิทธิ์
มือสอง

"โหมดแคช"
เลือกว่า libguestfs จะเชื่อฟังการซิงค์หรือไม่ (ปลอดภัยแต่ช้า) หรือไม่
(ไม่ปลอดภัยแต่รวดเร็ว). ค่าที่เป็นไปได้สำหรับสตริงนี้คือ:

"cachemode = "เขียนกลับ""
นี่คือค่าเริ่มต้น

การดำเนินการเขียนใน API จะไม่ส่งคืนจนกว่า a เขียน(2) การโทรเสร็จสิ้นใน
โฮสต์ [แต่โปรดทราบว่านี่ไม่ได้หมายความว่ามีการเขียนอะไรลงดิสก์]

การดำเนินการซิงค์ใน API รวมถึงการซิงค์โดยนัยที่เกิดจากระบบไฟล์
Journalling จะไม่กลับมาจนกว่า an fdatasync(2) การโทรเสร็จสิ้นในโฮสต์
บ่งชี้ว่าข้อมูลได้รับการคอมมิตไปยังดิสก์แล้ว

"โหมดแคช = "ไม่ปลอดภัย""
ในโหมดนี้ไม่มีการค้ำประกัน Libguestfs อาจแคชอะไรก็ได้และละเว้น
คำขอซิงค์ เหมาะสำหรับรอยขีดข่วนหรือดิสก์ชั่วคราวเท่านั้น

"ทิ้ง"
เปิดหรือปิดใช้งานการสนับสนุนการละทิ้ง (aka trim หรือ unmap) บนไดรฟ์นี้ หากเปิดใช้งาน
การดำเนินการเช่น "fstrim" จะสามารถทิ้ง / ทำให้บาง / เจาะรูใน
ไฟล์โฮสต์หรืออุปกรณ์พื้นฐาน

การตั้งค่าการยกเลิกที่เป็นไปได้คือ:

"ทิ้ง = "ปิดการใช้งาน""
ปิดการใช้งานยกเลิกการสนับสนุน นี่คือค่าเริ่มต้น

"ทิ้ง = "เปิดใช้งาน""
เปิดใช้งานการยกเลิกการสนับสนุน ล้มเหลวหากไม่สามารถทิ้งได้

"ทิ้ง = "ความพยายามอย่างดีที่สุด""
เปิดใช้งานการยกเลิกการสนับสนุนถ้าเป็นไปได้ แต่อย่าล้มเหลวหากไม่ได้รับการสนับสนุน

เนื่องจากไม่ใช่แบ็กเอนด์ทั้งหมดและไม่ใช่ทุกระบบที่รองรับการยกเลิก นี่คือ
ทางเลือกที่ดีถ้าคุณต้องการใช้ทิ้งถ้าเป็นไปได้ แต่ไม่เป็นไรถ้ามันไม่ได้
ทำงาน

"คัดลอกอ่าน"
พารามิเตอร์บูลีน "copyonread" ช่วยให้รองรับการคัดลอกเมื่ออ่านได้ สิ่งนี้ส่งผลกระทบเท่านั้น
รูปแบบดิสก์ที่มีไฟล์สำรอง และทำให้การอ่านถูกเก็บไว้ในโอเวอร์เลย์
ชั้น เร่งการอ่านหลายครั้งของพื้นที่ดิสก์เดียวกัน

ค่าเริ่มต้นเป็นเท็จ

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เพิ่มไดรฟ์ RO
เพิ่ม-ro
add-drive-ro ชื่อไฟล์

ฟังก์ชันนี้เทียบเท่ากับการเรียก "add-drive-opts" ด้วยพารามิเตอร์เสริม
"GUESTFS_ADD_DRIVE_OPTS_READONLY" ตั้งค่าเป็น 1 ดังนั้นดิสก์จึงถูกเพิ่มเป็นแบบอ่านอย่างเดียว โดยมี
ตรวจพบรูปแบบโดยอัตโนมัติ

เพิ่มไดรฟ์ Ro-กับถ้า
add-drive-ro-with-if ชื่อไฟล์ iface

สิ่งนี้เหมือนกับ "add-drive-ro" แต่อนุญาตให้คุณระบุอินเทอร์เฟซ QEMU
การจำลองเพื่อใช้ในเวลาทำงาน

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "add-drive" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เพิ่มไดรฟ์รอยขีดข่วน
รอยขีดข่วน
ขนาดเพิ่มไดรฟ์-รอยขีดข่วน [ชื่อ:..] [ป้ายกำกับ:..]

คำสั่งนี้เพิ่มไดรฟ์เริ่มต้นชั่วคราวที่หมายเลขอ้างอิง พารามิเตอร์ "ขนาด" คือ
ขนาดเสมือน (เป็นไบต์) ไดรฟ์เริ่มต้นว่างเปล่า (การอ่านทั้งหมดจะคืนค่าศูนย์
จนกว่าคุณจะเริ่มเขียน) ไดรฟ์จะถูกลบออกเมื่อปิดที่จับ

อาร์กิวเมนต์ตัวเลือก "name" และ "label" จะถูกส่งผ่านไปยัง "add-drive"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เพิ่มไดรฟ์ด้วยถ้า
add-drive-with-if ชื่อไฟล์ iface

สิ่งนี้เหมือนกับ "add-drive" แต่อนุญาตให้คุณระบุการจำลองอินเตอร์เฟส QEMU
เพื่อใช้ในเวลาทำงาน

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "add-drive" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ส.ค.ชัดเจน
Aug-ล้าง Augpath

ตั้งค่าที่เกี่ยวข้องกับ "เส้นทาง" เป็น "NULL" นี่ก็เหมือนกับ Augtool(1)
คำสั่ง "ชัดเจน"

ส.ค.ปิด
ส.ค.ปิด

ปิดแฮนเดิลของ Augeas ปัจจุบันและเพิ่มทรัพยากรที่ใช้โดยมัน หลังจากเรียกสิ่งนี้ว่า
คุณต้องเรียก "aug-init" อีกครั้งก่อนจึงจะสามารถใช้ฟังก์ชันอื่นๆ ของ Augeas ได้

Aug-defnode
aug-defnode ชื่อ expr val

กำหนดตัวแปร "name" ที่มีค่าเป็นผลลัพธ์ของการประเมิน "expr"

หาก "expr" ประเมินเป็นชุดโหนดว่าง โหนดจะถูกสร้างขึ้น เทียบเท่ากับการเรียก "aug-
set" "expr", "value" "name" จะเป็นชุดโหนดที่มีโหนดเดียวนั้น

เมื่อสำเร็จ จะส่งกลับคู่ที่มีจำนวนโหนดในชุดโหนด และ a
แฟล็กบูลีนหากโหนดถูกสร้างขึ้น

ส.ค.-defvar
aug-defvar ชื่อ expr

กำหนดตัวแปร "ชื่อ" ของ Augeas ซึ่งมีค่าเป็นผลมาจากการประเมิน "expr" ถ้า
"expr" เป็น NULL จากนั้น "name" จะไม่ถูกกำหนด

เมื่อสำเร็จ จะคืนค่าจำนวนโหนดใน "expr" หรือ 0 หาก "expr" ประเมินเป็น
สิ่งที่ไม่ใช่ชุดโหนด

Aug-get
ส.ค.ส

ค้นหาค่าที่เกี่ยวข้องกับ "เส้นทาง" หาก "เส้นทาง" ตรงกับโหนดเดียว "ค่า"
จะถูกส่งกลับ

ส.ค
แฟล็กรูท Aug-init

สร้างแฮนเดิล Augeas ใหม่สำหรับแก้ไขไฟล์การกำหนดค่า ถ้ามีมาก่อน
จัดการ Augeas ที่เกี่ยวข้องกับเซสชัน guestfs นี้ จากนั้นจะปิด

คุณต้องเรียกสิ่งนี้ก่อนใช้คำสั่ง "aug-*" อื่น ๆ

"root" คือรูทของระบบไฟล์ "root" ต้องไม่เป็น NULL ใช้ / แทน.

แฟล็กจะเหมือนกับแฟล็กที่กำหนดไว้ใน , ตรรกะ or ดังต่อไปนี้
จำนวนเต็ม:

"AUG_SAVE_BACKUP" = 1
เก็บไฟล์ต้นฉบับที่มีนามสกุล ".augsave"

"AUG_SAVE_NEWFILE" = 2
บันทึกการเปลี่ยนแปลงลงในไฟล์ที่มีนามสกุล ".augnew" และอย่าเขียนทับต้นฉบับ
แทนที่ "AUG_SAVE_BACKUP"

"AUG_TYPE_CHECK" = 4
เลนส์ Typecheck

ตัวเลือกนี้มีประโยชน์เมื่อทำการดีบั๊กเลนส์ Augeas เท่านั้น การใช้ตัวเลือกนี้อาจ
ต้องการหน่วยความจำเพิ่มเติมสำหรับอุปกรณ์ libguestfs คุณอาจต้องตั้งค่า
ตัวแปรสภาพแวดล้อม "LIBGUESTFS_MEMSIZE" หรือเรียก "set-memsize"

"AUG_NO_STDINC" = 8
อย่าใช้เส้นทางการโหลดมาตรฐานสำหรับโมดูล

"AUG_SAVE_NOOP" = 16
ทำการบันทึกแบบไม่ต้องดำเนินการ เพียงบันทึกสิ่งที่จะมีการเปลี่ยนแปลง

"AUG_NO_LOAD" = 32
อย่าโหลดต้นไม้ใน "aug-init"

หากต้องการปิดที่จับ คุณสามารถเรียก "aug-close"

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Augeas ได้ที่ http://augeas.net/.

ส.ค
aug-insert augpath label จริง|เท็จ

สร้าง "ป้ายกำกับ" พี่น้องใหม่สำหรับ "เส้นทาง" โดยแทรกลงในทรีก่อนหรือหลัง "เส้นทาง"
(ขึ้นอยู่กับธงบูลีน "ก่อน")

"เส้นทาง" ต้องตรงกับหนึ่งโหนดที่มีอยู่ในทรี และ "ป้ายกำกับ" ต้องเป็นป้ายกำกับ กล่าวคือ
ไม่มี /, "*" หรือลงท้ายด้วยดัชนีวงเล็บ "[N]"

ป้าย ส.ค
ป้ายกำกับ Aug-label

ป้ายกำกับ (ชื่อขององค์ประกอบสุดท้าย) ของนิพจน์เส้นทาง Augeas "augpath" ถูกส่งกลับ
"augpath" ต้องตรงกับโหนดเดียวเท่านั้น มิฉะนั้น ฟังก์ชันนี้จะส่งคืนข้อผิดพลาด

Aug-load
Aug-load

โหลดไฟล์ลงในทรี

ดู "aug_load" ในเอกสารของ Augeas สำหรับรายละเอียดที่เต็มไปด้วยเลือด

Aug-ls
ส.ค.-ls ส.ค

นี่เป็นเพียงทางลัดสำหรับแสดงรายการ "aug-match" "path/*" และจัดเรียงโหนดผลลัพธ์
ตามลำดับตัวอักษร

ส.ค
ส.ค.ส

ส่งกลับรายการของเส้นทางที่ตรงกับนิพจน์เส้นทาง "เส้นทาง" เส้นทางกลับคือ
มีคุณสมบัติเพียงพอเพื่อให้ตรงกับโหนดเดียวในทรีปัจจุบัน

ส.ค.-mv
aug-mv src ปลายทาง

ย้ายโหนด "src" ไปที่ "dest" "src" ต้องตรงกับโหนดเดียวเท่านั้น "dest" ถูกเขียนทับ
ถ้ามันมีอยู่

Aug-rm
aug-rm อัจฉรา

ลบ "เส้นทาง" และลูกทั้งหมดออก

เมื่อสำเร็จ จะคืนค่าจำนวนรายการที่ถูกลบออก

ส.ค.-save
ส.ค.-save

การดำเนินการนี้จะเขียนการเปลี่ยนแปลงที่รอดำเนินการทั้งหมดลงในดิสก์

แฟล็กที่ส่งไปยัง "aug-init" มีผลกับวิธีการบันทึกไฟล์

ส.ค
ส.ค. ชุด augpath val

ตั้งค่าที่เกี่ยวข้องกับ "เส้นทาง" เป็น "val"

ใน Augeas API คุณสามารถล้างโหนดโดยตั้งค่าเป็น NULL เนื่องจาก
การกำกับดูแลใน libguestfs API คุณไม่สามารถทำได้ด้วยการเรียกนี้ คุณต้องใช้ .แทน
เรียก "สิงหาคม"

ส.ค
aug-setm ฐานย่อย val

เปลี่ยนโหนด Augeas หลายโหนดในการดำเนินการเดียว "ฐาน" คือการจับคู่นิพจน์
หลายโหนด "sub" เป็นนิพจน์เส้นทางที่สัมพันธ์กับ "base" โหนดทั้งหมดที่ตรงกับ "ฐาน"
พบ จากนั้นสำหรับแต่ละโหนด "sub" จะถูกเปลี่ยนเป็น "val" "sub" อาจเป็น "NULL" ใน
ซึ่งกรณีที่มีการแก้ไขโหนด "ฐาน"

ส่งคืนจำนวนโหนดที่แก้ไข

ใช้ได้
มี 'กลุ่ม ...'

คำสั่งนี้ใช้เพื่อตรวจสอบความพร้อมใช้งานของฟังก์ชันบางกลุ่มใน
อุปกรณ์ซึ่งอุปกรณ์ libguestfs บางรุ่นเท่านั้นที่จะสามารถให้ได้

กลุ่ม libguestfs และฟังก์ชันที่กลุ่มเหล่านั้นสัมพันธ์กัน แสดงอยู่ใน
"ความพร้อมใช้งาน" ใน แขก(3). คุณยังสามารถดึงข้อมูลรายการนี้เมื่อรันไทม์ได้โดยการโทร
"ใช้ได้ทุกกลุ่ม".

อาร์กิวเมนต์ "groups" คือรายชื่อกลุ่ม เช่น: "["inotify", "augeas"]" จะตรวจสอบ
เพื่อความพร้อมใช้งานของฟังก์ชัน Linux inotify และ Augeas (ไฟล์การกำหนดค่า
การแก้ไข) ฟังก์ชั่น

คำสั่งไม่ส่งคืนข้อผิดพลาด if ทั้งหมด มีกลุ่มที่ร้องขอ

มันล้มเหลวโดยมีข้อผิดพลาดหากกลุ่มที่ร้องขออย่างน้อยหนึ่งกลุ่มไม่พร้อมใช้งานใน
เครื่องใช้

หากมีการรวมชื่อกลุ่มที่ไม่รู้จักไว้ในรายชื่อกลุ่ม ข้อผิดพลาดก็จะเป็นเสมอ
กลับ

หมายเหตุ:

· "คุณสมบัติพร้อมใช้งาน" เหมือนกับการโทรนี้ แต่ใช้ API ที่ง่ายกว่าเล็กน้อย:
การเรียกนั้นจะคืนค่าบูลีนเป็น true/false แทนที่จะส่งข้อผิดพลาด

· คุณต้องเรียก "launch" ก่อนเรียกใช้ฟังก์ชันนี้

เหตุผลเป็นเพราะเราไม่รู้ว่าอุปกรณ์/ภูตสนับสนุนกลุ่มใด
จนกว่าจะใช้งานได้และสามารถสอบถาม

· หากมีกลุ่มของฟังก์ชัน ไม่จำเป็นต้องหมายความว่าจะ
งาน. คุณยังต้องตรวจสอบข้อผิดพลาดเมื่อเรียกใช้ฟังก์ชัน API แต่ละรายการด้วย
หากมี

· โดยปกติแล้ว จะเป็นหน้าที่ของ distro packagers ในการสร้างฟังก์ชันการทำงานที่สมบูรณ์ลงใน
libguestfs อุปกรณ์ libguestfs อัปสตรีมหากสร้างจากแหล่งที่มาพร้อมข้อกำหนดทั้งหมด
พอใจจะสนับสนุนทุกอย่าง

· เพิ่มการโทรนี้ในเวอร์ชัน 1.0.80 ในเวอร์ชันก่อนหน้าของ libguestfs ทั้งหมดที่คุณ
สามารถทำได้คือการเก็งกำไรรันคำสั่งเพื่อดูว่า daemon
ดำเนินการมัน ดูเพิ่มเติมที่ "รุ่น"

ดูเพิ่มเติมที่ "ระบบไฟล์พร้อมใช้งาน"

มีทุกกลุ่ม
มีทุกกลุ่ม

คำสั่งนี้ส่งคืนรายการของกลุ่มทางเลือกทั้งหมดที่ daemon รู้ บันทึก
ส่งคืนทั้งกลุ่มที่ได้รับการสนับสนุนและไม่ได้รับการสนับสนุน เพื่อค้นหาว่าภูตตัวใดสามารถ
สนับสนุนจริง ๆ คุณต้องเรียก "พร้อมใช้งาน" / "คุณสมบัติพร้อมใช้งาน" กับสมาชิกแต่ละคนของ
รายการที่ส่งคืน

ดูเพิ่มเติมที่ "มี", "มีคุณลักษณะ" และ "ความพร้อมใช้งาน" ใน แขก(3)

ฐาน64-in
base64-in (base64file|-) ชื่อไฟล์

คำสั่งนี้จะอัปโหลดข้อมูลที่เข้ารหัส base64 จาก "base64file" ไปยัง ชื่อไฟล์.

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

เบส 64-ออก
ชื่อไฟล์ base64-out (base64file|-)

คำสั่งนี้ดาวน์โหลดเนื้อหาของ ชื่อไฟล์ให้เขียนลงในไฟล์ในเครื่อง "base64file"
เข้ารหัสเป็น base64

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

blkทิ้ง
อุปกรณ์ blkdiscard

สิ่งนี้จะทิ้งบล็อกทั้งหมดใน "อุปกรณ์" ของอุปกรณ์บล็อก ทำให้พื้นที่ว่างกลับไปที่
เจ้าภาพ

การดำเนินการนี้ต้องการการสนับสนุนใน libguestfs, ระบบไฟล์โฮสต์, qemu และ host
เคอร์เนล หากไม่มีการสนับสนุนนี้อาจแสดงข้อผิดพลาดหรือดูเหมือนว่าจะทำงานแต่ทำ
ไม่มีอะไร. คุณต้องตั้งค่าแอตทริบิวต์ "ละทิ้ง" บนไดรฟ์ที่อยู่ภายใต้ (ดู "เพิ่ม-
ตัวเลือกไดรฟ์")

blkทิ้งเลขศูนย์
blkdiscardzeroes อุปกรณ์

การโทรนี้จะคืนค่าเป็น จริง หากบล็อกใน "อุปกรณ์" ที่ถูกยกเลิกโดยการโทรไปยัง
"blkdiscard" จะถูกส่งกลับเป็นบล็อกศูนย์ไบต์เมื่ออ่านในครั้งต่อไป

หากคืนค่าเป็นเท็จ อาจเป็นไปได้ว่าบล็อกที่ถูกทิ้งจะถูกอ่านว่าเก่าหรือสุ่ม
ข้อมูล

บลคิด
อุปกรณ์ blkid

คำสั่งนี้ส่งคืนแอตทริบิวต์อุปกรณ์บล็อกสำหรับ "อุปกรณ์" ช่องต่อไปนี้คือ
มักจะอยู่ในแฮชที่ส่งคืน อาจมีสาขาอื่นด้วย

"ยูอิด"
uuid ของอุปกรณ์นี้

"ฉลาก"
ฉลากของอุปกรณ์นี้

"รุ่น"
เวอร์ชันของคำสั่ง blkid

"พิมพ์"
ประเภทระบบไฟล์หรือ RAID ของอุปกรณ์นี้

"การใช้งาน"
การใช้งานอุปกรณ์นี้ เช่น "filesystem" หรือ "raid"

blockdev-flushbufs
อุปกรณ์ blockdev-flushbufs

สิ่งนี้บอกให้เคอร์เนลล้างบัฟเฟอร์ภายในที่เกี่ยวข้องกับ "อุปกรณ์"

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-getbsz
อุปกรณ์ blockdev-getbsz

ส่งคืนขนาดบล็อกของอุปกรณ์

หมายเหตุ: สิ่งนี้แตกต่างจากทั้งสองอย่าง ขนาด in บล็อก และ ระบบแฟ้ม ปิดกั้น ขนาด. นี้ด้วย
การตั้งค่าไม่ได้ใช้โดยอะไรเลย คุณไม่น่าจะใช้มันเพื่ออะไร
ระบบไฟล์มีแนวคิดเกี่ยวกับขนาดบล็อกให้เลือก

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-getro
อุปกรณ์ blockdev-getro

ส่งกลับค่าบูลีนที่ระบุว่าอุปกรณ์บล็อกเป็นแบบอ่านอย่างเดียวหรือไม่ (true if read-only, false if
ไม่).

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-getsize64
blockdev-getsize64 อุปกรณ์

ซึ่งจะคืนค่าขนาดของอุปกรณ์เป็นไบต์

ดูเพิ่มเติมที่ "blockdev-getsz"

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-gets
blockdev-gets อุปกรณ์

ส่งคืนขนาดของเซกเตอร์บนอุปกรณ์บล็อก ปกติ 512 แต่อาจใหญ่กว่านี้สำหรับ
อุปกรณ์ที่ทันสมัย

(โปรดทราบว่านี่ไม่ใช่ขนาดในเซกเตอร์ ให้ใช้ "blockdev-getsz" สำหรับสิ่งนั้น)

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-getsz
อุปกรณ์ blockdev-getsz

ซึ่งจะคืนค่าขนาดของอุปกรณ์ในหน่วยของเซ็กเตอร์ 512 ไบต์ (แม้ว่าเซ็กเตอร์ขนาด
ไม่ใช่ 512 ไบต์ ... แปลก)

ดูเพิ่มเติมที่ "blockdev-getss" สำหรับขนาดเซกเตอร์จริงของอุปกรณ์ และ "blockdev-getsize64"
เพื่อประโยชน์มากขึ้น ขนาด in ไบต์.

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-อ่านซ้ำ
blockdev-rereadpt อุปกรณ์

อ่านตารางพาร์ติชั่นบน "อุปกรณ์" อีกครั้ง

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-setbsz
blockdev-setbsz อุปกรณ์ blocksize

การโทรนี้ไม่ทำอะไรเลยและไม่เคยทำอะไรเลยเนื่องจากข้อบกพร่องใน blockdev Do ไม่
ใช้ มัน

หากคุณต้องการตั้งค่าขนาดบล็อกของระบบไฟล์ ให้ใช้ตัวเลือก "ขนาดบล็อก" ของ "mkfs"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "mkfs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

blockdev-setra
ภาคอุปกรณ์ blockdev-setra

ตั้งค่า readahead (ในเซกเตอร์ 512 ไบต์) สำหรับอุปกรณ์

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-setro
อุปกรณ์ blockdev-setro

ตั้งค่าอุปกรณ์บล็อกชื่อ "อุปกรณ์" เป็นแบบอ่านอย่างเดียว

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

blockdev-setrw
อุปกรณ์ blockdev-setrw

ตั้งค่าอุปกรณ์บล็อกชื่อ "อุปกรณ์" ให้อ่าน-เขียน

สิ่งนี้ใช้ บล็อกเดฟ(8) คำสั่ง

btrfs-balance-ยกเลิก
btrfs-สมดุล-ยกเลิกเส้นทาง

ยกเลิกยอดเงินคงเหลือในระบบไฟล์ btrfs

btrfs-สมดุล-หยุดชั่วคราว
btrfs-balance-pause เส้นทาง

หยุดการรันบาลานซ์บนระบบไฟล์ btrfs ชั่วคราว

btrfs-สมดุล-ดำเนินการต่อ
btrfs-balance-เส้นทางประวัติย่อ

ทำยอดดุลที่หยุดชั่วคราวต่อบนระบบไฟล์ btrfs

btrfs-สมดุลสถานะ
btrfs-สมดุลสถานะเส้นทาง

แสดงสถานะของบาลานซ์ที่ทำงานอยู่หรือหยุดชั่วคราวบนระบบไฟล์ btrfs

btrfs-เพิ่มอุปกรณ์
btrfs-device-add 'อุปกรณ์ ...' fs

เพิ่มรายการอุปกรณ์ใน "อุปกรณ์" ให้กับระบบไฟล์ btrfs ที่ติดตั้งที่ "fs" ถ้า
"อุปกรณ์" เป็นรายการว่าง การดำเนินการนี้ไม่ทำอะไรเลย

btrfs-อุปกรณ์-ลบ
btrfs-device-delete 'อุปกรณ์ ...' fs

ลบ "อุปกรณ์" ออกจากระบบไฟล์ btrfs ที่ติดตั้งที่ "fs" หาก "อุปกรณ์" ว่างเปล่า
รายการนี้ไม่ทำอะไรเลย

btrfs-ระบบไฟล์-สมดุล
btrfs-สมดุล
btrfs-ระบบไฟล์-สมดุล fs

ปรับสมดุลชิ้นส่วนในระบบไฟล์ btrfs ที่ติดตั้งที่ "fs" ในอุปกรณ์พื้นฐาน

btrfs-filesystem-จัดเรียงข้อมูล
btrfs-filesystem-defrag path [flush:true|false] [บีบอัด:..]

จัดระเบียบไฟล์หรือไดเร็กทอรีบนระบบไฟล์ btrfs การบีบอัดเป็นหนึ่งใน zlib หรือ lzo

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfs-ระบบไฟล์ปรับขนาด
btrfs-filesystem-resize mountpoint [ขนาด:N]

คำสั่งนี้ปรับขนาดระบบไฟล์ btrfs

โปรดทราบว่าระบบไฟล์ต้องติดตั้งและพารามิเตอร์ is . ไม่เหมือนกับการเรียกปรับขนาดอื่นๆ
mountpoint ไม่ใช่อุปกรณ์ (นี่เป็นข้อกำหนดของ btrfs เอง)

พารามิเตอร์ทางเลือกคือ:

"ขนาด"
ขนาดใหม่ (เป็นไบต์) ของระบบไฟล์ หากละเว้น ระบบไฟล์จะถูกปรับขนาดเป็น
ขนาดสูงสุด

ดูสิ่งนี้ด้วย btrfs(8)

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfs-ระบบไฟล์-sync
btrfs-ระบบไฟล์-ซิงค์ fs

บังคับให้ซิงค์บนระบบไฟล์ btrfs ที่ติดตั้งที่ "fs"

btrfs-fsck
อุปกรณ์ btrfs-fsck [superblock:N] [repair:true|false]

ใช้เพื่อตรวจสอบระบบไฟล์ btrfs "อุปกรณ์" คือไฟล์อุปกรณ์ที่ระบบไฟล์อยู่
เก็บไว้

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfs-ภาพ
btrfs-image 'แหล่งที่มา ...' รูปภาพ [บีบอัดระดับ: N]

ใช้เพื่อสร้างอิมเมจของระบบไฟล์ btrfs ข้อมูลทั้งหมดจะเป็นศูนย์ แต่
ข้อมูลเมตาและสิ่งที่คล้ายกันจะได้รับการเก็บรักษาไว้

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfs-qgroup-กำหนด
btrfs-qgroup-assign src dst เส้นทาง

เพิ่ม qgroup "src" ในพาเรนต์ qgroup "dst" คำสั่งนี้สามารถจัดกลุ่ม qgroups หลายกลุ่มเป็น a
parent qgroup เพื่อแบ่งปันขีด จำกัด ทั่วไป

btrfs-qgroup-สร้าง
btrfs-qgroup-สร้างวอลุ่มย่อย qgroupid

สร้างกลุ่มโควต้า (qgroup) สำหรับโวลุ่มย่อยที่ "subvolume"

btrfs-qgroup-ทำลาย
btrfs-qgroup- ทำลาย qgroupid subvolume

ทำลายกลุ่มโควต้า

btrfs-qgroup-จำกัด
btrfs-qgroup-limit ขนาดวอลุ่มย่อย

จำกัดขนาดของ subvolume ซึ่งพาธคือ "subvolume" "ขนาด" สามารถมีคำต่อท้ายของ G, M,
หรือเค

btrfs-qgroup-ลบ
btrfs-qgroup-ลบเส้นทาง src dst

ลบ qgroup "src" ออกจากพาเรนต์ qgroup "dst"

btrfs-qgroup-แสดง
btrfs-qgroup-แสดงเส้นทาง

แสดงกลุ่มโควต้าย่อยทั้งหมดในระบบไฟล์ btrfs รวมถึงการใช้งาน

btrfs-โควตาเปิดใช้งาน
btrfs-โควตาเปิดใช้งาน fs true|false

เปิดใช้งานหรือปิดใช้งานการสนับสนุนโควต้าซับโวลุ่มสำหรับระบบไฟล์ที่มี "เส้นทาง"

btrfs-โควต้า-rescan
btrfs-โควตา-สแกนใหม่ fs

ทิ้งหมายเลข qgroup ทั้งหมดและสแกนข้อมูลเมตาอีกครั้งด้วยการกำหนดค่าปัจจุบัน

btrfs-แทนที่
btrfs-แทนที่ srcdev targetdev mntpoint

แทนที่อุปกรณ์ของระบบไฟล์ btrfs บนระบบไฟล์สด ทำซ้ำข้อมูลไปที่
อุปกรณ์เป้าหมายซึ่งปัจจุบันจัดเก็บไว้ในอุปกรณ์ต้นทาง หลังจากเสร็จสิ้น
การดำเนินการ อุปกรณ์ต้นทางจะถูกลบออกและลบออกจากระบบไฟล์

"targetdev" ต้องมีขนาดเท่ากันหรือใหญ่กว่า "srcdev" อุปกรณ์ที่
ไม่อนุญาตให้ใช้เป็น "targetdev" ที่ติดตั้งอยู่ในปัจจุบัน

btrfs-กู้ภัย-ก้อน-กู้คืน
btrfs-rescue-chunk-recover อุปกรณ์

กู้คืนแผนผังกลุ่มของระบบไฟล์ btrfs โดยการสแกนอุปกรณ์ทีละตัว

btrfs-rescue-super-กู้คืน
btrfs-rescue-super-recover อุปกรณ์

กู้คืน superblock ที่ไม่ดีจากสำเนาที่ดี

btrfs-ขัด-ยกเลิก
btrfs-scrub-ยกเลิกเส้นทาง

ยกเลิกการใช้สครับบนระบบไฟล์ btrfs

btrfs-ขัด-ประวัติ
btrfs-scrub-resume เส้นทาง

ดำเนินการขัดถูที่ยกเลิกหรือขัดจังหวะก่อนหน้านี้บนระบบไฟล์ btrfs

btrfs-ขัด-เริ่ม
เส้นทาง btrfs-scrub-start

อ่านข้อมูลและข้อมูลเมตาทั้งหมดบนระบบไฟล์ และใช้เช็คซัมและค่าที่ซ้ำกัน
คัดลอกจากที่จัดเก็บข้อมูล RAID เพื่อระบุและซ่อมแซมข้อมูลที่เสียหาย

btrfs-ขัดสถานะ
btrfs-scrub-สถานะเส้นทาง

แสดงสถานะของการขัดถูที่กำลังทำงานหรือเสร็จสิ้นบนระบบไฟล์ btrfs

btrfs-set-seing
btrfs-set-seding อุปกรณ์ true|false

เปิดใช้งานหรือปิดใช้งานคุณลักษณะการเพาะของอุปกรณ์ที่มีระบบไฟล์ btrfs

btrfs-subvolume-สร้าง
btrfs-subvolume-creation-opts
btrfs-subvolume- สร้างปลายทาง [qgroupid:..]

สร้างวอลุ่มย่อย btrfs อาร์กิวเมนต์ "dest" คือไดเร็กทอรีปลายทางและชื่อ
ของ subvolume ในรูปแบบ /path/to/dest/name. พารามิเตอร์ทางเลือก "qgroupid"
แสดงถึง qgroup ซึ่งจะมีการเพิ่ม subvolume ที่สร้างขึ้นใหม่

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfs-subvolume-ลบ
btrfs-subvolume-ลบ subvolume

ลบไดรฟ์ข้อมูลย่อยหรือสแน็ปช็อตที่มีชื่อ btrfs

btrfs-subvolume-get-default
btrfs-subvolume-get-default fs

รับไดรฟ์ข้อมูลย่อยเริ่มต้นหรือสแน็ปช็อตของระบบไฟล์ที่ติดตั้งที่ "จุดเชื่อมต่อ"

btrfs-subvolume-รายการ
btrfs-subvolume-รายการ fs

แสดงรายการสแน็ปช็อต btrfs และโวลุ่มย่อยของระบบไฟล์ btrfs ซึ่งติดตั้งที่ "fs"

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

ตั้งค่า subvolume ของระบบไฟล์ btrfs "fs" ซึ่งจะถูกเมาต์โดยค่าเริ่มต้น ดู
"btrfs-subvolume-list" เพื่อรับรายการของ subvolume

btrfs-subvolume-แสดง
btrfs-subvolume-แสดง subvolume

ส่งคืนข้อมูลโดยละเอียดของโวลุ่มย่อย

btrfs-subvolume-ภาพรวม
btrfs-subvolume-snapshot-opts
btrfs-subvolume-snapshot แหล่งที่มาปลายทาง [ro:true|false] [qgroupid:..]

สร้างสแน็ปช็อตของ "แหล่งที่มา" ของวอลุ่มย่อย btrfs อาร์กิวเมนต์ "dest" คือปลายทาง
ไดเร็กทอรีและชื่อของสแน็ปช็อตในรูปแบบ /path/to/dest/name. โดยค่าเริ่มต้น
สแน็ปช็อตที่สร้างขึ้นใหม่สามารถเขียนได้หากค่าของพารามิเตอร์ทางเลือก "ro" เป็นจริง
สร้างสแน็ปช็อตแบบอ่านอย่างเดียว พารามิเตอร์ทางเลือก "qgroupid" หมายถึง qgroup
ซึ่งสแนปชอตที่สร้างขึ้นใหม่จะถูกเพิ่มเข้าไป

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

btrfstune-เปิดใช้งาน-ขยาย-inode-refs
btrfstune-enable-extended-inode-refs อุปกรณ์

สิ่งนี้จะเปิดใช้งานการอ้างอิง inode แบบขยาย

btrfstune-enable-skinny-metadata-extent-refs
btrfstune-enable-skinny-metadata-extent-refs อุปกรณ์

สิ่งนี้เปิดใช้งานการอ้างอิงขอบเขตข้อมูลเมตาแบบบาง

btrfsune-เมล็ด
btrfsune-seding อุปกรณ์ true|false

เปิดใช้งานการ seeding ของอุปกรณ์ btrfs การดำเนินการนี้จะบังคับให้ fs อ่านได้อย่างเดียวเพื่อให้คุณสามารถใช้งานได้
สร้างระบบไฟล์อื่นๆ

c-ตัวชี้
c-ตัวชี้

ในการโยงภาษาที่ไม่ใช่ C สิ่งนี้ทำให้คุณสามารถดึงตัวชี้ C พื้นฐานไปยัง
ที่จับ (เช่น "h *") จุดประสงค์คือเพื่อให้ห้องสมุดอื่นสามารถทำงานร่วมกันได้
libguestfs

ชื่ออุปกรณ์มาตรฐาน
อุปกรณ์ชื่ออุปกรณ์ตามรูปแบบบัญญัติ

ฟังก์ชันยูทิลิตี้นี้มีประโยชน์เมื่อแสดงชื่ออุปกรณ์ต่อผู้ใช้ มันต้องใช้เวลา
จำนวนชื่ออุปกรณ์ที่ผิดปกติและส่งคืนในรูปแบบที่สอดคล้องกัน:

/dev/hdX
/dev/vdX
สิ่งเหล่านี้จะถูกส่งคืนเป็น / dev / sdX. โปรดทราบว่าสิ่งนี้ใช้ได้กับชื่ออุปกรณ์และชื่อพาร์ติชั่น
นี่เป็นการย้อนกลับของอัลกอริทึมที่อธิบายไว้ใน "BLOCK DEVICE NAMING" โดยประมาณ
in แขก(3)

/dev/ผู้ทำแผนที่/VG-LV
/dev/dm-N
แปลงเป็น /dev/VG/LV แบบฟอร์มโดยใช้ "lvm-canonical-lv-name"

สตริงอื่น ๆ จะถูกส่งกลับโดยไม่มีการแก้ไข

cap-รับไฟล์
cap-get-file เส้นทาง

ฟังก์ชันนี้ส่งคืนความสามารถของ Linux ที่แนบกับ "เส้นทาง" ความสามารถที่ตั้งไว้คือ
ส่งคืนในรูปแบบข้อความ (ดู cap_to_text(พ.ศ. 3)).

หากไม่มีความสามารถแนบมากับไฟล์ สตริงว่างจะถูกส่งคืน

cap-set-ไฟล์
cap-set-file เส้นทาง cap

ฟังก์ชันนี้ตั้งค่าความสามารถของ Linux ที่แนบกับ "เส้นทาง" ความสามารถชุด "หมวก"
ควรส่งในรูปแบบข้อความ (ดู cap_from_text(พ.ศ. 3)).

ตัวพิมพ์เล็ก-ใหญ่-เส้นทาง
ตัวพิมพ์เล็ก-ใหญ่-เส้นทางพาธ

สามารถใช้เพื่อแก้ไขพา ธ ที่ไม่คำนึงถึงขนาดตัวพิมพ์บนระบบไฟล์ซึ่งเป็นตัวพิมพ์ใหญ่และตัวพิมพ์ใหญ่
อ่อนไหว. กรณีการใช้งานคือการแก้ไขเส้นทางที่คุณได้อ่านจาก Windows
ไฟล์การกำหนดค่าหรือ Windows Registry ไปยังเส้นทางที่แท้จริง

คำสั่งจัดการลักษณะเฉพาะของไดรเวอร์ระบบไฟล์ Linux ntfs-3g (และอาจจะ
อื่น ๆ ) ซึ่งก็คือแม้ว่าระบบไฟล์พื้นฐานจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ แต่ไดรเวอร์
ส่งออกระบบไฟล์ไปยัง Linux โดยคำนึงถึงขนาดตัวพิมพ์

ผลที่ตามมาประการหนึ่งคือไดเร็กทอรีพิเศษเช่น C:\หน้าต่าง อาจปรากฏเป็น
/หน้าต่าง or /หน้าต่าง (หรืออย่างอื่น) แล้วแต่รายละเอียดว่าเป็นอย่างไร
สร้าง. ใน Windows เอง นี่คงไม่ใช่ปัญหา

ข้อบกพร่องหรือคุณลักษณะ? คุณตัดสินใจ: http://www.tuxera.com/community/ntfs-3g-faq/#posixชื่อไฟล์1

" case-sensitive-path" พยายามแก้ไขกรณีจริงของแต่ละองค์ประกอบในเส้นทาง มัน
จะส่งคืนพาธที่แก้ไขแล้ว หากมีพาธแบบเต็มหรือไดเร็กทอรีหลัก ถ้า
ไดเร็กทอรีหลักมีอยู่ แต่พาธเต็มไม่มี กรณีของไดเร็กทอรีหลักจะ
ได้รับการแก้ไขอย่างถูกต้องและส่วนที่เหลือต่อท้ายไม่แก้ไข ตัวอย่างเช่น ถ้าไฟล์
"/Windows/System32/netkvm.sys" มีอยู่:

"ตัวพิมพ์เล็ก-ใหญ่-พาธ" ("/windows/system32/netkvm.sys")
"Windows/System32/netkvm.sys"

"ตัวพิมพ์เล็ก-ใหญ่-พาธ" ("/windows/system32/NoSuchFile")
"Windows/System32/NoSuchFile"

"ตัวพิมพ์เล็ก-ใหญ่-พาธ" ("/windows/system33/netkvm.sys")
ข้อผิดพลาด

หมายเหตุ: เนื่องจากพฤติกรรมข้างต้น จึงไม่สามารถใช้ "case-sensitive-path" เพื่อตรวจสอบ
การมีอยู่ของไฟล์.

หมายเหตุ: ฟังก์ชันนี้ไม่รองรับชื่อไดรฟ์ แบ็กสแลช ฯลฯ

ดูเพิ่มเติมที่ "เส้นทางจริง"

แมว
เส้นทางแมว

ส่งคืนเนื้อหาของไฟล์ชื่อ "เส้นทาง"

เนื่องจากใน C ฟังก์ชันนี้จะคืนค่า "char *" จึงไม่มีวิธีแยกความแตกต่างระหว่าง
อักขระ "\0" ในไฟล์และส่วนท้ายของสตริง ในการจัดการไฟล์ไบนารีให้ใช้ "read-file"
หรือฟังก์ชัน "ดาวน์โหลด"

การตรวจสอบ
checksum csumtype เส้นทาง

การเรียกนี้จะคำนวณเช็คซัม MD5, SHAx หรือ CRC ของไฟล์ชื่อ "พาธ"

ประเภทของเช็คซัมที่จะคำนวณนั้นกำหนดโดยพารามิเตอร์ "csumtype" ซึ่งต้องมีหนึ่ง
ของค่าต่อไปนี้:

"ซีอาร์ซี"
คำนวณ cyclic redundancy check (CRC) ที่ระบุโดย POSIX สำหรับคำสั่ง "cksum"

"เอ็มดี5"
คำนวณแฮช MD5 (โดยใช้โปรแกรม "md5sum")

"ชา1"
คำนวณแฮช SHA1 (โดยใช้โปรแกรม "sha1sum")

"ชา224"
คำนวณแฮช SHA224 (โดยใช้โปรแกรม "sha224sum")

"ชา256"
คำนวณแฮช SHA256 (โดยใช้โปรแกรม "sha256sum")

"ชา384"
คำนวณแฮช SHA384 (โดยใช้โปรแกรม "sha384sum")

"ชา512"
คำนวณแฮช SHA512 (โดยใช้โปรแกรม "sha512sum")

เช็คซัมถูกส่งกลับเป็นสตริงที่พิมพ์ได้

ในการรับเช็คซัมสำหรับอุปกรณ์ ให้ใช้ "checksum-device"

หากต้องการรับเช็คซัมสำหรับไฟล์จำนวนมาก ให้ใช้ "checksums-out"

เช็คซัม-อุปกรณ์
ตรวจสอบอุปกรณ์ csumtype อุปกรณ์

การเรียกนี้จะคำนวณผลรวมการตรวจสอบ MD5, SHAx หรือ CRC ของเนื้อหาของอุปกรณ์ที่ชื่อ
"อุปกรณ์". สำหรับประเภทของเช็คซัมที่รองรับ โปรดดูคำสั่ง "checksum"

เช็คซัม-เอาท์
checksums-out ไดเร็กทอรี csumtype (sumsfile |-)

คำสั่งนี้คำนวณเช็คซัมของไฟล์ปกติทั้งหมดใน ไดเรกทอรี แล้วปล่อย a
รายการเช็คซัมเหล่านั้นไปยังไฟล์เอาต์พุตในเครื่อง "sumsfile"

สามารถใช้เพื่อตรวจสอบความสมบูรณ์ของเครื่องเสมือน อย่างไรก็ตามเพื่อให้ถูกต้อง
ปลอดภัยคุณควรให้ความสนใจกับผลลัพธ์ของคำสั่ง checksum (มันใช้คำสั่ง
จาก GNU coreutils) โดยเฉพาะอย่างยิ่งเมื่อชื่อไฟล์ไม่สามารถพิมพ์ได้ coreutils จะใช้ a
ไวยากรณ์แบ็กสแลชพิเศษ สำหรับข้อมูลเพิ่มเติม โปรดดูไฟล์ข้อมูล GNU coreutils

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

chmod
เส้นทางโหมด chmod

เปลี่ยนโหมด (สิทธิ์) ของ "เส้นทาง" เป็น "โหมด" รองรับเฉพาะโหมดตัวเลขเท่านั้น

หมายเหตุ: เมื่อใช้คำสั่งนี้จาก guestfish "mode" โดยค่าเริ่มต้นจะเป็นทศนิยม เว้นแต่
คุณนำหน้าด้วย 0 เพื่อรับฐานแปดเช่น ใช้ 0700 ไม่ใช่ 700

โหมดที่ตั้งไว้จริงได้รับผลกระทบจาก umask

chown
chown เจ้าของเส้นทางกลุ่ม

เปลี่ยนเจ้าของไฟล์เป็น "เจ้าของ" และกลุ่มเป็น "กลุ่ม"

รองรับเฉพาะตัวเลข uid และ gid หากคุณต้องการใช้ชื่อ คุณจะต้องค้นหา
และแยกไฟล์รหัสผ่านด้วยตัวเอง (การสนับสนุนของ Augea ทำให้สิ่งนี้ค่อนข้างง่าย)

การตั้งค่าแบ็กเอนด์ที่ชัดเจน
ชื่อการตั้งค่าแบ็กเอนด์ที่ชัดเจน

หากมีสตริงการตั้งค่าแบ็กเอนด์ที่ตรงกับ "name" หรือขึ้นต้นด้วย "name=" แสดงว่า
สตริงจะถูกลบออกจากการตั้งค่าแบ็กเอนด์

การเรียกนี้ส่งคืนจำนวนสตริงที่ถูกลบออก (ซึ่งอาจเป็น 0, 1 หรือมากกว่า
มากกว่า 1).

ดู "แบ็กเอนด์" ใน แขก(3), "การตั้งค่าแบ็กเอนด์" ใน แขก(3)

คำสั่ง
คำสั่ง 'ข้อโต้แย้ง ...'

การเรียกนี้รันคำสั่งจากระบบไฟล์ของแขก ต้องติดตั้งระบบไฟล์และ
ต้องมีระบบปฏิบัติการที่เข้ากันได้ (เช่น ลินุกซ์ ที่เหมือนกันหรือ
สถาปัตยกรรมโปรเซสเซอร์ที่เข้ากันได้)

พารามิเตอร์เดียวคือรายการอาร์กิวเมนต์รูปแบบ argv องค์ประกอบแรกคือชื่อของ
โปรแกรมที่จะรัน องค์ประกอบที่ตามมาคือพารามิเตอร์ รายการต้องไม่ว่างเปล่า (เช่น
ต้องมีชื่อโปรแกรม) โปรดทราบว่าคำสั่งทำงานโดยตรง และ is ไม่ เรียกผ่าน
เปลือก (ดู "sh")

ค่าที่ส่งคืนคือสิ่งที่พิมพ์ไปที่ แย่ โดยคำสั่ง

หากคำสั่งส่งคืนสถานะการออกที่ไม่ใช่ศูนย์ ฟังก์ชันนี้จะส่งคืนข้อผิดพลาด
ข้อความ. สตริงข้อความแสดงข้อผิดพลาดคือเนื้อหาของ สตเดอร์ จากคำสั่ง

ตัวแปรสภาพแวดล้อม $PATH จะมีอย่างน้อย / usr / bin และ / bin. หากคุณต้องการ
โปรแกรมจากตำแหน่งอื่น คุณควรระบุเส้นทางแบบเต็มในพารามิเตอร์แรก

ไลบรารีที่ใช้ร่วมกันและไฟล์ข้อมูลที่โปรแกรมต้องการต้องมีอยู่ในระบบไฟล์
ซึ่งติดตั้งในตำแหน่งที่ถูกต้อง เป็นความรับผิดชอบของผู้โทรเพื่อให้แน่ใจว่าทั้งหมด
ระบบไฟล์ที่จำเป็นจะถูกติดตั้งในตำแหน่งที่เหมาะสม

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

บรรทัดคำสั่ง
อาร์กิวเมนต์บรรทัดคำสั่ง ...

สิ่งนี้เหมือนกับ "คำสั่ง" แต่แยกผลลัพธ์ออกเป็นรายการบรรทัด

ดูเพิ่มเติม: "sh-lines"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

อุปกรณ์บีบอัดออก
อุปกรณ์ ctype ที่บีบอัด (zdevice |-) [ระดับ: N]

คำสั่งนี้จะบีบอัด "อุปกรณ์" และเขียนลงในไฟล์ในเครื่อง "zdevice"

พารามิเตอร์ "ctype" และ "ระดับ" ที่เป็นทางเลือกมีความหมายเดียวกับใน "compress-out"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ประคบ
บีบอัดไฟล์ ctype (zfile|-) [ระดับ:N]

คำสั่งนี้บีบอัด ไฟล์ และเขียนลงในไฟล์ในเครื่อง zfile.zfile.

โปรแกรมบีบอัดที่ใช้ถูกควบคุมโดยพารามิเตอร์ "ctype" ปัจจุบันนี้
รวมถึง: "บีบอัด", "gzip", "bzip2", "xz" หรือ "lzop" การบีบอัดบางประเภทอาจไม่
รองรับโดย libguestfs บิลด์โดยเฉพาะ ซึ่งในกรณีนี้คุณจะได้รับข้อผิดพลาด
มีสตริงย่อย "ไม่รองรับ"

พารามิเตอร์ "ระดับ" ทางเลือกจะควบคุมระดับการบีบอัด ความหมายและค่าเริ่มต้นสำหรับ
พารามิเตอร์นี้ขึ้นอยู่กับโปรแกรมบีบอัดที่ใช้

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

การตั้งค่า
กำหนดค่า hvparam hvvalue

สามารถใช้เพื่อเพิ่มพารามิเตอร์ไฮเปอร์ไวเซอร์ตามอำเภอใจของฟอร์ม -พารามิเตอร์ ความคุ้มค่า.
อันที่จริง มันไม่ได้เกิดขึ้นโดยพลการเลย - เราป้องกันไม่ให้คุณตั้งค่าพารามิเตอร์บางอย่างซึ่ง
จะรบกวนพารามิเตอร์ที่เราใช้

อักขระตัวแรกของสตริง "hvparam" ต้องเป็น "-" (ขีดกลาง)

"hvvalue" สามารถเป็น NULL ได้

คัดลอกแอตทริบิวต์
คัดลอกแอตทริบิวต์ src ปลายทาง [ทั้งหมด:จริง|เท็จ] [โหมด:จริง|เท็จ] [xattributes:จริง|เท็จ] [เจ้าของ:จริง|เท็จ]

คัดลอกแอตทริบิวต์ของพาธ (ซึ่งอาจเป็นไฟล์หรือไดเร็กทอรี) ไปยังพาธอื่น

โดยค่าเริ่มต้นแอตทริบิวต์ "ไม่" จะถูกคัดลอก ดังนั้นตรวจสอบให้แน่ใจว่าได้ระบุใดๆ (หรือ "ทั้งหมด" เพื่อคัดลอก
ทุกอย่าง).

อาร์กิวเมนต์ที่เป็นตัวเลือกระบุแอตทริบิวต์ที่สามารถคัดลอกได้:

"โหมด"
คัดลอกส่วนของโหมดไฟล์จาก "ต้นทาง" ไปที่ "ปลายทาง" เฉพาะสิทธิ์ UNIX
และบิตเหนียว/setuid/setgid สามารถคัดลอกได้

"แอตทริบิวต์x"
คัดลอกแอตทริบิวต์เพิ่มเติมของ Linux (xattrs) จาก "ต้นทาง" ไปที่ "ปลายทาง" ธงนี้
ไม่ทำอะไรเลยถ้า ลินุกซ์แซทเทอร์ ไม่มีคุณลักษณะนี้ (โปรดดู "คุณสมบัติพร้อมใช้งาน")

"ความเป็นเจ้าของ"
คัดลอก uid เจ้าของและ gid กลุ่มของ "source" ไปยัง "destination"

"ทั้งหมด"
คัดลอก ทั้งหมด คุณลักษณะจาก "ต้นทาง" ถึง "ปลายทาง" การเปิดใช้งานจะเปิดใช้งาน .ทั้งหมด
แฟล็กอื่นๆ หากไม่ได้ระบุไว้

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คัดลอกอุปกรณ์ไปยังอุปกรณ์
คัดลอกอุปกรณ์ไปยังอุปกรณ์ src ปลายทาง [srcoffset:N] [destoffset:N] [ขนาด:N] [กระจัดกระจาย:จริง|เท็จ] [ต่อท้าย:จริง|เท็จ]

ทั้งสี่เรียก "copy-device-to-device", "copy-device-to-file", "copy-file-to-device" และ
"copy-file-to-file" ให้คุณคัดลอกจากแหล่งที่มา (อุปกรณ์ | ไฟล์) ไปยังปลายทาง
(อุปกรณ์|ไฟล์).

สามารถทำสำเนาบางส่วนได้เนื่องจากคุณสามารถระบุออฟเซ็ตต้นทาง, ปลายทาง
ออฟเซ็ตและขนาดที่จะคัดลอก ค่าเหล่านี้ระบุเป็นไบต์ทั้งหมด หากไม่ได้รับ
ออฟเซ็ตทั้งค่าดีฟอลต์เป็นศูนย์ และค่าดีฟอลต์ของขนาดจะเป็นการคัดลอกให้มากที่สุดจนถึง
เรากดจุดสิ้นสุดของแหล่งที่มา

ต้นทางและปลายทางอาจเป็นวัตถุเดียวกัน อย่างไรก็ตามบริเวณที่ทับซ้อนกันอาจไม่
คัดลอกอย่างถูกต้อง

หากปลายทางเป็นไฟล์ ไฟล์นั้นจะถูกสร้างขึ้นหากจำเป็น หากไฟล์ปลายทางไม่ใช่
ใหญ่พอที่จะขยายออก

หากปลายทางเป็นไฟล์และไม่ได้ตั้งค่าสถานะ "ผนวก" แสดงว่าไฟล์ปลายทาง
ถูกตัดทอน หากตั้งค่าสถานะ "ผนวก" สำเนาจะต่อท้ายไฟล์ปลายทาง
ขณะนี้ไม่สามารถตั้งค่าสถานะ "ผนวก" สำหรับอุปกรณ์

หากค่าสถานะ "กระจัดกระจาย" เป็นจริง การเรียกจะหลีกเลี่ยงการเขียนบล็อกที่มีเพียงศูนย์เท่านั้น
ซึ่งสามารถช่วยได้ในบางสถานการณ์ที่มีการจัดสรรดิสก์สำรองแบบบาง สังเกตว่า
เว้นแต่เป้าหมายจะเป็นศูนย์แล้ว การใช้ตัวเลือกนี้จะส่งผลให้การคัดลอกไม่ถูกต้อง

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คัดลอกอุปกรณ์ไปยังไฟล์
copy-device-to-file src ปลายทาง [srcoffset:N] [destoffset:N] [ขนาด:N] [เบาบาง:จริง|เท็จ] [ต่อท้าย:จริง|เท็จ]

ดูภาพรวมทั่วไปของการโทรนี้ใน "คัดลอกอุปกรณ์ไปยังอุปกรณ์"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คัดลอกไฟล์ไปยังอุปกรณ์
คัดลอกไฟล์ไปยังอุปกรณ์ src ปลายทาง [srcoffset:N] [destoffset:N] [ขนาด:N] [กระจัดกระจาย:จริง|เท็จ] [ต่อท้าย:จริง|เท็จ]

ดูภาพรวมทั่วไปของการโทรนี้ใน "คัดลอกอุปกรณ์ไปยังอุปกรณ์"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คัดลอกไฟล์ไปยังไฟล์
copy-file-to-file src ปลายทาง [srcoffset:N] [destoffset:N] [ขนาด:N] [กระจัดกระจาย:จริง|เท็จ] [ต่อท้าย:จริง|เท็จ]

ดูภาพรวมทั่วไปของการโทรนี้ใน "คัดลอกอุปกรณ์ไปยังอุปกรณ์"

นี่คือ ไม่ ฟังก์ชั่นที่คุณต้องการสำหรับการคัดลอกไฟล์ ใช้สำหรับคัดลอกบล็อคภายใน
ไฟล์ที่มีอยู่ ดู "cp", "cp-a" และ "mv" สำหรับฟังก์ชันการคัดลอกและย้ายไฟล์ทั่วไป

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ขนาดสำเนา
คัดลอกขนาด src ขนาดปลายทาง

คำสั่งนี้จะคัดลอกไบต์ "ขนาด" จากอุปกรณ์ต้นทางหนึ่งหรือไฟล์ "src" ไปยังอีกเครื่องหนึ่ง
อุปกรณ์ปลายทางหรือไฟล์ "dest"

โปรดทราบว่าการดำเนินการนี้จะล้มเหลวหากต้นทางสั้นเกินไปหรือปลายทางมีขนาดไม่ใหญ่พอ

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ให้ใช้การโทร "คัดลอกอุปกรณ์ไปยังอุปกรณ์" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

cp
cp src ปลายทาง

สิ่งนี้จะคัดลอกไฟล์จาก "src" ถึง "dest" โดยที่ "dest" เป็นชื่อไฟล์ปลายทางหรือ
ไดเรกทอรีปลายทาง

ซีพี-เอ
cp-a src ปลายทาง

สิ่งนี้จะคัดลอกไฟล์หรือไดเร็กทอรีจาก "src" ไปยัง "dest" ซ้ำๆ โดยใช้ "cp -a"
คำสั่ง

ซีพี-อาร์
cp-r src ปลายทาง

สิ่งนี้จะคัดลอกไฟล์หรือไดเร็กทอรีจาก "src" ไปยัง "dest" ซ้ำๆ โดยใช้ "cp -rP"
คำสั่ง

ผู้ใช้ส่วนใหญ่ควรใช้ "cp-a" แทน คำสั่งนี้มีประโยชน์เมื่อคุณไม่ต้องการ
รักษาสิทธิ์เพราะระบบไฟล์เป้าหมายไม่รองรับ (โดยหลักเมื่อ
กำลังเขียนไปยังระบบไฟล์ DOS FAT)

cpio ออก
ไดเร็กทอรี cpio-out (cpiofile|-) [รูปแบบ:..]

คำสั่งนี้บรรจุเนื้อหาของ ไดเรกทอรี และดาวน์โหลดไฟล์ในเครื่อง "cpiofile"

สามารถใช้พารามิเตอร์ "รูปแบบ" ที่เป็นทางเลือกเพื่อเลือกรูปแบบได้ ต่อไปนี้เท่านั้น
รูปแบบที่ได้รับอนุญาตในขณะนี้:

"นิวซี"
รูปแบบพกพาใหม่ (SVR4) รูปแบบนี้เข้ากันได้กับ cpio-like
รูปแบบที่ใช้โดยเคอร์เนล Linux สำหรับ initramfs

นี่คือรูปแบบเริ่มต้น

"ซีอาร์ซี"
รูปแบบพกพาใหม่ (SVR4) พร้อมเช็คซัม

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

dd
dd src ปลายทาง

คำสั่งนี้คัดลอกจากอุปกรณ์ต้นทางหรือไฟล์ "src" ไปยังอุปกรณ์ปลายทางอื่นหรือ
ไฟล์ "dest" โดยปกติคุณจะใช้สิ่งนี้เพื่อคัดลอกไปยังหรือจากอุปกรณ์หรือพาร์ติชั่นสำหรับ
ตัวอย่างการทำสำเนาระบบไฟล์

หากปลายทางคืออุปกรณ์ จะต้องใหญ่เท่ากับหรือใหญ่กว่าไฟล์ต้นทางหรือ
อุปกรณ์ มิฉะนั้น การคัดลอกจะล้มเหลว คำสั่งนี้ไม่สามารถทำสำเนาบางส่วนได้ (ดู "คัดลอก-
อุปกรณ์ต่ออุปกรณ์")

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ให้ใช้การโทร "คัดลอกอุปกรณ์ไปยังอุปกรณ์" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ดัชนีอุปกรณ์
อุปกรณ์ดัชนีอุปกรณ์

ฟังก์ชันนี้ใช้ชื่ออุปกรณ์ (เช่น "/dev/sdb") และส่งคืนดัชนีของอุปกรณ์ใน
รายการอุปกรณ์

หมายเลขดัชนีเริ่มต้นจาก 0 อุปกรณ์ที่มีชื่อต้องมีอยู่ เช่น เป็นสตริงที่ส่งคืน
จาก "รายการอุปกรณ์"

ดูเพิ่มเติมที่ "list-devices", "part-to-dev"

df
df

คำสั่งนี้เรียกใช้คำสั่ง "df" เพื่อรายงานพื้นที่ดิสก์ที่ใช้

คำสั่งนี้มีประโยชน์สำหรับเซสชันแบบโต้ตอบเป็นส่วนใหญ่ มันคือ ไม่ ตั้งใจให้คุณลอง
เพื่อแยกวิเคราะห์สตริงเอาต์พุต ใช้ "statvfs" จากโปรแกรม

df-h
df-h

คำสั่งนี้รันคำสั่ง "df -h" เพื่อรายงานพื้นที่ดิสก์ที่ใช้ในรูปแบบที่มนุษย์อ่านได้

คำสั่งนี้มีประโยชน์สำหรับเซสชันแบบโต้ตอบเป็นส่วนใหญ่ มันคือ ไม่ ตั้งใจให้คุณลอง
เพื่อแยกวิเคราะห์สตริงเอาต์พุต ใช้ "statvfs" จากโปรแกรม

ดิสก์สร้าง
ขนาดรูปแบบชื่อไฟล์สร้างดิสก์ [backingfile:..] [backingformat:..] [preallocation:..] [compat:..] [clustersize:N]

สร้างอิมเมจดิสก์เปล่าที่เรียกว่า ชื่อไฟล์ (ไฟล์โฮสต์) ที่มีรูปแบบ "รูปแบบ" (โดยปกติ
"ดิบ" หรือ "qcow2") ขนาดคือ "ขนาด" ไบต์

หากใช้กับพารามิเตอร์ "backingfile" ที่เป็นตัวเลือก สแน็ปช็อตจะถูกสร้างขึ้นที่ด้านบนของ
ไฟล์สำรอง ในกรณีนี้ ต้องส่ง "ขนาด" เป็น "-1" ขนาดของสแนปชอต
เท่ากับขนาดของไฟล์สำรองซึ่งถูกค้นพบโดยอัตโนมัติ คุณคือ
สนับสนุนให้ส่ง "backingformat" เพื่ออธิบายรูปแบบของ "backingfile" ด้วย

If ชื่อไฟล์ หมายถึงอุปกรณ์บล็อกจากนั้นอุปกรณ์จะถูกฟอร์แมต "ขนาด" จะถูกละเว้น
เนื่องจากอุปกรณ์บล็อกมีขนาดที่แท้จริง

พารามิเตอร์ทางเลือกอื่นๆ ได้แก่:

"การจัดสรรล่วงหน้า"
หากรูปแบบเป็น "ดิบ" อาจเป็น "ปิด" (หรือ "เบาบาง") หรือ "เต็ม" เพื่อสร้าง
ไฟล์กระจัดกระจายหรือจัดสรรทั้งหมดตามลำดับ ค่าเริ่มต้นคือ "ปิด"

หากรูปแบบเป็น "qcow2" อาจเป็น "ปิด" (หรือ "กระจัดกระจาย") "ข้อมูลเมตา" หรือ "เต็ม"
การจัดสรรข้อมูลเมตาล่วงหน้าอาจเร็วขึ้นเมื่อเขียนจำนวนมาก แต่ใช้พื้นที่มากขึ้น
ค่าเริ่มต้นคือ "ปิด"

"คู่กัน"
"qcow2" เท่านั้น: ส่งสตริง 1.1 เพื่อใช้รูปแบบ qcow2 ขั้นสูงที่รองรับโดย qemu ≥
1.1.

"ขนาดคลัสเตอร์"
"qcow2" เท่านั้น: เปลี่ยนขนาดคลัสเตอร์ qcow2 ค่าเริ่มต้นคือ 65536 (ไบต์) และนี่
การตั้งค่าอาจเป็นกำลังสองค่าระหว่าง 512 ถึง 2097152

โปรดทราบว่าการเรียกนี้ไม่ได้เพิ่มดิสก์ใหม่ให้กับแฮนเดิล คุณอาจต้องเรียก "เพิ่ม-
ตัวเลือกไดรฟ์" แยกกัน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ดิสก์รูปแบบ
ชื่อไฟล์รูปแบบดิสก์

ตรวจจับและส่งคืนรูปแบบของดิสก์อิมเมจที่เรียกว่า ชื่อไฟล์. ชื่อไฟล์ ยังสามารถเป็นไฟล์
อุปกรณ์โฮสต์ ฯลฯ หากตรวจไม่พบรูปแบบของรูปภาพ แสดงว่า "ไม่ทราบ" คือ
กลับ

โปรดทราบว่าการตรวจจับรูปแบบดิสก์อาจไม่ปลอดภัยในบางกรณี ดู
"CVE-2010-3851" ใน แขก(3)

ดูเพิ่มเติม: "รูปแบบดิสก์อิมเมจ" ใน แขก(3)

ดิสก์มีสำรองไฟล์
disk-has-backing-file ชื่อไฟล์

ตรวจจับและส่งคืนดิสก์อิมเมจ ชื่อไฟล์ มีไฟล์สำรอง

โปรดทราบว่าการตรวจจับคุณสมบัติของดิสก์อาจไม่ปลอดภัยในบางกรณี ดู
"CVE-2010-3851" ใน แขก(3)

ดิสก์เสมือนขนาด
ชื่อไฟล์ขนาดดิสก์เสมือน

ตรวจจับและส่งคืนขนาดเสมือนเป็นไบต์ของภาพดิสก์ที่เรียกว่า ชื่อไฟล์.

โปรดทราบว่าการตรวจจับคุณสมบัติของดิสก์อาจไม่ปลอดภัยในบางกรณี ดู
"CVE-2010-3851" ใน แขก(3)

dmesg
dmesg

ส่งคืนข้อความเคอร์เนล (เอาต์พุต "dmesg") จากเคอร์เนลของแขก นี่คือ
บางครั้งมีประโยชน์สำหรับการดีบักแบบขยายของปัญหา

อีกวิธีในการรับข้อมูลเดียวกันคือเปิดใช้งานข้อความแบบละเอียดด้วย "set-verbose"
หรือโดยการตั้งค่าตัวแปรสภาพแวดล้อม "LIBGUESTFS_DEBUG=1" ก่อนรันโปรแกรม

ดาวน์โหลด
ดาวน์โหลด remotefilename (ชื่อไฟล์|-)

ดาวน์โหลดไฟล์ ชื่อไฟล์ระยะไกล และบันทึกเป็น ชื่อไฟล์ บนเครื่องท้องถิ่น

ชื่อไฟล์ สามารถเป็นไปป์ที่มีชื่อได้

ดูเพิ่มเติมที่ "อัปโหลด", "แมว"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

ดาวน์โหลด-offset
download-offset remotefilename (ชื่อไฟล์|-) offset size

ดาวน์โหลดไฟล์ ชื่อไฟล์ระยะไกล และบันทึกเป็น ชื่อไฟล์ บนเครื่องท้องถิ่น

ชื่อไฟล์ระยะไกล ถูกอ่านสำหรับไบต์ "ขนาด" เริ่มต้นที่ "ออฟเซ็ต" (ภูมิภาคนี้จะต้องอยู่ภายใน
ไฟล์หรืออุปกรณ์)

โปรดทราบว่าไม่มีการจำกัดปริมาณข้อมูลที่สามารถดาวน์โหลดได้ด้วยการโทรนี้
ไม่เหมือนกับ "pread" และการโทรนี้จะอ่านจำนวนเต็มเสมอเว้นแต่จะเกิดข้อผิดพลาด

ดูเพิ่มเติมที่ "ดาวน์โหลด", "เตรียม"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

วางแคช
ดรอปแคช whattodrop

สิ่งนี้แนะนำให้เคอร์เนลของแขกวางแคชของเพจ และ/หรือ dentries และแคชไอโหนด
พารามิเตอร์ "whattodrop" บอกเคอร์เนลว่าจะปล่อยอะไรอย่างแม่นยำ ดู
http://linux-mm.org/Drop_Caches

การตั้งค่า "whattodrop" เป็น 3 ควรทิ้งทุกอย่าง

นี้เรียกโดยอัตโนมัติ ซิงค์(2) ก่อนดำเนินการเพื่อให้หน่วยความจำแขกสูงสุดคือ
เป็นอิสระ

du
ดูเส้นทาง

คำสั่งนี้รันคำสั่ง "du -s" เพื่อประมาณการใช้พื้นที่ไฟล์สำหรับ "path"

"เส้นทาง" สามารถเป็นไฟล์หรือไดเร็กทอรี หาก "เส้นทาง" เป็นไดเร็กทอรี ค่าประมาณจะรวม
เนื้อหาของไดเร็กทอรีและไดเร็กทอรีย่อยทั้งหมด (เรียกซ้ำ)

ผลลัพธ์ที่ได้คือขนาดโดยประมาณใน กิโลไบต์ (เช่น หน่วย 1024 ไบต์)

e2fsck
อุปกรณ์ e2fsck [ถูกต้อง:จริง|เท็จ] [บังคับ:จริง|เท็จ]

สิ่งนี้จะเรียกใช้ตัวตรวจสอบระบบไฟล์ ext2/ext3 บน "อุปกรณ์" สามารถดำเนินการดังต่อไปนี้
อาร์กิวเมนต์ตัวเลือก:

"ถูกต้อง"
ซ่อมแซมระบบไฟล์โดยอัตโนมัติ ตัวเลือกนี้จะทำให้ e2fsck ทำงานโดยอัตโนมัติ
แก้ไขปัญหาระบบไฟล์ที่สามารถแก้ไขได้อย่างปลอดภัยโดยปราศจากการแทรกแซงของมนุษย์

ไม่สามารถระบุตัวเลือกนี้พร้อมกับตัวเลือก "forceall"

"ฟอร์ซซอล"
สมมติว่าคำตอบของ 'ใช่' สำหรับทุกคำถาม อนุญาตให้ใช้ e2fsck ไม่ใช่
โต้ตอบ

ไม่สามารถระบุตัวเลือกนี้พร้อมกับตัวเลือก "ถูกต้อง"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

e2fsck-ฉ
อุปกรณ์ e2fsck-f

สิ่งนี้รัน "e2fsck -p -f device" เช่น เรียกใช้ตัวตรวจสอบระบบไฟล์ ext2 / ext3 บน "อุปกรณ์"
ไม่โต้ตอบ (-p) แม้ว่าระบบไฟล์จะดูสะอาดสะอ้าน (-f).

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "e2fsck" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เสียงก้องภูต
echo-daemon 'คำ ...'

คำสั่งนี้เชื่อมรายการ "คำ" ที่ส่งผ่านด้วยช่องว่างเดียวระหว่างคำเหล่านั้นกับ
ส่งคืนสตริงผลลัพธ์

คุณสามารถใช้คำสั่งนี้เพื่อทดสอบการเชื่อมต่อผ่านไปยัง daemon

ดูเพิ่มเติมที่ "ping-daemon"

นกกระยาง
เส้นทาง egrep regex

สิ่งนี้เรียกโปรแกรม "egrep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

อีเกรปี
เส้นทาง egrepi regex

สิ่งนี้เรียกโปรแกรม "egrep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เท่ากัน
เท่ากับ file1 file2

สิ่งนี้เปรียบเทียบทั้งสองไฟล์ file1 และ file2 และคืนค่าเป็น จริง หากเนื้อหาตรงกันทุกประการ
เท่ากับหรือเท็จเป็นอย่างอื่น

ภายนอก CMP(1) โปรแกรมใช้สำหรับการเปรียบเทียบ

ที่มีอยู่
เส้นทางที่มีอยู่

ค่านี้จะส่งคืน "จริง" หากมีไฟล์ ไดเร็กทอรี (หรืออะไรก็ตาม) ที่ระบุ
ชื่อ "เส้นทาง"

ดูเพิ่มเติมที่ "is-file", "is-dir", "stat"

เอ็กซ์ลินุกซ์
ไดเร็กทอรี extlinux

ติดตั้ง SYSLINUX bootloader บนอุปกรณ์ที่ติดตั้งที่ ไดเรกทอรี. ไม่เหมือนกับ "syslinux"
ซึ่งต้องใช้ระบบไฟล์ FAT สามารถใช้กับระบบไฟล์ ext2/3/4 หรือ btrfs

การขอ ไดเรกทอรี พารามิเตอร์สามารถเป็นได้ทั้ง mountpoint หรือไดเร็กทอรีภายใน mountpoint

คุณต้องทำเครื่องหมายพาร์ติชั่นเป็น "active" ("part-set-bootable") และ Master Boot
ต้องติดตั้งบันทึก (เช่น ใช้ "pwrite-device") ในส่วนแรกของทั้งหมด
ดิสก์. แพ็คเกจ SYSLINUX มาพร้อมกับ Master Boot Records ที่เหมาะสม ดู
เอ็กซ์ลินุกซ์(1) หน้าคนสำหรับข้อมูลเพิ่มเติม

สามารถกำหนดค่าเพิ่มเติมให้กับ SYSLINUX ได้โดยการวางไฟล์ชื่อ
extlinux.conf บนระบบไฟล์ภายใต้ ไดเรกทอรี. สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ
เนื้อหาของไฟล์นี้ ดู เอ็กซ์ลินุกซ์(1)

ดูเพิ่มเติมที่ "syslinux"

ตกหลุม
เส้นทางที่ผิด len

คำสั่งนี้จัดสรรไฟล์ล่วงหน้า (มีศูนย์ไบต์) ชื่อ "เส้นทาง" ขนาด "len" ไบต์
หากไฟล์นั้นมีอยู่แล้ว ไฟล์นั้นจะถูกเขียนทับ

อย่าสับสนกับคำสั่ง "alloc" เฉพาะ guestfish ซึ่งจัดสรรไฟล์ใน
โฮสต์และแนบเป็นอุปกรณ์

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "fallocate64" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ตกหล่น64
fallocate64 เส้นทาง len

คำสั่งนี้จัดสรรไฟล์ล่วงหน้า (มีศูนย์ไบต์) ชื่อ "เส้นทาง" ขนาด "len" ไบต์
หากไฟล์นั้นมีอยู่แล้ว ไฟล์นั้นจะถูกเขียนทับ

โปรดทราบว่าการเรียกนี้จะจัดสรรบล็อกดิสก์สำหรับไฟล์ ในการสร้างไฟล์กระจัดกระจายใช้
"ตัดขนาด" แทน

การเรียกที่เลิกใช้แล้ว "fallocate" ทำเช่นเดียวกัน แต่เนื่องจากการกำกับดูแลจึงอนุญาตเท่านั้น
กำหนดความยาวได้ 30 บิต ซึ่งจะจำกัดขนาดสูงสุดของไฟล์ที่สร้างขึ้นอย่างมีประสิทธิภาพ
ผ่านการโทรนั้นไปยัง 1GB

อย่าสับสนกับคำสั่ง "alloc" และ "sparse" เฉพาะของ guestfish ซึ่งสร้าง
ไฟล์ในโฮสต์และแนบเป็นอุปกรณ์

ฟีเจอร์พร้อมใช้งาน
'กลุ่ม ...' ที่มีคุณลักษณะ

สิ่งนี้เหมือนกับ "มี" แต่ไม่เหมือนการเรียกนั้นส่งคืน true/false . อย่างง่าย
ผลลัพธ์แบบบูลีน แทนที่จะส่งข้อยกเว้นหากไม่พบคุณลักษณะ สำหรับอื่นๆ
เอกสารโปรดดูที่ "มี"

เอฟเกรป
เส้นทางรูปแบบ fgrep

สิ่งนี้เรียกโปรแกรม "fgrep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ฟเกรปี
เส้นทางรูปแบบ fgrepi

สิ่งนี้เรียกโปรแกรม "fgrep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ไฟล์
พา ธ ไฟล์

การโทรนี้ใช้มาตรฐาน ไฟล์(1) คำสั่งกำหนดประเภทหรือเนื้อหาของไฟล์

การเรียกนี้จะดูโปร่งใสภายในไฟล์บีบอัดประเภทต่างๆ

คำสั่งที่แน่นอนซึ่งทำงานคือ "file -zb path" โปรดสังเกตว่าชื่อไฟล์คือ
ไม่ได้ต่อท้ายผลลัพธ์ (the -b ตัวเลือก)

ผลลัพธ์ขึ้นอยู่กับผลลัพธ์ของพื้นฐาน ไฟล์(1) คำสั่งและสามารถเปลี่ยนใน
อนาคตในรูปแบบที่อยู่เหนือการควบคุมของเรา กล่าวอีกนัยหนึ่ง ผลลัพธ์ไม่รับประกันโดย
เอบีไอ.

See also: ไฟล์(1), "vfs-type", "lstat", "is-file", "is-blockdev" (ฯลฯ ), "is-zero"

ไฟล์-สถาปัตยกรรม
ชื่อไฟล์สถาปัตยกรรมไฟล์

สิ่งนี้ตรวจจับสถาปัตยกรรมของไบนารี ชื่อไฟล์และส่งคืนหากทราบ

สถาปัตยกรรมที่กำหนดไว้ในปัจจุบันคือ:

"ไอ386"
สตริงนี้ถูกส่งกลับสำหรับไบนารี 32 บิต i386, i486, i586, i686 ทั้งหมดโดยไม่คำนึงถึง
ข้อกำหนดโปรเซสเซอร์ที่แม่นยำของไบนารี

"x86_64"
64 บิต x86-64

"สปาร์ก"
SPARC 32 บิต

"สปาร์ก64"
64 บิต SPARC V9 ขึ้นไป

"ไอเอ64"
อินเทล อิทาเนียม

"ปชป"
พีซีพาวเวอร์ 32 บิต

"ppc64"
พีซีพาวเวอร์ 64 บิต

"แขน"
ARM 32 บิต

"aarch64"
ARM 64 บิต

Libguestfs อาจส่งคืนสตริงสถาปัตยกรรมอื่น ๆ ในอนาคต

ฟังก์ชันนี้ใช้งานได้กับไฟล์ประเภทต่อไปนี้เป็นอย่างน้อย:

· ไบนารี Un*x และ Linux หลายประเภท

· ไลบรารีที่ใช้ร่วมกัน Un*x และ Linux หลายประเภท

· ไบนารี Windows Win32 และ Win64

· Windows Win32 และ Win64 DLLs

ไบนารี Win32 และ DLL ส่งคืน "i386"

ไบนารี Win64 และ DLL ส่งคืน "x86_64"

· โมดูลเคอร์เนลลินุกซ์

· อิมเมจ initrd สไตล์ใหม่ของลินุกซ์

· เคอร์เนล vmlinuz ที่ไม่ใช่ x86 บางตัว

สิ่งที่ยังทำไม่ได้ในตอนนี้:

· ไลบรารีแบบคงที่ (libfoo.a)

· initrd แบบเก่าของ Linux เป็นระบบไฟล์ ext2 ที่บีบอัด (RHEL 3)

· x86 ลินุกซ์เคอร์เนล vmlinuz

รูปภาพ x86 vmlinuz (รูปแบบ bzImage) ประกอบด้วยรหัส 16-, 32- และบีบอัด
และแกะออกได้ยากยิ่ง หากคุณต้องการค้นหาสถาปัตยกรรมของเคอร์เนล
ใช้สถาปัตยกรรมของโมดูล initrd หรือเคอร์เนลที่เกี่ยวข้องแทน

ขนาดไฟล์
ไฟล์ขนาดไฟล์

คำสั่งนี้จะคืนค่าขนาดของ ไฟล์ เป็นไบต์

ในการรับสถิติอื่นๆ เกี่ยวกับไฟล์ ให้ใช้ "stat", "lstat", "is-dir", "is-file" เป็นต้น เพื่อให้ได้
ขนาดของอุปกรณ์บล็อก ใช้ "blockdev-getsize64"

ระบบไฟล์พร้อมใช้งาน
ระบบไฟล์-ระบบไฟล์ที่พร้อมใช้งาน

ตรวจสอบว่า libguestfs รองรับระบบไฟล์ที่มีชื่อหรือไม่ อาร์กิวเมนต์ "ระบบไฟล์" คือa
ชื่อระบบไฟล์ เช่น "ext3"

คุณต้องเรียก "launch" ก่อนใช้คำสั่งนี้

สิ่งนี้มีประโยชน์เป็นหลักในการทดสอบเชิงลบ หากคืนค่าเป็น จริง ไม่ได้หมายความว่า a
สามารถสร้างหรือติดตั้งระบบไฟล์เฉพาะได้ เนื่องจากระบบไฟล์อาจล้มเหลวสำหรับระบบไฟล์อื่นๆ
สาเหตุ เช่น เป็นระบบไฟล์รุ่นที่ใหม่กว่า หรือมีความเข้ากันไม่ได้
คุณสมบัติหรือขาด mkfs ที่ถูกต้องfs> เครื่องมือ

ดูเพิ่มเติมที่ "มี", "มีคุณลักษณะ", "ความพร้อมใช้งาน" ใน แขก(3)

ใส่
เติม c len เส้นทาง

คำสั่งนี้สร้างไฟล์ใหม่ชื่อ "เส้นทาง" เนื้อหาเริ่มต้นของไฟล์คือ "len"
อ็อกเท็ตของ "c" โดยที่ "c" ต้องเป็นตัวเลขในช่วง "[0]"

ในการเติมไฟล์ด้วยศูนย์ไบต์ (เบาบาง) จะมีประสิทธิภาพมากกว่าในการใช้ "truncate-
ขนาด" ในการสร้างไฟล์ที่มีรูปแบบของไบต์ที่ซ้ำกัน ให้ใช้ "fill-pattern"

เติม dir
เติม dir dir nr

ฟังก์ชันนี้มีประโยชน์สำหรับการทดสอบระบบไฟล์ สร้างไฟล์ว่าง "nr" ในไดเร็กทอรี
"dir" ที่มีชื่อ 00000000 ถึง "nr-1" (เช่น แต่ละชื่อไฟล์มีความยาว 8 หลักบุด้วย
ศูนย์)

รูปแบบการเติม
รูปแบบการเติม len path

ฟังก์ชั่นนี้เหมือนกับ "fill" ยกเว้นว่าจะสร้างไฟล์ใหม่ที่มีความยาว "len" ที่มี
รูปแบบการทำซ้ำของไบต์ใน "รูปแบบ" รูปแบบจะถูกตัดทอนหากจำเป็นเพื่อ
ตรวจสอบให้แน่ใจว่าความยาวของไฟล์เป็น "len" ไบต์พอดี

พบ
ค้นหาไดเรกทอรี

คำสั่งนี้แสดงรายการไฟล์และไดเร็กทอรีทั้งหมด แบบเรียกซ้ำ เริ่มต้นที่ ไดเรกทอรี. มัน
เทียบเท่ากับการรันคำสั่งเชลล์ "find directory -print" แต่บางอัน
หลังการประมวลผลเกิดขึ้นในผลลัพธ์ที่ได้อธิบายไว้ด้านล่าง

ส่งคืนรายการสตริง ไม่มี ใด อุปสรรค. ดังนั้นหากโครงสร้างไดเร็กทอรีเป็น:

/tmp/ก
/tmp/ข
/tmp/c/d

จากนั้นรายการส่งคืนจาก "find" / Tmp จะเป็น 4 องค์ประกอบ:

a
b
c
ซีดี

If ไดเรกทอรี ไม่ใช่ไดเร็กทอรี ดังนั้นคำสั่งนี้จะส่งคืนข้อผิดพลาด

รายการที่ส่งคืนจะถูกจัดเรียง

ค้นหา 0
ไดเรกทอรี find0 (ไฟล์ |-)

คำสั่งนี้แสดงรายการไฟล์และไดเร็กทอรีทั้งหมด แบบเรียกซ้ำ เริ่มต้นที่ ไดเรกทอรี,
วางรายการผลลัพธ์ในไฟล์ภายนอกที่เรียกว่า ไฟล์.

คำสั่งนี้ทำงานในลักษณะเดียวกับ "find" โดยมีข้อยกเว้นดังต่อไปนี้:

· รายการผลลัพธ์ถูกเขียนไปยังไฟล์ภายนอก

· รายการ (ชื่อไฟล์) ในผลลัพธ์จะถูกคั่นด้วยอักขระ "\0" ดู พบ(1) ตัวเลือก
-พิมพ์0.

· รายการผลลัพธ์จะไม่ถูกจัดเรียง

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

findfs ป้าย
findfs-ฉลากฉลาก

คำสั่งนี้ค้นหาระบบไฟล์และส่งคืนระบบที่มีป้ายกำกับที่กำหนด หนึ่ง
ข้อผิดพลาดจะถูกส่งกลับหากไม่พบระบบไฟล์ดังกล่าว

หากต้องการค้นหาป้ายกำกับของระบบไฟล์ ให้ใช้ "vfs-label"

findfs-uuid
findfs-uuid uuid

คำสั่งนี้ค้นหาระบบไฟล์และส่งคืนระบบที่มี UUID ที่กำหนด หนึ่ง
ข้อผิดพลาดจะถูกส่งกลับหากไม่พบระบบไฟล์ดังกล่าว

หากต้องการค้นหา UUID ของระบบไฟล์ ให้ใช้ "vfs-uuid"

ฟค
fsck อุปกรณ์ fstype

สิ่งนี้จะเรียกใช้ตัวตรวจสอบระบบไฟล์ (fsck) บน "อุปกรณ์" ซึ่งควรมีประเภทระบบไฟล์
"fstype".

จำนวนเต็มที่ส่งคืนคือสถานะ ดู ฟค(8) สำหรับรายการรหัสสถานะจาก "fsck"

หมายเหตุ:

· สามารถรวมรหัสสถานะได้หลายรหัส

· รหัสส่งคืนที่ไม่ใช่ศูนย์อาจหมายถึง "ความสำเร็จ" เช่น หากข้อผิดพลาดได้รับการแก้ไข
บนระบบไฟล์

· ไม่รองรับการตรวจสอบหรือซ่อมแซมโวลุ่ม NTFS (โดย linux-ntfs)

คำสั่งนี้เทียบเท่ากับการรัน "fsck -a -t fstype device" โดยสิ้นเชิง

fstream
จุดต่อเชื่อม fstrim [offset:N] [length:N] [minimumfreeextent:N]

ตัดพื้นที่ว่างในระบบไฟล์ที่ติดตั้งบน "จุดเชื่อมต่อ" ระบบไฟล์จะต้อง
ติดตั้งอ่าน-เขียน

เนื้อหาของระบบไฟล์จะไม่ได้รับผลกระทบ แต่พื้นที่ว่างในระบบไฟล์จะเป็น
"ตัดแต่ง" กล่าวคือ ให้กลับไปที่อุปกรณ์โฮสต์ ทำให้อิมเมจของดิสก์เบาบางลง
อนุญาตให้ใช้พื้นที่ที่ไม่ได้ใช้ในไฟล์ qcow2 ซ้ำ ฯลฯ

การดำเนินการนี้ต้องการการสนับสนุนใน libguestfs, ระบบไฟล์ที่เมาท์, โฮสต์
ระบบไฟล์ qemu และเคอร์เนลโฮสต์ หากไม่มีการสนับสนุนนี้ อาจมีข้อผิดพลาด
หรือแม้แต่วิ่งแต่ไม่ทำอะไรเลย

ดูเพิ่มเติมที่ "พื้นที่ว่างเป็นศูนย์" นั่นคือการดำเนินการที่แตกต่างกันเล็กน้อยที่จะเปลี่ยนพื้นที่ว่าง
ในระบบไฟล์ให้เป็นศูนย์ ถูกต้องที่จะเรียก "fstrim" แทนหรือหลัง
เรียก "พื้นที่ว่างเป็นศูนย์"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

รับผนวก
รับผนวก

ส่งคืนตัวเลือกเคอร์เนลเพิ่มเติมซึ่งถูกเพิ่มไปยังเคอร์เนลของอุปกรณ์ libguestfs
บรรทัดคำสั่ง.

หาก "NULL" จะไม่มีการเพิ่มตัวเลือก

รับแนบวิธี
รับแนบวิธี

ส่งคืนแบ็กเอนด์ปัจจุบัน

ดู "set-backend" และ "BACKEND" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การโทร "get-backend" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

รับ autosync
รับ autosync

รับแฟล็ก autosync

รับแบ็คเอนด์
รับแบ็คเอนด์

ส่งคืนแบ็กเอนด์ปัจจุบัน

คุณสมบัติจัดการนี้ก่อนหน้านี้เรียกว่า "วิธีแนบ"

ดู "set-backend" และ "BACKEND" ใน แขก(3)

รับแบ็คเอนด์การตั้งค่า
ชื่อการตั้งค่าแบ็คเอนด์

ค้นหาสตริงการตั้งค่าแบ็กเอนด์ที่เป็น "ชื่อ" หรือขึ้นต้นด้วย "name=" ถ้า "ชื่อ"
ส่งคืนสตริง "1" ถ้า "name=" จะคืนค่าส่วนหลังเครื่องหมายเท่ากับ
(ซึ่งอาจจะเป็นสตริงว่างก็ได้)

หากไม่พบการตั้งค่าดังกล่าว ฟังก์ชันนี้จะแสดงข้อผิดพลาด errno (ดู "last-errno")
จะเป็น "ESRCH" ในกรณีนี้

ดู "แบ็กเอนด์" ใน แขก(3), "การตั้งค่าแบ็กเอนด์" ใน แขก(3)

รับแบ็คเอนด์การตั้งค่า
รับแบ็คเอนด์การตั้งค่า

คืนค่าการตั้งค่าแบ็กเอนด์ปัจจุบัน

การโทรนี้ส่งคืนสตริงการตั้งค่าแบ็กเอนด์ทั้งหมด หากคุณต้องการค้นหาแบ็กเอนด์เดียว
การตั้งค่า โปรดดูที่ "get-backend-setting"

ดู "แบ็กเอนด์" ใน แขก(3), "การตั้งค่าแบ็กเอนด์" ใน แขก(3)

รับแคช
รับแคช

รับไดเร็กทอรีที่ใช้โดยหมายเลขอ้างอิงเพื่อเก็บแคชของอุปกรณ์

รับตรง
รับตรง

ส่งคืนแฟล็กโหมดอุปกรณ์โดยตรง

รับ-e2attrs
ไฟล์ get-e2attrs

ส่งคืนแอตทริบิวต์ของไฟล์ที่เกี่ยวข้องกับ ไฟล์.

คุณลักษณะคือชุดของบิตที่เกี่ยวข้องกับแต่ละไอโหนดซึ่งส่งผลต่อพฤติกรรมของ
ไฟล์. แอตทริบิวต์จะถูกส่งกลับเป็นสตริงของตัวอักษร (อธิบายด้านล่าง) ดิ
สตริงอาจว่างเปล่า แสดงว่าไม่มีการตั้งค่าแอตทริบิวต์ของไฟล์สำหรับไฟล์นี้

แอตทริบิวต์เหล่านี้จะปรากฏเมื่อไฟล์อยู่บนระบบไฟล์ ext2/3/4 เท่านั้น
การใช้การเรียกนี้กับระบบไฟล์ประเภทอื่นจะทำให้เกิดข้อผิดพลาด

อักขระ (แอตทริบิวต์ของไฟล์) ในสตริงที่ส่งคืนในปัจจุบันคือ:

'A' เมื่อเข้าถึงไฟล์ เวลาของไฟล์จะไม่ถูกแก้ไข

'a' ไฟล์เป็นแบบผนวกเท่านั้น

'c' ไฟล์ถูกบีบอัดบนดิสก์

'D' (ไดเร็กทอรีเท่านั้น) การเปลี่ยนแปลงในไดเร็กทอรีนี้จะถูกเขียนพร้อมกันไปยังดิสก์

'd' ไฟล์นี้ไม่ใช่ไฟล์สำรอง (ดู กอง(พ.ศ. 8)).

'E' ไฟล์มีข้อผิดพลาดในการบีบอัด

'e' ไฟล์กำลังใช้ขอบเขต

'h' ไฟล์กำลังจัดเก็บบล็อกในหน่วยของระบบไฟล์บล็อกขนาดแทน
ภาค

'I' (ไดเร็กทอรีเท่านั้น) ไดเร็กทอรีกำลังใช้ต้นไม้ที่ถูกแฮช

'i' ไฟล์นี้ไม่สามารถเปลี่ยนแปลงได้ ไม่สามารถแก้ไข ลบ หรือเปลี่ยนชื่อได้ ลิงค์ไม่สามารถเป็น
สร้างขึ้นในไฟล์นี้

'j' ไฟล์ถูกบันทึกด้วยข้อมูล

's' เมื่อไฟล์ถูกลบ บล็อคทั้งหมดจะเป็นศูนย์

การเปลี่ยนแปลง 'S' ในไฟล์นี้จะถูกเขียนพร้อมกันไปยังดิสก์

'T' (ไดเร็กทอรีเท่านั้น) นี่เป็นคำใบ้ถึงตัวจัดสรรบล็อกที่ไดเร็กทอรีย่อย
ที่มีอยู่ในไดเร็กทอรีนี้ควรกระจายข้ามบล็อก ถ้าไม่ปรากฏบล็อก
ตัวจัดสรรจะพยายามจัดกลุ่มไดเรกทอรีย่อยเข้าด้วยกัน

't' สำหรับไฟล์ การดำเนินการนี้จะปิดใช้งานการรวมท้าย (ไม่ใช้โดยการใช้งานต้นน้ำของ
ต่อ2)

'u' เมื่อไฟล์ถูกลบ บล็อคจะถูกบันทึก ทำให้ไม่สามารถลบไฟล์ได้

'X' เนื้อหาดิบของไฟล์บีบอัดอาจเข้าถึงได้

'Z' ไฟล์บีบอัดสกปรก

สามารถเพิ่มแอตทริบิวต์ของไฟล์เพิ่มเติมในรายการนี้ได้ในภายหลัง ไม่สามารถตั้งค่าแอตทริบิวต์ไฟล์ทั้งหมดได้
สำหรับไฟล์ทุกประเภท ดูรายละเอียดได้ที่ พูดพล่อย(1) หน้าคน

ดูเพิ่มเติมที่ "set-e2attrs"

อย่าสับสนระหว่างแอตทริบิวต์เหล่านี้กับแอตทริบิวต์เพิ่มเติม (ดู "getxattr")

รับ-e2generation
ไฟล์ get-e2generation

ส่งคืนการสร้างไฟล์ ext2 ของไฟล์ รุ่น (ซึ่งเคยเรียกว่า
"รุ่น") เป็นตัวเลขที่เกี่ยวข้องกับไอโหนด NFS . ใช้บ่อยที่สุด
เซิร์ฟเวอร์

การสร้างจะแสดงเมื่อไฟล์อยู่บนระบบไฟล์ ext2/3/4 เท่านั้น โดยใช้
การเรียกใช้ระบบไฟล์ประเภทอื่นนี้จะส่งผลให้เกิดข้อผิดพลาด

ดู "set-e2generation"

รับ e2label
อุปกรณ์ get-e2label

ซึ่งจะส่งคืนป้ายกำกับระบบไฟล์ ext2/3/4 ของระบบไฟล์ใน "อุปกรณ์"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "vfs-label" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

รับ-e2uuid
รับ-e2uuid อุปกรณ์

สิ่งนี้จะส่งคืน UUID ระบบไฟล์ ext2/3/4 ของระบบไฟล์บน "อุปกรณ์"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "vfs-uuid" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

รับ-hv
รับ-hv

ส่งกลับไบนารีไฮเปอร์ไวเซอร์ปัจจุบัน

สิ่งนี้ไม่ใช่ค่า NULL เสมอ หากไม่ได้ตั้งค่าไว้ สิ่งนี้จะคืนค่า qemu . เริ่มต้น
ชื่อไบนารี

รับตัวระบุ
รับตัวระบุ

รับตัวระบุหมายเลขอ้างอิง ดู "ตัวระบุชุด"

รับ libvirt-requested-credential-challenge
ดัชนี get-libvirt-requested-credential-challenge

รับคำท้า (จัดทำโดย libvirt) สำหรับข้อมูลรับรอง "index" ที่ร้องขอ ถ้า
libvirt ไม่ได้จัดเตรียมการท้าทาย ซึ่งจะส่งคืนสตริงว่าง ""

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

get-libvirt-requested-credential-defresult
ดัชนี get-libvirt-requested-credential-defresult

รับผลลัพธ์เริ่มต้น (จัดทำโดย libvirt) สำหรับข้อมูลรับรอง "index" ที่ร้องขอ ถ้า
libvirt ไม่ได้ให้ผลลัพธ์เริ่มต้น ซึ่งจะคืนค่าสตริงว่าง ""

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

รับ libvirt-requested-credential-prompt
get-libvirt-requested-credential-prompt ดัชนี

รับข้อความแจ้ง (จัดทำโดย libvirt) สำหรับข้อมูลรับรอง "index" ที่ร้องขอ ถ้า libvirt
ไม่ได้ให้พร้อมต์ ซึ่งจะส่งคืนสตริงว่าง ""

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

รับ-libvirt-ขอ-หนังสือรับรอง
รับ-libvirt-ขอ-หนังสือรับรอง

ควรเรียกเฉพาะในระหว่างการเรียกกลับเหตุการณ์สำหรับเหตุการณ์ประเภท
"GUESTFS_EVENT_LIBVIRT_AUTH"

ส่งคืนรายการข้อมูลรับรองที่ร้องขอโดย libvirt ค่าที่เป็นไปได้เป็นส่วนย่อยของ
สตริงที่ระบุเมื่อคุณเรียก "set-libvirt-supported-credentials"

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

รับ-memsize
รับ-memsize

ซึ่งได้รับขนาดหน่วยความจำเป็นเมกะไบต์ที่จัดสรรให้กับไฮเปอร์ไวเซอร์

ถ้า "set-memsize" ไม่ถูกเรียกบนแฮนเดิลนี้ และถ้าไม่ได้ตั้งค่า "LIBGUESTFS_MEMSIZE"
จากนั้นจะส่งกลับค่าเริ่มต้นที่คอมไพล์แล้วสำหรับ memsize

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสถาปัตยกรรมของ libguestfs โปรดดูที่ แขก(3)

รับเครือข่าย
รับเครือข่าย

ส่งคืนการตั้งค่าสถานะเครือข่ายที่เปิดใช้งาน

รับเส้นทาง
รับเส้นทาง

กลับเส้นทางการค้นหาปัจจุบัน

สิ่งนี้ไม่ใช่ค่า NULL เสมอ หากไม่ได้ตั้งค่าไว้ ค่านี้จะกลับเป็นค่าเริ่มต้น
เส้นทาง.

รับ-pgroup
รับ-pgroup

ส่งคืนแฟล็กกลุ่มกระบวนการ

รับ-pid
pid
รับ-pid

ส่งคืน ID กระบวนการของไฮเปอร์ไวเซอร์ หากไม่มีไฮเปอร์ไวเซอร์ทำงานอยู่ แสดงว่าสิ่งนี้
จะส่งคืนข้อผิดพลาด

นี่คือการโทรภายในที่ใช้สำหรับการดีบักและการทดสอบ

รับโปรแกรม
รับโปรแกรม

รับชื่อโปรแกรม ดู "ชุดโปรแกรม"

รับ qemu
รับ qemu

คืนค่าไบนารีไฮเปอร์ไวเซอร์ปัจจุบัน (โดยปกติคือ qemu)

สิ่งนี้ไม่ใช่ค่า NULL เสมอ หากไม่ได้ตั้งค่าไว้ สิ่งนี้จะคืนค่า qemu . เริ่มต้น
ชื่อไบนารี

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "get-hv" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

รับการกู้คืนproc
รับการกู้คืนproc

ส่งคืนแฟล็กเปิดใช้งานกระบวนการกู้คืน

รับ-selinux
รับ-selinux

ส่งคืนการตั้งค่าปัจจุบันของแฟล็ก selinux ซึ่งส่งผ่านไปยังอุปกรณ์ที่
เวลาบูต ดู "set-selinux"

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสถาปัตยกรรมของ libguestfs โปรดดูที่ แขก(3)

รับ-smp
รับ-smp

ส่งคืนจำนวน CPU เสมือนที่กำหนดให้กับอุปกรณ์

รับ-tmpdir
รับ-tmpdir

รับไดเร็กทอรีที่แฮนเดิลใช้เพื่อเก็บไฟล์ชั่วคราว

รับติดตาม
รับติดตาม

ส่งคืนแฟล็กการติดตามคำสั่ง

รับ umask
รับ umask

ส่งคืน Umask ปัจจุบัน โดยค่าเริ่มต้น umask คือ 022 เว้นแต่จะได้รับการตั้งค่าโดยการโทร
"อูมาสก์".

รับรายละเอียด
รับรายละเอียด

ส่งคืนแฟล็กข้อความ verbose

รับคอน
รับคอน

สิ่งนี้ได้รับบริบทการรักษาความปลอดภัย SELinux ของ daemon

ดูเอกสารเกี่ยวกับ SELINUX ใน แขก(3) และ "เซทคอน"

getxattr
getxattr ชื่อเส้นทาง

รับแอตทริบิวต์ขยายเดียวจากไฟล์ "เส้นทาง" ชื่อ "ชื่อ" การโทรนี้ดังต่อไปนี้
ลิงก์สัญลักษณ์ หากคุณต้องการค้นหาแอ็ตทริบิวต์แบบขยายสำหรับ symlink เอง ให้ใช้
"lgetxattr".

โดยปกติ เป็นการดีกว่าที่จะรับคุณลักษณะเพิ่มเติมทั้งหมดจากไฟล์ในครั้งเดียวโดยการโทร
"getxattrs". อย่างไรก็ตาม การใช้งานระบบไฟล์ลินุกซ์บางตัวมีข้อผิดพลาดและไม่ได้จัดเตรียมให้
วิธีแสดงรายการแอตทริบิวต์ สำหรับระบบไฟล์เหล่านี้ (โดยเฉพาะ ntfs-3g) คุณต้องรู้จัก
ชื่อของแอตทริบิวต์เพิ่มเติมที่คุณต้องการล่วงหน้าและเรียกใช้ฟังก์ชันนี้

ค่าแอตทริบิวต์เพิ่มเติมคือหยดของข้อมูลไบนารี หากไม่มีแอตทริบิวต์เพิ่มเติม
ชื่อ "ชื่อ" ซึ่งส่งคืนข้อผิดพลาด

ดูเพิ่มเติม: "getxattrs", "lgetxattr", Attribution-NonCommercial-ShareAlike(5)

getxattrs
เส้นทาง getxattrs

การเรียกนี้แสดงรายการแอตทริบิวต์เพิ่มเติมของไฟล์หรือ "เส้นทาง" ของไดเรกทอรี

ที่ระดับการเรียกของระบบ นี่คือการรวมกันของ รายการxattr(2) และ getxattr(2) โทร.

ดูเพิ่มเติม: "lgetxattrs", Attribution-NonCommercial-ShareAlike(5)

ทั่วโลกขยาย
glob-ขยายรูปแบบ

คำสั่งนี้ค้นหาชื่อพาธทั้งหมดที่ตรงกับ "รูปแบบ" ตามสัญลักษณ์แทน
กฎการขยายที่ใช้โดยเชลล์

หากไม่มีพาธที่ตรงกัน ระบบจะส่งคืนรายการว่าง (หมายเหตุ: ไม่ใช่ข้อผิดพลาด)

มันเป็นเพียงกระดาษห่อหุ้มรอบ C glob(3) ฟังก์ชันพร้อมแฟล็ก "GLOB_MARK|GLOB_BRACE" ดู
หน้าคู่มือนั้นสำหรับรายละเอียดเพิ่มเติม

ขอให้สังเกตว่าไม่มีคำสั่งที่เทียบเท่าสำหรับการขยายชื่ออุปกรณ์ (เช่น /dev/sd*).
ใช้ฟังก์ชัน "list-devices", "list-partitions" ฯลฯ แทน

grep
grep-ตัวเลือก
เส้นทาง grep regex [ขยาย:จริง|เท็จ] [แก้ไข:จริง|เท็จ] [ไม่ละเอียดอ่อน:จริง|เท็จ] [บีบอัด:จริง|เท็จ]

สิ่งนี้เรียกโปรแกรม "grep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

แฟล็กทางเลือกคือ:

"ขยาย"
ใช้นิพจน์ทั่วไปแบบขยาย นี้เหมือนกับการใช้ -E ธง.

"แก้ไขแล้ว"
แก้ไขการจับคู่ (อย่าใช้นิพจน์ทั่วไป) นี้เหมือนกับการใช้ -F ธง.

"ไร้ความรู้สึก"
จับคู่ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ นี้เหมือนกับการใช้ -i ธง.

"บีบอัด"
ใช้ "zgrep" แทน "grep" สิ่งนี้ทำให้อินพุตถูกบีบอัด- หรือ gzip-
บีบอัด

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

เกรปี้
เส้นทาง grepi regex

สิ่งนี้เรียกโปรแกรม "grep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ด้วงติดตั้ง
ด้วงติดตั้งอุปกรณ์รูท

คำสั่งนี้ติดตั้ง GRUB 1 (Grand Unified Bootloader) บน "อุปกรณ์" ด้วย root
ไดเร็กทอรีเป็น "รูท"

หมายเหตุ:

· ขณะนี้ยังไม่มีวิธีในการติดตั้ง grub2 ใน API ซึ่งทันสมัยที่สุด
แขกลินุกซ์ เป็นไปได้ที่จะรันคำสั่ง grub2 จากแขก แม้ว่า see
คำเตือนใน "RUNNING COMMANDS" ใน แขก(3)

· ใช้ "grub-install" จากโฮสต์ น่าเสียดายที่ด้วงไม่เข้ากันเสมอไป
ด้วยตัวมันเอง ดังนั้นสิ่งนี้จึงใช้ได้ในสถานการณ์ที่ค่อนข้างแคบเท่านั้น ทดสอบอย่างระมัดระวังด้วย
ขอแนะนำให้ใช้รุ่นแขกแต่ละรุ่น

· หากด้วงติดตั้งรายงานข้อผิดพลาด "ไม่พบไดรฟ์ที่เหมาะสมในอุปกรณ์ที่สร้างขึ้น
แผนที่" อาจเป็นได้ว่าคุณต้องสร้าง /boot/grub/device.map ไฟล์ก่อนว่า
มีการแมประหว่างชื่ออุปกรณ์ด้วงและชื่ออุปกรณ์ Linux มันมักจะ
เพียงพอที่จะสร้างไฟล์ที่มี:

(hd0) /dev/vda

การแทนที่ /dev/vda พร้อมชื่ออุปกรณ์ติดตั้ง

หัว
ทางหัว

คำสั่งนี้จะคืนค่า 10 บรรทัดแรกของไฟล์เป็นรายการสตริง

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

หัว-n
head-n nrlines เส้นทาง

หากพารามิเตอร์ "nrlines" เป็นจำนวนบวก ค่านี้จะส่งกลับบรรทัด "nrlines" แรกของ
ไฟล์ "เส้นทาง"

หากพารามิเตอร์ "nrlines" เป็นจำนวนลบ ค่านี้จะส่งคืนบรรทัดจากไฟล์ "path"
ยกเว้นบรรทัด "nrlines" สุดท้าย

หากพารามิเตอร์ "nrlines" เป็นศูนย์ จะคืนค่ารายการว่าง

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

การถ่ายโอนข้อมูล
เส้นทาง hexdump

สิ่งนี้จะรัน "hexdump -C" บน "เส้นทาง" ที่กำหนด ผลลัพธ์ที่ได้คือมาตรฐานที่มนุษย์อ่านได้
การถ่ายโอนข้อมูลฐานสิบหกของไฟล์

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

ลมพิษปิด
ลมพิษปิด

ปิดแฮนเดิล hivex ปัจจุบัน

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

ลมพิษกระทำ
hivex-commit ชื่อไฟล์

คอมมิต (เขียน) การเปลี่ยนแปลงไปยังกลุ่ม

ถ้าตัวเลือก ชื่อไฟล์ พารามิเตอร์เป็นโมฆะ จากนั้นการเปลี่ยนแปลงจะถูกเขียนกลับเป็นค่าเดิม
รังที่เปิดอยู่ หากนี่ไม่ใช่ค่าว่าง ไฟล์เหล่านั้นจะถูกเขียนไปยังชื่อไฟล์สำรอง
ให้และรังเดิมไม่ถูกแตะต้อง

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

รังผึ้งโหนดเพิ่มลูก
hivex-node-add-child ชื่อพาเรนต์

เพิ่มโหนดย่อยให้กับ "พาเรนต์" ที่ชื่อ "ชื่อ"

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

รังผึ้งโหนดลูก
hivex-node-children nodeh

ส่งคืนรายการโหนดที่เป็นคีย์ย่อยของ "nodeh"

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

กลุ่มโหนดลบลูก
โหนด hivex-node-delete-child

ลบ "nodeh" ซ้ำหากจำเป็น

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

รังผึ้งโหนดรับลูก
hivex-node-get-child ชื่อโหนด

ส่งคืนลูกของ "nodeh" ด้วยชื่อ "name" หากมี สิ่งนี้สามารถส่งคืน 0 ความหมาย
ไม่พบชื่อ

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

hivex-node-get-value
hivex-node-get-value nodeh คีย์

ส่งคืนค่าที่แนบมากับ "nodeh" ซึ่งมีชื่อ "key" หากมี นี้สามารถ
คืนค่า 0 หมายถึงไม่พบคีย์

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

กลุ่มโหนดชื่อ
hivex-node-name nodeh

กลับชื่อ "โนเดห์"

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

กลุ่มโหนดพาเรนต์
hivex-โหนด-พาเรนต์ nodeh

ส่งคืนโหนดหลักของ "nodeh"

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

hivex-node-set-value
hivex-node-set-value nodeh คีย์ t val

ตั้งค่าหรือแทนที่ค่าเดียวภายใต้โหนด "nodeh" "กุญแจ" คือชื่อ "t" คือ
type และ "val" คือข้อมูล

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

กลุ่มโหนดค่า
hivex-node-values ​​nodeh

ส่งคืนอาร์เรย์ของ (คีย์, ชนิดข้อมูล, ข้อมูล) tuples ที่แนบมากับ "nodeh"

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

ลมพิษเปิด
ชื่อไฟล์ hivex-open [verbose:true|false] [debug:true|false] [write:true|false]

เปิดไฟล์ไฮฟ์ Windows Registry ชื่อ ชื่อไฟล์. หากมีรังผึ้งมาก่อน
จัดการที่เกี่ยวข้องกับเซสชัน guestfs นี้ จากนั้นจะปิด

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

รังผึ้งราก
รังผึ้งราก

ส่งคืนโหนดรูทของกลุ่ม

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

hivex-value-คีย์
ค่า hivex-ค่าคีย์ h

ส่งคืนฟิลด์คีย์ (ชื่อ) ของทูเพิล (คีย์ ประเภทข้อมูล ข้อมูล)

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

ประเภทมูลค่ารังผึ้ง
ค่าประเภทค่า hivexh

ส่งคืนฟิลด์ชนิดข้อมูลจากทูเพิล (คีย์, ชนิดข้อมูล, ข้อมูล)

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

hivex-value-utf8
ค่า hivex-utf8 มีค่า

สิ่งนี้เรียกว่า "hivex-value-value" (ซึ่งส่งคืนฟิลด์ข้อมูลจาก tuple ค่า hivex)
จากนั้นจะถือว่าฟิลด์นั้นเป็นสตริง UTF-16LE และแปลงผลลัพธ์เป็น UTF-8 (หรือ
หากไม่สามารถทำได้ จะส่งคืนข้อผิดพลาด)

ซึ่งมีประโยชน์สำหรับการอ่านสตริงจากรีจิสทรีของ Windows อย่างไรก็ตามมันไม่ใช่
ไม่สามารถเข้าใจผิดได้เนื่องจากรีจิสทรีไม่ได้ถูกพิมพ์อย่างเข้มงวดและฟิลด์สามารถมีได้หรือ
ข้อมูลที่ไม่คาดคิด

รังผึ้งค่าค่า
hivex-value-value

ส่งคืนฟิลด์ข้อมูลของทูเพิล (คีย์, ชนิดข้อมูล, ข้อมูล)

นี่คือกระดาษห่อหุ้มรอบ ลมพิษ(3) เรียกชื่อเดียวกัน

ดูเพิ่มเติม: "hivex-value-utf8"

initrd-แมว
initrd-cat ชื่อไฟล์ initrdpath

คำสั่งนี้จะแตกไฟล์ ชื่อไฟล์ จากไฟล์ initrd ชื่อ เส้นทางเริ่มต้นส่วน
ต้องระบุชื่อไฟล์ ไม่มี เริ่มต้น / ตัวอักษร

ตัวอย่างเช่น ใน guestfish คุณสามารถใช้คำสั่งต่อไปนี้เพื่อตรวจสอบ boot script
(ปกติจะเรียกว่า /ในนั้น) มีอยู่ในอิมเมจ Linux initrd หรือ initramfs:

initrd-cat /boot/initrd- .img init

ดูเพิ่มเติมที่ "initrd-list"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

รายการเริ่มต้น
initrd-list เส้นทาง

คำสั่งนี้แสดงรายการไฟล์ที่มีอยู่ใน initrd

ไฟล์ถูกแสดงรายการโดยไม่มีชื่อย่อ / อักขระ. ไฟล์เรียงตามลำดับ
ปรากฏขึ้น (ไม่จำเป็นต้องเรียงตามตัวอักษร) ชื่อไดเร็กทอรีจะแสดงเป็นรายการแยกต่างหาก

เคอร์เนล Linux เก่า (2.4 และเก่ากว่า) ใช้ระบบไฟล์ ext2 ที่บีบอัดเป็น initrd เรา เพียง
รองรับรูปแบบ initramfs ที่ใหม่กว่า (ไฟล์ cpio ที่บีบอัด)

inotify เพิ่มนาฬิกา
inotify-add-watch เส้นทางหน้ากาก

ดู "เส้นทาง" สำหรับเหตุการณ์ที่ระบุไว้ใน "หน้ากาก"

โปรดทราบว่าหาก "เส้นทาง" เป็นไดเร็กทอรี เหตุการณ์ภายในไดเร็กทอรีนั้นจะถูกเฝ้าดู แต่สิ่งนี้
ทำ ไม่ เกิดขึ้นซ้ำๆ (ในไดเรกทอรีย่อย)

หมายเหตุสำหรับผู้เรียกที่ไม่ใช่ C หรือไม่ใช่ Linux: เหตุการณ์ inotify ถูกกำหนดโดยเคอร์เนล Linux
ABI และอยู่ใน /usr/include/sys/inotify.h.

ปิดการแจ้งเตือน
ปิดการแจ้งเตือน

สิ่งนี้จะปิดแฮนเดิล inotify ซึ่งเคยเปิดโดย inotify_init มันเอาออก
เฝ้าดูทั้งหมด ทิ้งกิจกรรมที่รอดำเนินการ และจัดสรรทรัพยากรทั้งหมด

inotify-ไฟล์
inotify-ไฟล์

ฟังก์ชันนี้เป็นตัวห่อหุ้มที่เป็นประโยชน์รอบ ๆ "inotify-read" ซึ่งเพิ่งส่งคืนรายการ
ชื่อเส้นทางของวัตถุที่ถูกสัมผัส ชื่อพาธที่ส่งคืนจะถูกจัดเรียงและ
ซ้ำซ้อน

inotify-init
inotify-init maxevents

คำสั่งนี้สร้างแฮนเดิล inotify ใหม่ ระบบย่อย inotify สามารถใช้แจ้งเตือนได้
เหตุการณ์ที่เกิดขึ้นกับวัตถุในระบบไฟล์แขก

"maxevents" คือจำนวนสูงสุดของเหตุการณ์ที่จะเข้าคิวระหว่างการเรียกไปยัง
"inotify-read" หรือ "inotify-files" หากส่งผ่านเป็น 0 แสดงว่าเคอร์เนล (หรือก่อนหน้านี้
set) ค่าเริ่มต้นจะถูกใช้ สำหรับ Linux 2.6.29 ค่าดีฟอลต์คือ 16384 เหตุการณ์ เกินขีดจำกัดนี้
เคอร์เนลโยนเหตุการณ์ทิ้งไป แต่บันทึกความจริงที่ว่ามันทิ้งมันไปโดยการตั้งค่า a
ตั้งค่าสถานะ "IN_Q_OVERFLOW" ในรายการโครงสร้างที่ส่งคืน (ดู "inotify-read")

ก่อนสร้างกิจกรรมใด ๆ คุณต้องเพิ่มนาฬิกาบางตัวในรายการเฝ้าดูภายใน
ดู: "inotify-add-watch" และ "inotify-rm-watch"

ควรอ่านเหตุการณ์ที่จัดคิวเป็นระยะโดยเรียก "inotify-read" (หรือ "inotify-files"
ซึ่งเป็นเพียงเสื้อคลุมที่มีประโยชน์รอบ ๆ "inotify-read") ถ้าคุณไม่อ่านเหตุการณ์ออก
บ่อยครั้งมากพอ คุณอาจเสี่ยงที่คิวภายในจะล้น

ควรปิดที่จับหลังการใช้งานโดยเรียก "inotify-close" นอกจากนี้ยังลบ any
นาฬิกาโดยอัตโนมัติ

ดูสิ่งนี้ด้วย แจ้งเตือน(7) สำหรับภาพรวมของอินเทอร์เฟซ inotify ที่เปิดเผยโดย Linux
เคอร์เนลซึ่งเป็นสิ่งที่เราเปิดเผยผ่าน libguestfs โดยประมาณ โปรดทราบว่ามีหนึ่ง global
inotify จัดการต่ออินสแตนซ์ libguestfs

inotify อ่าน
inotify อ่าน

ส่งคืนคิวเหตุการณ์ทั้งหมดที่เกิดขึ้นตั้งแต่การโทรอ่านครั้งก่อน

หากไม่มีเหตุการณ์ใดเกิดขึ้น จะส่งคืนรายการที่ว่างเปล่า

หมายเหตุ: เพื่อให้แน่ใจว่าได้อ่านเหตุการณ์ทั้งหมดแล้ว คุณต้องเรียกใช้ฟังก์ชันนี้
ซ้ำๆ จนกว่าจะกลับรายการว่าง เหตุผลคือสายจะอ่านเหตุการณ์
สูงสุดขนาดข้อความต่อเครื่องโฮสต์และปล่อยให้เหตุการณ์ที่เหลืออยู่ในคิว

inotify-rm-นาฬิกา
inotify-rm-นาฬิกา wd

ลบนาฬิกา inotify ที่กำหนดไว้ก่อนหน้านี้ ดู "inotify-add-watch"

ตรวจสอบรับ arch
ตรวจสอบ-get-arch root

ส่งคืนสถาปัตยกรรมของระบบปฏิบัติการที่ได้รับการตรวจสอบ ผลตอบแทนที่เป็นไปได้
ค่าอยู่ภายใต้ "file-architecture"

หากไม่สามารถกำหนดสถาปัตยกรรมได้ สตริง "unknown" จะถูกส่งกลับ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับ distro
ตรวจสอบรับ distro root

ส่งคืน distro (การกระจาย) ของระบบปฏิบัติการที่ตรวจสอบ

distros ที่กำหนดไว้ในปัจจุบันคือ:

"อัลไพน์ลินุกซ์"
อัลไพน์ลินุกซ์

"อัลลินุกซ์"
ALT ลินุกซ์

"อาร์คลินุกซ์"
Arch Linux

"บิลด์รูท"
distro ที่ได้มาจาก Buildroot แต่ไม่ใช่คนที่เรารู้จักโดยเฉพาะ

"เซนโตส"
CentOS

"ซีรอส"
ซีรอส

"คอรอส"
คอร์โอเอส

"เดเบียน"
Debian

"เฟดอร่า"
Fedora

"ฟรีบีเอสดี"
ฟรีบีเอสดี

"ฟรีดอส"
ฟรีดอส

"ของกระจุกกระจิก"
ของกระจุกกระจิก

"เจนทู"
Gentoo

"ลินุกซ์มินต์"
Linux Mint

"มาเกีย"
Mageia

"มันดริวา"
มันดริวา

"มีโก้"
MeeGo

"เน็ตบีเอสดี"
เน็ตบีเอสดี

"โอเพ่นบีเอสดี"
โอเพ่นบีเอสดี

"โอเพนซัส"
OpenSUSE

"ออราเคิลลินุกซ์"
ออราเคิล ลินุกซ์

"พาร์ดุส"
พาร์ดุส

"pldlinux"
PLD ลินุกซ์

"ตามเรดแฮท"
distro ที่ได้มาจาก Red Hat

"เรล"
เรดแฮท เอ็นเตอร์ไพรส์ ลินุกซ์

"วิทยาศาสตร์ลินุกซ์"
ลินุกซ์ทางวิทยาศาสตร์

"สแล็คแวร์"
Slackware

"สเล"
SuSE Linux Enterprise Server หรือเดสก์ท็อป

"เบสเบส"
distro ที่ได้มาจาก openSuSE บางตัว

"ทิลินุกซ์"
ttylinux

"อูบุนตู"
อูบุนตู

"ไม่รู้จัก"
ไม่สามารถกำหนด distro ได้

"หน้าต่าง"
Windows ไม่มีการแจกแจง สตริงนี้จะถูกส่งกลับหากประเภทของระบบปฏิบัติการคือ
หน้าต่าง

libguestfs เวอร์ชันต่อๆ ไปอาจส่งคืนสตริงอื่นๆ ที่นี่ ผู้โทรควรเป็น
พร้อมที่จะจัดการกับสตริงใด ๆ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-รับ-ไดรฟ์-แมป
ตรวจสอบ-รับ-ไดรฟ์-การแมปรูท

การโทรนี้มีประโยชน์สำหรับ Windows ซึ่งใช้ระบบดั้งเดิมในการกำหนดอักษรระบุไดรฟ์
(ชอบ C:) ไปยังพาร์ติชัน API การตรวจสอบนี้จะตรวจสอบ Windows Registry เพื่อค้นหา
วิธีที่ดิสก์/พาร์ติชั่นถูกแมปกับอักษรระบุไดรฟ์ และส่งคืนตารางแฮชเช่นเดียวกับใน
ตัวอย่างด้านล่าง:

C => /dev/vda2
อี => /dev/vdb1
F => /dev/vdc1

โปรดทราบว่าคีย์คืออักษรระบุไดรฟ์ สำหรับ Windows คีย์จะเป็นตัวพิมพ์เล็กและตัวพิมพ์ใหญ่เพียง
มีอักษรระบุไดรฟ์ โดยไม่มีอักขระตัวคั่นทวิภาคปกติ

ในอนาคต เราอาจสนับสนุนระบบปฏิบัติการอื่นๆ ที่ใช้อักษรระบุไดรฟ์ด้วย แต่
คีย์สำหรับคีย์เหล่านั้นอาจไม่คำนึงถึงขนาดตัวพิมพ์และอาจยาวกว่า 1 อักขระ สำหรับ
ตัวอย่างใน OS-9 ฮาร์ดไดรฟ์มีชื่อว่า "h0", "h1" เป็นต้น

สำหรับแขกของ Windows ขณะนี้ระบบจะส่งคืนเฉพาะการแมปฮาร์ดไดรฟ์เท่านั้น ดิสก์แบบถอดได้ (เช่น
DVD-ROM) จะถูกละเว้น

สำหรับแขกที่ไม่ได้ใช้การแมปไดรฟ์หรือหากไม่สามารถทำแผนที่ไดรฟ์ได้
กำหนด ส่งคืนตารางแฮชที่ว่างเปล่า

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม ดูเพิ่มเติมที่ "ตรวจสอบ-รับ-
mountpoints", "ตรวจสอบ-รับ-ระบบไฟล์"

ตรวจสอบรับไฟล์ระบบ
ตรวจสอบรับไฟล์ระบบ root

ส่งคืนรายการระบบไฟล์ทั้งหมดที่เราคิดว่าเกี่ยวข้องกับสิ่งนี้
ระบบปฏิบัติการ. ซึ่งรวมถึงระบบไฟล์รูท ระบบไฟล์ทั่วไปอื่นๆ และที่ไม่ใช่
อุปกรณ์ที่ติดตั้งเช่นพาร์ติชั่นสว็อป

ในกรณีของเครื่องเสมือนแบบมัลติบูต เป็นไปได้ที่จะแชร์ระบบไฟล์
ระหว่างระบบปฏิบัติการ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม ดูเพิ่มเติมที่ "ตรวจสอบ-รับ-
จุดติดตั้ง".

ตรวจสอบรับรูปแบบ
ตรวจสอบรับรูปแบบรูท

ส่งคืนรูปแบบของระบบปฏิบัติการที่ตรวจสอบ คุณสามารถใช้มันเพื่อตรวจจับ
ติดตั้งรูปภาพ ซีดีสด และอื่นๆ

รูปแบบที่กำหนดไว้ในปัจจุบันคือ:

"ติดตั้ง"
นี่คือระบบปฏิบัติการที่ติดตั้ง

"ช่างติดตั้ง"
อิมเมจดิสก์ที่กำลังตรวจสอบไม่ใช่ระบบปฏิบัติการที่ติดตั้ง แต่ a ที่สามารถบูตได้
ติดตั้งดิสก์ ซีดีสด หรือที่คล้ายกัน

"ไม่รู้จัก"
ไม่ทราบรูปแบบของดิสก์อิมเมจนี้

libguestfs เวอร์ชันต่อๆ ไปอาจส่งคืนสตริงอื่นๆ ที่นี่ ผู้โทรควรเป็น
พร้อมที่จะจัดการกับสตริงใด ๆ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับชื่อโฮสต์
ตรวจสอบรับชื่อโฮสต์ root

ฟังก์ชันนี้ส่งคืนชื่อโฮสต์ของระบบปฏิบัติการตามที่พบในการตรวจสอบ
ไฟล์การกำหนดค่าของแขก

หากไม่สามารถระบุชื่อโฮสต์ได้ สตริง "unknown" จะถูกส่งกลับ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับไอคอน
ตรวจสอบ-รับ-ไอคอนรูท [favicon:true|false] [highquality:true|false]

ฟังก์ชันนี้ส่งคืนไอคอนที่สอดคล้องกับระบบปฏิบัติการที่ตรวจสอบ ไอคอน
ถูกส่งกลับเป็นบัฟเฟอร์ที่มีอิมเมจ PNG (เข้ารหัสใหม่เป็น PNG หากจำเป็น)

หากไม่สามารถรับไอคอนได้ ฟังก์ชันนี้จะคืนค่าความยาวเป็นศูนย์ (ไม่ใช่ NULL)
buffer โทรติดต่อ ต้อง ตรวจสอบ สำหรับ นี้ กรณี.

Libguestfs จะเริ่มต้นด้วยการค้นหาไฟล์ชื่อ /etc/favicon.png or C:\etc\favicon.png
และหากมีรูปแบบที่ถูกต้อง เนื้อหาของไฟล์นี้จะถูกส่งคืน คุณสามารถ
ปิดใช้งานไอคอน Fav โดยส่งบูลีน "favicon" ที่เป็นตัวเลือกเป็นเท็จ (ค่าเริ่มต้นคือ true)

หากไม่พบ favicon ให้มองหาที่อื่นในแขกที่เหมาะสม
ไอคอน

หากบูลีน "คุณภาพสูง" ที่เป็นตัวเลือกเป็นจริง ระบบจะส่งกลับเฉพาะไอคอนคุณภาพสูงเท่านั้น
ซึ่งหมายถึงเฉพาะไอคอนที่มีความละเอียดสูงพร้อมช่องอัลฟา ค่าเริ่มต้น (เท็จ) คือ
เพื่อส่งคืนไอคอนใด ๆ ที่เราสามารถทำได้แม้ว่าจะมีคุณภาพต่ำกว่ามาตรฐานก็ตาม

หมายเหตุ:

· ไม่เหมือนกับการเรียก API การตรวจสอบอื่นๆ ส่วนใหญ่ ดิสก์ของแขกต้องถูกติดตั้งก่อน
คุณเรียกสิ่งนี้เนื่องจากจำเป็นต้องอ่านข้อมูลจากระบบไฟล์แขกระหว่าง
โทร.

· การรักษาความปลอดภัย: ข้อมูลไอคอนมาจากแขกที่ไม่น่าเชื่อถือ และควรได้รับการปฏิบัติด้วย
คำเตือน. เป็นที่ทราบกันดีว่าไฟล์ PNG มีช่องโหว่ ตรวจสอบให้แน่ใจว่า libpng (หรืออื่น ๆ
ไลบรารีที่เกี่ยวข้อง) เป็นเวอร์ชันล่าสุดก่อนที่จะพยายามประมวลผลหรือแสดงไอคอน

· รูปภาพ PNG ที่ส่งคืนสามารถมีขนาดใดก็ได้ อาจไม่ใช่สี่เหลี่ยมจัตุรัส Libguestfs พยายามที่จะ
ส่งคืนไอคอนที่ใหญ่ที่สุดและมีคุณภาพสูงสุด แอปพลิเคชันต้องปรับขนาด
ไอคอนตามขนาดที่ต้องการ

· การแยกไอคอนจากแขกของ Windows ต้องใช้โปรแกรม "wrestool" ภายนอกจาก
แพ็คเกจ "icoutils" และหลายโปรแกรม ("bmptopnm", "pnmtopng", "pamcut") จาก
แพ็คเกจ "netpbm" ต้องติดตั้งแยกต่างหาก

· ไอคอนระบบปฏิบัติการมักเป็นเครื่องหมายการค้า ขอคำแนะนำทางกฎหมายก่อนใช้
เครื่องหมายการค้าในแอปพลิเคชัน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ตรวจสอบรับรุ่นใหญ่
ตรวจสอบรับรุ่นหลัก root

ส่งคืนหมายเลขเวอร์ชันหลักของระบบปฏิบัติการที่ตรวจสอบ

Windows ใช้รูปแบบการกำหนดเวอร์ชันที่สอดคล้องกันซึ่งก็คือ ไม่ สะท้อนออกมาสู่สายตาประชาชนทั่วไป
ชื่อที่ใช้โดยระบบปฏิบัติการ โดยเฉพาะอย่างยิ่งระบบปฏิบัติการที่เรียกว่า "Windows 7" คือ
เวอร์ชัน 6.1 จริงๆ (เช่น major = 6, minor = 1) คุณสามารถค้นหารุ่นจริง
สอดคล้องกับรุ่นของ Windows โดยปรึกษา Wikipedia หรือ MSDN

หากไม่สามารถระบุเวอร์ชันได้ ระบบจะส่งคืน 0

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับรุ่นรอง
ตรวจสอบรับรุ่นรอง root

ส่งคืนหมายเลขเวอร์ชันรองของระบบปฏิบัติการที่ตรวจสอบ

หากไม่สามารถระบุเวอร์ชันได้ ระบบจะส่งคืน 0

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม ดูเพิ่มเติมที่ "inspect-get-major-
รุ่น".

ตรวจสอบ-รับ-เมานต์พอยท์
ตรวจสอบ-get-mountpoints root

ส่งคืนแฮชของตำแหน่งที่เราคิดว่าระบบไฟล์เกี่ยวข้องกับปฏิบัติการนี้
ควรติดตั้งระบบ ผู้โทรควรทราบว่านี่เป็นการเดาอย่างมีการศึกษาที่ดีที่สุด
โดยการอ่านไฟล์การกำหนดค่าเช่น / etc / fstab. In ในสิ่งที่สนใจ หมายเหตุ ที่อาจ
ส่งคืนระบบไฟล์ที่ไม่มีอยู่หรือไม่สามารถติดตั้งได้และควรเตรียมผู้เรียก
เพื่อจัดการหรือเพิกเฉยต่อความล้มเหลวหากพวกเขาพยายามติดตั้ง

แต่ละองค์ประกอบใน hashtable ที่ส่งคืนมีคีย์ซึ่งเป็นเส้นทางของจุดเชื่อมต่อ (เช่น
/ boot) และค่าที่เป็นระบบไฟล์ที่จะติดตั้งที่นั่น (เช่น / dev / sda1).

อุปกรณ์ที่ไม่ได้เมานต์ เช่น อุปกรณ์สลับเป็น ไม่ กลับมาในรายการนี้

สำหรับระบบปฏิบัติการเช่น Windows ที่ยังคงใช้อักษรระบุไดรฟ์ การโทรนี้จะใช้ได้เท่านั้น
ส่งคืนรายการสำหรับไดรฟ์แรก "ติดตั้ง" /. สำหรับข้อมูลเกี่ยวกับการทำแผนที่ของ
อักษรระบุไดรฟ์ไปยังพาร์ติชั่น โปรดดู "inspect-get-drive-mappings"

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม ดูเพิ่มเติมที่ "ตรวจสอบ-รับ-
ระบบไฟล์".

ตรวจสอบ-รับ-แพ็คเกจ-รูปแบบ
ตรวจสอบรับแพ็คเกจรูปแบบรูท

ฟังก์ชันนี้และ "inspect-get-package-management" ส่งคืนรูปแบบแพ็คเกจและแพ็คเกจ
เครื่องมือการจัดการที่ใช้โดยระบบปฏิบัติการที่ตรวจสอบ ตัวอย่างเช่นสำหรับ Fedora เหล่านี้
ฟังก์ชั่นจะส่งกลับ "rpm" (รูปแบบแพ็คเกจ) และ "yum" หรือ "dnf" (การจัดการแพ็คเกจ)

ส่งคืนสตริง "unknown" หากเราไม่สามารถระบุรูปแบบแพ็คเกจ or ถ้า
ระบบปฏิบัติการไม่มีระบบบรรจุภัณฑ์ที่แท้จริง (เช่น Windows)

สตริงที่เป็นไปได้ ได้แก่ "rpm", "deb", "ebuild", "pisi", "pacman", "pkgsrc", "apk"
libguestfs เวอร์ชันในอนาคตอาจส่งคืนสตริงอื่น

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-รับ-แพคเกจ-การจัดการ
ตรวจสอบ-รับ-แพคเกจ-จัดการ root

"inspect-get-package-format" และฟังก์ชันนี้ส่งคืนรูปแบบแพ็คเกจและแพ็คเกจ
เครื่องมือการจัดการที่ใช้โดยระบบปฏิบัติการที่ตรวจสอบ ตัวอย่างเช่นสำหรับ Fedora เหล่านี้
ฟังก์ชั่นจะส่งกลับ "rpm" (รูปแบบแพ็คเกจ) และ "yum" หรือ "dnf" (การจัดการแพ็คเกจ)

ค่านี้จะส่งคืนสตริง "unknown" หากเราไม่สามารถระบุเครื่องมือการจัดการแพ็คเกจได้ or
หากระบบปฏิบัติการไม่มีระบบบรรจุภัณฑ์จริง (เช่น Windows)

สตริงที่เป็นไปได้ ได้แก่ "yum", "dnf", "up2date", "apt" (สำหรับอนุพันธ์ Debian ทั้งหมด)
"portage", "pisi", "pacman", "urpmi", "zypper", "apk" libguestfs เวอร์ชันอนาคตอาจ
ส่งคืนสตริงอื่น ๆ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-รับ-ชื่อผลิตภัณฑ์
ตรวจสอบ-รับ-ชื่อผลิตภัณฑ์ root

ส่งคืนชื่อผลิตภัณฑ์ของระบบปฏิบัติการที่ตรวจสอบ ชื่อผลิตภัณฑ์คือ
โดยทั่วไปแล้วสตริงรูปแบบอิสระบางส่วนสามารถแสดงให้ผู้ใช้เห็นได้ แต่ไม่ควรเป็น
แยกวิเคราะห์โดยโปรแกรม

หากไม่สามารถระบุชื่อผลิตภัณฑ์ได้ สตริง "unknown" จะถูกส่งคืน

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-รับ-ผลิตภัณฑ์-ตัวแปร
ตรวจสอบ-รับ-ผลิตภัณฑ์-ตัวแปร root

ส่งคืนตัวเลือกผลิตภัณฑ์ของระบบปฏิบัติการที่ตรวจสอบ

สำหรับแขกของ Windows สิ่งนี้จะส่งคืนเนื้อหาของคีย์รีจิสทรี
"HKLM\Software\Microsoft\Windows NT\CurrentVersion" "InstallationType" ซึ่งมักจะเป็น
string เช่น "Client" หรือ "Server" (ค่าอื่นเป็นไปได้) สามารถใช้เพื่อ
แยกแยะ Windows รุ่นสำหรับผู้บริโภคและองค์กรที่มีหมายเลขเวอร์ชันเดียวกัน
(เช่น Windows 7 และ Windows 2008 Server เป็นทั้งเวอร์ชัน 6.1 แต่เดิมคือ
"ไคลเอนต์" และอันหลังคือ "เซิร์ฟเวอร์")

สำหรับแขก Linux ระดับองค์กร ในอนาคต เราตั้งใจให้สิ่งนี้ส่งคืนตัวเลือกสินค้า เช่น
เช่น "เดสก์ท็อป" "เซิร์ฟเวอร์" เป็นต้น แต่นี้ไม่ได้ดำเนินการในปัจจุบัน

หากไม่สามารถระบุตัวเลือกสินค้าได้ ระบบจะส่งคืนสตริง "ไม่ทราบ"

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม ดูเพิ่มเติมที่ "ตรวจสอบ-รับ-ผลิตภัณฑ์-
ชื่อ", "ตรวจสอบ-รับ-รุ่นหลัก".

ตรวจสอบรับราก
ตรวจสอบรับราก

ฟังก์ชันนี้เป็นวิธีที่สะดวกในการรับรายการอุปกรณ์รูท ที่ส่งคืนจากa
ก่อนหน้านี้เรียก "inspect-os" แต่ไม่ต้องทำซ้ำขั้นตอนการตรวจสอบทั้งหมด

ส่งคืนรายการว่างหากไม่พบอุปกรณ์รูทหรือผู้โทรไม่พบ
เรียกว่า "ตรวจสอบระบบปฏิบัติการ"

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับประเภท
ตรวจสอบรับประเภทรูท

ส่งคืนประเภทของระบบปฏิบัติการที่ตรวจสอบ ประเภทที่กำหนดไว้ในปัจจุบันคือ:

"ลินุกซ์"
ระบบปฏิบัติการใด ๆ ที่ใช้ Linux

"หน้าต่าง"
ระบบปฏิบัติการ Microsoft Windows ใด ๆ

"ฟรีบีเอสดี"
ฟรีบีเอสดี

"เน็ตบีเอสดี"
เน็ตบีเอสดี

"โอเพ่นบีเอสดี"
โอเพ่นบีเอสดี

"ฮูด"
GNU/เฮิร์ด

"ดอส"
MS-DOS, FreeDOS และอื่นๆ

"มินิกซ์"
มินิกซ์

"ไม่รู้จัก"
ไม่สามารถระบุชนิดของระบบปฏิบัติการได้

libguestfs เวอร์ชันต่อๆ ไปอาจส่งคืนสตริงอื่นๆ ที่นี่ ผู้โทรควรเป็น
พร้อมที่จะจัดการกับสตริงใด ๆ

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-รับ-windows-current-control-set
ตรวจสอบรับ windows-current-control-set root

ส่งคืน Windows CurrentControlSet ของผู้เยี่ยมชมที่ตรวจสอบ CurrentControlSet
เป็นชื่อรีจิสตรีคีย์ เช่น "ControlSet001"

การเรียกนี้ถือว่าแขกเป็น Windows และ Registry สามารถตรวจสอบได้โดย
การตรวจสอบ. หากไม่ใช่กรณีนี้ ข้อผิดพลาดจะถูกส่งคืน

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรับ windows systemroot
ตรวจสอบรับ windows-systemroot รูท

ซึ่งจะคืนค่ารูทระบบ Windows ของแขกที่ตรวจสอบ systemroot เป็นไดเร็กทอรี
เส้นทางเช่น /หน้าต่าง.

การเรียกนี้อนุมานว่าแขกคือ Windows และรูทระบบสามารถกำหนดได้โดย
การตรวจสอบ. หากไม่ใช่กรณีนี้ ข้อผิดพลาดจะถูกส่งคืน

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบเป็นสด
ตรวจสอบเป็นรากสด

หาก "inspect-get-format" ส่งคืน "ตัวติดตั้ง" (นี่คือดิสก์สำหรับติดตั้ง) ค่านี้จะส่งคืน
true หากตรวจพบภาพสดบนดิสก์

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบเป็นหลายส่วน
ตรวจสอบเป็นรากหลายส่วน

หาก "inspect-get-format" ส่งคืน "ตัวติดตั้ง" (นี่คือดิสก์สำหรับติดตั้ง) ค่านี้จะส่งคืน
true ถ้าดิสก์เป็นส่วนหนึ่งของชุด

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-is-netinst
ตรวจสอบเป็น netinst root

หาก "inspect-get-format" ส่งคืน "ตัวติดตั้ง" (นี่คือดิสก์สำหรับติดตั้ง) ค่านี้จะส่งคืน
true หากดิสก์เป็นตัวติดตั้งเครือข่าย กล่าวคือ ไม่ใช่ซีดีติดตั้งในตัวเอง แต่เป็นแผ่นที่
มีแนวโน้มว่าจะต้องมีการเข้าถึงเครือข่ายเพื่อทำการติดตั้งให้เสร็จสิ้น

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบรายการแอปพลิเคชัน
ตรวจสอบรายการแอปพลิเคชัน root

กลับรายการแอพพลิเคชั่นที่ติดตั้งในระบบปฏิบัติการ

หมายเหตุ การเรียกนี้ทำงานแตกต่างจากส่วนอื่นๆ ของ API การตรวจสอบ คุณต้อง
เรียก "inspect-os" จากนั้น "inspect-get-mountpoints" จากนั้นทำการเมานต์ดิสก์ก่อนที่จะโทร
นี้. รายการแอปพลิเคชันเป็นการดำเนินการที่ยากขึ้นอย่างมากซึ่งต้องการ
เข้าถึงระบบไฟล์แบบเต็ม โปรดทราบด้วยว่าไม่เหมือนกับการโทร "inspect-get-*" อื่น ๆ
ซึ่งเพิ่งส่งคืนข้อมูลที่แคชในการจัดการ libguestfs การเรียกนี้อ่านจริง
บางส่วนของระบบไฟล์ที่เมาต์ระหว่างการโทร

ส่งคืนรายการว่างหากรหัสตรวจสอบไม่สามารถระบุรายการของ .ได้
การใช้งาน

โครงสร้างแอปพลิเคชันประกอบด้วยฟิลด์ต่อไปนี้:

"app_name"
ชื่อของแอปพลิเคชัน สำหรับแขก Linux ที่ได้รับ Red Hat และ Debian
นี่คือชื่อแพ็คเกจ

"app_display_name"
ชื่อที่แสดงของแอปพลิเคชัน ซึ่งบางครั้งแปลเป็นภาษาการติดตั้งของ
ระบบปฏิบัติการแขก

หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง "" ผู้โทรที่ต้องการแสดง
บางอย่างสามารถใช้ "app_name" แทนได้

"app_epoch"
สำหรับตัวจัดการแพ็คเกจที่ใช้ epochs สิ่งนี้มี epoch ของแพ็คเกจ (an
จำนวนเต็ม). หากไม่พร้อมใช้งาน ค่านี้จะถูกส่งกลับเป็น 0

"app_version"
สตริงเวอร์ชันของแอปพลิเคชันหรือแพ็กเกจ หากไม่มีสิ่งนี้จะถูกส่งคืนเป็น
สตริงว่าง ""

"app_release"
สตริงการวางจำหน่ายของแอปพลิเคชันหรือแพ็คเกจ สำหรับตัวจัดการแพ็คเกจที่ใช้สิ่งนี้
หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง ""

"app_install_path"
เส้นทางการติดตั้งของแอปพลิเคชัน (บนระบบปฏิบัติการเช่น Windows ซึ่ง
ใช้เส้นทางการติดตั้ง) เส้นทางนี้อยู่ในรูปแบบที่แขกปฏิบัติการ
ระบบ มันไม่ใช่เส้นทาง libguestfs

หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง ""

"app_trans_path"
พาธการติดตั้งแปลเป็นพาธ libguestfs หากไม่พร้อมจะส่งคืน
เป็นสตริงว่าง ""

"app_publisher"
ชื่อผู้เผยแพร่แอปพลิเคชันสำหรับตัวจัดการแพ็คเกจที่ใช้สิ่งนี้ ถ้า
ไม่พร้อมใช้งาน สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app_url"
URL (เช่น URL ต้นน้ำ) ของแอปพลิเคชัน หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็น an
สตริงว่าง ""

"app_source_package"
สำหรับระบบบรรจุภัณฑ์ที่รองรับสิ่งนี้ ชื่อของแพ็คเกจต้นทาง ถ้า
ไม่พร้อมใช้งาน สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app_summary"
คำอธิบายสั้นๆ (โดยปกติคือหนึ่งบรรทัด) ของแอปพลิเคชันหรือแพ็คเกจ ถ้าไม่ว่าง
สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app_description"
คำอธิบายที่ยาวขึ้นของแอปพลิเคชันหรือแพ็คเกจ หากไม่พร้อมจะส่งคืน
เป็นสตริงว่าง ""

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ใช้การเรียก "inspect-list-applications2"
แทน.

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ตรวจสอบรายการโปรแกรม2
ตรวจสอบรายการโปรแกรม 2 รูท

กลับรายการแอพพลิเคชั่นที่ติดตั้งในระบบปฏิบัติการ

หมายเหตุ การเรียกนี้ทำงานแตกต่างจากส่วนอื่นๆ ของ API การตรวจสอบ คุณต้อง
เรียก "inspect-os" จากนั้น "inspect-get-mountpoints" จากนั้นทำการเมานต์ดิสก์ก่อนที่จะโทร
นี้. รายการแอปพลิเคชันเป็นการดำเนินการที่ยากขึ้นอย่างมากซึ่งต้องการ
เข้าถึงระบบไฟล์แบบเต็ม โปรดทราบด้วยว่าไม่เหมือนกับการโทร "inspect-get-*" อื่น ๆ
ซึ่งเพิ่งส่งคืนข้อมูลที่แคชในการจัดการ libguestfs การเรียกนี้อ่านจริง
บางส่วนของระบบไฟล์ที่เมาต์ระหว่างการโทร

ส่งคืนรายการว่างหากรหัสตรวจสอบไม่สามารถระบุรายการของ .ได้
การใช้งาน

โครงสร้างแอปพลิเคชันประกอบด้วยฟิลด์ต่อไปนี้:

"app2_name"
ชื่อของแอปพลิเคชัน สำหรับแขก Linux ที่ได้รับ Red Hat และ Debian
นี่คือชื่อแพ็คเกจ

"app2_display_name"
ชื่อที่แสดงของแอปพลิเคชัน ซึ่งบางครั้งแปลเป็นภาษาการติดตั้งของ
ระบบปฏิบัติการแขก

หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง "" ผู้โทรที่ต้องการแสดง
บางอย่างสามารถใช้ "app2_name" แทนได้

"app2_epoch"
สำหรับตัวจัดการแพ็คเกจที่ใช้ epochs สิ่งนี้มี epoch ของแพ็คเกจ (an
จำนวนเต็ม). หากไม่พร้อมใช้งาน ค่านี้จะถูกส่งกลับเป็น 0

"app2_version"
สตริงเวอร์ชันของแอปพลิเคชันหรือแพ็กเกจ หากไม่มีสิ่งนี้จะถูกส่งคืนเป็น
สตริงว่าง ""

"app2_release"
สตริงการวางจำหน่ายของแอปพลิเคชันหรือแพ็คเกจ สำหรับตัวจัดการแพ็คเกจที่ใช้สิ่งนี้
หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง ""

"app2_arch"
สตริงสถาปัตยกรรมของแอปพลิเคชันหรือแพ็คเกจ สำหรับตัวจัดการแพ็คเกจที่ใช้
นี้. หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง ""

"app2_install_path"
เส้นทางการติดตั้งของแอปพลิเคชัน (บนระบบปฏิบัติการเช่น Windows ซึ่ง
ใช้เส้นทางการติดตั้ง) เส้นทางนี้อยู่ในรูปแบบที่แขกปฏิบัติการ
ระบบ มันไม่ใช่เส้นทาง libguestfs

หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็นสตริงว่าง ""

"app2_trans_path"
พาธการติดตั้งแปลเป็นพาธ libguestfs หากไม่พร้อมจะส่งคืน
เป็นสตริงว่าง ""

"app2_publisher"
ชื่อผู้เผยแพร่แอปพลิเคชันสำหรับตัวจัดการแพ็คเกจที่ใช้สิ่งนี้ ถ้า
ไม่พร้อมใช้งาน สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app2_url"
URL (เช่น URL ต้นน้ำ) ของแอปพลิเคชัน หากไม่มีข้อมูลนี้จะถูกส่งกลับเป็น an
สตริงว่าง ""

"app2_source_package"
สำหรับระบบบรรจุภัณฑ์ที่รองรับสิ่งนี้ ชื่อของแพ็คเกจต้นทาง ถ้า
ไม่พร้อมใช้งาน สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app2_summary"
คำอธิบายสั้นๆ (โดยปกติคือหนึ่งบรรทัด) ของแอปพลิเคชันหรือแพ็คเกจ ถ้าไม่ว่าง
สิ่งนี้จะถูกส่งคืนเป็นสตริงว่าง ""

"app2_description"
คำอธิบายที่ยาวขึ้นของแอปพลิเคชันหรือแพ็คเกจ หากไม่พร้อมจะส่งคืน
เป็นสตริงว่าง ""

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ตรวจสอบ-os
ตรวจสอบ-os

ฟังก์ชันนี้ใช้ฟังก์ชัน libguestfs อื่นๆ และการวิเคราะห์พฤติกรรมบางอย่างเพื่อตรวจสอบ
ดิสก์ (โดยปกติคือดิสก์ที่เป็นของเครื่องเสมือน) มองหาระบบปฏิบัติการ

รายการที่ส่งคืนจะว่างเปล่าหากไม่พบระบบปฏิบัติการ

หากพบระบบปฏิบัติการใดระบบหนึ่ง ระบบจะส่งคืนรายการที่มีองค์ประกอบเดียว ซึ่ง
คือชื่อของระบบไฟล์รูทของระบบปฏิบัติการนี้ นอกจากนี้ยังเป็นไปได้สำหรับสิ่งนี้
ฟังก์ชันส่งคืนรายการที่มีองค์ประกอบมากกว่าหนึ่งรายการซึ่งบ่งชี้ว่ามีการบูตแบบคู่หรือ
เครื่องเสมือน multi-boot โดยแต่ละองค์ประกอบเป็นระบบไฟล์รูทของหนึ่งใน
ระบบปฏิบัติการ.

คุณสามารถส่งสตริงรูทที่ส่งคืนไปยังฟังก์ชัน "inspect-get-*" อื่น ๆ เพื่อ
สอบถามข้อมูลเพิ่มเติมเกี่ยวกับระบบปฏิบัติการแต่ละระบบ เช่น ชื่อและเวอร์ชัน

ฟังก์ชันนี้ใช้คุณสมบัติ libguestfs อื่นๆ เช่น "mount-ro" และ "umount-all" ตามลำดับ
เพื่อเมานต์และยกเลิกการต่อเชื่อมระบบไฟล์และดูเนื้อหา สิ่งนี้ควรเรียกว่าไม่มี
ดิสก์ที่ติดตั้งอยู่ในขณะนี้ ฟังก์ชันนี้อาจใช้ Augeas ดังนั้น Augeas ตัวจัดการที่มีอยู่แล้ว
จะปิด.

ฟังก์ชันนี้ไม่สามารถถอดรหัสดิสก์ที่เข้ารหัสได้ ผู้โทรต้องทำอย่างนั้นก่อน (การจัดหา
คีย์ที่จำเป็น) หากดิสก์ถูกเข้ารหัส

โปรดอ่าน "การตรวจสอบ" ใน แขก(3) สำหรับรายละเอียดเพิ่มเติม

ดูเพิ่มเติมที่ "รายการระบบไฟล์"

คือ-blockdev
คือ-blockdev-opts
เส้นทาง is-blockdev [followsymlinks:true|false]

ส่งคืน "จริง" หากมีอุปกรณ์บล็อกที่มีชื่อ "เส้นทาง" ที่กำหนด

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วยอุปกรณ์บล็อกทำให้ฟังก์ชันคืนค่าเป็นจริง

การโทรนี้จะดูเฉพาะไฟล์ภายในระบบไฟล์ของแขกเท่านั้น พาร์ทิชัน Libguestfs และ
อุปกรณ์บล็อก (เช่น / dev / SDA) ไม่สามารถใช้เป็นพารามิเตอร์ "เส้นทาง" ของการเรียกนี้ได้

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คือ-chardev
is-chardev-ตัวเลือก
เส้นทาง is-chardev [followsymlinks:true|false]

ส่งคืน "จริง" หากมีอุปกรณ์อักขระที่มีชื่อ "เส้นทาง" ที่กำหนด

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วย chardev ทำให้ฟังก์ชันคืนค่าเป็นจริง

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คือ-config
คือ-config

คืนค่า true หากมีการกำหนดค่าหมายเลขอ้างอิงนี้ (ในสถานะ "CONFIG")

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับรัฐ โปรดดูที่ แขก(3)

เป็น-dir
is-dir-ตัวเลือก
เส้นทาง is-dir [followsymlinks:true|false]

ค่านี้จะส่งคืน "จริง" ต่อเมื่อมีไดเร็กทอรีที่มีชื่อ "พาธ" ที่กำหนด บันทึก
ที่คืนค่าเท็จสำหรับวัตถุอื่นเช่นไฟล์

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วยไดเร็กทอรียังทำให้ฟังก์ชันคืนค่าเป็นจริง

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เป็น-fifo
is-fifo-ตัวเลือก
เส้นทาง is-fifo [followsymlinks:true|false]

สิ่งนี้จะส่งคืน "จริง" หากมี FIFO (ชื่อไปป์) ที่มี "เส้นทาง" ที่กำหนด
ชื่อ

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วย FIFO ทำให้ฟังก์ชันคืนค่าเป็นจริง

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เป็นไฟล์
เป็นไฟล์ตัวเลือก
เส้นทาง is-file [followsymlinks:true|false]

ค่านี้จะส่งคืน "จริง" หากมีไฟล์ปกติที่มีชื่อ "พาธ" ที่กำหนด
โปรดทราบว่าจะส่งคืนค่าเท็จสำหรับอ็อบเจ็กต์อื่นๆ เช่น ไดเร็กทอรี

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วยไฟล์ทำให้ฟังก์ชันคืนค่าเป็นจริง

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เป็น-lv
อุปกรณ์ is-lv

คำสั่งนี้จะทดสอบว่า "อุปกรณ์" เป็นโลจิคัลวอลุ่มหรือไม่ และคืนค่าเป็น จริง หากนี่คือ
กรณี.

is-ซ็อกเก็ต
เป็นซ็อกเก็ต-opts
เส้นทาง is-socket [followsymlinks:true|false]

ส่งคืน "จริง" หากมีซ็อกเก็ตโดเมน Unix ที่มี "เส้นทาง" ที่กำหนด
ชื่อ

หากแฟล็กตัวเลือก "followsymlinks" เป็นจริงแสดงว่า symlink (หรือ chain of symlink) ที่
ลงท้ายด้วยซ็อกเก็ตยังทำให้ฟังก์ชันคืนค่าเป็นจริง

ดูเพิ่มเติมที่ "สถิติ"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

คือ-symlink
is-symlink เส้นทาง

ส่งคืน "จริง" หากมีลิงก์สัญลักษณ์ที่มีชื่อ "เส้นทาง" ที่กำหนด

ดูเพิ่มเติมที่ "สถิติ"

เป็นทั้งอุปกรณ์
เป็นอุปกรณ์ครบเครื่อง

ค่านี้จะส่งคืน "จริง" ต่อเมื่อ "อุปกรณ์" หมายถึงอุปกรณ์บล็อกทั้งหมด นั่นคือไม่ใช่
พาร์ติชันหรืออุปกรณ์โลจิคัล

เป็นศูนย์
เส้นทางที่เป็นศูนย์

ค่านี้จะคืนค่าเป็น true หากมีไฟล์อยู่และไฟล์นั้นว่างเปล่าหรือมีไบต์ศูนย์ทั้งหมด

เป็นศูนย์อุปกรณ์
อุปกรณ์ที่เป็นศูนย์

ค่านี้จะคืนค่าเป็น true หากมีอุปกรณ์อยู่และมีศูนย์ไบต์ทั้งหมด

โปรดทราบว่าสำหรับอุปกรณ์ขนาดใหญ่ อาจใช้เวลานานในการทำงาน

ไอโซอินโฟ
isoinfo ไอโซไฟล์

สิ่งนี้เหมือนกับ "อุปกรณ์ isoinfo" ยกเว้นว่ามันใช้งานได้กับไฟล์ ISO ที่อยู่ภายใน
ระบบไฟล์ที่ติดตั้งอื่น ๆ โปรดทราบว่าในกรณีทั่วไปที่คุณเพิ่ม ISO
ไฟล์เป็นอุปกรณ์ libguestfs คุณจะ ไม่ เรียกสิ่งนี้ แต่คุณจะเรียก "isoinfo-
อุปกรณ์".

isoinfo-อุปกรณ์
อุปกรณ์ isoinfo

"อุปกรณ์" เป็นอุปกรณ์ ISO ส่งคืนโครงสร้างของข้อมูลที่อ่านจากหลัก
ตัวบอกปริมาณ (เทียบเท่า ISO ของ superblock) ของอุปกรณ์

โดยปกติแล้วจะมีประสิทธิภาพมากกว่าในการใช้ ไอโซอินโฟ(1) สั่งกับ -d ตัวเลือกบนโฮสต์
เพื่อวิเคราะห์ไฟล์ ISO แทนที่จะต้องผ่าน libguestfs

สำหรับข้อมูลเกี่ยวกับฟิลด์ตัวอธิบายโวลุ่มหลัก โปรดดูที่
http://wiki.osdev.org/ISO_9660#The_Primary_Volume_Descriptor

วารสารปิด
วารสารปิด

ปิดที่จับสมุดรายวัน

Journal-get
Journal-get

อ่านรายการบันทึกประจำวันปัจจุบัน ส่งคืนฟิลด์ทั้งหมดในเจอร์นัลเป็นชุดของ
คู่ "(ชื่อ attrval)" "attrname" คือชื่อฟิลด์ (สตริง)

"attrval" คือค่าของฟิลด์ (ไบนารี blob มักจะเป็นสตริง) โปรด
โปรดทราบว่า "attrval" เป็นอาร์เรย์ไบต์ ไม่ สตริง C ที่สิ้นสุด \0

ความยาวของข้อมูลอาจถูกตัดให้เหลือเพียงเกณฑ์ข้อมูล (ดู: "journal-set-data-
เกณฑ์", "journal-get-data-threshold")

หากคุณตั้งค่าขีด จำกัด ข้อมูลเป็นไม่ จำกัด (0) การเรียกนี้สามารถอ่านรายการบันทึกประจำวันของ
ขนาดใดก็ได้ กล่าวคือ มันไม่ได้ถูกจำกัดโดยโปรโตคอล libguestfs

Journal-get-data-threshold
Journal-get-data-threshold

รับเกณฑ์ข้อมูลปัจจุบันสำหรับการอ่านรายการบันทึกประจำวัน นี่คือคำใบ้ของวารสาร
ที่อาจตัดช่องข้อมูลให้เหลือขนาดนี้เมื่ออ่าน (โปรดทราบด้วยว่าอาจไม่
ตัดทอนพวกเขา) หากคืนค่าเป็น 0 แสดงว่าขีดจำกัดนั้นไม่จำกัด

ดูเพิ่มเติมที่ "journal-set-data-threshold"

Journal-get-realtime-usec
Journal-get-realtime-usec

รับการประทับเวลาแบบเรียลไทม์ (wallclock) ของรายการบันทึกประจำวันปัจจุบัน

Journal-next
Journal-next

ย้ายไปยังรายการบันทึกประจำวันถัดไป คุณต้องเรียกสิ่งนี้อย่างน้อยหนึ่งครั้งหลังจากเปิด
ก่อนที่คุณจะสามารถอ่านข้อมูลได้

บูลีนที่ส่งคืนจะบอกคุณว่ามีเร็กคอร์ดของเจอร์นัลให้อ่านอีกหรือไม่ "จริง"
หมายความว่าคุณสามารถอ่านบันทึกถัดไปได้ (เช่น ใช้ "journal-get") และ "เท็จ" หมายความว่าคุณมี
ถึงจุดสิ้นสุดของวารสาร

Journal-open
ไดเร็กทอรีเปิดวารสาร

เปิดวารสาร systemd ที่อยู่ใน ไดเรกทอรี. หมายเลขอ้างอิงสมุดรายวันที่เปิดไว้ก่อนหน้านี้คือ
ปิด

เนื้อหาของวารสารสามารถอ่านได้โดยใช้ "journal-next" และ "journal-get"

หลังจากคุณใช้วารสารเสร็จแล้ว คุณควรปิดที่จับโดยโทร
"วารสาร-ปิด".

Journal-set-data-threshold
ธรณีสัณฐานชุดข้อมูลเกณฑ์เกณฑ์

กำหนดเกณฑ์ข้อมูลสำหรับการอ่านรายการบันทึกประจำวัน นี้เป็นคำใบ้ให้วารสารที่มัน
อาจตัดช่องข้อมูลให้เหลือขนาดนี้เมื่ออ่าน (โปรดทราบด้วยว่าอาจไม่
ตัดทอนพวกเขา) หากคุณตั้งค่านี้เป็น 0 เกณฑ์จะไม่จำกัด

ดูเพิ่มเติมที่ "journal-get-data-threshold"

วารสารข้าม
วารสารข้ามข้าม

ข้ามไปข้างหน้า ("ข้าม ≥ 0") หรือย้อนกลับ ("ข้าม < 0") ในวารสาร

จำนวนรายการที่ข้ามจริงจะถูกส่งคืน (หมายเหตุ "rskip ≥ 0") ถ้านี่ไม่ใช่
เช่นเดียวกับค่าสัมบูรณ์ของพารามิเตอร์การข้าม ("|skip|") ที่คุณส่งผ่านเข้ามาก็หมายความว่า
คุณถึงจุดสิ้นสุดหรือจุดเริ่มต้นของวารสาร

ฆ่า-subprocess
ฆ่า-subprocess

สิ่งนี้จะฆ่าไฮเปอร์ไวเซอร์

อย่าเรียกสิ่งนี้ ดู: "การปิดระบบ" แทน

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ให้ใช้การโทร "ปิดระบบ" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เปิดตัว
วิ่ง
เปิดตัว

คุณควรเรียกสิ่งนี้หลังจากกำหนดค่าหมายเลขอ้างอิง (เช่น เพิ่มไดรฟ์) แต่ก่อนหน้า
ดำเนินการใด ๆ

อย่าเรียก "launch" สองครั้งบนแฮนเดิลเดียวกัน แม้ว่าจะไม่ทำให้เกิดข้อผิดพลาด (for
เหตุผลทางประวัติศาสตร์) พฤติกรรมที่แม่นยำเมื่อคุณทำเช่นนี้ไม่ได้กำหนดไว้อย่างชัดเจน ที่จับ
มีราคาถูกมากในการสร้าง ดังนั้นควรสร้างใหม่สำหรับแต่ละการเปิดตัว

ลชอง
lchown เจ้าของเส้นทางกลุ่ม

เปลี่ยนเจ้าของไฟล์เป็น "เจ้าของ" และกลุ่มเป็น "กลุ่ม" นี้ก็เหมือน "เชา" แต่ถ้าเป็น "ทาง"
เป็นลิงก์เชื่อมโยง จากนั้นลิงก์จะเปลี่ยนไป ไม่ใช่เป้าหมาย

รองรับเฉพาะตัวเลข uid และ gid หากคุณต้องการใช้ชื่อ คุณจะต้องค้นหา
และแยกไฟล์รหัสผ่านด้วยตัวเอง (การสนับสนุนของ Augea ทำให้สิ่งนี้ค่อนข้างง่าย)

ldmtool-สร้าง-ทั้งหมด
ldmtool-สร้าง-ทั้งหมด

ฟังก์ชันนี้จะสแกนอุปกรณ์บล็อกทั้งหมดที่กำลังมองหาไดรฟ์ข้อมูลดิสก์ไดนามิกของ Windows และ
พาร์ติชั่นและสร้างอุปกรณ์สำหรับสิ่งที่พบ

เรียก "list-ldm-volumes" และ "list-ldm-partitions" เพื่อส่งคืนอุปกรณ์ทั้งหมด

โปรดทราบว่าคุณ ทำไม่ได้ ปกติต้องเรียกให้ชัดเพราะทำโดยอัตโนมัติ
ในเวลา "เปิดตัว" อย่างไรก็ตาม คุณอาจต้องการเรียกใช้ฟังก์ชันนี้หากคุณมี hotplugged
ดิสก์หรือเพิ่งสร้างดิสก์ไดนามิกของ Windows

ldmtool-diskgroup-ดิสก์
ldmtool-diskgroup-ดิสก์กลุ่มดิสก์

ส่งคืนดิสก์ในกลุ่มดิสก์ไดนามิกของ Windows พารามิเตอร์ "diskgroup" ควรเป็น
GUID ของกลุ่มดิสก์ หนึ่งองค์ประกอบจากรายการที่ส่งคืนโดย "ldmtool-scan"

ldmtool-diskgroup-ชื่อ
ldmtool-diskgroup-ชื่อกลุ่มดิสก์

ส่งกลับชื่อของกลุ่มดิสก์ไดนามิกของ Windows พารามิเตอร์ "diskgroup" ควรเป็น
GUID ของกลุ่มดิสก์ หนึ่งองค์ประกอบจากรายการที่ส่งคืนโดย "ldmtool-scan"

ldmtool-diskgroup-วอลุ่ม
ldmtool-diskgroup-volumes กลุ่มดิสก์

ส่งกลับไดรฟ์ข้อมูลในกลุ่มดิสก์ไดนามิกของ Windows พารามิเตอร์ "diskgroup" ควรเป็น
GUID ของกลุ่มดิสก์ หนึ่งองค์ประกอบจากรายการที่ส่งคืนโดย "ldmtool-scan"

ldmtool-ลบทั้งหมด
ldmtool-ลบทั้งหมด

นี่คือสิ่งที่ตรงกันข้ามกับ "ldmtool-create-all" มันลบตัวทำแผนที่อุปกรณ์
การแมปสำหรับไดรฟ์ข้อมูลไดนามิกดิสก์ Windows ทั้งหมด

ldmtool-สแกน
ldmtool-สแกน

ฟังก์ชันนี้จะสแกนหาดิสก์ไดนามิกของ Windows ส่งคืนรายการตัวระบุ (GUID)
สำหรับกลุ่มดิสก์ทั้งหมดที่พบ ตัวระบุเหล่านี้สามารถส่งผ่านไปยัง "ldmtool-*" อื่นได้
ฟังก์ชั่น

ฟังก์ชันนี้จะสแกนอุปกรณ์บล็อกทั้งหมด หากต้องการสแกนชุดย่อยของอุปกรณ์บล็อก ให้เรียก "ldmtool-
อุปกรณ์สแกน" แทน

ldmtool-สแกนอุปกรณ์
ldmtool-scan-devices 'อุปกรณ์ ...'

ฟังก์ชันนี้จะสแกนหาดิสก์ไดนามิกของ Windows ส่งคืนรายการตัวระบุ (GUID)
สำหรับกลุ่มดิสก์ทั้งหมดที่พบ ตัวระบุเหล่านี้สามารถส่งผ่านไปยัง "ldmtool-*" อื่นได้
ฟังก์ชั่น

พารามิเตอร์ "อุปกรณ์" คือรายการอุปกรณ์บล็อกที่สแกน หากรายการนี้คือ
ว่างเปล่า อุปกรณ์บล็อกทั้งหมดจะถูกสแกน

ldmtool-volume-คำใบ้
ไดรฟ์ข้อมูล ldmtool-volume-คำใบ้ diskgroup

ส่งคืนฟิลด์คำใบ้ของโวลุ่มชื่อ "โวลุ่ม" ในกลุ่มดิสก์ด้วย GUID
"กลุ่มดิสก์" ค่านี้ไม่สามารถกำหนดได้ ในกรณีนี้ สตริงว่างจะถูกส่งคืน ดิ
ฟิลด์คำใบ้มักจะเป็นชื่อของไดรฟ์ Windows เช่น "อี:".

ldmtool-volume-พาร์ติชัน
ไดรฟ์ข้อมูล ldmtool-volume-partitions diskgroup

ส่งคืนรายการพาร์ติชั่นในโวลุ่มชื่อ "โวลุ่ม" ในกลุ่มดิสก์ด้วย GUID
"กลุ่มดิสก์"

ldmtool-ปริมาณ-ประเภท
ไดรฟ์ข้อมูลกลุ่มดิสก์ประเภทไดรฟ์ข้อมูล ldmtool

ส่งคืนประเภทของไดรฟ์ข้อมูลที่ชื่อ "volume" ในกลุ่มดิสก์ด้วย GUID "diskgroup"

ประเภทวอลุ่มที่เป็นไปได้ที่สามารถส่งคืนได้ที่นี่ ได้แก่ "แบบธรรมดา" "แบบขยาย" "แบบลาย"
"สะท้อน", "raid5" สามารถส่งคืนประเภทอื่นๆ ได้เช่นกัน

lgetxattr
lgetxattr ชื่อพาธ

รับแอตทริบิวต์ขยายเดียวจากไฟล์ "เส้นทาง" ชื่อ "ชื่อ" หาก "เส้นทาง" เป็นสัญลักษณ์
จากนั้นการเรียกนี้จะส่งคืนแอตทริบิวต์เพิ่มเติมจาก symlink

โดยปกติ เป็นการดีกว่าที่จะรับคุณลักษณะเพิ่มเติมทั้งหมดจากไฟล์ในครั้งเดียวโดยการโทร
"getxattrs". อย่างไรก็ตาม การใช้งานระบบไฟล์ลินุกซ์บางตัวมีข้อผิดพลาดและไม่ได้จัดเตรียมให้
วิธีแสดงรายการแอตทริบิวต์ สำหรับระบบไฟล์เหล่านี้ (โดยเฉพาะ ntfs-3g) คุณต้องรู้จัก
ชื่อของแอตทริบิวต์เพิ่มเติมที่คุณต้องการล่วงหน้าและเรียกใช้ฟังก์ชันนี้

ค่าแอตทริบิวต์เพิ่มเติมคือหยดของข้อมูลไบนารี หากไม่มีแอตทริบิวต์เพิ่มเติม
ชื่อ "ชื่อ" ซึ่งส่งคืนข้อผิดพลาด

ดูเพิ่มเติม: "lgetxattrs", "getxattr", Attribution-NonCommercial-ShareAlike(5)

lgetxattr
lgetxattrs เส้นทาง

สิ่งนี้เหมือนกับ "getxattrs" แต่ถ้า "เส้นทาง" เป็นลิงก์สัญลักษณ์ มันจะส่งคืน
คุณลักษณะเพิ่มเติมของลิงก์เอง

รายการ-9p
รายการ-9p

แสดงรายการระบบไฟล์ 9p ทั้งหมดที่แนบมากับแขก ส่งคืนรายการแท็กการเมานท์

รายการอุปกรณ์
รายการอุปกรณ์

รายการอุปกรณ์บล็อกทั้งหมด

ส่งคืนชื่ออุปกรณ์บล็อกแบบเต็ม เช่น / dev / SDA.

ดูเพิ่มเติมที่ "รายการระบบไฟล์"

รายการดิสก์ป้าย
รายการดิสก์ป้าย

หากคุณเพิ่มไดรฟ์โดยใช้พารามิเตอร์ "label" ที่เป็นตัวเลือกของ "add-drive-opts" คุณสามารถใช้
การเรียกนี้เพื่อแมประหว่างป้ายกำกับดิสก์และอุปกรณ์บล็อกดิบและชื่อพาร์ติชั่น (เช่น
/ dev / SDA และ / dev / sda1).

ส่งคืน hashtable โดยที่คีย์คือป้ายกำกับดิสก์ (ไม่มี /dev/disk/guestfs
คำนำหน้า) และค่าคือชื่ออุปกรณ์บล็อกและพาร์ติชั่นแบบเต็ม (เช่น / dev / SDA
และ / dev / sda1).

รายการ-dm-อุปกรณ์
รายการ-dm-อุปกรณ์

แสดงรายการอุปกรณ์ mapper ของอุปกรณ์ทั้งหมด

รายการที่ส่งคืนประกอบด้วย /dev/ผู้ทำแผนที่/* อุปกรณ์ เช่น ที่สร้างขึ้นโดยการโทรก่อนหน้านี้ถึง
"ลักส์-โอเพ่น".

อุปกรณ์ตัวแมปอุปกรณ์ซึ่งสอดคล้องกับโลจิคัลวอลุ่มคือ ไม่ กลับมาในรายการนี้
โทร "lvs" หากคุณต้องการแสดงรายการโลจิคัลวอลุ่ม

รายการระบบไฟล์
รายการระบบไฟล์

คำสั่งตรวจสอบนี้จะค้นหาระบบไฟล์บนพาร์ติชัน อุปกรณ์บล็อก และตรรกะ
วอลุ่มส่งคืนรายการ "mountables" ที่มีระบบไฟล์และประเภท

ค่าที่ส่งคืนคือแฮช โดยที่คีย์คืออุปกรณ์ที่มีระบบไฟล์ และ
ค่าเป็นประเภทระบบไฟล์ ตัวอย่างเช่น:

"/dev/sda1" => "ntfs"
"/dev/sda2" => "ext2"
"/dev/vg_guest/lv_root" => "ext4"
"/dev/vg_guest/lv_swap" => "สลับ"

กุญแจไม่จำเป็นต้องเป็นอุปกรณ์บล็อก นอกจากนี้ยังอาจเป็นสตริง 'ติดได้' ทึบแสง
ซึ่งสามารถส่งต่อไปยัง "เมานต์" ได้

ค่าสามารถมีค่าพิเศษ "ไม่ทราบ" ซึ่งหมายความว่าเนื้อหาของอุปกรณ์คือ
บึกบึนหรือว่างเปล่า "swap" หมายถึงพาร์ติชั่นลินุกซ์สวอป

คำสั่งนี้รันคำสั่ง libguestfs อื่นๆ ซึ่งอาจรวมถึง "mount" และ "umount" และ
ดังนั้น คุณควรใช้สิ่งนี้ทันทีหลังจากเปิดตัวและเมื่อไม่ได้ติดตั้งอะไรไว้

ระบบไฟล์บางระบบที่ส่งคืนจะไม่สามารถติดตั้งได้ โดยเฉพาะอย่างยิ่ง พาร์ติชั่นสว็อปคือ
กลับมาในรายการ นอกจากนี้ คำสั่งนี้ไม่ได้ตรวจสอบว่าแต่ละระบบไฟล์ที่พบคือ
ถูกต้องและติดตั้งได้ และระบบไฟล์บางระบบอาจติดตั้งได้ แต่ต้องมีตัวเลือกพิเศษ
ระบบไฟล์อาจไม่ใช่ระบบปฏิบัติการลอจิคัลเดียวทั้งหมด (ใช้ "inspect-os" to
มองหาระบบปฏิบัติการ)

list-ldm-พาร์ทิชัน
list-ldm-พาร์ทิชัน

ฟังก์ชันนี้ส่งคืนพาร์ติชันดิสก์ไดนามิกของ Windows ทั้งหมดที่พบในเวลาเปิดใช้
ส่งคืนรายชื่ออุปกรณ์

รายการ LDM ปริมาณ
รายการ LDM ปริมาณ

ฟังก์ชันนี้ส่งคืนไดรฟ์ข้อมูลไดนามิกดิสก์ของ Windows ทั้งหมดที่พบในเวลาเปิดใช้ มัน
ส่งคืนรายชื่ออุปกรณ์

รายการ MD-อุปกรณ์
รายการ MD-อุปกรณ์

แสดงรายการอุปกรณ์ Linux md ทั้งหมด

รายการพาร์ทิชัน
รายการพาร์ทิชัน

แสดงรายการพาร์ติชั่นทั้งหมดที่ตรวจพบบนอุปกรณ์บล็อกทั้งหมด

ชื่ออุปกรณ์พาร์ติชั่นแบบเต็มจะถูกส่งคืน เช่น / dev / sda1

สิ่งนี้ไม่ส่งคืนโลจิคัลวอลุ่ม เพื่อที่คุณจะต้องเรียก "lvs"

ดูเพิ่มเติมที่ "รายการระบบไฟล์"

ll
ไดเรกทอรีทั้งหมด

แสดงรายการไฟล์ใน ไดเรกทอรี (เทียบกับไดเร็กทอรีรูท, ไม่มี cwd) ในไฟล์
รูปแบบของ 'ls -la'

คำสั่งนี้มีประโยชน์สำหรับเซสชันแบบโต้ตอบเป็นส่วนใหญ่ มันคือ ไม่ ตั้งใจให้คุณลอง
เพื่อแยกวิเคราะห์สตริงเอาต์พุต

llz
ไดเรกทอรี llz

แสดงรายการไฟล์ใน ไดเรกทอรี ในรูปแบบของ 'ls -laZ'

คำสั่งนี้มีประโยชน์สำหรับเซสชันแบบโต้ตอบเป็นส่วนใหญ่ มันคือ ไม่ ตั้งใจให้คุณลอง
เพื่อแยกวิเคราะห์สตริงเอาต์พุต

ln
ln ชื่อลิงค์เป้าหมาย

คำสั่งนี้สร้างฮาร์ดลิงก์โดยใช้คำสั่ง "ln"

ln-ฉ
ln-f ชื่อลิงค์เป้าหมาย

คำสั่งนี้สร้างฮาร์ดลิงก์โดยใช้คำสั่ง "ln -f" ดิ -f ตัวเลือกลบ
ลิงค์ ("ชื่อลิงค์") หากมีอยู่แล้ว

ln-s
ln-s ชื่อลิงค์เป้าหมาย

คำสั่งนี้สร้างลิงก์สัญลักษณ์โดยใช้คำสั่ง "ln -s"

อิน-เอสเอฟ
ln-sf ชื่อลิงค์เป้าหมาย

คำสั่งนี้สร้างลิงค์สัญลักษณ์โดยใช้คำสั่ง "ln -sf", The -f ตัวเลือกลบ
ลิงค์ ("ชื่อลิงค์") หากมีอยู่แล้ว

lremovexattr
lremovexattr เส้นทาง xattr

สิ่งนี้เหมือนกับ "removexattr" แต่ถ้า "เส้นทาง" เป็นลิงก์สัญลักษณ์ มันจะลบ
คุณลักษณะขยายของลิงก์เอง

ls
ls ไดเรกทอรี

แสดงรายการไฟล์ใน ไดเรกทอรี (เทียบกับไดเร็กทอรี root ไม่มี cwd) '.'
และรายการ '..' จะไม่ถูกส่งคืน แต่จะแสดงไฟล์ที่ซ่อนอยู่

ls0
ls0 dir (ชื่อไฟล์|-)

คำสั่งพิเศษนี้ใช้เพื่อรับรายชื่อไฟล์ในไดเร็กทอรี "dir"
รายชื่อไฟล์ถูกเขียนลงในไฟล์ในเครื่อง ชื่อไฟล์ (บนโฮสต์).

ในไฟล์เอาต์พุต ชื่อไฟล์จะถูกคั่นด้วยอักขระ "\0"

"." และ ".." จะไม่ถูกส่งคืน ชื่อไฟล์จะไม่ถูกจัดเรียง

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

lsetxattr
lsetxattr xattr val vallen เส้นทาง

สิ่งนี้เหมือนกับ "setxattr" แต่ถ้า "เส้นทาง" เป็นลิงก์สัญลักษณ์ มันจะตั้งค่าส่วนขยาย
คุณลักษณะของลิงก์เอง

ลสแตท
lstat เส้นทาง

ส่งกลับข้อมูลไฟล์สำหรับ "เส้นทาง" ที่กำหนด

สิ่งนี้เหมือนกับ "สถิติ" ยกเว้นว่าหาก "เส้นทาง" เป็นลิงก์สัญลักษณ์ ลิงก์นั้นก็คือ
stat-ed ไม่ใช่ไฟล์ที่อ้างถึง

นี่ก็เหมือนกับ ลสแตท(2) การเรียกระบบ

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ใช้การเรียก "lstatns" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

รายการสถิติ
lstatlist เส้นทาง 'ชื่อ ...'

การเรียกนี้อนุญาตให้คุณดำเนินการ "lstat" กับหลายไฟล์ โดยที่ไฟล์ทั้งหมด
อยู่ในไดเรกทอรี "เส้นทาง" "names" คือรายการไฟล์จากไดเร็กทอรีนี้

คุณจะได้รับรายการโครงสร้างสถิติพร้อมการติดต่อแบบตัวต่อตัวกับ "ชื่อ"
รายการ. หากไม่มีชื่อใดหรือไม่สามารถ lstat'd ได้ ฟิลด์ "st_ino" ของ that
โครงสร้างถูกตั้งค่าเป็น "-1"

การเรียกนี้มีไว้สำหรับโปรแกรมที่ต้องการแสดงรายการเนื้อหาไดเร็กทอรีอย่างมีประสิทธิภาพ
โดยไม่ต้องไป-กลับหลายเที่ยว ดูเพิ่มเติมที่ "lxattrlist" สำหรับการโทรที่มีประสิทธิภาพเช่นเดียวกัน
รับแอตทริบิวต์เพิ่มเติม

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ใช้การเรียก "lstatnslist" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

lstatns
lstatns เส้นทาง

ส่งกลับข้อมูลไฟล์สำหรับ "เส้นทาง" ที่กำหนด

สิ่งนี้เหมือนกับ "statns" ยกเว้นว่าหาก "path" เป็นลิงก์สัญลักษณ์ ลิงก์ก็คือ
stat-ed ไม่ใช่ไฟล์ที่อ้างถึง

นี่ก็เหมือนกับ ลสแตท(2) การเรียกระบบ

รายการ lstatns
lstatnslist เส้นทาง 'ชื่อ ...'

การเรียกนี้อนุญาตให้คุณดำเนินการ "lstatns" ในหลายไฟล์ โดยที่ไฟล์ทั้งหมด
อยู่ในไดเรกทอรี "เส้นทาง" "names" คือรายการไฟล์จากไดเร็กทอรีนี้

คุณจะได้รับรายการโครงสร้างสถิติพร้อมการติดต่อแบบตัวต่อตัวกับ "ชื่อ"
รายการ. หากไม่มีชื่อใดหรือไม่สามารถ lstat'd ได้ ฟิลด์ "st_ino" ของ that
โครงสร้างถูกตั้งค่าเป็น "-1"

การเรียกนี้มีไว้สำหรับโปรแกรมที่ต้องการแสดงรายการเนื้อหาไดเร็กทอรีอย่างมีประสิทธิภาพ
โดยไม่ต้องไป-กลับหลายเที่ยว ดูเพิ่มเติมที่ "lxattrlist" สำหรับการโทรที่มีประสิทธิภาพเช่นเดียวกัน
รับแอตทริบิวต์เพิ่มเติม

luks-add-key
luks-add-key อุปกรณ์ keylot

คำสั่งนี้จะเพิ่มคีย์ใหม่บนอุปกรณ์ "อุปกรณ์" ของ LUKS "คีย์" คือคีย์ที่มีอยู่ และ is
ใช้ในการเข้าถึงอุปกรณ์ "newkey" คือคีย์ใหม่ที่จะเพิ่ม "ช่องกุญแจ" คือช่องกุญแจ
ที่จะถูกแทนที่

โปรดทราบว่าหาก "ช่องกุญแจ" มีคีย์อยู่แล้ว คำสั่งนี้จะล้มเหลว คุณต้อง
ใช้ "luks-kill-slot" ก่อนเพื่อลบคีย์นั้น

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

luks-ปิด
ลักส์ปิดอุปกรณ์

การดำเนินการนี้จะปิดอุปกรณ์ LUKS ที่สร้างขึ้นก่อนหน้านี้โดย "luks-open" หรือ "luks-open-ro" ดิ
พารามิเตอร์ "device" ต้องเป็นชื่อของอุปกรณ์การแมป LUKS (เช่น /dev/mapper/ชื่อแผนที่)
และ ไม่ ชื่อของอุปกรณ์บล็อกพื้นฐาน

luks-รูปแบบ
ช่องเสียบอุปกรณ์รูปแบบ luks

คำสั่งนี้จะลบข้อมูลที่มีอยู่ใน "อุปกรณ์" และจัดรูปแบบอุปกรณ์เป็น LUKS ที่เข้ารหัส
อุปกรณ์. "คีย์" คือคีย์เริ่มต้น ซึ่งเพิ่มลงใน "สล็อต" ของคีย์สล็อต (LUKS รองรับ 8
ช่องเสียบกุญแจหมายเลข 0-7)

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

luks-รูปแบบ-cipher
luks-format-cipher อุปกรณ์ keylot cipher

คำสั่งนี้เหมือนกับ "luks-format" แต่ยังให้คุณตั้งค่า "cipher" ที่ใช้ได้อีกด้วย

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

luks-kill-สล็อต
ช่องเสียบอุปกรณ์ luks-kill-slot

คำสั่งนี้จะลบคีย์ในช่องคีย์ "คีย์สล็อต" ออกจากอุปกรณ์ LUKS ที่เข้ารหัส
"อุปกรณ์". "กุญแจ" ต้องเป็นหนึ่งใน อื่น ๆ กุญแจ

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

luks-เปิด
ชื่อแมปเครื่องลูกเปิด

คำสั่งนี้เปิดอุปกรณ์บล็อกที่ได้รับการเข้ารหัสตาม Linux Unified
มาตรฐานการตั้งค่าคีย์ (LUKS)

"อุปกรณ์" เป็นอุปกรณ์บล็อกหรือพาร์ติชั่นที่เข้ารหัส

ผู้โทรจะต้องระบุหนึ่งในคีย์ที่เกี่ยวข้องกับอุปกรณ์บล็อก LUKS ใน "คีย์"
พารามิเตอร์.

สิ่งนี้จะสร้างอุปกรณ์บล็อกใหม่ที่เรียกว่า /dev/mapper/ชื่อแผนที่. อ่านเขียนถึงสิ่งนี้
อุปกรณ์บล็อกถูกถอดรหัสและเข้ารหัสไปยัง "อุปกรณ์" ที่เกี่ยวข้องตามลำดับ

หากอุปกรณ์บล็อกนี้มีกลุ่มวอลุ่ม LVM ให้เรียก "vgscan" ตามด้วย "vg-
activate-all" จะทำให้มองเห็นได้

ใช้ "list-dm-devices" เพื่อแสดงรายการอุปกรณ์ mapper ของอุปกรณ์ทั้งหมด

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

luks-open-ro
ชื่อแมปอุปกรณ์ luks-open-ro

สิ่งนี้เหมือนกับ "luks-open" ยกเว้นว่ามีการสร้างการแมปแบบอ่านอย่างเดียว

คำสั่งนี้มีพารามิเตอร์คีย์หรือรหัสผ่านตั้งแต่หนึ่งรายการขึ้นไป Guestfish จะแจ้งให้
เหล่านี้แยกต่างหาก

เลเวลสร้าง
lvcreate logvol volgroup เมกะไบต์

สิ่งนี้จะสร้างโลจิคัลวอลุ่ม LVM ที่เรียกว่า "logvol" บนกลุ่มวอลุ่ม "volgroup" ด้วย
"ขนาด" เมกะไบต์

lvcreate ฟรี
lvcreate ฟรี logvol volgroup เปอร์เซ็นต์

สร้างโลจิคัลวอลุ่ม LVM ที่เรียกว่า /dev/volgroup/logvol, โดยใช้ประมาณ "ร้อยละ" %
ของพื้นที่ว่างที่เหลืออยู่ในกลุ่มวอลุ่ม มีประโยชน์มากที่สุดเมื่อ "เปอร์เซ็นต์" เป็น 100
สิ่งนี้จะสร้าง LV ที่ใหญ่ที่สุดเท่าที่จะเป็นไปได้

lvm-canonical-lv-ชื่อ
lvm-canonical-lv-ชื่อ lvname

การทำเช่นนี้จะแปลงรูปแบบการตั้งชื่อทางเลือกสำหรับ LV ที่คุณอาจพบว่าเป็นแบบบัญญัติ
ชื่อ. ตัวอย่างเช่น, /dev/ผู้ทำแผนที่/VG-LV จะถูกแปลงเป็น /dev/VG/LV.

คำสั่งนี้ส่งคืนข้อผิดพลาดหากพารามิเตอร์ "lvname" ไม่ได้อ้างอิงถึงตรรกะ
ปริมาณ

ดูเพิ่มเติมที่ "is-lv", "canonical-device-name"

lvm-ล้างตัวกรอง
lvm-ล้างตัวกรอง

สิ่งนี้จะยกเลิกเอฟเฟกต์ของ "lvm-set-filter" LVM จะสามารถเห็นทุกอุปกรณ์ที่ถูกบล็อก

คำสั่งนี้ยังล้างแคช LVM และทำการสแกนกลุ่มวอลุ่ม

lvm-ลบทั้งหมด
lvm-ลบทั้งหมด

คำสั่งนี้จะลบโลจิคัลวอลุ่ม LVM กลุ่มวอลุ่ม และฟิสิคัลวอลุ่มทั้งหมด

LVM ชุดตัวกรอง
lvm-set-filter 'อุปกรณ์ ...'

ตั้งค่าตัวกรองอุปกรณ์ LVM เพื่อให้ LVM สามารถ "ดู" เฉพาะอุปกรณ์บล็อกได้เท่านั้น
ในรายการ "อุปกรณ์" และจะละเว้นอุปกรณ์บล็อกอื่น ๆ ที่แนบมาทั้งหมด

โดยที่ดิสก์อิมเมจมี PV หรือ VG ที่ซ้ำกัน คำสั่งนี้มีประโยชน์ในการรับ LVM เป็น
ละเว้นรายการที่ซ้ำกัน ไม่เช่นนั้น LVM อาจสับสนได้ หมายเหตุยังมี .สองประเภท
ทำซ้ำได้: PVs/VG ที่ลอกแบบอย่างใดอย่างหนึ่งซึ่งมี UUID เหมือนกัน หรือ VGs ที่
ไม่ได้ลอกแบบ แต่บังเอิญมีชื่อเหมือนกัน ในการดำเนินการปกติ คุณไม่สามารถสร้าง
สถานการณ์นี้ แต่คุณสามารถทำได้นอก LVM เช่น โดยการโคลนดิสก์อิมเมจหรือทีละบิต
twiddling ภายในข้อมูลเมตา LVM

คำสั่งนี้ยังล้างแคช LVM และทำการสแกนกลุ่มวอลุ่ม

คุณสามารถกรองอุปกรณ์บล็อกทั้งหมดหรือแต่ละพาร์ติชั่นได้

คุณไม่สามารถใช้สิ่งนี้ได้หากมีการใช้งาน VG ในปัจจุบัน (เช่น มีระบบไฟล์ที่ต่อเชื่อม)
แม้ว่าคุณจะไม่ได้กรอง VG นั้นออก

ลบ
อุปกรณ์ lvremove

ลบ "อุปกรณ์" โลจิคัลวอลุ่ม LVM โดยที่ "อุปกรณ์" เป็นเส้นทางไปยัง LV เช่น
/dev/VG/LV.

คุณยังสามารถลบ LV ทั้งหมดในกลุ่มวอลุ่มได้โดยการระบุชื่อ VG /dev/VG.

ชื่อ
เปลี่ยนชื่อ logvol newlogvol

เปลี่ยนชื่อโลจิคัลวอลุ่ม "logvol" ด้วยชื่อใหม่ "newlogvol"

ปรับขนาด
lvresize อุปกรณ์ mbytes

สิ่งนี้จะปรับขนาด (ขยายหรือย่อ) โลจิคัลวอลุ่ม LVM ที่มีอยู่เป็น "mbytes" เมื่อไหร่
ลดข้อมูลในส่วนที่ลดลงจะหายไป

lresize ฟรี
lvresize ฟรี lv เปอร์เซ็นต์

สิ่งนี้จะขยายโลจิคัลวอลุ่มที่มีอยู่ "lv" เพื่อเติม "pc"% ของว่างที่เหลือ
พื้นที่ในกลุ่มวอลุ่ม โดยทั่วไปคุณจะเรียกสิ่งนี้ด้วย pc = 100 ซึ่งขยาย
โลจิคัลวอลุ่มให้มากที่สุด โดยใช้พื้นที่ว่างที่เหลืออยู่ทั้งหมดในกลุ่มวอลุ่ม

เลเวล
เลเวล

แสดงรายการโลจิคัลวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ เลเวล(8) คำสั่ง

ส่งคืนรายการชื่ออุปกรณ์โลจิคัลวอลุ่ม (เช่น /dev/VolGroup00/LogVol00).

ดูเพิ่มเติมที่ "lvs-full", "list-filesystems"

lvs-เต็ม
lvs-เต็ม

แสดงรายการโลจิคัลวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ เลเวล(8) คำสั่ง ดิ
เวอร์ชัน "เต็ม" รวมทุกช่อง

หืม
อุปกรณ์ lvuuid

คำสั่งนี้ส่งคืน UUID ของ "อุปกรณ์" ของ LVM LV

รายการ
lxattrlist เส้นทาง 'ชื่อ ...'

การเรียกนี้อนุญาตให้คุณรับแอ็ตทริบิวต์ขยายของไฟล์หลายไฟล์ โดยที่ไฟล์ทั้งหมดอยู่
ในไดเรกทอรี "เส้นทาง" "names" คือรายการไฟล์จากไดเร็กทอรีนี้

คุณจะได้รับรายการโครงสร้าง xattr แบบเรียบๆ ซึ่งต้องตีความตามลำดับ
xattr struct แรกจะมี "attrname" ที่มีความยาวเป็นศูนย์เสมอ "attrval" ในโครงสร้างนี้คือ
ความยาวเป็นศูนย์เพื่อระบุว่ามีข้อผิดพลาดในการทำ "lgetxattr" สำหรับไฟล์นี้ or คือ C
สตริงซึ่งเป็นตัวเลขทศนิยม (จำนวนแอตทริบิวต์ต่อไปนี้สำหรับไฟล์นี้ซึ่ง
อาจเป็น "0") จากนั้นหลังจากโครงสร้าง xattr แรกเป็นศูนย์หรือมากกว่าแอตทริบิวต์สำหรับ
ไฟล์ชื่อแรก การดำเนินการนี้ซ้ำสำหรับไฟล์ที่สองและไฟล์ที่ตามมา

การเรียกนี้มีไว้สำหรับโปรแกรมที่ต้องการแสดงรายการเนื้อหาไดเร็กทอรีอย่างมีประสิทธิภาพ
โดยไม่ต้องไป-กลับหลายเที่ยว ดูเพิ่มเติมที่ "lstatlist" สำหรับการโทรที่มีประสิทธิภาพเช่นเดียวกัน
รับสถิติมาตรฐาน

แม็กซ์ดิสก์
แม็กซ์ดิสก์

ส่งกลับจำนวนสูงสุดของดิสก์ที่สามารถเพิ่มไปยังแฮนเดิลได้ (เช่น โดย "add-drive-opts"
และการโทรที่คล้ายกัน)

ฟังก์ชันนี้ถูกเพิ่มใน libguestfs 1.19.7 ในเวอร์ชันก่อนหน้าของ libguestfs the
ขีดจำกัดคือ 25

ดู "จำนวนสูงสุดของดิสก์" ใน แขก(3) สำหรับข้อมูลเพิ่มเติมในหัวข้อนี้

md-สร้าง
md- สร้างชื่อ 'อุปกรณ์ ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [ระดับ:..]

สร้างอุปกรณ์ Linux md (RAID) ชื่อ "name" บนอุปกรณ์ในรายการ "devices"

พารามิเตอร์ทางเลือกคือ:

"บิตแมปหายไป"
บิตแมปของอุปกรณ์ที่หายไป หากตั้งค่าบิตหมายความว่ามีการเพิ่มอุปกรณ์ที่ขาดหายไป
ไปยังอาร์เรย์ บิตที่มีนัยสำคัญน้อยที่สุดสอดคล้องกับอุปกรณ์แรกในอาร์เรย์

เป็นตัวอย่าง:

หาก "devices = ["/dev/sda"]" และ "missingbitmap = 0x1" แสดงว่าอาร์เรย์ที่ได้จะเป็น
เป็น "[ , "/dev/sda"]".

หาก "devices = ["/dev/sda"]" และ "missingbitmap = 0x2" แสดงว่าอาร์เรย์ที่ได้จะเป็น
เป็น "["/dev/sda", ]".

ค่าเริ่มต้นนี้เป็น 0 (ไม่มีอุปกรณ์ที่ขาดหายไป)

ความยาวของ "อุปกรณ์" + จำนวนบิตที่กำหนดใน "บิตแมปหายไป" ต้องเท่ากัน
"nrdevices" + "อะไหล่"

"nrdevices"
จำนวนอุปกรณ์ RAID ที่ใช้งานอยู่

หากไม่ได้ตั้งค่า ค่าเริ่มต้นนี้จะเป็นความยาวของ "อุปกรณ์" บวกกับจำนวนบิตที่ตั้งไว้ใน
"บิตแมปหายไป"

"สำรอง"
จำนวนอุปกรณ์สำรอง

หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นนี้จะอยู่ที่ 0

"ก้อน"
ขนาดก้อนเป็นไบต์

"ระดับ"
ระดับ RAID ซึ่งสามารถเป็นหนึ่งใน: เชิงเส้น, raid0, 0, ริ้ว, raid1, 1, กระจก,
raid4, 4, raid5, 5, raid6, 6, raid10, 10. สิ่งเหล่านี้มีความหมายเหมือนกันและอื่น ๆ
อาจมีการเพิ่มระดับในอนาคต

หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นนี้จะเป็น "raid1"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

md-รายละเอียด
md-รายละเอียด md

คำสั่งนี้แสดงผลลัพธ์ของ 'mdadm -DY '. ฟิลด์ต่อไปนี้มักจะ
มีอยู่ในแฮชที่ส่งคืน อาจมีสาขาอื่นด้วย

"ระดับ"
ระดับการโจมตีของอุปกรณ์ MD

"อุปกรณ์"
จำนวนอุปกรณ์พื้นฐานในอุปกรณ์ MD

"ข้อมูลเมตา"
เวอร์ชันข้อมูลเมตาที่ใช้

"อุอิอิด"
UUID ของอุปกรณ์ MD

"ชื่อ"
ชื่ออุปกรณ์ MD

md-สถิติ
md-สถิติ md

การเรียกนี้จะส่งคืนรายการของอุปกรณ์พื้นฐานซึ่งประกอบขึ้นเป็นซอฟต์แวร์ RAID . ตัวเดียว
อุปกรณ์อาร์เรย์ "md"

หากต้องการรับรายการอุปกรณ์ RAID ของซอฟต์แวร์ ให้เรียก "list-md-devices"

โครงสร้างแต่ละรายการที่ส่งคืนจะสอดคล้องกับอุปกรณ์หนึ่งเครื่องพร้อมกับสถานะเพิ่มเติม
ข้อมูล:

"mdstat_device"
ชื่ออุปกรณ์พื้นฐาน

"mdstat_index"
ดัชนีของอุปกรณ์นี้ภายในอาร์เรย์

"mdstat_flags"
แฟล็กที่เกี่ยวข้องกับอุปกรณ์นี้ นี่คือสตริงที่มี (ไม่เรียงลำดับเฉพาะ)
ศูนย์หรือมากกว่าของแฟล็กต่อไปนี้:

"W" เขียน-ส่วนใหญ่

เครื่อง "F" เสีย

อุปกรณ์ "S" คือ RAID สำรอง

ตัว "R" แทน

md-หยุด
md-หยุด md

คำสั่งนี้จะปิดใช้งานอาร์เรย์ MD ชื่อ "md" อุปกรณ์หยุดทำงาน แต่ไม่หยุด
ถูกทำลายหรือศูนย์

mkdir
เส้นทาง mkdir

สร้างไดเร็กทอรีชื่อ "เส้นทาง"

mkdir โหมด
โหมดเส้นทางโหมด mkdir

คำสั่งนี้สร้างไดเร็กทอรี โดยตั้งค่าการอนุญาตเริ่มต้นของไดเร็กทอรีเป็น
"โหมด".

สำหรับระบบไฟล์ Linux ทั่วไป โหมดจริงที่ตั้งค่าไว้จะเป็น "mode & ~umask &
01777" ระบบไฟล์ที่ไม่ใช่ของ Linux อาจตีความโหมดด้วยวิธีอื่น

ดูเพิ่มเติมที่ "mkdir", "umask"

mkdir-p
mkdir-p เส้นทาง

สร้างไดเร็กทอรีชื่อ "path" โดยสร้างไดเร็กทอรีหลักตามความจำเป็น นี่คือ
เช่นคำสั่งเชลล์ "mkdir -p"

mkdtemp
mkdtemp tmpl

คำสั่งนี้สร้างไดเร็กทอรีชั่วคราว พารามิเตอร์ "tmpl" ควรเป็น full
ชื่อพาธสำหรับชื่อไดเร็กทอรีชั่วคราวที่มีอักขระหกตัวสุดท้ายคือ "XXXXXX"

ตัวอย่างเช่น: "/tmp/myprogXXXXXX" หรือ "/Temp/myprogXXXXXX" อันที่สองเหมาะสม
สำหรับระบบไฟล์ Windows

ชื่อของไดเร็กทอรีชั่วคราวที่สร้างขึ้นจะถูกส่งคืน

ไดเร็กทอรีชั่วคราวถูกสร้างขึ้นด้วยโหมด 0700 และเป็นเจ้าของโดยรูท

ผู้โทรมีหน้าที่ลบไดเร็กทอรีชั่วคราวและเนื้อหาในไดเร็กทอรีหลังจากใช้งาน

See also: mkdtemp(3)

mke2fs
อุปกรณ์ mke2fs [จำนวนบล็อค:N] [ขนาดบล็อก:N] [fragsize:N] [blockspergroup:N] [numberofgroups:N] [bytesperinode:N] [inodesize:N] [journalsize:N] [numberofinodes:N] [stridesize: N] [stripewidth:N] [maxonlineresize:N] [reservedblockspercentage:N] [mmpupdateinterval:N] [journaldevice:..] [label:..] [lastmounteddir:..] [creatoros:..] [fstype:. .] [ประเภทการใช้งาน:..] [uuid:..] [forcecreate:จริง|เท็จ] [เขียนกลุ่มเท่านั้น:จริง|เท็จ] [lazyitableinit:จริง|เท็จ] [lazyjournalinit:จริง|เท็จ] [testfs:จริง|เท็จ] [ ละทิ้ง:จริง|เท็จ] [โควตาประเภท:จริง|เท็จ] [ขอบเขต:จริง|เท็จ] [ประเภทไฟล์:จริง|เท็จ] [flexbg:จริง|เท็จ] [hasjournal:จริง|เท็จ] [วารสารเดฟ:จริง|เท็จ] [ขนาดใหญ่ :จริง|เท็จ] [โควตา:จริง|เท็จ] [ปรับขนาดโนด:จริง|เท็จ] [กระจัดกระจาย:จริง|เท็จ] [uninitbg:จริง|เท็จ]

"mke2fs" ใช้เพื่อสร้างระบบไฟล์ ext2, ext3 หรือ ext4 บน "อุปกรณ์"

ตัวเลือก "จำนวนบล็อก" คือขนาดของระบบไฟล์ในหน่วยบล็อก ถ้าละเว้น
ค่าเริ่มต้นเป็นขนาดของ "อุปกรณ์" โปรดทราบว่าระบบไฟล์มีขนาดเล็กเกินไปที่จะมี a
Journal "mke2fs" จะสร้างระบบไฟล์ ext2 แบบเงียบๆ แทน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

mke2fs-J
mke2fs-J fstype blocksize อุปกรณ์ Journal

สิ่งนี้จะสร้างระบบไฟล์ ext2/3/4 บน "อุปกรณ์" โดยมีเจอร์นัลภายนอกใน "journal" มัน
เทียบเท่ากับคำสั่ง:

mke2fs -t fstype -b blocksize -J อุปกรณ์=

ดูเพิ่มเติมที่ "mke2journal"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mke2fs-JL
mke2fs-JL fstype blocksize อุปกรณ์ label

สิ่งนี้สร้างระบบไฟล์ ext2/3/4 บน "อุปกรณ์" โดยมีเจอร์นัลภายนอกใน journal
ที่มีป้ายกำกับว่า "ฉลาก"

ดูเพิ่มเติมที่ "mke2journal-L"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mke2fs-JU
mke2fs-JU อุปกรณ์ขนาดบล็อก fstype uuid

สิ่งนี้สร้างระบบไฟล์ ext2/3/4 บน "อุปกรณ์" โดยมีเจอร์นัลภายนอกใน journal
ด้วย UUID "uuid"

ดูเพิ่มเติมที่ "mke2journal-U"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mke2journal
อุปกรณ์ขนาดบล็อก mke2journal

สิ่งนี้จะสร้างวารสารภายนอก ext2 บน "อุปกรณ์" มันเทียบเท่ากับคำสั่ง:

mke2fs -O journal_dev -b อุปกรณ์ขนาดบล็อก

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mke2journal-L
mke2journal-L อุปกรณ์ฉลากขนาดบล็อก

สิ่งนี้จะสร้างวารสารภายนอก ext2 บน "อุปกรณ์" พร้อมป้ายกำกับ "ป้ายกำกับ"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mke2journal-U
mke2journal-U บล็อกขนาดอุปกรณ์ uuid

สิ่งนี้จะสร้างวารสารภายนอก ext2 บน "อุปกรณ์" ด้วย UUID "uuid"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การโทร "mke2fs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เอ็มเคฟิโฟ
เส้นทางโหมด mkfifo

การเรียกนี้สร้าง FIFO (ชื่อไปป์) ที่เรียกว่า "เส้นทาง" ด้วยโหมด "โหมด" มันเป็นแค่เ
เครื่องห่อที่สะดวกรอบ "mknod"

ต่างจาก "mknod", "mode" ต้อง มีเฉพาะบิตการอนุญาต

โหมดที่ตั้งไว้จริงได้รับผลกระทบจาก umask

เอ็มเคเอฟเอส
mkfs-ตัวเลือก
mkfs อุปกรณ์ fstype [ขนาดบล็อก:N] [คุณสมบัติ:..] [ไอโหนด:N] [ขนาดกลุ่ม:N] [ป้ายกำกับ:..]

ฟังก์ชันนี้สร้างระบบไฟล์บน "อุปกรณ์" ประเภทระบบไฟล์คือ "fstype" สำหรับ
ตัวอย่าง "ext3"

อาร์กิวเมนต์ที่เป็นทางเลือกคือ:

"บล็อกขนาด"
ขนาดบล็อกของระบบไฟล์ ขนาดบล็อกที่รองรับขึ้นอยู่กับประเภทระบบไฟล์ แต่
โดยทั่วไปคือ 1024, 2048 หรือ 4096 สำหรับระบบไฟล์ Linux ext2/3

สำหรับ VFAT และ NTFS พารามิเตอร์ "ขนาดบล็อก" จะถือเป็นขนาดคลัสเตอร์ที่ร้องขอ

สำหรับขนาดบล็อก UFS โปรดดูที่ mkfs.ufs(8)

"คุณสมบัติ"
สิ่งนี้ผ่าน -O พารามิเตอร์ไปยังโปรแกรม mkfs ภายนอก

สำหรับระบบไฟล์บางประเภท อนุญาตให้เลือกคุณสมบัติระบบไฟล์เพิ่มเติมได้
ดู mke2fs(8) และ mkfs.ufs(8) สำหรับรายละเอียดเพิ่มเติม

คุณไม่สามารถใช้พารามิเตอร์ทางเลือกนี้กับประเภทระบบไฟล์ "gfs" หรือ "gfs2"

"ไอโนด"
สิ่งนี้ผ่าน -I พารามิเตอร์ภายนอก mke2fs(8) โปรแกรมที่กำหนด inode
ขนาด (สำหรับระบบไฟล์ ext2/3/4 เท่านั้นในปัจจุบัน)

"ขนาดภาคส่วน"
สิ่งนี้ผ่าน -S พารามิเตอร์ภายนอก mkfs.ufs(8) โปรแกรมที่กำหนดขนาดเซกเตอร์
สำหรับระบบไฟล์ ufs

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

mkfs-b
mkfs-b อุปกรณ์ขนาดบล็อก fstype

การเรียกนี้คล้ายกับ "mkfs" แต่ช่วยให้คุณสามารถควบคุมขนาดบล็อกของ
ระบบไฟล์ผลลัพธ์ ขนาดบล็อกที่รองรับขึ้นอยู่กับประเภทของระบบไฟล์ แต่โดยทั่วไป
คือ 1024, 2048 หรือ 4096 เท่านั้น

สำหรับ VFAT และ NTFS พารามิเตอร์ "ขนาดบล็อก" จะถือเป็นขนาดคลัสเตอร์ที่ร้องขอ

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "mkfs" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mkfs-btrfs
mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] [leafsize:N] [label:..] [metadata:..] [nodesize:N] [sectorsize: ไม่]

สร้างระบบไฟล์ btrfs เพื่อให้สามารถตั้งค่าคอนฟิกได้ทั้งหมด สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ
อาร์กิวเมนต์ที่เป็นตัวเลือก ดู mkfs.btrfs(8)

เนื่องจากระบบไฟล์ btrfs สามารถขยายได้หลายอุปกรณ์ การดำเนินการนี้จึงทำให้รายการอุปกรณ์ไม่ว่างเปล่า

ในการสร้างระบบไฟล์ทั่วไป ให้ใช้ "mkfs"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

mklost และพบ
mklost-and-found จุดเมานท์

สร้างไดเร็กทอรี "lost+found" โดยปกติในไดเร็กทอรีรากของระบบไฟล์ ext2/3/4
"mountpoint" คือไดเร็กทอรีที่เราพยายามสร้างไดเร็กทอรี "lost+found"

mkmountpoint
เส้นทางการยกเว้น mkmountpoint

"mkmountpoint" และ "rmmountpoint" เป็นการเรียกเฉพาะที่สามารถใช้เพื่อสร้างพิเศษได้
mountpoints ก่อนติดตั้งระบบไฟล์แรก

การโทรเหล่านี้คือ เพียง จำเป็นในสถานการณ์ที่จำกัดมาก โดยเฉพาะกรณีที่
คุณต้องการติดตั้งระบบไฟล์ที่ไม่เกี่ยวข้องและ/หรืออ่านอย่างเดียวผสมกัน

ตัวอย่างเช่น ซีดีสดมักประกอบด้วยระบบไฟล์ "ตุ๊กตารัสเซีย" ซึ่งเป็น ISO outer
เลเยอร์ โดยมีอิมเมจ squashfs อยู่ข้างใน โดยมีอิมเมจ ext2/3 อยู่ข้างใน คุณสามารถแกะกล่อง
นี้ดังต่อไปนี้ใน guestfish:

ส่วนเสริม Fedora-11-i686-Live.iso
วิ่ง
mkmountpoint /ซีดี
mkmountpoint /sqsh.php
mkmountpoint /ext3fs
เมานต์ /dev/sda /cd
เมานต์ลูป /cd/LiveOS/squashfs.img /sqsh
เมานต์ลูป /sqsh/LiveOS/ext3fs.img /ext3fs

ระบบไฟล์ภายในถูกแตกออกภายใต้ /ext3fs mountpoint

"mkmountpoint" เข้ากันไม่ได้กับ "umount-all" คุณอาจได้รับข้อผิดพลาดที่ไม่คาดคิดหากคุณ
พยายามผสมสายเหล่านี้ การ unmount ระบบไฟล์และเอาออกด้วยตนเองจะปลอดภัยที่สุด
จุดยึดหลังการใช้งาน

"umount-all" ยกเลิกการต่อเชื่อมระบบไฟล์โดยเรียงลำดับพาธที่ยาวที่สุดก่อน เพื่อให้ใช้งานได้
สำหรับจุดต่อเชื่อมแบบแมนนวล คุณต้องแน่ใจว่าจุดต่อเชื่อมด้านในสุดนั้นยาวที่สุด
ชื่อพาธ ตามตัวอย่างโค้ดด้านบน

ดูรายละเอียดเพิ่มเติมได้ที่ https://bugzilla.redhat.com/show_bug.cgi?id=599503

Autosync [ดู "set-autosync" ซึ่งตั้งค่าโดยค่าเริ่มต้นที่ handles] อาจทำให้ "umount-all" เป็น
จะถูกเรียกเมื่อปิดที่จับซึ่งอาจทำให้เกิดปัญหาเหล่านี้ได้เช่นกัน

มโนด
โหมด mknod devmajor เส้นทาง devminor

การเรียกนี้สร้างอุปกรณ์พิเศษบล็อกหรืออักขระ หรือไปป์ที่มีชื่อ (FIFO)

พารามิเตอร์ "mode" ควรเป็นโหมดโดยใช้ค่าคงที่มาตรฐาน "devmajor" และ
"devminor" เป็นตัวเลขหลักและรองของอุปกรณ์ ใช้เฉพาะเมื่อสร้างบล็อกและ
อุปกรณ์พิเศษของตัวละคร

โปรดทราบว่าเช่นเดียวกับ มโนด(2) โหมดต้องเป็นบิตหรือกับ S_IFBLK, S_IFCHR,
S_IFIFO หรือ S_IFSOCK (มิฉะนั้นการโทรนี้จะสร้างไฟล์ปกติ) ค่าคงที่เหล่านี้
มีอยู่ในไฟล์ส่วนหัวของ Linux มาตรฐานหรือคุณสามารถใช้ "mknod-b", "mknod-c" หรือ
"mkfifo" ซึ่งเป็นตัวห่อหุ้มคำสั่งนี้ซึ่งระดับบิต OR ในความเหมาะสม
คงที่สำหรับคุณ

โหมดที่ตั้งไว้จริงได้รับผลกระทบจาก umask

mknod-b
โหมด mknod-b devmajor เส้นทาง devminor

การเรียกนี้สร้างโหนดอุปกรณ์บล็อกที่เรียกว่า "เส้นทาง" ด้วยโหมด "โหมด" และอุปกรณ์
หลัก/รอง "devmajor" และ "devminor" เป็นเพียงกระดาษห่อหุ้มที่สะดวกรอบๆ "mknod"

ต่างจาก "mknod", "mode" ต้อง มีเฉพาะบิตการอนุญาต

โหมดที่ตั้งไว้จริงได้รับผลกระทบจาก umask

mknod-c
โหมด mknod-c devmajor เส้นทาง devminor

การเรียกนี้จะสร้างโหนดอุปกรณ์ถ่านที่เรียกว่า "เส้นทาง" พร้อมโหมด "โหมด" และอุปกรณ์หลัก/รอง
"devmajor" และ "devminor" เป็นเพียงกระดาษห่อหุ้มที่สะดวกรอบๆ "mknod"

ต่างจาก "mknod", "mode" ต้อง มีเฉพาะบิตการอนุญาต

โหมดที่ตั้งไว้จริงได้รับผลกระทบจาก umask

mkswap
ตัวเลือก mkswap
อุปกรณ์ mkswap [ป้ายกำกับ:..] [uuid:..]

สร้างพาร์ติชั่นสว็อป Linux บน "อุปกรณ์"

อาร์กิวเมนต์ตัวเลือก "label" และ "uuid" อนุญาตให้คุณตั้งค่าป้ายกำกับและ/หรือ UUID ใหม่
สลับพาร์ทิชัน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

mkswap-L
อุปกรณ์ฉลาก mkswap-L

สร้างพาร์ติชั่นสว็อปบน "อุปกรณ์" พร้อมป้ายกำกับ "ป้ายกำกับ"

โปรดทราบว่าคุณไม่สามารถแนบป้ายสลับกับอุปกรณ์บล็อกได้ (เช่น / dev / SDA) เพียงเพื่อ
พาร์ทิชัน ดูเหมือนว่าจะเป็นข้อจำกัดของเคอร์เนลหรือเครื่องมือสลับ

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "mkswap" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mkswap-U
mkswap-U uuid อุปกรณ์

สร้างพาร์ติชั่นสว็อปบน "อุปกรณ์" ด้วย UUID "uuid"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "mkswap" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

mkswap-ไฟล์
mkswap-เส้นทางไฟล์

สร้างไฟล์สลับ

คำสั่งนี้เพียงแค่เขียนลายเซ็นไฟล์สลับไปยังไฟล์ที่มีอยู่ เพื่อสร้างไฟล์
ตัวเองใช้บางอย่างเช่น "fallocate"

mktemp
mktemp tmpl [คำต่อท้าย:..]

คำสั่งนี้สร้างไฟล์ชั่วคราว พารามิเตอร์ "tmpl" ควรเป็นชื่อพาธแบบเต็มสำหรับ
ชื่อไดเร็กทอรีชั่วคราวที่มีอักขระหกตัวสุดท้ายคือ "XXXXXX"

ตัวอย่างเช่น: "/tmp/myprogXXXXXX" หรือ "/Temp/myprogXXXXXX" อันที่สองเหมาะสม
สำหรับระบบไฟล์ Windows

ชื่อของไฟล์ชั่วคราวที่สร้างขึ้นจะถูกส่งคืน

ไฟล์ชั่วคราวถูกสร้างขึ้นด้วยโหมด 0600 และเป็นเจ้าของโดยรูท

ผู้โทรมีหน้าที่ลบไฟล์ชั่วคราวหลังการใช้งาน

หากระบุพารามิเตอร์ "suffix" ที่เป็นทางเลือก ให้ต่อท้าย (เช่น ".txt")
ชื่อชั่วคราว

ดูเพิ่มเติม: "mkdtemp".

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

modprobe
modprobe ชื่อโมดูล

สิ่งนี้จะโหลดโมดูลเคอร์เนลในอุปกรณ์

ภูเขา
เม้าท์ เมาท์พอยต์

เมานต์ดิสก์ของแขกที่ตำแหน่งในระบบไฟล์ อุปกรณ์ที่ถูกบล็อกมีชื่อว่า / dev / SDA,
dev / sdb / และอื่น ๆ ตามที่พวกเขาถูกเพิ่มไปยังแขก หากอุปกรณ์บล็อกเหล่านั้นมี
พาร์ติชั่นจะมีชื่อปกติ (เช่น / dev / sda1). LVM .ด้วย /dev/VG/LVสไตล์
สามารถใช้ชื่อหรือสตริง 'เมานท์' ที่ส่งคืนโดย "list-filesystems" หรือ "inspect-get-
จุดติดตั้ง".

กฎเหมือนกันสำหรับ ภูเขา(2): ต้องติดตั้งระบบไฟล์ก่อน / ก่อน
อื่น ๆ สามารถติดตั้งได้ ระบบไฟล์อื่นสามารถติดตั้งได้เฉพาะในไดเร็กทอรีที่มีอยู่แล้ว
มีอยู่

ระบบไฟล์ที่เมาต์นั้นสามารถเขียนได้ หากเรามีสิทธิ์เพียงพอในไฟล์พื้นฐาน
เครื่อง

ก่อนหน้า libguestfs 1.13.16 การโทรนี้จะเพิ่มตัวเลือก "ซิงค์" และ "noatime" โดยปริยาย
ตัวเลือก "ซิงค์" ทำให้การเขียนช้าลงอย่างมาก และทำให้ผู้ใช้เกิดปัญหามากมาย ถ้าคุณ
โปรแกรมอาจต้องทำงานกับ libguestfs เวอร์ชันเก่า ให้ใช้ "ตัวเลือกการเมานต์" แทน
(ใช้สตริงว่างสำหรับพารามิเตอร์แรกหากคุณไม่ต้องการตัวเลือกใดๆ)

เมานต์-9p
mount-9p mounttag mountpoint [ตัวเลือก:..]

เมานต์ระบบไฟล์ virtio-9p ด้วยแท็ก "mounttag" บนไดเร็กทอรี "mountpoint"

หากจำเป็น ระบบจะเพิ่ม "trans=virtio" ลงในตัวเลือกโดยอัตโนมัติ ทางเลือกอื่นๆ
สามารถส่งผ่านในพารามิเตอร์ "ตัวเลือก" ที่เป็นตัวเลือกได้

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เม้าท์ท้องถิ่น
mount-local localmountpoint [อ่านอย่างเดียว:จริง|เท็จ] [ตัวเลือก:..] [cachetimeout:N] [debugcalls:true|false]

การเรียกนี้จะส่งออกระบบไฟล์ที่เข้าถึงได้ของ libguestfs ไปยังจุดเชื่อมต่อในเครื่อง (ไดเร็กทอรี)
เรียกว่า "localmountpoint" การอ่านและเขียนแบบธรรมดาไปยังไฟล์และไดเร็กทอรีภายใต้
"localmountpoint" ถูกเปลี่ยนเส้นทางผ่าน libguestfs

หากตั้งค่าสถานะตัวเลือก "อ่านอย่างเดียว" เป็น true ให้เขียนข้อผิดพลาดในการส่งคืนระบบไฟล์
"เอรอฟส์"

"ตัวเลือก" คือรายการตัวเลือกการเมานท์ที่คั่นด้วยเครื่องหมายจุลภาค ดู แขกรับเชิญ(1) เพื่อประโยชน์บางอย่าง
ตัวเลือก

"cachetimeout" ตั้งค่าการหมดเวลา (เป็นวินาที) สำหรับรายการไดเรกทอรีแคช ค่าเริ่มต้นคือ
60 วินาที ดู แขกรับเชิญ(1) สำหรับข้อมูลเพิ่มเติม

หากตั้งค่า "debugcalls" เป็นจริง จะมีการสร้างข้อมูลการดีบักเพิ่มเติมสำหรับ
ทุกสาย FUSE

เมื่อ "mount-local" กลับมา ระบบไฟล์พร้อมแต่ไม่ประมวลผลคำขอ
(การเข้าถึงจะถูกบล็อก) คุณต้องเรียก "mount-local-run" เพื่อเรียกใช้ลูปหลัก

ดู "MOUNT LOCAL" ใน แขก(3) สำหรับเอกสารฉบับเต็ม

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เมานต์โลคัลรัน
เมานต์โลคัลรัน

เรียกใช้ลูปหลักซึ่งแปลการเรียกเคอร์เนลเป็นการเรียก libguestfs

ควรเรียกสิ่งนี้หลังจากส่งคืน "mount-local" สำเร็จเท่านั้น การโทรจะไม่
กลับมาจนกว่าจะยกเลิกการต่อเชื่อมระบบไฟล์

หมายเหตุ คุณต้อง ไม่ ทำการเรียก libguestfs พร้อมกันบนแฮนเดิลเดียวกันจากเธรดอื่น

คุณอาจเรียกสิ่งนี้จากเธรดอื่นที่ไม่ใช่เธรดที่เรียกว่า "mount-local", subject
ตามกฎปกติสำหรับเธรดและ libguestfs (ดู "MULTIPLE HANDLES AND MULTIPLE THREADS"
in แขก(พ.ศ. 3)).

ดู "MOUNT LOCAL" ใน แขก(3) สำหรับเอกสารฉบับเต็ม

เมานต์ห่วง
ไฟล์ mount-loop mountpoint

คำสั่งนี้ให้คุณเมานต์ ไฟล์ (อิมเมจระบบไฟล์ในไฟล์) บนจุดต่อเชื่อม มันคือ
เทียบเท่ากับคำสั่ง "mount -o loop file mountpoint" โดยสิ้นเชิง

ตัวเลือกการเมานต์
mount-options ตัวเลือก mountpoint ติดตั้งได้

คำสั่งนี้เหมือนกับคำสั่ง "เมานต์" แต่อนุญาตให้คุณตั้งค่าตัวเลือกการเมานท์เป็น for
ภูเขา(8) -o ธง.

หากพารามิเตอร์ "options" เป็นสตริงว่าง จะไม่มีการส่งตัวเลือกใด ๆ (ตัวเลือกทั้งหมด
ค่าเริ่มต้นเป็นสิ่งที่ระบบไฟล์ใช้)

เมานต์-โร
mount-ro mountpoint แบบติดตั้งได้

คำสั่งนี้เหมือนกับคำสั่ง "เมานต์" แต่จะเมาต์ระบบไฟล์ด้วยคำสั่งอ่านอย่างเดียว
(-o ro) ธง.

เมานต์ vfs
ตัวเลือก mount-vfs vfstype mountpoint ที่ติดตั้งได้

คำสั่งนี้เหมือนกับคำสั่ง "เมานต์" แต่อนุญาตให้คุณตั้งค่าทั้งตัวเลือกการเมานท์
และ vfstype สำหรับ ภูเขา(8) -o และ -t ธง

จุดยึด
จุดยึด

การเรียกนี้คล้ายกับ "การต่อเชื่อม" การโทรนั้นจะส่งคืนรายการอุปกรณ์ ตัวนี้คืนมา
ตารางแฮช (แผนที่) ของชื่ออุปกรณ์ไปยังไดเร็กทอรีที่ติดตั้งอุปกรณ์

เมาท์
เมาท์

ส่งคืนรายการของระบบไฟล์ที่เมาท์ในปัจจุบัน ส่งคืนรายการอุปกรณ์
(เช่น. / dev / sda1, /dev/VG/LV).

การติดตั้งภายในบางอย่างจะไม่แสดง

ดูเพิ่มเติม: "จุดยึด"

mv
mv src ปลายทาง

สิ่งนี้จะย้ายไฟล์จาก "src" เป็น "dest" โดยที่ "dest" เป็นชื่อไฟล์ปลายทางหรือ
ไดเรกทอรีปลายทาง

ดูเพิ่มเติม: "เปลี่ยนชื่อ".

nr-อุปกรณ์
nr-อุปกรณ์

ส่งคืนจำนวนอุปกรณ์บล็อกทั้งหมดที่เพิ่มเข้ามา นี่ก็เหมือนกับ
จำนวนอุปกรณ์ที่จะส่งคืนหากคุณเรียกว่า "list-devices"

หากต้องการทราบจำนวนอุปกรณ์สูงสุดที่สามารถเพิ่มได้ ให้เรียก "max-disks"

ntfs-3g-โพรบ
ntfs-3g-probe จริง|อุปกรณ์เท็จ

คำสั่งนี้รัน the ntfs-3g.โพรบ(8) คำสั่งที่โพรบ "อุปกรณ์" NTFS สำหรับ
ความสามารถในการติดตั้ง (ไดรฟ์ข้อมูล NTFS บางชนิดไม่สามารถเมาต์แบบอ่าน-เขียนได้ และบางไดรฟ์ไม่สามารถเมาต์ได้
เลย).

"rw" เป็นแฟล็กบูลีน ตั้งค่าเป็นจริงหากคุณต้องการทดสอบว่าสามารถติดตั้งโวลุ่มได้หรือไม่
อ่านเขียน. ตั้งค่าเป็น "เท็จ" หากคุณต้องการทดสอบว่าสามารถติดตั้งไดรฟ์ข้อมูลแบบอ่านอย่างเดียวได้หรือไม่

ค่าที่ส่งกลับเป็นจำนวนเต็มซึ่ง 0 ถ้าการดำเนินการจะสำเร็จหรือบางส่วนที่ไม่ใช่ศูนย์
ค่าที่บันทึกไว้ใน ntfs-3g.โพรบ(8) หน้าคู่มือ

ntfsclone-ใน
ntfsclone-in (backupfile|-) อุปกรณ์

กู้คืน "backupfile" (จากการเรียกครั้งก่อนไปที่ "ntfsclone-out") เป็น "device"
เขียนทับเนื้อหาที่มีอยู่ของอุปกรณ์นี้

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

ntfsclone ออก
อุปกรณ์ ntfsclone-out (backupfile|-) [metadataonly:true|false] [rescue:true|false] [ignorefscheck:true|false] [preservetimestamps:true|false] [บังคับ:true|false]

สตรีม "อุปกรณ์" ระบบไฟล์ NTFS ไปยังไฟล์ในเครื่อง "backupfile" รูปแบบที่ใช้สำหรับ
ไฟล์สำรองเป็นรูปแบบพิเศษที่ใช้โดย ntfsclone(8) เครื่องมือ

หากแฟล็ก "ข้อมูลเมตาเท่านั้น" ที่เป็นตัวเลือกเป็นจริง แสดงว่า เพียง ข้อมูลเมตาถูกบันทึก สูญเสียทั้งหมด
ข้อมูลผู้ใช้ (มีประโยชน์สำหรับการวินิจฉัยปัญหาระบบไฟล์บางอย่าง)

แฟล็ก "กู้ภัย", "ignorefscheck", "preservetimestamps" และ "force" ที่เป็นตัวเลือกมี
ความหมายที่แม่นยำซึ่งมีรายละเอียดใน ntfsclone(8) หน้าคน

ใช้ "ntfsclone-in" เพื่อกู้คืนไฟล์กลับไปยังอุปกรณ์ libguestfs

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ntfsfix
อุปกรณ์ ntfsfix [clearbadsectors:true|false]

คำสั่งนี้ซ่อมแซมความไม่สอดคล้องกันของ NTFS พื้นฐาน รีเซ็ตไฟล์เจอร์นัล NTFS
และกำหนดเวลาการตรวจสอบความสอดคล้องของ NTFS สำหรับการบูตครั้งแรกใน Windows

นี่คือ ไม่ เทียบเท่ากับ Windows "chkdsk" มันไม่ ไม่ สแกนระบบไฟล์สำหรับ
ความไม่สอดคล้องกัน

แฟล็ก "clearbadsectors" ที่เป็นตัวเลือกจะล้างรายการเซกเตอร์เสีย สิ่งนี้มีประโยชน์หลังจาก
การโคลนดิสก์ที่มีเซกเตอร์เสียไปยังดิสก์ใหม่

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ntfsปรับขนาด
ntfsresize-ตัวเลือก
ntfsresize อุปกรณ์ [ขนาด:N] [บังคับ:จริง|เท็จ]

คำสั่งนี้ปรับขนาดระบบไฟล์ NTFS ขยายหรือย่อขนาดให้เท่ากับ
อุปกรณ์พื้นฐาน

พารามิเตอร์ทางเลือกคือ:

"ขนาด"
ขนาดใหม่ (เป็นไบต์) ของระบบไฟล์ หากละเว้น ระบบไฟล์จะถูกปรับขนาดเป็น
พอดีกับคอนเทนเนอร์ (เช่น พาร์ทิชัน)

"บังคับ"
หากตัวเลือกนี้เป็นจริง ให้บังคับปรับขนาดของระบบไฟล์แม้ว่าระบบไฟล์
ถูกทำเครื่องหมายว่าต้องการการตรวจสอบความสม่ำเสมอ

หลังจากการปรับขนาด ระบบไฟล์จะถูกทำเครื่องหมายว่าต้องการความสอดคล้องเสมอ
ตรวจสอบ (เพื่อความปลอดภัย) คุณต้องบูตเข้าสู่ Windows เพื่อทำการตรวจสอบและล้าง
สภาพนี้. ถ้าคุณ ทำไม่ได้ ตั้งค่าตัวเลือก "บังคับ" ดังนั้นจึงไม่สามารถโทร .ได้
"ntfsresize" หลายครั้งบนระบบไฟล์เดียวโดยไม่ต้องบูตเข้าสู่ Windows
ระหว่างการปรับขนาดแต่ละครั้ง

ดูสิ่งนี้ด้วย ntfsปรับขนาด(8)

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ntfsresize-ขนาด
ntfsresize-ขนาดอุปกรณ์ขนาด

คำสั่งนี้เหมือนกับ "ntfsresize" ยกเว้นว่าอนุญาตให้คุณระบุขนาดใหม่
(เป็นไบต์) อย่างชัดเจน

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "ntfsresize" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

การแยกวิเคราะห์สภาพแวดล้อม
การแยกวิเคราะห์สภาพแวดล้อม

แยกวิเคราะห์สภาพแวดล้อมของโปรแกรมและตั้งค่าสถานะในการจัดการตามลำดับ ตัวอย่างเช่น if
"LIBGUESTFS_DEBUG=1" ดังนั้นแฟล็ก 'verbose' จะถูกตั้งค่าในแฮนเดิล

ส่วนมาก โปรแกรม do ไม่ จำเป็นต้อง ไปยัง โทรศัพท์ นี้. มันทำโดยปริยายเมื่อคุณเรียก "สร้าง"

ดู "ตัวแปรสิ่งแวดล้อม" ใน แขก(3) สำหรับรายการตัวแปรสภาพแวดล้อมที่สามารถ
ส่งผลกระทบต่อการจัดการ libguestfs ดูเพิ่มเติมที่ "guestfs_create_flags" ใน แขก(3) และ "แยกวิเคราะห์-
รายการสิ่งแวดล้อม".

แยกรายการสภาพแวดล้อม
parse-environment-list 'สภาพแวดล้อม ...'

แยกวิเคราะห์รายการสตริงในอาร์กิวเมนต์ "สภาพแวดล้อม" และตั้งค่าสถานะในหมายเลขอ้างอิง
ตามนั้น ตัวอย่างเช่น หาก "LIBGUESTFS_DEBUG=1" เป็นสตริงในรายการ ดังนั้น
แฟล็ก 'verbose' ถูกตั้งค่าไว้ที่แฮนเดิล

สิ่งนี้เหมือนกับ "parse-environment" ยกเว้นว่าจะแยกวิเคราะห์รายการสตริงที่ชัดเจน
แทนสภาพแวดล้อมของโปรแกรม

ส่วนเพิ่ม
ส่วนเพิ่มอุปกรณ์ prlogex เริ่มการสิ้นสุด endect

คำสั่งนี้จะเพิ่มพาร์ติชั่นให้กับ "อุปกรณ์" หากไม่มีตารางพาร์ติชั่นบนอุปกรณ์
เรียก "part-init" ก่อน

พารามิเตอร์ "prlogex" คือประเภทของพาร์ติชัน โดยปกติคุณควรผ่าน "p" หรือ
"หลัก" ที่นี่ แต่ตารางพาร์ติชัน MBR ยังรองรับ "l" (หรือ "ตรรกะ") และ "e" (หรือ
ประเภทพาร์ติชั่น "ขยาย")

"startsect" และ "endsect" เป็นจุดเริ่มต้นและจุดสิ้นสุดของพาร์ติชันใน ภาค. "ปลายสาย"
อาจเป็นค่าลบซึ่งหมายความว่านับถอยหลังจากจุดสิ้นสุดของดิสก์ ("-1" คือ
ภาคสุดท้าย)

การสร้างพาร์ติชั่นที่ครอบคลุมทั้งดิสก์นั้นไม่ใช่เรื่องง่าย ใช้ "part-disk" เพื่อทำ
ที่.

ส่วนเดล
part-del อุปกรณ์ partnum

คำสั่งนี้จะลบพาร์ติชั่นหมายเลข "partnum" บน "device"

โปรดทราบว่าในกรณีของการแบ่งพาร์ติชั่น MBR การลบพาร์ติชั่นเสริมจะเป็นการลบด้วย
โลจิคัลพาร์ติชันที่มีอยู่

ส่วนดิสก์
part-disk อุปกรณ์ parttype

คำสั่งนี้เป็นเพียงการรวมกันของ "part-init" ตามด้วย "part-add" เพื่อสร้าง a
พาร์ติชั่นหลักเดียวที่ครอบคลุมทั้งดิสก์

"parttype" เป็นประเภทตารางพาร์ติชั่น ปกติจะเป็น "mbr" หรือ "gpt" แต่เป็นค่าอื่นที่เป็นไปได้
อธิบายไว้ใน "part-init"

ส่วนที่บูตได้
part-get-bootable อุปกรณ์ partnum

คำสั่งนี้คืนค่า จริง หากพาร์ติชั่น "partnum" บน "อุปกรณ์" มีแฟล็กที่สามารถบู๊ตได้
ตั้ง

ดูเพิ่มเติมที่ "part-set-bootable"

ส่วนที่ได้รับ gpt-guid
part-get-gpt-guid อุปกรณ์ partnum

ส่งคืน GUID ของพาร์ติชัน GPT ที่มีหมายเลข "partnum"

part-get-gpt-type
part-get-gpt-type อุปกรณ์ partnum

ส่งคืนประเภท GUID ของพาร์ติชัน GPT ที่มีหมายเลข "partnum" สำหรับพาร์ติชัน MBR ให้ส่งคืน an
GUID ที่เหมาะสมซึ่งสอดคล้องกับประเภท MBR ไม่ได้กำหนดลักษณะการทำงานสำหรับพาร์ติชันอื่น
ประเภท

ส่วนรับ mbr-id
part-get-mbr-id อุปกรณ์ partnum

ส่งกลับไบต์ประเภท MBR (หรือที่เรียกว่าไบต์ ID) จากพาร์ทิชันที่มีหมายเลข
"พาร์ตนัม".

โปรดทราบว่าเฉพาะพาร์ติชั่น MBR (สไตล์ DOS แบบเก่า) เท่านั้นที่มีประเภทไบต์ คุณจะได้รับไม่ได้กำหนด
ผลลัพธ์สำหรับประเภทตารางพาร์ติชั่นอื่นๆ (ดู "part-get-parttype")

part-get-mbr-part-type
part-get-mbr-part-type อุปกรณ์ partnum

ส่งคืนประเภทพาร์ติชันของพาร์ติชัน MBR ที่มีหมายเลข "partnum" ใน "อุปกรณ์" ของอุปกรณ์

ส่งคืน "หลัก" "ตรรกะ" หรือ "ขยาย"

ส่วนรับชื่อ
part-get-name อุปกรณ์ partnum

สิ่งนี้ได้รับชื่อพาร์ติชั่นบนพาร์ติชั่นหมายเลข "partnum" บนอุปกรณ์ "device" บันทึก
ว่าพาร์ติชั่นมีเลขตั้งแต่ 1

ชื่อพาร์ติชั่นสามารถอ่านได้บนตารางพาร์ติชั่นบางประเภทเท่านั้น ใช้งานได้กับ
"gpt" แต่ไม่ใช่ในพาร์ติชัน "mbr"

ส่วนรับ parttype
อุปกรณ์ part-get-parttype

คำสั่งนี้ตรวจสอบตารางพาร์ติชั่นบน "อุปกรณ์" และส่งคืนตารางพาร์ติชั่น type
(รูปแบบ) ที่ใช้

ค่าส่งคืนทั่วไปรวมถึง: "msdos" (ตารางพาร์ทิชัน MBR สไตล์ DOS/Windows), "gpt" (a
ตารางพาร์ทิชันสไตล์ GPT/EFI) ค่าอื่นๆ เป็นไปได้ แม้ว่าจะผิดปกติก็ตาม ดู "ส่วน-
init" สำหรับรายการทั้งหมด

ส่วนเริ่มต้น
part-init อุปกรณ์ parttype

สิ่งนี้จะสร้างตารางพาร์ติชั่นว่างบน "อุปกรณ์" ของหนึ่งในประเภทพาร์ติชั่นที่ระบุไว้
ด้านล่าง. โดยปกติ "parttype" ควรเป็น "msdos" หรือ "gpt" (สำหรับดิสก์ขนาดใหญ่)

เริ่มแรกไม่มีพาร์ติชั่น ต่อไปนี้คุณควรเรียก "part-add" สำหรับแต่ละ
พาร์ทิชันที่จำเป็น

ค่าที่เป็นไปได้สำหรับ "parttype" คือ:

efi
GPT ตารางพาร์ทิชัน Intel EFI / GPT

ขอแนะนำสำหรับ >= 2 TB พาร์ติชันที่จะเข้าถึงได้จาก Linux และ Intel-
ตาม Mac OS X นอกจากนี้ยังมีความเข้ากันได้แบบย้อนหลังอย่างจำกัดกับรูปแบบ "mbr"

MBR
MSDOS
รูปแบบ PC "Master Boot Record" (MBR) มาตรฐานที่ใช้โดย MS-DOS และ Windows นี้
ประเภทพาร์ทิชันจะ เพียง ใช้งานได้กับอุปกรณ์ขนาดไม่เกิน 2 TB สำหรับดิสก์ขนาดใหญ่เรา
แนะนำให้ใช้ "gpt"

ประเภทตารางพาร์ติชั่นอื่นๆ ที่อาจใช้งานได้แต่ไม่ได้รับการสนับสนุน ได้แก่:

Aix เลเบลดิสก์ AIX

เอมิกา
rdb รูปแบบ "Rigid Disk Block" ของ Amiga

บีดีเอส ฉลากดิสก์ BSD

DASD
DASD ใช้กับเมนเฟรมของ IBM

ดว ปริมาณ MIPS/SGI

Mac รูปแบบพาร์ติชัน Mac เก่า Mac สมัยใหม่ใช้ "gpt"

pc98
รูปแบบ NEC PC-98 ซึ่งพบได้ทั่วไปในญี่ปุ่น

ดวงอาทิตย์ ฉลากดิสก์ซัน

รายการบางส่วน
รายการอุปกรณ์

คำสั่งนี้แยกวิเคราะห์ตารางพาร์ติชั่นบน "อุปกรณ์" และส่งคืนรายการพาร์ติชั่น
พบว่า

ฟิลด์ในโครงสร้างที่ส่งคืนคือ:

หมายเลขชิ้นส่วน
หมายเลขพาร์ติชั่น นับจาก 1

ส่วน_เริ่มต้น
จุดเริ่มต้นของพาร์ทิชัน in ไบต์. ในการรับเซกเตอร์คุณต้องหารด้วยอุปกรณ์
ขนาดเซกเตอร์ ดู "blockdev-getss"

part_end
สิ้นสุดพาร์ติชันในหน่วยไบต์

ส่วน_ขนาด
ขนาดของพาร์ติชันเป็นไบต์

ส่วนชุดบูต
part-set-bootable อุปกรณ์ partnum true|false

สิ่งนี้ตั้งค่าสถานะที่สามารถบู๊ตได้บนพาร์ติชั่นหมายเลข "partnum" บนอุปกรณ์ "device" สังเกตว่า
พาร์ติชั่นมีหมายเลขตั้งแต่ 1

ระบบปฏิบัติการบางระบบใช้แฟล็กที่สามารถบู๊ตได้ (โดยเฉพาะ Windows) เพื่อกำหนดว่า
พาร์ติชันที่จะบูตจาก ไม่เป็นที่ยอมรับในระดับสากล

ส่วนชุด gpt-guid
part-set-gpt-guid อุปกรณ์ partnum guid

ตั้งค่า GUID ของพาร์ติชัน GPT ที่มีหมายเลข "partnum" เป็น "guid" ส่งกลับข้อผิดพลาดถ้า
ตารางพาร์ทิชันของ "อุปกรณ์" ไม่ใช่ GPT หรือหาก "guid" ไม่ใช่ GUID ที่ถูกต้อง

ส่วนชุด-gpt-type
part-set-gpt-type อุปกรณ์ partnum guid

ตั้งค่าประเภท GUID ของพาร์ติชัน GPT ที่มีหมายเลข "partnum" เป็น "guid" ส่งกลับข้อผิดพลาดถ้า
ตารางพาร์ทิชันของ "อุปกรณ์" ไม่ใช่ GPT หรือหาก "guid" ไม่ใช่ GUID ที่ถูกต้อง

ดู http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs เพื่อประโยชน์
รายการประเภท GUID

ส่วนชุด mbr-id
part-set-mbr-id อุปกรณ์ partnum idbyte

ตั้งค่าไบต์ประเภท MBR (เรียกอีกอย่างว่าไบต์ ID) ของพาร์ติชั่นที่มีหมายเลข "partnum" เป็น
"ไอดีไบต์" โปรดทราบว่าประเภทไบต์ที่ยกมาในเอกสารประกอบส่วนใหญ่เป็นเลขฐานสิบหก
ตัวเลข แต่โดยปกติแล้วจะไม่มี "0x" นำหน้าซึ่งอาจสร้างความสับสน

โปรดทราบว่าเฉพาะพาร์ติชั่น MBR (สไตล์ DOS แบบเก่า) เท่านั้นที่มีประเภทไบต์ คุณจะได้รับไม่ได้กำหนด
ผลลัพธ์สำหรับประเภทตารางพาร์ติชั่นอื่นๆ (ดู "part-get-parttype")

ส่วนชุดชื่อ
ชื่อชุดอุปกรณ์ ชื่อชิ้นส่วนอุปกรณ์

ซึ่งจะตั้งชื่อพาร์ติชั่นบนพาร์ติชั่นหมายเลข "partnum" บนอุปกรณ์ "device" บันทึก
ว่าพาร์ติชั่นมีเลขตั้งแต่ 1

ชื่อพาร์ติชั่นสามารถกำหนดได้เฉพาะในตารางพาร์ติชั่นบางประเภทเท่านั้น ใช้งานได้กับ
"gpt" แต่ไม่ใช่ในพาร์ติชัน "mbr"

ส่วนต่อการพัฒนา
พาร์ติชั่น part-to-dev

ฟังก์ชันนี้ใช้ชื่อพาร์ติชั่น (เช่น "/dev/sdb1") และลบหมายเลขพาร์ติชั่น
ส่งคืนชื่ออุปกรณ์ (เช่น "/dev/sdb")

พาร์ติชั่นที่มีชื่อต้องมีอยู่ เช่น เป็นสตริงที่ส่งคืนจาก "list-partitions"

ดูเพิ่มเติมที่ "ส่วนต่อส่วน", "ดัชนีอุปกรณ์"

part-to-partnum
พาร์ทิชั่นแบบ part-to-partnum

ฟังก์ชันนี้ใช้ชื่อพาร์ติชัน (เช่น "/dev/sdb1") และส่งคืนหมายเลขพาร์ติชัน
(เช่น 1).

พาร์ติชั่นที่มีชื่อต้องมีอยู่ เช่น เป็นสตริงที่ส่งคืนจาก "list-partitions"

ดูเพิ่มเติมที่ "part-to-dev"

ปิงภูต
ปิงภูต

นี่คือโพรบทดสอบใน guestfs daemon ที่ทำงานอยู่ในอุปกรณ์ libguestfs
การเรียกใช้ฟังก์ชันนี้จะตรวจสอบว่า daemon ตอบสนองต่อข้อความ ping หรือไม่ โดยไม่ใช้
ส่งผลกระทบต่อ daemon หรืออุปกรณ์บล็อกที่แนบมาในลักษณะอื่นใด

เพรด
ออฟเซ็ตการนับเส้นทางล่วงหน้า

คำสั่งนี้ให้คุณอ่านบางส่วนของไฟล์ มันอ่าน "นับ" ไบต์ของไฟล์โดยเริ่ม
ที่ "offset" จากไฟล์ "path"

ซึ่งอาจอ่านไบต์น้อยกว่าที่ร้องขอ ดูรายละเอียดเพิ่มเติมได้ที่ เพรด(2) ระบบ
โทร.

ดูเพิ่มเติมที่ "pwrite", "pre-device"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

อุปกรณ์ล่วงหน้า
ออฟเซ็ตการนับอุปกรณ์ล่วงหน้า

คำสั่งนี้ให้คุณอ่านส่วนหนึ่งของอุปกรณ์บล็อก มันอ่าน "นับ" ไบต์ของ "อุปกรณ์"
เริ่มต้นที่ "ออฟเซ็ต"

ซึ่งอาจอ่านไบต์น้อยกว่าที่ร้องขอ ดูรายละเอียดเพิ่มเติมได้ที่ เพรด(2) ระบบ
โทร.

ดูเพิ่มเติมที่ "เตรียม"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

pvchange-uuid
อุปกรณ์ pvchange-uuid

สร้าง UUID แบบสุ่มใหม่สำหรับ "อุปกรณ์" ฟิสิคัลวอลุ่ม

pvchange-uuid-ทั้งหมด
pvchange-uuid-ทั้งหมด

สร้าง UUID แบบสุ่มใหม่สำหรับฟิสิคัลวอลุ่มทั้งหมด

พีวีซีสร้าง
พีวีซีสร้างอุปกรณ์

สิ่งนี้จะสร้างฟิสิคัลวอลุ่ม LVM บนชื่อ "อุปกรณ์" โดยที่ "อุปกรณ์" ปกติควร
เป็นชื่อพาร์ติชันเช่น / dev / sda1.

pvremov
อุปกรณ์ pvremov

สิ่งนี้จะล้าง "อุปกรณ์" ฟิสิคัลวอลุ่มเพื่อให้ LVM ไม่รู้จักอีกต่อไป

การใช้งานใช้คำสั่ง "pvremove" ซึ่งปฏิเสธที่จะล้างฟิสิคัลวอลุ่มที่
มีกลุ่มวอลุ่มใด ๆ ดังนั้นคุณต้องลบออกก่อน

ขนาด
อุปกรณ์pvresize

สิ่งนี้จะปรับขนาด (ขยายหรือย่อ) ฟิสิคัลวอลุ่ม LVM ที่มีอยู่เพื่อให้ตรงกับขนาดใหม่ของ
อุปกรณ์พื้นฐาน

pvresize-ขนาด
ขนาดอุปกรณ์ขนาด pvresize

คำสั่งนี้เหมือนกับ "pvresize" ยกเว้นว่าอนุญาตให้คุณระบุขนาดใหม่
(เป็นไบต์) อย่างชัดเจน

พีวีเอส
พีวีเอส

แสดงรายการฟิสิคัลวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ พีวีเอส(8) คำสั่ง

ส่งคืนรายการเฉพาะชื่ออุปกรณ์ที่มี PV (เช่น / dev / sda2).

ดูเพิ่มเติมที่ "pvs-เต็ม"

pvs-เต็ม
pvs-เต็ม

แสดงรายการฟิสิคัลวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ พีวีเอส(8) คำสั่ง
เวอร์ชัน "เต็ม" มีทุกช่อง

pvuid
เครื่อง pvuuid

คำสั่งนี้ส่งคืน UUID ของ "อุปกรณ์" ของ LVM PV

เขียน
ออฟเซ็ตเนื้อหาเส้นทาง pwrite

คำสั่งนี้เขียนไปยังส่วนหนึ่งของไฟล์ มันเขียนบัฟเฟอร์ข้อมูล "เนื้อหา" ไปยังไฟล์
"เส้นทาง" เริ่มต้นที่ออฟเซ็ต "ออฟเซ็ต"

คำสั่งนี้ใช้ เขียน(2) การเรียกระบบและเช่นเดียวกับการเรียกระบบนั้นอาจไม่
เขียนข้อมูลทั้งหมดที่ร้องขอ ค่าที่ส่งคืนคือจำนวนไบต์ที่เป็นจริง
เขียนลงในไฟล์. นี่อาจเป็น 0 แม้ว่าการเขียนสั้น ๆ จะไม่เกิดขึ้นเป็นประจำ
ไฟล์ในสถานการณ์ปกติ

ดูเพิ่มเติมที่ "pread", "pwrite-device"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

pwrite-อุปกรณ์
ออฟเซ็ตเนื้อหาอุปกรณ์ pwrite

คำสั่งนี้เขียนไปยังส่วนหนึ่งของอุปกรณ์ มันเขียนบัฟเฟอร์ข้อมูล "เนื้อหา" ไปยัง "อุปกรณ์"
เริ่มต้นที่ออฟเซ็ต "ออฟเซ็ต"

คำสั่งนี้ใช้ เขียน(2) การเรียกระบบและเช่นเดียวกับการเรียกระบบนั้นอาจไม่
เขียนข้อมูลทั้งหมดที่ร้องขอ (แม้ว่าการเขียนแบบสั้นไปยังอุปกรณ์ดิสก์และพาร์ติชั่นจะเป็น
อาจเป็นไปไม่ได้กับเคอร์เนล Linux มาตรฐาน)

ดูเพิ่มเติมที่ "pwrite"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

อ่านไฟล์
อ่านไฟล์เส้นทาง

การเรียกนี้ส่งคืนเนื้อหาของไฟล์ "เส้นทาง" เป็นบัฟเฟอร์

ฟังก์ชันนี้แตกต่างจาก "cat" ตรงที่สามารถจัดการไฟล์ที่มี ASCII NUL . ที่ฝังอยู่
อักขระ

อ่านบรรทัด
เส้นทางการอ่านบรรทัด

ส่งคืนเนื้อหาของไฟล์ชื่อ "เส้นทาง"

เนื้อหาไฟล์จะถูกส่งกลับเป็นรายการบรรทัด ต่อท้าย "LF" และ "CRLF" ตัวอักษร
ลำดับคือ ไม่ กลับ

โปรดทราบว่าฟังก์ชันนี้ไม่สามารถจัดการไฟล์ไบนารีได้อย่างถูกต้อง (โดยเฉพาะไฟล์
มีอักขระ "\0" ซึ่งถือเป็นจุดสิ้นสุดของสตริง) สำหรับคนที่ต้องใช้
ฟังก์ชัน "read-file" และแบ่งบัฟเฟอร์เป็นบรรทัดเอง

อ่าน
ผู้อ่าน

ส่งคืนรายการของรายการไดเร็กทอรีในไดเร็กทอรี "dir"

รายการทั้งหมดในไดเร็กทอรีจะถูกส่งกลับ รวมทั้ง "." และ "..". รายการคือ ไม่
เรียงลำดับแล้ว แต่ส่งคืนในลำดับเดียวกันกับระบบไฟล์พื้นฐาน

นอกจากนี้ การเรียกนี้จะส่งคืนข้อมูลประเภทไฟล์พื้นฐานเกี่ยวกับแต่ละไฟล์ ฟิลด์ "ftyp" จะ
มีหนึ่งในอักขระต่อไปนี้:

'b' บล็อคพิเศษ

'c' Char พิเศษ

'd' ไดเรกทอรี

'f' FIFO (ชื่อไปป์)

'l' ลิงก์สัญลักษณ์

'r' ไฟล์ปกติ

ของ' ซ็อกเก็ต

'u' ไม่รู้จักประเภทไฟล์

'?' ดิ อ่าน(3) การเรียกส่งคืนฟิลด์ "d_type" ด้วยค่าที่ไม่คาดคิด

ฟังก์ชันนี้มีจุดประสงค์เพื่อการใช้งานโดยโปรแกรมเป็นหลัก เพื่อให้ได้รายชื่ออย่างง่าย
ใช้ "ลส" เพื่อให้ได้ไดเร็กทอรีที่พิมพ์ได้สำหรับการบริโภคของมนุษย์ ให้ใช้ "ll"

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

อ่านลิงค์
เส้นทางลิงก์อ่าน

คำสั่งนี้อ่านเป้าหมายของลิงก์สัญลักษณ์

รายการลิงก์อ่าน
readlinklist เส้นทาง 'ชื่อ ...'

การโทรนี้อนุญาตให้คุณดำเนินการ "readlink" ในหลายไฟล์ โดยที่ไฟล์ทั้งหมดอยู่
ในไดเรกทอรี "เส้นทาง" "names" คือรายการไฟล์จากไดเร็กทอรีนี้

คุณจะได้รับรายการสตริงที่มีการโต้ตอบแบบหนึ่งต่อหนึ่งไปยังรายการ "ชื่อ"
แต่ละสตริงคือค่าของลิงก์สัญลักษณ์

ถ้า อ่านลิงค์(2) การดำเนินการล้มเหลวในชื่อใด ๆ จากนั้นสตริงผลลัพธ์ที่สอดคล้องกันคือ
สตริงว่าง "" อย่างไรก็ตามการดำเนินการทั้งหมดจะเสร็จสมบูรณ์แม้ว่าจะมี
อ่านลิงค์(2) ข้อผิดพลาด เพื่อให้คุณสามารถเรียกใช้ฟังก์ชันนี้ด้วยชื่อที่คุณไม่รู้ว่า
เป็นลิงก์สัญลักษณ์อยู่แล้ว (แม้ว่าจะมีประสิทธิภาพน้อยกว่าเล็กน้อย)

การเรียกนี้มีไว้สำหรับโปรแกรมที่ต้องการแสดงรายการเนื้อหาไดเร็กทอรีอย่างมีประสิทธิภาพ
โดยไม่ต้องไป-กลับหลายเที่ยว

เส้นทางจริง
เส้นทางจริง

ส่งคืนชื่อพา ธ สัมบูรณ์ที่เป็นที่ยอมรับของ "เส้นทาง" เส้นทางที่ส่งคืนไม่มี ".", ".."
หรือองค์ประกอบเส้นทางลิงก์สัญลักษณ์

รีเม้าท์
ติดตั้งจุดเชื่อมต่อใหม่ [rw:true|false]

การโทรนี้อนุญาตให้คุณเปลี่ยนแฟล็ก "rw" (อ่านอย่างเดียว/อ่าน-เขียน) บนการติดตั้งแล้ว
ระบบไฟล์ที่ "จุดเชื่อมต่อ" การแปลงระบบไฟล์แบบอ่านอย่างเดียวให้เป็นแบบอ่าน-เขียน หรือรอง-
ในทางกลับกัน

โปรดทราบว่าในขณะนี้ คุณต้องระบุพารามิเตอร์ "ตัวเลือก" "rw" ในอนาคตเราอาจ
อนุญาตให้ปรับธงอื่นๆ

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ถอดไดรฟ์
ป้ายถอดไดรฟ์

ฟังก์ชันนี้ตรงกันข้ามกับ "add-drive-opts" ตามแนวคิด มันลบไดรฟ์ที่
ก่อนหน้านี้ถูกเพิ่มด้วยป้ายกำกับ "label"

โปรดทราบว่าในการถอดไดรฟ์ คุณต้องเพิ่มไดรฟ์เหล่านั้นด้วยป้ายกำกับ (ดูตัวเลือก
อาร์กิวเมนต์ "label" เป็น "add-drive-opts") หากคุณไม่ได้ใช้ป้ายกำกับก็ไม่สามารถ
ลบออก

คุณสามารถเรียกใช้ฟังก์ชันนี้ก่อนหรือหลังเปิดใช้แฮนเดิล หากเรียกหลังจากเปิดตัว
หากแบ็กเอนด์รองรับ เราพยายามถอดปลั๊กไดรฟ์ออก: ดู "HOTPLUGGING" ใน
แขก(3). ดิสก์ ต้อง ไม่ ใช้งานอยู่ (เช่น ติดตั้ง) เมื่อคุณทำเช่นนี้ เราพยายามที่จะตรวจจับ
หากมีการใช้งานดิสก์และหยุดไม่ให้คุณทำเช่นนี้

ลบxattr
เส้นทาง removexattr xattr

การเรียกนี้จะลบแอตทริบิวต์ขยายชื่อ "xattr" ของไฟล์ "เส้นทาง"

ดูเพิ่มเติม: "lremovexattr", Attribution-NonCommercial-ShareAlike(5)

ตั้งชื่อใหม่
เปลี่ยนชื่อเส้นทางเก่า newpath

เปลี่ยนชื่อไฟล์เป็นตำแหน่งใหม่บนระบบไฟล์เดียวกัน นี้เหมือนกับ Linux
ตั้งชื่อใหม่(2) การเรียกระบบ ในกรณีส่วนใหญ่ คุณควรใช้ "mv" แทน

ปรับขนาด2fs
อุปกรณ์ปรับขนาด2fs

สิ่งนี้จะปรับขนาดระบบไฟล์ ext2, ext3 หรือ ext4 เพื่อให้ตรงกับขนาดของอุปกรณ์พื้นฐาน

ดูเพิ่มเติมที่ "ข้อผิดพลาด RESIZE2FS" ใน แขก(3)

ปรับขนาด2fs-M
อุปกรณ์ปรับขนาด2fs-M

คำสั่งนี้เหมือนกับ "resize2fs" แต่ระบบไฟล์ถูกปรับขนาดให้เหลือน้อยที่สุด
ขนาด. ทำงานเหมือน -M ตัวเลือกสำหรับคำสั่ง "resize2fs"

เพื่อให้ได้ขนาดผลลัพธ์ของระบบไฟล์ คุณควรเรียก "tune2fs-l" และอ่านค่า
ค่า "ขนาดบล็อก" และ "จำนวนบล็อก" สองตัวนี้คูณกันจะได้
ขนาดผลลัพธ์ของระบบไฟล์ที่น้อยที่สุดในหน่วยไบต์

ดูเพิ่มเติมที่ "ข้อผิดพลาด RESIZE2FS" ใน แขก(3)

ปรับขนาด2fs-size
resize2fs-ขนาดขนาดอุปกรณ์

คำสั่งนี้เหมือนกับ "resize2fs" ยกเว้นว่าอนุญาตให้คุณระบุขนาดใหม่
(เป็นไบต์) อย่างชัดเจน

ดูเพิ่มเติมที่ "ข้อผิดพลาด RESIZE2FS" ใน แขก(3)

rm
เส้นทาง rm

ลบ "เส้นทาง" ไฟล์เดียว

RM-F
rm-f เส้นทาง

ลบไฟล์ "เส้นทาง"

หากไม่มีไฟล์ ข้อผิดพลาดนั้นจะถูกละเว้น (ข้อผิดพลาดอื่นๆ เช่น ข้อผิดพลาด I/O หรือข้อผิดพลาด
เส้นทางจะไม่ละเว้น)

การโทรนี้ไม่สามารถลบไดเร็กทอรี ใช้ "rmdir" เพื่อลบไดเร็กทอรีว่าง หรือ "rm-rf"
เพื่อลบไดเร็กทอรีแบบเรียกซ้ำ

rm-rf
เส้นทาง rm-rf

ลบไฟล์หรือไดเรกทอรี "เส้นทาง" ลบเนื้อหาซ้ำหากเป็นไดเรกทอรี
นี่เหมือนกับคำสั่งเชลล์ "rm -rf"

คือ rm
เส้นทาง rmdir

ลบ "เส้นทาง" ไดเรกทอรีเดียว

rmmountpoint
เส้นทางการยกเว้น rmmountpoint

การเรียกนี้จะลบจุดเชื่อมต่อที่สร้างไว้ก่อนหน้านี้ด้วย "mkmountpoint" ดู
"mkmountpoint" สำหรับรายละเอียดทั้งหมด

rsync
rsync src dest [เก็บถาวร:จริง|เท็จ] [ลบออก:จริง|เท็จ]

การโทรนี้อาจใช้เพื่อคัดลอกหรือซิงโครไนซ์สองไดเร็กทอรีภายใต้ libguestfs . เดียวกัน
ด้ามจับ. สิ่งนี้ใช้ rsync(1) โปรแกรมที่ใช้อัลกอริธึมที่รวดเร็วเพื่อหลีกเลี่ยงการคัดลอก
ไฟล์โดยไม่จำเป็น

"src" และ "dest" เป็นไดเร็กทอรีต้นทางและปลายทาง ไฟล์ถูกคัดลอกจาก "src"
สู่ "ปลายทาง"

อาร์กิวเมนต์ที่เป็นทางเลือกคือ:

"คลังเก็บเอกสารสำคัญ"
เปิดโหมดเก็บถาวร นี่ก็เหมือนกับการผ่าน --คลังเก็บเอกสารสำคัญ ตั้งค่าสถานะเป็น "rsync"

"ลบออก"
ลบไฟล์ที่ปลายทางที่ไม่มีอยู่ที่ต้นทาง

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

rsync ใน
rsync-in ปลายทางระยะไกล [archive:true|false] [deletedest:true|false]

การโทรนี้อาจใช้เพื่อคัดลอกหรือซิงโครไนซ์ระบบไฟล์บนโฮสต์หรือบนรีโมท
คอมพิวเตอร์ที่มีระบบไฟล์ภายใน libguestfs สิ่งนี้ใช้ rsync(1) โปรแกรมที่ใช้
อัลกอริธึมที่รวดเร็วเพื่อหลีกเลี่ยงการคัดลอกไฟล์โดยไม่จำเป็น

การโทรนี้ใช้ได้เฉพาะเมื่อเปิดใช้งานเครือข่าย ดู "set-network" หรือ --เครือข่าย ตัวเลือก
ไปจนถึงเครื่องมือต่างๆ เช่น ปลาแขก(1)

ไฟล์ถูกคัดลอกจากเซิร์ฟเวอร์ระยะไกลและไดเร็กทอรีที่ระบุโดย "remote" ไปยัง
ไดเรกทอรีปลายทาง "dest"

รูปแบบของสตริงเซิร์ฟเวอร์ระยะไกลถูกกำหนดโดย rsync(1). สังเกตว่าไม่มีทาง
เพื่อระบุรหัสผ่านหรือข้อความรหัสผ่าน ดังนั้นต้องตั้งเป้าหมายไม่ให้มี

อาร์กิวเมนต์ที่เป็นทางเลือกจะเหมือนกับอาร์กิวเมนต์ของ "rsync"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

rsync ออก
rsync-out src remote [เก็บถาวร:จริง|เท็จ] [ลบออก:จริง|เท็จ]

การโทรนี้อาจใช้เพื่อคัดลอกหรือซิงโครไนซ์ระบบไฟล์ภายใน libguestfs ด้วยa
ระบบไฟล์บนโฮสต์หรือบนคอมพิวเตอร์ระยะไกล สิ่งนี้ใช้ rsync(1) โปรแกรมที่ใช้
อัลกอริธึมที่รวดเร็วเพื่อหลีกเลี่ยงการคัดลอกไฟล์โดยไม่จำเป็น

การโทรนี้ใช้ได้เฉพาะเมื่อเปิดใช้งานเครือข่าย ดู "set-network" หรือ --เครือข่าย ตัวเลือก
ไปจนถึงเครื่องมือต่างๆ เช่น ปลาแขก(1)

ไฟล์ถูกคัดลอกจากไดเร็กทอรีต้นทาง "src" ไปยังเซิร์ฟเวอร์ระยะไกลและไดเร็กทอรี
กำหนดโดย "ระยะไกล"

รูปแบบของสตริงเซิร์ฟเวอร์ระยะไกลถูกกำหนดโดย rsync(1). สังเกตว่าไม่มีทาง
เพื่อระบุรหัสผ่านหรือข้อความรหัสผ่าน ดังนั้นต้องตั้งเป้าหมายไม่ให้มี

อาร์กิวเมนต์ที่เป็นทางเลือกจะเหมือนกับอาร์กิวเมนต์ของ "rsync"

Globbing ไม่เกิดขึ้นในพารามิเตอร์ "src" ในโปรแกรมที่ใช้ API โดยตรง
คุณต้องขยายไวด์การ์ดด้วยตัวเอง (ดู "glob-expand") ใน guestfish คุณสามารถใช้
คำสั่ง "glob" (ดู "glob") เช่น

> glob rsync-out /* rsync://remote/

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เครื่องขัด
อุปกรณ์ขัดถู

คำสั่งนี้เขียนรูปแบบบน "อุปกรณ์" เพื่อทำให้การดึงข้อมูลทำได้ยากขึ้น

มันเป็นส่วนต่อประสานกับ ขัด(1) โปรแกรม ดูหน้าคู่มือสำหรับรายละเอียดเพิ่มเติม

ไฟล์ขัด
ไฟล์สครับไฟล์

คำสั่งนี้เขียนรูปแบบบนไฟล์เพื่อทำให้การดึงข้อมูลทำได้ยากขึ้น

ไฟล์คือ ลบออก หลังจากขัด.

มันเป็นส่วนต่อประสานกับ ขัด(1) โปรแกรม ดูหน้าคู่มือสำหรับรายละเอียดเพิ่มเติม

สครับ-freespace
สครับ-freespace dir

คำสั่งนี้สร้างไดเร็กทอรี "dir" แล้วเติมด้วยไฟล์จนถึง filesystem
เต็มและขัดไฟล์เป็น "scrub-file" แล้วลบออก ความตั้งใจคือเพื่อ
ขัดพื้นที่ว่างบนพาร์ติชันที่มี "dir"

มันเป็นส่วนต่อประสานกับ ขัด(1) โปรแกรม ดูหน้าคู่มือสำหรับรายละเอียดเพิ่มเติม

ชุดต่อท้าย
ผนวก
set-append ต่อท้าย

ฟังก์ชันนี้ใช้เพื่อเพิ่มตัวเลือกเพิ่มเติมให้กับคำสั่งเคอร์เนลของอุปกรณ์ libguestfs
เส้น

ค่าเริ่มต้นคือ "NULL" เว้นแต่จะถูกแทนที่ด้วยการตั้งค่าสภาพแวดล้อม "LIBGUESTFS_APPEND"
ตัวแปร

การตั้งค่า "ผนวก" เป็น "NULL" หมายถึง ไม่ ตัวเลือกเพิ่มเติมจะถูกส่งผ่าน (libguestfs จะเพิ่ม .เสมอ
ของตัวเองบางส่วน)

ชุดแนบวิธี
แนบวิธี
set-attach-method แบ็กเอนด์

ตั้งค่าวิธีการที่ libguestfs ใช้เพื่อเชื่อมต่อกับแบ็กเอนด์ guestfsd daemon

ดู "แบ็กเอนด์" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "set-backend" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ตั้ง-autosync
ซิงค์อัตโนมัติ
set-autosync จริง|เท็จ

หาก "autosync" เป็นจริง จะเป็นการเปิดใช้งาน autosync Libguestfs จะพยายามอย่างเต็มที่
เพื่อให้ระบบไฟล์สอดคล้องและซิงโครไนซ์เมื่อปิดหมายเลขอ้างอิง (เช่นถ้า
โปรแกรมออกโดยไม่มีที่จับปิด)

สิ่งนี้ถูกเปิดใช้งานโดยค่าเริ่มต้น (ตั้งแต่ libguestfs 1.5.24 ก่อนหน้านี้มันถูกปิดการใช้งานโดย
ค่าเริ่มต้น).

ชุดแบ็กเอนด์
แบ็กเอนด์
ชุดแบ็กเอนด์แบ็กเอนด์

ตั้งค่าวิธีการที่ libguestfs ใช้เพื่อเชื่อมต่อกับแบ็กเอนด์ guestfsd daemon

คุณสมบัติจัดการนี้ก่อนหน้านี้เรียกว่า "วิธีแนบ"

ดู "แบ็กเอนด์" ใน แขก(3)

ตั้งค่าแบ็คเอนด์
set-backend-การตั้งค่าชื่อ val

ต่อท้าย "name=value" ในรายการสตริงการตั้งค่าแบ็กเอนด์ แต่ถ้าเป็นสตริงแล้ว
มี "ชื่อ" ที่ตรงกันหรือขึ้นต้นด้วย "name=" จากนั้นการตั้งค่านั้นจะถูกแทนที่

ดู "แบ็กเอนด์" ใน แขก(3), "การตั้งค่าแบ็กเอนด์" ใน แขก(3)

การตั้งค่าแบ็คเอนด์
set-backend-settings 'การตั้งค่า ...'

ตั้งค่ารายการการตั้งค่าตั้งแต่ศูนย์ขึ้นไปซึ่งส่งผ่านไปยังแบ็กเอนด์ปัจจุบัน แต่ละ
การตั้งค่าเป็นสตริงที่ตีความในวิธีเฉพาะแบ็กเอนด์ หรือละเว้นหากไม่
เข้าใจโดยแบ็กเอนด์

ค่าดีฟอลต์คือรายการว่าง ยกเว้นกรณีที่ตัวแปรสภาพแวดล้อม
"LIBGUESTFS_BACKEND_SETTINGS" ถูกตั้งค่าเมื่อมีการสร้างแฮนเดิล สภาพแวดล้อมนี้
ตัวแปรมีรายการการตั้งค่าที่คั่นด้วยเครื่องหมายทวิภาค

การโทรนี้จะแทนที่การตั้งค่าแบ็กเอนด์ทั้งหมด หากคุณต้องการเปลี่ยนการตั้งค่าแบ็กเอนด์เดียว
ดู "การตั้งค่าแบ็คเอนด์การตั้งค่า" หากคุณต้องการล้างการตั้งค่าแบ็กเอนด์เดียว โปรดดู "ล้าง-
การตั้งค่าแบ็กเอนด์".

ดู "แบ็กเอนด์" ใน แขก(3), "การตั้งค่าแบ็กเอนด์" ใน แขก(3)

ชุดแคช
แคชเดียร์
set-cachedir แคชเดียร์

ตั้งค่าไดเร็กทอรีที่ใช้โดยแฮนเดิลเพื่อเก็บแคชของอุปกรณ์ เมื่อใช้ supermin
เครื่องใช้ อุปกรณ์ถูกแคชและแชร์ระหว่างแฮนเดิลทั้งหมดที่มี
ID ผู้ใช้ที่มีประสิทธิภาพ

ตัวแปรสภาพแวดล้อม "LIBGUESTFS_CACHEDIR" และ "TMPDIR" ควบคุมค่าเริ่มต้น: ถ้า
"LIBGUESTFS_CACHEDIR" ได้รับการตั้งค่าแล้ว นั่นคือค่าเริ่มต้น มิฉะนั้นหากตั้งค่า "TMPDIR" แล้ว
นั่นคือค่าเริ่มต้น อื่น / var / tmp เป็นค่าเริ่มต้น

ตั้งตรง
โดยตรง
ตั้งค่าโดยตรง จริง|เท็จ

หากเปิดใช้งานแฟล็กโหมดอุปกรณ์โดยตรง stdin และ stdout จะถูกส่งต่อโดยตรง
ผ่านไปยังเครื่องทันทีที่เปิดตัว

ผลที่ตามมาประการหนึ่งคือข้อความบันทึกไม่ได้รับการจับโดยไลบรารีและจัดการโดย
"set-log-message-callback" แต่ตรงไปที่ stdout

คุณอาจไม่ต้องการใช้สิ่งนี้เว้นแต่คุณจะรู้ว่ากำลังทำอะไรอยู่

ค่าเริ่มต้นถูกปิดใช้งาน

ชุด-e2attrs
ไฟล์ set-e2attrs attrs [ล้าง: จริง | เท็จ]

ตั้งค่าหรือล้างแอตทริบิวต์ไฟล์ "attrs" ที่เกี่ยวข้องกับ inode ไฟล์.

"attrs" คือสตริงของอักขระที่แสดงแอตทริบิวต์ของไฟล์ ดู "get-e2attrs" สำหรับ
รายการแอตทริบิวต์ที่เป็นไปได้ คุณลักษณะบางอย่างไม่สามารถเปลี่ยนแปลงได้

หากตัวเลือกบูลีน "ชัดเจน" ไม่มีอยู่หรือเป็นเท็จ แสดงว่า "attrs" ที่แสดงอยู่ใน
ไอโหนด

หาก "ชัดเจน" เป็นจริง แสดงว่า "attrs" ที่แสดงในรายการจะถูกล้างในไอโหนด

ในทั้งสองกรณี คุณลักษณะอื่นที่ไม่มีอยู่ในสตริง "attrs" จะไม่เปลี่ยนแปลง

แอตทริบิวต์เหล่านี้จะปรากฏเมื่อไฟล์อยู่บนระบบไฟล์ ext2/3/4 เท่านั้น
การใช้การเรียกนี้กับระบบไฟล์ประเภทอื่นจะทำให้เกิดข้อผิดพลาด

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

ชุด-e2generation
การสร้างไฟล์ set-e2generation

ตั้งค่าการสร้างไฟล์ ext2 ของไฟล์

ดู "get-e2generation"

ชุด-e2label
ฉลากอุปกรณ์ set-e2label

ซึ่งจะตั้งค่าป้ายกำกับระบบไฟล์ ext2/3/4 ของระบบไฟล์ใน "อุปกรณ์" เป็น "ป้ายกำกับ"
ป้ายกำกับระบบไฟล์มีอักขระได้ไม่เกิน 16 ตัว

คุณสามารถใช้ "tune2fs-l" หรือ "get-e2label" เพื่อส่งคืนป้ายกำกับที่มีอยู่บน
ระบบไฟล์

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "set-label" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ชุด-e2uid
set-e2uuid อุปกรณ์ uuid

สิ่งนี้จะตั้งค่า UUID ระบบไฟล์ ext2/3/4 ของระบบไฟล์บน "อุปกรณ์" เป็น "uuid" ดิ
รูปแบบของ UUID และทางเลือกอื่นเช่น "ชัดเจน" "สุ่ม" และ "เวลา" อธิบายไว้ใน
Tune2fs(8) หน้าจัดการ

คุณสามารถใช้ "vfs-uuid" เพื่อส่งคืน UUID ที่มีอยู่ของระบบไฟล์

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "set-uuid" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ชุด-hv
hv
ชุด-hv hv

ตั้งค่าไบนารีไฮเปอร์ไวเซอร์ที่เราจะใช้ ไฮเปอร์ไวเซอร์ขึ้นอยู่กับแบ็กเอนด์ แต่คือ
โดยปกติแล้วจะเป็นตำแหน่งของไฮเปอร์ไวเซอร์ qemu/KVM สำหรับแบ็กเอนด์ uml มันคือตำแหน่ง
ของไบนารี "linux" หรือ "vmlinux"

ค่าเริ่มต้นจะถูกเลือกเมื่อไลบรารีถูกคอมไพล์โดยสคริปต์กำหนดค่า

คุณยังสามารถลบล้างสิ่งนี้ได้โดยการตั้งค่าตัวแปรสภาพแวดล้อม "LIBGUESTFS_HV"

โปรดทราบว่าคุณควรเรียกใช้ฟังก์ชันนี้โดยเร็วที่สุดหลังจากสร้างแฮนเดิล
เนื่องจากการดำเนินการก่อนการเปิดตัวบางอย่างขึ้นอยู่กับการทดสอบคุณสมบัติ qemu (โดยการรัน
"qemu -ช่วย") หากไบนารี qemu เปลี่ยนแปลง เราจะไม่ทดสอบคุณสมบัติซ้ำ ดังนั้นคุณอาจเห็น
ผลลัพธ์ที่ไม่สอดคล้องกัน การใช้ตัวแปรสภาพแวดล้อม "LIBGUESTFS_HV" นั้นปลอดภัยที่สุด
เนื่องจากมันเลือกไบนารี qemu ในเวลาเดียวกันกับที่แฮนเดิลถูกสร้างขึ้น

ชุดระบุ
ระบุ
ตัวระบุชุดตัวระบุ

นี่คือสตริงข้อมูลซึ่งผู้เรียกอาจเลือกตั้งค่าในแฮนเดิลได้ มันคือ
พิมพ์ในสถานที่ต่าง ๆ ทำให้สามารถระบุหมายเลขอ้างอิงปัจจุบันในการดีบัก
เอาท์พุต

สิ่งสำคัญประการหนึ่งคือเมื่อเปิดใช้งานการติดตาม หากสตริงตัวระบุไม่ว่างเปล่า
สตริง จากนั้นติดตามข้อความจะเปลี่ยนจากสิ่งนี้:

libguestfs: ติดตาม: get_tmpdir
libguestfs: ติดตาม: get_tmpdir = "/ Tmp"

สำหรับสิ่งนี้:

libguestfs: ติดตาม: ID: get_tmpdir
libguestfs: ติดตาม: ID: get_tmpdir = "/ Tmp"

โดยที่ "ID" คือสตริงตัวระบุที่กำหนดโดยการโทรนี้

ตัวระบุต้องมีเฉพาะอักขระ ASCII ที่เป็นตัวอักษรและตัวเลขคละกัน ขีดล่าง และเครื่องหมายลบ
ค่าดีฟอลต์คือสตริงว่าง

ดูเพิ่มเติมที่ "set-program", "set-trace", "get-identifier"

ชุดป้าย
ชุดป้ายติดฉลาก

ตั้งค่าป้ายกำกับระบบไฟล์เป็น "เมานท์" เป็น "ป้ายกำกับ"

เฉพาะระบบไฟล์บางประเภทเท่านั้นที่รองรับป้ายกำกับ และ libguestfs รองรับการตั้งค่าป้ายกำกับบนเท่านั้น
ส่วนย่อยของสิ่งเหล่านี้

ต่อ 2, ต่อ 3, ต่อ 4
ป้ายกำกับถูกจำกัดไว้ที่ 16 ไบต์

NTFS
ป้ายกำกับจำกัดอักขระ Unicode ได้ไม่เกิน 128 ตัว

XFS ป้ายชื่อถูกจำกัดที่ 12 ไบต์ ระบบไฟล์จะต้องไม่ถูกเมาต์เมื่อพยายาม
ตั้งฉลาก

btrfs
ป้ายกำกับถูกจำกัดที่ 255 ไบต์และไม่อนุญาตให้ใช้อักขระบางตัว การตั้งค่า
เลเบลบนโวลุ่มย่อย btrfs จะตั้งค่าเลเบลบนระบบไฟล์หลัก ดิ
ต้องไม่ติดตั้งระบบไฟล์เมื่อพยายามตั้งค่าป้ายกำกับ

fat ฉลากถูกจำกัดไว้ที่ 11 ไบต์

หากไม่มีการสนับสนุนสำหรับการเปลี่ยนป้ายกำกับสำหรับประเภทของระบบไฟล์ที่ระบุ
set_label จะล้มเหลวและตั้งค่า errno เป็น ENOTSUP

หากต้องการอ่านป้ายกำกับบนระบบไฟล์ ให้เรียก "vfs-label"

set-libvirt-ร้องขอข้อมูลรับรอง
set-libvirt-requested-credential ดัชนี cred

หลังจากขอข้อมูลประจำตัว "ดัชนี" จากผู้ใช้แล้ว ให้เรียกใช้ฟังก์ชันนี้เพื่อส่งผ่าน
ตอบกลับไปที่ libvirt

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

set-libvirt-supported-หนังสือรับรอง
set-libvirt-supported-credentials 'เครดิต ...'

เรียกใช้ฟังก์ชันนี้ก่อนตั้งค่าตัวจัดการเหตุการณ์สำหรับ "GUESTFS_EVENT_LIBVIRT_AUTH" เป็น
ระบุรายการประเภทข้อมูลรับรองที่โปรแกรมรู้วิธีดำเนินการ

รายการ "เครดิต" ต้องเป็นรายการสตริงที่ไม่ว่างเปล่า สตริงที่เป็นไปได้คือ:

"ชื่อผู้ใช้"
"ชื่อจริง"
"ภาษา"
"คอนเซ่"
"ข้อความรหัสผ่าน"
"เอ็กโซพรอมต์"
"โนโชพร้อมพร็อพท์"
"อาณาจักร"
"ภายนอก"

ดูเอกสารประกอบ libvirt สำหรับความหมายของประเภทข้อมูลรับรองเหล่านี้

ดู "การรับรองความถูกต้องของ LIBVIRT" ใน แขก(3) สำหรับเอกสารและรหัสตัวอย่าง

ชุด memsize
เมมไซส์
ชุด memsize memsize

ซึ่งกำหนดขนาดหน่วยความจำเป็นเมกะไบต์ที่จัดสรรให้กับไฮเปอร์ไวเซอร์ มีแค่นี้
มีผลถ้าเรียกก่อน "เปิดตัว"

คุณยังสามารถเปลี่ยนแปลงได้โดยการตั้งค่าตัวแปรสภาพแวดล้อม "LIBGUESTFS_MEMSIZE" ก่อน
ที่จับถูกสร้างขึ้น

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสถาปัตยกรรมของ libguestfs โปรดดูที่ แขก(3)

ชุดเครือข่าย
เครือข่าย
ตั้งค่าเครือข่าย true|false

หาก "เครือข่าย" เป็นจริง แสดงว่าเครือข่ายเปิดใช้งานในอุปกรณ์ libguestfs ดิ
ค่าเริ่มต้นเป็นเท็จ

สิ่งนี้มีผลกับคำสั่งที่สามารถเข้าถึงเครือข่ายได้หรือไม่ (ดู "คำสั่งการรัน" ใน
แขก(พ.ศ. 3)).

คุณต้องเรียกสิ่งนี้ก่อนที่จะเรียก "เปิดตัว" มิฉะนั้นจะไม่มีผล

ชุดเส้นทาง
เส้นทาง
ค้นหาเส้นทางที่กำหนด

กำหนดเส้นทางที่ libguestfs ค้นหาเคอร์เนลและ initrd.img

ค่าเริ่มต้นคือ "$libdir/guestfs" เว้นแต่จะถูกแทนที่ด้วยการตั้งค่า "LIBGUESTFS_PATH"
ตัวแปรสภาพแวดล้อม

การตั้งค่า "เส้นทาง" เป็น "NULL" จะคืนค่าเส้นทางเริ่มต้น

ชุด pgroup
กลุ่ม
set-pgroup จริง|เท็จ

ถ้า "pgroup" เป็นจริง โปรเซสลูกจะถูกวางลงในกลุ่มโปรเซสของตัวเอง

ผลที่ตามมาในทางปฏิบัติคือสัญญาณเช่น "SIGINT" (จากผู้ใช้กด "^C")
กระบวนการย่อยจะไม่ได้รับ

ค่าดีฟอลต์สำหรับแฟล็กนี้เป็นเท็จ เนื่องจากโดยปกติคุณต้องการให้ "^C" ฆ่ากระบวนการย่อย
Guestfish ตั้งค่าแฟล็กนี้เป็นจริงเมื่อใช้แบบโต้ตอบ เพื่อให้ "^C" สามารถยกเลิก long-
รันคำสั่งอย่างสง่างาม (ดู "ผู้ใช้ยกเลิก")

ชุดโปรแกรม
โครงการ
ชุดโปรแกรม โปรแกรม

ตั้งชื่อโปรแกรม. นี่คือสตริงข้อมูลที่โปรแกรมหลักสามารถเลือกได้
ตั้งอยู่ในที่จับ

เมื่อสร้างหมายเลขอ้างอิง ชื่อโปรแกรมในหมายเลขอ้างอิงจะถูกตั้งค่าเป็นชื่อฐานจาก
"argv[0]". หากไม่สามารถทำได้ ระบบจะตั้งค่าเป็นสตริงว่าง (แต่ไม่เคยเป็น "NULL")

ชุด-qemu
qemu
ชุด-qemu hv

ตั้งค่าไบนารีไฮเปอร์ไวเซอร์ (โดยปกติคือ qemu) ที่เราจะใช้

ค่าเริ่มต้นจะถูกเลือกเมื่อไลบรารีถูกคอมไพล์โดยสคริปต์กำหนดค่า

คุณยังสามารถลบล้างสิ่งนี้ได้โดยการตั้งค่าตัวแปรสภาพแวดล้อม "LIBGUESTFS_HV"

การตั้งค่า "hv" เป็น "NULL" จะคืนค่าไบนารี qemu เริ่มต้น

โปรดทราบว่าคุณควรเรียกใช้ฟังก์ชันนี้โดยเร็วที่สุดหลังจากสร้างแฮนเดิล
เนื่องจากการดำเนินการก่อนการเปิดตัวบางอย่างขึ้นอยู่กับการทดสอบคุณสมบัติ qemu (โดยการรัน
"qemu -ช่วย") หากไบนารี qemu เปลี่ยนแปลง เราจะไม่ทดสอบคุณสมบัติซ้ำ ดังนั้นคุณอาจเห็น
ผลลัพธ์ที่ไม่สอดคล้องกัน การใช้ตัวแปรสภาพแวดล้อม "LIBGUESTFS_HV" นั้นปลอดภัยที่สุด
เนื่องจากมันเลือกไบนารี qemu ในเวลาเดียวกันกับที่แฮนเดิลถูกสร้างขึ้น

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "set-hv" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ตั้ง-recovery-proc
การกู้คืนproc
set-recovery-proc จริง|เท็จ

หากเรียกสิ่งนี้ด้วยพารามิเตอร์ "false" ดังนั้น "launch" จะไม่สร้างการกู้คืน
กระบวนการ. จุดประสงค์ของกระบวนการกู้คืนคือการหยุดกระบวนการรันอะเวย์ไฮเปอร์ไวเซอร์ใน
กรณีที่โปรแกรมหลักล้มเลิกกะทันหัน

สิ่งนี้จะมีผลใดๆ หากถูกเรียกก่อน "เปิดตัว" และค่าดีฟอลต์จะเป็นจริง

ครั้งเดียวที่คุณต้องการปิดการใช้งานนี้คือถ้ากระบวนการหลักจะแยก
ตัวเองเป็นพื้นหลัง ("daemonize" เอง) ในกรณีนี้กระบวนการกู้คืนคิดว่า
ว่าโปรแกรมหลักหายไปและฆ่าไฮเปอร์ไวเซอร์ซึ่งไม่มากนัก
เป็นประโยชน์

ชุด-selinux
เซลินุกซ์
set-selinux จริง | เท็จ

การตั้งค่านี้จะตั้งค่าสถานะ selinux ที่ส่งผ่านไปยังอุปกรณ์ขณะบูต ค่าเริ่มต้นคือ
"selinux=0" (ปิดการใช้งาน)

โปรดทราบว่าหากเปิดใช้งาน SELinux จะอยู่ในโหมดอนุญาตเสมอ ("กำลังบังคับใช้=0")

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสถาปัตยกรรมของ libguestfs โปรดดูที่ แขก(3)

ชุด-smp
SMP
ชุด-smp smp

เปลี่ยนจำนวน CPU เสมือนที่กำหนดให้กับอุปกรณ์ ค่าเริ่มต้นคือ 1
การเพิ่มสิ่งนี้อาจช่วยปรับปรุงประสิทธิภาพ แม้ว่าบ่อยครั้งจะไม่มีผลใดๆ

ต้องเรียกใช้ฟังก์ชันนี้ก่อน "เปิดตัว"

ตั้งค่า tmpdir
tmpdir
ตั้งค่า tmpdir tmpdir

ตั้งค่าไดเร็กทอรีที่ใช้โดยแฮนเดิลเพื่อเก็บไฟล์ชั่วคราว

ตัวแปรสภาพแวดล้อม "LIBGUESTFS_TMPDIR" และ "TMPDIR" ควบคุมค่าเริ่มต้น: If
"LIBGUESTFS_TMPDIR" ถูกตั้งค่าไว้ นั่นคือค่าเริ่มต้น มิฉะนั้นหากตั้งค่า "TMPDIR" แล้ว
เป็นค่าเริ่มต้น อื่น / Tmp เป็นค่าเริ่มต้น

ชุดติดตาม
ติดตาม
set-trace จริง | เท็จ

หากแฟล็กการติดตามคำสั่งถูกตั้งค่าเป็น 1 การเรียก libguestfs พารามิเตอร์ และค่าส่งคืน
ถูกติดตาม

หากคุณต้องการติดตามการเรียก C API ไปยัง libguestfs (และไลบรารีอื่น ๆ ) อาจเป็น
วิธีที่ดีกว่าคือการใช้ภายนอก ลิเทรซ(1) คำสั่ง

การติดตามคำสั่งถูกปิดใช้งานเว้นแต่จะมีการกำหนดตัวแปรสภาพแวดล้อม "LIBGUESTFS_TRACE" ไว้
และตั้งค่าเป็น 1

โดยปกติข้อความติดตามจะถูกส่งไปยัง "stderr" เว้นแต่คุณจะลงทะเบียนการโทรกลับเพื่อส่ง
ที่อื่น (ดู "set-event-callback")

ชุด-uuid
อุปกรณ์ set-uuid uuid

ตั้งค่าระบบไฟล์ UUID บน "อุปกรณ์" เป็น "uuid" หากล้มเหลวและข้อผิดพลาดคือ ENOTSUP
หมายความว่าไม่มีการสนับสนุนสำหรับการเปลี่ยน UUID สำหรับประเภทที่ระบุ
ระบบไฟล์

ระบบไฟล์บางประเภทเท่านั้นที่รองรับการตั้งค่า UUID

หากต้องการอ่าน UUID บนระบบไฟล์ ให้เรียก "vfs-uuid"

set-uuid-สุ่ม
set-uuid-สุ่มอุปกรณ์

ตั้งค่าระบบไฟล์ UUID บน "อุปกรณ์" เป็น UUID แบบสุ่ม หากสิ่งนี้ล้มเหลวและข้อผิดพลาดคือ
ENOTSUP หมายความว่าไม่มีการสนับสนุนสำหรับการเปลี่ยน UUID สำหรับประเภทของ
ระบบไฟล์ที่ระบุ

ระบบไฟล์บางประเภทเท่านั้นที่รองรับการตั้งค่า UUID

หากต้องการอ่าน UUID บนระบบไฟล์ ให้เรียก "vfs-uuid"

ตั้งค่ารายละเอียด
ละเอียด
set-verbose จริง | เท็จ

หาก "verbose" เป็นจริง จะเป็นการเปิดข้อความ verbose

ข้อความแบบละเอียดจะถูกปิดใช้งานเว้นแต่ว่าตัวแปรสภาพแวดล้อม "LIBGUESTFS_DEBUG" is
กำหนดและตั้งค่าเป็น 1

โดยปกติข้อความที่ละเอียดจะถูกส่งไปยัง "stderr" เว้นแต่คุณจะลงทะเบียนการโทรกลับเพื่อส่ง
พวกเขาอยู่ที่อื่น (ดู "set-event-callback")

เซ็ตคอน
บริบท setcon

สิ่งนี้ตั้งค่าบริบทความปลอดภัยของ SELinux ของ daemon เป็นสตริง "บริบท"

ดูเอกสารเกี่ยวกับ SELINUX ใน แขก(3)

setxattr
setxattr xattr val vallen เส้นทาง

การเรียกนี้ตั้งค่าแอตทริบิวต์แบบขยายชื่อ "xattr" ของไฟล์ "เส้นทาง" เป็นค่า "val"
(ความยาว "vallen") ค่านี้เป็นข้อมูล 8 บิตโดยพลการ

ดูเพิ่มเติม: "lsetxattr", Attribution-NonCommercial-ShareAlike(5)

เอสเอฟดิสก์
sfdisk device cyls ส่วนหัว 'สาย ...'

นี่เป็นส่วนต่อประสานโดยตรงกับ เอสเอฟดิสก์(8) โปรแกรมสำหรับสร้างพาร์ติชั่นบนบล็อค
อุปกรณ์

"อุปกรณ์" ควรเป็นอุปกรณ์บล็อกเช่น / dev / SDA.

"กระบอกสูบ" "หัว" และ "ส่วน" คือจำนวนกระบอกสูบ หัว และส่วนบน
อุปกรณ์ซึ่งส่งโดยตรงไปยัง sfdisk เป็น -C, -H และ -S พารามิเตอร์ ถ้าคุณผ่าน
0 สำหรับสิ่งเหล่านี้ พารามิเตอร์ที่เกี่ยวข้องจะถูกละเว้น โดยปกติสำหรับ 'ขนาดใหญ่'
ดิสก์ คุณสามารถผ่าน 0 สำหรับสิ่งเหล่านี้ได้ แต่สำหรับดิสก์ขนาดเล็ก (ขนาดฟลอปปี) sfdisk (หรือ
แต่เคอร์เนล) ไม่สามารถหารูปทรงที่ถูกต้องได้ และคุณจะต้องบอกมัน

"lines" คือรายการของบรรทัดที่เราป้อนให้กับ "sfdisk" สำหรับข้อมูลเพิ่มเติมโปรดดูที่
เอสเอฟดิสก์(8) หน้าจัดการ

ในการสร้างพาร์ติชั่นเดียวที่ใช้ทั้งดิสก์ คุณจะต้องส่ง "lines" เป็นพาร์ติชั่นเดียว
รายการองค์ประกอบ เมื่อองค์ประกอบเดียวเป็นสตริง "," (จุลภาค)

ดูเพิ่มเติม: "sfdisk-l", "sfdisk-N", "part-init"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "part-add" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

sfdiskM
อุปกรณ์ sfdiskM 'สาย ...'

นี่คืออินเทอร์เฟซที่เรียบง่ายสำหรับคำสั่ง "sfdisk" โดยที่ขนาดพาร์ติชั่นคือ
ระบุเป็นเมกะไบต์เท่านั้น (ปัดเศษเป็นทรงกระบอกที่ใกล้ที่สุด) และคุณไม่จำเป็นต้อง
ระบุพารามิเตอร์ของ cyls, heads และ sectors ซึ่งแทบไม่เคยใช้เลย

ดูเพิ่มเติม: "sfdisk", the เอสเอฟดิสก์(8) manpage และ "part-disk"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "part-add" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

sfdisk-N
sfdisk-N อุปกรณ์ partnum cyls หัวเซกเตอร์ line

นี้ทำงาน เอสเอฟดิสก์(8) ตัวเลือกในการปรับเปลี่ยนเพียงพาร์ติชั่นเดียว "n" (หมายเหตุ: "n" นับจาก
1)

สำหรับพารามิเตอร์อื่นๆ โปรดดู "sfdisk" โดยปกติคุณควรผ่าน 0 สำหรับ cyls/heads/sectors
พารามิเตอร์

ดูเพิ่มเติม: "ส่วนเพิ่ม"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "part-add" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

sfdisk-disk-เรขาคณิต
sfdisk-disk-อุปกรณ์เรขาคณิต

ซึ่งจะแสดงรูปทรงดิสก์ของ "อุปกรณ์" ที่อ่านจากตารางพาร์ติชั่น โดยเฉพาะใน
กรณีที่มีการปรับขนาดอุปกรณ์บล็อกพื้นฐานนี้จะแตกต่างจาก
แนวคิดของเคอร์เนลเกี่ยวกับเรขาคณิต (ดู "sfdisk-kernel-geometry")

ผลลัพธ์อยู่ในรูปแบบที่มนุษย์อ่านได้ และไม่ได้ออกแบบมาเพื่อให้แยกวิเคราะห์

sfdisk-เคอร์เนลเรขาคณิต
sfdisk-เคอร์เนล-อุปกรณ์เรขาคณิต

สิ่งนี้แสดงแนวคิดของเคอร์เนลเกี่ยวกับเรขาคณิตของ "อุปกรณ์"

ผลลัพธ์อยู่ในรูปแบบที่มนุษย์อ่านได้ และไม่ได้ออกแบบมาเพื่อให้แยกวิเคราะห์

sfdisk-l
อุปกรณ์ sfdisk-l

สิ่งนี้แสดงตารางพาร์ติชั่นบน "อุปกรณ์" ในเอาต์พุตที่มนุษย์อ่านได้ของ
เอสเอฟดิสก์(8) คำสั่ง ไม่ได้มีไว้เพื่อแยกวิเคราะห์

ดูเพิ่มเติม: "รายการบางส่วน"

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "part-list" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

sh
คำสั่ง sh

การเรียกนี้เรียกใช้คำสั่งจากระบบไฟล์ของแขกผ่าน guest's bin / sh /.

นี้เป็นเหมือน "คำสั่ง" แต่ส่งคำสั่งไปที่:

bin / sh / -c "คำสั่ง"

ขึ้นอยู่กับเชลล์ของแขก ซึ่งมักจะส่งผลให้ไวด์การ์ดถูกขยาย, เชลล์
นิพจน์ที่ถูกสอดแทรกและอื่น ๆ

ข้อกำหนดทั้งหมดเกี่ยวกับ "คำสั่ง" ใช้กับการโทรนี้

sh-เส้น
คำสั่ง sh-lines

สิ่งนี้เหมือนกับ "sh" แต่แยกผลลัพธ์ออกเป็นรายการบรรทัด

ดูเพิ่มเติม: "บรรทัดคำสั่ง"

การปิด
การปิด

นี่คือสิ่งที่ตรงกันข้ามกับ "เปิดตัว" มันทำการปิดระบบแบ็กเอนด์อย่างเป็นระเบียบ
กระบวนการ หากมีการตั้งค่าแฟล็ก autosync (ซึ่งเป็นค่าเริ่มต้น) อิมเมจของดิสก์จะเป็น
ซิงโครไนซ์

หากกระบวนการย่อยออกโดยมีข้อผิดพลาด ฟังก์ชันนี้จะส่งคืนข้อผิดพลาด ซึ่ง
น่า ไม่ ถูกละเว้น (อาจบ่งชี้ว่าไม่สามารถเขียนภาพดิสก์ได้
อย่างถูกต้อง).

เรียกสิ่งนี้หลายครั้งได้อย่างปลอดภัย การโทรพิเศษจะถูกละเว้น

การโทรนี้ไม่ ไม่ ปิดหรือปล่อยที่จับ คุณยังคงต้องเรียก "ปิด"
ภายหลัง

"ปิด" จะเรียกสิ่งนี้ถ้าคุณไม่ทำอย่างชัดเจน แต่โปรดทราบว่าข้อผิดพลาดใด ๆ จะถูกละเว้น
ในกรณีนั้น.

นอนหลับ
วินาทีหลับ

นอนหลับเป็นเวลา "วินาที"

stat
เส้นทางสถิติ

ส่งกลับข้อมูลไฟล์สำหรับ "เส้นทาง" ที่กำหนด

นี่ก็เหมือนกับ stat(2) การเรียกระบบ

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ใช้การเรียก "statns" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

สถานะ
สถิติเส้นทาง

ส่งกลับข้อมูลไฟล์สำหรับ "เส้นทาง" ที่กำหนด

นี่ก็เหมือนกับ stat(2) การเรียกระบบ

สถิติ
statvfs เส้นทาง

ส่งกลับสถิติระบบไฟล์สำหรับระบบไฟล์ที่เมาท์ "เส้นทาง" ควรเป็นไฟล์หรือ
ไดเร็กทอรีในระบบไฟล์ที่ต่อเชื่อม (โดยทั่วไปคือจุดต่อเชื่อมเอง แต่เป็น
ไม่จำเป็นต้องเป็น)

นี่ก็เหมือนกับ สถิติ(2) การเรียกระบบ

เงื่อนไข
เส้นทางสตริง

สิ่งนี้ทำงาน เงื่อนไข(1) คำสั่งในไฟล์และส่งคืนรายการสตริงที่พิมพ์ได้
พบว่า

ในอดีต คำสั่ง "strings" มีปัญหากับการแยกวิเคราะห์ไฟล์ที่ไม่น่าเชื่อถือ เหล่านี้
ได้รับการบรรเทาใน libguestfs เวอร์ชันปัจจุบัน แต่ดู "CVE-2014-8484" ใน แขก(3)

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

สตริง-e
เส้นทางการเข้ารหัส strings-e

เหมือนกับคำสั่ง "strings" แต่ให้คุณระบุการเข้ารหัสของสตริงที่
ถูกค้นหาในไฟล์ต้นทาง "เส้นทาง"

การเข้ารหัสที่อนุญาตคือ:

อักขระ 7 บิตไบต์เดี่ยว เช่น ASCII และชิ้นส่วนที่เข้ากันได้กับ ASCII ของ ISO-8859-X
(นี่คือสิ่งที่ "สตริง" ใช้)

S อักขระ 8 บิตไบต์เดี่ยว

b สตริง endian ขนาดใหญ่ 16 บิต เช่น สตริงที่เข้ารหัสใน UTF-16BE หรือ UCS-2BE

ล. (ตัวพิมพ์เล็ก L)
endian น้อย 16 บิต เช่น UTF-16LE และ UCS-2LE นี้เป็นประโยชน์สำหรับการตรวจสอบ
ไบนารีในแขกของ Windows

B 32 บิต endian ขนาดใหญ่เช่น UCS-4BE

L 32-บิต endian น้อย เช่น UCS-4LE

สตริงที่ส่งคืนจะถูกแปลงเป็น UTF-8

ในอดีต คำสั่ง "strings" มีปัญหากับการแยกวิเคราะห์ไฟล์ที่ไม่น่าเชื่อถือ เหล่านี้
ได้รับการบรรเทาใน libguestfs เวอร์ชันปัจจุบัน แต่ดู "CVE-2014-8484" ใน แขก(3)

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

อุปกรณ์แลกเปลี่ยน
อุปกรณ์สลับอุปกรณ์

คำสั่งนี้ปิดใช้งานอุปกรณ์สลับอุปกรณ์ libguestfs หรือพาร์ติชั่นชื่อ "อุปกรณ์"
ดู "swapon-device"

swapoff-ไฟล์
ไฟล์ swapoff ไฟล์

คำสั่งนี้ปิดใช้งานการสลับอุปกรณ์ libguestfs ในไฟล์

สลับฉลาก
ป้ายสลับป้าย

คำสั่งนี้ปิดใช้งานการสลับอุปกรณ์ libguestfs บนพาร์ติชั่นสว็อปที่มีป้ายกำกับ

swapoff-uuid
สลับ-uuid uuid

คำสั่งนี้ปิดใช้งานพาร์ติชัน swap ของอุปกรณ์ libguestfs ด้วย UUID ที่กำหนด

อุปกรณ์สวอปออน
อุปกรณ์สวอปออน

คำสั่งนี้ทำให้อุปกรณ์ libguestfs ใช้อุปกรณ์สลับหรือพาร์ติชั่นที่ชื่อ
"อุปกรณ์". มีหน่วยความจำที่เพิ่มขึ้นสำหรับคำสั่งทั้งหมด ตัวอย่างเช่น run
โดยใช้ "คำสั่ง" หรือ "sh"

โปรดทราบว่าคุณไม่ควรสลับไปยังพาร์ติชั่น guest swap ที่มีอยู่เว้นแต่คุณจะรู้ว่าคุณ
กำลังทำ. พวกเขาอาจมีข้อมูลการจำศีลหรือข้อมูลอื่น ๆ ที่แขก
ไม่ต้องการให้คุณทิ้งขยะ คุณยังเสี่ยงที่จะรั่วไหลข้อมูลเกี่ยวกับโฮสต์ให้กับแขก
ทางนี้. ให้แนบอุปกรณ์โฮสต์ใหม่กับแขกและเปลี่ยนอุปกรณ์นั้นแทน

swapon-ไฟล์
ไฟล์สวอปไฟล์

คำสั่งนี้เปิดใช้งานการสลับไปยังไฟล์ ดู "swapon-device" สำหรับหมายเหตุอื่นๆ

สวอปออน-เลเบล
ฉลากสวอปออน

คำสั่งนี้เปิดใช้งานการสลับไปยังพาร์ติชั่นสว็อปที่มีป้ายกำกับ See "swapon-device" สำหรับอื่นๆ
บันทึก

swapon-uuid
สลับ-uuid uuid

คำสั่งนี้เปิดใช้งานการสลับไปยังพาร์ติชั่นสว็อปด้วย UUID ที่กำหนด ดู "swapon-device"
สำหรับบันทึกอื่น ๆ

ซิงค์
ซิงค์

สิ่งนี้จะซิงค์ดิสก์ เพื่อให้การเขียนใดๆ ถูกฟลัชผ่านไปยังอิมเมจของดิสก์พื้นฐาน

คุณควรเรียกสิ่งนี้เสมอหากคุณได้แก้ไขภาพดิสก์ ก่อนที่จะปิดแฮนเดิล

syslinux
อุปกรณ์ syslinux [ไดเรกทอรี:..]

ติดตั้ง SYSLINUX bootloader บน "อุปกรณ์"

พารามิเตอร์อุปกรณ์ต้องเป็นทั้งดิสก์ที่จัดรูปแบบเป็นระบบไฟล์ FAT หรือ a
พาร์ติชันที่จัดรูปแบบเป็นระบบไฟล์ FAT ในกรณีหลัง พาร์ติชั่นควรเป็น
ทำเครื่องหมายเป็น "active" ("part-set-bootable") และต้องติดตั้ง Master Boot Record (เช่น
ใช้ "pwrite-device") ในส่วนแรกของดิสก์ทั้งหมด แพ็คเกจ SYSLINUX มาแล้ว
ด้วย Master Boot Records ที่เหมาะสม ดู syslinux(1) หน้าคนต่อไป
ข้อมูล

อาร์กิวเมนต์ที่เป็นทางเลือกคือ:

ไดเรกทอรี
ติดตั้ง SYSLINUX ในไดเร็กทอรีย่อยที่มีชื่อ แทนที่จะติดตั้งในไดเร็กทอรีรากของ
ระบบไฟล์ FAT

สามารถกำหนดค่าเพิ่มเติมให้กับ SYSLINUX ได้โดยการวางไฟล์ชื่อ syslinux.cfg
บนระบบไฟล์ FAT ไม่ว่าจะในไดเร็กทอรีรูทหรือภายใต้ ไดเรกทอรี ถ้าไม่จำเป็น
กำลังใช้อาร์กิวเมนต์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาของไฟล์นี้ โปรดดูที่
syslinux(1)

ดูเพิ่มเติมที่ "extlinux"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

หาง
เส้นทางหาง

คำสั่งนี้จะคืนค่าเป็น 10 บรรทัดสุดท้ายของไฟล์เป็นรายการสตริง

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

หาง-n
เส้นทางหาง-n nrlines

หากพารามิเตอร์ "nrlines" เป็นจำนวนบวก จะคืนค่าบรรทัด "nrlines" สุดท้ายของ
ไฟล์ "เส้นทาง"

หากพารามิเตอร์ "nrlines" เป็นจำนวนลบ ค่านี้จะส่งคืนบรรทัดจากไฟล์ "path"
เริ่มต้นด้วยบรรทัดที่ "-nrlines"

หากพารามิเตอร์ "nrlines" เป็นศูนย์ จะคืนค่ารายการว่าง

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

ทาร์อิน
น้ำมันดินในตัวเลือก
tar-in (tarfile|-) ไดเร็กทอรี [บีบอัด:..] [xattrs:จริง|เท็จ] [selinux:จริง|เท็จ] [acls:จริง|เท็จ]

คำสั่งนี้จะอัปโหลดและแตกไฟล์ในเครื่อง "tarfile" ลงใน ไดเรกทอรี.

แฟล็ก "บีบอัด" ที่เป็นตัวเลือกจะควบคุมการบีบอัด หากไม่ระบุ ข้อมูลที่ป้อนควรเป็น
ไฟล์ tar ที่ไม่บีบอัด มิฉะนั้น อาจกำหนดหนึ่งในสตริงต่อไปนี้เพื่อเลือก
ประเภทการบีบอัดของไฟล์อินพุต: "บีบอัด", "gzip", "bzip2", "xz", "lzop" (บันทึก
ไม่ใช่ว่าทุกบิลด์ของ libguestfs จะรองรับประเภทการบีบอัดเหล่านี้ทั้งหมด)

อาร์กิวเมนต์ที่เป็นทางเลือกอื่นๆ ได้แก่:

"แซททร์"
หากตั้งค่าเป็น true แอ็ตทริบิวต์ส่วนขยายจะถูกกู้คืนจากไฟล์ tar

"เซลินุกซ์"
หากตั้งค่าเป็นจริง บริบท SELinux จะถูกกู้คืนจากไฟล์ tar

"เอแอลเอส"
หากตั้งค่าเป็นจริง POSIX ACL จะถูกกู้คืนจากไฟล์ tar

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

น้ำมันดิน
tar-out-opts
ไดเรกทอรี tar-out (tarfile|-) [บีบอัด:..] [ตัวเลขเจ้าของ:จริง|เท็จ] [ไม่รวม:..] [xattrs:จริง|เท็จ] [selinux:จริง|เท็จ] [acls:จริง|เท็จ]

คำสั่งนี้บรรจุเนื้อหาของ ไดเรกทอรี และดาวน์โหลดไฟล์ในเครื่อง "tarfile"

แฟล็ก "บีบอัด" ที่เป็นตัวเลือกจะควบคุมการบีบอัด หากไม่ระบุ ผลลัพธ์จะเป็น
ไฟล์ tar ที่ไม่บีบอัด มิฉะนั้น อาจกำหนดหนึ่งในสตริงต่อไปนี้เพื่อเลือก
ประเภทการบีบอัดของไฟล์เอาต์พุต: "บีบอัด", "gzip", "bzip2", "xz", "lzop" (บันทึก
ไม่ใช่ว่าทุกบิลด์ของ libguestfs จะรองรับประเภทการบีบอัดเหล่านี้ทั้งหมด)

อาร์กิวเมนต์ที่เป็นทางเลือกอื่นๆ ได้แก่:

"ยกเว้น"
รายชื่อตัวแทน ไฟล์จะถูกยกเว้นหากตรงกับสัญลักษณ์แทนใดๆ

"เจ้าของตัวเลข"
หากตั้งค่าเป็น true ไฟล์ tar เอาต์พุตจะมีหมายเลข UID/GID แทน user/group
ชื่อ

"แซททร์"
หากตั้งค่าเป็น true แอ็ตทริบิวต์แบบขยายจะถูกบันทึกไว้ในเอาต์พุต tar

"เซลินุกซ์"
หากตั้งค่าเป็นจริง บริบท SELinux จะถูกบันทึกไว้ในเอาต์พุต tar

"เอแอลเอส"
หากตั้งค่าเป็น true POSIX ACL จะถูกบันทึกไว้ในเอาต์พุต tar

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

tgz-ใน
ไดเรกทอรี tgz-in (tarball|-)

คำสั่งนี้จะอัปโหลดและแตกไฟล์ในเครื่อง "tarball" (a gzip ถูกอัด tar ไฟล์) เป็น
ไดเรกทอรี.

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ให้ใช้การเรียก "tar-in" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

tgz ออก
ไดเรกทอรี tgz-out (tarball |-)

คำสั่งนี้บรรจุเนื้อหาของ ไดเรกทอรี และดาวน์โหลดไฟล์ในเครื่อง "tarball"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "tar-out" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

แตะ
เส้นทางสัมผัส

สัมผัสทำหน้าที่เหมือน แตะ(1) คำสั่ง สามารถใช้เพื่ออัปเดตการประทับเวลาในไฟล์
หรือหากไม่มีไฟล์อยู่ ให้สร้างไฟล์ที่มีความยาวเป็นศูนย์ใหม่

คำสั่งนี้ใช้งานได้กับไฟล์ปกติเท่านั้น และจะล้มเหลวในไฟล์ประเภทอื่น เช่น
ไดเร็กทอรี ลิงก์สัญลักษณ์ บล็อกพิเศษ ฯลฯ

ตัด
ตัดเส้นทาง

คำสั่งนี้จะตัด "เส้นทาง" เป็นไฟล์ที่มีความยาวเป็นศูนย์ ไฟล์ต้องมีอยู่แล้ว

ตัดทอนขนาด
ขนาดเส้นทางตัดทอนขนาด

คำสั่งนี้จะตัดทอน "เส้นทาง" เป็นขนาด "ขนาด" ไบต์ ไฟล์ต้องมีอยู่แล้ว

หากขนาดไฟล์ปัจจุบันน้อยกว่า "ขนาด" ไฟล์จะถูกขยายเป็นขนาดที่จำเป็น
ขนาดที่มีศูนย์ไบต์ สิ่งนี้จะสร้างไฟล์กระจัดกระจาย (เช่น บล็อกดิสก์ไม่ได้ถูกจัดสรรสำหรับ
ไฟล์จนกว่าคุณจะเขียนลงไป) ในการสร้างไฟล์ศูนย์ที่ไม่กระจัดกระจาย ให้ใช้ "fallocate64"
แทน.

Tune2fs
อุปกรณ์ tune2fs [บังคับ:จริง|เท็จ] [maxmountcount:N] [จำนวนการเมานท์:N] [ข้อผิดพลาดพฤติกรรม:..] [กลุ่ม:N] [ช่วงระหว่างเช็ค:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N ] [ผู้ใช้:N]

การเรียกนี้ช่วยให้คุณปรับพารามิเตอร์ระบบไฟล์ต่างๆ ของ ext2/ext3/ext4
ระบบไฟล์ที่เรียกว่า "อุปกรณ์"

พารามิเตอร์ทางเลือกคือ:

"บังคับ"
บังคับให้ tune2fs ดำเนินการให้เสร็จสิ้นแม้ในขณะที่เกิดข้อผิดพลาด นี่ก็เหมือนกัน
เป็นตัวเลือก "-f" ของ tune2fs

"maxmountcount"
กำหนดจำนวนการเมานต์หลังจากที่ระบบไฟล์ถูกตรวจสอบโดย e2fsck(8). ถ้านี้
คือ 0 ดังนั้นจำนวนการขี่จะถูกเพิกเฉย สิ่งนี้เหมือนกับ tune2fs "-c"
ตัวเลือก

"การขึ้นเขา"
กำหนดจำนวนครั้งที่ระบบไฟล์ได้รับการติดตั้ง นี่ก็เหมือนกับ
ตัวเลือก tune2fs "-C"

"พฤติกรรมผิดพลาด"
เปลี่ยนพฤติกรรมของรหัสเคอร์เนลเมื่อตรวจพบข้อผิดพลาด ค่าที่เป็นไปได้
ขณะนี้คือ: "ดำเนินการต่อ", "remount-ro", "ตื่นตระหนก" ในทางปฏิบัติตัวเลือกเหล่านี้ไม่
สร้างความแตกต่างได้อย่างแท้จริง โดยเฉพาะข้อผิดพลาดในการเขียน

สิ่งนี้เหมือนกับตัวเลือก "-e" ของ tune2fs

"กลุ่ม"
ตั้งค่ากลุ่มที่สามารถใช้บล็อกระบบไฟล์ที่สงวนไว้ นี่ก็เหมือนกับ
ตัวเลือก tune2fs "-g" ยกเว้นว่าสามารถระบุเป็นตัวเลขเท่านั้น

"ช่วงระหว่างเช็ค"
ปรับเวลาสูงสุดระหว่างการตรวจสอบระบบไฟล์สองครั้ง (เป็นวินาที) ถ้าตัวเลือกคือ
ผ่านเป็น 0 จากนั้นการตรวจสอบตามเวลาจะถูกปิดใช้งาน

สิ่งนี้เหมือนกับตัวเลือก "-i" ของ tune2fs

"จองบล็อคเปอร์เซ็นต์"
กำหนดเปอร์เซ็นต์ของระบบไฟล์ที่อาจได้รับการจัดสรรโดยผู้มีสิทธิพิเศษเท่านั้น
กระบวนการ สิ่งนี้เหมือนกับตัวเลือก "-m" ของ tune2fs

"lastmounteddirectory"
ตั้งค่าไดเร็กทอรีที่เมานต์ล่าสุด สิ่งนี้เหมือนกับตัวเลือก "-M" ของ tune2fs

"reservedblockscount" กำหนดจำนวนบล็อกระบบไฟล์ที่สงวนไว้ นี่ก็เหมือนกับ
ตัวเลือก tune2fs "-r"
"ผู้ใช้"
ตั้งค่าผู้ใช้ที่สามารถใช้บล็อกระบบไฟล์ที่สงวนไว้ นี่ก็เหมือนกับ
ตัวเลือก tune2fs "-u" ยกเว้นว่าสามารถระบุได้เป็นตัวเลขเท่านั้น

หากต้องการรับค่าปัจจุบันของพารามิเตอร์ระบบไฟล์ โปรดดู "tune2fs-l" เพื่อรายละเอียดที่แม่นยำ
เกี่ยวกับวิธีการทำงานของ tune2fs ดูที่ Tune2fs(8) หน้าคน

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

Tune2fs-l
อุปกรณ์ tune2fs-l

ส่งคืนเนื้อหาของ superblock ระบบไฟล์ ext2, ext3 หรือ ext4 บน "อุปกรณ์"

มันเหมือนกับการรัน "อุปกรณ์ tune2fs -l" ดู Tune2fs(8) manpage สำหรับรายละเอียดเพิ่มเติม
รายการของฟิลด์ที่ส่งคืนไม่ได้ถูกกำหนดไว้อย่างชัดเจน และขึ้นอยู่กับเวอร์ชันของ
"tune2fs" ที่สร้าง libguestfs และระบบไฟล์เอง

txz-ใน
ไดเรกทอรี txz-in (tarball|-)

คำสั่งนี้จะอัปโหลดและแตกไฟล์ในเครื่อง "tarball" (an xz ถูกอัด tar ไฟล์) เป็น
ไดเรกทอรี.

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ให้ใช้การเรียก "tar-in" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

txz ออก
ไดเรกทอรี txz-out (tarball |-)

คำสั่งนี้บรรจุเนื้อหาของ ไดเรกทอรี และดาวน์โหลดไฟล์ในเครื่อง "tarball" (เช่น
ไฟล์ tar ที่บีบอัด xz)

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในโค้ดใหม่ ให้ใช้การเรียก "tar-out" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

อูมาสก์
หน้ากากอูมาสก์

ฟังก์ชันนี้ตั้งค่ามาสก์ที่ใช้สำหรับสร้างไฟล์ใหม่และโหนดอุปกรณ์เป็น "mask & 0777"

ค่า umask ทั่วไปจะเป็น 022 ซึ่งสร้างไฟล์ใหม่ที่มีสิทธิ์เช่น
"-rw-r--r--" หรือ "-rwxr-xr-x" และ 002 ซึ่งสร้างไฟล์ใหม่ที่มีสิทธิ์เช่น
"-rw-rw-r--" หรือ "-rwxrwxr-x"

umask เริ่มต้นคือ 022 นี่เป็นสิ่งสำคัญเพราะหมายความว่าไดเร็กทอรีและอุปกรณ์
โหนดจะถูกสร้างขึ้นด้วยโหมด 0644 หรือ 0755 แม้ว่าคุณจะระบุ 0777 ก็ตาม

ดูเพิ่มเติมที่ "get-umask" อูมาสก์(2), "mknod", "mkdir".

การเรียกนี้ส่งคืน umask ก่อนหน้า

นับ
ยกเลิกการต่อเชื่อม
ตัวเลือก umount
umount pathordevice [บังคับ:จริง|เท็จ] [lazyunmount:จริง|เท็จ]

สิ่งนี้จะยกเลิกการต่อเชื่อมระบบไฟล์ที่กำหนด ระบบไฟล์อาจถูกระบุโดย
mountpoint (เส้นทาง) หรืออุปกรณ์ที่มีระบบไฟล์

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

umount-ทั้งหมด
ยกเลิกการต่อเชื่อมทั้งหมด
umount-ทั้งหมด

สิ่งนี้จะยกเลิกการต่อเชื่อมระบบไฟล์ที่เมาต์ทั้งหมด

การต่อเชื่อมภายในบางตัวจะไม่ถูกถอดออกโดยการโทรนี้

จำนวนท้องถิ่น
umount-local [ลองใหม่:จริง|เท็จ]

หาก libguestfs กำลังส่งออกระบบไฟล์บนจุดเชื่อมต่อในเครื่อง การดำเนินการนี้จะยกเลิกการต่อเชื่อม

ดู "MOUNT LOCAL" ใน แขก(3) สำหรับเอกสารฉบับเต็ม

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

แนบ
อัพโหลด (ชื่อไฟล์|-) remotefilename

อัปโหลดไฟล์ในเครื่อง ชื่อไฟล์ ไปยัง ชื่อไฟล์ระยะไกล บนระบบไฟล์

ชื่อไฟล์ สามารถเป็นไปป์ที่มีชื่อได้

ดูเพิ่มเติมที่ "ดาวน์โหลด"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

อัพโหลด-ออฟเซ็ต
upload-offset (ชื่อไฟล์|-) remotefilename offset

อัปโหลดไฟล์ในเครื่อง ชื่อไฟล์ ไปยัง ชื่อไฟล์ระยะไกล บนระบบไฟล์

ชื่อไฟล์ระยะไกล ถูกเขียนทับโดยเริ่มต้นที่ไบต์ "offset" ที่ระบุ ความตั้งใจคือ
เพื่อเขียนทับบางส่วนของไฟล์หรืออุปกรณ์ที่มีอยู่แม้ว่าไฟล์ที่ไม่มีอยู่จริงคือ
ระบุแล้วสร้างด้วย "รู" ก่อน "ออฟเซ็ต" ขนาดของข้อมูลที่เขียน
เป็นนัยในขนาดของแหล่งที่มา ชื่อไฟล์.

โปรดทราบว่าไม่มีการจำกัดจำนวนข้อมูลที่สามารถอัพโหลดได้ด้วยการโทรนี้
ไม่เหมือนกับ "pwrite" และการโทรนี้จะเขียนจำนวนเงินเต็มเสมอเว้นแต่จะเกิดข้อผิดพลาด

ดูเพิ่มเติมที่ "อัปโหลด", "เขียน"

ใช้ "-" แทนชื่อไฟล์เพื่ออ่าน/เขียนจาก stdin/stdout

ผู้ใช้ยกเลิก
ผู้ใช้ยกเลิก

ฟังก์ชันนี้จะยกเลิกการดำเนินการอัปโหลดหรือดาวน์โหลดปัจจุบัน

ไม่เหมือนกับการเรียก libguestfs อื่น ๆ ส่วนใหญ่ ฟังก์ชันนี้มีความปลอดภัยสำหรับสัญญาณและเธรดที่ปลอดภัย คุณสามารถ
เรียกจากตัวจัดการสัญญาณหรือจากเธรดอื่นโดยไม่ต้องทำการล็อคใด ๆ

การโอนที่กำลังดำเนินการอยู่ (ถ้ามี) จะหยุดหลังจากนั้นไม่นานและจะ
ส่งคืนข้อผิดพลาด errno (ดู "guestfs_last_errno") ถูกตั้งค่าเป็น "EINTR" เพื่อให้คุณสามารถทดสอบได้
สำหรับสิ่งนี้เพื่อดูว่าการดำเนินการถูกยกเลิกหรือล้มเหลวเนื่องจากข้อผิดพลาดอื่นหรือไม่

ไม่มีการล้างข้อมูล: ตัวอย่างเช่น หากไฟล์กำลังถูกอัปโหลด หลังจากยกเลิก
อาจมีไฟล์ที่อัปโหลดบางส่วน เป็นความรับผิดชอบของผู้โทรในการทำความสะอาดถ้า
จำเป็น

มีสองสถานที่ทั่วไปที่คุณอาจเรียกว่า "ผู้ใช้ยกเลิก":

ในโปรแกรมแบบข้อความแบบโต้ตอบ คุณอาจเรียกมันจากตัวจัดการสัญญาณ "SIGINT" ดังนั้น
การกด "^C" จะยกเลิกการทำงานปัจจุบัน (คุณต้องโทร .ด้วย
"guestfs_set_pgroup" เพื่อให้โปรเซสลูกไม่รับสัญญาณ "^C")

ในโปรแกรมกราฟิก เมื่อเธรดหลักแสดงแถบความคืบหน้าด้วยการยกเลิก
ให้ต่อสายปุ่มยกเลิกเพื่อเรียกใช้ฟังก์ชันนี้

เครื่องใช้
เส้นทางของยูทิลิตี้ atsecs atnsecs mtsecs mtnsecs

คำสั่งนี้ตั้งค่าการประทับเวลาของไฟล์ด้วยความแม่นยำระดับนาโนวินาที

"atsecs, atnsecs" เป็นเวลาเข้าถึงล่าสุด (atime) ในหน่วยวินาทีและนาโนวินาทีจากยุค

"mtsecs, mtnsecs" คือเวลาที่แก้ไขล่าสุด (mtime) ในหน่วยวินาทีและนาโนวินาทีจาก
ยุค.

หากฟิลด์ *nsecs มีค่าพิเศษ "-1" การประทับเวลาที่สอดคล้องกันคือ
ตั้งเวลาปัจจุบัน (ในกรณีนี้ ฟิลด์ *secs จะถูกละเว้น)

หากฟิลด์ *nsecs มีค่าพิเศษ "-2" การประทับเวลาที่สอดคล้องกันคือ
เหลือไม่เปลี่ยนแปลง (ในกรณีนี้ ฟิลด์ *secs จะถูกละเว้น)

นามสกุล
นามสกุล

ค่านี้จะส่งคืนเวอร์ชันเคอร์เนลของอุปกรณ์ซึ่งมีให้ใช้งาน นี้
ข้อมูลมีประโยชน์สำหรับการดีบักเท่านั้น ไม่มีสิ่งใดในโครงสร้างที่ส่งคืนถูกกำหนดโดย
API

รุ่น
รุ่น

ส่งคืนหมายเลขเวอร์ชัน libguestfs ที่โปรแกรมเชื่อมโยงอยู่

โปรดทราบว่าเนื่องจากการลิงก์แบบไดนามิกจึงไม่จำเป็นต้องเป็นเวอร์ชันของ libguestfs
ที่คุณรวบรวมไว้ คุณสามารถคอมไพล์โปรแกรม จากนั้นรันไทม์แบบไดนามิก
เชื่อมโยงกับความแตกต่างอย่างสิ้นเชิง libguestfs.so ห้องสมุด.

เพิ่มการโทรนี้ในเวอร์ชัน 1.0.58 ในเวอร์ชันก่อนหน้าของ libguestfs ไม่มี
วิธีรับหมายเลขเวอร์ชัน จากรหัส C คุณสามารถใช้ฟังก์ชันตัวเชื่อมโยงแบบไดนามิกเพื่อค้นหา
หากมีสัญลักษณ์นี้อยู่ (หากไม่มีแสดงว่าเป็นเวอร์ชันก่อนหน้า)

การเรียกส่งคืนโครงสร้างที่มีสี่องค์ประกอบ สามตัวแรก ("เอก", "รอง" และ
"ปล่อย") เป็นตัวเลขและตรงกับรุ่นแฝดสามรุ่นปกติ องค์ประกอบที่สี่
("พิเศษ") เป็นสตริงและปกติจะว่าง แต่อาจใช้สำหรับ distro-specific
ข้อมูล

ในการสร้างสตริงเวอร์ชันดั้งเดิม: "$major.$minor.$release$extra"

ดูเพิ่มเติม: "LIBGUESTFS VERSION NUMBERS" ใน แขก(3)

หมายเหตุ อย่าใช้การโทรนี้เพื่อทดสอบความพร้อมใช้งานของคุณสมบัติ ในองค์กร
การกระจายเราแบ็คพอร์ตคุณสมบัติจากรุ่นที่ใหม่กว่าไปเป็นรุ่นก่อนหน้าทำให้สิ่งนี้
วิธีทดสอบฟีเจอร์ที่ไม่น่าเชื่อถือ ใช้ "มี" หรือ "มีคุณลักษณะ" แทน

ป้าย vfs
ติดตั้งฉลาก vfs ได้

ซึ่งจะส่งคืนป้ายกำกับของระบบไฟล์ว่า "เมานท์ได้"

หากระบบไฟล์ไม่มีป้ายกำกับ จะคืนค่าสตริงว่าง

หากต้องการค้นหาระบบไฟล์จากป้ายกำกับ ให้ใช้ "findfs-label"

vfs-ขนาดต่ำสุด
ติดตั้ง vfs-minimum ได้

รับขนาดขั้นต่ำของระบบไฟล์เป็นไบต์ นี่คือขนาดต่ำสุดที่เป็นไปได้สำหรับ
ระบบไฟล์หดตัว

หากไม่รองรับการรับขนาดขั้นต่ำของระบบไฟล์ที่ระบุ จะล้มเหลวและตั้งค่า
errno เป็น ENOTSUP

ดูสิ่งนี้ด้วย ntfsปรับขนาด(8) ปรับขนาด2fs(8) btrfs(8) xfs_info(8)

vfs-ประเภท
ติดตั้งประเภท vfs ได้

คำสั่งนี้รับประเภทระบบไฟล์ที่สอดคล้องกับระบบไฟล์บน "เมานท์"

สำหรับระบบไฟล์ส่วนใหญ่ ผลลัพธ์จะเป็นชื่อของโมดูล Linux VFS ที่จะใช้
เพื่อเมานต์ระบบไฟล์นี้ หากคุณเมานต์โดยไม่ได้ระบุประเภทระบบไฟล์ สำหรับ
ตัวอย่างสตริงเช่น "ext3" หรือ "ntfs"

vfs-uuid
รับ uuid
ติดตั้ง vfs-uuid ได้

สิ่งนี้จะส่งคืน UUID ระบบไฟล์ของระบบไฟล์ใน "เมานท์"

หากระบบไฟล์ไม่มี UUID ค่านี้จะส่งคืนสตริงว่าง

หากต้องการค้นหาระบบไฟล์จาก UUID ให้ใช้ "findfs-uuid"

vg-เปิดใช้งาน
vg-activate จริง | เท็จ 'volgroups ...'

คำสั่งนี้เปิดใช้งานหรือ (หาก "เปิดใช้งาน" เป็นเท็จ) ปิดใช้งานโลจิคัลวอลุ่มทั้งหมดใน
รายชื่อกลุ่มวอลุ่ม "volgroups"

คำสั่งนี้เหมือนกับการรัน "vgchange -ay|n volgroups..."

โปรดทราบว่าหาก "volgroups" เป็นรายการที่ว่างเปล่า ทั้งหมด เปิดใช้งานกลุ่มวอลุ่มหรือ
ปิดการใช้งาน

vg-เปิดใช้งานทั้งหมด
vg-activate-all จริง|เท็จ

คำสั่งนี้เปิดใช้งานหรือ (หาก "เปิดใช้งาน" เป็นเท็จ) ปิดใช้งานโลจิคัลวอลุ่มทั้งหมดในทั้งหมด
กลุ่มวอลุ่ม

คำสั่งนี้เหมือนกับการรัน "vgchange -ay|n"

vgchange-uuid
vgchange-uuid vg

สร้าง UUID แบบสุ่มใหม่สำหรับกลุ่มวอลุ่ม "vg"

vgchange-uuid-ทั้งหมด
vgchange-uuid-ทั้งหมด

สร้าง UUID แบบสุ่มใหม่สำหรับกลุ่มวอลุ่มทั้งหมด

vgcreate
vgcreate volgroup 'physvols ...'

สิ่งนี้จะสร้างกลุ่มวอลุ่ม LVM ที่เรียกว่า "volgroup" จากรายการทางกายภาพ .ที่ไม่ว่างเปล่า
ปริมาณ "physvols"

vgluuids
vgluuids vgname

กำหนด VG ที่เรียกว่า "vgname" จะคืนค่า UUID ของโลจิคัลวอลุ่มทั้งหมดที่สร้างขึ้นใน
กลุ่มวอลุ่มนี้

คุณสามารถใช้สิ่งนี้ร่วมกับการเรียก "lvs" และ "lvuuid" เพื่อเชื่อมโยงโลจิคัลวอลุ่มและ
กลุ่มวอลุ่ม

ดูเพิ่มเติมที่ "vgpvuuids"

วีจีเมต้า
วีจีเมต้า vgname

"vgname" คือกลุ่มวอลุ่ม LVM คำสั่งนี้ตรวจสอบกลุ่มวอลุ่มและส่งคืน
ข้อมูลเมตา

โปรดทราบว่าข้อมูลเมตาเป็นโครงสร้างภายในที่ใช้โดย LVM อาจเปลี่ยนแปลงได้ที่
เวลาและจัดทำขึ้นเพื่อเป็นข้อมูลเท่านั้น

vgpvuuids
vgpvuuids vgname

กำหนด VG ที่เรียกว่า "vgname" ค่านี้จะส่งคืน UUID ของฟิสิคัลวอลุ่มทั้งหมดที่ this
กลุ่มวอลุ่มอยู่บน

คุณสามารถใช้สิ่งนี้ร่วมกับการเรียก "pvs" และ "pvuuid" เพื่อเชื่อมโยงฟิสิคัลวอลุ่มและ
กลุ่มวอลุ่ม

ดูเพิ่มเติมที่ "vgluuids"

vgremove
vgremove vgname

ลบกลุ่มวอลุ่ม LVM "vgname" (เช่น "VG")

นอกจากนี้ยังบังคับให้ลบโลจิคัลวอลุ่มทั้งหมดในกลุ่มวอลุ่ม (ถ้ามี)

vgrename
vgrename โวลกรุ๊ป newvolgroup

เปลี่ยนชื่อกลุ่มวอลุ่ม "volgroup" ด้วยชื่อใหม่ "newvolgroup"

ฯลฯ
ฯลฯ

แสดงรายการกลุ่มวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ ฯลฯ(8) คำสั่ง

ส่งคืนรายการเฉพาะชื่อกลุ่มวอลุ่มที่ตรวจพบ (เช่น "VolGroup00")

ดูเพิ่มเติมที่ "vgs-full"

vgs-เต็ม
vgs-เต็ม

แสดงรายการกลุ่มวอลุ่มทั้งหมดที่ตรวจพบ ซึ่งเทียบเท่ากับ ฯลฯ(8) คำสั่ง ดิ
เวอร์ชัน "เต็ม" รวมทุกช่อง

วีจีสแกน
วีจีสแกน

การดำเนินการนี้จะสแกนอุปกรณ์ที่ถูกบล็อกทั้งหมดอีกครั้ง และสร้างรายการฟิสิคัลวอลุ่ม LVM ใหม่ วอลุ่ม
กลุ่มและโลจิคัลวอลุ่ม

vguid
vguid vgname

คำสั่งนี้ส่งคืน UUID ของ LVM VG ชื่อ "vgname"

ห้องสุขา-ค
เส้นทาง wc-c

คำสั่งนี้นับอักขระในไฟล์ โดยใช้คำสั่งภายนอก "wc -c"

สุขา-ล
เส้นทาง wc-l

คำสั่งนี้นับบรรทัดในไฟล์ โดยใช้คำสั่งภายนอก "wc -l"

สุขา-ว
wc-w เส้นทาง

คำสั่งนี้นับคำในไฟล์ โดยใช้คำสั่งภายนอก "wc -w"

เช็ด
อุปกรณ์เช็ด

คำสั่งนี้จะลบระบบไฟล์หรือลายเซ็น RAID จาก "อุปกรณ์" ที่ระบุเพื่อสร้าง
ระบบไฟล์ที่ libblkid มองไม่เห็น

การดำเนินการนี้จะไม่ลบระบบไฟล์หรือข้อมูลอื่นใดออกจาก "อุปกรณ์"

เปรียบเทียบกับ "ศูนย์" ซึ่งเท่ากับศูนย์ในช่วงสองสามช่วงตึกแรกของอุปกรณ์

เขียน
เขียนเนื้อหาเส้นทาง

การเรียกนี้จะสร้างไฟล์ชื่อ "เส้นทาง" เนื้อหาของไฟล์เป็นสตริง "เนื้อหา"
(ซึ่งสามารถมีข้อมูล 8 บิตใดก็ได้)

ดูเพิ่มเติมที่ "เขียนต่อท้าย"

เขียนต่อท้าย
เนื้อหาเส้นทางต่อท้ายเขียน

การเรียกนี้จะต่อท้าย "เนื้อหา" ต่อท้ายไฟล์ "เส้นทาง" หากไม่มี "เส้นทาง" แสดงว่า
ไฟล์ใหม่ถูกสร้างขึ้น

ดูเพิ่มเติมที่ "เขียน"

เขียนไฟล์
ขนาดเนื้อหาเส้นทางเขียนไฟล์

การเรียกนี้จะสร้างไฟล์ชื่อ "เส้นทาง" เนื้อหาของไฟล์เป็นสตริง "เนื้อหา"
(ซึ่งสามารถมีข้อมูล 8 บิตใดก็ได้) โดยมี "ขนาด" ยาว

เป็นกรณีพิเศษ หาก "ขนาด" เป็น 0 ความยาวจะถูกคำนวณโดยใช้ "strlen" (เช่นในนี้
กรณีเนื้อหาไม่สามารถมี ASCII NUL ที่ฝังอยู่)

NB เนื่องจากข้อบกพร่อง การเขียนเนื้อหาที่มีอักขระ ASCII NUL ไม่ ไม่ ทำงานแม้ว่า
ความยาวถูกระบุ

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "เขียน" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

xfs-ผู้ดูแลระบบ
อุปกรณ์ xfs-admin [extunwrite:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [ป้ายกำกับ:..] [uuid:.. ]

เปลี่ยนพารามิเตอร์ของระบบไฟล์ XFS บน "อุปกรณ์"

อุปกรณ์ที่ติดตั้งแล้วไม่สามารถแก้ไขได้ ผู้ดูแลระบบต้องยกเลิกการต่อเชื่อมระบบไฟล์
ก่อนที่การโทรนี้จะแก้ไขพารามิเตอร์ได้

พารามิเตอร์บางตัวของระบบไฟล์ที่เมาต์สามารถตรวจสอบและแก้ไขได้โดยใช้
การเรียก "xfs-info" และ "xfs-growfs"

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

xfs-growfs
เส้นทาง xfs-growfs [datasec:true|false] [logsec:true|false] [rtsec:true|false] [datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]

ขยายระบบไฟล์ XFS ที่ติดตั้งที่ "เส้นทาง"

โครงสร้างที่ส่งคืนมีข้อมูลเรขาคณิต ฟิลด์ที่หายไปจะถูกส่งกลับเป็น "-1"
(สำหรับช่องตัวเลข) หรือสตริงว่าง

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

xfs-ข้อมูล
xfs-info อุปกรณ์พาธ

"pathordevice" คือระบบไฟล์ XFS ที่เมาท์หรืออุปกรณ์ที่มีระบบไฟล์ XFS นี้
คำสั่งส่งคืนเรขาคณิตของระบบไฟล์

โครงสร้างที่ส่งคืนมีข้อมูลเรขาคณิต ฟิลด์ที่หายไปจะถูกส่งกลับเป็น "-1"
(สำหรับช่องตัวเลข) หรือสตริงว่าง

xfs-ซ่อม
อุปกรณ์ซ่อมแซม xfs [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride: N] [logdev:..] [rtdev:..]

ซ่อมแซมระบบไฟล์ XFS ที่เสียหายหรือเสียหายใน "อุปกรณ์"

ระบบไฟล์ถูกระบุโดยใช้อาร์กิวเมนต์ "device" ซึ่งควรเป็นชื่ออุปกรณ์ของ
พาร์ติชั่นดิสก์หรือโวลุ่มที่มีระบบไฟล์ หากได้รับชื่อของบล็อก
อุปกรณ์ "xfs_repair" จะพยายามค้นหาอุปกรณ์ดิบที่เชื่อมโยงกับที่ระบุ
บล็อกอุปกรณ์และจะใช้อุปกรณ์ดิบแทน

ไม่ว่าระบบไฟล์ที่จะซ่อมแซมจะต้องถูก unmount มิฉะนั้นผลลัพธ์
ระบบไฟล์อาจไม่สอดคล้องหรือเสียหาย

สถานะที่ส่งคืนระบุว่าตรวจพบความเสียหายของระบบไฟล์ (ส่งคืน 1) หรือ
ตรวจไม่พบ (ส่งคืน 0)

คำสั่งนี้มีอาร์กิวเมนต์ที่เป็นทางเลือกอย่างน้อยหนึ่งอาร์กิวเมนต์ ดู "อาร์กิวเมนต์ที่ไม่บังคับ"

เซเกรป
เส้นทาง zegrep regex

สิ่งนี้เรียกโปรแกรม "zegrep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เซเกรปี
เส้นทาง zegrepi regex

สิ่งนี้เรียกโปรแกรม "zegrep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

เป็นศูนย์
อุปกรณ์ศูนย์

คำสั่งนี้เขียนเลขศูนย์ในช่วงสองสามบล็อกแรกของ "อุปกรณ์"

ไม่ได้ระบุจำนวนบล็อกที่เป็นศูนย์ (แต่มันคือ ไม่ เพียงพอที่จะเช็ด
อุปกรณ์). ควรจะเพียงพอที่จะลบตารางพาร์ติชั่นระบบไฟล์ superblocks
เป็นต้น

หากบล็อกมีค่าเป็นศูนย์อยู่แล้ว คำสั่งนี้จะหลีกเลี่ยงการเขียนเลขศูนย์ สิ่งนี้จะป้องกันไม่ให้
อุปกรณ์พื้นฐานไม่ให้กระจัดกระจายหรือเพิ่มขึ้นโดยไม่จำเป็น

ดูเพิ่มเติม: "zero-device", "scrub-device", "is-zero-device"

อุปกรณ์ศูนย์
อุปกรณ์ศูนย์

คำสั่งนี้เขียนเลขศูนย์บน "อุปกรณ์" ทั้งหมด เปรียบเทียบกับ "ศูนย์" ซึ่งเพียงแค่
ศูนย์สองสามช่วงตึกแรกของอุปกรณ์

หากบล็อกมีค่าเป็นศูนย์อยู่แล้ว คำสั่งนี้จะหลีกเลี่ยงการเขียนเลขศูนย์ สิ่งนี้จะป้องกันไม่ให้
อุปกรณ์พื้นฐานไม่ให้กระจัดกระจายหรือเพิ่มขึ้นโดยไม่จำเป็น

พื้นที่ว่างเป็นศูนย์
ไดเร็กทอรีพื้นที่ว่างเป็นศูนย์

ศูนย์พื้นที่ว่างในระบบไฟล์ที่ติดตั้งบน ไดเรกทอรี. ระบบไฟล์จะต้อง
ติดตั้งอ่าน-เขียน

เนื้อหาของระบบไฟล์จะไม่ได้รับผลกระทบ แต่พื้นที่ว่างในระบบไฟล์จะว่าง

พื้นที่ว่างไม่ได้ "ถูกตัดแต่ง" คุณอาจต้องการเรียก "fstrim" แทน
นี้หรือหลังจากเรียกสิ่งนี้ขึ้นอยู่กับความต้องการของคุณ

Zerofree
อุปกรณ์ Zerofree

สิ่งนี้ทำงาน Zerofree โปรแกรมบน "อุปกรณ์" โปรแกรมนี้อ้างว่าเป็นศูนย์ inodes ที่ไม่ได้ใช้และ
ดิสก์บล็อกบนระบบไฟล์ ext2/3 ทำให้สามารถบีบอัดระบบไฟล์ได้
มีประสิทธิภาพมากขึ้น

คุณควร ไม่ เรียกใช้โปรแกรมนี้หากติดตั้งระบบไฟล์

เป็นไปได้ว่าการใช้โปรแกรมนี้อาจทำให้ระบบไฟล์หรือข้อมูลบน .เสียหายได้
ระบบไฟล์

zfgrep
เส้นทางรูปแบบ zfgrep

สิ่งนี้เรียกโปรแกรม "zfgrep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ซฟเกรปิ
เส้นทางรูปแบบ zfgrepi

สิ่งนี้เรียกโปรแกรม "zfgrep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

zfile.zfile
zfile meth เส้นทาง

คำสั่งนี้ทำงาน ไฟล์ หลังจากคลาย "เส้นทาง" ครั้งแรกโดยใช้ "วิธีการ"

"เมธอด" ต้องเป็นหนึ่งใน "gzip", "compress" หรือ "bzip2"

ตั้งแต่ 1.0.63 ให้ใช้ "file" แทนซึ่งสามารถประมวลผลไฟล์บีบอัดได้

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "ไฟล์" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

กริป
เส้นทาง zgrep regex

สิ่งนี้เรียกโปรแกรม "zgrep" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

ซเกรปี
เส้นทาง zgrepi regex

สิ่งนี้เรียกโปรแกรม "zgrep -i" ภายนอกและส่งคืนบรรทัดที่ตรงกัน

เนื่องจากโปรโตคอลข้อความ จึงมีขีดจำกัดการถ่ายโอนระหว่าง 2MB และ
4MB. ดู "ข้อจำกัดของโปรโตคอล" ใน แขก(3)

แจกันดอกไม้โรแมนติกนี้ ฟังก์ชัน is เลิกใช้แล้ว ในรหัสใหม่ ใช้การเรียก "grep" แทน

ฟังก์ชันที่เลิกใช้แล้วจะไม่ถูกลบออกจาก API แต่แท้จริงแล้วคือ
เลิกใช้แสดงว่ามีปัญหากับการใช้ฟังก์ชันเหล่านี้อย่างถูกต้อง

EXIT สถานภาพ

guestfish คืนค่า 0 หากคำสั่งเสร็จสมบูรณ์โดยไม่มีข้อผิดพลาด หรือ 1 หากมีข้อผิดพลาด

และพวกเรา ตัวแปร

บรรณาธิการ
คำสั่ง "edit" ใช้ $EDITOR เป็นตัวแก้ไข หากไม่ได้ตั้งค่าไว้ จะใช้ "vi"

GUESTFISH_DISPLAY_IMAGE
คำสั่ง "display" ใช้ $GUESTFISH_DISPLAY_IMAGE เพื่อแสดงภาพ ถ้าไม่ตั้งไว้ก็
ใช้ รายการผลิตภัณฑ์(1)

GUESTFISH_INIT
พิมพ์เมื่อเริ่มต้น guestfish ดู "พร้อมท์"

GUESTFISH_OUTPUT
พิมพ์ก่อนส่งออกเกสต์ฟิช ดู "พร้อมท์"

GUESTFISH_PID
ใช้กับ --ระยะไกล ตัวเลือกเพื่อระบุกระบวนการ guestfish ระยะไกลเพื่อควบคุม ดู
ส่วน "การควบคุมระยะไกล GUESTFISH ผ่านซ็อกเก็ต"

GUESTFISH_PS1
ตั้งค่าพรอมต์คำสั่ง ดู "พร้อมท์"

GUESTFISH_คืนค่า
พิมพ์ก่อนที่ guestfish จะออก ดู "พร้อมท์"

เฮกซีดิเตอร์
คำสั่ง "hexedit" ใช้ $HEXEDITOR เป็นตัวแก้ไขฐานสิบหกภายนอก หากไม่ระบุ
ภายนอก เลขฐานสิบหก(1) ใช้โปรแกรม

หน้าหลัก
หากคอมไพล์ด้วยการสนับสนุน readline ของ GNU ไฟล์ต่างๆ ในโฮมไดเร็กตอรี่จะเป็น
ใช้แล้ว. ดู "ไฟล์"

LIBGUESTFS_APPEND
ส่งตัวเลือกเพิ่มเติมไปยังเคอร์เนลของแขก

LIBGUESTFS_ATTACH_METHOD
นี่เป็นวิธีเก่าในการตั้งค่า "LIBGUESTFS_BACKEND"

LIBGUESTFS_BACKEND
เลือกวิธีเริ่มต้นในการสร้างอุปกรณ์ ดู "guestfs_set_backend" ใน
แขก(3)

LIBGUESTFS_BACKEND_SETTINGS
รายการการตั้งค่าเฉพาะแบ็กเอนด์ที่คั่นด้วยเครื่องหมายทวิภาค ดู "แบ็กเอนด์" ใน แขก(3)
"การตั้งค่าแบ็กเอนด์" ใน แขก(3)

LIBGUESTFS_CACHEDIR
ตำแหน่งที่ libguestfs จะแคชอุปกรณ์เมื่อใช้ supermin
เครื่องใช้ อุปกรณ์ถูกแคชและแชร์ระหว่างแฮนเดิลทั้งหมดที่มี
ID ผู้ใช้ที่มีประสิทธิภาพ

หากไม่ได้ตั้งค่า "LIBGUESTFS_CACHEDIR" ระบบจะใช้ "TMPDIR" หากไม่ได้ตั้งค่า "TMPDIR"
แล้วก็ / var / tmp ถูกนำมาใช้.

ดูเพิ่มเติมที่ "LIBGUESTFS_TMPDIR", "set-cachedir"

LIBGUESTFS_DEBUG
ตั้งค่า "LIBGUESTFS_DEBUG=1" เพื่อเปิดใช้งานข้อความแบบละเอียด นี้มีผลเช่นเดียวกับ
โดยใช้โปรแกรม -v ตัวเลือก

LIBGUESTFS_HV
ตั้งค่าไบนารีไฮเปอร์ไวเซอร์เริ่มต้น (โดยปกติคือ qemu) ที่ libguestfs ใช้ ถ้าไม่ได้ตั้งค่า
จากนั้นใช้ qemu ซึ่งพบในเวลารวบรวมโดยสคริปต์กำหนดค่า

LIBGUESTFS_MEMSIZE
ตั้งค่าหน่วยความจำที่จัดสรรให้กับกระบวนการ qemu ในหน่วยเมกะไบต์ ตัวอย่างเช่น:

LIBGUESTFS_MEMSIZE=700

LIBGUESTFS_PATH
กำหนดเส้นทางที่ guestfish ใช้เพื่อค้นหาเคอร์เนลและ initrd.img ดู
อภิปรายเส้นทางใน แขก(3)

LIBGUESTFS_QEMU
นี่เป็นวิธีเก่าในการตั้งค่า "LIBGUESTFS_HV"

LIBGUESTFS_TMPDIR
ตำแหน่งที่ libguestfs จะเก็บไฟล์ชั่วคราวที่ใช้โดยแต่ละหมายเลขอ้างอิง

หากไม่ได้ตั้งค่า "LIBGUESTFS_TMPDIR" ระบบจะใช้ "TMPDIR" หากไม่ได้ตั้งค่า "TMPDIR"
แล้วก็ / Tmp ถูกนำมาใช้.

ดูเพิ่มเติมที่ "LIBGUESTFS_CACHEDIR", "set-tmpdir"

LIBGUESTFS_TRACE
ตั้งค่า "LIBGUESTFS_TRACE=1" เพื่อเปิดใช้งานการติดตามคำสั่ง

เพจเจอร์
คำสั่ง "more" ใช้ $PAGER เป็นเพจเจอร์ หากไม่ได้ตั้งค่า จะใช้ "เพิ่มเติม"

เส้นทาง
Libguestfs และ guestfish อาจเรียกใช้โปรแกรมภายนอกบางโปรแกรม และอาศัยการตั้งค่า $PATH
อย่างคุ้มค่า หากใช้แบ็กเอนด์ libvirt libvirt จะไม่ทำงานเลย
เว้นแต่ $PATH จะมีพาธของ qemu/KVM

SUPERMIN_KERNEL
SUPERMIN_KERNEL_VERSION
ซุปเปอร์มิน_โมดูล
ตัวแปรสภาพแวดล้อมทั้งสามนี้อนุญาตให้เคอร์เนลที่ libguestfs ใช้ใน
อุปกรณ์ที่จะเลือก หากไม่ได้ตั้งค่า $SUPERMIN_KERNEL แสดงว่าโฮสต์ล่าสุด
เคอร์เนลถูกเลือก สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเลือกเคอร์เนล โปรดดูที่ ซูเปอร์มิน(1)

ทีเอ็มพีดีอาร์
ดู "LIBGUESTFS_CACHEDIR", "LIBGUESTFS_TMPDIR"

ใช้ guestfish ออนไลน์โดยใช้บริการ onworks.net