.\" -*- 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 "libguestfs-tools.conf 5"
.TH libguestfs-tools.conf 5 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)"
libguestfs\-tools.conf \- پرونده پیکربندی برای ابزارهای libguestfs
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& /etc/libguestfs\-tools.conf
\&
\& $XDG_CONFIG_DIRS/libguestfs/libguestfs\-tools.conf
\&
\& $HOME/.libguestfs\-tools.rc
\&
\& $XDG_CONFIG_HOME/libguestfs/libguestfs\-tools.conf
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
پرونده
\&\fIlibguestfs\-tools.conf\fR
(یا
\&\fR\f(CI$HOME\fR\fI/.libguestfs\-tools.rc\fR)
تنها مقادیر پیش‌فرض برنامه‌های زیر را تغییر می‌دهد:
.IP \(bu 4
\&\fBguestfish\fR\|(1)
.IP \(bu 4
\&\fBguestmount\fR\|(1)
.IP \(bu 4
\&\fBvirt\-rescue\fR\|(1)
.PP
در حال حاضر تنها یک تنظیم وجود دارد که توسط این پرونده کنترل می‌شود. افزودن (یا از حالت کامنت خارج کردن):
.PP
.Vb 1
\& read_only = true;
.Ve
.PP
این برنامه‌ها را به‌گونه‌ای تغییر می‌دهد که گویی فلگ
\&\fI\-\-ro\fR
در خط فرمان مشخص شده است. می‌توانید از این گزینه برای ایمن‌سازی برنامه‌ها در برابر تغییرات ناخواسته در یک سیستم مهمان فعال استفاده کنید (کاربران برای تغییر دادن مهمان‌ها باید صراحتاً فلگ
\&\fI\-\-rw\fR
را اضافه کنند). این رفتار به دلیل عدم سازگاری با گذشته پیش‌فرض نیست.
همچنین بخش "OPENING DISKS FOR READ AND WRITE" را در
\&\fBguestfish\fR\|(1)
ببینید.
.PP
توجه داشته باشید که
\&\fBنقطه\-ویرگول الزامی است\fR.
.PP
این پرونده توسط کتابخانه libconfig تجزیه می‌شود. برای اطلاعات بیشتر درباره این قالب، پیوند زیر را ببینید:
http://www.hyperrealm.com/libconfig/libconfig_manual.html
.SH "محل پرونده (FILE LOCATION)"
.IX Header "FILE LOCATION"
ترتیب خوانده شدن پرونده‌های پیکربندی بر اساس اولویت به شرح زیر است:
.IP \(bu 4
\&\f(CW$XDG_CONFIG_HOME\fR/libguestfs/libguestfs\-tools.conf
(در صورت تعیین نشدن، مقدار
\&\f(CW$XDG_CONFIG_HOME\fR
برابر با
\&\fR\f(CI$HOME\fR\fI/.config\fR
است).
.IP \(bu 4
\&\f(CW$HOME\fR/.libguestfs\-tools.rc
.IP \(bu 4
\&\f(CW$XDG_CONFIG_DIRS\fR/libguestfs/libguestfs\-tools.conf
(که در آن
\&\f(CW$XDG_CONFIG_DIRS\fR
به معنای هر یک از دایرکتوری‌های موجود در این متغیر محیطی است، یا در صورت تعیین نشدن تنها
\&\fI/etc/xdg\fR)
.IP \(bu 4
/etc/libguestfs\-tools.conf
.PP
این بدان معناست که کاربران محلی می‌توانند با کپی کردن پرونده پیکربندی (یا ایجاد مجدد آن) در
\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/libguestfs/libguestfs\-tools.conf\fR،
پیکربندی سیستم را بازنویسی کنند.
.PP
مسیرهای
\&\fI/etc/libguestfs\-tools.conf\fR
و
\&\fR\f(CI$HOME\fR\fI/.libguestfs\-tools.rc\fR
مسیرهای قدیمی غیر XDG هستند که برای سازگاری با گذشته خوانده می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
"OPENING DISKS FOR READ AND WRITE" در \fBguestfish\fR\|(1)،
\&\fBguestmount\fR\|(1)،
\&\fBvirt\-rescue\fR\|(1)،
http://libguestfs.org،
http://standards.freedesktop.org/basedir\-spec/latest.
.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) 2011\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به دلخواه خود) هر نسخه بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.
.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 آن را در گزارش اشکال قرار دهید.