.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.60.1 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "guestmount 1"
.TH guestmount 1 2026-07-14 libguestfs-1.60.1 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
guestmount \- مونت کردن سیستم‌فایل‌های ماشین مجازی روی سیستم میزبان با FUSE و libguestfs
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& guestmount [\-\-options] \-a disk.img \-m device [\-\-ro] mountpoint
\&
\& guestmount [\-\-options] \-a disk.img \-i [\-\-ro] mountpoint
\&
\& guestmount [\-\-options] \-d Guest \-i [\-\-ro] mountpoint
.Ve
.SH "هشدار (WARNING)"
.IX Header "WARNING"
استفاده از
\f(CW\*(C`guestmount\*(C'\fR
در حالت نوشتنی روی ماشین‌های مجازی فعال و روشن، یا همزمان با سایر ابزارهای ویرایش دیسک، می‌تواند خطرناک باشد و به خرابی داده‌های دیسک منجر شود. ماشین مجازی باید پیش از استفاده از این دستور خاموش شود، و ایمیج‌های دیسک نباید به صورت همزمان ویرایش شوند.
.PP
در صورتی که ایمیج دیسک یا ماشین مجازی ممکن است روشن باشد، از گزینه
\fI\-\-ro\fR
(فقط‌خواندنی) استفاده کنید تا
\f(CW\*(C`guestmount\*(C'\fR
به صورت ایمن اجرا شود. در صورت اجرای همزمان با سایر تغییرات ممکن است نتایج عجیب یا ناهماهنگی مشاهده کنید، اما با این گزینه با خطر خرابی دیسک مواجه نخواهید شد.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامه guestmount برای مونت کردن سیستم‌فایل‌های ماشین‌های مجازی و سایر ایمیج‌های دیسک روی سیستم میزبان به کار می‌رود. این برنامه از libguestfs برای دسترسی به سیستم‌فایل ماشین مجازی، و از FUSE (سامانه سیستم‌فایل در فضای کاربری) برای نمایش آن به صورت یک دستگاه قابل مونت استفاده می‌کند.
.PP
در کنار سایر گزینه‌ها، باید دست‌کم یک دستگاه (گزینه
\fI\-a\fR\fR)
یا دامنه libvirt (گزینه
\fI\-d\fR\fR)،
و حداقل یک نقطه مونت (گزینه
\fI\-m\fR\fR)
مشخص کنید یا از گزینه بازرسی
\fI\-i\fR
استفاده نمایید. نحوه عملکرد این بخش در صفحه راهنمای
\fBguestfish\fR\|(1)
یا با مشاهده مثال‌های زیر بهتر توضیح داده شده است.
.PP
قابلیت FUSE امکان مونت کردن سیستم‌فایل‌ها را بدون دسترسی ریشه (non-root) فراهم می‌کند. نقطه مونت باید متعلق به شما باشد. سیستم‌فایل برای سایر کاربران قابل مشاهده نخواهد بود مگر اینکه تنظیمات را تغییر دهید؛ بخش «نکات» را در زیر ببینید.
.PP
برای آن‌مونت کردن سیستم‌فایل، از دستور
\fBguestunmount\fR\|(1)
استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای یک ماشین ویندوزی معمولی که سیستم‌فایل اصلی آن روی پارتیشن اول قرار دارد:
.PP
.Vb 1
\& guestmount \-a windows.img \-m /dev/sda1 \-\-ro /mnt
.Ve
.PP
برای یک ماشین لینوکسی معمولی که سیستم‌فایل ‎/boot آن روی پارتیشن اول و سیستم‌فایل ریشه روی یک حجم منطقی (LVM) است:
.PP
.Vb 1
\& guestmount \-a linux.img \-m /dev/VG/LV \-m /dev/sda1:/boot \-\-ro /mnt
.Ve
.PP
برای اینکه libguestfs نقاط مونت ماشین مجازی را به طور خودکار شناسایی کند:
.PP
.Vb 1
\& guestmount \-a guest.img \-i \-\-ro /mnt
.Ve
.PP
برای یک ماشین مجازی libvirt به نام "Guest" می‌توانید این‌گونه عمل کنید:
.PP
.Vb 1
\& guestmount \-d Guest \-i \-\-ro /mnt
.Ve
.PP
اگر نمی‌دانید چه سیستم‌فایل‌هایی درون یک ماشین یا ایمیج دیسک وجود دارد، ابتدا از
\fBvirt\-filesystems\fR\|(1)
استفاده کنید:
.PP
.Vb 1
\& virt\-filesystems \-d MyGuest
.Ve
.PP
اگر می‌خواهید فراخوانی‌های libguestfs را بدون اطلاعات دیباگ بیش از حد ردیابی کنید، دستور زیر پیشنهاد می‌شود:
.PP
.Vb 1
\& guestmount [...] \-\-trace /mnt
.Ve
.PP
اگر می‌خواهید برنامه را دیباگ کنید، پیشنهاد می‌شود:
.PP
.Vb 1
\& guestmount [...] \-\-trace \-\-verbose /mnt
.Ve
.PP
برای آن‌مونت کردن سیستم‌فایل پس از اتمام استفاده:
.PP
.Vb 1
\& guestunmount /mnt
.Ve
.SH "نکات (NOTES)"
.IX Header "NOTES"
.SS "به‌طور پیش‌فرض سایر کاربران نمی‌توانند سیستم‌فایل را ببینند"
.IX Subsection "Other users cannot see the filesystem by default"
اگر سیستم‌فایلی را با یک کاربر (مثلاً root) مونت کنید، سایر کاربران به طور پیش‌فرض قادر به مشاهده آن نخواهند بود. راه حل اضافه کردن گزینه FUSE به نام
\&\f(CW\*(C`allow_other\*(C'\fR
هنگام مونت کردن است:
.PP
.Vb 1
\& sudo guestmount [...] \-o allow_other /mnt
.Ve
.PP
\&\fBو\fR
فعال‌سازی این گزینه در فایل
\fI/etc/fuse.conf\fR.
.SS "فعال‌سازی FUSE"
.IX Subsection "Enabling FUSE"
در برخی از توزیع‌ها، ممکن است لازم باشد پیش از استفاده از هر سیستم‌فایل FUSE، خود را به گروه خاصی (مانند
\f(CW\*(C`fuse\*(C'\fR\fR)
اضافه کنید. این کار در دبیان و توزیع‌های مشتق از آن ضروری است.
.PP
در سایر توزیع‌ها به گروه خاصی نیاز نیست. در فدورا یا Red Hat Enterprise Linux نیازی به این کار نیست.
.SS "خطای fusermount: ""Device or resource busy"""
.IX Subsection "fusermount error: ""Device or resource busy"""
ممکن است زمانی این خطا را مشاهده کنید که پردازش دیگری روی سیستم وارد نقطه مونتی که تازه ایجاد کرده‌اید شده و آن را باز نگه داشته باشد و مانع از آن‌مونت شدن آن شود. عامل معمول این مشکل برنامه‌های مختلف «نمایه‌سازی» (indexing) در محیط گرافیکی هستند.
.PP
راهکار متداول برای این مشکل، تکرار چندباره دستور
\f(CW\*(C`fusermount \-u\*(C'\fR
است تا در نهایت با موفقیت انجام شود (دستور
\fBguestunmount\fR\|(1)
این کار را به صورت خودکار برای شما انجام می‌دهد). متأسفانه این راهکار همیشه قابل اعتماد نیست؛ برای نمونه زمانی که سیستم‌فایل مونت‌شده بسیار بزرگ باشد و برنامه مداخله‌گر با سرسختی به کار خود ادامه دهد.
.PP
راه حل اصولی، استفاده از یک نقطه مونت خصوصی با ایجاد یک فضای نام مونت (mount namespace) جدید با استفاده از فلگ مخصوص لینوکس
\&\f(CW\*(C`CLONE_NEWNS\*(C'\fR
در
\fBclone\fR\|(2)/\fBunshare\fR\|(2)
است. متأسفانه در حال حاضر این کار نیاز به دسترسی ریشه دارد و احتمالاً باید به عنوان یک ویژگی به guestmount اضافه شود.
.SS "احتمال بروز شرایط رقابت هنگام قطع اتصال"
.IX Subsection "Race conditions possible when shutting down the connection"
هنگامی که دستور
\fBguestunmount\fR\|(1)/\fBfusermount\fR\|(1)
خاتمه می‌یابد، ممکن است guestmount هنوز در حال اجرا و پاک‌سازی نقطه مونت باشد. در این حالت ایمیج دیسک هنوز کاملاً نهایی و تثبیت نشده است.
.PP
این بدان معناست که اسکریپت‌هایی مانند نمونه زیر دارای شرایط رقابت (race condition) خطرناکی هستند:
.PP
.Vb 4
\& guestmount \-a disk.img \-i /mnt
\& # کپی کردن فایل‌ها به درون /mnt
\& guestunmount /mnt
\& # تلاش فوری برای استفاده از 'disk.img' ** ناایمن **
.Ve
.PP
راه حل استفاده از گزینه
\fI\-\-pid\-file\fR
برای نوشتن شناسه پردازش (PID) دستور guestmount در یک فایل است، و سپس پس از guestunmount، منتظر ماندن در یک حلقه تا زمان خروج این PID است.
.PP
.Vb 1
\& guestmount \-a disk.img \-i \-\-pid\-file guestmount.pid /mnt
\&
\& # ...
\& # ...
\&
\& # ذخیره شناسه پردازش guestmount *پیش* از فراخوانی guestunmount.
\& pid="$(cat guestmount.pid)"
\&
\& # آن‌مونت کردن سیستم‌فایل.
\& guestunmount /mnt
\&
\& timeout=10
\&
\& count=$timeout
\& while kill \-0 "$pid" 2>/dev/null && [ $count \-gt 0 ]; do
\&     sleep 1
\&     ((count\-\-))
\& done
\& if [ $count \-eq 0 ]; then
\&     echo "$0: wait for guestmount to exit failed after $timeout seconds"
\&     exit 1
\& fi
\&
\& # اکنون استفاده از ایمیج دیسک ایمن است.
.Ve
.PP
توجه داشته باشید که اگر مستقیماً از رابط برنامه‌نویسی
\f(CW\*(C`guestfs_mount_local\*(C'\fR
استفاده کنید (بخش "MOUNT LOCAL" در
\fBguestfs\fR\|(3)
را ببینید)، نوشتن برنامه‌ای ایمن و عاری از شرایط رقابت بسیار ساده‌تر خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-a\fR IMAGE" 4
.IX Item "-a IMAGE"
.PD 0
.IP "\fB\-\-add\fR IMAGE" 4
.IX Item "--add IMAGE"
.PD
افزودن یک دستگاه بلوکی یا ایمیج ماشین مجازی.
.Sp
فرمت ایمیج دیسک به طور خودکار تشخیص داده می‌شود. برای لغو این حالت و اجبار به استفاده از یک فرمت خاص، از گزینه
\fI\-\-format=..\fR
استفاده کنید.
.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
افزودن یک دیسک دوردست. بخش "ADDING REMOTE STORAGE" را در
\fBguestfish\fR\|(1)
ببینید.
.IP \fB\-\-blocksize=512\fR 4
.IX Item "--blocksize=512"
.PD 0
.IP \fB\-\-blocksize=4096\fR 4
.IX Item "--blocksize=4096"
.IP \fB\-\-blocksize\fR 4
.IX Item "--blocksize"
.PD
این پارامتر اندازه سکتور ایمیج دیسک را تعیین می‌کند. این مقدار بر تمامی دیسک‌هایی که پس از این پارامتر به صورت صریح اضافه شوند تأثیر می‌گذارد. استفاده از
\&\fI\-\-blocksize\fR
بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است تغییر می‌دهد. همچنین به "guestfs_add_drive_opts" در
\fBguestfs\fR\|(3)
مراجعه کنید.
.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
هنگامی که همراه با گزینه
\fI\-d\fR
استفاده شود، نشانی اینترنتی (URI) اتصال libvirt را مشخص می‌کند. حالت پیش‌فرض استفاده از اتصال پیش‌فرض libvirt است.
.IP "\fB\-d\fR LIBVIRT\-DOMAIN" 4
.IX Item "-d LIBVIRT-DOMAIN"
.PD 0
.IP "\fB\-\-domain\fR LIBVIRT\-DOMAIN" 4
.IX Item "--domain LIBVIRT-DOMAIN"
.PD
افزودن دیسک‌ها از دامنه نام‌برده libvirt. اگر از گزینه
\fI\-\-ro\fR
نیز استفاده شود، می‌توان هر دامنه libvirt را مشخص کرد. با این حال در حالت نوشتنی، فقط دامنه‌های libvirt که خاموش هستند می‌توانند در اینجا نام برده شوند.
.Sp
به جای نام‌ها می‌توان از UUID دامنه‌ها نیز استفاده کرد.
.IP "\fB\-\-dir\-cache\-timeout\fR N" 4
.IX Item "--dir-cache-timeout N"
تنظیم مدت زمان انقضای حافظه موقت (کش) readdir بر حسب \fIN\fR ثانیه که پیش‌فرض آن ۶۰ ثانیه است. کش readdir [در واقع چندین کش نیمه‌مستقل وجود دارد] پس از فراخوانی
\fBreaddir\fR\|(2)
با اطلاعات stat و ویژگی‌های گسترش‌یافته فایل‌های درون دایرکتوری پر می‌شود، با این فرض که به زودی مورد درخواست قرار خواهند گرفت.
.Sp
کش ویژگی دیگری نیز وجود دارد که توسط FUSE پیاده‌سازی شده است (گزینه FUSE به نام
\fI\-o attr_timeout\fR
را ببینید)، اما کش FUSE درخواست‌های آتی را پیش‌بینی نمی‌کند و فقط موارد موجود را کش می‌کند.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و گذرواژه‌ها، guestfish معمولاً نمایش کاراکترها را غیرفعال می‌کند تا آنچه تایپ می‌کنید دیده نشود. اگر نگران حملات تمپست (Tempest) نیستید و فرد دیگری در اتاق حضور ندارد، می‌توانید این گزینه را مشخص کنید تا آنچه تایپ می‌کنید را ببینید.
.IP \fB\-\-fd=\fRFD 4
.IX Item "--fd=FD"
مشخص کردن توصیف‌کننده فایل پایپ یا eventfd. هنگامی که نقطه مونت آماده استفاده باشد، guestmount یک بایت منفرد در این توصیف‌کننده فایل می‌نویسد. این گزینه می‌تواند همراه با
\fI\-\-no\-fork\fR
استفاده شود تا guestmount زیر نظر پردازش دیگری اجرا شود.
.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
حالت پیش‌فرض برای گزینه
\fI\-a\fR
تشخیص خودکار فرمت ایمیج دیسک است. استفاده از این گزینه، فرمت دیسک را برای گزینه‌های
\fI\-a\fR
که پس از آن در خط فرمان می‌آیند اجبار می‌کند. استفاده از
\fI\-\-format\fR
بدون آرگومان، وضعیت را به تشخیص خودکار برای گزینه‌های
\fI\-a\fR
بعدی بازمی‌گرداند.
.Sp
اگر ایمیج‌های دیسک خام (raw) با منبع غیرقابل اعتماد دارید، باید از این گزینه برای مشخص کردن فرمت دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی توسط ماشین‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851). همچنین به "guestfs_add_drive_opts" در
\fBguestfs\fR\|(3)
مراجعه کنید.
.IP \fB\-\-fuse\-help\fR 4
.IX Item "--fuse-help"
نمایش راهنمای گزینه‌های ویژه FUSE (به
\fI\-o\fR
در زیر مراجعه کنید).
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنمای مختصر و خروج.
.IP \fB\-i\fR 4
.IX Item "-i"
.PD 0
.IP \fB\-\-inspector\fR 4
.IX Item "--inspector"
.PD
با استفاده از کدهای
\fBvirt\-inspector\fR\|(1)،
دیسک‌ها را برای یافتن سیستم‌عامل بازرسی کرده و سیستم‌فایل‌ها را همان‌گونه که روی ماشین مجازی واقعی مونت می‌شدند، مونت می‌کند.
.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
مشخص کردن یک کلید برای LUKS، جهت بازگشایی خودکار دستگاه رمزنگاری‌شده LUKS هنگام استفاده از بازرسی.
.RS 4
.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
.IX Item "--key NAME:key:KEY_STRING"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
.IX Item "--key UUID:key:KEY_STRING"
.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
.IX Item "--key all:key:KEY_STRING"
.PD
\&\f(CW\*(C`NAME\*(C'\fR
نام دستگاه در libguestfs است (مانند
\f(CW\*(C`/dev/sda1\*(C'\fR\fR).
\&\f(CW\*(C`UUID\*(C'\fR
شناسه یکتای دستگاه (UUID) است.
\&\f(CW\*(C`all\*(C'\fR
به معنای آزمودن کلید روی تمامی دستگاه‌های رمزنگاری‌شده است.
.Sp
استفاده از
\f(CW\*(C`KEY_STRING\*(C'\fR
مشخص‌شده به عنوان گذرواژه.
.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
.IX Item "--key NAME:file:FILENAME"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
.IX Item "--key UUID:file:FILENAME"
.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
.IX Item "--key all:file:FILENAME"
.PD
خواندن گذرواژه از فایل
\fIFILENAME\fR.
.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
.IX Item "--key NAME:clevis"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
.IX Item "--key UUID:clevis"
.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
.IX Item "--key all:clevis"
.PD
تلاش برای بازگشایی بدون گذرواژه دستگاه از طریق Clevis روی شبکه. لطفاً برای اطلاعات بیشتر درباره رمزنگاری دیسک مبتنی بر شبکه (NBDE) به بخش "ENCRYPTED DISKS" در
\fBguestfs\fR\|(3)
مراجعه کنید.
.Sp
توجه داشته باشید که در صورت وجود چنین گزینه‌ای در خط فرمان، شبکه کاربری QEMU به طور خودکار برای تجهیزات libguestfs فعال خواهد شد.
.RE
.RS 4
.RE
.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
خواندن پارامترهای کلید یا گذرواژه از ورودی استاندارد (stdin). حالت پیش‌فرض تلاش برای خواندن گذرواژه‌ها از کاربر با باز کردن
\fI/dev/tty\fR
است.
.Sp
اگر چند دستگاه رمزنگاری‌شده وجود داشته باشد، ممکن است نیاز باشد چندین کلید را در ورودی استاندارد، هر کدام در یک خط وارد کنید.
.IP "\fB\-m\fR dev[:mountpoint[:options[:fstype]]" 4
.IX Item "-m dev[:mountpoint[:options[:fstype]]"
.PD 0
.IP "\fB\-\-mount\fR dev[:mountpoint[:options[:fstype]]]" 4
.IX Item "--mount dev[:mountpoint[:options[:fstype]]]"
.PD
مونت کردن پارتیشن یا حجم منطقی نام‌برده روی نقطه مونت مشخص‌شده
\&\fBدرون ماشین مجازی\fR
(این مورد ارتباطی با نقاط مونت در سیستم میزبان ندارد).
.Sp
در صورت حذف نقطه مونت، مقدار پیش‌فرض آن
\fI/\fR
خواهد بود. شما باید حتماً چیزی را روی
\fI/\fR
مونت کنید.
.Sp
بخش سوم (که به ندرت استفاده می‌شود) از پارامتر mount، فهرست گزینه‌های مونت مورد استفاده برای سیستم‌فایل زیرین است. اگر این بخش مشخص نشود، گزینه‌های مونت یا رشته خالی یا
\f(CW\*(C`ro\*(C'\fR
خواهد بود (مورد اخیر در صورتی است که فلگ
\fI\-\-ro\fR
استفاده شده باشد). با تعیین گزینه‌های مونت، این انتخاب پیش‌فرض را لغو می‌کنید. احتمالاً تنها زمانی از این گزینه استفاده می‌کنید که بخواهید در صورت پشتیبانی سیستم‌فایل، ACLها یا ویژگی‌های گسترش‌یافته را فعال کنید:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
.Ve
.Sp
بخش چهارم پارامتر، درایور سیستم‌فایل مورد استفاده است، مانند
\f(CW\*(C`ext3\*(C'\fR
یا
\f(CW\*(C`ntfs\*(C'\fR\fR.
این بخش به ندرت نیاز می‌شود، اما زمانی مفید است که چندین درایور برای یک سیستم‌فایل معتبر باشند (مانند:
\f(CW\*(C`ext2\*(C'\fR
و
\f(CW\*(C`ext3\*(C'\fR\fR)،
یا اگر libguestfs سیستم‌فایل را اشتباه تشخیص دهد.
.IP \fB\-\-no\-fork\fR 4
.IX Item "--no-fork"
عدم اجرای پس‌زمینه (یا عدم انشعاب به صورت دیمن در پس‌زمینه).
.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
.IP \fB\-\-no\-sync\fR 4
.IX Item "--no-sync"
.PD
به طور پیش‌فرض، هنگام آن‌مونت شدن نقطه مونت FUSE، تلاش می‌کنیم دیسک ماشین مجازی را همگام‌سازی (sync) کنیم. اگر این گزینه را مشخص کنید، تلاشی برای همگام‌سازی دیسک انجام نخواهد شد. به توضیحات autosync در صفحه راهنمای
\fBguestfs\fR\|(3)
مراجعه کنید.
.IP "\fB\-o\fR OPTION" 4
.IX Item "-o OPTION"
.PD 0
.IP "\fB\-\-option\fR OPTION" 4
.IX Item "--option OPTION"
.PD
ارسال گزینه‌های اضافی به FUSE.
.Sp
برای دریافت فهرست تمامی گزینه‌های اضافی پشتیبانی‌شده توسط FUSE، از دستور زیر استفاده کنید. توجه داشته باشید که تنها گزینه‌های
\fI\-o\fR
مربوط به FUSE قابل ارسال هستند، و تنها استفاده از برخی از آن‌ها ایده خوبی است.
.Sp
.Vb 1
\& guestmount \-\-fuse\-help
.Ve
.Sp
برخی از گزینه‌های بالقوه مفید FUSE:
.RS 4
.IP "\fB\-o\fR \fBallow_other\fR" 4
.IX Item "-o allow_other"
اجازه به سایر کاربران برای مشاهده سیستم‌فایل. این گزینه هیچ تأثیری ندارد مگر اینکه آن را به صورت سراسری در
\fI/etc/fuse.conf\fR
فعال کرده باشید.
.IP "\fB\-o\fR \fBattr_timeout=N\fR" 4
.IX Item "-o attr_timeout=N"
فعال‌سازی کش ویژگی‌ها توسط FUSE و تنظیم مدت زمان انقضا به \fIN\fR ثانیه.
.IP "\fB\-o\fR \fBkernel_cache\fR" 4
.IX Item "-o kernel_cache"
اجازه به هسته برای کش کردن فایل‌ها (کاهش تعداد خواندن‌هایی که باید از طریق رابط کاربری
\fBguestfs\fR\|(3)
انجام شوند). این کار عموماً ایده خوبی است در صورتی که بتوانید حافظه مصرفی اضافه را تأمین کنید.
.IP "\fB\-o\fR \fBuid=N\fR \fB\-o\fR \fBgid=N\fR" 4
.IX Item "-o uid=N -o gid=N"
استفاده از این گزینه‌ها برای نگاشت تمامی UIDها و GIDهای درون سیستم‌فایل ماشین مجازی به مقادیر انتخاب‌شده.
.IP "\fB\-o\fR \fBuse_ino\fR" 4
.IX Item "-o use_ino"
حفظ شماره‌های اینود (inode) از سیستم‌فایل زیرین.
.Sp
بدون این گزینه، FUSE شماره‌های اینود اختصاصی خود را تولید می‌کند. شماره‌های اینودی که در
\fBstat\fR\|(2)،
\f(CW\*(C`ls \-i\*(C'\fR
و غیره می‌بینید، شماره‌های اینود سیستم‌فایل زیرین نخواهند بود.
.Sp
\&\fBتوجه\fR
این گزینه در صورتی که سیستم‌فایل زیرین شامل چندین نقطه مونت باشد بالقوه خطرناک است، زیرا ممکن است شماره‌های اینود تکراری از طریق FUSE مشاهده شوند. استفاده از این گزینه می‌تواند برخی نرم‌افزارها را دچار سردرگمی کند.
.RE
.RS 4
.RE
.IP "\fB\-\-pid\-file\fR FILENAME" 4
.IX Item "--pid-file FILENAME"
نوشتن شناسه پردازش (PID) پردازش کارگر guestmount در
\f(CW\*(C`filename\*(C'\fR.
.IP \fB\-r\fR 4
.IX Item "-r"
.PD 0
.IP \fB\-\-ro\fR 4
.IX Item "--ro"
.PD
افزودن دستگاه‌ها و مونت کردن همه‌چیز به صورت فقط‌خواندنی. همچنین نوشتن را ممنوع کرده و دیسک را برای FUSE به صورت فقط‌خواندنی نمایش می‌دهد.
.Sp
در صورتی که قصد ویرایش دیسک ماشین مجازی را ندارید، استفاده از این گزینه به شدت توصیه می‌شود. اگر ماشین مجازی در حال اجرا باشد و این گزینه ارائه
\fIنشود\fR\fR،
خطر جدی خرابی دیسک در ماشین وجود خواهد داشت. ما تلاش می‌کنیم از این اتفاق جلوگیری کنیم، اما همیشه امکان‌پذیر نیست.
.Sp
همچنین به بخش "OPENING DISKS FOR READ AND WRITE" در
\fBguestfish\fR\|(1)
مراجعه کنید.
.IP \fB\-\-selinux\fR 4
.IX Item "--selinux"
این گزینه برای سازگاری با نسخه‌های پیشین فراهم شده و کاری انجام نمی‌دهد.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال‌سازی پیام‌های پرجزئیات از libguestfs زیرین.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش نسخه برنامه و خروج.
.IP \fB\-w\fR 4
.IX Item "-w"
.PD 0
.IP \fB\-\-rw\fR 4
.IX Item "--rw"
.PD
این گزینه عملکرد گزینه‌های
\fI\-a\fR\fR،
\fI\-d\fR
و
\fI\-m\fR
را تغییر می‌دهد تا دیسک‌ها به صورت خواندنی\-نوشتنی اضافه و مونت شوند.
.Sp
به بخش "OPENING DISKS FOR READ AND WRITE" در
\fBguestfish\fR\|(1)
مراجعه کنید.
.IP \fB\-x\fR 4
.IX Item "-x"
.PD 0
.IP \fB\-\-trace\fR 4
.IX Item "--trace"
.PD
ردیابی فراخوانی‌های libguestfs و ورود به هر تابع FUSE.
.Sp
این گزینه همچنین از رفتن دیمن به پس‌زمینه جلوگیری می‌کند (گزینه
\fI\-\-no\-fork\fR
را ببینید).
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.ie n .IP $XDG_CONFIG_HOME/libguestfs/libguestfs\-tools.conf 4
.el .IP \f(CW$XDG_CONFIG_HOME\fR/libguestfs/libguestfs\-tools.conf 4
.IX Item "$XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf"
.PD 0
.ie n .IP $HOME/.libguestfs\-tools.rc 4
.el .IP \f(CW$HOME\fR/.libguestfs\-tools.rc 4
.IX Item "$HOME/.libguestfs-tools.rc"
.ie n .IP $XDG_CONFIG_DIRS/libguestfs/libguestfs\-tools.conf 4
.el .IP \f(CW$XDG_CONFIG_DIRS\fR/libguestfs/libguestfs\-tools.conf 4
.IX Item "$XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf"
.IP /etc/libguestfs\-tools.conf 4
.IX Item "/etc/libguestfs-tools.conf"
.PD
این فایل پیکربندی حالت پیش‌فرض فقط‌خواندنی یا خواندنی\-نوشتنی را کنترل می‌کند
(\fI\-\-ro\fR
یا
\fI\-\-rw\fR\fR).
.Sp
به
\fBlibguestfs\-tools.conf\fR\|(5)
مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت مقدار 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestunmount\fR\|(1),
\&\fBfusermount\fR\|(1),
\&\fBguestfish\fR\|(1),
\&\fBvirt\-inspector\fR\|(1),
\&\fBvirt\-cat\fR\|(1),
\&\fBvirt\-edit\fR\|(1),
\&\fBvirt\-tar\fR\|(1),
\&\fBlibguestfs\-tools.conf\fR\|(5),
"MOUNT LOCAL" in \fBguestfs\fR\|(3),
http://libguestfs.org,
http://fuse.sf.net
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Richard W.M. Jones (\f(CW\*(C`rjones at redhat dot com\*(C'\fR)
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نسخه ۲ مجوز و یا (به انتخاب خودتان) هر نسخه پس از آن، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به نشانی زیر مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
برای دریافت فهرستی از اشکالات ثبت‌شده برای libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
هنگام گزارش یک اشکال، لطفاً موارد زیر را ارائه دهید:
.IP \(bu 4
نسخه libguestfs.
.IP \(bu 4
محلی که libguestfs را از آن دریافت کرده‌اید (مانند توزیع لینوکس، کامپایل‌شده از سورس، و غیره).
.IP \(bu 4
توصیف دقیق اشکال و ارائه راهی برای بازتولید آن.
.IP \(bu 4
دستور
\fBlibguestfs\-test\-tool\fR\|(1)
را اجرا کرده و خروجی \fBکامل و دست‌نخورده\fR آن را درون گزارش اشکال قرار دهید.