این دستور guestfish است که می تواند در ارائه دهنده میزبانی رایگان OnWorks با استفاده از یکی از چندین ایستگاه کاری آنلاین رایگان مانند Ubuntu Online، Fedora Online، شبیه ساز آنلاین ویندوز یا شبیه ساز آنلاین MAC OS اجرا شود.
برنامه:
نام
guestfish - پوسته سیستم فایل مهمان
خلاصه
ماهی مهمان [--گزینه‌ها] [فرمان‌ها]
ماهی مهمان
guestfish [--ro|--rw] -a disk.img
guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]
guestfish -d libvirt-domain
guestfish [--ro|--rw] -a disk.img -i
guestfish -d libvirt-domain -i
هشدار
استفاده از "guestfish" در حالت نوشتن در ماشین های مجازی زنده یا همزمان با دیسک های دیگر
ابزارهای ویرایش می توانند خطرناک باشند و به طور بالقوه باعث خرابی دیسک شوند. ماشین مجازی
قبل از استفاده از این دستور باید خاموش شود و تصاویر دیسک نباید ویرایش شوند
همزمان
استفاده از --ro (فقط خواندنی) گزینه ای برای استفاده ایمن از "guestfish" در صورت تصویر دیسک یا مجازی
ممکن است دستگاه فعال باشد در صورت اجرا ممکن است نتایج عجیب یا متناقضی مشاهده کنید
همزمان با تغییرات دیگر، اما با این گزینه خطر خراب شدن دیسک را نخواهید داشت.
شرح
Guestfish یک ابزار پوسته و خط فرمان برای بررسی و اصلاح ماشین مجازی است
فایل سیستم ها از libguestfs استفاده می کند و تمام عملکردهای Guestfs API را نشان می دهد،
دیدن مهمانان(3).
Guestfish به شما دسترسی ساختاریافته به API libguestfs، از اسکریپت های پوسته یا
خط فرمان یا به صورت تعاملی اگر می خواهید یک تصویر ماشین مجازی شکسته را نجات دهید، شما
باید به فضیلت نجات(1) فرمان.
مثال ها
As an تعاملی صدف
ماهی مهمان دلار
به guestfish، پوسته فایل سیستم مهمان برای
ویرایش فایل سیستم های ماشین مجازی
تایپ کنید: "راهنما" برای لیستی از دستورات
"مرد" برای خواندن راهنما
"ترک" برای ترک پوسته
> add-ro disk.img
> اجرا کن
> لیست-فایل سیستم ها
/dev/sda1: ext4
/dev/vg_guest/lv_root: ext4
/dev/vg_guest/lv_swap: مبادله
> mount /dev/vg_guest/lv_root /
> گربه / etc / fstab
# / etc / fstab
# ایجاد شده توسط anaconda
[...]
> خروج
از جانب صدف اسکریپت
ایجاد یک جدید / و غیره / MOTD فایل در یک مهمان یا تصویر دیسک:
ماهی مهمان <<_EOF_
disk.img را اضافه کنید
اجرا
mount /dev/vg_guest/lv_root /
/etc/motd را بنویسید "کاربران جدید خوش آمدید"
_EOF_
حجم های منطقی LVM را در یک تصویر دیسک فهرست کنید:
guestfish -a disk.img --ro <<_EOF_
اجرا
lvs
_EOF_
لیست تمام سیستم های فایل در یک تصویر دیسک:
guestfish -a disk.img --ro <<_EOF_
اجرا
لیست-فایل سیستم ها
_EOF_
On یک فرمان خط
بروزرسانی /etc/resolv.conf در یک مهمان:
ماهی مهمان
افزودن disk.img : run : mount /dev/vg_guest/lv_root / :
نوشتن /etc/resolv.conf "نام سرور 1.2.3.4"
ویرایش /boot/grub/grub.conf به صورت تعاملی:
guestfish --rw --add disk.img
--mount /dev/vg_guest/lv_root
--mount /dev/sda1:/ boot
ویرایش /boot/grub/grub.conf
کوه دیسک ها بطور خودکار
استفاده از -i گزینه ای برای نصب خودکار دیسک ها از یک ماشین مجازی:
guestfish --ro -a disk.img -i cat / و غیره / گروه
guestfish --ro -d libvirt-domain -i cat / و غیره / گروه
راه دیگری برای ویرایش /boot/grub/grub.conf به صورت تعاملی است:
guestfish --rw -a disk.img -i ویرایش /boot/grub/grub.conf
As a خط مترجم
یک دیسک 100 مگابایتی حاوی یک پارتیشن با فرمت ext2 ایجاد کنید:
#!/usr/bin/guestfish -f
پراکنده test1.img 100M
اجرا
part-disk /dev/sda mbr
mkfs ext2 /dev/sda1
آغاز با a آماده شده دیسک
یک راه جایگزین برای ایجاد یک دیسک 100 مگابایتی به نام test1.img حاوی تک
پارتیشن با فرمت ext2:
guestfish -N fs
برای فهرست کردن موارد موجود انجام دهید:
guestfish -N کمک | کمتر
دور درایو
دسترسی به یک دیسک راه دور با استفاده از ssh:
guestfish -a ssh://example.com/path/to/disk.img
دور کنترل
eval "`guestfish -- listen"
guestfish -- remote add-ro disk.img
guestfish -- اجرا از راه دور
guestfish -- lvs راه دور
OPTIONS
--کمک
راهنمای کلی گزینه ها را نشان می دهد.
-h
--cmd-help
تمام دستورات guestfish موجود را فهرست می کند.
-h CMD
--cmd-help CMD
راهنمای دقیق را در یک فرمان "cmd" نشان می دهد.
-a تصویر
--اضافه کردن تصویر
یک دستگاه بلوک یا تصویر ماشین مجازی را به پوسته اضافه کنید.
فرمت تصویر دیسک به طور خودکار شناسایی می شود. برای نادیده گرفتن این و مجبور کردن a
فرمت خاص استفاده کنید --فرمت=.. گزینه.
استفاده از این پرچم بیشتر معادل استفاده از دستور "add" با "readonly:true" است.
اگر --ro پرچم داده شد، و با "قالب:..." اگر --فرمت=... پرچم داده شد.
-a URI
--اضافه کردن URI
یک دیسک راه دور اضافه کنید. به "افزودن حافظه از راه دور" مراجعه کنید.
-c URI
-- اتصال URI
هنگامی که همراه با استفاده می شود -d گزینه، این URI libvirt مورد استفاده را مشخص می کند.
پیش فرض استفاده از اتصال پیش فرض libvirt است.
--csh
در صورت استفاده از --گوش کن گزینه و یک پوسته csh مانند، از این گزینه استفاده کنید. بخش را ببینید
"کنترل از راه دور و CSH" در زیر.
-d libvirt-domain
--دامنه libvirt-domain
دیسک‌هایی را از دامنه libvirt با نام اضافه کنید. اگر --ro گزینه نیز استفاده می شود، سپس هر
دامنه libvirt قابل استفاده است. اما در حالت نوشتن، فقط دامنه های libvirt که هستند
shut down را می توان در اینجا نام برد.
UUID های دامنه را می توان به جای نام استفاده کرد.
استفاده از این پرچم بیشتر معادل استفاده از دستور «add-domain» است، با
"readonly:true" اگر --ro پرچم داده شد، و با "قالب:..." اگر --فرمت=...
پرچم داده شد.
---کلیدهای اکو
هنگام درخواست کلیدها و عبارات عبور، guestfish معمولاً اکو را خاموش می کند تا شما
نمی تواند ببیند چه چیزی تایپ می کنید. اگر نگران حملات طوفان نیستید و
هیچ کس دیگری در اتاق وجود ندارد که بتوانید این پرچم را مشخص کنید تا ببینید چه چیزی تایپ می کنید.
-f پرونده
--فایل پرونده
دستورات را از "فایل" بخوانید. برای نوشتن اسکریپت های خالص مهمان ماهی، از:
#!/usr/bin/guestfish -f
--format=raw|qcow2|..
--قالب
پیش فرض برای -a گزینه تشخیص خودکار فرمت تصویر دیسک است. استفاده كردن
این فرمت دیسک را برای -a گزینه هایی که در خط فرمان دنبال می شوند. استفاده كردن
--قالب بدون آرگومان به تشخیص خودکار برای موارد بعدی باز می گردد -a گزینه.
مثلا:
guestfish --format=raw -a disk.img
فرمت خام (بدون تشخیص خودکار) را برای disk.img.
guestfish --format=raw -a disk.img --format -a Another.img
فرمت خام (بدون تشخیص خودکار) را برای disk.img و به تشخیص خودکار برای
other.img.
اگر تصاویر دیسک مهمان با فرمت خام غیرقابل اعتماد دارید، باید از این گزینه استفاده کنید
فرمت دیسک را مشخص کنید با این کار از یک مشکل امنیتی احتمالی با مخرب جلوگیری می شود
مهمانان (CVE-2010-3851). همچنین به "افزودن" مراجعه کنید.
-i
-- بازرس
با استفاده از فضیلت بازرس(1) کد، دیسک ها را به دنبال یک سیستم عامل بازرسی کنید و
سیستم های فایل را همانطور که روی ماشین مجازی واقعی سوار می شوند، سوار کنید.
استفاده معمولی یکی از موارد زیر است:
guestfish -d myguest -i
(برای یک دامنه غیرفعال libvirt به نام مهمان من)، یا:
guestfish --ro -d myguest -i
(برای دامنه های فعال، فقط خواندنی)، یا دستگاه بلوک را مستقیماً مشخص کنید:
guestfish --rw -a /dev/Guests/MyGuest -i
توجه داشته باشید که دستور خط فرمان کمی نسبت به نسخه های قدیمی guestfish تغییر کرده است.
شما همچنان می توانید از نحو قدیمی استفاده کنید:
guestfish [--ro] -i disk.img
guestfish [--ro] -i libvirt-domain
استفاده از این پرچم بیشتر معادل استفاده از دستور "inspect-os" و سپس استفاده است
سایر دستورات برای مونت فایل سیستم های یافت شده.
--keys-from-stdin
پارامترهای کلید یا عبارت عبور را از stdin بخوانید. پیش فرض این است که سعی کنید بخوانید
عبارات عبور از کاربر با باز کردن /dev/tty.
--گوش کن
در پس زمینه فوک کنید و به دستورات از راه دور گوش دهید. بخش "کنترل از راه دور" را ببینید
FUESTFISH OVER A SOCKET" در زیر.
--زنده
به یک ماشین مجازی زنده متصل شوید. (تجربی، نگاه کنید به "اتصال به RUNNING DAEMONS"
in مهمانان(3).
-m dev[:mountpoint[:options[:fstype]]]
--کوه dev[:mountpoint[:options[:fstype]]]
پارتیشن نامگذاری شده یا حجم منطقی را روی نقطه اتصال داده شده نصب کنید.
اگر نقطه اتصال حذف شود، به طور پیش فرض روی آن تنظیم می شود /.
شما باید چیزی را روی آن نصب کنید / قبل از اینکه اکثر دستورات کار کنند.
در صورت وجود -m or --کوه گزینه ها داده می شود، مهمان به طور خودکار راه اندازی می شود.
اگر نمی‌دانید یک تصویر دیسک شامل چه سیستم‌هایی است، می‌توانید guestfish را اجرا کنید
بدون این گزینه، سپس پارتیشن ها، سیستم های فایل و LV های موجود را فهرست کنید (نگاه کنید به
دستورات "list-partitions"، "list-filesystems" و "lvs")، یا می توانید از
سیستم های فایل virt(1) برنامه
سومین قسمت (و به ندرت استفاده می شود) پارامتر mount لیست گزینه های mount است
برای نصب فایل سیستم زیرین استفاده می شود. اگر این داده نشده است، سپس گزینه های mount
یا رشته خالی هستند یا "ro" (اگر دومی --ro پرچم استفاده می شود). توسط
با تعیین گزینه های mount، این انتخاب پیش فرض را لغو می کنید. احتمالا تنها
زمانی که از آن استفاده می کنید فعال کردن ACL ها و/یا ویژگی های توسعه یافته در سیستم فایل است
می تواند از آنها حمایت کند:
-m /dev/sda1:/:acl,user_xattr
استفاده از این پرچم معادل استفاده از دستور "mount-options" است.
بخش چهارم پارامتر، درایور سیستم فایلی است که باید استفاده شود، مانند "ext3" یا
"ntfs". این به ندرت مورد نیاز است، اما اگر چندین درایور برای a معتبر باشد، می تواند مفید باشد
فایل سیستم (به عنوان مثال: "ext2" و "ext3")، یا اگر libguestfs یک سیستم فایل را اشتباه شناسایی کند.
--شبکه
شبکه کاربر QEMU را در مهمان فعال کنید.
-N [نام فایل=]نوع
--جدید [نام فایل=]نوع
-N کمک
یک تصویر دیسک تازه فرمت شده به عنوان "نوع" آماده کنید. این یک جایگزین برای -a
گزینه: در حالی که -a یک دیسک موجود را اضافه می کند، -N یک دیسک از پیش فرمت شده با a ایجاد می کند
فایل سیستم و آن را اضافه می کند. به "تصاویر آماده شده دیسک" در زیر مراجعه کنید.
-n
--بدون همگام سازی
همگام سازی خودکار را غیرفعال کنید. این به طور پیش فرض فعال است. بحث همگام سازی خودکار را در قسمت ببینید
مهمانان(3) manpage.
--بدون بهترین مسیرها
مسیرهای موجود در سیستم فایل مهمان را با برگه کامل نکنید. مفید است که بتوانید ضربه بزنید
کلید تب برای تکمیل مسیرها در سیستم فایل مهمان، اما این باعث "پنهان" اضافی می شود.
تماس‌های guestfs باید برقرار شود، بنابراین این گزینه برای غیرفعال کردن این ویژگی اینجا است.
- خطای لوله
اگر نوشته ها در اجرای دستورات شکست بخورند (به "PIPES" در زیر مراجعه کنید)، سپس دستور an را برمی گرداند
خطا.
پیش فرض (همچنین به دلایل تاریخی) نادیده گرفتن چنین خطاهایی است تا:
> فرمان_با_خروجی_های_زیاد | سر
خطا نمیده
--پیشرفت-نوارها
نوارهای پیشرفت را فعال کنید، حتی زمانی که ماهی مهمان به صورت غیر تعاملی استفاده می شود.
هنگامی که guestfish به عنوان یک پوسته تعاملی استفاده می شود، نوارهای پیشرفت به طور پیش فرض فعال می شوند.
--بدون پیشرفت میله
نوارهای پیشرفت را غیرفعال کنید
-- راه دور[=pid]
دستورات راه دور را به $GUESTFISH_PID یا "pid" ارسال کنید. بخش "کنترل از راه دور" را ببینید
FUESTFISH OVER A SOCKET" در زیر.
-r
--ro
این تغییر می کند -a, -d و -m گزینه هایی به طوری که دیسک ها اضافه شده و مانت ها انجام می شود
فقط خواندنی.
اگر تصویر دیسک یا ماشین مجازی ممکن است در حال اجرا باشد، همیشه باید از این گزینه استفاده شود.
و به طور کلی در مواردی که نیازی به دسترسی نوشتن به دیسک ندارید توصیه می شود.
توجه داشته باشید که تصاویر دیسک آماده ایجاد شده با -N تحت تأثیر این گزینه قرار نمی گیرند. همچنین
دستوراتی مانند "add" تحت تأثیر قرار نمی گیرند - باید گزینه "readonly:true" را مشخص کنید.
به صراحت اگر به آن نیاز دارید
همچنین به "باز کردن دیسک برای خواندن و نوشتن" در زیر مراجعه کنید.
--سلینوکس
پشتیبانی SELinux را برای مهمان فعال کنید. "SELINUX" را در مهمانان(3).
-v
-- پرحرف
پیام های بسیار پرمخاطب را فعال کنید. این به ویژه در صورت یافتن یک اشکال مفید است.
-V
- نسخه
نمایش شماره نسخه guestfish / libguestfs و خروج.
-w
--rw
این تغییر می کند -a, -d و -m گزینه هایی به طوری که دیسک ها اضافه شده و مانت ها انجام می شود
خواندن و نوشتن
"باز کردن دیسک برای خواندن و نوشتن" را در زیر ببینید.
-x هر دستور را قبل از اجرای آن تکرار کنید.
دستورات ON COMMAND LINE
هر آرگومان اضافی (غیر گزینه ای) به عنوان دستوری برای اجرا در نظر گرفته می شود.
دستورات برای اجرا باید با یک دونقطه (":") از هم جدا شوند، جایی که کولون جدا است
پارامتر. بدین ترتیب:
guestfish cmd [args...] : cmd [args...] : cmd [args...] ...
اگر هیچ آرگومان اضافی وجود نداشته باشد، وارد یک پوسته، یا یک پوسته تعاملی می‌شویم
با یک اعلان (اگر ورودی ترمینال باشد) یا یک پوسته غیر تعاملی.
در حالت خط فرمان یا پوسته غیر تعاملی، اولین دستوری که یک را می دهد
خطا باعث خروج کل پوسته می شود. در حالت تعاملی (با یک فرمان) اگر یک دستور
شکست می خورد، می توانید به وارد کردن دستورات ادامه دهید.
استفاده كردن راه اندازی (یا اجرا کن)
همانطور که با مهمانان(3)، ابتدا باید مهمان خود را با افزودن دیسک پیکربندی کنید، سپس آن را راه اندازی کنید.
سپس هر دیسکی را که نیاز دارید سوار کنید و در نهایت اکشن/فرمان ها را صادر کنید. بنابراین دستور کلی
روز است:
· افزودن یا -a/--افزودن
· راه اندازی (معروف به اجرا)
· mount یا -m/--mount
· هر دستور دیگری
"run" مترادف "راه اندازی" است. قبل از سوار شدن باید مهمان خود را "راه اندازی" کنید (یا "دو کنید").
یا انجام هر دستور دیگری
تنها استثنا این است که اگر هر یک از -i, -m, --کوه, -N or --جدید گزینه هایی داده شد
سپس "اجرا" به طور خودکار انجام می شود، صرفاً به این دلیل که guestfish نمی تواند عمل شما را انجام دهد
بدون انجام این کار درخواست کرد.
باز کردن دیسک ها برای خواندن و نوشتن
ماهی مهمان، میهمان میهمان(1) و فضیلت نجات(1) گزینه ها --ro و --rw بر اینکه آیا
سایر گزینه های خط فرمان -a, -c, -d, -i و -m باز کردن تصاویر دیسک فقط خواندنی یا برای
نوشته.
در libguestfs ≤ 1.10، guestfish، guestmount و virt-rescue برای باز کردن دیسک پیش‌فرض قرار گرفتند.
تصاویر ارائه شده در خط فرمان برای نوشتن. برای باز کردن یک تصویر دیسک فقط خواندنی باید این کار را انجام دهید
do -a تصویر --ro.
این مهم است: اگر به طور تصادفی یک تصویر دیسک VM زنده قابل نوشتن را باز کنید، باعث می‌شوید
خرابی غیر قابل برگشت دیسک
در libguestfs آینده ما قصد داریم پیش فرض را به روش دیگری تغییر دهیم. تصاویر دیسک خواهد بود
فقط خواندنی باز شد شما باید یکی را مشخص کنید ماهی مهمان --rw, میهمان میهمان --rw, مج-
نجات --rw، یا فایل پیکربندی را برای دسترسی به نوشتن تصاویر دیسک تغییر دهید
توسط آن گزینه های دیگر خط فرمان مشخص شده است.
این نسخه از guestfish، guestmount و virt-rescue دارای یک --rw گزینه ای که هیچ کاری نمی کند
(این قبلاً پیش فرض است). با این حال بسیار توصیه می شود که از این گزینه استفاده کنید
نشان دهید که به دسترسی نوشتن نیاز دارید و اسکریپت های خود را برای روزی که این گزینه وجود دارد آماده کنید
برای دسترسی نوشتن مورد نیاز خواهد بود.
توجه داشته باشید: این به این نه دستوراتی مانند "add" و "mount" یا هر libguestf دیگری را تحت تاثیر قرار می دهد
برنامه جدا از guestfish و guestmount.
نقل قول
شما می توانید پارامترهای معمولی را با استفاده از یک یا دو نقل قول نقل قول کنید. مثلا:
افزودن "فایل با یک space.img"
rm '/نام فایل'
rm '/"'
چند دستور نیاز به یک لیست از رشته ها برای ارسال دارند. برای این موارد، از یک فضای خالی استفاده کنید-
لیست جدا شده، محصور در نقل قول. رشته های حاوی فضای خالی برای عبور
باید در یک نقل قول محصور شود. از یک نقل قول تکی تحت اللفظی باید با a فرار کرد
بک اسلش
vgcreate VG "/dev/sda1 /dev/sdb1"
فرمان "/bin/echo "فو بار""
فرمان "/bin/echo \'فو\'"
فرار توالی IN دو برابر نقل شده ادله
در آرگومان های دوگانه نقل قول (فقط) از بک اسلش برای درج کاراکترهای خاص استفاده کنید:
"\آ"
شخصیت هشدار (زنگ).
"\b"
شخصیت Backspace
"\f"
شکل کاراکتر فید.
"\n"
کاراکتر خط جدید.
"\r"
کاراکتر برگشت کالسکه.
"\t"
کاراکتر برگه افقی.
"\v"
کاراکتر زبانه عمودی
"\"
یک کاراکتر نقل قول دوگانه تحت اللفظی.
"\ooo"
یک کاراکتر با ارزش هشتگانه OOO. باید دقیقاً 3 رقم اکتال وجود داشته باشد (برخلاف C).
"\xhh"
شخصیتی با ارزش هگز hh. باید دقیقاً 2 رقم هگزا وجود داشته باشد.
در اجرای فعلی "\000" و "\x00" را نمی توان در رشته ها استفاده کرد.
"\\"
یک شخصیت بک اسلش تحت اللفظی.
اختیاری ادله
برخی از دستورات آرگومان های اختیاری می گیرند. این استدلال ها در این مستندات به صورت ظاهر می شوند
"[argname:..]". می توانید مانند این مثال ها از آنها استفاده کنید:
اضافه کردن نام فایل
نام فایل فقط خواندنی:true را اضافه کنید
فرمت نام فایل را اضافه کنید: qcow2 فقط خواندنی: نادرست
هر آرگومان اختیاری می تواند حداکثر یک بار ظاهر شود. همه آرگومان های اختیاری باید بعد از آن ظاهر شوند
موارد مورد نیاز
شماره
این بخش برای تمام دستوراتی که می توانند اعداد صحیح را به عنوان پارامتر بگیرند اعمال می شود.
اندازه پسوند
هنگامی که فرمان پارامتری را می گیرد که بر حسب بایت اندازه گیری می شود، می توانید از یکی از موارد زیر استفاده کنید
پسوندهایی برای تعیین کیلوبایت، مگابایت و اندازه های بزرگتر:
k or K or کی بی
اندازه در کیلوبایت (ضرب در 1024).
KB اندازه در SI 1000 واحد بایت.
M or Eb
اندازه در مگابایت (ضرب در 1048576).
MB اندازه در SI 1000000 واحد بایت.
G or GIB
اندازه در گیگابایت (ضرب در 2**30).
GB اندازه در SI 10**9 واحد بایت.
T or TiB
اندازه در ترابایت (ضرب در 2**40).
TB اندازه در SI 10**12 واحد بایت.
P or PiB
اندازه در پتابایت (ضرب در 2**50).
PB اندازه در SI 10**15 واحد بایت.
E or EiB
اندازه در اگزابایت (ضرب در 2**60).
EB اندازه در SI 10**18 واحد بایت.
Z or ZiB
اندازه در زتابایت (ضرب در 2**70).
ZB اندازه در SI 10**21 واحد بایت.
Y or YiB
اندازه به یوتابایت (ضرب در 2**80).
YB اندازه در SI 10**24 واحد بایت.
مثلا:
truncate-size /file 1G
فایل را به 1 گیگابایت کوتاه می کند.
مراقب باشید زیرا تعداد کمی از دستورات بر حسب کیلوبایت یا مگابایت اندازه می گیرند (مثلاً پارامتر
به "memsize" قبلاً بر حسب مگابایت مشخص شده است). افزودن پسوند احتمالاً انجام نخواهد شد
آنچه شما انتظار دارید
OCTAL و هگزادسیمال شماره
برای تعیین ریشه (پایه) از قرارداد C استفاده کنید: 0 برای پیشوند یک عدد اکتال یا "0x"
برای قرار دادن پیشوند یک عدد هگزادسیمال. مثلا:
1234 عدد اعشاری 1234
02322 عدد اکتال، معادل اعشار 1234
عدد هگزادسیمال 0x4d2، معادل اعشار 1234
هنگام استفاده از دستور "chmod"، تقریباً همیشه می خواهید یک عدد اکتال برای آن مشخص کنید
حالت، و باید آن را با 0 پیشوند (بر خلاف یونیکس chmod(1) برنامه):
chmod 0777 /public # OK
chmod 777 /public # اشتباه است! این حالت 777 اعشاری = 01411 اکتال است.
دستوراتی که اعداد را برمی گرداند معمولاً آنها را به صورت اعشاری چاپ می کنند، اما برخی از دستورات چاپ می شوند
اعداد در رادهای دیگر (مثلاً "umask" حالت را به صورت هشتی چاپ می کند، قبل از 0).
WILDCARDS و GLOBBING
نه guestfish و نه Guestfs API زیربنایی، بسط علامت عام (globbing) توسط
پیش فرض بنابراین برای مثال موارد زیر آنچه را که انتظار دارید انجام نمی دهند:
rm-rf / خانه /*
با فرض اینکه دایرکتوری به نام تحت اللفظی ندارید / خانه /* سپس دستور بالا خواهد شد
یک خطا را برگرداند
برای انجام بسط عام، از دستور "glob" استفاده کنید.
glob rm-rf / خانه /*
"rm-rf" را در هر مسیری که مطابقت دارد اجرا می کند (یعنی به طور بالقوه دستور را چندین بار اجرا می کند)،
معادل:
rm-rf /home/jim
rm-rf /home/joe
rm-rf /home/mary
"glob" فقط در مسیرهای مهمان ساده کار می کند و روی نام دستگاه ها کار نمی کند.
اگر چندین پارامتر دارید که هر کدام شامل یک علامت عام است، glob یک را انجام می دهد
ضرب دکارتی.
نظرات
هر خطی که با a شروع شود # شخصیت به عنوان یک نظر در نظر گرفته می شود و نادیده گرفته می شود. در # می توان
به صورت اختیاری با فاصله سفید قبل از آن، اما نه توسط یک فرمان مثلا:
#این یک نظر است
#این یک نظر است
foo # نظری نیست
خطوط خالی نیز نادیده گرفته می شوند.
دویدن دستورات بطور محلی
هر خطی که با a شروع شود ! کاراکتر به عنوان یک فرمان ارسال شده به پوسته محلی در نظر گرفته می شود
(/ بن / شل یا هر چیز دیگری سیستم(3) موارد استفاده). مثلا:
!mkdir محلی
tgz-out /remote local/remote-data.tar.gz
یک دایرکتوری "local" در هاست ایجاد می کند و سپس محتویات آن را صادر می کند /از راه دور on
فایل سیستم نصب شده به local/remote-data.tar.gz. (به "tgz-out" مراجعه کنید).
برای تغییر دایرکتوری محلی، از دستور "lcd" استفاده کنید. "!cd" هیچ تاثیری نخواهد داشت، به دلیل
روشی که زیر فرآیندها در یونیکس کار می کنند.
محلی دستورات با INLINE اعدام
اگر یک خط با <! سپس دستور shell اجرا می شود (همانطور که برای !) اما متعاقبا
هر خروجی (stdout) فرمان پوسته تجزیه و به عنوان دستورهای guestfish اجرا می شود.
بنابراین شما می توانید از اسکریپت پوسته برای ساخت دستورات دلخواه guestfish استفاده کنید
تجزیه شده توسط ماهی مهمان
برای مثال، ایجاد یک سری فایل‌ها خسته‌کننده است (مثلاً. /foo.1 از طریق /foo.100)
با استفاده از دستورات guestfish به تنهایی. با این حال، اگر از یک اسکریپت پوسته برای ایجاد استفاده کنیم، این کار ساده است
ماهی مهمان برای ما دستور می دهد:
<! برای n در «دنباله 1 100»؛ echo نوشتن /foo.$n $n; انجام شده
یا با نام هایی مانند /foo.001:
<! برای n در «دنباله 1 100»؛ do printf "write /foo.%03d %d\n" $n $n; انجام شده
هنگام استفاده از guestfish به صورت تعاملی، می تواند مفید باشد که ابتدا اسکریپت پوسته را اجرا کنید
(یعنی کاراکتر "<" اولیه را حذف کنید تا یک کاراکتر معمولی باشد ! فرمان محلی)، ببینید چه چیزی
دستور guestfish اجرا میشود، و وقتی از آنها راضی هستید، «<» را اضافه کنید.
کاراکتر برای اجرای واقعی دستورات guestfish.
لوله های
از "فرمان" استفاده کنید | command" برای لوله کردن خروجی فرمان اول (یک ماهی مهمان
فرمان) به فرمان دوم (هر دستور میزبان). مثلا:
گربه / etc / passwd | awk -F: '$3 == 0 { print }'
(که در آن "cat" دستور گربه ماهی مهمان است، اما "awk" برنامه awk میزبان است). بالا
دستور تمام حساب‌های موجود در سیستم فایل مهمان را که دارای UID 0 هستند، فهرست میکند. ریشه
حساب ها از جمله درهای پشتی نمونه های دیگر:
هگزدامپ /bin/ls | سر
لیست-دستگاه | دم -1
tgz-out / - | tar ztf -
فضای قبل از نماد لوله مورد نیاز است، هر فاصله بعد از نماد لوله اختیاری است.
همه چیز بعد از نماد لوله مستقیماً به پوسته میزبان منتقل می شود، بنابراین می تواند
شامل تغییر مسیرها، glob و هر چیز دیگری که در سمت میزبان منطقی است.
برای استفاده از یک آرگومان تحت اللفظی که با نماد لوله شروع می شود، باید آن را نقل قول کنید، به عنوان مثال:
اکو "|"
صفحه اصلی دایرکتوری ها
اگر پارامتری با کاراکتر "~" شروع شود، ممکن است tilde به عنوان یک خانه گسترش یابد
مسیر دایرکتوری (یا "~" برای فهرست اصلی کاربر فعلی، یا "~user" برای دیگری
کاربر).
توجه داشته باشید که گسترش فهرست اصلی برای کاربران شناخته شده اتفاق می افتد on la میزبان، در مهمان نیست
فایل سیستم
برای استفاده از یک استدلال تحت اللفظی که با tilde شروع می شود، باید آن را نقل قول کنید، به عنوان مثال:
اکو "~"
رمزگذاری شده دیسک ها
Libguestfs برخی از مهمانان لینوکس را که بر اساس کلید یکپارچه لینوکس رمزگذاری شده اند، پشتیبانی می کند
استاندارد راه اندازی (LUKS) که تقریباً تمام سیستم های رمزگذاری دیسک مورد استفاده را شامل می شود
مهمانان مدرن لینوکس در حال حاضر فقط LVM-on-LUKS پشتیبانی می شود.
دستگاه ها و پارتیشن های بلوک رمزگذاری شده را با استفاده از "vfs-type" شناسایی کنید:
> vfs-type /dev/sda2
crypto_LUKS
سپس آن دستگاه ها را با استفاده از "luks-open" باز کنید. این یک دستگاه نقشه‌بردار دستگاه به نام ایجاد میکند
/dev/mapper/luksdev.
> luks-open /dev/sda2 luksdev
کلید یا عبارت عبور ("کلید") را وارد کنید:
در نهایت باید به LVM بگویید گروه‌های حجمی را در دستگاه نقشه‌بردار جدید ایجاد شده اسکن کند:
vgscan
vg-activate-all true
اکنون می توان حجم(های) منطقی را به روش معمول نصب کرد.
قبل از بستن یک دستگاه LUKS، باید ولوم های منطقی روی آن را جدا کرده و آن را غیرفعال کنید
با فراخوانی "vg-activate false VG" بر روی هر یک، گروه های حجم را گروه بندی کنید. سپس می توانید آن را ببندید
دستگاه نقشه کش:
vg-false /dev/VG را فعال کنید
luks-close /dev/mapper/luksdev
WINDOWS راه ها
اگر پیشوند یک مسیر با "win:" باشد، می توانید از حروف و مسیرهای درایو به سبک ویندوز استفاده کنید
(با برخی محدودیت ها). دستورات زیر معادل هستند:
فایل /WINDOWS/system32/config/system.LOG
فایل win:\windows\system32\config\system.log
فایل WIN:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG
با نگاه کردن به موقعیتی که درایو در آن قرار دارد، پارامتر "پشت صحنه" بازنویسی می شود
نصب شده است، و آن را در مسیر قرار می دهد و همه کاراکترهای بک اسلش را به جلو تغییر می دهد
اسلش کنید، سپس نتیجه را با استفاده از «مسیر حساس به حروف بزرگ» حل کنید. برای مثال اگر درایو E:
بر روی آن نصب شد /e سپس پارامتر ممکن است به صورت زیر بازنویسی شود:
win:e:\foo\bar => /e/FOO/bar
این فقط در موقعیت های استدلالی کار می کند که انتظار یک مسیر را دارند.
در حال آپلود و بارگیری فایل ها
برای دستوراتی مانند "upload"، "download"، "tar-in"، "tar-out" و موارد دیگر که آپلود می کنند
از یا دانلود به یک فایل محلی، می توانید از نام فایل ویژه "-" به معنای "از" استفاده کنید
stdin" یا "to stdout". برای مثال:
آپلود - /foo
stdin را می خواند و از آن یک فایل ایجاد می کند /فو در تصویر دیسک، و:
قیر کردن /و غیره - | tar tf -
tarball را در stdout می نویسد و سپس آن را به دستور خارجی "tar" وارد می کند (نگاه کنید به
"لوله های").
هنگام استفاده از "-" برای خواندن از stdin، ورودی تا انتهای stdin خوانده می شود. شما همچنین می توانید
از یک نحو خاص مانند "heredoc" برای خواندن برخی از نشانگرهای پایان دلخواه استفاده کنید:
آپلود -<
خط ورودی 1
خط ورودی 2
خط ورودی 3
END
هر رشته ای از کاراکترها را می توان به جای "END" استفاده کرد. نشانگر انتهایی باید روی a ظاهر شود
خط خودش، بدون هیچ کاراکتر قبلی یا بعدی (حتی فاصله).
توجه داشته باشید که نحو "-<<" فقط برای پارامترهای مورد استفاده برای آپلود فایل های محلی اعمال می شود (بنابراین
به نام پارامترهای "FileIn" در ژنراتور).
خروج ON ERROR رفتار - اخلاق
به‌طور پیش‌فرض، guestfish در حالت تعاملی (یعنی دریافت دستورات) خطاها را نادیده می‌گیرد
از یک انسان بیش از tty)، و در اولین خطا در حالت غیر تعاملی خارج می شود
(اسکریپت ها، دستورات داده شده در خط فرمان).
اگر یک دستور را با a پیشوند قرار دهید - کاراکتر، پس آن دستور باعث نمی شود که مهمان ماهی شود
exit، حتی اگر آن دستور (یکی) خطایی را برگرداند.
از راه دور کنترل ماهی مهمان بر فراز A سوکت
میهمان ماهی را می توان از راه دور از طریق یک سوکت کنترل کرد. این به ویژه در پوسته مفید است
اسکریپت هایی که می خواهید چندین تغییر مختلف در یک فایل سیستم ایجاد کنید، اما این کار را نمی کنید
هر بار برای راه اندازی یک فرآیند مهمان ماهی هزینه سربار را می خواهید.
یک فرآیند سرور مهمان ماهی را با استفاده از:
eval "`guestfish -- listen"
و سپس دستورات را با انجام زیر ارسال کنید:
guestfish --cmd راه دور [...]
برای خروج سرور، دستور exit را برای آن ارسال کنید:
guestfish -- خروج از راه دور
توجه داشته باشید که سرور معمولاً در صورت وجود خطایی در یک فرمان خارج می شود. تو می تونی تغییر کنی
این به روش معمول بخش "خروج از رفتار خطا" را ببینید.
کنترل چند برابر ماهی مهمان فرآیندها
عبارت "eval" متغیر محیطی $GUESTFISH_PID را تنظیم می کند، که اینگونه است
--از راه دور گزینه می داند دستورات را کجا ارسال کند. شما می توانید چندین شنونده مهمان ماهی داشته باشید
فرآیندهایی که با استفاده از:
eval "`guestfish -- listen"
pid1=$GUESTFISH_PID
eval "`guestfish -- listen"
pid2=$GUESTFISH_PID
...
guestfish --remote=$pid1 cmd
guestfish --remote=$pid2 cmd
از راه دور کنترل و CSH
هنگام استفاده از پوسته های csh مانند (csh، tcsh و غیره) باید آن را اضافه کنید --csh گزینه:
eval "` guestfish -- listen --csh`"
از راه دور کنترل جزئیات
کنترل از راه دور روی یک سوکت دامنه یونیکس به نام انجام می شود /tmp/.guestfish-$UID/socket-$PID,
که در آن $UID شناسه کاربر موثر فرآیند است و $PID شناسه فرآیند آن است
سرور
نسخه مشتری و سرور Guestfish باید دقیقاً مطابقت داشته باشند.
نسخه های قدیمی guestfish در برابر CVE-2013-4419 آسیب پذیر بودند (به "CVE-2013-4419" در
مهمانان(3)). این در نسخه فعلی رفع شده است.
استفاده كردن از راه دور کنترل قوی از پوسته اسکریپت ها
از Bash می توانید از کد زیر استفاده کنید که نمونه guestfish را به درستی ایجاد می کند
خط فرمان را نقل‌قول میکند، عدم شروع را مدیریت میکند، و هنگام اسکریپت، guestfish را پاک میکند
خروج:
#!/ bin / bash -
تنظیم -e
guestfish[0]="مهمان ماهی"
guestfish[1]="--listen"
guestfish[2]="--ro"
guestfish[3]="-a"
guestfish[4]="disk.img"
GUESTFISH_PID=
ارزش $("${guestfish[@]}")
اگر [ -z "$GUESTFISH_PID" ]; سپس
echo "خطا: guestfish راه اندازی نشد، پیام های خطا را در بالا ببینید"
خروج 1
fi
cleanup_guestfish ()
{
guestfish --remote -- خروج >/dev/null 2>&1 ||:
}
trap cleanup_guestfish EXIT ERR
guestfish -- راه دور -- اجرا شود
#...
از راه دور کنترل میکند نه کار با -a ETC OPTIONS
گزینه هایی مانند -a, --اضافه کردن, -N, --جدید و غیره به درستی با پشتیبانی از راه دور تعامل ندارند.
آنها به صورت محلی پردازش می شوند و به ماهی مهمان از راه دور ارسال نمی شوند. به خصوص
این چیزی را که شما انتظار دارید انجام نمی دهد:
guestfish --remote --add disk.img
از این گزینه ها استفاده نکنید به جای آن از دستورات معادل استفاده کنید، به عنوان مثال:
guestfish -- remote add-drive disk.img
و یا:
ماهی مهمان -- از راه دور
> disk.img را اضافه کنید
از راه دور کنترل RUN COMMAND به دار آویختن
استفاده از دستور "run" (یا "راه اندازی") از راه دور در یک زمینه جایگزینی دستور قطع می شود،
یعنی انجام نده (به نقل قول ها توجه کن):
a=`ماهی مهمان -- اجرا از راه دور`
از آنجایی که دستور "run" هیچ خروجی در stdout تولید نمی کند، به هر حال این کار مفید نیست. برای
اطلاعات بیشتر را ببینید https://bugzilla.redhat.com/show_bug.cgi?id=592910.
آماده شده خطر تصاویر
استفاده از -N [نام فایل=]نوع or --جدید [نام فایل=]نوع پارامتر برای انتخاب یکی از مجموعه ای از
تصاویر دیسک از پیش فرمت شده ای که guestfish می تواند برای شما بسازد تا در تایپ صرفه جویی کنید. این هست
به ویژه برای اهداف آزمایش مفید است. این گزینه به جای استفاده می شود -a گزینه،
و دوست دارم -a می تواند چندین بار ظاهر شود (و می تواند با -a).
دیسک جدید نامیده می شود test1.img برای اولین بار -N, test2.img برای دوم و غیره
فایل های موجود در فهرست فعلی هستند رونویسی شده است. می توانید از نام فایل دیگری استفاده کنید
با مشخص کردن "filename=" قبل از نوع (نمونه های زیر را ببینید).
نوع به طور خلاصه توضیح می دهد که چگونه دیسک باید اندازه شود، پارتیشن بندی شود، چگونه سیستم فایل (های)
باید ایجاد شود، و چگونه محتوا باید اضافه شود. به صورت اختیاری می توان نوع را دنبال کرد
با پارامترهای اضافی که با کاراکترهای ":" (دونقطه) از هم جدا شده اند. مثلا، -N fs ایجاد یک
100 مگابایت پیش‌فرض، دیسک پراکنده، حاوی یک پارتیشن، با پارتیشن
فرمت شده به صورت ext2. -N fs:ext4:1G یکسان است، اما برای یک فایل سیستم ext4 روی یک دیسک 1 گیگابایتی
به جای آن.
توجه داشته باشید که فایل سیستم آماده شده مانت نشده است. معمولاً باید از آن استفاده کنید
دستور "mount /dev/sda1 /" یا اضافه کردن دستور -m / dev / sda1 گزینه.
در صورت وجود -N or --جدید گزینه های داده شده، دستگاه libguestfs به طور خودکار راه اندازی می شود.
مثال ها
یک دیسک 100 مگابایتی با یک پارتیشن با فرمت ext4 به نام ایجاد کنید test1.img در حال حاضر
دایرکتوری:
guestfish -N fs:ext4
یک دیسک 32 مگابایتی با یک پارتیشن با فرمت VFAT ایجاد کنید و آن را نصب کنید:
guestfish -N fs:vfat:32M -m /dev/sda1
یک دیسک 200 مگابایتی خالی بسازید:
guestfish -N دیسک:200M
یک دیسک 200 مگابایتی خالی به نام ایجاد کنید blankdisk.img (بجای test1.img):
guestfish -N blankdisk.img=disk:200M
-N دیسک - ایجاد a سفید دیسک
"ماهی مهمان -N [نام فایل=]دیسک[:اندازه]"
یک دیسک خالی با اندازه 100 مگابایت (به طور پیش فرض) ایجاد کنید.
اندازه پیش فرض را می توان با ارائه یک پارامتر اختیاری تغییر داد.
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
اندازه 100M اندازه تصویر دیسک
-N بخش - ایجاد a تقسیم شده دیسک
"ماهی مهمان -N [نام فایل=]قسمت[:اندازه[:پارتیشن]]"
یک دیسک با یک پارتیشن ایجاد کنید. به طور پیش فرض اندازه دیسک 100 مگابایت است
فضای موجود در پارتیشن کمی کوچکتر خواهد بود) و جدول پارتیشن خواهد بود
MBR (سبک DOS قدیمی) باشد.
این پیش فرض ها را می توان با ارائه پارامترهای اختیاری تغییر داد.
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
اندازه 100M اندازه تصویر دیسک
پارتیشن mbr نوع جدول پارتیشن
-N fs - ایجاد a سیستم فایل
"ماهی مهمان -N [filename=]fs[:filesystem[:size[:partition]]]"
یک دیسک با یک پارتیشن واحد ایجاد کنید که پارتیشن حاوی یک فایل سیستم خالی باشد.
این به طور پیش فرض برای ایجاد یک دیسک 100 مگابایتی است (فضای موجود در سیستم فایل a
کمی کوچکتر) با یک جدول پارتیشن MBR (به سبک DOS قدیمی) و یک سیستم فایل ext2.
این پیش فرض ها را می توان با ارائه پارامترهای اختیاری تغییر داد.
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
فایل سیستم ext2 نوع فایل سیستم مورد استفاده
اندازه 100M اندازه تصویر دیسک
پارتیشن mbr نوع جدول پارتیشن
-N lv - ایجاد a دیسک با منطقی حجم
"ماهی مهمان -N [filename=]lv[:name[:size[:partition]]]"
یک دیسک با یک پارتیشن ایجاد کنید، پارتیشن را به عنوان یک حجم فیزیکی LVM2 تنظیم کنید،
و یک گروه حجمی و حجم منطقی را در آنجا قرار دهید. این به طور پیش فرض برای ایجاد یک 100 مگابایت است
دیسک با VG و LV به نام "/dev/VG/LV". شما می توانید نام VG و LV را تغییر دهید
ارائه یک نام جایگزین به عنوان اولین پارامتر اختیاری.
توجه داشته باشید که این یک فایل سیستم ایجاد نمی کند. برای این کار از lvfs استفاده کنید.
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
نام /dev/VG/LV نام VG و LV مورد استفاده
اندازه 100M اندازه تصویر دیسک
پارتیشن mbr نوع جدول پارتیشن
-N lvfs - ایجاد a دیسک با منطقی حجم و سیستم فایل
"ماهی مهمان -N [filename=]lvfs[:name[: filesystem[:size[:partition]]]]"
یک دیسک با یک پارتیشن ایجاد کنید، پارتیشن را به عنوان یک حجم فیزیکی LVM2 تنظیم کنید،
و یک گروه حجمی و حجم منطقی را در آنجا قرار دهید. سپس LV را با a فرمت کنید
فایل سیستم این به طور پیش فرض ایجاد یک دیسک 100 مگابایتی با VG و LV نامیده می شود
"/dev/VG/LV"، با یک سیستم فایل ext2.
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
نام /dev/VG/LV نام VG و LV مورد استفاده
فایل سیستم ext2 نوع فایل سیستم مورد استفاده
اندازه 100M اندازه تصویر دیسک
پارتیشن mbr نوع جدول پارتیشن
-N بوتروت - ایجاد a پوتین و ریشه سیستم فایل
"ماهی مهمان -N [filename=]bootroot[:bootfs[:rootfs[:size[:bootsize[:partition]]]]]"
یک دیسک با دو پارتیشن برای فایل سیستم بوت و ریشه ایجاد کنید. این دو را فرمت کنید
فایل سیستم ها به طور مستقل چندین پارامتر اختیاری وجود دارد که دقیق را کنترل می کند
طرح بندی و انواع سیستم فایل
پارامترهای اختیاری عبارتند از:
نام مقدار پیش فرض
bootfs ext2 نوع فایل سیستمی که برای بوت استفاده می شود
rootfs ext2 نوع فایل سیستمی که برای روت استفاده می شود
اندازه 100M اندازه تصویر دیسک
bootsize 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 نوع فایل سیستمی که برای روت استفاده می شود
اندازه 100M اندازه تصویر دیسک
bootsize 32M به اندازه فایل سیستم بوت
پارتیشن mbr نوع جدول پارتیشن
اضافه كردن از راه دور ذخیره سازی
برای سطح API مستندات on این موضوع، دیدن "guestfs_add_drive_opts" in مهمانان(3) و
"از راه دور ذخیره سازی" in مهمانان(3).
در خط فرمان می توانید از -a گزینه ای برای اضافه کردن دستگاه های بلوک شبکه با استفاده از URI-
قالب سبک، به عنوان مثال:
guestfish -a ssh://root@example.com/disk.img
URI ها نمی توان با دستور "افزودن" استفاده شود. دستور معادل با استفاده از API به طور مستقیم
است:
> افزودن /disk.img پروتکل:ssh سرور:tcp:example.com نام کاربری:root
ممکن -a URI فرمت ها در زیر توضیح داده شده است.
-a disk.img
-a file:///path/to/disk.img
تصویر دیسک محلی (یا دستگاه) نامیده شده را اضافه کنید disk.img.
-a ftp://[user@]example.com[:port]/disk.img
-a ftps://[user@]example.com[:port]/disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp://[user@]example.com[:port]/disk.img
دیسکی را که روی یک سرور FTP، HTTP یا TFTP راه دور قرار دارد اضافه کنید.
دستور API معادل این خواهد بود:
> پروتکل /disk.img را اضافه کنید:(ftp|...) server:tcp:example.com
-a gluster://example.com[:port]/volname/image
یک تصویر دیسک واقع در حافظه GlusterFS اضافه کنید.
سرور سروری است که "glusterd" را اجرا می کند و ممکن است "localhost" باشد.
دستور API معادل این خواهد بود:
> پروتکل volname/image: gluster server:tcp:example.com را اضافه کنید
-a iscsi://example.com[:port]/target-iqn-name[/lun]
یک دیسک واقع در سرور iSCSI اضافه کنید.
دستور API معادل این خواهد بود:
> target-iqn-name/lun protocol:iscsi server:tcp:example.com را اضافه کنید
-a nbd://example.com[:port]
-a nbd://example.com[:port]/exportname
-a nbd://?socket=/socket
-a nbd:///exportname?socket=/socket
دیسکی را که در ذخیره‌سازی دستگاه بلوک شبکه (nbd) قرار دارد اضافه کنید.
La /exportname بخشی از URI یک نام صادراتی NBD را مشخص می کند، اما معمولاً خالی می ماند.
اختیاری ?سوکت پارامتر را می توان برای تعیین سوکت دامنه یونیکس که با آن صحبت می کنیم استفاده کرد
سرور NBD تمام شد. توجه داشته باشید که نمی توانید نام سرور (یعنی TCP/IP) و مسیر سوکت را با هم ترکیب کنید.
دستور API معادل (بدون نام صادراتی):
> افزودن "" protocol:nbd سرور:[tcp:example.com|unix:/socket]
-a rbd:///pool/disk
-a rbd://example.com[:port]/pool/disk
یک تصویر دیسک واقع در حجم ذخیره سازی Ceph (RBD/librbd) اضافه کنید.
اگرچه libguestfs و Ceph از چندین سرور پشتیبانی می کنند، تنها یک سرور می تواند باشد
هنگام استفاده از این نحو URI مشخص شده است.
دستور API معادل این خواهد بود:
> pool/disk protocol:rbd server:tcp:example.com:port را اضافه کنید
-a sheepdog://[example.com[:port]]/volume/image
یک تصویر دیسکی که روی یک جلد Sheepdog قرار دارد اضافه کنید.
نام سرور اختیاری است. اگرچه libguestfs و Sheepdog از چندین سرور پشتیبانی می کنند،
هنگام استفاده از این نحو URI، حداکثر یک سرور را می توان مشخص کرد.
دستور API معادل این خواهد بود:
> افزودن پروتکل حجم: sheepdog [server:tcp:example.com]
-a ssh://[user@]example.com[:port]/disk.img
اضافه کردن یک تصویر دیسک واقع در یک سرور راه دور، که با استفاده از پوسته امن (ssh) SFTP قابل دسترسی است.
پروتکل SFTP خارج از جعبه توسط تمام سرورهای اصلی SSH پشتیبانی می شود.
دستور API معادل این خواهد بود:
> افزودن /پروتکل دیسک:ssh سرور:tcp:example.com [نام کاربری:user]
پیش رفتن بارها
برخی (نه همه) فرمان های طولانی مدت پیام های اعلان پیشرفت را همانطور که هستند ارسال می کنند
در حال اجرا Guestfish این پیام ها را به نوارهای پیشرفت تبدیل می کند.
زمانی که دستوری که از نوارهای پیشرفت پشتیبانی می کند بیش از دو ثانیه طول می کشد تا اجرا شود و اگر
نوارهای پیشرفت فعال هستند، سپس یکی را در زیر فرمان خواهید دید:
> اندازه کپی /large-file /another-file 2048M
/ 10% [#####---------------------------------------- ] 00:30
چرخنده در سمت چپ برای هر اعلان پیشرفت یک بار حرکت می کند
دریافت شده از باطن این یک اطمینان (معقولانه) طلایی است که فرمان چنین است
"انجام کاری" حتی اگر نوار پیشرفت حرکت نکند، زیرا فرمان قادر است
اعلان های پیشرفت را ارسال کنید وقتی نوار به 100% رسید و فرمان تمام شد،
اسپینر ناپدید می شود
هنگامی که guestfish به صورت تعاملی استفاده می شود، نوارهای پیشرفت به طور پیش فرض فعال می شوند. می توانید فعال کنید
آنها را حتی برای حالت های غیر تعاملی با استفاده از --پیشرفت-نوارهاو می توانید آنها را غیرفعال کنید
کاملا با استفاده از --بدون پیشرفت میله.
سریع
می توانید رنگ ها را به دستور پیش فرض تغییر دهید یا اضافه کنید ("> ") با تنظیم
متغیر محیطی "GUESTFISH_PS1". رشته دوم ("GUESTFISH_OUTPUT") چاپ می شود
پس از وارد شدن دستور و قبل از خروجی، به شما امکان می دهد تا کنترل کنید
رنگ خروجی رشته سوم ("GUESTFISH_INIT") قبل از استقبال چاپ می شود
پیام، به شما امکان می دهد رنگ آن پیام را کنترل کنید. یک رشته چهارم
("GUESTFISH_RESTORE") قبل از خروج ماهی مهمان چاپ می شود.
با تنظیم "GUESTFISH_PS1" روی یک رشته جایگزین می توان یک دستور ساده تنظیم کرد:
$ GUESTFISH_PS1='(یک فرمان را تایپ کنید) '
$ صادرات GUESTFISH_PS1
ماهی مهمان دلار
[...]
(یک فرمان را تایپ کنید) ▂
همانطور که در جدول زیر توضیح داده شده است، می توانید از دنباله های فرار ویژه نیز استفاده کنید:
\\ یک کاراکتر بک اسلش تحت اللفظی.
\[
\] (اینها فقط باید در "GUESTFISH_PS1" استفاده شوند.)
نویسه‌های غیرچاپ (مثلاً کدهای کنترل ترمینال برای رنگ‌ها) را بین آنها قرار دهید
"\[...\]". این چه کاری انجام می دهد تا به آن بگوید خط خواندن(3) کتابخانه ای که باید آن را درمان کند
این دنباله به عنوان عرض صفر است، به طوری که نمایش مجدد خط فرمان، ویرایش و غیره کار می کند.
\a شخصیت زنگی.
\e یک کاراکتر ASCII ESC (فرار).
\n خط جدید.
بازگشت کالسکه.
\ 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
"راه اندازی سریع" ویندوز 8 می تواند از نصب پارتیشن های NTFS توسط guestfish جلوگیری کند. دیدن
"WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP" در مهمانان(3).
ماهی مهمان دستورات
دستورات این بخش دستورات راحت مهمان ماهی هستند و به عبارت دیگر هستند
بخشی از مهمانان(3) API.
کمک
کمک
cmd کمک کنید
بدون هیچ پارامتری، این کمک کلی را ارائه می دهد.
با یک پارامتر "cmd"، این راهنمای دقیق برای آن دستور را نمایش می دهد.
خروج
ترک
این از ماهی مهمان خارج می شود. همچنین می توانید از کلید "^D" استفاده کنید.
اختصاص دهید
اختصاص دادن
اندازه نام فایل alloc
این یک فایل خالی (صفر شده) با اندازه داده شده ایجاد می کند، و سپس اضافه می کند تا بتواند بیشتر شود
بررسی شده است.
برای ایجاد تصویر پیشرفته تر، به "ایجاد دیسک" مراجعه کنید.
اندازه را می توان با استفاده از پسوندهای استاندارد مشخص کرد، به عنوان مثال. "1M".
برای ایجاد یک فایل پراکنده، به جای آن از "sparse" استفاده کنید. برای ایجاد یک تصویر دیسک آماده شده، نگاه کنید
"تصاویر دیسک آماده".
کپی کردن
کپی در محلی [محلی ...] /remotedir
"copy-in" فایل ها یا دایرکتوری های محلی را به صورت بازگشتی در تصویر دیسک کپی می کند و آنها را قرار می دهد
در دایرکتوری به نام /remotedir (که باید وجود داشته باشد). این متا فرمان ماهی مهمان می چرخد
به دنباله ای از "tar-in" و سایر دستورات در صورت لزوم.
چندین فایل محلی و دایرکتوری را می توان مشخص کرد، اما آخرین پارامتر همیشه باید باشد
یک دایرکتوری راه دور باشد نمی توان از حروف عامیانه استفاده کرد.
کپی کردن
کپی کردن از راه دور [راه دور ...] localdir
"copy-out" فایل ها یا دایرکتوری های راه دور را به صورت بازگشتی از تصویر دیسک کپی می کند و قرار می دهد.
آنها را بر روی دیسک میزبان در یک فهرست محلی به نام "localdir" (که باید وجود داشته باشد). این
متا فرمان guestfish به دنباله ای از "دانلود"، "tar-out" و دستورات دیگر تبدیل می شود.
در صورت لزوم.
چندین فایل و فهرست راه دور را می توان مشخص کرد، اما آخرین پارامتر همیشه باید باشد
یک فهرست محلی باشد. برای دانلود در فهرست فعلی، از "." همانطور که در:
کپی کردن / صفحه اصلی .
حروف عام را نمی توان در دستور معمولی استفاده کرد، اما می توانید با کمک از آنها استفاده کنید
"کره" مانند این:
گلوب کپی کردن / خانه /*
حذف رویداد
حذف نام رویداد
کنترل کننده رویداد را که قبلاً به عنوان "نام" ثبت شده بود حذف کنید. اگر چند رویداد
کنترل کننده ها با همین نام ثبت شده اند، همه آنها حذف شده اند.
دستورهای guestfish "رویداد" و "list-events" را نیز ببینید.
نمایش
نمایش نام فایل
برای نمایش فایل تصویری از "نمایش" (برنامه نمایش گرافیکی) استفاده کنید. آن را دانلود می کند
فایل، و "نمایش" را روی آن اجرا می کند.
برای استفاده از یک برنامه جایگزین، متغیر محیطی "GUESTFISH_DISPLAY_IMAGE" را تنظیم کنید.
به عنوان مثال برای استفاده از برنامه نمایش گنوم:
صادرات GUESTFISH_DISPLAY_IMAGE=eog
همچنین مشاهده کنید نمایش(1).
از دست
اکو [پارامس ...]
این پارامترها را به ترمینال بازتاب می دهد.
ویرایش کنید
vi
ایمکس
ویرایش نام فایل
این برای ویرایش یک فایل استفاده می شود. این فایل را دانلود می کند، آن را به صورت محلی با استفاده از ویرایشگر شما ویرایش می کند،
سپس نتیجه را آپلود می کند.
ویرایشگر $EDITOR است. با این حال اگر از دستورات جایگزین "vi" یا "emacs" استفاده کنید، این کار را خواهید کرد
آن ویراستاران مربوطه را دریافت کنید.
واقعه
نام رویداد رویدادهای "اسکریپت پوسته ..."
یک قطعه اسکریپت پوسته را که هنگام بالا آمدن یک رویداد اجرا می شود، ثبت کنید. دیدن
"guestfs_set_event_callback" در مهمانان(3) برای بحث در مورد رویداد API در
libguestfs.
پارامتر "name" نامی است که به این کنترل کننده رویداد می دهید. این می تواند هر رشته ای باشد
(حتی رشته خالی) و به سادگی وجود دارد، بنابراین می توانید با استفاده از آن، کنترل کننده را حذف کنید
دستور "حذف-رویداد" guestfish.
پارامتر "eventset" لیستی از یک یا چند رویداد است که با کاما از هم جدا شده اند
"نزدیک" یا "نزدیک، ردیابی". مقدار ویژه "*" به معنای همه رویدادها است.
سومین و آخرین پارامتر قطعه اسکریپت پوسته (یا هر دستور خارجی) است که
زمانی اجرا می شود که هر یک از رویدادهای مجموعه رویداد رخ دهد. با استفاده از "$SHELL" اجرا می شود
-c"، یا اگر $SHELL تنظیم نشده باشد، پس / بن / شل -c.
قطعه اسکریپت پوسته پارامترهای بازگشت به تماس را به عنوان آرگومان های $1، $2 و غیره دریافت می کند
رویداد واقعی که فراخوانی شد در متغیر محیطی $EVENT موجود است.
رویداد "" بستن "پژواک بسته شد"
ابزار پیام های رویداد، کتابخانه، ردیابی "echo $@"
رویداد "" progress "echo progress: $3/$4"
رویداد "" * "echo $EVENT $@"
دستورهای guestfish "delete-event" و "list-events" را نیز ببینید.
کره
دستور glob args...
حروف عام را در هر مسیری در لیست args گسترش دهید و "command" را به طور مکرر در هر کدام اجرا کنید.
مسیر تطبیق
به "WILDCARDS AND GLOBBING" مراجعه کنید.
هگزیدیت
هگزیدیت
هگزیدیت
هگزیدیت
از هگزیدیت (ویرایشگر هگز) برای ویرایش تمام یا بخشی از یک فایل باینری یا مسدود کردن دستگاه استفاده کنید.
این دستور با دانلود بالقوه کل فایل یا دستگاه و ویرایش آن کار می کند
به صورت محلی، سپس آن را آپلود کنید. اگر فایل یا دستگاه بزرگ است، باید آن را مشخص کنید
بخشی را که می خواهید با استفاده از پارامترهای "max" و/یا "شروع" "max" ویرایش کنید. "شروع" و "حداکثر"
بر حسب بایت مشخص می شوند، با اصلاح کننده های معمولی مجاز مانند "1M" (1 مگابایت).
به عنوان مثال برای ویرایش چند بخش اول یک دیسک ممکن است انجام دهید:
hexedit /dev/sda 1M
که به شما این امکان را می دهد که در هر مگابایت اول دیسک ویرایش کنید.
برای ویرایش superblock یک فایل سیستم ext2 در / dev / sda1، انجام دادن:
hexedit /dev/sda1 0x400 0x400
(با فرض اینکه superblock در محل استاندارد قرار دارد).
این دستور نیاز به خارجی دارد هگزیدیت(1) برنامه می توانید برنامه دیگری را برای آن مشخص کنید
با تنظیم متغیر محیطی "HEXEDITOR" استفاده کنید.
همچنین به "hexdump" مراجعه کنید.
ال سی دی
فهرست ال سی دی
دایرکتوری محلی را تغییر دهید. فهرست راهنمای فعلی خود guestfish.
توجه داشته باشید که "!cd" کاری را که شما انتظار دارید انجام نمی دهد.
لیست رویدادها
لیست رویدادها
کنترل کننده های رویداد ثبت شده را با استفاده از دستور "رویداد" guestfish فهرست کنید.
مرد
کتابچه راهنمای
مرد
صفحه راهنمای ماهی مهمان را باز می کند.
بیش
کمتر
نام فایل بیشتر
نام فایل کمتر
این برای مشاهده یک فایل استفاده می شود.
نمایشگر پیش فرض $PAGER است. اما اگر از دستور جایگزین "کمتر" استفاده کنید، این کار را خواهید کرد
دستور "کمتر" را به طور خاص دریافت کنید.
باز کردن
باز کردن
دستگیره libguestfs را ببندید و دوباره باز کنید. استفاده از این به طور معمول ضروری نیست، زیرا
هنگام خروج ماهی مهمان، دسته به درستی بسته می شود. با این حال این گاهی اوقات مفید است
برای آزمایش.
settenv
مقدار setenv VAR
متغیر محیطی "VAR" را روی رشته "value" تنظیم کنید.
برای چاپ مقدار متغیر محیطی از دستور shell مانند:
!echo $VAR
پراکنده
اندازه نام فایل پراکنده
این یک فایل پراکنده خالی با اندازه داده شده ایجاد می کند و سپس اضافه می کند تا بتواند بیشتر شود
بررسی شده است.
از همه لحاظ مانند دستور "alloc" عمل می کند، با این تفاوت که فایل تصویری است
اختصاص داده شده به صورت پراکنده، به این معنی که بلوک های دیسک تا زمانی که به فایل اختصاص داده نمی شوند
مورد نیاز است. فایل‌های دیسک پراکنده فقط زمانی از فضا استفاده می‌کنند که روی آن نوشته میشود، اما کندتر و کندتر هستند
این خطر وجود دارد که فضای دیسک واقعی در طول عملیات نوشتن تمام شود.
برای ایجاد تصویر پیشرفته تر، به "ایجاد دیسک" مراجعه کنید.
اندازه را می توان با استفاده از پسوندهای استاندارد مشخص کرد، به عنوان مثال. "1M".
دستور «خراش» را نیز ببینید.
پشتیبانی
پشتیبانی
این دستور فهرستی از گروه های اختیاری شناخته شده برای دیمون را برمی گرداند و نشان می دهد
کدام یک توسط این بیلد دستگاه libguestfs پشتیبانی می شود.
همچنین به "در دسترس بودن" در مهمانان(3).
زمان
دستور زمان آرگ...
دستور را طبق معمول اجرا کنید، اما پس از آن زمان سپری شده را چاپ کنید. این می تواند مفید باشد برای
عملیات محک زدن
unsetenv
unsetenv VAR
"VAR" را از محیط حذف کنید.
دستورات
acl-delete-def-file
acl-delete-def-file dir
این تابع فهرست پیش‌فرض کنترل دسترسی POSIX (ACL) متصل به فهرست را حذف میکند
"دایر".
acl-get-file
acl-get-file مسیر acltype
این تابع لیست کنترل دسترسی POSIX (ACL) متصل به "path" را برمی گرداند. ACL است
به "شکل متن طولانی" بازگردانده شد (نگاه کنید به لیگ قهرمانان آسیا(5).
پارامتر "acltype" ممکن است:
"دسترسی"
ACL معمولی (دسترسی) را برای هر فایل، دایرکتوری یا دیگر شیء سیستم فایل برگردانید.
"پیش فرض"
ACL پیش فرض را برگردانید. معمولاً این تنها زمانی معنا دارد که "path" یک دایرکتوری باشد.
acl-set-file
مسیر acl-set-file acltype acl
این تابع لیست کنترل دسترسی POSIX (ACL) را که به "مسیر" متصل شده است، تنظیم می کند.
پارامتر "acltype" ممکن است:
"دسترسی"
ACL معمولی (دسترسی) را برای هر فایل، دایرکتوری یا دیگر شی سیستم فایل تنظیم کنید.
"پیش فرض"
ACL پیش فرض را تنظیم کنید. معمولاً این تنها زمانی معنا دارد که "path" یک دایرکتوری باشد.
پارامتر "acl" ACL جدید در "شکل متن طولانی" یا "فرم متن کوتاه" است (نگاه کنید به
لیگ قهرمانان آسیا(5)). ACL جدید به طور کامل جایگزین هر ACL قبلی روی فایل می شود. ACL باید
حاوی مجوزهای کامل یونیکس (به عنوان مثال "u::rwx,g::rx,o::rx").
اگر کاربران یا گروه‌ها را مشخص می‌کنید، فیلد ماسک نیز لازم است
(مثلاً "m::rwx")، به دنبال آن "u:شناسه:..." و/یا "g:شناسه:..." زمینه های). یک رشته کامل ACL
بنابراین ممکن است به شکل زیر باشد:
u::rwx,g::rwx,o::rwx,m::rwx,u:500:rwx,g:500:rwx
\ مجوزهای یونیکس / \mask/ \ ACL /
شما باید از UIDهای عددی و GID استفاده کنید. برای نگاشت نام کاربری و نام گروه به درستی
شناسه عددی در زمینه مهمان، از توابع Augeas استفاده کنید (به "aug-init" مراجعه کنید).
افزودن سی دی
افزودن نام فایل cdrom
این تابع یک تصویر دیسک CD-ROM مجازی را به مهمان اضافه می کند.
تصویر به عنوان درایو فقط خواندنی اضافه می شود، بنابراین این تابع معادل "add-drive-ro" است.
این تابع is منسوخ. در کد جدید، به جای آن از تماس «add-drive-ro» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
افزودن دامنه
دامنه
add-domain dom [libvirturi:..] [readonly:true|false] [face:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..] [cachemode:..] [ حذف:..] [copyonread:true|false]
این تابع دیسک(های) متصل به دامنه libvirt نامگذاری شده "dom" را اضافه می کند. این کار توسط
اتصال به libvirt، درخواست دامنه و دامنه XML از libvirt، تجزیه آن برای
دیسک‌ها و فراخوانی «add-drive-opts» روی هر کدام.
تعداد دیسک های اضافه شده برگردانده می شود. این عملیات اتمی است: اگر یک خطا برگردانده شود،
سپس هیچ دیسکی اضافه نمی شود.
این تابع حداقل بررسی ها را انجام می دهد تا مطمئن شود دامنه libvirt اجرا نمی شود
(مگر اینکه "readonly" درست باشد). در نسخه آینده ما سعی خواهیم کرد قفل libvirt را بدست آوریم
روی هر دیسک
دیسک ها باید به صورت محلی قابل دسترسی باشند. این اغلب به این معنی است که دیسک ها را از یک کنترل از راه دور اضافه کنید
اتصال libvirt (نگاه کنید به http://libvirt.org/remote.html) از کار می افتد مگر اینکه آن دیسک ها باشند
از طریق همان مسیر دستگاه به صورت محلی نیز قابل دسترسی است.
پارامتر اختیاری "libvirturi" URI libvirt را تنظیم می کند (نگاه کنید به
http://libvirt.org/uri.html). اگر این تنظیم نشده باشد، به libvirt پیش فرض متصل می شویم
URI (یا یک مجموعه از طریق یک متغیر محیطی، مستندات libvirt را به طور کامل ببینید
جزئیات).
پرچم اختیاری "زنده" کنترل می کند که آیا این تماس سعی خواهد کرد به یک در حال اجرا متصل شود یا خیر
ماشین مجازی "guestfsd" را در صورت مشاهده مناسب پردازش می کند عنصر در libvirt
تعریف XML پیش‌فرض (اگر پرچم حذف شده باشد) این است که هرگز امتحان نکنید. به "ضمیمه کردن به
RUNNING DAEMONS" در مهمانان(3) برای اطلاعات بیشتر
اگر پرچم "allowuuid" درست است (پیش‌فرض نادرست است) یک UUID ممکن است به جای تصویب شود
نام دامنه رشته "dom" ابتدا به عنوان یک UUID در نظر گرفته می شود و به بالا نگاه می شود، و اگر چنین شد
جستجو با شکست مواجه می شود، سپس ما "dom" را به عنوان یک نام به طور معمول در نظر می گیریم.
پارامتر اختیاری "readonlydisk" کاری را که ما برای دیسک های علامت گذاری شده انجام می دهیم را کنترل می کند
در libvirt XML. مقادیر ممکن عبارتند از:
readonlydisk = "خطا"
اگر "readly" نادرست است:
در صورت وجود دیسک با این، کل تماس با خطا قطع می شود پرچم است
پیدا شده است.
اگر "readly" درست است:
دیسک های با پرچم فقط خواندنی اضافه می شود.
readonlydisk = "خواندن"
اگر "readly" نادرست است:
دیسک های با پرچم فقط خواندنی اضافه می شود. دیسک های دیگر اضافه شده است
خواندن/نوشتن
اگر "readly" درست است:
دیسک های با پرچم فقط خواندنی اضافه می شود.
readonlydisk = "نوشتن" (پیش فرض)
اگر "readly" نادرست است:
دیسک های با پرچم خواندن/نوشتن اضافه می شود.
اگر "readly" درست است:
دیسک های با پرچم فقط خواندنی اضافه می شود.
readonlydisk = "نادیده گرفتن"
اگر "خواندنی" درست یا نادرست است:
دیسک های با پرچم نادیده گرفته می شود.
سایر پارامترهای اختیاری مستقیماً به "add-drive-opts" منتقل می شوند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
افزودن درایو
اضافه کردن
افزودن درایو انتخاب
نام فایل add-drive [readonly:true|false] [قالب:..] [face:..] [نام:..] [label:..] [پروتکل:..] [سرور:..] [نام کاربری: ..] [مخفی:..] [کَشِمُد:..] [رد:..] [copyonread:true|false]
این تابع یک تصویر دیسک به نام اضافه می کند نام فایل به دسته نام فایل ممکن است منظم باشد
فایل میزبان یا یک دستگاه میزبان
وقتی این تابع قبل از "راه اندازی" (مورد معمول) فراخوانی می شود، اولین باری که تماس می گیرید
این تابع، دیسک در API به عنوان ظاهر می شود / dev / sda و، دومین بار به عنوان / dev / sdbو
به زودی.
در libguestfs ≥ 1.20 نیز می توانید این تابع را پس از راه اندازی فراخوانی کنید (با برخی از
محدودیت های). به این "هات پلاگ" می گویند. هنگام هات پلاگ باید a را مشخص کنید
"برچسب" به طوری که دیسک جدید یک نام قابل پیش بینی دریافت کند. برای اطلاعات بیشتر ببین
"HOTPLUGING" در مهمانان(3).
هنگام استفاده از libguestfs لزوماً نیازی به روت بودن ندارید. با این حال شما به وضوح انجام می دهید
به مجوزهای کافی برای دسترسی به نام فایل برای هر عملیاتی که می خواهید نیاز دارید
اجرا کنید (به عنوان مثال، اگر فقط می خواهید تصویر را بخوانید، دسترسی به خواندن را انجام دهید یا اگر می خواهید، دسترسی به نوشتن را انجام دهید
تصویر را اصلاح کنید).
این تماس آن را بررسی می کند نام فایل وجود دارد
نام فایل ممکن است رشته ویژه "/dev/null" باشد. "NULL DISKS" را در اینجا ببینید مهمانان(3).
آرگومان های اختیاری عبارتند از:
"فقط خواندنی"
اگر درست باشد، تصویر فقط خواندنی است. نوشتن هنوز مجاز است، اما آنها
در یک پوشش موقت عکس فوری ذخیره می شوند که در پایان دور انداخته می شود. دیسک
که اضافه می کنید اصلاح نشده است.
"قالب"
این فرمت تصویر را مجبور می کند. اگر این را حذف کنید (یا از "add-drive" یا "add-drive-ro" استفاده کنید)
سپس فرمت به طور خودکار شناسایی می شود. فرمت های ممکن عبارتند از "خام" و
"qcow2".
تشخیص خودکار قالب شما را به یک حفره امنیتی بالقوه باز می کند
برخورد با تصاویر غیرقابل اعتماد با فرمت خام CVE-2010-3851 و RHBZ#642934 را ببینید.
با تعیین فرمت، این حفره امنیتی بسته می شود.
"چهره"
این گزینه که به ندرت استفاده می شود به شما امکان می دهد رفتار "add-drive-" منسوخ شده را شبیه سازی کنید.
با-اگر" تماس (qv)
"نام"
نامی که درایو در مهمان اصلی داشت، به عنوان مثال / dev / sdb. این به عنوان یک اشاره استفاده می شود
به فرآیند بازرسی مهمان در صورت موجود بودن.
"برچسب"
به دیسک یک برچسب بدهید. برچسب باید یک رشته کوتاه و منحصر به فرد باشد فقط ASCII
کاراکترهای "[a-zA-Z]". و همچنین نام معمول آن در API (مانند / dev / sda و)،
درایو نیز نامگذاری خواهد شد /dev/disk/guestfs/label.
به "برچسب های دیسک" در مراجعه کنید مهمانان(3).
"پروتکل"
آرگومان پروتکل اختیاری را می توان برای انتخاب یک پروتکل منبع جایگزین استفاده کرد.
همچنین ببینید: "ذخیره سازی از راه دور" در مهمانان(3).
"پروتکل = "پرونده""
نام فایل به عنوان یک فایل یا دستگاه محلی تفسیر می شود. این پیش فرض است اگر
پارامتر پروتکل اختیاری حذف شده است.
"پروتکل = "ftp"|"ftps"|"http"|"https"|"tftp""
به یک سرور FTP، HTTP یا TFTP راه دور متصل شوید. پارامتر "سرور" نیز باید باشد
عرضه شده - زیر را ببینید.
همچنین ببینید: "FTP، HTTP و TFTP" در مهمانان(3)
"پروتکل = "گلستر""
به سرور GlusterFS متصل شوید. پارامتر "سرور" نیز باید ارائه شود -
به زیر مراجعه کنید
همچنین ببینید: "GLUSTER" در مهمانان(3)
"پروتکل = "iscsi""
به سرور iSCSI متصل شوید. پارامتر "سرور" نیز باید ارائه شود - ببینید
زیر ممکن است پارامتر "نام کاربری" ارائه شود. زیر را ببینید. راز"
پارامتر ممکن است ارائه شود. زیر را ببینید.
همچنین ببینید: "ISCSI" در مهمانان(3).
"پروتکل = "nbd""
به سرور دستگاه بلوک شبکه متصل شوید. پارامتر "سرور" نیز باید باشد
عرضه شده - زیر را ببینید.
همچنین ببینید: "NETWORK BLOCK DEVICE" در مهمانان(3).
"پروتکل = "rbd""
به سرور Ceph (librbd/RBD) متصل شوید. پارامتر "سرور" نیز باید باشد
عرضه شده - زیر را ببینید. ممکن است پارامتر "نام کاربری" ارائه شود. زیر را ببینید. در
ممکن است پارامتر "مخفی" ارائه شود. زیر را ببینید.
همچنین ببینید: "CEPH" در مهمانان(3).
"پروتکل = "سگ گوسفند""
به سرور Sheepdog متصل شوید. ممکن است پارامتر "سرور" نیز ارائه شود - ببینید
زیر کلیک کنید.
همچنین ببینید: "SHEEPDOG" در مهمانان(3).
"پروتکل = "ssh""
به سرور Secure Shell (ssh) متصل شوید.
پارامتر "سرور" باید ارائه شود. ممکن است پارامتر "username" باشد
عرضه شده است. زیر را ببینید.
همچنین ببینید: "SSH" در مهمانان(3).
"سرور"
برای پروتکل هایی که نیاز به دسترسی به سرور راه دور دارند، این لیست سرور(ها) است.
پروتکل تعداد سرورهای مورد نیاز
---------------------------------
لیست فایل باید خالی باشد یا از پارامتر استفاده نشود
ftp|ftps|http|https|tftp دقیقا یکی
گلستر دقیقا یکی
iscsi دقیقا یکی
nbd دقیقا یکی
rbd صفر یا بیشتر
سگ گله صفر یا بیشتر
ssh دقیقا یکی
هر عنصر لیست یک رشته است که یک سرور را مشخص می کند. رشته باید در یکی از
فرمت های زیر:
نام میزبان
نام میزبان: پورت
tcp: نام میزبان
tcp:hostname:port
unix:/path/to/socket
اگر شماره پورت حذف شود، از شماره پورت استاندارد برای پروتکل استفاده می شود
(نگاه کنید به / و غیره / خدمات).
"نام کاربری"
برای پروتکل‌های «ftp»، «ftps»، «http»، «https»، «iscsi»، «rbd»، «ssh» و «tftp»،
این نام کاربری راه دور را مشخص می کند.
اگر داده نشده باشد، نام کاربری محلی برای "ssh" استفاده می شود و هیچ احراز هویتی وجود ندارد
تلاش برای ceph. اما توجه داشته باشید که گاهی اوقات ممکن است به عنوان مثال نتایج غیرمنتظره ای به همراه داشته باشد
اگر از باطن libvirt استفاده می کنید و اگر باطن libvirt برای شروع پیکربندی شده باشد
دستگاه qemu به عنوان یک کاربر خاص مانند "qemu.qemu". اگر شک دارید، ریموت را مشخص کنید
نام کاربری مورد نظر شما
"راز"
فقط برای پروتکل "rbd"، این "راز" مورد استفاده در هنگام اتصال به
دستگاه از راه دور باید کدگذاری base64 باشد.
اگر داده نشود، رازی مطابق با نام کاربری داده شده در قسمت جستجو می شود
مکان های پیش فرض زنجیره کلید، یا اگر نام کاربری داده نشود، احراز هویت انجام نخواهد شد
استفاده شده.
"cachemode"
انتخاب کنید که آیا libguestfs از عملیات همگام سازی (ایمن اما کند) تبعیت می کند یا خیر
(ناامن اما سریع). مقادیر ممکن برای این رشته عبارتند از:
"cachemode = "نوشتن""
این پیش فرض است.
عملیات نوشتن در API تا زمانی که a بر نمی گردند نوشتن(2) تماس به پایان رسیده است
میزبان [اما توجه داشته باشید که این بدان معنا نیست که چیزی روی دیسک نوشته می شود].
همگام سازی عملیات در API، از جمله همگام سازی ضمنی ناشی از سیستم فایل
ژورنالینگ، تا زمانی که fdatasync(2) تماس در میزبان تکمیل شده است،
نشان می دهد که داده ها به دیسک متعهد شده اند.
"cachemode = "ناامن""
در این حالت هیچ تضمینی وجود ندارد. Libguestfs ممکن است هر چیزی را کش کند و نادیده بگیرد
همگام سازی درخواست ها این فقط برای دیسک های خراشیده یا موقت مناسب است.
"دور انداختن"
پشتیبانی از حذف (معروف به trim یا unmap) را در این درایو فعال یا غیرفعال کنید. در صورت فعال بودن،
عملیاتی مانند "fstrim" قادر به دور انداختن / ایجاد سوراخ های نازک / پانچ در آن خواهد بود
فایل میزبان یا دستگاه اصلی
تنظیمات دور انداختن احتمالی عبارتند از:
"discard = "غیرفعال کردن""
غیرفعال کردن پشتیبانی از حذف این پیش فرض است.
"discard = "فعال کردن""
پشتیبانی از حذف را فعال کنید. اگر دور انداختن امکان پذیر نباشد، شکست بخورد.
"رد = "بهترین تلاش""
در صورت امکان، پشتیبانی از حذف را فعال کنید، اما اگر پشتیبانی نمی‌شود، شکست نخورید.
از آنجایی که همه بک‌اندها و همه سیستم‌های زیربنایی از کنار زدن پشتیبانی نمی‌کنند، این یک است
اگر می‌خواهید در صورت امکان از دور انداختن استفاده کنید، انتخاب خوبی است، اما اگر این کار را نکرد، اهمیتی ندهید
کار می کنند.
"کپی خوانده شده"
پارامتر بولی "copyonread" پشتیبانی کپی در خواندن را فعال می کند. این فقط تاثیر می گذارد
فرمت‌های دیسکی که دارای فایل‌های پشتیبان هستند و باعث می‌شوند که خواندن‌ها در پوشش ذخیره شوند
لایه، سرعت خواندن چندگانه یک ناحیه از دیسک را افزایش می دهد.
حالت پیش فرض غلط است.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
add-drive-ro
افزودن رو
نام فایل add-drive-ro
این تابع معادل فراخوانی "add-drive-opts" با پارامتر اختیاری است
"GUESTFS_ADD_DRIVE_OPTS_READONLY" روی 1 تنظیم شد، بنابراین دیسک فقط خواندنی اضافه می شود، با
فرمت به طور خودکار شناسایی می شود.
add-drive-ro-with-if
add-drive-ro-with-if filename iface
این همان "add-drive-ro" است اما به شما امکان می دهد رابط QEMU را مشخص کنید
شبیه سازی برای استفاده در زمان اجرا
این تابع is منسوخ. در کد جدید، به جای آن از تماس «add-drive» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
add-drive-scratch
خراش
اندازه add-drive-scratch [نام:..] [برچسب:..]
این دستور یک درایو خراش موقت به دسته اضافه می کند. پارامتر "اندازه" است
اندازه مجازی (به بایت). درایو خراش در ابتدا خالی است (همه قرائت ها صفر هستند
تا زمانی که شروع به نوشتن برای آن کنید). با بسته شدن دسته درایو حذف می شود.
آرگومان های اختیاری "name" و "label" به "add-drive" منتقل می شوند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
add-drive-with-if
add-drive-with-if filename iface
این همان "add-drive" است اما به شما امکان می دهد شبیه سازی رابط QEMU را مشخص کنید
برای استفاده در زمان اجرا
این تابع is منسوخ. در کد جدید، به جای آن از تماس «add-drive» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
اوت روشن
aug-clear augpath
مقدار مرتبط با "path" را روی "NULL" تنظیم کنید. این همان است autool(1)
دستور "پاک کردن".
آگوست-بستن
آگوست-بستن
دستگیره فعلی Augeas را ببندید و منابع مورد استفاده توسط آن را آزاد کنید. پس از تماس با این،
قبل از اینکه بتوانید از سایر توابع Augeas استفاده کنید، باید دوباره "aug-init" را فراخوانی کنید.
aug-defnode
نام aug-defnode expr val
متغیر "name" را تعریف می کند که مقدار آن حاصل ارزیابی "expr" است.
اگر "expr" به یک گره خالی ارزیابی شود، یک گره ایجاد می شود که معادل فراخوانی "aug-
set" "expr"، "value". "name" مجموعه گره ای خواهد بود که شامل آن گره منفرد است.
در صورت موفقیت، یک جفت حاوی تعداد گره‌ها در مجموعه گره‌ها و a
اگر یک گره ایجاد شده باشد، پرچم بولی.
آگوست دفور
نام aug-defvar expr
یک متغیر Augeas "name" را تعریف می کند که مقدار آن حاصل ارزیابی "expr" است. اگر
"expr" NULL است، سپس "name" تعریف نشده است.
در صورت موفقیت، تعداد گره‌ها در "expr" یا 0 در صورت ارزیابی "expr" برمی‌گردد
چیزی که یک گره نیست.
اوت گرفتن
aug-get augpath
مقدار مرتبط با "path" را جستجو کنید. اگر «مسیر» دقیقاً با یک گره مطابقت داشته باشد، «مقدار»
برگردانده شده است.
aug-init
پرچم های ریشه aug-init
یک دسته جدید Augeas برای ویرایش فایل های پیکربندی ایجاد کنید. اگر قبلی بود
دسته Augeas مرتبط با این جلسه مهمان است، سپس بسته می شود.
شما باید قبل از استفاده از سایر دستورات "aug-*" این را فراخوانی کنید.
"root" ریشه سیستم فایل است. "ریشه" نباید NULL باشد، استفاده کنید / به جای آن.
پرچم ها همان پرچم هایی هستند که در آن تعریف شده اند ، منطقی or از موارد زیر
اعداد صحیح:
"AUG_SAVE_BACKUP" = 1
فایل اصلی را با پسوند ".augsave" نگه دارید.
"AUG_SAVE_NEWFILE" = 2
تغییرات را در فایلی با پسوند ".augnew" ذخیره کنید و نسخه اصلی را بازنویسی نکنید.
"AUG_SAVE_BACKUP" را لغو می کند.
"AUG_TYPE_CHECK" = 4
لنزهای تایپ چک
این گزینه فقط در هنگام اشکال زدایی لنزهای Augeas مفید است. استفاده از این گزینه ممکن است
نیاز به حافظه اضافی برای دستگاه libguestfs. ممکن است نیاز به تنظیم داشته باشید
متغیر محیطی "LIBGUESTFS_MEMSIZE" یا "set-memsize" را فراخوانی کنید.
"AUG_NO_STDINC" = 8
از مسیر بارگذاری استاندارد برای ماژول ها استفاده نکنید.
"AUG_SAVE_NOOP" = 16
بدون عملیات ذخیره کنید، فقط آنچه را که تغییر می کرد ضبط کنید.
"AUG_NO_LOAD" = 32
درخت را در "aug-init" بارگذاری نکنید.
برای بستن دسته، می توانید با "aug-close" تماس بگیرید.
برای کسب اطلاعات بیشتر در مورد Augeas، نگاه کنید http://augeas.net/.
آگوست درج
aug-insert augpath برچسب true|false
یک "برچسب" جدید برای "path" ایجاد کنید، آن را قبل یا بعد از "path" در درخت قرار دهید.
(بسته به پرچم بولی "قبل").
"path" باید دقیقاً با یک گره موجود در درخت مطابقت داشته باشد و "label" باید یک برچسب باشد، به عنوان مثال.
حاوی نیست /، "*" یا با نمایه پرانتزی "[N]" خاتمه دهید.
اوت برچسب
aug-label augpath
برچسب (نام آخرین عنصر) عبارت مسیر Augeas "augpath" برگردانده می شود.
"augpath" باید دقیقاً با یک گره مطابقت داشته باشد، در غیر این صورت این تابع یک خطا را برمی گرداند.
اوت بارگذاری
اوت بارگذاری
فایل ها را در درخت بارگذاری کنید.
برای جزئیات کامل به "aug_load" در مستندات Augeas مراجعه کنید.
آگوست-ls
aug-ls augpath
این فقط یک میانبر برای فهرست کردن "aug-match" "path/*" و مرتب‌سازی گره‌های حاصل است.
به ترتیب حروف الفبا
اوت مسابقه
aug-match augpath
فهرستی از مسیرهایی را برمی‌گرداند که با عبارت مسیر «path» مطابقت دارند. مسیرهای برگشتی هستند
به اندازه کافی واجد شرایط هستند تا دقیقاً با یک گره در درخت فعلی مطابقت داشته باشند.
aug-mv
aug-mv src dest
گره "src" را به "dest" منتقل کنید. "src" باید دقیقاً با یک گره مطابقت داشته باشد. "dest" بازنویسی شده است
اگر وجود داشته باشد
aug-rm
aug-rm augpath
"مسیر" و همه فرزندان آن را حذف کنید.
در صورت موفقیت، تعداد ورودی هایی که حذف شده اند را برمی گرداند.
آگوست ذخیره
آگوست ذخیره
این همه تغییرات در انتظار دیسک را می نویسد.
پرچم هایی که به "aug-init" منتقل شده اند دقیقا بر نحوه ذخیره فایل ها تأثیر می گذارند.
اوت مجموعه
aug-set augpath val
مقدار مرتبط با "path" را روی "val" تنظیم کنید.
در Augeas API امکان پاک کردن یک گره با تنظیم مقدار NULL وجود دارد. به دلیل یک
نظارت در libguestfs API شما نمی توانید با این تماس این کار را انجام دهید. در عوض باید استفاده کنید
تماس "آگوست پاک".
aug-setm
زیر val پایه aug-setm
چندین گره Augeas را در یک عملیات تغییر دهید. "پایه" تطبیق عبارت است
چندین گره "sub" یک عبارت مسیر نسبت به "پایه" است. همه گره های مطابق با "پایه"
پیدا می شوند، و سپس برای هر گره، "sub" به "val" تغییر می کند. "sub" نیز ممکن است "NULL" باشد
در این صورت گره های "پایه" اصلاح می شوند.
این تعداد گره های اصلاح شده را برمی گرداند.
در دسترس
"گروه های موجود ..."
این دستور برای بررسی در دسترس بودن برخی از گروه‌های عملکردی استفاده میشود
ابزاری که همه بیلدهای دستگاه libguestfs قادر به ارائه آن نیستند.
گروه‌های libguestfs و توابعی که آن گروه‌ها با آنها مطابقت دارند، در فهرست‌بندی شده‌اند
"در دسترس بودن" در مهمانان(3). همچنین می توانید این لیست را در زمان اجرا با تماس گرفتن دریافت کنید
"در دسترس همه گروه ها".
آرگومان "گروه ها" فهرستی از نام گروه ها است، به عنوان مثال: "["inotify"، "augeas"]" را بررسی می کند.
برای در دسترس بودن توابع inotify لینوکس و Augeas (فایل پیکربندی
ویرایش) توابع.
این فرمان هیچ خطایی را برمی‌گرداند اگر تمام گروه های درخواستی موجود هستند.
اگر یک یا چند گروه از گروه‌های درخواستی در دسترس نباشند، با خطا مواجه میشود
لوازم خانگی
اگر یک نام گروه ناشناخته در لیست گروه ها گنجانده شود، همیشه یک خطا وجود دارد
برگشت
یادداشت:
· "feature-available" مانند این تماس است، اما با استفاده از API کمی ساده تر:
آن فراخوانی به جای ارسال خطا، یک درست/نادرست بولی را برمی‌گرداند.
· قبل از فراخوانی این تابع باید "راه اندازی" را فراخوانی کنید.
دلیل آن این است که ما نمی دانیم چه گروه هایی توسط appliance/daemon پشتیبانی می شوند
تا زمانی که در حال اجرا باشد و بتوان آن را پرس و جو کرد.
· اگر گروهی از توابع در دسترس باشد، این لزوماً به این معنا نیست که آن ها در دسترس خواهند بود
کار هنگام فراخوانی عملکردهای API منفرد، هنوز باید خطاها را بررسی کنید
در صورت موجود بودن
· معمولاً وظیفه توزیع کنندگان بسته بندی این است که عملکرد کاملی را در آن ایجاد کنند
دستگاه libguestfs. libguestfs بالادست، اگر از منبع با تمام الزامات ساخته شده باشد
راضی است، از همه چیز پشتیبانی خواهد کرد.
· این تماس در نسخه 1.0.80 اضافه شد. در نسخه های قبلی libguestfs همه شما
می تواند انجام شود به صورت حدس و گمان اجرای یک فرمان برای کشف اینکه آیا دیمون
آن را اجرا کرد. همچنین به "نسخه" مراجعه کنید.
همچنین به "فایل سیستم در دسترس" مراجعه کنید.
در دسترس-همه-گروه ها
در دسترس-همه-گروه ها
این دستور فهرستی از تمام گروه های اختیاری را که این دیمون در مورد آنها می داند، برمی گرداند. توجه داشته باشید
این هم گروه های پشتیبانی شده و هم گروه های پشتیبانی نشده را برمی گرداند. برای اینکه بفهمیم دیمون می تواند کدام یک را داشته باشد
در واقع از شما پشتیبانی می کند که باید "در دسترس" / "ویژگی در دسترس" را در هر یک از اعضای آن فراخوانی کنید
لیست برگشتی
همچنین به "در دسترس"، "ویژگی در دسترس" و "AVAILABILITY" در اینجا مراجعه کنید مهمانان(3).
پایه 64 اینچی
نام فایل base64-in (base64file|-).
این دستور داده های کدگذاری شده با base64 را از "base64file" در آپلود می کند نام فایل.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
base64-out
نام فایل base64-out (base64file|-)
این دستور محتویات را دانلود می کند نام فایل، نوشتن آن در فایل محلی "base64file"
کدگذاری شده به عنوان base64.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
نادیده گرفتن
دستگاه blkdiscard
این کار تمام بلوک‌های موجود در دستگاه بلوک را کنار می‌گذارد و فضای آزاد را به دستگاه باز می‌گرداند
میزبان
این عملیات به پشتیبانی در libguestfs، فایل سیستم میزبان، qemu و میزبان نیاز دارد
هسته اگر این پشتیبانی وجود نداشته باشد، ممکن است خطا بدهد یا حتی به نظر برسد که اجرا می شود اما اجرا می شود
هیچ چیزی. همچنین باید ویژگی «discard» را در درایو زیرین تنظیم کنید (به «افزودن- مراجعه کنید.
drive-opts").
blkdiscardzeroes
دستگاه blkdiscardzeroes
اگر بلوک‌هایی روی «دستگاه» که با تماس به آن حذف شده‌اند، این تماس درست برمی‌گردد
"blkdiscard" به عنوان بلوک های صفر بایت در دفعات بعدی بازگردانده می شود.
اگر false برگرداند، ممکن است بلوک های دور ریخته شده به عنوان قدیمی یا تصادفی خوانده شوند
داده است.
سیاه
دستگاه تاریک
این دستور ویژگی‌های دستگاه بلوک را برای «دستگاه» برمی‌گرداند. فیلدهای زیر هستند
معمولاً در هش برگشتی وجود دارد. ممکن است فیلدهای دیگری نیز وجود داشته باشد.
"UUID"
uuid این دستگاه
"برچسب"
برچسب این دستگاه
"نسخه"
نسخه دستور blkid.
"TYPE"
نوع فایل سیستم یا RAID این دستگاه.
"استفاده"
استفاده از این دستگاه، به عنوان مثال "فایل سیستم" یا "raid".
blockdev-flushbufs
دستگاه blockdev-flushbufs
این به هسته می گوید که بافرهای داخلی مرتبط با "دستگاه" را شستشو دهد.
این استفاده می کند blockdev(8) فرمان.
blockdev-getbsz
دستگاه blockdev-getbsz
این اندازه بلوک یک دستگاه را برمی گرداند.
توجه: این با هر دو تفاوت دارد اندازه in بلوک و سیستم فایل مسدود کردن اندازه. همچنین این
تنظیمات واقعاً توسط هیچ چیز استفاده نمی شود. احتمالاً نباید از آن برای هیچ چیز استفاده کنید.
سیستم های فایل ایده خود را در مورد اندازه بلوک انتخاب می کنند.
این استفاده می کند blockdev(8) فرمان.
blockdev-getro
دستگاه blockdev-getro
یک بولی را برمی‌گرداند که نشان می‌دهد آیا دستگاه بلوک فقط خواندنی است (در صورت فقط خواندنی درست است، اگر فقط نادرست است
نه).
این استفاده می کند blockdev(8) فرمان.
blockdev-getsize64
دستگاه blockdev-getsize64
این اندازه دستگاه را بر حسب بایت برمی گرداند.
همچنین به "blockdev-getsz" مراجعه کنید.
این استفاده می کند blockdev(8) فرمان.
blockdev-getss
دستگاه blockdev-getss
این اندازه بخش ها را در یک دستگاه بلوک برمی گرداند. معمولا 512، اما می تواند بزرگتر برای
دستگاه های مدرن
(توجه داشته باشید، این اندازه در بخش ها نیست، برای آن از "blockdev-getsz" استفاده کنید).
این استفاده می کند blockdev(8) فرمان.
blockdev-getsz
دستگاه blockdev-getsz
این اندازه دستگاه را در واحدهای بخش های 512 بایتی برمی گرداند (حتی اگر اندازه بخش
512 بایت نیست ... عجیب است).
همچنین به "blockdev-getss" برای اندازه بخش واقعی دستگاه و "blockdev-getsize64" مراجعه کنید.
برای مفیدتر اندازه in بایت.
این استفاده می کند blockdev(8) فرمان.
blockdev-readpt
دستگاه blockdev-readpt
جدول پارتیشن را در "دستگاه" دوباره بخوانید.
این استفاده می کند blockdev(8) فرمان.
blockdev-setbsz
اندازه بلوک دستگاه blockdev-setbsz
این تماس هیچ کاری انجام نمی دهد و هرگز به دلیل یک اشکال در blockdev کاری انجام نداده است. Do نه
استفاده کنید آن است.
اگر نیاز به تنظیم اندازه بلوک فایل سیستم دارید، از گزینه "blocksize" از "mkfs" استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mkfs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
blockdev-setra
بخش های دستگاه blockdev-setra
پیشخوان خواندن (در بخش های 512 بایتی) را برای دستگاه تنظیم کنید.
این استفاده می کند blockdev(8) فرمان.
blockdev-setro
دستگاه blockdev-setro
دستگاه بلوک به نام "دستگاه" را روی فقط خواندنی تنظیم می کند.
این استفاده می کند blockdev(8) فرمان.
blockdev-setrw
دستگاه blockdev-setrw
دستگاه بلوک به نام «دستگاه» را برای خواندن و نوشتن تنظیم می کند.
این استفاده می کند blockdev(8) فرمان.
btrfs-balance-cancel
مسیر btrfs-balance-cancel
تعادل در حال اجرا در فایل سیستم btrfs را لغو کنید.
btrfs-balance-pause
مسیر btrfs-balance-pause
یک تعادل در حال اجرا را در یک فایل سیستم btrfs متوقف کنید.
btrfs-balance-resume
مسیر btrfs-balance-resume
تعادل متوقف شده را در سیستم فایل btrfs از سر بگیرید.
btrfs-balance-status
مسیر btrfs-balance-status
نشان دادن وضعیت موجودی در حال اجرا یا توقف در یک فایل سیستم btrfs.
btrfs-device-add
btrfs-device-add 'devices ...' fs
لیست دستگاه(های) موجود در "دستگاه" را به سیستم فایل btrfs نصب شده در "fs" اضافه کنید. اگر
"دستگاه ها" یک لیست خالی است، این هیچ کاری نمی کند.
btrfs-device-delete
btrfs-device-delete 'devices ...' fs
«دستگاه‌ها» را از سیستم فایل btrfs نصب شده در «fs» حذف کنید. اگر "دستگاه ها" خالی است
لیست، این هیچ کاری نمی کند.
btrfs-filesystem-balance
btrfs-balance
btrfs-filesystem-balance fs
تکه‌های موجود در سیستم فایل btrfs را که در «fs» در دستگاه‌های زیرین نصب شده‌اند، متعادل کنید.
btrfs-filesystem-defragment
مسیر btrfs-filesystem-defragment [flush:true|false] [compress:..]
یک فایل یا دایرکتوری را در یک سیستم فایل btrfs یکپارچه سازی کنید. فشرده سازی یکی از zlib یا lzo است.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfs-filesystem-resize
btrfs-filesystem-resize mountpoint [size:N]
این دستور اندازه یک فایل سیستم btrfs را تغییر می دهد.
توجه داشته باشید که برخلاف دیگر تماس‌های تغییر اندازه، سیستم فایل باید Mount شود و پارامتر آن است
mountpoint نه دستگاه (این مورد نیاز خود btrfs است).
پارامترهای اختیاری عبارتند از:
"اندازه"
اندازه جدید (بر حسب بایت) فایل سیستم. در صورت حذف، اندازه فایل سیستم به تغییر اندازه می شود
حداکثر اندازه
همچنین مشاهده کنید btrfs(8).
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfs-filesystem-sync
btrfs-filesystem-sync fs
همگام سازی اجباری در سیستم فایل btrfs نصب شده در "fs".
btrfs-fsck
دستگاه btrfs-fsck [superblock:N] [تعمیر:درست|نادرست]
برای بررسی یک فایل سیستم btrfs استفاده می شود، "دستگاه" فایل دستگاهی است که سیستم فایل در آن قرار دارد
ذخیره شده
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfs-image
btrfs-image "منبع ..." تصویر [compresslevel:N]
این برای ایجاد یک تصویر از یک فایل سیستم btrfs استفاده می شود. همه داده ها صفر خواهند شد، اما
ابرداده و مانند آن حفظ می شود.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfs-qgroup-assign
btrfs-qgroup-assign مسیر dst src
qgroup "src" را به qgroup والد "dst" اضافه کنید. این دستور می تواند چندین qgroup را در یک گروه بندی کند
qgroup والد برای به اشتراک گذاشتن محدودیت مشترک.
btrfs-qgroup-create
btrfs-qgroup-ایجاد زیرجلد qgroupid
یک گروه سهمیه (qgroup) برای زیرجلد در "subvolume" ایجاد کنید.
btrfs-qgroup-destroy
btrfs-qgroup-destroy qgroupid subvolume
گروه سهمیه ای را نابود کنید.
btrfs-qgroup-limit
اندازه زیرجلد btrfs-qgroup-limit
اندازه یک زیرجلد را که مسیر آن "subvolume" است محدود کنید. "اندازه" می تواند پسوند G، M داشته باشد،
یا ک.
btrfs-qgroup-remove
مسیر btrfs-qgroup-remove src dst
qgroup "src" را از qgroup والد "dst" حذف کنید.
btrfs-qgroup-show
مسیر btrfs-qgroup-show
نمایش تمام گروه های سهمیه حجم فرعی در یک سیستم فایل btrfs، از جمله موارد استفاده آنها.
btrfs-quota-enable
btrfs-quota-enable fs true|false
فعال یا غیرفعال کردن پشتیبانی سهمیه فرعی برای سیستم فایلی که حاوی "path" است.
btrfs-quota-rescan
btrfs-quota-rescan fs
تمام اعداد qgroup را حذف کنید و ابرداده را دوباره با پیکربندی فعلی اسکن کنید.
btrfs-replace
btrfs-جایگزین srcdev targetdev mntpoint
دستگاه فایل سیستم btrfs را جایگزین کنید. در یک فایل سیستم زنده، داده ها را در فایل کپی کنید
دستگاه مورد نظر که در حال حاضر در دستگاه منبع ذخیره شده است. پس از اتمام
در عملیات، دستگاه منبع پاک شده و از سیستم فایل حذف می شود.
"targetdev" باید همان اندازه یا بزرگتر از "srcdev" باشد. دستگاه هایی که هستند
در حال حاضر نصب شده هرگز مجاز به استفاده به عنوان "targetdev" نیست.
btrfs-rescue-chunk-recover
دستگاه btrfs-rescue-chunk-recover
با اسکن یک به یک دستگاه ها، درخت تکه فایل سیستم btrfs را بازیابی کنید.
btrfs-rescue-super-recover
دستگاه btrfs-rescue-super-recover
ابر بلوک های بد را از کپی های خوب بازیابی کنید.
btrfs-scrub-cancel
مسیر btrfs-scrub-cancel
یک اسکراب در حال اجرا در یک سیستم فایل btrfs را لغو کنید.
btrfs-scrub-رزومه
مسیر btrfs-scrub-resume
یک اسکراب که قبلاً لغو یا قطع شده را در یک سیستم فایل btrfs از سر بگیرید.
btrfs-scrub-start
مسیر btrfs-scrub-start
تمام داده‌ها و ابرداده‌های موجود در سیستم فایل را می‌خواند و از چک‌جمع‌ها و موارد تکراری استفاده میکند
کپی از حافظه RAID برای شناسایی و تعمیر هر گونه داده فاسد.
btrfs-scrub-status
مسیر btrfs-scrub-status
نمایش وضعیت اسکراب در حال اجرا یا تمام شده در یک فایل سیستم btrfs.
btrfs-set-seeding
btrfs-set-seeding device true|false
ویژگی seed دستگاهی که حاوی یک سیستم فایل btrfs است را فعال یا غیرفعال کنید.
btrfs-subvolume-create
btrfs-subvolume-create-opts
btrfs-subvolume-create dest [qgroupid:..]
یک زیرجلد btrfs ایجاد کنید. آرگومان "dest" فهرست مقصد و نام است
از زیر جلد، به شکل /path/to/dest/name. پارامتر اختیاری "qgroupid"
نشان دهنده qgroup است که زیرجلد جدید ایجاد شده به آن اضافه خواهد شد.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfs-subvolume-delete
btrfs-subvolume-delete subvolume
زیرجلد یا عکس فوری btrfs نامگذاری شده را حذف کنید.
btrfs-subvolume-get-default
btrfs-subvolume-get-default fs
زیرجلد پیش فرض یا عکس فوری یک سیستم فایل نصب شده در "نقطه mount" را دریافت کنید.
btrfs-subvolume-list
btrfs-subvolume-list fs
عکس های فوری btrfs و حجم های فرعی سیستم فایل btrfs که در "fs" نصب شده است را فهرست کنید.
btrfs-subvolume-set-default
btrfs-subvolume-set-default id fs
حجم فرعی فایل سیستم btrfs را "fs" تنظیم کنید که به طور پیش فرض نصب می شود. دیدن
"btrfs-subvolume-list" برای دریافت لیستی از زیرجلدها.
btrfs-subvolume-show
btrfs-subvolume-show subvolume
اطلاعات دقیق زیرجلد را برگردانید.
btrfs-subvolume-snapshot
btrfs-subvolume-snapshot-opts
منبع btrfs-subvolume-snapshot مقصد [ro:true|false] [qgroupid:..]
یک عکس فوری از زیر جلد btrfs "source" ایجاد کنید. استدلال "بهترین" مقصد است
دایرکتوری و نام عکس فوری، در فرم /path/to/dest/name. به طور پیش فرض
عکس فوری تازه ایجاد شده قابل نوشتن است، اگر مقدار پارامتر اختیاری "ro" درست باشد، پس
یک عکس فوری فقط خواندنی ایجاد می شود. پارامتر اختیاری "qgroupid" نشان دهنده qgroup است
که اسنپ شات جدید ایجاد شده به آن اضافه خواهد شد.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
btrfstune-enable-extended-inode-refs
دستگاه btrfstune-enable-extended-inode-refs
این refs inode توسعه یافته را فعال می کند.
btrfstune-enable-skinny-metadata-extent-refs
دستگاه btrfstune-enable-skinny-metadata-extent-refs
با این کار refs وسعت ابرداده لاغر فعال می شود.
بترفستون بذر
دستگاه btrfstune-seeding true|false
Seding یک دستگاه btrfs را فعال کنید، این یک fs فقط خواندنی را مجبور می کند تا بتوانید از آن برای
ساخت فایل سیستم های دیگر
نشانگر سی
نشانگر سی
در پیوندهای زبان غیر C، این به شما این امکان را می دهد که نشانگر C زیرین را به آن بازیابی کنید
دسته (به عنوان مثال "h *"). هدف از این کار اجازه دادن به سایر کتابخانه ها برای همکاری با یکدیگر است
libguestfs.
نام دستگاه متعارف
دستگاه نام دستگاه متعارف
این عملکرد ابزار هنگام نمایش نام دستگاه به کاربر مفید است. طول می کشد
تعداد نام‌های دستگاه نامنظم و آنها را در قالبی ثابت برمی‌گرداند:
/dev/hdX
/dev/vdX
اینها به عنوان بازگردانده می شوند / dev / sdX. توجه داشته باشید که این برای نام دستگاه و نام پارتیشن کار می کند.
این تقریباً برعکس الگوریتم توصیف شده در "BLOCK DEVICE NAMING" است.
in مهمانان(3).
/dev/mapper/VG-LV
/dev/dm-N
تبدیل شده به /dev/VG/LV با استفاده از "lvm-canonical-lv-name" فرم دهید.
سایر رشته ها بدون تغییر بازگردانده می شوند.
cap-get-file
مسیر cap-get-file
این تابع قابلیت های لینوکس متصل به "path" را برمی گرداند. مجموعه قابلیت ها می باشد
به صورت متن بازگردانده شده است (نگاه کنید به cap_to_text(3).
اگر هیچ قابلیتی به فایل ضمیمه نشده باشد، یک رشته خالی برگردانده می شود.
cap-set-file
cap-set-file cap path
این تابع قابلیت های لینوکس متصل به "path" را تنظیم می کند. قابلیت های تنظیم شده "Cap"
باید به صورت متن ارسال شود (نگاه کنید به cap_from_text(3).
مسیر حساس به حروف کوچک و بزرگ
مسیر مسیر حساس به حروف بزرگ و کوچک
این می تواند برای حل و فصل مسیرهای حساس به حروف بزرگ و کوچک در یک سیستم فایل که حروف کوچک و بزرگ است استفاده شود
حساس. مورد استفاده برای حل مسیرهایی است که از ویندوز خوانده اید
فایل های پیکربندی یا رجیستری ویندوز، به مسیر واقعی.
فرمان یک ویژگی خاص درایور سیستم فایل لینوکس ntfs-3g را کنترل می کند (و احتمالاً
دیگران)، که این است که اگرچه سیستم فایل زیربنایی به حروف بزرگ و کوچک حساس است، اما درایور
فایل سیستم را به صورت حساس به حروف کوچک و بزرگ به لینوکس صادر می کند.
یکی از پیامدهای این امر این است که دایرکتوری های خاصی مانند ج:\ویندوز ممکن است به عنوان ظاهر شود
/پنجره ها or /پنجره ها (یا چیزهای دیگر) بسته به جزئیات دقیق چگونگی آنها
ایجاد شده. در خود ویندوز این مشکل نخواهد بود.
اشکال یا ویژگی؟ تو تصمیم بگیر: http://www.tuxera.com/community/ntfs-3g-faq/#posixfilnames1
"مسیر حساس به حروف بزرگ" تلاش می کند تا حالت واقعی هر عنصر در مسیر را حل کند. آی تی
اگر مسیر کامل یا دایرکتوری والد آن وجود داشته باشد، یک مسیر حل شده را برمی گرداند. اگر
دایرکتوری والد وجود دارد اما مسیر کامل وجود ندارد، مورد دایرکتوری والد وجود دارد
به درستی حل شود و بقیه بدون تغییر اضافه شود. به عنوان مثال، اگر فایل
"/Windows/System32/netkvm.sys" وجود دارد:
"مسیر حساس به حروف بزرگ" ("/windows/system32/netkvm.sys")
"Windows/System32/netkvm.sys"
"مسیر حساس به حروف بزرگ" ("/windows/system32/NoSuchFile")
"Windows/System32/NoSuchFile"
"مسیر حساس به حروف بزرگ" ("/windows/system33/netkvm.sys")
ERROR
توجه داشته باشید:: به دلیل رفتار فوق، "مسیر حساس به حروف کوچک" را نمی توان برای بررسی استفاده کرد
وجود یک فایل
توجه داشته باشید:: این تابع نام درایو، اسلش برگشتی و غیره را کنترل نمی کند.
همچنین به "realpath" مراجعه کنید.
گربه
مسیر گربه
محتویات فایلی با نام مسیر را برگردانید.
از آنجا که در C، این تابع یک "char *" برمی گرداند، هیچ راهی برای تمایز بین آنها وجود ندارد
یک کاراکتر "\0" در یک فایل و انتهای رشته. برای مدیریت فایل های باینری، از "فایل خواندن" استفاده کنید.
یا توابع "دانلود".
چکمه
مسیر csumtype checksum
این فراخوانی MD5، SHAx یا CRC چک مجموع فایلی به نام مسیر را محاسبه می کند.
نوع چک جمع برای محاسبه با پارامتر "csumtype" داده می شود که باید دارای یک باشد
از مقادیر زیر:
"crc"
بررسی افزونگی چرخه ای (CRC) که توسط POSIX برای دستور "cksum" مشخص شده است را محاسبه کنید.
"md5"
هش MD5 را محاسبه کنید (با استفاده از برنامه "md5sum").
"sha1"
هش SHA1 را محاسبه کنید (با استفاده از برنامه "sha1sum").
"sha224"
هش SHA224 را محاسبه کنید (با استفاده از برنامه "sha224sum").
"sha256"
هش SHA256 را محاسبه کنید (با استفاده از برنامه "sha256sum").
"sha384"
هش SHA384 را محاسبه کنید (با استفاده از برنامه "sha384sum").
"sha512"
هش SHA512 را محاسبه کنید (با استفاده از برنامه "sha512sum").
چک جمع به عنوان یک رشته قابل چاپ برگردانده می شود.
برای دریافت چک‌سوم برای یک دستگاه، از "checksum-device" استفاده کنید.
برای دریافت چک جمع برای بسیاری از فایل‌ها، از "checksums-out" استفاده کنید.
چک جمع-دستگاه
checksum-device دستگاه csumtype
این تماس مجموع بررسی MD5، SHAx یا CRC محتویات دستگاه نامگذاری شده را محاسبه می کند
"دستگاه". برای انواع چک‌سام‌های پشتیبانی شده، دستور "checksum" را ببینید.
مبلغ چک کردن
دایرکتوری csumtype checksums-out (sumsfile|-)
این دستور چک‌سام‌های تمام فایل‌های معمولی را محاسبه میکند فهرست راهنما و سپس a منتشر می کند
لیستی از آن جمع های کنترلی به فایل خروجی محلی "sumsfile".
این می تواند برای تایید یکپارچگی یک ماشین مجازی استفاده شود. با این حال به درستی
امن باید به خروجی دستور checksum توجه کنید (از آنهایی استفاده می کند
از GNU coreutils). به ویژه هنگامی که نام فایل قابل چاپ نیست، coreutils از a استفاده می کند
نحو خاص بک اسلش برای اطلاعات بیشتر، به فایل اطلاعات Coreutils گنو مراجعه کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
chmod
مسیر حالت chmod
حالت (مجوزها) "path" را به "mode" تغییر دهید. فقط حالت های عددی پشتیبانی می شوند.
توجه داشته باشید:: هنگام استفاده از این دستور از guestfish، "mode" به طور پیش فرض اعشاری خواهد بود، مگر اینکه
شما آن را با 0 پیشوند می کنید تا اکتال شود، یعنی. از 0700 استفاده کن نه 700
حالتی که در واقع تنظیم شده است تحت تأثیر umask قرار می گیرد.
دلم برات تنگ شده
مسیر گروه مالک chown
مالک فایل را به "مالک" و گروه را به "گروه" تغییر دهید.
فقط uid عددی و gid پشتیبانی می شوند. اگر می خواهید از نام ها استفاده کنید، باید مکان یابی کنید
و فایل رمز عبور را خودتان تجزیه کنید (پشتیبانی از Augeas این کار را نسبتاً آسان می کند).
پاک کردن باطن-تنظیم
پاک کردن باطن-تنظیم نام
اگر یک رشته تنظیمات پشتیبان مطابق با "name" یا شروع با "name=" وجود دارد، پس آن
رشته از تنظیمات باطن حذف می شود.
این فراخوانی تعداد رشته های حذف شده را برمی گرداند (که ممکن است 0، 1 یا بیشتر باشد
از 1).
"بازگشت" را در مهمانان(3)، "تنظیمات پشتیبان" در مهمانان(3).
فرمان
دستور "Arguments ..."
این فراخوانی دستوری را از سیستم فایل مهمان اجرا می کند. فایل سیستم باید مانت شده باشد و
باید دارای یک سیستم عامل سازگار باشد (یعنی چیزی لینوکس، با همان یا
معماری پردازنده سازگار).
پارامتر واحد یک لیست آرگومان به سبک argv است. اولین عنصر نام است
برنامه برای اجرا عناصر بعدی پارامتر هستند. لیست باید خالی نباشد (یعنی
باید حاوی نام برنامه باشد). توجه داشته باشید که دستور مستقیما اجرا می شود و هست نه فراخوانی شده از طریق
پوسته (به "sh" مراجعه کنید).
مقدار بازگشتی هر چیزی است که روی آن چاپ شده است stdout توسط فرمان
اگر فرمان وضعیت خروج غیر صفر را برگرداند، این تابع یک خطا برمی گرداند
پیام رشته پیام خطا محتوای آن است استدرر از فرمان.
متغیر محیطی $PATH حداقل شامل خواهد شد / usr / bin و / صندوقچه. اگر نیاز دارید یک
برنامه از مکان دیگری، باید مسیر کامل را در پارامتر اول ارائه دهید.
کتابخانه های مشترک و فایل های داده مورد نیاز برنامه باید در سیستم فایل موجود باشد
که در مکان های صحیح نصب می شوند. این مسئولیت تماس گیرنده است که همه را تضمین کند
فایل سیستم های مورد نیاز در مکان های مناسب نصب می شوند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
خطوط فرمان
خطوط فرمان "آرگمون ها ..."
این همان "فرمان" است، اما نتیجه را به لیستی از خطوط تقسیم می کند.
همچنین ببینید: "sh-lines"
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
فشرده کردن دستگاه
دستگاه ctype فشرده سازی دستگاه (zdevice|-) [سطح:N]
این دستور "device" را فشرده می کند و آن را در فایل محلی "zdevice" می نویسد.
پارامترهای "ctype" و "سطح" اختیاری همان معنی را دارند که در "فشرده کردن" وجود دارد.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
فشرده کردن
فشرده سازی فایل ctype (zfile|-) [سطح:N]
این دستور فشرده می کند پرونده و آن را در فایل محلی می نویسد zfile.
برنامه فشرده سازی مورد استفاده توسط پارامتر "ctype" کنترل می شود. در حال حاضر این
شامل: "فشرده کردن"، "gzip"، "bzip2"، "xz" یا "lzop". برخی از انواع فشرده سازی ممکن است نباشند
توسط بیلدهای خاصی از libguestfs پشتیبانی می شود، در این صورت با خطا مواجه خواهید شد
حاوی رشته فرعی "پشتیبانی نمی شود".
پارامتر اختیاری "سطح" سطح فشرده سازی را کنترل می کند. معنی و پیش فرض برای
این پارامتر به برنامه فشرده سازی مورد استفاده بستگی دارد.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
پیکربندی
پیکربندی hvparam hvvalue
از این می توان برای افزودن پارامترهای Hypervisor دلخواه فرم استفاده کرد -پارام ارزش.
در واقع کاملاً دلخواه نیست - ما از تنظیم برخی از پارامترها جلوگیری می کنیم
با پارامترهایی که استفاده می کنیم تداخل ایجاد می کند.
اولین کاراکتر رشته "hvparam" باید یک "-" (خط تیره) باشد.
"hvvalue" می تواند NULL باشد.
کپی-ویژگی ها
copy-attributes src dest [همه:درست|نادرست] [mode:true|false] [xattributes:true|false] [مالکیت:true|false]
ویژگی های یک مسیر (که می تواند یک فایل یا دایرکتوری باشد) را در مسیر دیگری کپی کنید.
به‌طور پیش‌فرض ویژگی «no» کپی میشود، بنابراین مطمئن شوید که هر (یا «همه» را برای کپی کردن مشخص کنید
همه چيز).
آرگومان های اختیاری مشخص می کنند که کدام ویژگی ها را می توان کپی کرد:
"حالت"
بخشی از حالت فایل را از «منبع» به «مقصد» کپی کنید. فقط مجوزهای یونیکس
و بیت های sticky/setuid/setgid قابل کپی هستند.
"خصلت ها"
ویژگی های توسعه یافته لینوکس (xattrs) را از "source" به "destination" کپی کنید. این پرچم
هیچ کاری نمی کند اگر linuxxattrs ویژگی در دسترس نیست (به "ویژگی در دسترس" مراجعه کنید).
"مالکیت"
uid مالک و گروه gid "منبع" را در "مقصد" کپی کنید.
"همه"
نسخه تمام صفات از «منبع» تا «مقصد». فعال کردن آن همه را فعال می کند
پرچم های دیگر، اگر قبلاً مشخص نشده باشند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
کپی از دستگاه به دستگاه
کپی-دستگاه-به-دستگاه src dest [srcoffset:N] [destoffset:N] [اندازه:N] [sparse:true|false] [append:true|false]
این چهار مورد «کپی-دستگاه-به-دستگاه»، «کپی-دستگاه-به-فایل»، «کپی-فایل به-دستگاه» و
"copy-file-to-file" به شما امکان می دهد از یک منبع (دستگاه|فایل) به مقصد کپی کنید.
(دستگاه|فایل).
می‌توان کپی‌های جزئی ایجاد کرد زیرا می‌توانید به‌صورت اختیاری مبدأ و مقصد را تعیین کنید
افست و اندازه برای کپی. این مقادیر همه در بایت مشخص می شوند. اگر داده نشود،
هم پیش‌فرض را صفر میکند و هم اندازه را تا حد امکان کپی میکند
ما انتهای منبع را می زنیم.
منبع و مقصد ممکن است یک شی باشند. با این حال ممکن است مناطق همپوشانی نداشته باشند
درست کپی شده
اگر مقصد یک فایل باشد، در صورت نیاز ایجاد می شود. اگر فایل مقصد نیست
به اندازه کافی بزرگ است، گسترش یافته است.
اگر مقصد یک فایل است و پرچم "پیوست" تنظیم نشده است، فایل مقصد
کوتاه شده است. اگر پرچم "افزودن" تنظیم شده باشد، کپی به فایل مقصد اضافه می شود.
در حال حاضر نمی‌توان پرچم «پیوست» را برای دستگاه‌ها تنظیم کرد.
اگر پرچم "sparse" درست باشد، فراخوانی از نوشتن بلوک هایی که فقط حاوی صفر هستند، اجتناب می کند.
که می تواند در برخی شرایط که دیسک پشتیبان نازک است کمک کند. توجه داشته باشید که
مگر اینکه هدف قبلاً صفر شده باشد، استفاده از این گزینه منجر به کپی نادرست می شود.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
کپی دستگاه به فایل
کپی-دستگاه-به-فایل src dest [srcoffset:N] [destoffset:N] [اندازه:N] [sparse:true|false] [append:true|false]
برای یک نمای کلی از این تماس، «کپی-دستگاه به دستگاه» را ببینید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
کپی فایل به دستگاه
کپی فایل به دستگاه src مقصد [srcoffset:N] [destoffset:N] [اندازه:N] [sparse:true|false] [append:true|false]
برای یک نمای کلی از این تماس، «کپی-دستگاه به دستگاه» را ببینید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
کپی فایل به فایل
کپی-فایل-به-فایل src dest [srcoffset:N] [destoffset:N] [اندازه:N] [sparse:true|false] [append:true|false]
برای یک نمای کلی از این تماس، «کپی-دستگاه به دستگاه» را ببینید.
این هست نه عملکردی که برای کپی کردن فایل ها می خواهید. این برای کپی کردن بلوک های درون است
فایل های موجود برای اطلاع از عملکردهای کلی کپی و جابجایی فایل، به "cp"، "cp-a" و "mv" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
اندازه کپی
کپی-اندازه اندازه دست src
این دستور دقیقاً بایت های "size" را از یک دستگاه منبع یا فایل "src" به دیگری کپی می کند
دستگاه مقصد یا فایل «dest».
توجه داشته باشید که اگر منبع خیلی کوتاه باشد یا مقصد به اندازه کافی بزرگ نباشد، این کار با شکست مواجه خواهد شد.
این تابع is منسوخ. در کد جدید، به جای آن از تماس «کپی-دستگاه-به-دستگاه» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
cp
cp src dest
این یک فایل را از "src" به "dest" کپی می کند که در آن "dest" یا نام فایل مقصد است یا
فهرست مقصد
cp-a
cp-a src dest
این یک فایل یا دایرکتوری را از "src" به "dest" به صورت بازگشتی با استفاده از "cp -a" کپی می کند.
فرمان
cp-r
cp-r src dest
این یک فایل یا دایرکتوری را از "src" به "dest" به صورت بازگشتی با استفاده از "cp -rP" کپی می کند.
فرمان
اکثر کاربران باید به جای آن از "cp-a" استفاده کنند. این دستور زمانی مفید است که شما نمی خواهید
مجوزها را حفظ کنید، زیرا سیستم فایل هدف از آن پشتیبانی نمی کند (در درجه اول زمانی که
نوشتن در فایل سیستم های DOS FAT).
cpio out
فهرست cpio-out (cpiofile|-) [قالب:..]
این دستور محتویات را بسته بندی می کند فهرست راهنما و آن را در فایل محلی "cpiofile" دانلود می کند.
برای انتخاب قالب می توان از پارامتر اختیاری "format" استفاده کرد. فقط موارد زیر
فرمت ها در حال حاضر مجاز هستند:
"newc"
فرمت قابل حمل جدید (SVR4). این فرمت اتفاقاً با cpio-like سازگار است
فرمت مورد استفاده توسط هسته لینوکس برای initramfs.
این فرمت پیش فرض است.
"crc"
فرمت قابل حمل جدید (SVR4) با چک جمع.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
dd
dd src dest
این دستور از یک دستگاه مبدا یا فایل "src" به دستگاه مقصد دیگری کپی می شود
فایل "dest". معمولاً از این برای کپی کردن یا از یک دستگاه یا پارتیشن استفاده می‌کنید
مثال برای کپی کردن یک فایل سیستم
اگر مقصد یک دستگاه است، باید به اندازه فایل منبع یا بزرگتر باشد
دستگاه، در غیر این صورت کپی ناموفق خواهد بود. این دستور نمی تواند کپی های جزئی انجام دهد (به "copy- مراجعه کنید"
دستگاه به دستگاه").
این تابع is منسوخ. در کد جدید، به جای آن از تماس «کپی-دستگاه-به-دستگاه» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
دستگاه-شاخص
دستگاه شاخص دستگاه
این تابع نام دستگاه را می گیرد (به عنوان مثال "/dev/sdb") و فهرست دستگاه را در
لیست دستگاه ها
اعداد فهرست از 0 شروع می شوند. دستگاه نامگذاری شده باید وجود داشته باشد، به عنوان مثال به عنوان یک رشته بازگشتی
از "list-devices".
همچنین به "list-devices"، "part-to-dev" مراجعه کنید.
df
df
این دستور دستور "df" را برای گزارش فضای دیسک استفاده شده اجرا می کند.
این دستور بیشتر برای جلسات تعاملی مفید است. این است نه قصد داشتی تلاش کنی
برای تجزیه رشته خروجی از "statvfs" از برنامه ها استفاده کنید.
df-h
df-h
این دستور دستور "df -h" را برای گزارش فضای دیسک مورد استفاده در قالب قابل خواندن توسط انسان اجرا می کند.
این دستور بیشتر برای جلسات تعاملی مفید است. این است نه قصد داشتی تلاش کنی
برای تجزیه رشته خروجی از "statvfs" از برنامه ها استفاده کنید.
ایجاد دیسک
اندازه فرمت نام فایل دیسک ایجاد [backingfile:..] [backingformat:..] [preallocation:..] [compat:..] [clustersize:N]
یک تصویر دیسک خالی به نام ایجاد کنید نام فایل (فایل میزبان) با فرمت "فرمت" (معمولا
"خام" یا "qcow2"). اندازه "اندازه" بایت است.
اگر با پارامتر اختیاری "backingfile" استفاده شود، یک عکس فوری در بالای آن ایجاد می شود
فایل پشتیبان در این مورد، "اندازه" باید به عنوان "-1" ارسال شود. اندازه عکس فوری
اندازه فایل پشتیبان است که به صورت خودکار کشف می شود. شما هستید
تشویق میشود که برای توصیف قالب «backingfile»، «backingformat» را نیز ارسال کند.
If نام فایل به یک دستگاه بلوک اشاره دارد، سپس دستگاه فرمت می شود. "اندازه" نادیده گرفته می شود
از آنجایی که دستگاه های بلوک دارای اندازه ذاتی هستند.
سایر پارامترهای اختیاری عبارتند از:
"پیش تخصیص"
اگر قالب "خام" است، برای ایجاد یک قالب می تواند "خاموش" (یا "پراکنده") یا "پر" باشد.
به ترتیب پراکنده یا به طور کامل اختصاص داده شده است. پیش فرض "خاموش" است.
اگر قالب "qcow2" باشد، این می تواند "خاموش" (یا "پراکنده")، "متاداده" یا "کامل" باشد.
تخصیص پیش داده‌ها می‌تواند در هنگام نوشتن زیاد سریع‌تر باشد، اما از فضای بیشتری استفاده میکند.
پیش فرض "خاموش" است.
"همکار"
فقط "qcow2": برای استفاده از قالب پیشرفته qcow1.1 که توسط qemu ≥ پشتیبانی می شود، رشته 2 را ارسال کنید.
1.1.
"اندازه خوشه"
فقط "qcow2": اندازه خوشه qcow2 را تغییر دهید. پیش فرض 65536 (بایت) است و این
تنظیم ممکن است هر توان دو بین 512 و 2097152 باشد.
توجه داشته باشید که این تماس دیسک جدید را به دسته اضافه نمی کند. ممکن است لازم باشد "افزودن
drive-opts" به طور جداگانه.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
فرمت دیسک
نام فایل با فرمت دیسک
فرمت تصویر دیسک نامیده شده را شناسایی و برگردانید نام فایل. نام فایل همچنین می تواند یک
دستگاه میزبان و غیره. اگر فرمت تصویر شناسایی نشد، «ناشناخته» است
برگشت
توجه داشته باشید که تشخیص فرمت دیسک در برخی شرایط ممکن است ناامن باشد. دیدن
"CVE-2010-3851" در مهمانان(3).
همچنین نگاه کنید به: "DISK IMAGE FORMATS" در مهمانان(3)
disk-has-backing-file
نام فایل disk-has-backing-file
تشخیص و برگرداندن تصویر دیسک نام فایل دارای یک فایل پشتیبان
توجه داشته باشید که شناسایی ویژگی‌های دیسک تحت برخی شرایط می‌تواند ناامن باشد. دیدن
"CVE-2010-3851" در مهمانان(3).
دیسک-مجازی-اندازه
نام فایل دیسک با اندازه مجازی
اندازه مجازی را بر حسب بایت از تصویر دیسک نامیده شده شناسایی و برگردانید نام فایل.
توجه داشته باشید که شناسایی ویژگی‌های دیسک تحت برخی شرایط می‌تواند ناامن باشد. دیدن
"CVE-2010-3851" در مهمانان(3).
dmesg
dmesg
این پیام های هسته (خروجی "dmesg") را از هسته مهمان برمی گرداند. این هست
گاهی اوقات برای رفع اشکال طولانی مشکلات مفید است.
راه دیگر برای به دست آوردن اطلاعات مشابه، فعال کردن پیام های پرمخاطب با "set-verbose" است.
یا با تنظیم متغیر محیطی "LIBGUESTFS_DEBUG=1" قبل از اجرای برنامه.
دانلود
دانلود نام فایل راه دور (نام فایل|-)
دریافت فایل نام فایل راه دور و آن را ذخیره کنید به عنوان نام فایل روی ماشین محلی
نام فایل همچنین می تواند یک لوله با نام باشد.
همچنین به "آپلود"، "گربه" مراجعه کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
دانلود-افست
دانلود-افست نام فایل راه دور (نام فایل|-) اندازه افست
دریافت فایل نام فایل راه دور و آن را ذخیره کنید به عنوان نام فایل روی ماشین محلی
نام فایل راه دور برای بایت های "اندازه" خوانده می شود که از "offset" شروع می شود (این منطقه باید در داخل باشد
فایل یا دستگاه).
توجه داشته باشید که هیچ محدودیتی در میزان داده قابل دانلود با این تماس وجود ندارد.
برخلاف "pread"، و این تماس همیشه مقدار کامل را می خواند مگر اینکه خطایی رخ دهد.
همچنین به "دانلود"، "پاداش" مراجعه کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
حافظه پنهان
whattodrop را ذخیره می کند
این به هسته مهمان دستور می دهد تا کش صفحه خود را حذف کند، و/یا دنتری ها و کش های اینود را حذف کند.
پارامتر "whattodrop" به هسته می گوید که دقیقا چه چیزی را رها کند، ببینید
http://linux-mm.org/Drop_Caches
تنظیم "whattodrop" روی 3 باید همه چیز را حذف کند.
این به طور خودکار تماس می گیرد همگام(2) قبل از عملیات، به طوری که حداکثر حافظه مهمان است
آزاد شد.
du
دو مسیر
این دستور دستور "du -s" را برای تخمین استفاده از فضای فایل برای "path" اجرا می کند.
"path" می تواند یک فایل یا یک فهرست باشد. اگر "مسیر" یک دایرکتوری باشد، تخمین شامل آن می شود
محتویات دایرکتوری و همه زیر شاخه ها (به صورت بازگشتی).
نتیجه اندازه تخمین زده شده در است کیلوبایت (یعنی واحدهای 1024 بایتی).
e2fsck
دستگاه e2fsck [درست:درست|نادرست] [forceall:true|false]
این بررسی کننده سیستم فایل ext2/ext3 را روی "دستگاه" اجرا می کند. می تواند موارد زیر را به خود اختصاص دهد
آرگومان های اختیاری:
"درست"
تعمیر خودکار فایل سیستم این گزینه باعث می شود e2fsck به طور خودکار
هر گونه مشکل سیستم فایل را که می توان با خیال راحت بدون دخالت انسان برطرف کرد، برطرف کنید.
این گزینه ممکن است همزمان با گزینه "forceall" مشخص نشود.
"اجبار کردن"
پاسخ "بله" به همه سوالات را فرض کنید. اجازه می دهد تا e2fsck غیر از
به صورت تعاملی
این گزینه ممکن است همزمان با گزینه "درست" مشخص نشود.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
e2fsck-f
دستگاه e2fsck-f
این دستگاه "e2fsck -p -f" را اجرا می کند. بررسی کننده سیستم فایل ext2/ext3 را روی "دستگاه" اجرا می کند،
غیر تعاملی (-p، حتی اگر سیستم فایل تمیز به نظر برسد (-f).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "e2fsck" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
پژواک دیمون
پژواک دیمون "کلمات ..."
این دستور لیستی از "کلمات" ارسال شده را با فاصله های تکی بین آنها و
رشته حاصل را برمی گرداند.
می توانید از این دستور برای آزمایش اتصال به دیمون استفاده کنید.
همچنین به "پینگ دیمون" مراجعه کنید.
egrep
مسیر egrep regex
این برنامه خارجی "egrep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
egrepi
مسیر egrepi regex
این برنامه خارجی "egrep -i" را فراخوانی می کند و خطوط منطبق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
برابر
برابر file1 file2
این دو فایل را با هم مقایسه می کند file1 و file2 و اگر محتوای آنها دقیقاً باشد، true را برمی گرداند
برابر، یا نادرست در غیر این صورت.
بیرونی CMPاز برنامه (1) برای مقایسه استفاده می شود.
وجود دارد
مسیر وجود دارد
اگر و تنها در صورتی که یک فایل، دایرکتوری (یا هر چیز دیگری) همراه با داده‌شده وجود داشته باشد، "درست" را برمی‌گرداند
نام "مسیر".
همچنین به "is-file"، "is-dir"، "stat" مراجعه کنید.
اکستلینکس
دایرکتوری extlinux
بوت لودر SYSLINUX را روی دستگاه نصب شده نصب کنید فهرست راهنما. بر خلاف "syslinux"
که به یک سیستم فایل FAT نیاز دارد، این می تواند در فایل سیستم ext2/3/4 یا btrfs استفاده شود.
La فهرست راهنما پارامتر می تواند یک نقطه mount یا یک دایرکتوری در mountpoint باشد.
همچنین باید پارتیشن را به‌عنوان «اکتیو» («پارت‌تنظیم‌پذیر») و Master Boot علامت‌گذاری کنید.
رکورد باید روی اولین بخش کل نصب شود (مثلاً با استفاده از "pwrite-device").
دیسک بسته SYSLINUX با تعدادی رکوردهای Master Boot مناسب ارائه می شود. را ببینید
اکستلینکس(1) صفحه مرد برای اطلاعات بیشتر.
پیکربندی اضافی را می توان با قرار دادن یک فایل به نام SYSLINUX ارائه کرد
extlinux.conf در فایل سیستم زیر فهرست راهنما. برای اطلاعات بیشتر در مورد
محتویات این فایل را ببینید اکستلینکس(1).
همچنین به "syslinux" مراجعه کنید.
سقوط کردن
مسیر سقوط لن
این دستور یک فایل (حاوی صفر بایت) به نام "path" با اندازه "len" بایت را از قبل اختصاص می دهد.
اگر فایل از قبل وجود داشته باشد، بازنویسی می شود.
این را با دستور "alloc" مخصوص guestfish که یک فایل را به آن اختصاص می دهد اشتباه نگیرید
میزبان و آن را به عنوان یک دستگاه متصل می کند.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "fallocate64" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
fallocate64
مسیر len fallocate64
این دستور یک فایل (حاوی صفر بایت) به نام "path" با اندازه "len" بایت را از قبل اختصاص می دهد.
اگر فایل از قبل وجود داشته باشد، بازنویسی می شود.
توجه داشته باشید که این فراخوان بلوک های دیسک را برای فایل اختصاص می دهد. برای ایجاد یک فایل پراکنده استفاده کنید
در عوض "قطع اندازه".
تماس منسوخ "fallocate" همین کار را می کند، اما به دلیل یک نادیده گرفتن فقط مجاز است
طول 30 بیتی که باید مشخص شود، به طور موثر حداکثر اندازه فایل های ایجاد شده را محدود می کند
از طریق آن تماس به 1 گیگابایت.
این را با دستورهای "alloc" و "sparse" مخصوص ماهی مهمان که ایجاد می کنند اشتباه نگیرید.
یک فایل در هاست و پیوست آن به عنوان یک دستگاه.
ویژگی در دسترس
«گروه‌های...» با قابلیت در دسترس
این همان "در دسترس" است، اما بر خلاف آن فراخوان، یک true/false ساده را برمی گرداند
نتیجه بولی، به جای پرتاب استثنا در صورت یافت نشدن یک ویژگی. برای دیگر
مستندات را ببینید "در دسترس".
fgrep
مسیر الگوی fgrep
این برنامه خارجی "fgrep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
fgrepi
مسیر الگوی fgrepi
این برنامه خارجی "fgrep -i" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
پرونده
مسیر فایل
این تماس از استاندارد استفاده می کند پرونده(1) دستور برای تعیین نوع یا محتویات فایل.
این فراخوانی همچنین به طور شفاف به انواع فایل های فشرده نگاه می کند.
دستور دقیقی که اجرا می شود "مسیر file -zb" است. به ویژه توجه داشته باشید که نام فایل است
به خروجی تعبیه نشده است ( -b گزینه).
خروجی به خروجی زیربنا بستگی دارد پرونده(1) فرمان و می تواند تغییر کند
آینده به روش هایی خارج از کنترل ما به عبارت دیگر، خروجی تضمین نمی شود
ABI.
همچنین نگاه کنید به: پرونده(1)، "vfs-type"، "lstat"، "is-file"، "is-blockdev" (و غیره)، "is-zero".
فایل-معماری
فایل-معماری نام فایل
این معماری باینری را تشخیص می دهد نام فایل، و در صورت اطلاع آن را برمی گرداند.
معماری های تعریف شده فعلی عبارتند از:
"i386"
این رشته برای همه باینری های 32 بیتی i386, i486, i586, i686 صرف نظر از
نیازهای دقیق پردازنده باینری
"x86_64"
64 بیت x86-64.
"اسپارک"
SPARC 32 بیتی
"sparc64"
64 بیت SPARC V9 و بالاتر.
"ia64"
اینتل ایتانیوم.
"ppc"
کامپیوتر 32 بیتی پاور.
"ppc64"
کامپیوتر 64 بیتی پاور.
"بازو"
32 بیت ARM.
"aarch64"
64 بیت ARM.
Libguestfs ممکن است در آینده رشته های معماری دیگری را برگرداند.
این تابع حداقل بر روی انواع فایل های زیر کار می کند:
· بسیاری از انواع باینری Un*x و Linux
· بسیاری از انواع کتابخانه مشترک Un*x و Linux
· باینری های Win32 و Win64 ویندوز
· DLL های Win32 و Win64 ویندوز
باینری های Win32 و DLL ها "i386" را برمی گرداند.
باینری ها و DLL های Win64 "x86_64" را برمی گرداند.
· ماژول های هسته لینوکس
· تصاویر initrd به سبک جدید لینوکس
برخی از هسته های vmlinuz لینوکس غیر x86
کاری که در حال حاضر نمی تواند انجام دهد:
· کتابخانه های ایستا (libfoo.a)
· لینوکس به سبک قدیمی initrd به عنوان فایل سیستم فشرده ext2 (RHEL 3)
· کرنل های x86 لینوکس vmlinuz
تصاویر x86 vmlinuz (فرمت bzImage) از ترکیبی از کدهای 16، 32 و فشرده تشکیل شده است.
و باز کردن بسته بندی آن بسیار سخت است. اگر می خواهید معماری یک هسته را پیدا کنید،
به جای آن از معماری initrd یا ماژول(های) هسته مرتبط استفاده کنید.
حجم فایل
فایل اندازه فایل
این دستور اندازه را برمی گرداند پرونده در بایت
برای دریافت سایر آمارها در مورد یک فایل، از "stat"، "lstat"، "is-dir"، "is-file" و غیره استفاده کنید.
اندازه دستگاه های بلوک، از "blockdev-getsize64" استفاده کنید.
فایل سیستم در دسترس
فایل سیستم در دسترس
بررسی کنید که آیا libguestfs از سیستم فایل نامگذاری شده پشتیبانی می کند یا خیر. آرگومان "فایل سیستم" یک است
نام فایل سیستم، مانند "ext3".
قبل از استفاده از این دستور باید "راه اندازی" را فراخوانی کنید.
این عمدتا به عنوان یک تست منفی مفید است. اگر این مقدار true باشد، به این معنی نیست که a
فایل سیستم خاصی را می توان ایجاد یا نصب کرد، زیرا سیستم فایل ممکن است برای سایر سیستم ها شکست بخورد
دلایلی مانند نسخه بعدی سیستم فایل یا ناسازگار بودن آن
ویژگی ها، یا فاقد mkfs مناسب.fs> ابزار.
همچنین به "در دسترس"، "ویژگی در دسترس"، "AVAILABILITY" در مهمانان(3).
پر کردن
مسیر c len را پر کنید
این دستور یک فایل جدید به نام مسیر ایجاد می کند. محتوای اولیه فایل "len" است.
اکتت های "c"، که در آن "c" باید عددی در محدوده "[0..255]" باشد.
برای پر کردن یک فایل با صفر بایت (به صورت پراکنده)، استفاده از "truncate- بسیار کارآمدتر است.
اندازه". برای ایجاد یک فایل با الگوی بایت های تکرار شونده از "fill-pattern" استفاده کنید.
پر کردن
fill-dir dir nr
این تابع که برای آزمایش سیستم های فایل مفید است، فایل های خالی "nr" را در دایرکتوری ایجاد می کند
"dir" با نام های 00000000 تا "nr-1" (یعنی نام هر فایل 8 رقمی است که با آن پر شده است.
صفر).
الگوی پر کردن
الگوی پر کردن مسیر لن
این تابع مانند "fill" است با این تفاوت که یک فایل جدید با طول "len" ایجاد می کند
الگوی تکراری بایت ها در "الگو". الگو در صورت لزوم کوتاه می شود
مطمئن شوید که طول فایل دقیقا "لن" بایت است.
پیدا کردن
پیدا کردن دایرکتوری
این دستور همه فایل ها و دایرکتوری ها را به صورت بازگشتی و با شروع لیست فهرست می کند فهرست راهنما. آن
در اصل معادل اجرای دستور پوسته "find directory -print" است اما برخی از آنها
پس پردازش در خروجی اتفاق می افتد که در زیر توضیح داده شده است.
این یک لیست از رشته ها را برمی گرداند بدون هر پیشوند. بنابراین اگر ساختار دایرکتوری این بود:
/tmp/a
/tmp/b
/tmp/c/d
سپس لیست بازگشتی از "یافتن" دایرکتوری / tmp 4 عنصر خواهد بود:
a
b
c
c/d
If فهرست راهنما یک دایرکتوری نیست، سپس این دستور یک خطا برمی گرداند.
لیست برگشتی مرتب شده است.
پیدا کردن 0
find0 فهرست (فایل ها|-)
این دستور همه فایل ها و دایرکتوری ها را به صورت بازگشتی و با شروع لیست فهرست می کند فهرست راهنما,
قرار دادن لیست به دست آمده در فایل خارجی به نام فایل ها.
این دستور مانند "find" با استثناهای زیر عمل می کند:
· لیست به دست آمده در یک فایل خارجی نوشته می شود.
· آیتم ها (نام فایل ها) در نتیجه با کاراکترهای "\0" از هم جدا می شوند. دیدن پیدا کردن(1) گزینه
-چاپ0.
· لیست نتایج مرتب نشده است.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
findfs-label
برچسب findfs-label
این دستور فایل سیستم ها را جستجو می کند و فایلی را که برچسب داده شده را دارد برمی گرداند. یک
اگر چنین فایل سیستمی پیدا نشود، خطا برمی گردد.
برای پیدا کردن برچسب یک فایل سیستم، از "vfs-label" استفاده کنید.
findfs-uuid
findfs-uuid uuid
این دستور فایل سیستم ها را جستجو می کند و فایلی را که دارای UUID داده شده است برمی گرداند. یک
اگر چنین فایل سیستمی پیدا نشود، خطا برمی گردد.
برای پیدا کردن UUID یک فایل سیستم، از "vfs-uuid" استفاده کنید.
البته معمولا
دستگاه fsck fstyle
این بررسی کننده سیستم فایل (fsck) را روی "دستگاه" اجرا می کند که باید نوع سیستم فایل را داشته باشد
"fstyle".
عدد صحیح برگشتی وضعیت است. دیدن البته معمولا(8) برای لیست کدهای وضعیت از "fsck".
یادداشت:
· کدهای وضعیت چندگانه را می توان با هم جمع کرد.
· یک کد بازگشتی غیر صفر می تواند به معنای "موفقیت" باشد، برای مثال اگر خطاها تصحیح شده باشند
روی سیستم فایل
· بررسی یا تعمیر حجم های NTFS پشتیبانی نمی شود (توسط linux-ntfs).
این دستور کاملاً معادل اجرای "fsck -a -t fstype device" است.
fstream
نقطه اتصال fstrim [offset:N] [length:N] [minimumfreeextent:N]
فضای خالی در سیستم فایل نصب شده روی "mountpoint" را کوتاه کنید. فایل سیستم باید باشد
خواندن و نوشتن نصب شده است.
محتویات سیستم فایل تحت تأثیر قرار نمی گیرند، اما هر فضای خالی در سیستم فایل تحت تأثیر قرار می گیرد
"بریده شده"، یعنی به دستگاه میزبان بازگردانده می شود، بنابراین تصاویر دیسک پراکنده تر می شود.
امکان استفاده مجدد از فضای بلااستفاده در فایل های qcow2 و غیره.
این عملیات به پشتیبانی در libguestfs، سیستم فایل نصب شده، میزبان نیاز دارد
سیستم فایل، qemu و هسته میزبان. اگر این پشتیبانی وجود نداشته باشد ممکن است خطا بدهد
یا حتی به نظر می رسد که در حال اجرا است اما هیچ کاری انجام نمی دهد.
همچنین به "فضای بدون صفر" مراجعه کنید. این یک عملیات کمی متفاوت است که فضای آزاد را تبدیل می کند
در فایل سیستم به صفر می رسد. این معتبر است که "fstrim" را به جای یا بعد از آن فراخوانی کنید
فراخوانی "فضای آزاد صفر".
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
اضافه کردن
اضافه کردن
گزینه های کرنل اضافی را که به هسته دستگاه libguestfs اضافه شده اند برگردانید
خط فرمان.
اگر "NULL" باشد، هیچ گزینه ای اضافه نمی شود.
روش اتصال
روش اتصال
باطن فعلی را برگردانید.
به "set-backend" و "BACKEND" در اینجا مراجعه کنید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "get-backend" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
دریافت خودکار
دریافت خودکار
پرچم همگام سازی خودکار را دریافت کنید.
بازگشت به عقب
بازگشت به عقب
باطن فعلی را برگردانید.
این ویژگی handle قبلا "متد پیوست" نامیده می شد.
به "set-backend" و "BACKEND" در اینجا مراجعه کنید مهمانان(3).
گرفتن-پشت-تنظیم
نام get-backend-setting
یک رشته تنظیمات پشتیبان را پیدا کنید که یا "name" است یا با "name=" شروع می شود. اگر "نام"،
این رشته "1" را برمی گرداند. اگر "name="، این قسمت را بعد از علامت مساوی برمی گرداند
(که ممکن است یک رشته خالی باشد).
اگر چنین تنظیماتی یافت نشد، این تابع خطا می دهد. خطا (به "آخرین خطا" مراجعه کنید)
در این مورد "ESRCH" خواهد بود.
"بازگشت" را در مهمانان(3)، "تنظیمات پشتیبان" در مهمانان(3).
تنظیمات دریافت پشتیبان
تنظیمات دریافت پشتیبان
تنظیمات باطن فعلی را برگردانید.
این تماس تمام رشته های تنظیمات پشتیبان را برمی گرداند. اگر می خواهید یک باطن واحد پیدا کنید
تنظیمات، به "get-backend-setting" مراجعه کنید.
"بازگشت" را در مهمانان(3)، "تنظیمات پشتیبان" در مهمانان(3).
دریافت کش
دریافت کش
دایرکتوری مورد استفاده توسط دسته برای ذخیره کش دستگاه را دریافت کنید.
دریافت مستقیم
دریافت مستقیم
پرچم حالت دستگاه مستقیم را برگردانید.
get-e2attrs
فایل get-e2attrs
این ویژگی های فایل مرتبط با آن را برمی گرداند پرونده.
ویژگی ها مجموعه ای از بیت های مرتبط با هر ایند هستند که بر رفتار آن تأثیر می گذارند
پرونده. ویژگی ها به صورت رشته ای از حروف برگردانده می شوند (در زیر توضیح داده شده است). در
ممکن است رشته خالی باشد، که نشان می دهد هیچ ویژگی فایلی برای این فایل تنظیم نشده است.
این ویژگی ها تنها زمانی وجود دارند که فایل در یک سیستم فایل ext2/3/4 قرار گرفته باشد.
استفاده از این فراخوانی در سایر انواع سیستم فایل منجر به خطا می شود.
کاراکترها (ویژگی های فایل) در رشته برگشتی در حال حاضر عبارتند از:
'A' وقتی به فایل دسترسی پیدا می شود، زمان آن تغییر نمی کند.
'a' فایل فقط ضمیمه است.
'c' فایل روی دیسک فشرده شده است.
'D' (فقط دایرکتوری ها.) تغییرات در این فهرست به طور همزمان روی دیسک نوشته می شود.
'd' فایل کاندیدای پشتیبان گیری نیست (نگاه کنید به موادی که موقتا برای استعمال انبار میشود(8).
'E' فایل دارای خطاهای فشرده سازی است.
'e' فایل از وسعت استفاده می کند.
'h' فایل در حال ذخیره بلوک های خود در واحدهای اندازه بلوک سیستم فایل است
بخش ها
'I' (فقط دایرکتوری ها.) دایرکتوری از درخت های هش شده استفاده می کند.
'i' فایل تغییرناپذیر است. نمی توان آن را اصلاح، حذف یا تغییر نام داد. هیچ پیوندی نمی تواند باشد
برای این فایل ایجاد شده است.
'j' فایل به صورت داده ژورنال شده است.
's' هنگامی که فایل حذف می شود، تمام بلوک های آن صفر می شود.
'S' تغییرات این فایل به طور همزمان روی دیسک نوشته می شود.
'T' (فقط دایرکتوری ها) این یک اشاره به تخصیص دهنده بلوک است که زیرشاخه ها را تشکیل می دهد
موجود در این دایرکتوری باید در بین بلوک ها پخش شود. اگر وجود ندارد، بلوک
allocator سعی می کند زیر شاخه ها را با هم گروه بندی کند.
't' برای یک فایل، این ادغام دنباله را غیرفعال می کند. (توسط پیاده سازی های بالادستی استفاده نمی شود
ext2.)
'u' هنگامی که فایل حذف میشود، بلوک‌های آن ذخیره می‌شوند و اجازه می‌دهند فایل حذف شود.
'X' محتویات خام فایل فشرده قابل دسترسی است.
'Z' فایل فشرده کثیف است.
ممکن است بعداً ویژگی های فایل بیشتری به این لیست اضافه شود. ممکن است همه ویژگی های فایل تنظیم نشده باشند
برای انواع فایل ها برای اطلاعات دقیق، با گفتگو(1) صفحه مرد.
همچنین به "set-e2attrs" مراجعه کنید.
این ویژگی ها را با ویژگی های توسعه یافته اشتباه نگیرید (به "getxattr" مراجعه کنید).
get-e2generation
فایل get-e2generation
این تولید فایل ext2 یک فایل را برمی گرداند. نسلی (که قبلاً نامیده می شد
"نسخه") عددی است که با یک ایند مرتبط است. این بیشتر توسط NFS استفاده می شود
سرورها
تولید تنها زمانی وجود دارد که فایل در یک سیستم فایل ext2/3/4 قرار داشته باشد. استفاده كردن
این فراخوانی در انواع دیگر فایل سیستم منجر به خطا می شود.
به "set-e2generation" مراجعه کنید.
get-e2label
دستگاه get-e2label
این برچسب ext2/3/4 فایل سیستم فایل سیستم را در "دستگاه" برمی گرداند.
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی "vfs-label" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
get-e2uuid
دستگاه get-e2uuid
این UUID سیستم فایل ext2/3/4 سیستم فایل روی «دستگاه» را برمی‌گرداند.
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی "vfs-uuid" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
get-hv
get-hv
باینری هایپروایزر فعلی را برگردانید.
این همیشه غیر NULL است. اگر قبلاً تنظیم نشده بود، این دستور qemu پیش‌فرض را برمی‌گرداند
نام باینری
دریافت شناسه
دریافت شناسه
شناسه دسته را دریافت کنید. به "مجموعه شناسه" مراجعه کنید.
get-libvirt-requested-credential-challenge
شاخص get-libvirt-درخواست شده-credential-challenge
چالش (ارائه شده توسط libvirt) برای "index"'امین اعتبار درخواستی را دریافت کنید. اگر
libvirt چالشی ارائه نکرده است، این رشته خالی "" را برمی گرداند.
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
get-libvirt-requested-credential-defresult
فهرست get-libvirt-درخواست شده-credential-defresult
نتیجه پیش فرض (ارائه شده توسط libvirt) را برای "index"'امین اعتبار درخواستی دریافت کنید. اگر
libvirt یک نتیجه پیش فرض ارائه نکرده است، این رشته خالی "" را برمی گرداند.
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
get-libvirt-requested-credential-prompt
ایندکس get-libvirt-requested-credential-prompt
درخواست (ارائه شده توسط libvirt) برای "index"'امین اعتبار درخواستی را دریافت کنید. اگر libvirt
درخواستی ارائه نکرد، این رشته خالی "" را برمی گرداند.
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
get-libvirt-requested-credentials
get-libvirt-requested-credentials
این فقط باید در طول تماس مجدد رویداد برای رویدادهای از نوع فراخوانی شود
"GUESTFS_EVENT_LIBVIRT_AUTH".
لیستی از اعتبارنامه های درخواست شده توسط libvirt را برگردانید. مقادیر ممکن زیر مجموعه ای از
رشته هایی که هنگام فراخوانی "set-libvirt-supported-credentials" ارائه می شوند.
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
گرفتن - memsize
گرفتن - memsize
این اندازه حافظه را بر حسب مگابایت به هایپروایزر اختصاص می دهد.
اگر "set-memsize" در این دسته فراخوانی نشده بود، و اگر "LIBGUESTFS_MEMSIZE" تنظیم نشده بود،
سپس این مقدار پیش فرض کامپایل شده را برای memsize برمی گرداند.
برای اطلاعات بیشتر در مورد معماری libguestfs، نگاه کنید مهمانان(3).
دریافت شبکه
دریافت شبکه
این پرچم فعال شبکه را برمی گرداند.
مسیر رسیدن
مسیر رسیدن
مسیر جستجوی فعلی را برگردانید.
این همیشه غیر NULL است. اگر قبلاً تنظیم نشده بود، به حالت پیش فرض برمی گردد
مسیر.
get-pgroup
get-pgroup
این پرچم گروه فرآیند را برمی گرداند.
گیج شدن
pid
گیج شدن
شناسه فرآیند هایپروایزر را برگردانید. اگر هایپروایزر در حال اجرا نیست، پس این
یک خطا را برمی گرداند.
این یک تماس داخلی است که برای اشکال زدایی و آزمایش استفاده می شود.
دریافت برنامه
دریافت برنامه
نام برنامه را دریافت کنید. به "تنظیم برنامه" مراجعه کنید.
get-qemu
get-qemu
Hypervisor فعلی باینری (معمولا qemu) را برگردانید.
این همیشه غیر NULL است. اگر قبلاً تنظیم نشده بود، این دستور qemu پیش‌فرض را برمی‌گرداند
نام باینری
این تابع is منسوخ. در کد جدید، به جای آن از تماس «get-hv» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
get-recovery-proc
get-recovery-proc
پرچم فعال فرآیند بازیابی را برگردانید.
get-selinux
get-selinux
این تنظیمات فعلی پرچم selinux را که به دستگاه ارسال می شود، برمی گرداند
زمان بوت. به "set-selinux" مراجعه کنید.
برای اطلاعات بیشتر در مورد معماری libguestfs، نگاه کنید مهمانان(3).
دریافت smp
دریافت smp
این تعداد CPUهای مجازی اختصاص داده شده به دستگاه را برمی گرداند.
get-tmpdir
get-tmpdir
دایرکتوری مورد استفاده توسط دسته برای ذخیره فایل های موقت را دریافت کنید.
ردیابی
ردیابی
پرچم ردیابی فرمان را برگردانید.
گرفتن-ماسک
گرفتن-ماسک
umask فعلی را برگردانید. به طور پیش فرض umask 022 است مگر اینکه با تماس تنظیم شده باشد
"umask".
پر حرف
پر حرف
این پرچم پیام های پرمخاطب را برمی گرداند.
getcon
getcon
این زمینه امنیتی SELinux دیمون را دریافت می کند.
مستندات مربوط به SELINUX را در اینجا ببینید مهمانان(3) و "setcon"
getxattr
نام مسیر getxattr
یک ویژگی توسعه یافته را از فایل "path" به نام "name" دریافت کنید. این تماس دنبال می شود
پیوندهای نمادین اگر می‌خواهید یک ویژگی توسعه‌یافته را برای خود پیوند نماد جستجو کنید، از آن استفاده کنید
"lgetxattr".
معمولاً بهتر است تمام ویژگی های توسعه یافته را از یک فایل به صورت یکجا و با فراخوانی دریافت کنید
"getxattrs". با این حال، برخی از پیاده‌سازی‌های سیستم فایل لینوکس باگ هستند و a
راهی برای فهرست کردن ویژگی ها برای این فایل سیستم ها (به ویژه ntfs-3g) باید بدانید
نام ویژگی های توسعه یافته ای را که می خواهید از قبل نام ببرید و این تابع را فراخوانی کنید.
مقادیر مشخصه توسعه یافته حباب هایی از داده های باینری هستند. اگر ویژگی توسعه یافته وجود نداشته باشد
با نام "name"، یک خطا برمی گرداند.
همچنین ببینید: "getxattrs"، "lgetxattr"، جذب کنند(5).
getxattrs
مسیر getxattrs
این فراخوان ویژگی های توسعه یافته فایل یا دایرکتوری "path" را فهرست می کند.
در سطح فراخوانی سیستم، این ترکیبی از listxattr(2) و getxattr(2) تماس.
همچنین ببینید: "lgetxattrs"، جذب کنند(5).
glob-expand
الگوی گسترش کره ای
این دستور همه نام مسیرهای مطابق با "الگو" را با توجه به علامت عام جستجو می کند
قوانین گسترش مورد استفاده توسط پوسته
اگر هیچ مسیری مطابقت نداشته باشد، یک لیست خالی را برمی گرداند (توجه داشته باشید: یک خطا نیست).
این فقط یک لفاف در اطراف C است کره(3) عملکرد با پرچم های "GLOB_MARK|GLOB_BRACE". دیدن
آن صفحه راهنما برای جزئیات بیشتر.
توجه داشته باشید که هیچ دستوری معادل برای گسترش نام دستگاه وجود ندارد (مثلاً /dev/sd*).
به جای آن از توابع "list-devices"، "list-partitions" و غیره استفاده کنید.
grep استفاده
grep-opts
مسیر regex grep [توسعه:درست|نادرست] [ثابت:درست|نادرست] [غیر حساس:درست|نادرست] [فشرده:درست|نادرست]
این برنامه خارجی "grep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
پرچم های اختیاری عبارتند از:
"تمدید شده"
از عبارات منظم توسعه یافته استفاده کنید. این همان استفاده از است -E پرچم.
"درست شد"
مطابقت ثابت شد (از عبارات منظم استفاده نکنید). این همان استفاده از است -F پرچم.
"بی احساس"
کبریت به حروف بزرگ و کوچک حساس نیست. این همان استفاده از است -i پرچم.
"فشرده"
به جای «grep» از «zgrep» استفاده کنید. این اجازه می دهد تا ورودی فشرده یا gzip باشد.
فشرده شده
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
گرپی
مسیر grepi regex
این برنامه خارجی "grep -i" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
نصب کردن
grub-install root device
این دستور GRUB 1 (Grand Unified Bootloader) را روی "دستگاه" با روت نصب می کند
دایرکتوری که "ریشه" است.
یادداشت:
· در حال حاضر هیچ راهی در API برای نصب grub2، که توسط اکثر مدرن ها استفاده می شود، وجود ندارد
مهمانان لینوکس این امکان وجود دارد که دستور grub2 را از مهمان اجرا کنید، اگرچه ببینید
اخطارها در "فرمان های در حال اجرا" در مهمانان(3).
· این از "grub-install" از میزبان استفاده می کند. متأسفانه grub همیشه سازگار نیست
با خودش، بنابراین این فقط در شرایط نسبتاً محدود کار می کند. تست دقیق با
هر نسخه مهمان توصیه می شود.
· اگر grub-install خطای «درایو مناسبی در دستگاه تولید شده یافت نشد
نقشه." ممکن است شما نیاز به ایجاد یک /boot/grub/device.map ابتدا آن را فایل کنید
شامل نقشه برداری بین نام دستگاه های grub و نام دستگاه های لینوکس است. معمولا هست
برای ایجاد یک فایل حاوی:
(hd0) /dev/vda
جایگزین /dev/vda با نام دستگاه نصب
سر
مسیر سر
این دستور تا 10 خط اول یک فایل را به عنوان لیست رشته ها برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
سر-ن
مسیر head-n nrlines
اگر پارامتر "nrlines" یک عدد مثبت باشد، اولین خطوط "nrlines" را برمی گرداند
فایل "مسیر".
اگر پارامتر "nrlines" یک عدد منفی باشد، خطوطی از فایل "path" را برمی گرداند.
به استثنای آخرین خطوط "nrlines".
اگر پارامتر "nrlines" صفر باشد، یک لیست خالی برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
هگزدامپ
مسیر hexdump
این "hexdump -C" را در "مسیر" داده شده اجرا می کند. نتیجه این است که انسان قابل خواندن و متعارف است
حذف هگز فایل.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
hivex-close
hivex-close
دستگیره هیوکس فعلی را ببندید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-commit
نام فایل hivex-commit
اعمال (نوشتن) تغییرات در کندو.
اگر اختیاری است نام فایل پارامتر null است، سپس تغییرات به همان حالت نوشته می شود
کندویی که باز شد اگر این تهی نباشد، آنها در نام فایل جایگزین نوشته می شوند
داده شده و کندو اصلی دست نخورده باقی می ماند.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-add-child
نام والدین hivex-node-add-child
یک گره فرزند به "والد" به نام "name" اضافه کنید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
کهیر-گره-کودکان
کهیر-گره-کودکان گره
لیست گره هایی را که زیرکلیدهای "nodeh" هستند، برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-delete-child
hivex-node-delete-child nodeh
در صورت لزوم "nodeh" را به صورت بازگشتی حذف کنید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
کهیر-گره-دریافت فرزند
hivex-node-get-child نام گره
فرزند «نوده» را در صورت وجود با نام «نام» برگردانید. این می تواند معنی 0 را برگرداند
نام یافت نشد
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-get-value
کلید nodeh hivex-node-get-value
مقدار متصل به "nodeh" که نام "key" را دارد، در صورت وجود، برگردانید. این می تواند
بازگشت 0 به این معنی که کلید پیدا نشد.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-name
hivex-node-name nodeh
نام نوده را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-parent
hivex-node-parent nodeh
گره والد "nodeh" را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-set-value
hivex-node-set-value nodeh key t val
یک مقدار واحد را در زیر گره "nodeh" تنظیم یا جایگزین کنید. "کلید" نام است، "t" نام است
نوع، و "val" داده است.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-node-values
hivex-node-values nodeh
آرایه (کلید، نوع داده، داده) تاپل های متصل به "nodeh" را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
کندو-باز
نام فایل hivex-open [verbose:true|false] [debug:true|false] [write:true|false]
فایل hive رجیستری ویندوز را با نام باز کنید نام فایل. اگر کهیر قبلی وجود داشت
دسته مرتبط با این جلسه مهمان، سپس بسته می شود.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
ریشه کندو
ریشه کندو
گره ریشه کندو را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-value-key
hivex-value-key valueh
فیلد کلید (نام) یک تاپل (کلید، نوع داده، داده) را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-value-نوع
hivex-value-type valueh
فیلد نوع داده را از یک تاپل (کلید، نوع داده، داده) برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
hivex-value-utf8
hivex-value-utf8 valueh
این "hivex-value-value" را فرا می خواند (که فیلد داده را از یک مقدار hivex برمی گرداند).
سپس فرض می کند که فیلد یک رشته UTF-16LE است و نتیجه را به UTF-8 (یا
اگر این امکان پذیر نباشد، یک خطا برمی گرداند).
این برای خواندن رشته های خارج از رجیستری ویندوز مفید است. با این حال اینطور نیست
اشتباه نیست زیرا رجیستری به شدت تایپ نشده است و فیلدها می توانند حاوی دلخواه یا دلخواه باشند
داده های غیر منتظره
hivex-value-value
hivex-value-value valueh
فیلد داده یک تاپل (کلید، نوع داده، داده) را برگردانید.
این یک لفاف در اطراف است کندو(3) تماس با همین نام.
همچنین ببینید: "hivex-value-utf8".
initrd-cat
نام فایل initrd-cat initrdpath
این دستور فایل را باز می کند نام فایل از فایل initrd فراخوانی شده است مسیر درونی.
نام فایل باید داده شود بدون اولیه / شخصیت.
به عنوان مثال، در guestfish می توانید از دستور زیر برای بررسی اسکریپت بوت استفاده کنید
(معمولاً نامیده می شود /init) موجود در یک تصویر initrd یا initramfs لینوکس:
initrd-cat /boot/initrd- img init
همچنین به "initrd-list" مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
initrd-list
مسیر initrd-list
این دستور فایل های موجود در initrd را فهرست می کند.
فایل ها بدون هیچ حرف اول فهرست شده اند / شخصیت. فایل ها به ترتیب فهرست شده اند
آنها ظاهر می شوند (الزاماً حروف الفبا نیستند). نام دایرکتوری ها به عنوان آیتم های جداگانه فهرست شده اند.
هسته های لینوکس قدیمی (2.4 و قبل از آن) از یک سیستم فایل فشرده ext2 به عنوان initrd استفاده می کردند. ما فقط
از فرمت جدیدتر initramfs (فایل های فشرده cpio) پشتیبانی کنید.
inotify-add-watch
ماسک مسیر inotify-add-watch
"مسیر" را برای رویدادهای فهرست شده در "ماسک" تماشا کنید.
توجه داشته باشید که اگر "path" یک دایرکتوری باشد، رویدادهای درون آن دایرکتوری مشاهده می شوند، اما این
میکند نه به صورت بازگشتی (در زیر شاخه ها) اتفاق می افتد.
نکته برای تماس گیرندگان غیر C یا غیر لینوکس: رویدادهای inotify توسط هسته لینوکس تعریف می شوند.
ABI و در فهرست شده اند /usr/include/sys/inotify.h.
inotify-close
inotify-close
با این کار دسته inotify که قبلا توسط inotify_init باز شده بود بسته می شود. حذف می کند
همه را تماشا می کند، رویدادهای معلق را دور می اندازد، و همه منابع را اختصاص می دهد.
inotify-فایل ها
inotify-فایل ها
این تابع یک بسته بندی مفید در اطراف "inotify-read" است که فقط لیستی از آنها را برمی گرداند
نام مسیر اشیایی که لمس شده اند. نام مسیرهای برگشتی مرتب شده اند و
کپی شده
inotify-init
inotify-init maxevents
این دستور یک دسته جدید inotify ایجاد می کند. برای اطلاع رسانی می توان از زیرسیستم inotify استفاده کرد
رویدادهایی که برای اشیاء در سیستم فایل مهمان اتفاق می افتد.
"maxevents" حداکثر تعداد رویدادهایی است که بین تماس ها در صف قرار می گیرند
"inotify-read" یا "inotify-files". اگر این به عنوان 0 ارسال شود، هسته (یا قبلا
set) پیش فرض استفاده می شود. برای لینوکس 2.6.29 پیش فرض 16384 رویداد بود. فراتر از این حد،
هسته رویدادها را دور می اندازد، اما این واقعیت را ثبت می کند که با تنظیم a آنها را دور انداخته است
پرچم "IN_Q_OVERFLOW" را در لیست ساختار برگشتی (به "inotify-read" مراجعه کنید).
قبل از ایجاد هر رویدادی، باید چند ساعت را به لیست تماشای داخلی اضافه کنید.
ببینید: "inotify-add-watch" و "inotify-rm-watch".
رویدادهای در صف باید به صورت دوره ای با فراخوانی "inotify-read" (یا "inotify-files" خوانده شوند.
که فقط یک بسته بندی مفید در اطراف "inotify-read" است). اگر رویدادها را بیرون نخوانید
اغلب اوقات به اندازه کافی در معرض خطر پر شدن صف داخلی قرار می گیرید.
دسته باید پس از استفاده با فراخوانی "inotify-close" بسته شود. این نیز هر یک را حذف می کند
به طور خودکار ساعت
همچنین مشاهده کنید بی حس کردن(7) برای یک نمای کلی از رابط inotify همانطور که توسط لینوکس در معرض دید قرار گرفته است
هسته، که تقریباً همان چیزی است که ما از طریق libguestfs در معرض نمایش قرار می دهیم. توجه داشته باشید که یک جهانی وجود دارد
inotify handle در هر نمونه libguestfs.
inotify-خواندن
inotify-خواندن
صف کامل رویدادهایی را که از زمان تماس خوانده شده قبلی رخ داده است، برگردانید.
اگر هیچ رویدادی رخ نداده باشد، یک لیست خالی را برمی گرداند.
توجه داشته باشید:: برای اینکه مطمئن شوید همه رویدادها خوانده شده اند، باید این تابع را فراخوانی کنید
به طور مکرر تا زمانی که یک لیست خالی برگرداند. دلیل آن این است که تماس رویدادها را می خواند
تا حداکثر اندازه پیام دستگاه به میزبان و باقیمانده رویدادها را در صف قرار دهید.
inotify-rm-watch
inotify-rm-watch wd
ساعت inotify را که قبلاً تعریف شده بود بردارید. به "inotify-add-watch" مراجعه کنید.
بازرسی-گرفتن-طاق
inspect-get-arch root
این معماری سیستم عامل بازرسی شده را برمی گرداند. بازگشت احتمالی
مقادیر در زیر "فایل-معماری" فهرست شده اند.
اگر معماری قابل تعیین نباشد، رشته "ناشناخته" برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی-گرفتن-توزیع
inspect-get-distro root
این توزیع (توزیع) سیستم عامل بازرسی شده را برمی گرداند.
توزیع های فعلی تعریف شده عبارتند از:
"alpinelinux"
آلپاین لینوکس.
"altlinux"
ALT لینوکس.
"آرکلینوکس"
آرچ لینوکس.
"بیلد روت"
توزیع مشتق شده از Buildroot، اما نه توزیعی که ما به طور خاص آن را می شناسیم.
"سنتوس"
CentOS
"سیروس"
سیروس
"coreos"
CoreOS.
"دبیان"
دبیان
"فدورا"
فدورا
"freebsd"
FreeBSD.
"freedos"
فریدوس
"ظروف مقرون به صرفه"
ظروف مقرون به صرفه.
"جنتو"
جنتو
"linuxmint"
لینوکس مینت.
"mageia"
ماژیا
"ماندریوا"
ماندریوا
"میگو"
MeeGo.
"netbsd"
NetBSD.
"openbsd"
OpenBSD.
"باز"
OpenSUSE
"اوراکلینوکس"
اوراکل لینوکس.
"پاردوس"
پردوس
"pldlinux"
لینوکس PLD.
"بر اساس redhat"
برخی از توزیع های مشتق شده از کلاه قرمزی.
"رل"
لینوکس Red Hat Enterprise.
"scientificlinux"
لینوکس علمی
"Slackware"
نرم افزارهای نرم افزاری
"سلس"
SuSE Linux Enterprise Server یا Desktop.
"مبتنی بر استفاده"
برخی از توزیع های مشتق شده از openSuSE.
"ttylinux"
ttylinux.
"اوبونتو"
اوبونتو
"ناشناخته"
توزیع نمی تواند تعیین شود.
"پنجره ها"
ویندوز توزیع ندارد. اگر نوع سیستم عامل باشد، این رشته برگردانده می شود
پنجره ها.
نسخه های آینده libguestfs ممکن است رشته های دیگری را در اینجا برگردانند. تماس گیرنده باید باشد
آماده رسیدگی به هر رشته
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-drive-mappings
inspect-get-drive-mappings root
این فراخوانی برای ویندوز مفید است که از سیستم ابتدایی اختصاص دادن حروف درایو استفاده می کند
(پسندیدن C:) به پارتیشن ها. این API بازرسی رجیستری ویندوز را بررسی می کند تا متوجه شود
چگونه دیسک‌ها/پارتیشن‌ها برای حروف درایو نگاشت می‌شوند و یک جدول هش را همانطور که در
مثال زیر:
C => /dev/vda2
E => /dev/vdb1
F => /dev/vdc1
توجه داشته باشید که کلیدها حروف درایو هستند. برای ویندوز، کلید حساس به حروف کوچک و بزرگ و فقط است
حاوی حرف درایو، بدون کاراکتر جداکننده کولون معمولی است.
در آینده ممکن است از سیستم عامل های دیگری که از حروف درایو نیز استفاده می کنند، پشتیبانی کنیم
کلیدهای آن ها ممکن است به حروف بزرگ و کوچک حساس نباشند و ممکن است بیشتر از 1 کاراکتر باشند. برای
به عنوان مثال در OS-9، هارد دیسک ها "h0"، "h1" و غیره نامگذاری شدند.
برای مهمان های ویندوز، در حال حاضر فقط نقشه های هارد دیسک برگردانده می شود. دیسک های قابل جابجایی (مثلا
DVD-ROM ها) نادیده گرفته می شوند.
برای مهمانانی که از نگاشت درایو استفاده نمی کنند، یا اگر نگاشت درایو نمی تواند باشد
تعیین شده، این یک جدول هش خالی را برمی گرداند.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر همچنین ببینید "بازرسی - دریافت -
mountpoints، "inspect-get-filesystems".
سیستم های فایل inspect-get-get
inspect-get-filessystems root
این فهرستی از تمام سیستم‌های فایلی را که فکر می‌کنیم مرتبط با آن هستند، برمی‌گرداند
سیستم عامل. این شامل فایل سیستم ریشه، سایر فایل سیستم های معمولی و غیر
دستگاه های نصب شده مانند پارتیشن های تعویض.
در مورد ماشین مجازی چند بوت، امکان اشتراک گذاری فایل سیستم وجود دارد
بین سیستم عامل ها
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر همچنین ببینید "بازرسی - دریافت -
نقاط کوه".
بازرسی-دریافت-فرمت
ریشه inspect-get-format
این فرمت سیستم عامل بازرسی شده را برمی گرداند. می توانید از آن برای تشخیص استفاده کنید
تصاویر، سی دی های زنده و موارد مشابه را نصب کنید.
فرمت های تعریف شده در حال حاضر عبارتند از:
"نصب شده است"
این یک سیستم عامل نصب شده است.
"نصاب"
تصویر دیسک مورد بازرسی یک سیستم عامل نصب شده نیست، بلکه یک قابل استفاده
دیسک، سی دی زنده یا موارد مشابه را نصب کنید.
"ناشناخته"
فرمت این تصویر دیسک مشخص نیست.
نسخه های آینده libguestfs ممکن است رشته های دیگری را در اینجا برگردانند. تماس گیرنده باید باشد
آماده رسیدگی به هر رشته
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-hostname
ریشه inspect-get-hostname
این تابع نام میزبان سیستم عامل را همانطور که با بازرسی از پیدا شده است برمی گرداند
فایل های پیکربندی مهمان
اگر نام میزبان تعیین نشد، رشته "ناشناخته" برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
نماد inspect-get-icon
inspect-get-icon root [favicon:true|false] [highquality:true|false]
این تابع یک نماد مربوط به سیستم عامل بازرسی شده را برمی گرداند. نماد
به عنوان یک بافر حاوی یک تصویر PNG بازگردانده می شود (در صورت لزوم دوباره به PNG کدگذاری می شود).
اگر امکان دریافت نماد وجود نداشت، این تابع یک طول صفر (غیر NULL) برمی‌گرداند.
بافر شده است. تماس گیرنده ها باید بررسی برای این مورد.
Libguestfs با جستجوی فایلی به نام شروع می شود /etc/favicon.png or C:\etc\favicon.png
و در صورت داشتن فرمت صحیح محتویات این فایل برگردانده می شود. تو می توانی
فاویکون ها را با پاس دادن بولی اختیاری "favicon" به عنوان false غیرفعال کنید (پیش فرض درست است).
اگر یافتن فاویکون ناموفق بود، ما در مکان‌های دیگر مهمان به دنبال گزینه مناسب می‌گردیم
آیکون.
اگر بولی اختیاری "کیفیت بالا" درست باشد، فقط نمادهای با کیفیت بالا برگردانده می شوند.
یعنی فقط آیکون هایی با وضوح بالا با کانال آلفا. پیش فرض (نادرست) است
برای برگرداندن هر نمادی که می توانیم، حتی اگر کیفیت پایینی داشته باشد.
یادداشت:
· بر خلاف بسیاری از تماس‌های API بازرسی دیگر، دیسک‌های مهمان باید قبلاً نصب شوند
شما این را صدا می زنید، زیرا نیاز به خواندن اطلاعات از سیستم فایل مهمان در طول زمان دارد
زنگ زدن.
· امنیت: داده‌های نماد از مهمان غیرقابل اعتماد می‌آیند و باید با آنها برخورد شود
احتیاط فایل‌های PNG حاوی اکسپلویت‌ها هستند. اطمینان حاصل کنید که libpng (یا موارد دیگر
کتابخانه های مربوطه) قبل از تلاش برای پردازش یا نمایش نماد، کاملاً به روز هستند.
· تصویر PNG بازگشتی می تواند هر اندازه ای باشد. ممکن است مربع نباشد. Libguestfs تلاش می کند
بزرگترین و با کیفیت ترین نماد موجود را برگردانید. برنامه باید مقیاس داشته باشد
نماد به اندازه مورد نیاز
· استخراج آیکون ها از مهمان های ویندوز به برنامه خارجی "wrestool" نیاز دارد
بسته "icoutils" و چندین برنامه ("bmptopnm"، "pnmtopng"، "pamcut") از
بسته "netpbm". اینها باید جداگانه نصب شوند.
· نمادهای سیستم عامل معمولاً علائم تجاری هستند. قبل از استفاده از مشاوره حقوقی استفاده کنید
علائم تجاری در برنامه های کاربردی
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
inspect-get-major-version
inspect-get-major-version root
این شماره نسخه اصلی سیستم عامل بازرسی شده را برمی گرداند.
ویندوز از یک طرح نسخه سازی سازگار استفاده می کند که این است نه در افکار عمومی منعکس شده است
نام های استفاده شده توسط سیستم عامل قابل توجه سیستم عامل معروف به "ویندوز 7" است
واقعا نسخه 6.1 (یعنی عمده = 6، مینور = 1). شما می توانید نسخه های واقعی را پیدا کنید
مطابق با نسخه های ویندوز با مشورت ویکی پدیا یا MSDN.
اگر نسخه را نمی توان تعیین کرد، 0 برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-minor-version
inspect-get-minor-version root
این شماره نسخه جزئی سیستم عامل بازرسی شده را برمی گرداند.
اگر نسخه را نمی توان تعیین کرد، 0 برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر همچنین نگاه کنید به "بازرسی-دریافت-عمده-
نسخه".
بازرسی-گرفتن-نقاط کوهستانی
inspect-get-mountpoints root
این یک هش از جایی که ما فکر می کنیم فایل سیستم های مرتبط با این عملیات را برمی گرداند
سیستم باید نصب شود تماس گیرندگان باید توجه داشته باشند که این در بهترین حالت یک حدس علمی است
با خواندن فایل های پیکربندی مانند / etc / fstab. In ویژه توجه داشته باشید که این ممکن است
فایل سیستم هایی را که وجود ندارند یا قابل نصب نیستند و تماس گیرندگان را برمی گرداند باید آماده شوند
در صورت تلاش برای نصب شکست ها، آنها را مدیریت کرده یا نادیده بگیرند.
هر عنصر در hashtable برگشتی دارای یک کلید است که مسیر mountpoint است (به عنوان مثال.
/ boot) و مقداری که سیستم فایلی است که در آنجا نصب می شود (مثلاً. / dev / sda1).
دستگاه های غیر نصب شده مانند دستگاه های سوآپ هستند نه در این لیست بازگشته است.
برای سیستم عامل هایی مانند ویندوز که هنوز از حروف درایو استفاده می کنند، این تماس فقط انجام می شود
یک ورودی برای اولین درایو "mounted on" برگردانید /. برای اطلاعات در مورد نقشه برداری از
درایو حروف به پارتیشن‌ها، به "inspect-get-drive-mappings" مراجعه کنید.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر همچنین ببینید "بازرسی - دریافت -
سیستم های فایل".
بازرسی-دریافت-پکیج-فرمت
root inspect-get-package-format
این تابع و "inspect-get-package-management" قالب و بسته بسته را برمی گرداند
ابزار مدیریتی که توسط سیستم عامل بازرسی شده استفاده می شود. به عنوان مثال برای فدورا اینها
توابع "rpm" (فرمت بسته) و "yum" یا "dnf" (مدیریت بسته) را برمی گرداند.
اگر نتوانیم قالب بسته را تعیین کنیم، رشته "ناشناخته" را برمی گرداند or اگر
سیستم عامل یک سیستم بسته بندی واقعی (به عنوان مثال ویندوز) ندارد.
رشته های ممکن عبارتند از: "rpm"، "deb"، "ebuild"، "pisi"، "pacman"، "pkgsrc"، "apk".
نسخه های آینده libguestfs ممکن است رشته های دیگری را برگردانند.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی-دریافت-پکیج-مدیریت
inspect-get-package-management root
"inspect-get-package-format" و این تابع قالب و بسته بسته را برمی گرداند
ابزار مدیریتی که توسط سیستم عامل بازرسی شده استفاده می شود. به عنوان مثال برای فدورا اینها
توابع "rpm" (فرمت بسته) و "yum" یا "dnf" (مدیریت بسته) را برمی گرداند.
اگر نتوانیم ابزار مدیریت بسته را تعیین کنیم، رشته "ناشناخته" را برمی گرداند or
اگر سیستم عامل یک سیستم بسته بندی واقعی (مثلاً ویندوز) نداشته باشد.
رشته های ممکن عبارتند از: "yum"، "dnf"، "up2date"، "apt" (برای همه مشتقات دبیان)،
"portage"، "pisi"، "pacman"، "urpmi"، "zypper"، "apk". نسخه های آینده libguestfs ممکن است
رشته های دیگر را برگردانید.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-product-name
inspect-get-product-name root
این نام محصول سیستم عامل بازرسی شده را برمی گرداند. نام محصول است
به طور کلی یک رشته آزاد که می تواند به کاربر نمایش داده شود، اما نباید باشد
تجزیه شده توسط برنامه ها
اگر نام محصول تعیین نشد، رشته "ناشناخته" برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی-دریافت-محصول-نوع
inspect-get-product-variant root
این نوع محصول سیستم عامل بازرسی شده را برمی گرداند.
برای مهمان های ویندوز، این محتویات کلید رجیستری را برمی گرداند
"HKLM\Software\Microsoft\Windows NT\CurrentVersion" "InstallationType" که معمولا
رشته ای مانند "Client" یا "Server" (مقادیر دیگر ممکن است). از این می توان استفاده کرد
نسخه های مصرف کننده و سازمانی ویندوز را که شماره نسخه یکسانی دارند را تشخیص دهید
(به عنوان مثال، ویندوز 7 و سرور 2008 هر دو نسخه 6.1 هستند، اما اولی
"Client" و دومی "Server" است).
برای مهمانان لینوکس سازمانی، در آینده قصد داریم این نوع محصول را بازگردانیم
به عنوان "رومیزی"، "سرور" و غیره. اما این امر در حال حاضر اجرا نمی شود.
اگر نوع محصول قابل تعیین نباشد، رشته "ناشناخته" برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر همچنین نگاه کنید به "بازرسی-دریافت-محصول-
name"، "inspect-get-major-version".
بازرسی-دریافت ریشه
بازرسی-دریافت ریشه
این تابع یک راه راحت برای دریافت لیست دستگاه های ریشه است، همانطور که از a برگردانده شده است
تماس قبلی با "Inspect-OS"، اما بدون انجام مجدد کل فرآیند بازرسی.
اگر هیچ دستگاه ریشه ای پیدا نشده باشد یا تماس گیرنده پیدا نشده باشد، یک لیست خالی برمی گرداند
به نام "بازرسی-os".
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی-گرفتن-نوع
inspect-get-type root
این نوع سیستم عامل بازرسی شده را برمی گرداند. انواع تعریف شده در حال حاضر عبارتند از:
"لینوکس"
هر سیستم عامل مبتنی بر لینوکس.
"پنجره ها"
هر سیستم عامل مایکروسافت ویندوز.
"freebsd"
FreeBSD.
"netbsd"
NetBSD.
"openbsd"
OpenBSD.
"هورد"
گنو/هرد.
"انجام"
MS-DOS، FreeDOS و دیگران.
"مینیکس"
MINIX.
"ناشناخته"
نوع سیستم عامل را نمی توان تعیین کرد.
نسخه های آینده libguestfs ممکن است رشته های دیگری را در اینجا برگردانند. تماس گیرنده باید باشد
آماده رسیدگی به هر رشته
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-windows-current-control-set
inspect-get-windows-current-control-set root
این گزینه Windows CurrentControlSet مهمان بازرسی شده را برمی گرداند. CurrentControlSet
یک نام کلید رجیستری مانند "ControlSet001" است.
این فراخوانی فرض می کند که مهمان ویندوز است و رجیستری می تواند توسط آن بررسی شود
بازرسی. اگر اینطور نیست، یک خطا برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-get-windows-systemroot
inspect-get-windows-systemroot root
این سیستم ریشه ویندوز مهمان بازرسی شده را برمی گرداند. systemroot یک دایرکتوری است
مسیری مانند /پنجره ها.
این فراخوانی فرض میکند که مهمان ویندوز است و سیستم روت می‌تواند توسط آن تعیین شود
بازرسی. اگر اینطور نیست، یک خطا برگردانده می شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی - زنده است
inspect-is-live root
اگر "inspect-get-format" "Installer" را برگرداند (این یک دیسک نصب است)، آنگاه این دیسک را برمی گرداند.
درست است اگر یک تصویر زنده روی دیسک شناسایی شود.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-is-multipart
ریشه inspect-is-multipart
اگر "inspect-get-format" "Installer" را برگرداند (این یک دیسک نصب است)، آنگاه این دیسک را برمی گرداند.
درست است اگر دیسک بخشی از یک مجموعه باشد.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-is-netinst
inspect-is-netinst root
اگر "inspect-get-format" "Installer" را برگرداند (این یک دیسک نصب است)، آنگاه این دیسک را برمی گرداند.
درست است اگر دیسک نصب کننده شبکه باشد، به عنوان مثال. نه یک سی دی نصب مستقل، بلکه یک سی دی نصب
احتمالاً برای تکمیل نصب نیاز به دسترسی به شبکه دارد.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
inspect-list-applications
inspect-list-applications root
لیست برنامه های نصب شده در سیستم عامل را برگردانید.
توجه داشته باشید: این فراخوانی متفاوت از سایر بخش‌های Inspection API عمل میکند. تو باید
قبل از تماس، «inspect-os»، سپس «inspect-get-mountpoints» را فراخوانی کنید، سپس دیسک‌ها را نصب کنید.
این. فهرست کردن برنامه ها عملیات بسیار دشوارتری است که به آن نیاز دارد
دسترسی به فایل سیستم کامل همچنین توجه داشته باشید که برخلاف دیگر تماس‌های "inspect-get-*".
که فقط داده های کش شده در دسته libguestfs را برمی گرداند، این فراخوان در واقع خوانده می شود
بخش هایی از فایل سیستم های نصب شده در طول تماس.
اگر کد بازرسی قادر به تعیین لیست نبود، یک لیست خالی برمی گرداند
برنامه های کاربردی.
ساختار برنامه شامل فیلدهای زیر است:
"نام برنامه"
نام برنامه. برای مهمانان لینوکس مشتق شده از Red Hat و Debian،
این نام بسته است.
"app_display_name"
نام نمایشی برنامه که گاهی اوقات به زبان نصب ترجمه می شود
سیستم عامل مهمان
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود. تماس گیرندگانی که نیاز به نمایش دارند
چیزی می تواند به جای آن از "app_name" استفاده کند.
"app_epoch"
برای مدیران بسته که از دوره‌ها استفاده می‌کنند، این شامل دوره بسته (یک
عدد صحیح). اگر در دسترس نباشد، به عنوان 0 برگردانده می شود.
"app_version"
رشته نسخه برنامه یا بسته. اگر در دسترس نباشد این به عنوان برگردانده می شود
یک رشته خالی "".
"app_release"
رشته انتشار برنامه یا بسته، برای مدیران بسته که از این استفاده می کنند.
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود.
"app_install_path"
مسیر نصب برنامه (در سیستم عامل هایی مانند ویندوز که
از مسیرهای نصب استفاده کنید). این مسیر در قالب استفاده شده توسط مهمان است
سیستم، یک مسیر libguestfs نیست.
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود.
"app_trans_path"
مسیر نصب به یک مسیر libguestfs ترجمه شده است. اگر در دسترس نباشد، برگردانده می شود
به عنوان یک رشته خالی "".
"app_publisher"
نام ناشر برنامه، برای مدیران بسته که از این استفاده می کنند. اگر
در دسترس نیست این به عنوان یک رشته خالی "" برگردانده می شود.
"app_url"
URL (به عنوان مثال URL بالادست) برنامه. اگر در دسترس نباشد، این به عنوان یک بازگردانده می شود
رشته خالی "".
"app_source_package"
برای سیستم های بسته بندی که از این پشتیبانی می کنند، نام بسته منبع. اگر
در دسترس نیست این به عنوان یک رشته خالی "" برگردانده می شود.
"app_summary"
توضیح کوتاه (معمولاً یک خطی) از برنامه یا بسته. اگر در دسترس نباشد
این به عنوان یک رشته خالی "" برگردانده می شود.
"app_description"
توضیحات طولانی تر از برنامه یا بسته. اگر در دسترس نباشد، برگردانده می شود
به عنوان یک رشته خالی "".
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
این تابع is منسوخ. در کد جدید، از تماس "inspect-list-applications2" استفاده کنید
به جای آن.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
inspect-list-applications2
inspect-list-applications2 root
لیست برنامه های نصب شده در سیستم عامل را برگردانید.
توجه داشته باشید: این فراخوانی متفاوت از سایر بخش‌های Inspection API عمل میکند. تو باید
قبل از تماس، «inspect-os»، سپس «inspect-get-mountpoints» را فراخوانی کنید، سپس دیسک‌ها را نصب کنید.
این. فهرست کردن برنامه ها عملیات بسیار دشوارتری است که به آن نیاز دارد
دسترسی به فایل سیستم کامل همچنین توجه داشته باشید که برخلاف دیگر تماس‌های "inspect-get-*".
که فقط داده های کش شده در دسته libguestfs را برمی گرداند، این فراخوان در واقع خوانده می شود
بخش هایی از فایل سیستم های نصب شده در طول تماس.
اگر کد بازرسی قادر به تعیین لیست نبود، یک لیست خالی برمی گرداند
برنامه های کاربردی.
ساختار برنامه شامل فیلدهای زیر است:
"app2_name"
نام برنامه. برای مهمانان لینوکس مشتق شده از Red Hat و Debian،
این نام بسته است.
"app2_display_name"
نام نمایشی برنامه که گاهی اوقات به زبان نصب ترجمه می شود
سیستم عامل مهمان
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود. تماس گیرندگانی که نیاز به نمایش دارند
چیزی می تواند به جای آن از "app2_name" استفاده کند.
"app2_epoch"
برای مدیران بسته که از دوره‌ها استفاده می‌کنند، این شامل دوره بسته (یک
عدد صحیح). اگر در دسترس نباشد، به عنوان 0 برگردانده می شود.
"app2_version"
رشته نسخه برنامه یا بسته. اگر در دسترس نباشد این به عنوان برگردانده می شود
یک رشته خالی "".
"app2_release"
رشته انتشار برنامه یا بسته، برای مدیران بسته که از این استفاده می کنند.
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود.
"app2_arch"
رشته معماری برنامه یا بسته، برای مدیران بسته ای که استفاده می کنند
این. اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود.
"app2_install_path"
مسیر نصب برنامه (در سیستم عامل هایی مانند ویندوز که
از مسیرهای نصب استفاده کنید). این مسیر در قالب استفاده شده توسط مهمان است
سیستم، یک مسیر libguestfs نیست.
اگر در دسترس نباشد، به عنوان یک رشته خالی "" برگردانده می شود.
"app2_trans_path"
مسیر نصب به یک مسیر libguestfs ترجمه شده است. اگر در دسترس نباشد، برگردانده می شود
به عنوان یک رشته خالی "".
"app2_publisher"
نام ناشر برنامه، برای مدیران بسته که از این استفاده می کنند. اگر
در دسترس نیست این به عنوان یک رشته خالی "" برگردانده می شود.
"app2_url"
URL (به عنوان مثال URL بالادست) برنامه. اگر در دسترس نباشد، این به عنوان یک بازگردانده می شود
رشته خالی "".
"app2_source_package"
برای سیستم های بسته بندی که از این پشتیبانی می کنند، نام بسته منبع. اگر
در دسترس نیست این به عنوان یک رشته خالی "" برگردانده می شود.
"app2_summary"
توضیح کوتاه (معمولاً یک خطی) از برنامه یا بسته. اگر در دسترس نباشد
این به عنوان یک رشته خالی "" برگردانده می شود.
"app2_description"
توضیحات طولانی تر از برنامه یا بسته. اگر در دسترس نباشد، برگردانده می شود
به عنوان یک رشته خالی "".
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
بازرسی سیستم عامل
بازرسی سیستم عامل
این تابع از توابع دیگر libguestfs و اکتشافی های خاصی برای بازرسی استفاده می کند
دیسک(ها) (معمولا دیسک های متعلق به یک ماشین مجازی)، به دنبال سیستم عامل هستند.
اگر هیچ سیستم عاملی پیدا نشد، لیست برگشتی خالی است.
اگر یک سیستم عامل پیدا شد، لیستی را با یک عنصر برمی گرداند که
نام فایل سیستم ریشه این سیستم عامل است. برای این کار نیز امکان پذیر است
تابعی برای برگرداندن لیستی حاوی بیش از یک عنصر، نشان دهنده بوت دوگانه یا
ماشین مجازی چند بوت، با هر عنصر سیستم فایل ریشه یکی از آنها
سیستم های عامل.
شما می توانید رشته(های) ریشه برگشتی را به سایر توابع "inspect-get-*" ارسال کنید تا این کار را انجام دهید
اطلاعات بیشتر در مورد هر سیستم عامل مانند نام و نسخه را جویا شوید.
این تابع به ترتیب از سایر ویژگی های libguestfs مانند "mount-ro" و "umount-all" استفاده می کند.
برای mount و unmount فایل سیستم ها و نگاه کردن به محتویات. این باید با شماره نامیده شود
دیسک هایی که در حال حاضر نصب شده اند این تابع همچنین ممکن است از Augeas استفاده کند، بنابراین هر Augeas موجود را کنترل می کند
بسته خواهد شد.
این تابع نمی تواند دیسک های رمزگذاری شده را رمزگشایی کند. تماس گیرنده باید ابتدا این کار را انجام دهد (تامین
کلیدهای لازم) اگر دیسک رمزگذاری شده باشد.
لطفا "بازرسی" را در مهمانان(3) برای جزئیات بیشتر.
همچنین به "list-filesystems" مراجعه کنید.
is-blockdev
is-blockdev-opts
مسیر is-blockdev [followsymlinks:true|false]
اگر و تنها در صورتی که دستگاه بلوکی با نام «مسیر» داده شده وجود داشته باشد، «درست» را برمی گرداند.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با یک دستگاه بلوک به پایان می رسد همچنین باعث می شود که عملکرد به درستی برگردد.
این تماس فقط به فایل‌های داخل سیستم فایل مهمان نگاه میکند. پارتیشن های Libguestfs و
مسدود کردن دستگاه ها (به عنوان مثال / dev / sda و) نمی تواند به عنوان پارامتر "مسیر" این فراخوانی استفاده شود.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
is-chardev
is-chardev-opts
مسیر is-chardev [followsymlinks:true|false]
اگر و تنها در صورتی که دستگاه کاراکتری با نام «مسیر» داده شده وجود داشته باشد، «درست» را برمی گرداند.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با یک chardev به پایان می رسد همچنین باعث می شود که تابع true باشد.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
is-config
is-config
اگر این دسته در حال پیکربندی باشد (در حالت "CONFIG") این مقدار true را برمی گرداند.
برای اطلاعات بیشتر در مورد ایالت ها، نگاه کنید مهمانان(3).
کارگردان است
is-dir-opts
مسیر is-dir [followsymlinks:true|false]
اگر و تنها در صورتی که دایرکتوری با نام مسیر داده شده وجود داشته باشد، "true" را برمی گرداند. توجه داشته باشید
که false را برای اشیاء دیگر مانند فایل ها برمی گرداند.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با یک دایرکتوری به پایان می رسد همچنین باعث می شود که تابع true باشد.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
is-fifo
is-fifo-opts
مسیر is-fifo [followsymlinks:true|false]
اگر و تنها در صورتی که یک FIFO (لوله نامگذاری شده) با «مسیر» داده شده وجود داشته باشد، «درست» را برمی گرداند.
نام.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با یک FIFO به پایان می رسد همچنین باعث می شود که تابع true باشد.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
فایل است
is-file-opts
مسیر is-file [followsymlinks:true|false]
اگر و تنها در صورتی که یک فایل معمولی با نام "مسیر" داده شده وجود داشته باشد، "درست" را برمی گرداند.
توجه داشته باشید که false را برای اشیاء دیگر مانند دایرکتوری ها برمی گرداند.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با یک فایل به پایان می رسد همچنین باعث می شود که تابع true باشد.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
is-lv
دستگاه is-lv
این دستور آزمایش میکند که آیا «دستگاه» یک حجم منطقی است یا خیر، و اگر این مقدار باشد، true را برمی‌گرداند
مورد.
سوکت است
is-socket-opts
مسیر is-socket [followsymlinks:true|false]
اگر و تنها در صورتی که یک سوکت دامنه یونیکس با «مسیر» داده شده وجود داشته باشد، «درست» را برمی گرداند.
نام.
اگر پرچم اختیاری "followsymlinks" درست باشد، یک پیوند نمادین (یا زنجیره ای از پیوندهای نمادین) که
با سوکت به پایان می رسد همچنین باعث می شود که تابع true باشد.
همچنین به "stat" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
is-symlink
مسیر is-symlink
اگر و تنها در صورتی که پیوند نمادینی با نام «مسیر» داده شده وجود داشته باشد، «درست» را برمی گرداند.
همچنین به "stat" مراجعه کنید.
کل دستگاه است
دستگاه کل دستگاه است
اگر و فقط اگر «دستگاه» به یک دستگاه بلوک کامل اشاره داشته باشد، «درست» را برمی‌گرداند. یعنی نه یک
پارتیشن یا یک دستگاه منطقی
صفر است
مسیر صفر است
در صورتی که فایل وجود داشته باشد و فایل خالی باشد یا حاوی تمام صفر بایت باشد، این مقدار true را برمی گرداند.
دستگاه صفر است
دستگاه دستگاه صفر است
اگر دستگاه وجود داشته باشد و تمام صفر بایت را داشته باشد، این مقدار true را برمی‌گرداند.
توجه داشته باشید که برای دستگاه های بزرگ این کار ممکن است زمان زیادی طول بکشد.
isoinfo
ایزوفایل isoinfo
این همان "isoinfo-device" است با این تفاوت که برای یک فایل ISO واقع در داخل کار می کند
چند سیستم فایل نصب شده دیگر توجه داشته باشید که در موارد رایج که ISO اضافه کرده اید
فایل را به عنوان یک دستگاه libguestfs انجام می دهید نه این را صدا کن به جای آن شما می توانید "isoinfo-
دستگاه".
دستگاه isoinfo
دستگاه isoinfo-device
"دستگاه" یک دستگاه ISO است. این یک ساختار از اطلاعات خوانده شده از اولیه را برمی گرداند
توصیفگر حجم (معادل ISO superblock) دستگاه.
معمولاً استفاده از آن کارآمدتر است isoinfo(1) فرمان با -d گزینه روی میزبان
برای تجزیه و تحلیل فایل های ISO، به جای مرور libguestfs.
برای اطلاعات در مورد فیلدهای توصیفگر حجم اولیه، رجوع کنید به
http://wiki.osdev.org/ISO_9660#شرح_جلد_اصلی
مجله-بستن
مجله-بستن
دسته ژورنال را ببندید.
مجله-دریافت
مجله-دریافت
مدخل ژورنال فعلی را بخوانید. این همه فیلدهای مجله را به صورت مجموعه ای از برمی گرداند
"(attrname, attrval)" جفت. "attrname" نام فیلد (رشته) است.
"attrval" مقدار فیلد است (یک لکه باینری، اغلب اما نه همیشه یک رشته). لطفا
توجه داشته باشید که "attrval" یک آرایه بایت است، نه یک رشته C خاتمه یافته \0.
طول داده ممکن است به آستانه داده کوتاه شود (نگاه کنید به: "journal-set-data-
آستانه، "مجله-آستانه-داده-دریافت").
اگر آستانه داده را روی نامحدود (0) تنظیم کنید، این تماس می تواند یک ورودی ژورنالی را بخواند
هر اندازه، یعنی توسط پروتکل libguestfs محدود نمی شود.
journal-get-data-threshold
journal-get-data-threshold
آستانه داده فعلی را برای خواندن نوشته های مجله دریافت کنید. این یک اشاره به مجله است
که ممکن است هنگام خواندن فیلدهای داده به این اندازه آنها را کوتاه کند (همچنین توجه داشته باشید که ممکن است اینطور نباشد
آنها را کوتاه کنید). اگر 0 برگرداند، آستانه نامحدود است.
همچنین به "مجموعه مجله-آستانه داده" مراجعه کنید.
journal-get-realtime-usec
journal-get-realtime-usec
مُهر زمان بیدرنگ (ساعت دیواری) ورودی ژورنال فعلی را دریافت کنید.
مجله-بعدی
مجله-بعدی
به ورودی بعدی مجله بروید. شما باید حداقل یک بار پس از باز کردن آن با آن تماس بگیرید
قبل از اینکه بتوانید داده ها را بخوانید، رسیدگی کنید.
بولی برگشتی به شما می گوید که آیا رکوردهای مجله دیگری برای خواندن وجود دارد یا خیر. "درست است، واقعی"
یعنی می توانید رکورد بعدی را بخوانید (مثلاً با استفاده از "journal-get")، و "false" به این معنی است که دارید
به پایان مجله رسید.
مجله-باز
فهرست باز مجله
ژورنال systemd واقع در را باز کنید فهرست راهنما. هر دسته ژورنالی که قبلاً باز شده باشد
بسته
مطالب مجله را می توان با استفاده از "journal-next" و "journal-get" خواند.
پس از پایان استفاده از ژورنال، باید دستگیره را با تماس ببندید
"ژورنال-بستن".
journal-set-data-threshold
journal-set-data-threshold threshold
آستانه داده را برای خواندن نوشته های مجله تنظیم کنید. این یک اشاره به مجله است که آن را
ممکن است هنگام خواندن فیلدهای داده به این اندازه آنها را کوتاه کند (همچنین توجه داشته باشید که ممکن است اینطور نباشد
آنها را کوتاه کنید). اگر این را روی 0 تنظیم کنید، آستانه نامحدود است.
همچنین به "مجله-دریافت-آستانه داده" مراجعه کنید.
مجله-پرش
journal-skip skip
پرش به جلو («پرش ≥ 0») یا به عقب («پرش < 0») در ژورنال.
تعداد ورودی‌هایی که واقعاً حذف شده‌اند بازگردانده میشود (به "rskip ≥ 0" توجه کنید). اگر این نیست
همان مقدار مطلق پارامتر skip ("|skip|") که در آن پاس کردید، به این معنی است
شما به پایان یا شروع مجله رسیده اید.
کشتن-زیر فرآیند
کشتن-زیر فرآیند
این Hypervisor را از بین می برد.
اینو صدا نکن به جای آن به «خاموش شدن» مراجعه کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "خاموش" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
راه اندازی
اجرا
راه اندازی
شما باید این را بعد از پیکربندی دسته (مثلاً اضافه کردن درایوها) اما قبل از آن فراخوانی کنید
انجام هر گونه عمل
دو بار روی یک دسته، "راه اندازی" را صدا نکنید. اگرچه خطا نمی دهد (برای
دلایل تاریخی)، رفتار دقیق زمانی که شما این کار را انجام می دهید به خوبی تعریف نشده است. دستگیره ها
ایجاد آنها بسیار ارزان است، بنابراین برای هر راه اندازی یک مورد جدید ایجاد کنید.
lchown
مسیر گروه مالک lchown
مالک فایل را به "مالک" و گروه را به "گروه" تغییر دهید. این مانند "چاون" است اما اگر "مسیر"
یک پیوند نمادین است، سپس خود پیوند تغییر می کند، نه هدف.
فقط uid عددی و gid پشتیبانی می شوند. اگر می خواهید از نام ها استفاده کنید، باید مکان یابی کنید
و فایل رمز عبور را خودتان تجزیه کنید (پشتیبانی از Augeas این کار را نسبتاً آسان می کند).
ldmtool-create-all
ldmtool-create-all
این عملکرد تمام دستگاه های بلوکی را که به دنبال حجم های دیسک پویا ویندوز هستند اسکن می کند
پارتیشن بندی می کند و دستگاه هایی را برای هر موجودی که یافت می شود ایجاد می کند.
برای بازگرداندن همه دستگاه‌ها، «list-ldm-volumes» و «list-ldm-partitions» را فراخوانی کنید.
توجه داشته باشید که شما نکن معمولاً باید این را صریحاً فراخوانی کنید، زیرا به طور خودکار انجام می شود
در زمان "پرتاب". با این حال ممکن است بخواهید این تابع را در صورتی که هات پلاگ دارید فراخوانی کنید
دیسک ها یا به تازگی یک دیسک پویا ویندوز ایجاد کرده اند.
ldmtool-diskgroup-disks
ldmtool-diskgroup-diskgroup
دیسک ها را در یک گروه دیسک پویا ویندوز برگردانید. پارامتر "diskgroup" باید باشد
GUID یک گروه دیسک، یک عنصر از لیست برگردانده شده توسط "ldmtool-scan".
ldmtool-diskgroup-name
ldmtool-diskgroup-name diskgroup
نام یک گروه دیسک پویا ویندوز را برگردانید. پارامتر "diskgroup" باید باشد
GUID یک گروه دیسک، یک عنصر از لیست برگردانده شده توسط "ldmtool-scan".
ldmtool-diskgroup-volumes
ldmtool-diskgroup-volumes diskgroup
حجم ها را در یک گروه دیسک پویا ویندوز برگردانید. پارامتر "diskgroup" باید باشد
GUID یک گروه دیسک، یک عنصر از لیست بازگردانده شده توسط "ldmtool-scan".
ldmtool-remove-all
ldmtool-remove-all
این اساساً مخالف "ldmtool-create-all" است. نگاشت دستگاه را حذف می کند
نقشه برداری برای تمام حجم های دیسک پویا ویندوز
ldmtool-scan
ldmtool-scan
این تابع دیسک های پویا ویندوز را اسکن می کند. لیستی از شناسه ها (GUID) را برمی گرداند.
برای همه گروه های دیسکی که پیدا شد. این شناسه ها را می توان به دیگر "ldmtool-*" منتقل کرد
توابع.
این عملکرد تمام دستگاه های بلوک را اسکن می کند. برای اسکن زیر مجموعه ای از دستگاه های بلوک، با "ldmtool-" تماس بگیرید
اسکن دستگاه ها" در عوض.
ldmtool-scan-devices
ldmtool-scan-devices 'devices ...'
این تابع دیسک های پویا ویندوز را اسکن می کند. لیستی از شناسه ها (GUID) را برمی گرداند.
برای همه گروه های دیسکی که پیدا شد. این شناسه ها را می توان به دیگر "ldmtool-*" منتقل کرد
توابع.
پارامتر "دستگاه ها" لیستی از دستگاه های بلوکی است که اسکن می شوند. اگر این لیست است
خالی، تمام دستگاه های بلوک اسکن می شوند.
ldmtool-volume-hint
ldmtool-volume-hint diskgroup volume
فیلد اشاره حجم به نام "volume" را در گروه دیسک با GUID برگردانید
"گروه دیسک". ممکن است این مورد تعریف نشود، در این صورت رشته خالی برگردانده می شود. در
فیلد راهنمایی اغلب، البته نه همیشه، نام یک درایو ویندوز است، به عنوان مثال. "E:".
ldmtool-volume-partitions
حجم گروه دیسک ldmtool-volume-partitions
لیست پارتیشن‌های موجود در حجم به نام "volume" در گروه دیسک را با GUID برگردانید.
"گروه دیسک".
ldmtool-volume-type
ldmtool-volume-type diskgroup volume
نوع حجم به نام "ولوم" را در گروه دیسک با GUID "diskgroup" برگردانید.
انواع حجم‌های احتمالی که می‌توان در اینجا برگرداند عبارتند از: "ساده"، "پهنه‌دار"، "راه راه"،
"Mirrored"، "raid5". انواع دیگر نیز ممکن است بازگردانده شوند.
lgetxattr
نام مسیر lgetxattr
یک ویژگی توسعه یافته را از فایل "path" به نام "name" دریافت کنید. اگر «مسیر» یک پیوند نمادین باشد،
سپس این فراخوانی یک ویژگی توسعه یافته را از symlink برمی گرداند.
معمولاً بهتر است تمام ویژگی های توسعه یافته را از یک فایل به صورت یکجا و با فراخوانی دریافت کنید
"getxattrs". با این حال، برخی از پیاده‌سازی‌های سیستم فایل لینوکس باگ هستند و a
راهی برای فهرست کردن ویژگی ها برای این فایل سیستم ها (به ویژه ntfs-3g) باید بدانید
نام ویژگی های توسعه یافته ای را که می خواهید از قبل نام ببرید و این تابع را فراخوانی کنید.
مقادیر مشخصه توسعه یافته حباب هایی از داده های باینری هستند. اگر ویژگی توسعه یافته وجود نداشته باشد
با نام "name"، یک خطا برمی گرداند.
همچنین ببینید: "lgetxattrs"، "getxattr"، جذب کنند(5).
lgetxattrs
مسیر lgetxattrs
این همان "getxattrs" است، اما اگر "مسیر" یک پیوند نمادین باشد، آن را برمی گرداند
ویژگی های توسعه یافته خود پیوند
list-9p
list-9p
تمام فایل سیستم های 9p پیوست شده به مهمان را فهرست کنید. لیستی از تگ های mount برگردانده می شود.
لیست دستگاه ها
لیست دستگاه ها
تمام دستگاه های بلوک را فهرست کنید.
نام دستگاه های بلوک کامل برگردانده می شود، به عنوان مثال. / dev / sda و.
همچنین به "list-filesystems" مراجعه کنید.
لیست-دیسک-برچسب ها
لیست-دیسک-برچسب ها
اگر درایوها را با استفاده از پارامتر "label" اختیاری "add-drive-opts" اضافه کنید، می توانید استفاده کنید
این فراخوانی برای نگاشت بین برچسب‌های دیسک، و نام‌های دستگاه و پارتیشن بلوک خام (مانند
/ dev / sda و و / dev / sda1).
این یک hashtable را برمی‌گرداند، جایی که کلیدها برچسب‌های دیسک هستند (بدون la /dev/disk/guestfs
پیشوند)، و مقادیر نام دستگاه و پارتیشن بلوک کامل خام هستند (مثلاً. / dev / sda و
و / dev / sda1).
list-dm-devices
list-dm-devices
فهرست همه دستگاه‌های نقشه‌بردار دستگاه.
لیست برگشتی شامل /dev/mapper/* دستگاه ها، به عنوان مثال آنهایی که توسط تماس قبلی ایجاد شده اند
"luks-open".
دستگاه‌های نقشه‌بردار دستگاه که با حجم‌های منطقی مطابقت دارند، هستند نه در این لیست بازگشته است.
اگر می‌خواهید حجم‌های منطقی را فهرست کنید، با «lvs» تماس بگیرید.
لیست-فایل سیستم ها
لیست-فایل سیستم ها
این دستور بازرسی به دنبال سیستم های فایل روی پارتیشن ها، دستگاه های بلوک و منطقی می گردد
حجم‌ها، فهرستی از «موارد قابل نصب» حاوی سیستم‌های فایل و نوع آنها را برمی‌گرداند.
مقدار بازگشتی یک هش است، که در آن کلیدها دستگاه های حاوی سیستم فایل و
مقادیر انواع سیستم فایل هستند. مثلا:
"/dev/sda1" => "ntfs"
"/dev/sda2" => "ext2"
"/dev/vg_guest/lv_root" => "ext4"
"/dev/vg_guest/lv_swap" => "swap"
کلید لزوماً یک دستگاه بلوک نیست. همچنین ممکن است یک رشته «قابل نصب» مات باشد
که می توان آن را به "mount" منتقل کرد.
مقدار می تواند دارای مقدار ویژه "ناشناخته" باشد، به این معنی که محتوای دستگاه است
نامشخص یا خالی "swap" به معنای یک پارتیشن تعویض لینوکس است.
این دستور سایر دستورات libguestfs را اجرا می کند که ممکن است شامل "mount" و "umount" باشد، و
بنابراین شما باید بلافاصله پس از راه اندازی و فقط زمانی که هیچ چیز نصب نشده است از آن استفاده کنید.
همه فایل سیستم های بازگشتی قابل نصب نیستند. به طور خاص، پارتیشن های swap هستند
در لیست بازگشت. همچنین این دستور بررسی نمی کند که هر فایل سیستمی که پیدا شده است باشد
معتبر و قابل نصب است و برخی از سیستم های فایل ممکن است قابل نصب باشند اما به گزینه های خاصی نیاز دارند.
سیستم‌های فایل ممکن است همه متعلق به یک سیستم عامل منطقی نباشند (از "inspect-os" استفاده کنید
به دنبال سیستم عامل باشید).
list-ldm-partitions
list-ldm-partitions
این تابع تمام پارتیشن‌های دیسک پویا ویندوز را که در زمان راه‌اندازی پیدا شده بودند، برمی‌گرداند.
لیستی از نام دستگاه ها را برمی گرداند.
list-ldm-volumes
list-ldm-volumes
این تابع تمام حجم‌های دیسک پویا ویندوز را که در زمان راه‌اندازی پیدا شده بودند، برمی‌گرداند. آی تی
لیستی از نام دستگاه ها را برمی گرداند.
list-md-devices
list-md-devices
لیست تمام دستگاه های لینوکس md.
لیست پارتیشن ها
لیست پارتیشن ها
لیست تمام پارتیشن های شناسایی شده در همه دستگاه های بلوک.
نام دستگاه های پارتیشن کامل برگردانده می شود، به عنوان مثال. / dev / sda1
این حجم های منطقی را بر نمی گرداند. برای این کار باید با "lvs" تماس بگیرید.
همچنین به "list-filesystems" مراجعه کنید.
ll
فهرست ll
لیست فایل های موجود در فهرست راهنما (نسبت به دایرکتوری ریشه، cwd وجود ندارد) در
قالب "ls -la".
این دستور بیشتر برای جلسات تعاملی مفید است. این است نه قصد داشتی تلاش کنی
برای تجزیه رشته خروجی
llz
دایرکتوری llz
لیست فایل های موجود در فهرست راهنما در قالب 'ls -laZ'.
این دستور بیشتر برای جلسات تعاملی مفید است. این است نه قصد داشتی تلاش کنی
برای تجزیه رشته خروجی
ln
نام پیوند را هدف قرار دهید
این دستور با استفاده از دستور "ln" یک لینک سخت ایجاد می کند.
ln-f
نام پیوند هدف ln-f
این دستور با استفاده از دستور "ln -f" یک پیوند سخت ایجاد می کند. در -f گزینه را حذف می کند
پیوند ("نام پیوند") اگر قبلا وجود داشته باشد.
ln-s
نام پیوند هدف ln-s
این دستور با استفاده از دستور "ln -s" یک پیوند نمادین ایجاد می کند.
ln-sf
نام پیوند هدف ln-sf
این دستور یک پیوند نمادین با استفاده از دستور "ln -sf"، The ایجاد می کند -f گزینه را حذف می کند
پیوند ("نام پیوند") اگر قبلا وجود داشته باشد.
lremovexattr
مسیر lremovexattr xattr
این همان "removexattr" است، اما اگر "مسیر" یک پیوند نمادین باشد، یک پیوند را حذف می کند.
ویژگی توسعه یافته خود پیوند
ls
دایرکتوری ls
لیست فایل های موجود در فهرست راهنما (نسبت به دایرکتوری ریشه، cwd وجود ندارد). '.'
و ورودی های '..' برگردانده نمی شوند، اما فایل های مخفی نشان داده می شوند.
ls0
ls0 dir (نام فایل|-)
از این دستور تخصصی برای دریافت فهرستی از نام فایل ها در دایرکتوری "dir" استفاده می شود.
لیست نام فایل ها در فایل محلی نوشته می شود نام فایل ها (در میزبان).
در فایل خروجی، نام فایل ها با کاراکترهای "\0" از هم جدا می شوند.
"." و «..» برگردانده نمی شوند. نام فایل ها مرتب نشده اند.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
lsetxattr
مسیر lsetxattr xattr val vallen
این همان "setxattr" است، اما اگر "مسیر" یک پیوند نمادین باشد، آنگاه یک پیوند توسعه یافته تنظیم می کند.
ویژگی خود لینک
lstat
مسیر lstat
اطلاعات فایل را برای "مسیر" داده شده برمی گرداند.
این همان "stat" است با این تفاوت که اگر "مسیر" یک پیوند نمادین است، پس پیوند است
stat-ed، نه فایلی که به آن اشاره دارد.
این همان است lstat(2) تماس سیستمی.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "lstatns" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
lstatlist
lstatlist مسیر "نام ها ..."
این تماس به شما اجازه می دهد تا عملیات "lstat" را بر روی چندین فایل انجام دهید، که در آن همه فایل ها وجود دارد
در دایرکتوری "path" قرار دارند. "names" لیستی از فایل های این فهرست است.
در بازگشت، فهرستی از ساختارهای آماری را دریافت می‌کنید، با یک مکاتبه یک به یک با «نامها»
فهرست اگر نامی وجود نداشت یا نمی توانست lstat'd شود، قسمت "st_ino" آن
ساختار روی "-1" تنظیم شده است.
این فراخوان برای برنامه‌هایی در نظر گرفته شده است که می‌خواهند محتویات دایرکتوری را به طور مؤثر فهرست کنند
بدون رفت و برگشت زیاد همچنین به "lxattrlist" برای یک تماس کارآمد مشابه مراجعه کنید
دریافت ویژگی های توسعه یافته
این تابع is منسوخ. در کد جدید، به جای آن از تماس "lstatnslist" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
lstatns
مسیر lstatns
اطلاعات فایل را برای "مسیر" داده شده برمی گرداند.
این همان "statns" است با این تفاوت که اگر "مسیر" یک پیوند نمادین است، پس پیوند است
stat-ed، نه فایلی که به آن اشاره دارد.
این همان است lstat(2) تماس سیستمی.
lstatnslist
lstatnslist مسیر "نام ..."
این فراخوانی به شما اجازه می دهد تا عملیات "lstatns" را بر روی چندین فایل انجام دهید، که در آن همه فایل ها وجود دارد
در دایرکتوری "path" قرار دارند. "names" لیستی از فایل های این فهرست است.
در بازگشت، فهرستی از ساختارهای آماری را دریافت می‌کنید، با یک مکاتبه یک به یک با «نامها»
فهرست اگر نامی وجود نداشت یا نمی توانست lstat'd شود، قسمت "st_ino" آن
ساختار روی "-1" تنظیم شده است.
این فراخوان برای برنامه‌هایی در نظر گرفته شده است که می‌خواهند محتویات دایرکتوری را به طور مؤثر فهرست کنند
بدون رفت و برگشت زیاد همچنین به "lxattrlist" برای یک تماس کارآمد مشابه مراجعه کنید
دریافت ویژگی های توسعه یافته
luks-add-key
کلید دستگاه luks-add-key
این دستور کلید جدیدی را به دستگاه LUKS "دستگاه" اضافه می کند. "کلید" هر کلید موجود است و هست
برای دسترسی به دستگاه استفاده می شود. "newkey" کلید جدیدی برای اضافه کردن است. "slot" محل کلید است
که جایگزین خواهد شد.
توجه داشته باشید که اگر «slot» قبلاً حاوی یک کلید باشد، این دستور با شکست مواجه خواهد شد. تو باید
ابتدا از "luks-kill-slot" برای حذف آن کلید استفاده کنید.
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
luks-close
دستگاه luks-close
این دستگاه LUKS را که قبلاً توسط "luks-open" یا "luks-open-ro" ایجاد شده بود، بسته می شود. در
پارامتر "دستگاه" باید نام دستگاه نقشه برداری LUKS باشد (یعنی /dev/mapper/mapname)
و نه نام دستگاه بلوک زیرین.
luks-format
کلید دستگاه با فرمت luks
این دستور داده های موجود در "دستگاه" را پاک می کند و دستگاه را به عنوان یک LUKS رمزگذاری شده فرمت می کند
دستگاه "کلید" کلید اولیه است که به شکاف کلید اضافه می شود. (LUKS از 8 پشتیبانی می کند
اسلات کلید، شماره 0-7).
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
luks-format-cipher
luks-format-cipher cipher keyslot device
این دستور همان "luks-format" است، اما به شما اجازه می دهد تا "رمز" مورد استفاده را نیز تنظیم کنید.
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
luks-kill-slot
کلید دستگاه luks-kill-slot
این دستور کلید در شکاف کلید "keyslot" را از دستگاه رمزگذاری شده LUKS حذف می کند
"دستگاه". "کلید" باید یکی از دیگر کلیدها
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
luks-open
نام نقشه دستگاه luks-open
این دستور یک دستگاه بلوکی را باز می کند که طبق Linux Unified رمزگذاری شده است
استاندارد تنظیم کلید (LUKS).
"دستگاه" دستگاه یا پارتیشن بلوک رمزگذاری شده است.
تماس گیرنده باید یکی از کلیدهای مرتبط با دستگاه بلوک LUKS را در "کلید" ارائه کند.
پارامتر.
این یک دستگاه بلوک جدید به نام ایجاد می کند /dev/mapper/mapname. این را می خواند و می نویسد
دستگاه بلوک به ترتیب از «دستگاه» زیرین رمزگشایی و رمزگذاری می شود.
اگر این دستگاه بلوک حاوی گروه‌های حجمی LVM باشد، «vgscan» را فراخوانی کنید و سپس «vg-
activate-all" آنها را قابل مشاهده می کند.
از «list-dm-devices» برای فهرست کردن همه دستگاه‌های نقشه‌بردار دستگاه استفاده کنید.
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
luks-open-ro
نام نقشه دستگاه luks-open-ro
این همان "luks-open" است با این تفاوت که یک نقشه فقط خواندنی ایجاد می شود.
این دستور یک یا چند پارامتر کلیدی یا رمز عبور دارد. Guestfish درخواست خواهد کرد
اینها جدا
lvcreate
lv بایت های logvol volgroup را ایجاد کنید
این یک حجم منطقی LVM به نام "logvol" در گروه حجم "volgroup" ایجاد می کند
"اندازه" مگابایت.
بدون lvcreate
درصد logvol volgroup بدون lvcreate
یک حجم منطقی LVM به نام ایجاد کنید /dev/volgroup/logvol، با استفاده از "درصد" %
از فضای خالی باقی مانده در گروه حجم. مفیدترین حالت زمانی است که "درصد" 100 باشد
این بزرگترین LV ممکن را ایجاد می کند.
lvm-cononical-lv-name
lvm-cononical-lv-name lvname
این طرح‌های نامگذاری جایگزین را برای LVهایی که ممکن است پیدا کنید به نامگذاری متعارف تبدیل میکند
نام. مثلا، /dev/mapper/VG-LV تبدیل /dev/VG/LV.
اگر پارامتر "lvname" به یک منطقی اشاره نکند، این دستور یک خطا برمی گرداند
جلد.
همچنین به "is-lv"، "canonical-device-name" مراجعه کنید.
lvm-clear-filter
lvm-clear-filter
این اثر "lvm-set-filter" را خنثی می کند. LVM قادر خواهد بود هر دستگاه بلوکی را ببیند.
این دستور همچنین کش LVM را پاک می کند و یک اسکن گروه حجمی را انجام می دهد.
lvm-remove-all
lvm-remove-all
این دستور تمام حجم های منطقی LVM، گروه های حجم و حجم های فیزیکی را حذف می کند.
lvm-set-filter
lvm-set-filter 'devices ...'
این فیلتر دستگاه LVM را به گونه ای تنظیم می کند که LVM فقط می تواند دستگاه های بلوک را "دیدن" کند
در لیست «دستگاه‌ها» قرار دارد و تمام دستگاه‌های بلوک متصل دیگر را نادیده می‌گیرد.
در جایی که تصویر(های) دیسک حاوی PV یا VGهای تکراری است، این دستور برای دریافت LVM به
موارد تکراری را نادیده بگیرید، در غیر این صورت LVM ممکن است گیج شود. توجه داشته باشید که دو نوع وجود دارد
امکان تکرار وجود دارد: PV/VGهای کلون شده که دارای UUID یکسان هستند. یا VG هایی که هستند
شبیه سازی نشده اما اتفاقاً همین نام را دارد. در عملکرد عادی شما نمی توانید ایجاد کنید
این وضعیت، اما شما می توانید آن را خارج از LVM انجام دهید، به عنوان مثال. با شبیه سازی تصاویر دیسک یا با بیت
چرخش در داخل ابرداده LVM.
این دستور همچنین کش LVM را پاک می کند و یک اسکن گروه حجمی را انجام می دهد.
می توانید کل دستگاه های بلوک یا پارتیشن های جداگانه را فیلتر کنید.
اگر VG در حال حاضر در حال استفاده است (به عنوان مثال شامل یک فایل سیستم نصب شده) نمی توانید از آن استفاده کنید.
حتی اگر VG را فیلتر نکنید.
lvremove
دستگاه lvremove
حذف یک "دستگاه" حجم منطقی LVM، که در آن "دستگاه" مسیر LV است، مانند
/dev/VG/LV.
شما همچنین می توانید تمام LV ها را در یک گروه حجمی با تعیین نام VG حذف کنید. /dev/VG.
lvrename
lvrename logvol newlogvol
نام یک جلد منطقی را به "logvol" با نام جدید "newlogvol" تغییر دهید.
lvresize
lvresize دستگاه بایت
این یک حجم منطقی LVM موجود را به "مگابایت" تغییر اندازه می دهد (بسط یا کوچک می کند). چه زمانی
با کاهش، داده ها در قسمت کاهش یافته از بین می روند.
بدون lvresize
درصد lv بدون lvresize
این یک حجم منطقی موجود "lv" را گسترش می دهد به طوری که "pc"٪ از باقی مانده رایگان را پر می کند.
فضای در گروه حجم معمولاً شما این را با pc = 100 می نامید که گسترش می یابد
حجم منطقی تا حد امکان، با استفاده از تمام فضای خالی باقی مانده در گروه حجم.
lvs
lvs
تمام حجم های منطقی شناسایی شده را فهرست کنید. این معادل است lvs(8) فرمان.
این فهرستی از نام‌های حجم منطقی دستگاه (مثلاً /dev/VolGroup00/LogVol00).
همچنین به "lvs-full"، "list-filesystems" مراجعه کنید.
lvs-full
lvs-full
تمام حجم های منطقی شناسایی شده را فهرست کنید. این معادل است lvs(8) فرمان. در
نسخه "کامل" شامل تمام فیلدها است.
lvuuid
دستگاه lvuuid
این دستور UUID دستگاه LVM LV را برمی گرداند.
lxattrlist
lxattrlist مسیر 'نام ها ...'
این فراخوانی به شما امکان می دهد تا ویژگی های توسعه یافته چندین فایل را که همه فایل ها در آن قرار دارند، دریافت کنید
در دایرکتوری "path". "names" لیستی از فایل های این فهرست است.
در بازگشت شما یک لیست مسطح از ساختارهای xattr دریافت می کنید که باید به صورت متوالی تفسیر شوند.
اولین ساختار xattr همیشه یک "attrname" با طول صفر دارد. "attrval" در این ساختار است
طول صفر برای نشان دادن خطایی در انجام "lgetxattr" برای این فایل، or C است
رشته ای که یک عدد اعشاری است (تعداد ویژگی های زیر برای این فایل، که
می تواند "0" باشد). سپس بعد از اولین ساختار xattr صفت های صفر یا بیشتر برای آن وجود دارد
فایل با نام اول این کار برای فایل دوم و بعدی تکرار می شود.
این فراخوان برای برنامه‌هایی در نظر گرفته شده است که می‌خواهند محتویات دایرکتوری را به طور مؤثر فهرست کنند
بدون رفت و برگشت زیاد همچنین برای یک تماس کارآمد مشابه به "lstatlist" مراجعه کنید
گرفتن آمار استاندارد
حداکثر دیسک ها
حداکثر دیسک ها
حداکثر تعداد دیسک‌هایی که ممکن است به یک دسته اضافه شوند را برگردانید (مثلاً توسط "add-drive-opts"
و تماس های مشابه).
این تابع در libguestfs 1.19.7 اضافه شده است. در نسخه های قبلی libguestfs
حد 25 بود
"حداکثر تعداد دیسک" را در مهمانان(3) برای اطلاعات بیشتر در مورد این موضوع.
md-create
md-ایجاد نام «دستگاه‌ها ...» [missingbitmap:N] [nrdevices:N] [یدک:N] [chunk:N] [سطح:..]
یک دستگاه Linux md (RAID) با نام "name" در دستگاه های موجود در لیست "devices" ایجاد کنید.
پارامترهای اختیاری عبارتند از:
"missingbitmap"
نقشه بیتی از دستگاه های گم شده اگر یک بیت تنظیم شده باشد به این معنی است که یک دستگاه گم شده اضافه شده است
به آرایه کم اهمیت ترین بیت مربوط به اولین دستگاه در آرایه است.
به عنوان نمونه:
اگر "devices = ["/dev/sda"]" و "missingbitmap = 0x1"، آرایه حاصل خواهد شد
بودن "[ ، "/dev/sda"]".
اگر "devices = ["/dev/sda"]" و "missingbitmap = 0x2"، آرایه حاصل خواهد شد
"["/dev/sda" باشد، ]".
این به طور پیش فرض روی 0 است (بدون دستگاه گم شده).
طول "دستگاه ها" + تعداد بیت های تنظیم شده در "missingbitmap" باید برابر باشد
"nrdevices" + "یدکی".
"nrdevices"
تعداد دستگاه های RAID فعال
اگر تنظیم نشود، این به طور پیش‌فرض روی طول «دستگاه‌ها» به اضافه تعداد بیت‌های تنظیم‌شده است
"missingbitmap".
"یدکی"
تعداد وسایل یدکی
اگر تنظیم نشده باشد، این پیش فرض روی 0 است.
"تکه"
اندازه تکه به بایت
"مرحله"
سطح RAID که می تواند یکی از موارد زیر باشد: خطی, 0, 0, پارچه راه راه, 1, 1, آینه,
4, 4, 5, 5, 6, 6, 10, 10. برخی از اینها مترادف هستند و بیشتر
سطوح ممکن است در آینده اضافه شود.
اگر تنظیم نشده باشد، این به طور پیش فرض روی "raid1" است.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
md-detail
md-detail md
این دستور خروجی 'mdadm -DY را نشان می دهد '. فیلدهای زیر معمولاً هستند
موجود در هش برگشتی ممکن است فیلدهای دیگری نیز وجود داشته باشد.
"مرحله"
سطح حمله دستگاه MD.
"دستگاه ها"
تعداد دستگاه های زیرین در دستگاه MD.
"فراداده"
نسخه ابرداده استفاده شده
"uuid"
UUID دستگاه MD.
"نام"
نام دستگاه MD.
md-stat
md-stat md
این تماس فهرستی از دستگاه های زیربنایی را که RAID نرم افزاری واحد را تشکیل می دهند، برمی گرداند
دستگاه آرایه "md".
برای دریافت لیستی از دستگاه های RAID نرم افزاری، با "list-md-devices" تماس بگیرید.
هر ساختار برگشتی مربوط به یک دستگاه همراه با وضعیت اضافی است
اطلاعات:
"mdstat_device"
نام دستگاه زیرین.
"mdstat_index"
شاخص این دستگاه در آرایه.
"mdstat_flags"
پرچم های مرتبط با این دستگاه. این یک رشته حاوی (بدون ترتیب خاصی) است
صفر یا بیشتر از پرچم های زیر:
"W" بیشتر می نویسد
دستگاه "F" معیوب است
دستگاه "S" یک RAID یدکی است
جایگزینی "R".
md-stop
md-stop md
این دستور آرایه MD با نام "md" را غیرفعال می کند. دستگاه متوقف شده است، اما اینطور نیست
نابود یا به صفر می رسد.
mkdir
مسیر mkdir
یک دایرکتوری به نام مسیر ایجاد کنید.
حالت mkdir
حالت مسیر mkdir-mode
این دستور یک دایرکتوری ایجاد می کند و مجوزهای اولیه دایرکتوری را تنظیم می کند
"حالت".
برای سیستم های فایل لینوکس معمولی، حالت واقعی که تنظیم می شود "mode & ~umask &" خواهد بود.
01777". فایل سیستم های غیر بومی لینوکس ممکن است حالت را به روش های دیگری تفسیر کنند.
همچنین به "mkdir"، "umask" مراجعه کنید.
mkdir-p
مسیر mkdir-p
یک دایرکتوری به نام "path" ایجاد کنید و هر دایرکتوری والد را در صورت لزوم ایجاد کنید. این هست
مانند دستور پوسته "mkdir -p".
mkdtemp
mkdtemp tmpl
این دستور یک دایرکتوری موقت ایجاد می کند. پارامتر "tmpl" باید کامل باشد
نام مسیر برای نام دایرکتوری موقت با شش کاراکتر پایانی "XXXXXX".
به عنوان مثال: "/tmp/myprogXXXXXX" یا "/Temp/myprogXXXXXX" که مورد دوم مناسب است
برای فایل سیستم های ویندوز
نام دایرکتوری موقت ایجاد شده برگردانده می شود.
دایرکتوری موقت با حالت 0700 ایجاد شده و متعلق به root است.
تماس گیرنده مسئول حذف دایرکتوری موقت و محتویات آن پس از استفاده است.
همچنین نگاه کنید به: mkdtemp(3)
mke2fs
دستگاه mke2fs [blockscount:N] [blocksize:N] [fragsize:N] [blockspergroup:N] [numberofgroups:N] [bytesperinode:N] [inodesize:N] [journalsize:N] [numberofinodes:N] [stridesize: N] [stripewidth:N] [maxonlinesize:N] [reservedblockspercentage:N] [mmpupdateinterval:N] [journaldevice:..] [label:..] [lastmounteddir:..] [creatoros:..] [fstyle:. .] [نوع استفاده:..] [uuid:..] [اجباری ایجاد: درست|نادرست] [نوشتنگروه فقط:درست|نادرست] [lazyitableinit:درست|نادرست] [lazyjournalinit:درست|نادرست] [testfs:true|نادرست] [ رد کردن:درست|نادرست] [quotatype:درست|نادرست] [گستره:درست|نادرست] [نوع فایل:درست|نادرست] [flexbg:درست|نادرست] [hasjournal:درست|نادرست] [journaldev:درست|نادرست] [فایل بزرگ :true|false] [سهمیه:true|false] [resizeinode:true|false] [sparsesuper:true|false] [unitbg:true|false]
"mke2fs" برای ایجاد یک فایل سیستم ext2، ext3 یا ext4 در "دستگاه" استفاده می شود.
اختیاری "blockscount" اندازه سیستم فایل در بلوک است. در صورت حذف آن
پیش فرض به اندازه "دستگاه". توجه داشته باشید که اگر سیستم فایل آنقدر کوچک است که حاوی a باشد
ژورنال، "mke2fs" به جای آن یک سیستم فایل ext2 در سکوت ایجاد می کند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mke2fs-J
مجله دستگاه mke2fs-J fstype اندازه بلوک
این یک فایل سیستم ext2/3/4 را در "دستگاه" با یک مجله خارجی در "ژورنال" ایجاد می کند. آی تی
معادل دستور:
mke2fs -t fstyle -b blocksize -J device=
همچنین به "mke2journal" مراجعه کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mke2fs-JL
برچسب دستگاه fstype mke2fs-JL
این یک فایل سیستم ext2/3/4 در "دستگاه" با یک مجله خارجی در مجله ایجاد می کند.
با برچسب "برچسب".
همچنین به "mke2journal-L" مراجعه کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mke2fs-JU
mke2fs-JU fstype blocksize uuid دستگاه
این یک فایل سیستم ext2/3/4 در "دستگاه" با یک مجله خارجی در مجله ایجاد می کند.
با UUID "uuid".
همچنین به "mke2journal-U" مراجعه کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mke2journal
دستگاه اندازه بلوک mke2journal
این یک مجله خارجی ext2 در "دستگاه" ایجاد می کند. معادل این دستور است:
mke2fs -O journal_dev -b اندازه بلوک دستگاه
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mke2journal-L
دستگاه برچسب اندازه بلوک mke2journal-L
این یک مجله خارجی ext2 روی "دستگاه" با برچسب "label" ایجاد می کند.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mke2journal-U
دستگاه uuid اندازه بلوک mke2journal-U
این یک مجله خارجی ext2 در "دستگاه" با UUID "uuid" ایجاد می کند.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mke2fs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mkfifo
مسیر حالت mkfifo
این فراخوانی یک FIFO (لوله با نام) به نام "path" با حالت "mode" ایجاد می کند. این فقط یک است
بسته بندی مناسب در اطراف "mknod".
برخلاف "mknod"، "mode" باید فقط شامل بیت های مجوز است.
حالتی که در واقع تنظیم شده است تحت تأثیر umask قرار می گیرد.
mkfs
mkfs-opts
دستگاه fstyle mkfs [blocksize:N] [ویژگی ها:..] [inode:N] [sectorsize:N] [label:..]
این تابع یک فایل سیستم را در "دستگاه" ایجاد می کند. نوع فایل سیستم "fstyle" است، برای
مثال "ext3".
آرگومان های اختیاری عبارتند از:
"بلاک کردن"
اندازه بلوک فایل سیستم اندازه بلوک های پشتیبانی شده به نوع سیستم فایل بستگی دارد، اما
معمولاً برای فایل سیستم های لینوکس ext1024/2048 4096، 2 یا 3 هستند.
برای VFAT و NTFS پارامتر "blockize" به عنوان اندازه خوشه درخواستی در نظر گرفته می شود.
برای اندازه‌های بلوک UFS، لطفاً ببینید mkfs.ufs(8).
"امکانات"
این عبور می کند -O پارامتر برنامه mkfs خارجی.
برای انواع سیستم فایل خاص، این امکان انتخاب ویژگی های فایل سیستم اضافی را فراهم می کند.
دیدن mke2fs(8) و mkfs.ufs(8) برای جزئیات بیشتر.
شما نمی توانید از این پارامتر اختیاری با نوع سیستم فایل "gfs" یا "gfs2" استفاده کنید.
"inode"
این عبور می کند -I پارامتر به خارجی mke2fs(8) برنامه ای که inode را تنظیم می کند
اندازه (در حال حاضر فقط برای فایل سیستم های ext2/3/4).
"اندازه بخش"
این عبور می کند -S پارامتر به خارجی mkfs.ufs(8) برنامه، که اندازه بخش را تعیین می کند
برای فایل سیستم ufs
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mkfs-b
دستگاه mkfs-b fstype اندازه بلوک
این فراخوانی شبیه به "mkfs" است، اما به شما امکان می دهد اندازه بلوک را کنترل کنید
فایل سیستم حاصل اندازه بلوک های پشتیبانی شده به نوع سیستم فایل بستگی دارد، اما معمولا
آنها فقط 1024، 2048 یا 4096 هستند.
برای VFAT و NTFS پارامتر "blockize" به عنوان اندازه خوشه درخواستی در نظر گرفته می شود.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "mkfs" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mkfs-btrfs
mkfs-btrfs 'devices ...' [allocstart:N] [bytecount:N] [datatype:..] [leafsize:N] [label:..] [metadata:..] [nodesize:N] [sectorsize: N]
یک فایل سیستم btrfs ایجاد کنید، که اجازه می دهد تمام تنظیمات قابل تنظیم تنظیم شوند. برای اطلاعات بیشتر در
آرگومان های اختیاری را ببینید mkfs.btrfs(8).
از آنجایی که فایل سیستم‌های btrfs می‌توانند چندین دستگاه را دربر گیرند، لیستی از دستگاه‌ها خالی نیست.
برای ایجاد فایل سیستم های عمومی، از "mkfs" استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mklost-and-found
نقطه کوه mklost-and-found
دایرکتوری "Lost+found" را، معمولاً در دایرکتوری ریشه یک سیستم فایل ext2/3/4 ایجاد کنید.
"mountpoint" دایرکتوری است که در آن سعی می کنیم دایرکتوری "Lost+found" را ایجاد کنیم.
mkmountpoint
mkmountpoint exemptpath
"mkmountpoint" و "rmmountpoint" تماس های تخصصی هستند که می توانند برای ایجاد موارد اضافی استفاده شوند
mountpoint ها قبل از نصب اولین فایل سیستم.
این تماس ها هستند فقط در برخی شرایط بسیار محدود ضروری است، عمدتاً در مواردی که
می‌خواهید ترکیبی از فایل‌سیستم‌های نامرتبط و/یا فقط خواندنی را با هم سوار کنید.
برای مثال، سی‌دی‌های زنده اغلب حاوی یک لانه «عروسک روسی» از سیستم‌های فایل، یک ISO بیرونی هستند.
لایه، با یک تصویر squashfs در داخل، با یک تصویر ext2/3 در داخل آن. می توانید بسته بندی را باز کنید
این در guestfish به شرح زیر است:
add-ro Fedora-11-i686-Live.iso
اجرا
mkmountpoint /cd
mkmountpoint /sqsh
mkmountpoint /ext3fs
mount /dev/sda /cd
mount-loop /cd/LiveOS/squashfs.img /sqsh
mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs
فایل سیستم داخلی اکنون در زیر نقطه نصب /ext3fs باز شده است.
"mkmountpoint" با "umount-all" سازگار نیست. در این صورت ممکن است خطاهای غیرمنتظره ای دریافت کنید
سعی کنید این تماس ها را مخلوط کنید. ایمن‌ترین کار این است که فایل‌سیستم‌ها را به‌صورت دستی جدا کرده و حذف کنید
نقاط اتصال پس از استفاده
"umount-all" سیستم های فایل را با مرتب کردن طولانی ترین مسیرها ابتدا جدا می کند تا کار کند
برای نقاط نصب دستی، باید مطمئن شوید که داخلی ترین نقاط نصب، طولانی ترین را دارند
نام مسیر، مانند کد مثال بالا.
برای جزئیات بیشتر به https://bugzilla.redhat.com/show_bug.cgi?id=599503 مراجعه کنید
همگام‌سازی خودکار [به «set-autosync» مراجعه کنید، این به‌طور پیش‌فرض روی دسته‌ها تنظیم شده است] می‌تواند باعث «umount-all» شود
هنگامی که دستگیره بسته است فراخوانی شود که می تواند این مشکلات را نیز ایجاد کند.
mknod
مسیر mknod devmajor devminor
این فراخوانی دستگاه های مخصوص بلوک یا کاراکتر یا لوله های نامگذاری شده (FIFO) را ایجاد می کند.
پارامتر "mode" باید حالت، با استفاده از ثابت های استاندارد باشد. "devmajor" و
"devminor" اعداد اصلی و کوچک دستگاه هستند که فقط هنگام ایجاد بلوک و استفاده می شوند
دستگاه های ویژه شخصیت
توجه داشته باشید که، درست مانند mknod(2)، حالت باید به صورت بیتی باشد یا با S_IFBLK، S_IFCHR،
S_IFIFO یا S_IFSOCK (در غیر این صورت این تماس فقط یک فایل معمولی ایجاد می کند). این ثابت ها
در فایل‌های هدر لینوکس استاندارد موجود هستند، یا می‌توانید از «mknod-b»، «mknod-c» یا
"mkfifo" که بسته‌بندی‌هایی در اطراف این دستور هستند که به صورت بیتی OR در مناسب هستند
برای شما ثابت است
حالتی که در واقع تنظیم شده است تحت تأثیر umask قرار می گیرد.
mknod-b
مسیر devminor حالت mknod-b
این تماس یک گره دستگاه بلوکی به نام «مسیر» با حالت «حالت» و دستگاه ایجاد میکند
ماژور/مینور «devmajor» و «devminor». این فقط یک بسته بندی مناسب در اطراف "mknod" است.
برخلاف "mknod"، "mode" باید فقط شامل بیت های مجوز است.
حالتی که در واقع تنظیم شده است تحت تأثیر umask قرار می گیرد.
mknod-c
مسیر devminor حالت mknod-c
این فراخوانی یک گره دستگاه char به نام "path" با حالت "mode" و دستگاه اصلی/مینور ایجاد می کند
"devmajor" و "devminor". این فقط یک بسته بندی مناسب در اطراف "mknod" است.
برخلاف "mknod"، "mode" باید فقط شامل بیت های مجوز است.
حالتی که در واقع تنظیم شده است تحت تأثیر umask قرار می گیرد.
mkswap
mkswap-opts
دستگاه mkswap [برچسب:..] [uuid:..]
یک پارتیشن تعویض لینوکس در "دستگاه" ایجاد کنید.
آرگومان های گزینه "label" و "uuid" به شما امکان می دهد برچسب و/یا UUID جدید را تنظیم کنید.
پارتیشن تعویض
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mkswap-L
دستگاه لیبل mkswap-L
یک پارتیشن مبادله در "دستگاه" با برچسب "label" ایجاد کنید.
توجه داشته باشید که نمی‌توانید برچسب تعویض را به یک دستگاه بلوک وصل کنید (مثلاً / dev / sda و)، فقط به یک
تقسیم بندی. به نظر می رسد که این محدودیت هسته یا ابزار مبادله باشد.
این تابع is منسوخ. در کد جدید، به جای آن از تماس «mkswap» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mkswap-U
دستگاه mkswap-U uuid
یک پارتیشن مبادله در "دستگاه" با UUID "uuid" ایجاد کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس «mkswap» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
mkswap-file
مسیر فایل mkswap
یک فایل swap ایجاد کنید.
این دستور فقط یک امضای فایل swap را روی یک فایل موجود می نویسد. برای ایجاد فایل
خود، از چیزی مانند "fallocate" استفاده کنید.
mktemp
mktemp tmpl [پسوند:..]
این دستور یک فایل موقت ایجاد می کند. پارامتر "tmpl" باید یک نام مسیر کامل برای آن باشد
نام دایرکتوری موقت با شش کاراکتر پایانی "XXXXXX".
به عنوان مثال: "/tmp/myprogXXXXXX" یا "/Temp/myprogXXXXXX" که مورد دوم مناسب است
برای فایل سیستم های ویندوز
نام فایل موقت ایجاد شده برگردانده می شود.
فایل موقت با حالت 0600 ایجاد شده و متعلق به root است.
تماس گیرنده مسئول حذف فایل موقت پس از استفاده است.
اگر پارامتر اختیاری "پسوند" داده شود، پسوند (مثلاً ".txt") به آن اضافه می شود.
نام موقت
همچنین ببینید: "mkdtemp".
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
پروب پرو
modprobe نام ماژول
این یک ماژول هسته را در دستگاه بارگیری می کند.
استقرار (mount)
mount mountpoint mountpoint
دیسک مهمان را در یک موقعیت در سیستم فایل نصب کنید. دستگاه های بلوک نامگذاری شده اند / dev / sda و,
/ dev / sdb و غیره همانطور که به مهمان اضافه شدند. اگر آن دستگاه های بلوک حاوی
پارتیشن‌ها، نام‌های معمولی را خواهند داشت (مثلاً / dev / sda1). همچنین LVM /dev/VG/LVسبک
می‌توان از نامها استفاده کرد یا رشته‌های «قابل نصب» توسط «list-filesystems» یا «inspect-get-» برگردانده شد.
نقاط کوه".
قوانین همان است که برای استقرار (mount)(2): ابتدا باید یک فایل سیستم نصب شود / قبل از
دیگران را می توان نصب کرد. سایر سیستم های فایل را فقط می توان بر روی دایرکتوری هایی که قبلاً نصب شده اند نصب کرد
وجود دارد
در صورتی که مجوزهای کافی در زمینه اصلی داشته باشیم، سیستم فایل نصب شده قابل نوشتن است
دستگاه.
قبل از libguestfs 1.13.16، این فراخوان به طور ضمنی گزینه های "sync" و "noatime" را اضافه کرد.
گزینه "همگام سازی" سرعت نوشتن را به شدت کاهش داد و مشکلات زیادی را برای کاربران ایجاد کرد. اگر شما
ممکن است برنامه نیاز به کار با نسخه های قدیمی libguestfs داشته باشد، به جای آن از "mount-options" استفاده کنید.
(اگر هیچ گزینه ای نمی خواهید از یک رشته خالی برای پارامتر اول استفاده کنید).
mount-9p
mount-9p mounttag mountpoint [گزینه‌ها:..]
فایل سیستم virtio-9p را با تگ "mounttag" در پوشه "mountpoint" نصب کنید.
در صورت نیاز، "trans=virtio" به طور خودکار به گزینه ها اضافه می شود. هر گزینه دیگری
مورد نیاز را می توان در پارامتر اختیاری "گزینه ها" ارسال کرد.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mount-local
mount-local localmountpoint [readonly:true|false] [گزینه‌ها:..] [cachetimeout:N] [debugcalls:true|false]
این فراخوانی سیستم فایل قابل دسترسی libguestfs را به یک Mountpoint محلی (دایرکتوری) صادر می کند.
"localmountpoint" نامیده می شود. خواندن و نوشتن معمولی در فایل ها و دایرکتوری های زیر
"localmountpoint" از طریق libguestfs هدایت می شوند.
اگر پرچم اختیاری "readonly" روی true تنظیم شده باشد، خطای بازگشت در فایل سیستم می نویسد.
"EROFS".
"options" فهرستی از گزینه‌های نصب با کاما است. دیدن میهمان میهمان(1) برای برخی مفید
گزینه.
"cachetimeout" زمان وقفه (در چند ثانیه) را برای ورودی های دایرکتوری ذخیره شده تنظیم می کند. پیش فرض است
60 ثانیه دیدن میهمان میهمان(1) برای اطلاعات بیشتر
اگر "debugcalls" روی true تنظیم شود، اطلاعات رفع اشکال اضافی برای آن تولید می شود
هر تماس FUSE
هنگامی که "mount-local" برمی گردد، سیستم فایل آماده است، اما درخواست ها را پردازش نمی کند
(دسترسی به آن مسدود خواهد شد). برای اجرای حلقه اصلی باید "mount-local-run" را فراخوانی کنید.
"MOUNT LOCAL" را در اینجا ببینید مهمانان(3) برای مستندات کامل.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
mount-local-run
mount-local-run
حلقه اصلی را اجرا کنید که فراخوانی هسته را به تماس های libguestfs ترجمه می کند.
این فقط باید پس از بازگشت موفقیت آمیز "mount-local" فراخوانی شود. تماس نخواهد بود
تا زمانی که فایل سیستم unmount نشده است برگردید.
توجه داشته باشید: شما باید نه فراخوانی های همزمان libguestfs را روی همان دسته از یک رشته دیگر انجام دهید.
ممکن است این موضوع را از رشته‌ای متفاوت از موضوعی که "mount-local" نامیده میشود، نام ببرید
به قوانین معمول برای رشته ها و libguestfs (به "چند دسته ها و موضوعات چندگانه" مراجعه کنید
in مهمانان(3).
"MOUNT LOCAL" را در اینجا ببینید مهمانان(3) برای مستندات کامل.
mount-loop
فایل mount-loop mountpoint
این دستور به شما امکان می دهد سوار شوید پرونده (تصویر سیستم فایل در یک فایل) در نقطه نصب. این است
کاملاً معادل دستور "mount -o loop file mountpoint" است.
گزینه های نصب
گزینه های mount-Options mountpoint mountpoint
این همان فرمان "mount" است، اما به شما امکان می دهد گزینه های mount را به عنوان برای تنظیم کنید
la استقرار (mount)(8) -o پرچم.
اگر پارامتر "options" یک رشته خالی باشد، هیچ گزینه ای ارسال نمی شود (همه گزینه ها
به طور پیش فرض به هر آنچه که سیستم فایل استفاده می کند).
mount-ro
mount-ro mountpoint mountpoint
این همان فرمان "mount" است، اما سیستم فایل را با دستور فقط خواندنی مونت می کند
(-o ro) پرچم.
mount-vfs
گزینه های mount-vfs vfstyle mountpoint mountpoint
این همان فرمان "mount" است، اما به شما امکان می دهد هر دو گزینه mount را تنظیم کنید
و vfstyle برای the استقرار (mount)(8) -o و -t پرچم ها
نقاط کوهستانی
نقاط کوهستانی
این فراخوانی شبیه "mounts" است. آن تماس فهرستی از دستگاه ها را برمی گرداند. این یکی برمیگرده
یک جدول هش (نقشه) از نام دستگاه به فهرستی که دستگاه در آن نصب شده است.
پایه
پایه
این لیست فایل سیستم های نصب شده را برمی گرداند. لیست دستگاه ها را برمی گرداند
(به عنوان مثال. / dev / sda1, /dev/VG/LV).
برخی از پایه های داخلی نشان داده نشده اند.
همچنین ببینید: "نقاط کوه"
mv
mv src dest
این یک فایل را از "src" به "dest" منتقل می کند که در آن "dest" یا نام فایل مقصد است یا
فهرست مقصد
همچنین ببینید: "تغییر نام".
دستگاه های nr
دستگاه های nr
این تعداد کل دستگاه های بلوک اضافه شده را برمی گرداند. این همان است
تعداد دستگاه هایی که در صورت فراخوانی «list-devices» برگردانده می شوند.
برای اطلاع از حداکثر تعداد دستگاه هایی که می توان اضافه کرد، با "max-disks" تماس بگیرید.
پروب ntfs-3g
دستگاه ntfs-3g-probe true|false
این دستور را اجرا می کند ntfs-3g.probe(8) دستوری که یک "دستگاه" NTFS را برای آن بررسی می کند
قابلیت نصب (همه جلدهای NTFS را نمی توان برای خواندن و نوشتن نصب کرد و برخی را نمی توان نصب کرد
اصلاً)
"rw" یک پرچم بولی است. اگر می‌خواهید تست کنید آیا می‌توان صدا را نصب کرد، آن را روی true تنظیم کنید
خواندن و نوشتن اگر می‌خواهید تست کنید آیا می‌توان صدا را فقط خواندنی نصب کرد، آن را روی false تنظیم کنید.
مقدار بازگشتی یک عدد صحیح است که در صورت موفقیت عملیات 0 یا مقداری غیر صفر است
ارزش مستند شده در ntfs-3g.probe(8) صفحه دستی.
ntfsclone-in
دستگاه ntfsclone-in (پشتیبان گیری|-).
"پشتیبان فایل" (از تماس قبلی با "ntfsclone-out") به "دستگاه"،
رونویسی هر محتوای موجود در این دستگاه.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
ntfsclone-out
دستگاه ntfsclone-out (پرونده پشتیبان|-) [فقط فراداده:درست|نادرست] [rescue:true|false] [ignorefscheck:true|false] [reservetimestamps:true|false] [force:true|false]
فایل سیستم NTFS "دستگاه" را به فایل محلی "پشتیبان فایل" پخش کنید. فرمت مورد استفاده برای
فایل پشتیبان فرمت خاصی است که توسط ntfsclone(8) ابزار.
اگر پرچم اختیاری "metadataonly" درست باشد، پس فقط ابرداده ذخیره می شود و همه چیز را از دست می دهد
داده های کاربر (این برای تشخیص برخی از مشکلات سیستم فایل مفید است).
پرچم های اختیاری "rescue"، "ignorefscheck"، "reservetimestamps" و "force" دارای
معانی دقیق به تفصیل در ntfsclone(8) صفحه مرد.
از "ntfsclone-in" برای بازگرداندن فایل به دستگاه libguestfs استفاده کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
ntfsfix
دستگاه ntfsfix [clearbadsectors:true|false]
این دستور برخی از ناسازگاری های اساسی NTFS را تعمیر می کند، فایل ژورنال NTFS را بازنشانی می کند.
و یک بررسی سازگاری NTFS را برای اولین بوت در ویندوز برنامه ریزی می کند.
این هست نه معادل ویندوز "chkdsk". این کار را انجام می دهد نه فایل سیستم را اسکن کنید
ناسازگاری
پرچم اختیاری "clearbadsectors" لیست بدسکتورها را پاک می کند. این بعد مفید است
شبیه سازی یک دیسک با بخش های بد به یک دیسک جدید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
ntfsresize
ntfsresize-opts
دستگاه ntfsresize [size:N] [force:true|false]
این دستور اندازه یک فایل سیستم NTFS را تغییر می دهد و آن را به اندازه ی آن بزرگ یا کوچک می کند
دستگاه زیرین
پارامترهای اختیاری عبارتند از:
"اندازه"
اندازه جدید (بر حسب بایت) فایل سیستم. در صورت حذف، اندازه فایل سیستم به تغییر اندازه می شود
مناسب ظرف (به عنوان مثال پارتیشن).
"زور"
اگر این گزینه درست است، پس اندازه فایل سیستم را مجبور کنید حتی اگر سیستم فایل باشد
به عنوان نیاز به بررسی سازگاری علامت گذاری شده است.
پس از عملیات تغییر اندازه، فایل سیستم همیشه به عنوان نیاز به یکپارچگی علامت گذاری می شود
بررسی (برای ایمنی). برای انجام این بررسی و پاک کردن باید در ویندوز بوت شوید
این شرایط اگر شما نکن گزینه "force" را تنظیم کنید سپس امکان تماس وجود ندارد
"ntfsresize" چندین بار در یک فایل سیستم بدون بوت شدن در ویندوز
بین هر تغییر اندازه
همچنین مشاهده کنید ntfsresize(8).
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
ntfsresize-size
اندازه دستگاه ntfsresize-size
این دستور همان "ntfsresize" است با این تفاوت که به شما امکان می دهد اندازه جدید را مشخص کنید
(در بایت) به طور صریح.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "ntfsresize" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
تجزیه محیط
تجزیه محیط
محیط برنامه را تجزیه کنید و بر اساس آن پرچم ها را در دسته قرار دهید. به عنوان مثال اگر
"LIBGUESTFS_DEBUG=1" سپس پرچم "کلمه" در دسته تنظیم می شود.
پل برنامه ها do نه نیاز به صدا این. وقتی "ایجاد" را صدا می زنید، به طور ضمنی انجام می شود.
"متغیرهای محیط" را در مهمانان(3) برای لیستی از متغیرهای محیطی که می توانند
دسته های libguestfs را تحت تأثیر قرار می دهند. همچنین به "guestfs_create_flags" در مراجعه کنید مهمانان(3) و "تجزیه
لیست محیطی".
تجزیه-محیط-لیست
parse-environment-list "محیط ..."
لیست رشته ها را در آرگومان "محیط" تجزیه کنید و پرچم ها را در دسته قرار دهید
بر این اساس. برای مثال اگر "LIBGUESTFS_DEBUG=1" یک رشته در لیست باشد،
پرچم "پرده" در دسته تنظیم شده است.
این همان "تجزیه محیط" است با این تفاوت که فهرست صریح رشته ها را تجزیه می کند.
به جای محیط برنامه
قسمت اضافه کردن
part-add device prlogex startsect endsect
این دستور یک پارتیشن به "دستگاه" اضافه می کند. اگر جدول پارتیشن روی دستگاه وجود ندارد،
ابتدا با "part-init" تماس بگیرید.
پارامتر "prlogex" نوع پارتیشن است. به طور معمول باید "p" یا را پاس کنید
در اینجا "اصلی"، اما جداول پارتیشن MBR از "l" (یا "منطقی") و "e" (یا" نیز پشتیبانی می کنند.
"extended") انواع پارتیشن.
"startsect" و "endsect" شروع و پایان پارتیشن در هستند بخش. "انتها"
ممکن است منفی باشد، به این معنی که از انتهای دیسک به عقب شمارش میکند ("-1" همان است
بخش آخر).
ایجاد پارتیشنی که کل دیسک را پوشش دهد چندان آسان نیست. برای انجام این کار از "پارت دیسک" استفاده کنید
آن
قسمت دلخواه
پارت دل دستگاه پارتنوم
این دستور پارتیشن با شماره "partnum" در "device" را حذف می کند.
توجه داشته باشید که در مورد پارتیشن بندی MBR، حذف یک پارتیشن توسعه یافته هر کدام را نیز حذف می کند
پارتیشن های منطقی موجود در آن
قسمت دیسک
نوع دستگاه پارت دیسک
این دستور به سادگی ترکیبی از "part-init" و به دنبال آن "part-add" برای ایجاد یک است
پارتیشن اصلی که کل دیسک را پوشش می دهد.
"parttype" نوع جدول پارتیشن است، معمولا "mbr" یا "gpt"، اما مقادیر دیگر ممکن است
در "part-init" توضیح داده شده است.
قابل بوت شدن
دستگاه part-get-bootable partnum
اگر پارتیشن "partnum" در "device" دارای پرچم قابل بوت باشد، این دستور true را برمی گرداند
تنظیم شده است.
همچنین به "part-set-bootable" مراجعه کنید.
part-get-gpt-guid
part-get-gpt-guid دستگاه partnum
GUID پارتیشن GPT شماره دار "partnum" را برگردانید.
part-get-gpt-type
part-get-gpt-type device partnum
نوع GUID پارتیشن GPT شماره دار "partnum" را برگردانید. برای پارتیشن های MBR، عبارت را برگردانید
GUID مناسب مربوط به نوع MBR. رفتار برای پارتیشن های دیگر تعریف نشده است
انواع.
part-get-mbr-id
part-get-mbr-id دستگاه partnum
بایت نوع MBR (همچنین به عنوان بایت ID شناخته می شود) را از پارتیشن شماره گذاری شده برمی گرداند
"partnum".
توجه داشته باشید که فقط پارتیشن های MBR (به سبک DOS قدیمی) دارای بایت نوع هستند. شما نامشخص خواهید شد
نتایج برای سایر انواع جدول پارتیشن (به "part-get-parttype" مراجعه کنید).
part-get-mbr-part-type
part-get-mbr-part-type device partnum
این نوع پارتیشن یک پارتیشن MBR با شماره "partnum" در "دستگاه" دستگاه را برمی گرداند.
"اولیه"، "منطقی" یا "بسط یافته" را برمی گرداند.
نام بخشی
part-get-name دستگاه partnum
این نام پارتیشن را در پارتیشن شماره "partnum" در دستگاه "device" دریافت می کند. توجه داشته باشید
که پارتیشن ها از 1 شماره گذاری می شوند.
نام پارتیشن فقط در انواع خاصی از جدول پارتیشن قابل خواندن است. این کار می کند
"gpt" اما نه در پارتیشن های "mbr".
part-get-parttype
دستگاه part-get-parttype
این دستور جدول پارتیشن را در "دستگاه" بررسی می کند و نوع جدول پارتیشن را برمی گرداند
(فرمت) در حال استفاده
مقادیر رایج بازگشتی عبارتند از: "msdos" (جدول پارتیشن MBR سبک DOS/Windows)، "gpt" (a
جدول پارتیشن به سبک GPT/EFI). مقادیر دیگری نیز ممکن است، اگرچه غیرعادی است. رجوع به "قسمت -
init" برای یک لیست کامل.
part-init
نوع دستگاه part-init
این یک جدول پارتیشن خالی در "دستگاه" یکی از انواع پارتیشن های فهرست شده ایجاد می کند
زیر معمولاً «parttype» باید «msdos» یا «gpt» باشد (برای دیسک‌های بزرگ).
در ابتدا هیچ پارتیشنی وجود ندارد. پس از این، شما باید برای هر کدام "part-add" را فراخوانی کنید
پارتیشن مورد نیاز
مقادیر ممکن برای "parttype" عبارتند از:
EFI
gpt جدول پارتیشن اینتل EFI / GPT.
این برای پارتیشن های >= 2 ترابایتی که از لینوکس و اینتل قابل دسترسی هستند توصیه می شود.
مبتنی بر Mac OS X. همچنین سازگاری محدودی با فرمت "mbr" دارد.
mbr
msdos
فرمت استاندارد رایانه شخصی "Master Boot Record" (MBR) که توسط MS-DOS و Windows استفاده می شود. این
نوع پارتیشن خواهد شد فقط برای اندازه دستگاه تا 2 ترابایت کار می کند. برای دیسک های بزرگ ما
توصیه می شود از "gpt" استفاده کنید.
سایر انواع جدول پارتیشن که ممکن است کار کنند اما پشتیبانی نمی شوند عبارتند از:
فیکس برچسب های دیسک AIX.
آمیگا
Rdb فرمت آمیگا "Rigid Disk Block".
bsd برچسب های دیسک BSD
داسد
DASD، مورد استفاده در پردازنده های مرکزی IBM.
dvh حجم های MIPS/SGI.
مک فرمت پارتیشن مک قدیمی مک های مدرن از "gpt" استفاده می کنند.
pc98
فرمت NEC PC-98، ظاهراً رایج در ژاپن.
آفتاب برچسب های دیسک خورشید.
قسمت لیست
دستگاه جزء لیست
این دستور جدول پارتیشن را در "دستگاه" تجزیه می کند و لیست پارتیشن ها را برمی گرداند
پیدا شده است.
فیلدهای ساختار برگشتی عبارتند از:
part_num
شماره پارتیشن، شمارش از 1.
part_start
شروع پارتیشن in بایت. برای به دست آوردن بخش ها باید بر بخش دستگاه تقسیم کنید
اندازه بخش، به "blockdev-getss" مراجعه کنید.
part_end
پایان پارتیشن بر حسب بایت
part_size
اندازه پارتیشن بر حسب بایت
قابل بوت شدن
دستگاه part-set-bootable partnum true|false
این پرچم قابل بوت را روی پارتیشن با شماره "partnum" در دستگاه "device" تنظیم می کند. توجه داشته باشید که
پارتیشن ها از 1 شماره گذاری می شوند.
پرچم قابل بوت توسط برخی از سیستم عامل ها (به ویژه ویندوز) برای تعیین اینکه کدام مورد استفاده می شود
پارتیشن برای بوت کردن به هیچ وجه به رسمیت شناخته شده جهانی نیست.
part-set-gpt-guid
part-set-gpt-guid دستگاه راهنمای partnum
GUID پارتیشن GPT شماره دار "partnum" را روی "guid" تنظیم کنید. اگر خطا را برگردانید
جدول پارتیشن "دستگاه" GPT نیست، یا اگر "راهنما" یک GUID معتبر نیست.
part-set-gpt-type
راهنمای part-set-gpt-type device partnum
نوع GUID پارتیشن GPT شماره دار "partnum" را روی "guid" تنظیم کنید. اگر خطا را برگردانید
جدول پارتیشن "دستگاه" GPT نیست، یا اگر "راهنما" یک GUID معتبر نیست.
دیدن http://en.wikipedia.org/wiki/GUID_Partition_Table#پارتیشن_نوع_GUID برای مفید
لیست نوع GUID
part-set-mbr-id
part-set-mbr-id دستگاه partnum idbyte
بایت نوع MBR (همچنین به عنوان بایت ID نیز شناخته می شود) پارتیشن شماره گذاری شده "partnum" را روی
"idbyte". توجه داشته باشید که نوع بایت های نقل شده در اکثر اسناد در واقع هگزادسیمال هستند
اعداد، اما معمولاً بدون هیچ "0x" ابتدایی مستند می شوند که ممکن است گیج کننده باشد.
توجه داشته باشید که فقط پارتیشن های MBR (به سبک DOS قدیمی) دارای بایت نوع هستند. شما نامشخص خواهید شد
نتایج برای سایر انواع جدول پارتیشن (به "part-get-parttype" مراجعه کنید).
نام مجموعه ای
نام دستگاه پارتنوم
این نام پارتیشن را روی پارتیشن شماره "partnum" در دستگاه "device" تنظیم می کند. توجه داشته باشید
که پارتیشن ها از 1 شماره گذاری می شوند.
نام پارتیشن را فقط می توان در انواع خاصی از جدول پارتیشن تنظیم کرد. این کار می کند
"gpt" اما نه در پارتیشن های "mbr".
part-to-dev
پارتیشن part-to-dev
این تابع یک نام پارتیشن می گیرد (به عنوان مثال "/dev/sdb1") و شماره پارتیشن را حذف می کند.
بازگرداندن نام دستگاه (به عنوان مثال "/dev/sdb").
پارتیشن نامگذاری شده باید وجود داشته باشد، برای مثال به عنوان یک رشته برگردانده شده از "list-partitions".
همچنین به "part-to-partnum"، "device-index" مراجعه کنید.
قسمت به پارتنر
پارتیشن پارت به پارتناوم
این تابع یک نام پارتیشن (به عنوان مثال "/dev/sdb1") می گیرد و شماره پارتیشن را برمی گرداند
(مثلا 1).
پارتیشن نامگذاری شده باید وجود داشته باشد، برای مثال به عنوان یک رشته برگردانده شده از "list-partitions".
همچنین به "part-to-dev" مراجعه کنید.
پینگ دیمون
پینگ دیمون
این یک کاوشگر آزمایشی برای دیمون guestfs است که در داخل دستگاه libguestfs اجرا می شود.
با فراخوانی این تابع بررسی می شود که دیمون به پیام پینگ پاسخ می دهد، بدون آن
به هر طریق دیگری بر دیمون یا دستگاه(های) بلوک متصل شده تأثیر می گذارد.
تبلیغ کردن
تعدیل تعداد مسیر پیشخوان
این دستور به شما امکان می دهد بخشی از یک فایل را بخوانید. "شمارش" بایت های فایل را می خواند و شروع می کند
در "offset"، از فایل "path".
ممکن است این بایت کمتر از درخواستی خوانده شود. برای جزئیات بیشتر مراجعه کنید تبلیغ کردن(2) سیستم
زنگ زدن.
همچنین به "pwrite"، "pread-device" مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
دستگاه پیش آماده
تعدیل تعداد دستگاه های پیش آماده
این دستور به شما امکان می دهد بخشی از یک دستگاه بلوک را بخوانید. "شمارش" بایت های "دستگاه" را می خواند،
از "افست" شروع می شود.
ممکن است این بایت کمتر از درخواستی خوانده شود. برای جزئیات بیشتر مراجعه کنید تبلیغ کردن(2) سیستم
زنگ زدن.
همچنین به «پاداش» مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
pvchange-uuid
دستگاه pvchange-uuid
یک UUID تصادفی جدید برای "دستگاه" حجم فیزیکی ایجاد کنید.
pvchange-uuid-all
pvchange-uuid-all
UUID های تصادفی جدید برای تمام حجم های فیزیکی ایجاد کنید.
pvcreate
دستگاه pvcreate
این یک حجم فیزیکی LVM در "دستگاه" نامگذاری شده ایجاد می کند، جایی که "دستگاه" معمولاً باید در آنجا باشد
یک نام پارتیشن مانند / dev / sda1.
pvremove
دستگاه pvremove
این یک "دستگاه" حجم فیزیکی را پاک می کند تا LVM دیگر آن را تشخیص ندهد.
پیاده سازی از دستور "pvremove" استفاده می کند که از پاک کردن حجم های فیزیکی آن امتناع می کند
شامل هر گروه حجمی باشد، بنابراین ابتدا باید آن ها را حذف کنید.
pvresize
دستگاه pvresize
این یک حجم فیزیکی LVM موجود را تغییر اندازه می دهد (بسط یا کوچک می کند) تا با اندازه جدید مطابقت داشته باشد
دستگاه زیرین
pvresize-size
اندازه دستگاه pvresize-size
این دستور همان "pvresize" است با این تفاوت که به شما امکان می دهد اندازه جدید را مشخص کنید
(در بایت) به طور صریح.
pvs
pvs
تمام حجم های فیزیکی شناسایی شده را فهرست کنید. این معادل است pvs(8) فرمان.
این فهرستی از نام‌های دستگاه را که حاوی PV هستند (مثلاً / dev / sda2).
همچنین به "pvs-full" مراجعه کنید.
pvs-full
pvs-full
تمام حجم های فیزیکی شناسایی شده را فهرست کنید. این معادل است pvs(8) فرمان.
نسخه "کامل" شامل تمام فیلدها می شود.
pvuuid
دستگاه pvuuid
این دستور UUID دستگاه LVM PV را برمی گرداند.
نوشتن
آفست محتوای مسیر pwrite
این دستور در بخشی از یک فایل می نویسد. "محتوای" بافر داده را در فایل می نویسد
"مسیر" با آفست "offset" شروع می شود.
این فرمان را پیاده سازی می کند نوشتن(2) تماس سیستمی، و مانند آن تماس سیستم ممکن است نباشد
اطلاعات کامل درخواست شده را بنویسید مقدار بازگشتی تعداد بایت هایی است که در واقع وجود داشته است
روی فایل نوشته شده است. این حتی می تواند 0 باشد، اگرچه نوشتن کوتاه برای معمولی بعید است
فایل ها در شرایط عادی
همچنین به "pread"، "pwrite-device" مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
دستگاه pwrite
آفست محتوای دستگاه pwrite-device
این دستور در قسمتی از یک دستگاه می نویسد. "محتوای" بافر داده را روی "دستگاه" می نویسد.
با آفست "offset" شروع می شود.
این فرمان را پیاده سازی می کند نوشتن(2) تماس سیستمی، و مانند آن تماس سیستم ممکن است نباشد
اطلاعات کامل درخواست شده را بنویسید (اگرچه نوشته های کوتاه در دستگاه ها و پارتیشن های دیسک هستند
احتمالاً با هسته های استاندارد لینوکس غیرممکن است).
همچنین به "pwrite" مراجعه کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
فایل خواندنی
مسیر فایل خواندن
این فراخوانی محتویات فایل "path" را به عنوان بافر برمی گرداند.
برخلاف «cat»، این تابع می‌تواند فایل‌هایی را که حاوی ASCII NUL تعبیه‌شده هستند، به درستی مدیریت کند
کاراکتر باشد.
خواندن خطوط
مسیر خطوط خواندن
محتویات فایلی با نام مسیر را برگردانید.
محتویات فایل به صورت لیستی از خطوط برگردانده می شود. بعد از شخصیت "LF" و "CRLF".
دنباله ها هستند نه برگشت
توجه داشته باشید که این تابع نمی تواند فایل های باینری (مخصوصاً فایل ها) را به درستی مدیریت کند
حاوی کاراکتر "\0" که به عنوان انتهای رشته در نظر گرفته می شود). برای کسانی که باید استفاده کنید
تابع "خواندن فایل" و بافر را خودتان به خطوط تقسیم کنید.
readdir
readdir کارگردان
این لیستی از ورودی های دایرکتوری را در فهرست "dir" برمی گرداند.
همه ورودی‌های فهرست شامل "." و "..". ورودی ها هستند نه
مرتب شد، اما به همان ترتیبی که سیستم فایل زیرین بود برگردانده شد.
همچنین این فراخوانی اطلاعات اولیه نوع فایل مربوط به هر فایل را برمی گرداند. فیلد "ftyp" خواهد بود
حاوی یکی از کاراکترهای زیر باشد:
بلاک ویژه
'c' Char ویژه
دایرکتوری 'd'
'f' FIFO (لوله نامگذاری شده)
پیوند نمادین 'l'
'r' فایل معمولی
سوکت 's'
'u' نوع فایل ناشناخته
"؟" در readdir(3) فراخوانی فیلد "d_type" با مقدار غیرمنتظره را برگرداند
این تابع در درجه اول برای استفاده توسط برنامه ها در نظر گرفته شده است. برای دریافت یک لیست ساده از اسامی،
از "ls" استفاده کنید. برای دریافت دایرکتوری قابل چاپ برای مصرف انسان، از "ll" استفاده کنید.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
پیوند خواندن
مسیر خواندن لینک
این دستور هدف یک پیوند نمادین را می خواند.
لیست پیوند خواندن
مسیر readlinklist 'names ...'
این فراخوانی به شما امکان می دهد تا یک عملیات "readlink" را روی چندین فایل انجام دهید، جایی که همه فایل ها در آن قرار دارند
در دایرکتوری "path". "names" لیستی از فایل های این فهرست است.
پس از بازگشت، فهرستی از رشته‌ها را دریافت می‌کنید که با فهرست «نامها» مطابقت دارد.
هر رشته مقدار پیوند نمادین است.
اگر پیوند خواندن(2) عملیات در هر نامی با شکست مواجه می شود، سپس رشته نتیجه مربوطه است
رشته خالی "". با این حال کل عملیات تکمیل می شود حتی اگر وجود داشته باشد
پیوند خواندن(2) خطاها، و بنابراین می‌توانید این تابع را با نام‌هایی که نمی‌دانید فراخوانی کنید
آنها در حال حاضر پیوندهای نمادین هستند (البته کمی کارآمدتر).
این فراخوان برای برنامه‌هایی در نظر گرفته شده است که می‌خواهند محتویات دایرکتوری را به طور مؤثر فهرست کنند
بدون رفت و برگشت زیاد
مسیر واقعی
مسیر realpath
نام مسیر مطلق متعارف "مسیر" را برگردانید. مسیر برگشتی "."، ".." ندارد.
یا عناصر مسیر پیوند نمادین.
دوباره سوار کردن
نصب مجدد نقطه کوه [rw:true|false]
این تماس به شما امکان می دهد پرچم "rw" (فقط خواندن/خواندن-نوشتن) را در یک دستگاه از قبل نصب شده تغییر دهید.
فایل سیستم در "نقطه کوه"، تبدیل یک فایل سیستم فقط خواندنی به خواندن-نوشتن یا معاون
برعکس
توجه داشته باشید که در حال حاضر باید پارامتر "اختیاری" "rw" را تامین کنید. در آینده ممکن است
اجازه دهید پرچم های دیگر تنظیم شوند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
حذف-درایو
برچسب حذف درایو
این تابع از نظر مفهومی مخالف "add-drive-opts" است. درایوی که
قبلا با برچسب "برچسب" اضافه شده بود.
توجه داشته باشید که برای حذف درایوها، باید آنها را با برچسب اضافه کنید (به قسمت اختیاری مراجعه کنید
آرگومان "label" به "add-drive-opts"). اگر از یک برچسب استفاده نکرده اید، آنها نمی توانند باشند
حذف شده.
می توانید این عملکرد را قبل یا بعد از راه اندازی دستگیره فراخوانی کنید. اگر پس از راه اندازی فراخوانی شد،
اگر پشتیبان آن را پشتیبانی می کند، سعی می کنیم درایو را از برق جدا کنیم: "HOTPLUGGING" را در
مهمانان(3). دیسک باید نه هنگامی که این کار را انجام می دهید در حال استفاده (به عنوان مثال نصب شده) باشد. ما سعی می کنیم تشخیص دهیم
اگر دیسک در حال استفاده است و شما را از انجام این کار باز می دارد.
removexattr
مسیر removexattr xattr
این فراخوانی ویژگی توسعه یافته به نام "xattr" از فایل "path" را حذف می کند.
همچنین ببینید: "lremovexattr"، جذب کنند(5).
تغییر نام دهید
تغییر نام oldpath newpath
یک فایل را به یک مکان جدید در همان فایل سیستم تغییر نام دهید. این همان لینوکس است
تغییر نام دهید(2) تماس سیستمی. در بیشتر موارد بهتر است به جای آن از "mv" استفاده کنید.
resize2fs
دستگاه resize2fs
این اندازه یک سیستم فایل ext2، ext3 یا ext4 را برای مطابقت با اندازه دستگاه زیرین تغییر می‌دهد.
همچنین به "خطاهای RESIZE2FS" در اینجا مراجعه کنید مهمانان(3).
resize2fs-M
دستگاه resize2fs-M
این دستور همان "resize2fs" است، اما اندازه فایل سیستم به حداقل می رسد
اندازه. این کار مانند -M گزینه ای برای دستور "resize2fs".
برای بدست آوردن اندازه فایل سیستم باید "tune2fs-l" را فراخوانی کرده و آن را بخوانید
مقادیر «اندازه بلوک» و «تعداد بلوک». این دو عدد که با هم ضرب می شوند، عدد را به دست می دهند
اندازه حداقل فایل سیستم در بایت.
همچنین به "خطاهای RESIZE2FS" در اینجا مراجعه کنید مهمانان(3).
resize2fs-size
اندازه دستگاه resize2fs-size
این دستور همان "resize2fs" است با این تفاوت که به شما امکان می دهد اندازه جدید را مشخص کنید
(در بایت) به طور صریح.
همچنین به "خطاهای RESIZE2FS" در اینجا مراجعه کنید مهمانان(3).
rm
مسیر rm
تنها فایل "path" را حذف کنید.
rm-f
مسیر rm-f
فایل "path" را حذف کنید.
اگر فایل وجود نداشته باشد، آن خطا نادیده گرفته می شود. (سایر خطاها، به عنوان مثال، خطاهای ورودی/خروجی یا بد
مسیرها نادیده گرفته نمی شوند)
این تماس نمی تواند دایرکتوری ها را حذف کند. از "rmdir" برای حذف یک پوشه خالی یا "rm-rf" استفاده کنید.
برای حذف دایرکتوری ها به صورت بازگشتی
rm-rf
مسیر rm-rf
فایل یا دایرکتوری "مسیر" را حذف کنید، اگر یک دایرکتوری است، محتویات را به صورت بازگشتی حذف کنید.
این مانند دستور پوسته "rm -rf" است.
rm است
مسیر rmdir
دایرکتوری واحد "path" را حذف کنید.
rmmountpoint
rmmountpoint exemptpath
این فراخوانی نقطه‌ای را که قبلاً با "mkmountpoint" ایجاد شده بود، حذف میکند. دیدن
"mkmountpoint" برای جزئیات کامل.
rsync
rsync src dest [بایگانی:true|false] [deletedest:true|false]
این فراخوانی ممکن است برای کپی یا همگام سازی دو دایرکتوری تحت یک libguestfs استفاده شود
رسیدگی. این استفاده می کند rsync(1) برنامه ای که از یک الگوریتم سریع استفاده می کند که از کپی کردن جلوگیری می کند
فایل های غیر ضروری
"src" و "dest" دایرکتوری های مبدا و مقصد هستند. فایل ها از "src" کپی می شوند
به "دسترس".
آرگومان های اختیاری عبارتند از:
"بایگانی"
حالت بایگانی را روشن می کند. این همان عبور از --بایگانی پرچم به "rsync".
"حذف ترین"
فایل هایی را در مقصد که در منبع وجود ندارند حذف کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
rsync-in
rsync-in remote dest [بایگانی:true|false] [deletedest:true|false]
این تماس ممکن است برای کپی یا همگام سازی سیستم فایل در هاست یا روی یک کنترل از راه دور استفاده شود
کامپیوتر با سیستم فایل در libguestfs. این استفاده می کند rsync(1) برنامه ای که استفاده می کند
یک الگوریتم سریع که از کپی بی مورد فایل ها جلوگیری می کند.
این تماس فقط در صورتی کار می کند که شبکه فعال باشد. به "set-network" یا --شبکه انتخاب
به ابزارهای مختلف مانند ماهی مهمان(1).
فایل ها از سرور راه دور و دایرکتوری مشخص شده توسط "remote" در کپی می شوند
فهرست مقصد "dest".
قالب رشته سرور راه دور توسط تعریف می شود rsync(1). توجه داشته باشید که هیچ راهی وجود ندارد
برای ارائه یک رمز عبور یا عبارت عبور، بنابراین هدف باید طوری تنظیم شود که به آن نیاز نداشته باشد.
آرگومان های اختیاری همان آرگومان های "rsync" هستند.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
rsync-out
rsync-out src remote [بایگانی:true|false] [deletedest:true|false]
این فراخوانی ممکن است برای کپی یا همگام سازی فایل سیستم در libguestfs با a استفاده شود
سیستم فایل روی هاست یا روی یک کامپیوتر راه دور. این استفاده می کند rsync(1) برنامه ای که استفاده می کند
یک الگوریتم سریع که از کپی بی مورد فایل ها جلوگیری می کند.
این تماس فقط در صورتی کار می کند که شبکه فعال باشد. به "set-network" یا --شبکه انتخاب
به ابزارهای مختلف مانند ماهی مهمان(1).
فایل ها از دایرکتوری منبع "src" به سرور و دایرکتوری راه دور کپی می شوند
مشخص شده توسط "راه دور".
قالب رشته سرور راه دور توسط تعریف می شود rsync(1). توجه داشته باشید که هیچ راهی وجود ندارد
برای ارائه یک رمز عبور یا عبارت عبور، بنابراین هدف باید طوری تنظیم شود که به آن نیاز نداشته باشد.
آرگومان های اختیاری همان آرگومان های "rsync" هستند.
Globbing روی پارامتر "src" اتفاق نمی افتد. در برنامه هایی که مستقیماً از API استفاده می کنند
شما باید خود حروف عام را گسترش دهید (به "گسترش جهانی" مراجعه کنید). در ماهی مهمان می توانید از
دستور "glob" (به "glob" مراجعه کنید)، برای مثال:
> گلوب rsync-out /* rsync://remote/
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
دستگاه اسکراب
دستگاه اسکراب
این دستور الگوها را روی "دستگاه" می نویسد تا بازیابی داده ها را دشوارتر کند.
این یک رابط به است اسکراب(1) برنامه برای جزئیات بیشتر به آن صفحه راهنما مراجعه کنید.
فایل اسکراب
فایل اسکراب
این دستور الگوها را روی یک فایل می نویسد تا بازیابی اطلاعات را دشوارتر کند.
فایل است حذف پس از شستشو
این یک رابط به است اسکراب(1) برنامه برای جزئیات بیشتر به آن صفحه راهنما مراجعه کنید.
فضای بدون اسکراب
اسکراب فضای آزاد کارگردان
این دستور دایرکتوری "dir" را ایجاد می کند و سپس آن را با فایل ها تا سیستم فایل پر می کند
پر است و فایل‌ها را مانند «scrub-file» پاک میکند و آنها را حذف میکند. قصد این است که
هر فضای خالی روی پارتیشن حاوی "dir" را تمیز کنید.
این یک رابط به است اسکراب(1) برنامه برای جزئیات بیشتر به آن صفحه راهنما مراجعه کنید.
ضمیمه کردن
ضمیمه کردن
تنظیم ضمیمه
این تابع برای افزودن گزینه های اضافی به دستور هسته دستگاه libguestfs استفاده می شود
خط.
پیش‌فرض «NULL» است مگر اینکه با تنظیم محیط «LIBGUESTFS_APPEND» لغو شود
متغیر.
تنظیم "پیوست" به "NULL" به معنای نه گزینه های اضافی ارسال می شود (libguestfs همیشه اضافه می کند
چند تا از خودش).
مجموعه-پیوست-روش
ضمیمه-روش
باطن متد set-attach
روشی را تنظیم کنید که libguestfs برای اتصال به دیمون باطن guestfsd استفاده می کند.
"بازگشت" را در مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "set-backend" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
تنظیم خودکار
همگام سازی خودکار
set-autosync true|false
اگر «همگام‌سازی خودکار» درست باشد، همگام‌سازی خودکار را فعال میکند. Libguestfs بهترین تلاش را خواهد کرد
برای منسجم و هماهنگ کردن فایل سیستم ها در هنگام بسته شدن دسته (همچنین اگر
برنامه بدون بستن دستگیره ها خارج می شود).
این به طور پیش فرض فعال است (از libguestfs 1.5.24، قبلاً توسط غیرفعال شده بود
پیش فرض)
مجموعه پشتیبان
باطن
مجموعه پشتیبان
روشی را تنظیم کنید که libguestfs برای اتصال به دیمون باطن guestfsd استفاده می کند.
این ویژگی handle قبلا "متد پیوست" نامیده می شد.
"بازگشت" را در مهمانان(3).
set-backend-setting
set-backend-setting نام val
"name=value" را به لیست رشته تنظیمات باطن اضافه کنید. با این حال اگر یک رشته در حال حاضر
مطابق با "name" یا شروع با "name=" وجود دارد، سپس آن تنظیم جایگزین می شود.
"بازگشت" را در مهمانان(3)، "تنظیمات پشتیبان" در مهمانان(3).
set-backend-settings
set-backend-settings 'تنظیمات ...'
فهرستی از تنظیمات صفر یا بیشتر را تنظیم کنید که به باطن فعلی منتقل می شوند. هر یک
setting رشته‌ای است که به روشی خاص تفسیر میشود، یا در غیر این صورت نادیده گرفته میشود
توسط باطن قابل درک است.
مقدار پیش فرض یک لیست خالی است، مگر اینکه متغیر محیطی باشد
"LIBGUESTFS_BACKEND_SETTINGS" هنگام ایجاد دسته تنظیم شد. این محیط
متغیر شامل لیستی از تنظیمات جدا شده با کولون است.
این تماس جایگزین تمام تنظیمات Backend می شود. اگر می خواهید یک تنظیمات باطن را جایگزین کنید،
به "set-backend-setting" مراجعه کنید. اگر می‌خواهید یک تنظیم پشتیبان را پاک کنید، به «clear-
تنظیم باطن".
"بازگشت" را در مهمانان(3)، "تنظیمات پشتیبان" در مهمانان(3).
تنظیم حافظه پنهان
حافظه پنهان
set-cachedir cachedir
هنگام استفاده از سوپرمین، دایرکتوری مورد استفاده توسط دسته را برای ذخیره کش دستگاه تنظیم کنید
دستگاه دستگاه در حافظه پنهان ذخیره می شود و بین همه دسته هایی که دارای یک دسته هستند به اشتراک گذاشته می شود
شناسه کاربری موثر
متغیرهای محیطی "LIBGUESTFS_CACHEDIR" و "TMPDIR" مقدار پیش فرض را کنترل می کنند: اگر
"LIBGUESTFS_CACHEDIR" تنظیم شده است، سپس این پیش فرض است. در غیر این صورت اگر "TMPDIR" تنظیم شده باشد، پس
که پیش فرض است. دیگر / var / tmp پیش فرض است.
تنظیم مستقیم
مستقیم
تنظیم مستقیم درست|نادرست
اگر پرچم حالت مستقیم دستگاه فعال باشد، stdin و stdout مستقیماً ارسال می شوند
پس از راه‌اندازی به دستگاه می‌رسد.
یکی از پیامدهای این امر این است که پیام های گزارش توسط کتابخانه گرفته نمی شود و توسط آن مدیریت نمی شود
"set-log-message-callback"، اما مستقیماً به stdout بروید.
احتمالاً نمی خواهید از این استفاده کنید مگر اینکه بدانید چه کاری انجام می دهید.
پیش فرض غیرفعال است.
set-e2attrs
فایل set-e2attrs attrs [clear:true|false]
این ویژگی های فایل "attrs" مرتبط با inode را تنظیم یا پاک می کند پرونده.
"attrs" رشته ای از کاراکترها است که ویژگی های فایل را نشان می دهد. به "get-e2attrs" مراجعه کنید
لیستی از ویژگی های ممکن همه صفات را نمی توان تغییر داد.
اگر بولی اختیاری "clear" وجود نداشته باشد یا نادرست باشد، "attrs" فهرست شده در
ایند
اگر "clear" درست باشد، "attrs" فهرست شده در inode پاک می شوند.
در هر دو مورد، سایر ویژگی‌هایی که در رشته «attrs» وجود ندارند، بدون تغییر باقی می‌مانند.
این ویژگی ها تنها زمانی وجود دارند که فایل در یک سیستم فایل ext2/3/4 قرار گرفته باشد.
استفاده از این فراخوانی در سایر انواع سیستم فایل منجر به خطا می شود.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
set-e2generation
تولید فایل set-e2generation
این کار تولید فایل ext2 یک فایل را تنظیم می کند.
به "get-e2generation" مراجعه کنید.
set-e2label
برچسب دستگاه set-e2label
با این کار برچسب سیستم فایل ext2/3/4 فایل سیستم روی "دستگاه" روی "برچسب" تنظیم می شود.
برچسب های سیستم فایل به 16 کاراکتر محدود می شوند.
می توانید از "tune2fs-l" یا "get-e2label" برای برگرداندن برچسب موجود در یک استفاده کنید.
فایل سیستم
این تابع is منسوخ. در کد جدید، به جای آن از تماس "set-label" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
set-e2uuid
set-e2uuid دستگاه uuid
این UUID سیستم فایل ext2/3/4 سیستم فایل روی "دستگاه" را روی "uuid" تنظیم می کند. در
فرمت UUID و جایگزین هایی مانند "روشن"، "تصادفی" و "زمان" در توضیح داده شده است
la tune2fs(8) manpage.
می توانید از "vfs-uuid" برای برگرداندن UUID موجود یک سیستم فایل استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "set-uuid" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
set-hv
hv
set-hv hv
Hypervisor باینری را که استفاده خواهیم کرد تنظیم کنید. هایپروایزر به باطن بستگی دارد، اما هست
معمولاً محل هایپروایزر qemu/KVM. برای backend uml، آن مکان است
از باینری "linux" یا "vmlinux".
پیش فرض زمانی انتخاب می شود که کتابخانه توسط اسکریپت پیکربندی کامپایل شده باشد.
همچنین می توانید با تنظیم متغیر محیطی "LIBGUESTFS_HV" این مورد را لغو کنید.
توجه داشته باشید که باید این تابع را در اسرع وقت پس از ایجاد دسته فراخوانی کنید.
این به این دلیل است که برخی از عملیات های قبل از راه اندازی به آزمایش ویژگی های qemu (با اجرای
"qemu - help"). اگر باینری qemu تغییر کند، ویژگی‌ها را دوباره آزمایش نمی‌کنیم، و بنابراین ممکن است ببینید
نتایج متناقض استفاده از متغیر محیطی "LIBGUESTFS_HV" از همه امن تر است
از آنجایی که همزمان با ایجاد دسته، باینری qemu را انتخاب می کند.
مجموعه شناسه
شناسه
شناسه مجموعه-شناسه
این یک رشته اطلاعاتی است که تماس گیرنده ممکن است به صورت اختیاری در دسته تنظیم کند. این است
در مکان‌های مختلف چاپ میشود، که امکان شناسایی دسته فعلی در اشکال‌زدایی را فراهم میکند
خروجی.
یک مکان مهم زمانی است که ردیابی فعال است. اگر رشته شناسه خالی نباشد
رشته، سپس ردیابی پیام ها از این تغییر می کند:
libguestfs: trace: get_tmpdir
libguestfs: trace: get_tmpdir = "دایرکتوری / tmp"
به این:
libguestfs: trace: ID: get_tmpdir
libguestfs: trace: ID: get_tmpdir = "دایرکتوری / tmp"
که در آن "ID" رشته شناسه تنظیم شده توسط این تماس است.
شناسه باید فقط شامل نویسه های الفبایی ASCII، زیرخط و علامت منفی باشد.
پیش فرض رشته خالی است.
همچنین به "set-program"، "set-trace"، "get-identifier" مراجعه کنید.
مجموعه برچسب
برچسب قابل نصب set-label
برچسب سیستم فایل را روی "mountable" روی "label" تنظیم کنید.
فقط برخی از انواع سیستم فایل از برچسب ها پشتیبانی می کنند و libguestfs فقط از تنظیم برچسب ها پشتیبانی می کند
زیر مجموعه ای از اینها
ext2 ، ext3 ، ext4
برچسب ها به 16 بایت محدود می شوند.
NTFS
برچسب ها به 128 کاراکتر یونیکد محدود می شوند.
XFS برچسب به 12 بایت محدود شده است. هنگام تلاش برای نصب فایل سیستم نباید نصب شود
برچسب را تنظیم کنید
btrfs
این برچسب به 255 بایت محدود شده است و برخی از کاراکترها مجاز نیستند. تنظیم کردن
برچسب در یک زیرجلد btrfs برچسب را روی سیستم فایل اصلی خود تنظیم می کند. را
هنگام تلاش برای تنظیم برچسب، سیستم فایل نباید نصب شود.
چربی برچسب به 11 بایت محدود شده است.
اگر هیچ پشتیبانی برای تغییر برچسب برای نوع فایل سیستم مشخص شده وجود ندارد،
set_label با شکست مواجه می شود و errno را به عنوان ENOTSUP تنظیم می کند.
برای خواندن برچسب در یک فایل سیستم، "vfs-label" را صدا کنید.
set-libvirt-requested-credential
set-libvirt-requested-credential index cred
پس از درخواست اعتبار "index"'th از کاربر، این تابع را برای ارسال آن فراخوانی کنید
پاسخ به libvirt
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
set-libvirt-supported-credentials
set-libvirt-supported-credentials 'creds ...'
قبل از تنظیم یک کنترل کننده رویداد برای "GUESTFS_EVENT_LIBVIRT_AUTH"، این تابع را فراخوانی کنید.
فهرستی از انواع اعتبارنامه‌هایی را که برنامه می‌داند چگونه پردازش کند، ارائه کنید.
لیست "اعتبارات" باید یک لیست غیر خالی از رشته ها باشد. رشته های احتمالی عبارتند از:
"نام کاربری"
"نام رسمی"
"زبان"
"cnonce"
"عبارت عبور"
"echoprompt"
"noechoprompt"
"قلمرو"
"خارجی"
برای معنی این انواع اعتبارنامه به مستندات libvirt مراجعه کنید.
به "احراز هویت LIBVIRT" در اینجا مراجعه کنید مهمانان(3) برای اسناد و کد نمونه.
set-memsize
مزاحم کردن
set-memsize memsize
این اندازه حافظه را بر حسب مگابایت تخصیص داده شده به هایپروایزر تنظیم می کند. این فقط هر کدام را دارد
اثر اگر قبل از "راه اندازی" فراخوانی شود.
همچنین می‌توانید با تنظیم متغیر محیطی "LIBGUESTFS_MEMSIZE" قبلاً این مورد را تغییر دهید
دسته ایجاد می شود.
برای اطلاعات بیشتر در مورد معماری libguestfs، نگاه کنید مهمانان(3).
مجموعه شبکه
شبکه
set-network true|false
اگر "شبکه" درست باشد، شبکه در ابزار libguestfs فعال می شود. را
پیش فرض نادرست است.
این امر بر اینکه آیا دستورات می‌توانند به شبکه دسترسی داشته باشند تأثیر می‌گذارد (به «اجرای دستورات» در آن مراجعه کنید
مهمانان(3).
قبل از فراخوانی "راه اندازی" باید این را صدا بزنید، در غیر این صورت تاثیری ندارد.
تعیین مسیر
مسیر
مسیر جستجوی تعیین مسیر
مسیری را که libguestfs برای کرنل و initrd.img جستجو می کند، تنظیم کنید.
پیش‌فرض «$libdir/guestfs» است مگر اینکه با تنظیم «LIBGUESTFS_PATH» لغو شود.
متغیر محیطی.
با تنظیم "path" روی "NULL" مسیر پیش فرض بازیابی می شود.
set-pgroup
pgroup
set-pgroup true|false
اگر "pgroup" درست باشد، فرآیندهای فرزند در گروه فرآیند خود قرار می گیرند.
نتیجه عملی این است که سیگنال هایی مانند "SIGINT" (از کاربرانی که "^C" را فشار می دهند)
توسط فرآیند فرزند دریافت نخواهد شد.
پیش‌فرض این پرچم نادرست است، زیرا معمولاً می‌خواهید «^C» فرآیند فرعی را بکشد.
Guestfish این پرچم را در صورت استفاده تعاملی روی true تنظیم می کند، به طوری که "^C" می تواند طولانی مدت را لغو کند.
دستورات را به خوبی اجرا کنید (به "لغو کاربر" مراجعه کنید).
مجموعه برنامه
برنامه
برنامه تنظیم برنامه
نام برنامه را تنظیم کنید این یک رشته اطلاعاتی است که برنامه اصلی ممکن است به صورت اختیاری باشد
در دسته
هنگامی که دسته ایجاد می شود، نام برنامه در دسته به نام پایه از تنظیم می شود
"argv[0]". اگر امکان پذیر نبود، روی رشته خالی تنظیم می شود (اما هرگز "NULL").
set-qemu
ایست
set-qemu hv
Hypervisor باینری (معمولا qemu) را که استفاده خواهیم کرد را تنظیم کنید.
پیش فرض زمانی انتخاب می شود که کتابخانه توسط اسکریپت پیکربندی کامپایل شده باشد.
همچنین می توانید با تنظیم متغیر محیطی "LIBGUESTFS_HV" این مورد را لغو کنید.
تنظیم "hv" روی "NULL" باینری پیش فرض qemu را بازیابی می کند.
توجه داشته باشید که باید این تابع را در اسرع وقت پس از ایجاد دسته فراخوانی کنید.
این به این دلیل است که برخی از عملیات های قبل از راه اندازی به آزمایش ویژگی های qemu (با اجرای
"qemu - help"). اگر باینری qemu تغییر کند، ویژگی‌ها را دوباره آزمایش نمی‌کنیم، و بنابراین ممکن است ببینید
نتایج متناقض استفاده از متغیر محیطی "LIBGUESTFS_HV" از همه امن تر است
از آنجایی که همزمان با ایجاد دسته، باینری qemu را انتخاب می کند.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "set-hv" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
set-recovery-proc
روند بازیابی
set-recovery-proc true|false
اگر با پارامتر "false" فراخوانی شود، "راه اندازی" بازیابی ایجاد نمی کند
روند. هدف از فرآیند بازیابی متوقف کردن فرآیندهای هایپروایزر فراری است
موردی که برنامه اصلی به طور ناگهانی قطع می شود.
این فقط در صورت فراخوانی قبل از "راه اندازی" اثری دارد و پیش فرض درست است.
تقریباً تنها زمانی که می‌خواهید این را غیرفعال کنید این است که فرآیند اصلی منشعب شود
خود را در پس‌زمینه قرار می‌دهد (خود را «شیرینی کردن»). در این مورد فرآیند بازیابی فکر می کند
که برنامه اصلی ناپدید شده است و بنابراین هایپروایزر را می کشد که خیلی هم نیست
مفید است.
set-selinux
سلینوکس
set-selinux true|false
این پرچم selinux را تنظیم می کند که در زمان راه اندازی به دستگاه منتقل می شود. پیش فرض است
"selinux=0" (غیرفعال).
توجه داشته باشید که اگر SELinux فعال باشد، همیشه در حالت Permissive است ("enforcing=0").
برای اطلاعات بیشتر در مورد معماری libguestfs، نگاه کنید مهمانان(3).
تنظیم-smp
دبیرستان متوسطه اول
set-smp smp
تعداد CPUهای مجازی اختصاص داده شده به دستگاه را تغییر دهید. پیش فرض 1 است.
افزایش این ممکن است عملکرد را بهبود بخشد، اگرچه اغلب تأثیری ندارد.
این تابع باید قبل از "راه اندازی" فراخوانی شود.
set-tmpdir
tmpdir
set-tmpdir tmpdir
دایرکتوری مورد استفاده توسط دسته را برای ذخیره فایل های موقت تنظیم کنید.
متغیرهای محیطی "LIBGUESTFS_TMPDIR" و "TMPDIR" مقدار پیش فرض را کنترل می کنند: اگر
"LIBGUESTFS_TMPDIR" تنظیم شده است، سپس این پیش فرض است. در غیر این صورت، اگر "TMPDIR" تنظیم شده باشد، آن وقت است
پیش فرض است. دیگر دایرکتوری / tmp پیش فرض است.
تنظیم ردیابی
رد
set-trace true|false
اگر پرچم ردیابی فرمان روی 1 تنظیم شود، libguestfs فراخوانی ها، پارامترها و مقادیر را برمی گرداند.
ردیابی می شوند.
اگر می‌خواهید تماس‌های C API را در libguestfs (و سایر کتابخانه‌ها) ردیابی کنید، احتمالاً
راه بهتر استفاده از خارجی است ردیابی(1) فرمان.
ردیابی فرمان غیرفعال است مگر اینکه متغیر محیطی "LIBGUESTFS_TRACE" تعریف شده باشد
و روی 1 تنظیم کنید.
پیام‌های ردیابی معمولاً به "stderr" ارسال می‌شوند، مگر اینکه برای ارسال آنها یک تماس پاسخ ثبت کنید
در جای دیگری (به "تنظیم رویداد-بازخوانی" مراجعه کنید).
set-uuid
set-uuid دستگاه uuid
فایل سیستم UUID روی «دستگاه» را روی «uuid» تنظیم کنید. اگر این کار انجام نشد و خطا ENOTSUP بود،
به این معنی که هیچ پشتیبانی برای تغییر UUID برای نوع مشخص شده وجود ندارد
فایل سیستم
فقط برخی از انواع سیستم فایل از تنظیمات UUID پشتیبانی می کنند.
برای خواندن UUID در یک سیستم فایل، "vfs-uuid" را فراخوانی کنید.
set-uuid-random
دستگاه set-uuid-random
UUID سیستم فایل روی «دستگاه» را روی یک UUID تصادفی تنظیم کنید. اگر این شکست بخورد و خطا باشد
ENOTSUP، به این معنی است که هیچ پشتیبانی برای تغییر UUID برای نوع UUID وجود ندارد
فایل سیستم مشخص شده
فقط برخی از انواع سیستم فایل از تنظیمات UUID پشتیبانی می کنند.
برای خواندن UUID در یک سیستم فایل، "vfs-uuid" را فراخوانی کنید.
پرمخاطب
واژگان
set-verbose true|false
اگر «پرمخاطب» درست باشد، پیام‌های پرمخاطب را روشن میکند.
پیام‌های پرمخاطب غیرفعال هستند مگر اینکه متغیر محیطی "LIBGUESTFS_DEBUG" باشد
تعریف شده و روی 1 تنظیم شده است.
پیام‌های پرمخاطب معمولاً به "stderr" ارسال می‌شوند، مگر اینکه برای ارسال پاسخ تماس ثبت کنید
آنها را در جای دیگری ببینید (به "تنظیم-رویداد-بازخوانی" مراجعه کنید).
setcon
زمینه setcon
این زمینه امنیتی SELinux دیمون را روی رشته "context" تنظیم می کند.
مستندات مربوط به SELINUX را در اینجا ببینید مهمانان(3).
setxattr
مسیر setxattr xattr val vallen
این فراخوانی ویژگی توسعه یافته به نام "xattr" از فایل "path" را به مقدار "val" تنظیم می کند.
(از طول "والن"). مقدار داده دلخواه 8 بیتی است.
همچنین ببینید: "lsetxattr"، جذب کنند(5).
sfdisk
دستگاه sfdisk cyls heads بخش "خطوط ..."
این یک رابط مستقیم به sfdisk(8) برنامه برای ایجاد پارتیشن در بلوک
دستگاه ها.
برای مثال، "دستگاه" باید یک دستگاه بلوک باشد / dev / sda و.
«سیلندر»، «هد» و «قطعه» تعداد سیلندرها، سرها و بخش‌های روی
دستگاهی که مستقیماً به عنوان sfdisk ارسال می شود -C, -H و -S مولفه های. اگر بگذری
0 برای هر یک از اینها، سپس پارامتر مربوطه حذف می شود. معمولا برای "بزرگ"
برای این دیسک‌ها فقط می‌توانید عدد 0 را ارسال کنید، اما برای دیسک‌های کوچک (به اندازه فلاپی)، sfdisk (یا
بلکه هسته) نمی تواند هندسه درستی داشته باشد و شما باید آن را بگویید.
"lines" لیستی از خطوطی است که ما به "sfdisk" تغذیه می کنیم. برای اطلاعات بیشتر به
sfdisk(8) manpage.
برای ایجاد یک پارتیشن منفرد که کل دیسک را اشغال می کند، باید "خطوط" را به عنوان یک واحد ارسال کنید
لیست عنصر، زمانی که عنصر واحد رشته "," (کاما) باشد.
همچنین ببینید: "sfdisk-l"، "sfdisk-N"، "part-init"
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی «part-add» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
sfdiskM
خطوط دستگاه sfdiskM ...
این یک رابط ساده شده برای دستور "sfdisk" است که اندازه پارتیشن ها در آن قرار دارند
فقط بر حسب مگابایت (به نزدیکترین سیلندر گرد شده) مشخص شده است و نیازی به
پارامترهای سیلن، هد و سکتورها را که به ندرت استفاده شده اند را مشخص کنید.
همچنین ببینید: "sfdisk", the sfdisk(8) manpage و "part-disk"
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی «part-add» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
sfdisk-N
sfdisk-N دستگاه پارتنوم cyls سر سکتور خط
این اجرا می شود sfdisk(8) گزینه ای برای تغییر تنها پارتیشن "n" (توجه داشته باشید: "n" از آن شمارش می شود
1).
برای سایر پارامترها، "sfdisk" را ببینید. معمولاً باید 0 را برای cyls/heads/sectors پاس کنید
پارامترها.
همچنین ببینید: "part-add"
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی «part-add» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
sfdisk-disk-geometry
دستگاه sfdisk-disk-geometry
این هندسه دیسک "دستگاه" خوانده شده از جدول پارتیشن را نمایش می دهد. به خصوص در
در موردی که اندازه دستگاه بلوک زیرین تغییر کرده است، این می تواند متفاوت باشد
ایده هسته از هندسه (به "sfdisk-kernel-geometry" مراجعه کنید).
نتیجه در قالب قابل خواندن توسط انسان است و برای تجزیه طراحی نشده است.
sfdisk-kernel-geometry
دستگاه sfdisk-kernel-geometry
این ایده کرنل از هندسه "دستگاه" را نشان می دهد.
نتیجه در قالب قابل خواندن توسط انسان است و برای تجزیه طراحی نشده است.
sfdisk-l
دستگاه sfdisk-l
این جدول پارتیشن را در "دستگاه" در خروجی قابل خواندن توسط انسان نمایش می دهد
sfdisk(8) فرمان. قرار نیست تجزیه شود.
همچنین ببینید: "جزئی لیست"
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی "part-list" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
sh
دستور sh
این فراخوانی دستوری را از سیستم فایل مهمان از طریق مهمان اجرا می کند / بن / شل.
این مانند "command" است، اما دستور را به:
/ بن / شل -c "فرمان"
بسته به پوسته مهمان، این معمولاً منجر به گسترش حروف عامیانه می شود
عبارات درون یابی شده و غیره.
تمام مقررات مربوط به "فرمان" در مورد این فراخوان اعمال می شود.
خطوط sh
دستور sh-lines
این همان "sh" است، اما نتیجه را به لیستی از خطوط تقسیم می کند.
همچنین ببینید: "خطوط فرمان"
تعطیل
تعطیل
این برعکس "راه اندازی" است. خاموش کردن منظم باطن را انجام می دهد
فرآیند(های) اگر پرچم خودکار همگام‌سازی تنظیم شده باشد (که پیش‌فرض است)، تصویر دیسک تنظیم میشود
هماهنگ شده
اگر فرآیند فرعی با خطا خارج شود، این تابع یک خطا را برمی‌گرداند که
باید نه نادیده گرفته شود (ممکن است نشان دهد که تصویر دیسک نمی تواند نوشته شود
به درستی).
تماس با این چند بار بی خطر است. تماس های اضافی نادیده گرفته می شوند.
این تماس انجام می دهد نه دستگیره را ببندید یا آزاد کنید هنوز باید با "بستن" تماس بگیرید
پس از آن
اگر به صراحت این کار را انجام ندهید، "close" این را صدا می کند، اما توجه داشته باشید که هر گونه خطا نادیده گرفته می شود
در این مورد.
خواب
ثانیه خواب
برای "ثانیه" ثانیه بخوابید.
آمار
مسیر آماری
اطلاعات فایل را برای "مسیر" داده شده برمی گرداند.
این همان است آمار(2) تماس سیستمی.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "statns" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
statns
مسیر statns
اطلاعات فایل را برای "مسیر" داده شده برمی گرداند.
این همان است آمار(2) تماس سیستمی.
statvfs
مسیر statvfs
آمار سیستم فایل را برای هر فایل سیستم نصب شده برمی گرداند. "path" باید یک فایل یا
دایرکتوری در سیستم فایل نصب شده (معمولاً خود نقطه اتصال است، اما آن
نیازی نیست).
این همان است statvfs(2) تماس سیستمی.
رشته های
مسیر رشته ها
این اجرا می شود رشته های(1) روی یک فایل دستور می دهد و لیست رشته های قابل چاپ را برمی گرداند
پیدا شده است.
دستور "strings" در گذشته با تجزیه فایل های نامعتبر مشکل داشت. اینها
در نسخه فعلی libguestfs کاهش یافته است، اما به "CVE-2014-8484" در مهمانان(3).
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
strings-e
مسیر رمزگذاری رشته ها
این مانند دستور "strings" است، اما به شما اجازه می دهد تا رمزگذاری رشته هایی را مشخص کنید
در فایل منبع "path" جستجو می شوند.
رمزگذاری های مجاز عبارتند از:
نویسه‌های 7 بیتی منفرد مانند ASCII و بخش‌های سازگار با ASCII ISO-8859-X
(این همان چیزی است که "رشته" استفاده می کند).
S تک کاراکترهای 8 بیتی.
b رشته های اندیان بزرگ 16 بیتی مانند آنهایی که در UTF-16BE یا UCS-2BE کدگذاری شده اند.
l (حرف کوچک L)
اندیان کوچک 16 بیتی مانند UTF-16LE و UCS-2LE. این برای بررسی مفید است
باینری ها در مهمان های ویندوز.
B 32 بیتی بزرگ اندیان مانند UCS-4BE.
اندیان کوچک 32 بیتی L مانند UCS-4LE.
رشته های برگشتی به UTF-8 تبدیل می شوند.
دستور "strings" در گذشته با تجزیه فایل های نامعتبر مشکل داشت. اینها
در نسخه فعلی libguestfs کاهش یافته است، اما به "CVE-2014-8484" در مهمانان(3).
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
تعویض دستگاه
دستگاه swapoff-device
این دستور دستگاه یا پارتیشن مبادله لوازم libguestfs با نام «device» را غیرفعال می کند.
به "swapon-device" مراجعه کنید.
فایل swapoff
فایل swapoff-file
این دستور libguestfs appliance swap روی فایل را غیرفعال می کند.
swapoff-label
برچسب swapoff-label
این دستور تعویض ابزار libguestfs را در پارتیشن swap برچسب دار غیرفعال می کند.
swapoff-uuid
swapoff-uuid uuid
این دستور پارتیشن libguestfs appliance swap را با UUID داده شده غیرفعال می کند.
تعویض دستگاه
دستگاه swapon-device
این دستور ابزار libguestfs را قادر می‌سازد تا از دستگاه یا پارتیشن مبادله‌ای که نامش را نامگذاری کرده است استفاده کند
"دستگاه". حافظه افزایش یافته برای همه دستورات در دسترس است، به عنوان مثال آنهایی که اجرا می شوند
با استفاده از "command" یا "sh".
توجه داشته باشید که نباید با پارتیشن‌های تعویض مهمان موجود تعویض کنید، مگر اینکه بدانید چه چیزی دارید
در حال انجام. آنها ممکن است حاوی اطلاعات خواب زمستانی یا سایر اطلاعاتی باشند که مهمان است
نمی خواهد شما را سطل زباله کنید شما همچنین در معرض خطر درز اطلاعات مربوط به میزبان به مهمان هستید
بدین ترتیب. در عوض، یک دستگاه میزبان جدید را به مهمان وصل کنید و آن را تعویض کنید.
swapon-فایل
فایل swapon
این دستور swap به یک فایل را فعال می کند. برای یادداشت‌های دیگر به «swapon-device» مراجعه کنید.
swapon-label
برچسب swapon-label
این دستور swap را به یک پارتیشن swap برچسب گذاری شده فعال می کند. برای موارد دیگر به "swapon-device" مراجعه کنید
یادداشت.
swapon-uuid
swapon-uuid uuid
این دستور swap به یک پارتیشن swap با UUID داده شده را فعال می کند. به "swapon-device" مراجعه کنید
برای یادداشت های دیگر
همگام
همگام
این دیسک را همگام می کند، به طوری که هر نوشته ای به تصویر دیسک زیرین منتقل می شود.
اگر تصویر دیسک را تغییر داده اید، همیشه باید قبل از بستن دسته، این را صدا بزنید.
syslinux
دستگاه syslinux [دایرکتوری:..]
بوت لودر SYSLINUX را روی «دستگاه» نصب کنید.
پارامتر دستگاه باید یا یک دیسک کامل فرمت شده به عنوان یک فایل سیستم FAT باشد یا a
پارتیشن فرمت شده به عنوان یک فایل سیستم FAT. در مورد دوم، پارتیشن باید باشد
علامت گذاری شده به عنوان "فعال" ("پارت مجموعه قابل راه اندازی") و یک رکورد بوت اصلی باید نصب شود (به عنوان مثال.
با استفاده از "pwrite-device") در بخش اول کل دیسک. بسته SYSLINUX می آید
با چند رکورد Master Boot مناسب. را ببینید syslinux(1) صفحه مرد برای ادامه مطلب
اطلاعات.
آرگومان های اختیاری عبارتند از:
فهرست راهنما
SYSLINUX را در زیر شاخه نامگذاری شده نصب کنید، به جای اینکه در دایرکتوری ریشه آن نصب شود
فایل سیستم FAT
پیکربندی اضافی را می توان با قرار دادن یک فایل به نام SYSLINUX ارائه کرد syslinux.cfg
در فایل سیستم FAT، یا در دایرکتوری ریشه یا در زیر فهرست راهنما اگر آن اختیاری است
استدلال در حال استفاده است. برای اطلاعات بیشتر در مورد محتویات این فایل به ادامه مطلب مراجعه کنید
syslinux(1).
همچنین به "extlinux" مراجعه کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
دم
مسیر دم
این دستور تا 10 خط آخر یک فایل را به عنوان لیست رشته ها برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
دم-ن
مسیر tail-n nrlines
اگر پارامتر "nrlines" یک عدد مثبت باشد، آخرین خطوط "nrlines" را برمی گرداند
فایل "مسیر".
اگر پارامتر "nrlines" یک عدد منفی باشد، خطوطی از فایل "path" را برمی گرداند.
با خط "-nrlines" شروع می شود.
اگر پارامتر "nrlines" صفر باشد، یک لیست خالی برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
tar-in
tar-in-opts
فهرست tar-in (tarfile|-) [فشرده کردن:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]
این دستور فایل محلی "tarfile" را آپلود و باز می کند فهرست راهنما.
پرچم اختیاری "فشرده سازی" فشرده سازی را کنترل می کند. اگر داده نشده باشد، ورودی باید باشد
یک فایل tar غیر فشرده در غیر این صورت ممکن است یکی از رشته های زیر برای انتخاب داده شود
نوع فشرده سازی فایل ورودی: "compress"، "gzip"، "bzip2"، "xz"، "lzop". (توجه داشته باشید
که همه بیلدهای libguestfs از همه این انواع فشرده سازی پشتیبانی نمی کنند).
آرگومان های اختیاری دیگر عبارتند از:
"xattrs"
اگر روی true تنظیم شود، ویژگی های توسعه یافته از فایل tar بازیابی می شوند.
"سلینوکس"
اگر روی true تنظیم شود، زمینه های SELinux از فایل tar بازیابی می شوند.
"acls"
اگر روی true تنظیم شود، ACL های POSIX از فایل tar بازیابی می شوند.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
قیر کردن
tar-out-opts
فهرست راهنمای tar-out (tarfile|-) [فشرده کردن:..] [numericowner:true|false] [به استثنای:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]
این دستور محتویات را بسته بندی می کند فهرست راهنما و آن را در فایل محلی "tarfile" دانلود می کند.
پرچم اختیاری "فشرده سازی" فشرده سازی را کنترل می کند. اگر داده نشود، خروجی خواهد بود
یک فایل tar غیر فشرده در غیر این صورت ممکن است یکی از رشته های زیر برای انتخاب داده شود
نوع فشرده سازی فایل خروجی: "compress"، "gzip"، "bzip2"، "xz"، "lzop". (توجه داشته باشید
که همه بیلدهای libguestfs از همه این انواع فشرده سازی پشتیبانی نمی کنند).
آرگومان های اختیاری دیگر عبارتند از:
"استثنا"
لیستی از حروف عام اگر فایل‌ها با هر یک از حروف عام مطابقت داشته باشند، حذف می‌شوند.
"مالک عددی"
اگر روی true تنظیم شود، فایل tar خروجی به جای کاربر/گروه حاوی اعداد UID/GID خواهد بود
نامها
"xattrs"
اگر روی true تنظیم شود، ویژگی های توسعه یافته در تار خروجی ذخیره می شوند.
"سلینوکس"
اگر روی true تنظیم شود، زمینه های SELinux در تار خروجی ذخیره می شوند.
"acls"
اگر روی true تنظیم شود، ACL های POSIX در تار خروجی ذخیره می شوند.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
tgz-in
فهرست راهنمای tgz-in (tarball|-).
این دستور فایل محلی "tarball" را آپلود و باز می کند (الف از gzip فشرده فایل tar) به
فهرست راهنما.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "tar-in" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
tgz-out
فهرست راهنما tgz-out (tarball|-)
این دستور محتویات را بسته بندی می کند فهرست راهنما و آن را در فایل محلی "tarball" دانلود می کند.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "tar-out" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
لمس
مسیر لمسی
لمس مانند عمل می کند لمس(1) فرمان می توان از آن برای به روز رسانی مهرهای زمانی روی یک فایل استفاده کرد،
یا، اگر فایل وجود ندارد، یک فایل با طول صفر جدید ایجاد کنید.
این دستور فقط روی فایل‌های معمولی کار میکند و در انواع فایل‌های دیگر مانند
دایرکتوری ها، پیوندهای نمادین، بلاک های ویژه و غیره
کوتاه کردن
کوتاه کردن مسیر
این دستور "path" را به یک فایل با طول صفر کوتاه می کند. فایل باید از قبل وجود داشته باشد.
اندازه کوتاه
اندازه مسیر کوتاه
این دستور "path" را به اندازه "size" بایت کوتاه می کند. فایل باید از قبل وجود داشته باشد.
اگر اندازه فایل فعلی کمتر از "اندازه" باشد، فایل به اندازه مورد نیاز گسترش می یابد
اندازه با صفر بایت این یک فایل پراکنده ایجاد می کند (یعنی بلوک های دیسک برای آنها تخصیص داده نمی شود
فایل را تا زمانی که روی آن بنویسید). برای ایجاد یک فایل غیر پراکنده از صفر، از "fallocate64" استفاده کنید.
به جای آن.
tune2fs
دستگاه tune2fs [force:true|false] [maxmountcount:N] [mountcount:N] [error behavior:...] [group:N] [intervalbetweenchecks:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N ] [کاربر:ن]
این فراخوانی به شما این امکان را می دهد که پارامترهای مختلف فایل سیستم یک ext2/ext3/ext4 را تنظیم کنید
فایل سیستمی به نام "دستگاه".
پارامترهای اختیاری عبارتند از:
"زور"
tune2fs را مجبور کنید حتی در صورت وجود خطا، عملیات را کامل کند. این هم همینطور است
به عنوان گزینه tune2fs "-f".
"maxmountcount"
تعداد مانت هایی را که پس از آن سیستم فایل توسط آن بررسی می شود را تنظیم کنید e2fsck(8). اگر این
0 است سپس تعداد مانت ها نادیده گرفته می شود. این همان tune2fs "-c" است
گزینه.
"mountcount"
تعداد دفعات نصب فایل سیستم را تنظیم کنید. این همان است
گزینه tune2fs "-C".
"رفتار خطا"
هنگام شناسایی خطا، رفتار کد هسته را تغییر دهید. مقادیر ممکن
در حال حاضر عبارتند از: "continue"، "remount-ro"، "panic". در عمل این گزینه ها اینطور نیست
واقعاً تفاوتی ایجاد می کند، به خصوص برای خطاهای نوشتن.
این همان گزینه tune2fs "-e" است.
"گروه"
گروهی را تنظیم کنید که می تواند از بلوک های سیستم فایل رزرو شده استفاده کند. این همان است
گزینه tune2fs "-g" با این تفاوت که فقط می توان آن را به عنوان یک عدد مشخص کرد.
"فاصله بین چک ها"
حداکثر زمان بین دو بررسی سیستم فایل (بر حسب ثانیه) را تنظیم کنید. اگر گزینه است
به عنوان 0 ارسال می شود سپس بررسی وابسته به زمان غیرفعال می شود.
این همان گزینه tune2fs "-i" است.
"Blockspercentage رزرو شده"
درصدی از سیستم فایل را که ممکن است فقط توسط افراد دارای امتیاز اختصاص داده شود، تنظیم کنید
فرآیندها این همان گزینه tune2fs "-m" است.
"lastmounteddirectory"
آخرین دایرکتوری نصب شده را تنظیم کنید. این همان گزینه tune2fs "-M" است.
"reservedblockscount" تعداد بلوک های سیستم فایل رزرو شده را تنظیم کنید. این همان است
گزینه tune2fs "-r".
"کاربر"
کاربری را تعیین کنید که بتواند از بلوک های سیستم فایل رزرو شده استفاده کند. این همان است
گزینه tune2fs "-u" با این تفاوت که فقط می توان آن را به عنوان یک عدد مشخص کرد.
برای بدست آوردن مقادیر فعلی پارامترهای سیستم فایل، به "tune2fs-l" مراجعه کنید. برای جزئیات دقیق
در مورد نحوه عملکرد tune2fs، به ادامه مطلب مراجعه کنید tune2fs(8) صفحه مرد.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
tune2fs-l
دستگاه tune2fs-l
این محتویات سوپر بلوک سیستم فایل ext2، ext3 یا ext4 را در "دستگاه" برمی گرداند.
این همان اجرای "دستگاه tune2fs -l" است. دیدن tune2fs(8) manpage برای جزئیات بیشتر.
لیست فیلدهای بازگردانده شده به وضوح تعریف نشده است و به هر دو نسخه بستگی دارد
"tune2fs" که libguestfs بر علیه آن ساخته شده است و خود سیستم فایل.
txz-in
فهرست راهنمای txz-in (tarball|-).
این دستور فایل محلی "tarball" را آپلود و باز می کند (an xz فشرده فایل tar) به
فهرست راهنما.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "tar-in" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
txz-out
فهرست راهنما txz-out (tarball|-)
این دستور محتویات را بسته بندی می کند فهرست راهنما و آن را در فایل محلی "tarball" (به عنوان
یک آرشیو فشرده xz tar).
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
این تابع is منسوخ. در کد جدید، به جای آن از تماس "tar-out" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
umask
ماسک umask
این تابع ماسک مورد استفاده برای ایجاد فایل‌ها و گره‌های دستگاه جدید را روی "mask & 0777" تنظیم میکند.
مقادیر معمول umask 022 است که فایل های جدیدی با مجوزهایی مانند ایجاد می کند
"-rw-r--r--" یا "-rwxr-xr-x" و 002 که فایل های جدیدی با مجوزهایی مانند
"-rw-rw-r--" یا "-rwxrwxr-x".
umask پیش فرض 022 است. این مهم است زیرا به این معنی است که دایرکتوری ها و دستگاه
گره ها با حالت 0644 یا 0755 ایجاد می شوند حتی اگر 0777 را مشخص کنید.
همچنین به "get-umask" مراجعه کنید، umask(2)، «مکنود»، «مکدیر».
این فراخوانی umask قبلی را برمی گرداند.
جمع کردن
پیاده کردن
umount-opts
umount pathordevice [force:true| false] [lazyunmount:true|false]
این فایل سیستم داده شده را از حالت نصب خارج می کند. فایل سیستم ممکن است توسط آن مشخص شود
mountpoint (مسیر) یا دستگاهی که شامل سیستم فایل است.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
مقدار همه
unmount-all
مقدار همه
این همه فایل سیستم های نصب شده را از حالت مانت خارج می کند.
برخی از پایه‌های داخلی با این تماس حذف نمی‌شوند.
مقدار-محلی
umount-local [تکرار مجدد:درست|نادرست]
اگر libguestfs فایل سیستم را روی یک نقطه نصب محلی صادر می کند، آن را از حالت نصب خارج می کند.
"MOUNT LOCAL" را در اینجا ببینید مهمانان(3) برای مستندات کامل.
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
آپلود
آپلود (نام فایل|-) نام فایل راه دور
فایل محلی را آپلود کنید نام فایل به نام فایل راه دور روی سیستم فایل
نام فایل همچنین می تواند یک لوله با نام باشد.
همچنین به "دانلود" مراجعه کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
آپلود آفست
upload-offset (نام فایل|-) نام فایل از راه دور افست
فایل محلی را آپلود کنید نام فایل به نام فایل راه دور روی سیستم فایل
نام فایل راه دور با شروع بایت "offset" مشخص شده بازنویسی می شود. قصد این است
برای بازنویسی بخش‌هایی از فایل‌ها یا دستگاه‌های موجود، اگرچه اگر فایلی وجود نداشته باشد
مشخص شده و سپس با یک "سوراخ" قبل از "offset" ایجاد می شود. اندازه داده های نوشته شده
در اندازه منبع ضمنی است نام فایل.
توجه داشته باشید که هیچ محدودیتی در میزان داده ای که می توان با این تماس آپلود کرد وجود ندارد.
برخلاف "pwrite"، و این تماس همیشه مقدار کامل را می نویسد مگر اینکه خطایی رخ دهد.
همچنین به "آپلود"، "pwrite" مراجعه کنید.
از "-" به جای نام فایل برای خواندن/نوشتن از stdin/stdout استفاده کنید.
کاربر لغو
کاربر لغو
این تابع عملیات بارگذاری یا دانلود فعلی را لغو می کند.
برخلاف بسیاری از فراخوانی های libguestfs دیگر، این تابع دارای سیگنال ایمن و thread ایمن است. تو می توانی
آن را از یک کنترل کننده سیگنال یا از یک رشته دیگر، بدون نیاز به قفل کردن صدا کنید.
انتقالی که در حال انجام بود (اگر وجود داشته باشد) مدت کوتاهی بعد متوقف می شود و خواهد شد
خطا را برگرداند errno (به "guestfs_last_errno" مراجعه کنید) روی "EINTR" تنظیم شده است، بنابراین می توانید آزمایش کنید
برای این که بفهمیم آیا عملیات به دلیل خطای دیگری لغو شده یا ناموفق بوده است.
هیچ پاکسازی انجام نمی شود: به عنوان مثال، اگر یک فایل در حال آپلود بود، پس از لغو
ممکن است یک فایل تا حدی آپلود شده باشد. این مسئولیت تماس گیرنده است که اگر را تمیز کند
لازم است
دو مکان متداول وجود دارد که ممکن است آنها را «لغو کاربر» بنامید:
در یک برنامه مبتنی بر متن تعاملی، می توانید آن را از یک کنترل کننده سیگنال "SIGINT" فراخوانی کنید.
که فشار دادن "^C" عملیات جاری را لغو می کند. (همچنین باید تماس بگیرید
"guestfs_set_pgroup" تا پردازش های فرزند سیگنال "^C" را دریافت نکنند).
در یک برنامه گرافیکی، زمانی که موضوع اصلی نوار پیشرفت را با لغو نمایش می دهد
برای فراخوانی این عملکرد، دکمه لغو را سیم کشی کنید.
ابزارها
مسیر utimes atsecs atnsecs mtsecs mtnsecs
این دستور مهرهای زمانی یک فایل را با دقت نانوثانیه تنظیم می کند.
"atsecs, atnsecs" آخرین زمان دسترسی (atime) در ثانیه و نانوثانیه از دوران است.
"mtsecs, mtnsecs" آخرین زمان اصلاح (mtime) در ثانیه و نانوثانیه از
دوره
اگر فیلد *nsecs حاوی مقدار ویژه "-1" باشد، مهر زمانی مربوطه است
روی زمان فعلی تنظیم کنید (در این مورد قسمت *secs نادیده گرفته می شود).
اگر فیلد *nsecs حاوی مقدار ویژه "-2" باشد، مهر زمانی مربوطه است
بدون تغییر باقی مانده است. (در این مورد قسمت *secs نادیده گرفته می شود).
utsname
utsname
این نسخه هسته دستگاه را که در آن موجود است، برمی گرداند. این
اطلاعات فقط برای اشکال زدایی مفید است. هیچ چیزی در ساختار برگشتی با تعریف نشده است
API
نسخه
نسخه
شماره نسخه libguestfs را که برنامه با آن پیوند شده است، برگردانید.
توجه داشته باشید که به دلیل پیوند پویا، این لزوماً نسخه libguestfs نیست
که علیه آن گردآوری کردید. می توانید برنامه را کامپایل کنید و سپس در زمان اجرا به صورت پویا
لینک در برابر یک کاملا متفاوت است libguestfs.so کتابخانه
این تماس در نسخه 1.0.58 اضافه شد. در نسخه های قبلی libguestfs هیچ وجود نداشت
راه دریافت شماره نسخه از کد C می توانید از توابع پیوند دهنده پویا برای پیدا کردن استفاده کنید
اگر این نماد وجود داشته باشد (اگر وجود ندارد، پس نسخه قبلی است).
فراخوانی ساختاری با چهار عنصر را برمی گرداند. سه مورد اول ("عمده"، "فرع" و
"release") اعداد هستند و با نسخه معمولی سه گانه مطابقت دارند. عنصر چهارم
("extra") یک رشته است و معمولاً خالی است، اما ممکن است برای توزیع خاص استفاده شود
اطلاعات.
برای ساختن رشته نسخه اصلی: "$major.$minor.$release$extra"
همچنین ببینید: "LIBGUESTFS VERSION NUMBERS" در مهمانان(3).
توجه داشته باشید: از این تماس برای آزمایش در دسترس بودن ویژگی‌ها استفاده نکنید. در شرکت
توزیع‌هایی که ما ویژگی‌های نسخه‌های بعدی را به نسخه‌های قبلی پشتیبان می‌دهیم و این امر را ایجاد میکند
یک روش غیر قابل اعتماد برای آزمایش ویژگی ها به جای آن از «در دسترس» یا «ویژگی در دسترس» استفاده کنید.
vfs-label
vfs-label قابل نصب
این برچسب سیستم فایل را روی "mountable" برمی گرداند.
اگر سیستم فایل بدون برچسب باشد، رشته خالی را برمی گرداند.
برای پیدا کردن یک فایل سیستم از برچسب، از "findfs-label" استفاده کنید.
vfs-minimum-size
vfs-minimum-size mountable
حداقل اندازه فایل سیستم را بر حسب بایت دریافت کنید. این حداقل اندازه ممکن برای
کوچک شدن فایل سیستم
اگر دریافت حداقل اندازه فایل سیستم مشخص شده پشتیبانی نشود، این مورد ناموفق و تنظیم می شود
خطا به عنوان ENOTSUP.
همچنین مشاهده کنید ntfsresize(8) resize2fs(8) btrfs(8) xfs_info(8).
vfs-type
قابل نصب از نوع vfs
این دستور نوع فایل سیستم مربوط به سیستم فایل روی "mountable" را دریافت می کند.
برای اکثر فایل سیستم ها، نتیجه نام ماژول VFS لینوکس است که استفاده می شود
اگر این فایل سیستم را بدون مشخص کردن نوع سیستم نصب کرده اید، مانت کنید. برای
به عنوان مثال یک رشته مانند "ext3" یا "ntfs".
vfs-uuid
گرفتن-uuid
vfs-uuid قابل نصب
این UUID سیستم فایل سیستم فایل روی "mountable" را برمی گرداند.
اگر سیستم فایل UUID نداشته باشد، رشته خالی را برمی گرداند.
برای پیدا کردن یک فایل سیستم از UUID، از "findfs-uuid" استفاده کنید.
vg-activate
vg-activate true|false 'volgroups...'
این دستور فعال یا (اگر "activate" نادرست است) تمام حجم های منطقی را غیرفعال می کند
گروه های حجم فهرست شده "گروه های volgroup".
این دستور مانند اجرای "vgchange -ay|n volgroups..." است.
توجه داشته باشید که اگر "volgroups" یک لیست خالی است، پس تمام گروه های حجم فعال یا
غیر فعال شده
vg-activate-all
vg-activate-all true|false
این دستور فعال یا (اگر "activate" نادرست باشد) تمام حجم های منطقی را در همه غیرفعال می کند
گروه های حجمی
این دستور مانند اجرای "vgchange -ay|n" است.
vgchange-uuid
vgchange-uuid vg
یک UUID تصادفی جدید برای گروه حجم "vg" ایجاد کنید.
vgchange-uuid-all
vgchange-uuid-all
UUID های تصادفی جدید برای همه گروه های حجمی ایجاد کنید.
vgcreate
vgcreate volgroup 'physvols ...'
این یک گروه حجم LVM به نام "volgroup" از لیست غیر خالی فیزیکی ایجاد می کند
مجلدات "فیسولس".
vglvuuids
vglvuuids vgname
با توجه به VG به نام "vgname"، UUIDهای تمام حجم های منطقی ایجاد شده در
این گروه حجمی
می توانید از این به همراه فراخوانی های "lvs" و "lvuuid" برای مرتبط کردن حجم های منطقی و
گروه های حجمی
همچنین به "vgpvuuids" مراجعه کنید.
vgmeta
vgmeta vgname
"vgname" یک گروه حجم LVM است. این دستور گروه حجم را بررسی می کند و آن را برمی گرداند
فراداده
توجه داشته باشید که ابرداده یک ساختار داخلی است که توسط LVM استفاده میشود و در هر صورت ممکن است تغییر کند
زمان، و فقط برای اطلاع رسانی ارائه شده است.
vgpvuuids
vgpvuuids vgname
با توجه به VG به نام "vgname"، این UUID تمام حجم های فیزیکی را برمی گرداند
گروه حجم ساکن است.
می توانید از این به همراه تماس های "pvs" و "pvuuid" برای مرتبط کردن حجم های فیزیکی و
گروه های حجمی
همچنین به "vglvuuids" مراجعه کنید.
vgremove
vgremove vgname
یک گروه حجم LVM "vgname" را حذف کنید (به عنوان مثال "VG").
این همچنین به اجبار تمام حجم های منطقی در گروه حجم (در صورت وجود) را حذف می کند.
vgrename
vgrename volgroup newvolgroup
نام یک گروه حجمی را به "volgroup" با نام جدید "newvolgroup" تغییر دهید.
و غیره
و غیره
تمام گروه‌های جلد شناسایی شده را فهرست کنید. این معادل است و غیره(8) فرمان.
این یک لیست فقط از نام گروه های حجمی که شناسایی شده اند (به عنوان مثال "VolGroup00") را برمی گرداند.
همچنین به "vgs-full" مراجعه کنید.
vgs-full
vgs-full
تمام گروه‌های جلد شناسایی شده را فهرست کنید. این معادل است و غیره(8) فرمان. در
نسخه "کامل" شامل تمام فیلدها است.
vgscan
vgscan
این همه دستگاه‌های بلوک را دوباره اسکن میکند و فهرست حجم‌های فیزیکی LVM، حجم را دوباره می‌سازد
گروه ها و حجم های منطقی
vguuid
vguuid vgname
این دستور UUID LVM VG با نام "vgname" را برمی گرداند.
wc-c
مسیر wc-c
این دستور کاراکترهای یک فایل را با استفاده از دستور خارجی "wc -c" شمارش می کند.
wc-l
مسیر wc-l
این دستور با استفاده از دستور خارجی "wc -l" خطوط یک فایل را می شمارد.
wc-w
مسیر wc-w
این دستور با استفاده از دستور خارجی "wc -w" کلمات موجود در یک فایل را می شمارد.
دستمال مرطوب
دستگاه wipefs
این دستور امضاهای سیستم فایل یا RAID را از "دستگاه" مشخص شده پاک می کند تا آن را ایجاد کند
فایل سیستم برای libblkid نامرئی است.
این نه خود سیستم فایل و نه هیچ داده دیگری را از "دستگاه" پاک نمی کند.
با "صفر" مقایسه کنید که چند بلوک اول یک دستگاه را صفر می کند.
نوشتن
محتوای مسیر را بنویسید
این فراخوانی فایلی به نام مسیر ایجاد می کند. محتوای فایل رشته "content" است
(که می تواند حاوی هر داده 8 بیتی باشد).
همچنین به "نوشتن-پیوست" مراجعه کنید.
نوشتن-پیوست
نوشتن-پیوست محتوای مسیر
این فراخوان "content" را به انتهای فایل "path" اضافه می کند. اگر «مسیر» وجود نداشته باشد، الف
فایل جدید ایجاد می شود
همچنین به "نوشتن" مراجعه کنید.
نوشتن فایل
اندازه محتوای مسیر فایل نوشتن
این فراخوانی فایلی به نام مسیر ایجاد می کند. محتویات فایل رشته "content" است
(که می تواند حاوی هر داده 8 بیتی باشد)، با طول "اندازه".
به عنوان یک مورد خاص، اگر "اندازه" 0 باشد، طول با استفاده از "strlen" محاسبه می شود (بنابراین در این
در صورتی که محتوا نمی تواند حاوی NUL های ASCII تعبیه شده باشد).
NB به دلیل وجود یک اشکال، نوشتن محتوای حاوی کاراکترهای ASCII NUL انجام می شود نه کار کند، حتی اگر
طول مشخص شده است
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس «نوشتن» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
xfs-admin
دستگاه xfs-admin [extunwritten:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [lazy:..] [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-info
دستگاه گذرگاه xfs-info
"pathordevice" یک سیستم فایل XFS نصب شده یا یک دستگاه حاوی یک فایل سیستم XFS است. این
دستور هندسه فایل سیستم را برمی گرداند.
ساختار برگشتی حاوی اطلاعات هندسی است. فیلدهای از دست رفته به عنوان "-1" برگردانده می شوند
(برای فیلدهای عددی) یا رشته خالی.
xfs-repair
دستگاه xfs-repair [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride: N] [logdev:..] [rtdev:..]
سیستم فایل XFS خراب یا آسیب دیده را در "دستگاه" تعمیر کنید.
سیستم فایل با استفاده از آرگومان "دستگاه" که باید نام دستگاه باشد مشخص می شود
پارتیشن یا حجم دیسک حاوی سیستم فایل. اگر نام یک بلوک داده شود
دستگاه، "xfs_repair" تلاش خواهد کرد تا دستگاه خام مرتبط با مشخص شده را پیدا کند
دستگاه را مسدود کرده و به جای آن از دستگاه خام استفاده خواهد کرد.
صرف نظر از این، فایل سیستمی که باید تعمیر شود باید unmount شود، در غیر این صورت، نتیجه می شود
سیستم فایل ممکن است ناسازگار یا خراب باشد.
وضعیت بازگشتی نشان می دهد که آیا خرابی سیستم فایل شناسایی شده است (برمی گرداند 1) یا
شناسایی نشد (0 برمی گرداند).
این دستور یک یا چند آرگومان اختیاری دارد. به "استدلال های اختیاری" مراجعه کنید.
زگرپ
مسیر ریجکس zegrep
این برنامه خارجی "zegrep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
زگرپی
مسیر regex zegrepi
این برنامه خارجی "zegrep -i" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
صفر
دستگاه صفر
این دستور صفرها را روی چند بلوک اول "دستگاه" می نویسد.
تعداد بلوک هایی که صفر شده اند مشخص نشده است (اما همینطور است نه به اندازه کافی برای پاک کردن ایمن
دستگاه). حذف هر گونه جداول پارتیشن، سوپر بلوک های سیستم فایل باید کافی باشد
و الی آخر.
اگر بلوک ها از قبل صفر هستند، این دستور از نوشتن صفر جلوگیری می کند. این مانع از
دستگاه زیرین از پراکنده نشدن یا رشد غیر ضروری.
همچنین ببینید: "دستگاه صفر"، "دستگاه تمیزکننده"، "دستگاه صفر است"
دستگاه صفر
دستگاه صفر
این دستور صفرها را روی کل «دستگاه» می نویسد. مقایسه با "صفر" که فقط
چند بلوک اول یک دستگاه را صفر می کند.
اگر بلوک ها از قبل صفر هستند، این دستور از نوشتن صفر جلوگیری می کند. این مانع از
دستگاه زیرین از پراکنده نشدن یا رشد غیر ضروری.
فضای خالی صفر
دایرکتوری فضای خالی صفر
فضای خالی فایل سیستم نصب شده را صفر کنید فهرست راهنما. فایل سیستم باید باشد
خواندن و نوشتن نصب شده است.
محتویات سیستم فایل تحت تأثیر قرار نمی گیرند، اما هر فضای خالی در سیستم فایل آزاد می شود.
فضای آزاد "کوچک" نشده است. ممکن است بخواهید "fstrim" را به عنوان جایگزینی فراخوانی کنید
این، یا پس از تماس با این، بسته به نیاز شما.
بدون صفر
دستگاه بدون صفر
این اجرا می شود بدون صفر برنامه در "دستگاه". این برنامه ادعا می کند که اینودهای استفاده نشده را صفر می کند و
دیسک در یک فایل سیستم ext2/3 بلوک می شود، بنابراین فشرده سازی فایل سیستم را ممکن می کند.
موثرتر.
تو باید نه اگر سیستم فایل نصب شده است این برنامه را اجرا کنید.
این امکان وجود دارد که استفاده از این برنامه به سیستم فایل یا داده های موجود در آن آسیب برساند
فایل سیستم
zfgrep
مسیر الگوی zfgrep
این برنامه خارجی "zfgrep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
zfgrepi
مسیر الگوی zfgrepi
این برنامه خارجی "zfgrep -i" را فراخوانی می کند و خطوط منطبق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
zfile
مسیر zfile meth
این دستور اجرا می شود پرونده پس از اینکه ابتدا "مسیر" را با استفاده از "روش" از حالت فشرده خارج کرد.
"روش" باید یکی از "gzip"، "compress" یا "bzip2" باشد.
از 1.0.63، به جای آن از "file" استفاده کنید که اکنون می تواند فایل های فشرده را پردازش کند.
این تابع is منسوخ. در کد جدید، به جای آن از فراخوانی «فایل» استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
zgrep
مسیر zgrep regex
این برنامه خارجی "zgrep" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
زگرپی
مسیر regex zgrepi
این برنامه خارجی "zgrep -i" را فراخوانی می کند و خطوط مطابق را برمی گرداند.
به دلیل پروتکل پیام، محدودیت انتقال چیزی بین 2 مگابایت و
4 مگابایت "محدودیت های پروتکل" را در اینجا ببینید مهمانان(3).
این تابع is منسوخ. در کد جدید، به جای آن از تماس "grep" استفاده کنید.
توابع منسوخ شده از API حذف نمی شوند، بلکه این واقعیت است که حذف می شوند
منسوخ شده نشان می دهد که مشکلاتی در استفاده صحیح از این توابع وجود دارد.
خروج وضعیت
guestfish اگر دستورات بدون خطا انجام شده باشد 0 یا اگر خطایی وجود داشته باشد 1 را برمی گرداند.
محیط زیست متغیرها
تدوین
دستور "edit" از $EDITOR به عنوان ویرایشگر استفاده می کند. اگر تنظیم نشود، از "vi" استفاده می کند.
GUESTFISH_DISPLAY_IMAGE
دستور "display" از $GUESTFISH_DISPLAY_IMAGE برای نمایش تصاویر استفاده می کند. اگر تنظیم نشد، آن را
استفاده نمایش(1).
GUESTFISH_INIT
وقتی مهمان ماهی شروع می شود چاپ می شود. به "PROMPT" مراجعه کنید.
GUESTFISH_OUTPUT
قبل از خروجی guestfish چاپ شده است. به "PROMPT" مراجعه کنید.
GUESTFISH_PID
استفاده شده با --از راه دور گزینه ای برای تعیین فرآیند guestfish از راه دور برای کنترل. دیدن
بخش "ماهی مهمان کنترل از راه دور بیش از یک سوکت".
GUESTFISH_PS1
خط فرمان را تنظیم کنید. به "PROMPT" مراجعه کنید.
GUESTFISH_RESTORE
قبل از خروج ماهی مهمان چاپ شده است. به "PROMPT" مراجعه کنید.
HEXEDITOR
دستور "hexedit" از $HEXEDITOR به عنوان ویرایشگر هگز خارجی استفاده می کند. اگر مشخص نشده باشد،
خارجی هگزیدیت(1) برنامه استفاده می شود.
صفحه اصلی
اگر با پشتیبانی خط خواندن گنو کامپایل شود، فایل‌های مختلف در فهرست اصلی می‌توانند باشند
استفاده شده. به "فایل ها" مراجعه کنید.
LIBGUESTFS_APPEND
گزینه های اضافی را به هسته مهمان منتقل کنید.
LIBGUESTFS_ATTACH_METHOD
این روش قدیمی برای تنظیم "LIBGUESTFS_BACKEND" است.
LIBGUESTFS_BACKEND
روش پیش فرض ایجاد دستگاه را انتخاب کنید. "guestfs_set_backend" را در اینجا ببینید
مهمانان(3).
LIBGUESTFS_BACKEND_SETTINGS
یک لیست جدا شده از دو نقطه از تنظیمات خاص باطن. "بازگشت" را در مهمانان(3)
"تنظیمات بازگشت" در مهمانان(3).
LIBGUESTFS_CACHEDIR
مکانی که libguestfs هنگام استفاده از سوپرمین، دستگاه خود را کش میکند
دستگاه دستگاه در حافظه پنهان ذخیره می شود و بین همه دسته هایی که دارای یک دسته هستند به اشتراک گذاشته می شود
شناسه کاربری موثر
اگر "LIBGUESTFS_CACHEDIR" تنظیم نشده باشد، از "TMPDIR" استفاده می شود. اگر "TMPDIR" تنظیم نشده باشد،
سپس / var / tmp استفاده می شود.
همچنین به "LIBGUESTFS_TMPDIR"، "set-cachedir" مراجعه کنید.
LIBGUESTFS_DEBUG
"LIBGUESTFS_DEBUG=1" را برای فعال کردن پیام های پرمخاطب تنظیم کنید. این همان تأثیر را دارد
با استفاده از -v گزینه.
LIBGUESTFS_HV
Hypervisor پیش فرض (معمولا qemu) باینری را که libguestfs استفاده می کند، تنظیم کنید. اگر تنظیم نشده باشد،
سپس qemu که در زمان کامپایل توسط اسکریپت پیکربندی پیدا شد استفاده می شود.
LIBGUESTFS_MEMSIZE
حافظه اختصاص داده شده به فرآیند qemu را بر حسب مگابایت تنظیم کنید. مثلا:
LIBGUESTFS_MEMSIZE=700
LIBGUESTFS_PATH
مسیری را که guestfish برای جستجوی kernel و initrd.img استفاده می کند، تنظیم کنید. را ببینید
بحث در مورد مسیرها در مهمانان(3).
LIBGUESTFS_QEMU
این روش قدیمی برای تنظیم "LIBGUESTFS_HV" است.
LIBGUESTFS_TMPDIR
مکانی که libguestfs فایل های موقت استفاده شده توسط هر دسته را در آن ذخیره می کند.
اگر "LIBGUESTFS_TMPDIR" تنظیم نشده باشد، از "TMPDIR" استفاده می شود. اگر "TMPDIR" تنظیم نشده باشد،
سپس دایرکتوری / tmp استفاده می شود.
همچنین به "LIBGUESTFS_CACHEDIR"، "set-tmpdir" مراجعه کنید.
LIBGUESTFS_TRACE
"LIBGUESTFS_TRACE=1" را برای فعال کردن ردیابی فرمان تنظیم کنید.
PAGER
دستور "more" از $PAGER به عنوان پیجر استفاده می کند. اگر تنظیم نشود، از "بیشتر" استفاده می کند.
PATH
Libguestfs و guestfish ممکن است برخی از برنامه های خارجی را اجرا کنند و به تنظیم $PATH متکی باشند
به یک مقدار معقول. اگر از باطن libvirt استفاده کنید، libvirt اصلا کار نخواهد کرد
مگر اینکه $PATH حاوی مسیر qemu/KVM باشد.
SUPERMIN_KERNEL
SUPERMIN_KERNEL_VERSION
SUPERMIN_MODULES
این سه متغیر محیطی به هسته ای که libguestfs در آن استفاده می کند اجازه می دهد
وسیله ای که باید انتخاب شود اگر $SUPERMIN_KERNEL تنظیم نشده باشد، جدیدترین میزبان
هسته انتخاب شده است. برای اطلاعات بیشتر در مورد انتخاب هسته، رجوع کنید به سوپرمین(1).
TMPDIR
به "LIBGUESTFS_CACHEDIR"، "LIBGUESTFS_TMPDIR" مراجعه کنید.
با استفاده از خدمات onworks.net از guestfish آنلاین استفاده کنید