.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.56.0 (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 "virt-edit 1"
.TH virt-edit 1 2026-07-11 guestfs-tools-1.56.0 "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)"
virt\-edit \- ویرایش یک فایل در یک ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-edit [\-\-options] \-d domname file [file ...]
\&
\& virt\-edit [\-\-options] \-a disk.img [\-a disk.img ...] file [file ...]
\&
\& virt\-edit [\-d domname|\-a disk.img] file \-e \*(Aqexpr\*(Aq
.Ve
.PP
شیوه قدیمی:
.PP
.Vb 1
\& virt\-edit domname file
\&
\& virt\-edit disk.img [disk.img ...] file
.Ve.SH "هشدار (WARNING)"
.IX Header "WARNING"
استفاده از \f(CW\*(C`virt\-edit\*(C'\fR
روی ماشین‌های مجازی روشن و در حال اجرا، یا هم‌زمان با سایر
ابزارهای ویرایش دیسک، می‌تواند خطرناک باشد و به طور بالقوه موجب خرابی
دیسک شود. ماشین مجازی باید پیش از استفاده از این دستور خاموش شود،
و ایمیج‌های دیسک نباید به صورت هم‌زمان ویرایش شوند.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\f(CW\*(C`virt\-edit\*(C'\fR یک ابزار خط فرمانی برای ویرایش \f(CW\*(C`file\*(C'\fR است، به‌طوری که هر \f(CW\*(C`file\*(C'\fR
در ماشین مجازی مشخص‌شده (یا ایمیج دیسک) وجود دارد.
.PP
می‌توان چندین نام فایل را مشخص کرد که در این صورت هر یک به نوبت ویرایش
می‌شوند. هر نام فایل باید یک مسیر کامل باشد که از دایرکتوری ریشه
آغاز می‌شود (با \*(Aq/\*(Aq شروع می‌شود).
.PP
اگر تنها می‌خواهید فایلی را مشاهده کنید، از \fBvirt\-cat\fR\|(1) استفاده کنید.
.PP
برای موارد پیچیده‌تر باید ابزار \fBguestfish\fR\|(1) را بررسی کنید
(بخش «USING GUESTFISH» را در ادامه ببینید).
.PP
ابزار \&\f(CW\*(C`virt\-edit\*(C'\fR نمی‌تواند برای ایجاد یک فایل جدید استفاده شود. \fBguestfish\fR\|(1) می‌تواند
این کار و بسیار بیشتر از آن را انجام دهد.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
ویرایش تعاملی فایل‌های مشخص‌شده:
.PP
.Vb 1
\& virt\-edit \-d mydomain /boot/grub/grub.conf
\&
\& virt\-edit \-d mydomain /etc/passwd
.Ve
.PP
برای ماشین‌های مهمان ویندوز، برخی از مسیرهای ویندوزی نیز قابل درک هستند:
.PP
.Vb 1
\& virt\-edit \-d mywindomain \*(Aqc:\eautoexec.bat\*(Aq
.Ve
.PP
در صورت نصب بودن Perl، می‌توانید فایل‌ها را به صورت غیرتعاملی نیز ویرایش کنید (بخش
«NON\-INTERACTIVE EDITING» را در ادامه ببینید).
برای تغییر سطح پیش‌فرض init به ۵:
.PP
.Vb 1
\& virt\-edit \-d mydomain /etc/inittab \-e \*(Aqs/^id:.*/id:5:initdefault:/\*(Aq
.Ve
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنمای مختصر.
.IP "\fB\-a\fR file" 4
.IX Item "-a file"
.PD 0
.IP "\fB\-\-add\fR file" 4
.IX Item "--add file"
.PD
افزودن \fIfile\fR که باید یک ایمیج دیسک از ماشین مجازی باشد. اگر
ماشین مجازی دارای چندین دستگاه بلوکی است، باید همه آن‌ها را با گزینه‌های
مجزا \fI\-a\fR ارائه دهید.
.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
افزودن یک دیسک دوردست (remote). بخش «ADDING REMOTE STORAGE» در \fBguestfish\fR\|(1) را ببینید.
.IP "\fB\-b\fR EXTENSION" 4
.IX Item "-b EXTENSION"
.PD 0
.IP "\fB\-\-backup\fR EXTENSION" 4
.IX Item "--backup EXTENSION"
.PD
ایجاد یک نسخه پشتیبان از فایل اصلی \fIدر ایمیج دیسک سیستم‌عامل مهمان\fR.
فایل پشتیبان همان نام فایل اصلی را به همراه پسوند افزودهٔ \f(CW\*(C`extension\*(C'\fR خواهد داشت.
.Sp
معمولاً نخستین نویسه از \f(CW\*(C`extension\*(C'\fR یک نقطه \f(CW\*(C`.\*(C'\fR است،
بنابراین به این صورت می‌نویسید:
.Sp
.Vb 1
\& virt\-edit \-b .orig [etc]
.Ve
.Sp
به طور پیش‌فرض، هیچ فایل پشتیبانی ساخته نمی‌شود.
.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
در صورت استفاده از libvirt، به \fIURI\fR مشخص‌شده متصل می‌شود. در صورت حذف، به
هایپروایزر پیش‌فرض libvirt متصل خواهیم شد.
.Sp
اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید، به هیچ وجه از
libvirt استفاده نمی‌شود.
.IP "\fB\-d\fR GUEST" 4
.IX Item "-d GUEST"
.PD 0
.IP "\fB\-\-domain\fR GUEST" 4
.IX Item "--domain GUEST"
.PD
افزودن تمام دیسک‌ها از مهمان libvirt با نام مشخص‌شده. می‌توان از
UUIDهای دامنه نیز به جای نام استفاده کرد.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و گذرواژه‌ها، virt\-edit معمولاً بازتاب نویسه‌ها (echoing)
را غیرفعال می‌کند تا نتوانید آنچه را تایپ می‌کنید ببینید. اگر نگران
حملات تمپست (Tempest) نیستید و فرد دیگری در اتاق حضور ندارد، می‌توانید این
پرچم را مشخص کنید تا تایپ خود را ببینید.
.IP "\fB\-e\fR EXPR" 4
.IX Item "-e EXPR"
.PD 0
.IP "\fB\-\-edit\fR EXPR" 4
.IX Item "--edit EXPR"
.IP "\fB\-\-expr\fR EXPR" 4
.IX Item "--expr EXPR"
.PD
به جای اجرای ویرایشگر بیرونی، عبارت پرل \f(CW\*(C`EXPR\*(C'\fR را به صورت غیرتعاملی
بر روی تک‌تک خطوط فایل اعمال می‌کند.
بخش «NON\-INTERACTIVE EDITING» را در ادامه ببینید.
.Sp
دقت کنید که عبارت را به درستی درون نقل‌قول قرار دهید تا از
تغییر آن توسط پوسته (shell) جلوگیری شود.
.Sp
توجه داشته باشید که این گزینه تنها در صورتی در دسترس است که Perl 5 نصب باشد.
.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
برای نمونه:
.Sp
.Vb 1
\& virt\-edit \-\-format=raw \-a disk.img file
.Ve
.Sp
قالب raw را (بدون تشخیص خودکار) برای \fIdisk.img\fR اجباری می‌کند.
.Sp
.Vb 1
\& virt\-edit \-\-format=raw \-a disk.img \-\-format \-a another.img file
.Ve
.Sp
قالب raw را (بدون تشخیص خودکار) برای \fIdisk.img\fR اجباری کرده و به حالت
تشخیص خودکار برای \fIanother.img\fR بازمی‌گردد.
.Sp
اگر ایمیج‌های دیسک مهمان نامطمئن با قالب raw دارید، باید از این گزینه
برای تعیین قالب دیسک استفاده کنید. این کار از یک آسیب‌پذیری امنیتی بالقوه با
مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851).
.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
تعیین کلید برای LUKS، جهت باز کردن خودکار دستگاه LUKS هنگام استفاده از
وارسی (inspection).
.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). \f(CW\*(C`UUID\*(C'\fR نشان‌دهنده
UUID دستگاه است. \f(CW\*(C`all\*(C'\fR به معنی آزمایش کلید روی هر دستگاه
رمزگذاری‌شده است.
.Sp
از \f(CW\*(C`KEY_STRING\*(C'\fR مشخص‌شده به عنوان عبارت عبور (passphrase) استفاده کنید.
.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 به طور خودکار برای appliance مربوط به libguestfs فعال خواهد شد.
.RE
.RS 4
.RE
.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
خواندن پارامترهای کلید یا عبارت عبور از ورودی استاندارد (stdin). حالت پیش‌فرض،
تلاش برای خواندن عبارات عبور از کاربر با باز کردن \fI/dev/tty\fR است.
.Sp
اگر چندین دستگاه رمزگذاری‌شده وجود دارد، ممکن است لازم باشد چندین کلید
را در stdin ارائه دهید، هر کدام در یک سطر جداگانه.
.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
سوار کردن (mount) پارتیشن یا حجم منطقیِ (logical volume) نام‌برده بر روی نقطه اتصالِ داده‌شده.
.Sp
اگر نقطه اتصال مشخص نشود، مقدار پیش‌فرض آن \fI/\fR خواهد بود.
.Sp
مشخص کردن هر نقطه اتصالی، بازرسی مهمان (guest inspection) و
سوار شدن ریشه و تمامی نقاط اتصال آن را غیرفعال می‌کند؛ بنابراین مطمئن شوید
تمامی نقاط اتصالی را که برای کار با نام فایل‌های داده‌شده به عنوان آرگومان
نیاز است، سوار کنید.
.Sp
اگر نمی‌دانید یک تصویر دیسک شامل چه سیستم‌فایل‌هایی است، می‌توانید
guestfish را بدون این گزینه اجرا کرده و سپس فهرست پارتیشن‌ها، سیستم‌فایل‌ها
و LVهای موجود را بگیرید (دستورهای «list\-partitions»،
«list\-filesystems» و «lvs» را ببینید)، یا می‌توانید از
برنامه \&\fBvirt\-filesystems\fR\|(1) استفاده کنید.
.Sp
بخش سوم (و به‌ندرت استفاده‌شده) از پارامتر mount، فهرستی از
گزینه‌های سوار کردن است که برای سوار کردن سیستم‌فایل زیرین به کار می‌رود. اگر این
مورد مشخص نشود، گزینه‌های سوار کردن یا یک رشته خالی خواهند بود یا \f(CW\*(C`ro\*(C'\fR
(مورد دوم در حالتی است که پرچم \fI\-\-ro\fR استفاده شده باشد). با تعیین
گزینه‌های mount، این انتخاب پیش‌فرض را لغو می‌کنید. احتمالاً تنها زمانی از
این مورد استفاده خواهید کرد که بخواهید در صورت پشتیبانی سیستم‌فایل، ACLها و/یا
ویژگی‌های توسعه‌یافته (extended attributes) را فعال کنید:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
.Ve
.Sp
استفاده از این پرچم معادل استفاده از دستور \f(CW\*(C`mount\-options\*(C'\fR است.
.Sp
بخش چهارم پارامتر، گرداننده (driver) سیستم‌فایلی است که باید استفاده شود، مانند
\f(CW\*(C`ext3\*(C'\fR یا \f(CW\*(C`ntfs\*(C'\fR. به این بخش به‌ندرت نیاز می‌شود، اما در صورتی که
چندین درایور برای یک سیستم‌فایل معتبر باشند (مانند: \f(CW\*(C`ext2\*(C'\fR و \f(CW\*(C`ext3\*(C'\fR)
یا اگر libguestfs یک سیستم‌فایل را به اشتباه شناسایی کند، می‌تواند سودمند باشد.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال کردن پیام‌های پرجزئیات برای اشکال‌زدایی.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه و خروج.
.IP \fB\-x\fR 4
.IX Item "-x"
فعال کردن ردگیری فراخوانی‌های API در libguestfs..SH "آرگومان‌های خط فرمان سبک قدیم (OLD\-STYLE COMMAND LINE ARGUMENTS)"
.IX Header "OLD-STYLE COMMAND LINE ARGUMENTS"
نسخه‌های پیشین virt\-edit به شما امکان می‌دادند یکی از این دو حالت را بنویسید:
.PP
.Vb 1
\& virt\-edit disk.img [disk.img ...] file
.Ve
.PP
یا
.PP
.Vb 1
\& virt\-edit guestname file
.Ve
.PP
در حالی که در این نسخه باید به ترتیب از \fI\-a\fR یا \fI\-d\fR استفاده کنید
تا از حالت گیج‌کننده‌ای که ممکن است یک تصویر دیسک هم‌نام با یک ماشین مهمان باشد
جلوگیری شود.
.PP
به منظور سازگاری، سبک قدیمی همچنان پشتیبانی می‌شود.
.SH "ویرایش غیرتعاملی (NON\-INTERACTIVE EDITING)"
.IX Header "NON-INTERACTIVE EDITING"
دستور \&\f(CW\*(C`virt\-edit\*(C'\fR به طور معمول \f(CW$EDITOR\fR (یا vi) را فراخوانی می‌کند تا
مدیر سیستم بتواند فایل را به صورت تعاملی ویرایش کند.
.PP
همچنین دو روش برای استفاده از \&\f(CW\*(C`virt\-edit\*(C'\fR درون اسکریپت‌ها جهت
اعمال ویرایش‌های خودکار روی فایل‌ها وجود دارد. (توجه داشته باشید که اگرچه \fIمی‌توانید\fR از
\&\f(CW\*(C`virt\-edit\*(C'\fR به این شکل استفاده کنید، اما نوشتن مستقیم اسکریپت‌ها با استفاده از
API مربوط به libguestfs و ابزار Augeas برای ویرایش فایل‌های پیکربندی، کمتر مستعد خطا است.)
.PP
روش نخست این است که \f(CW$EDITOR\fR را موقتاً روی هر اسکریپت یا برنامه‌ای که می‌خواهید اجرا شود
تنظیم کنید. اسکریپت به شکل \f(CW\*(C`$EDITOR tmpfile\*(C'\fR فراخوانی می‌شود
و باید \f(CW\*(C`tmpfile\*(C'\fR را درجا به هر نحوی که می‌خواهد به‌روزرسانی کند.
.PP
روش دوم استفاده از پارامتر \fI\-e\fR در \f(CW\*(C`virt\-edit\*(C'\fR برای اجرای یک قطعه‌کد
کوتاه Perl به سبک \fBsed\fR\|(1) است. برای نمونه، جهت جایگزینی تمام موارد
\f(CW\*(C`foo\*(C'\fR با \f(CW\*(C`bar\*(C'\fR در یک فایل:
.PP
.Vb 1
\& virt\-edit \-d domname filename \-e \*(Aqs/foo/bar/\*(Aq
.Ve
.PP
تمام توانایی عبارت‌های منظم Perl قابل استفاده است (به
\&\fBperlre\fR\|(1) مراجعه کنید). برای نمونه، جهت حذف گذرواژه کاربر root می‌توانید بنویسید:
.PP
.Vb 1
\& virt\-edit \-d domname /etc/passwd \-e \*(Aqs/^root:.*?:/root::/\*(Aq
.Ve
.PP
آنچه در واقع رخ می‌دهد این است که قطعه‌کد به عنوان یک عبارت Perl برای هر خط
از فایل ارزیابی می‌شود. خط، شامل کاراکتر پایانی \&\f(CW\*(C`\en\*(C'\fR، در
\f(CW$_\fR ارسال می‌شود و عبارت باید \f(CW$_\fR را به‌روزرسانی کند یا
آن را بدون تغییر باقی بگذارد.
.PP
برای حذف یک خط، \f(CW$_\fR را برابر با رشته خالی قرار دهید. برای نمونه، جهت
حذف حساب کاربری \f(CW\*(C`apache\*(C'\fR از فایل گذرواژه می‌توانید دستور زیر را اجرا کنید:
.PP
.Vb 1
\& virt\-edit \-d mydomain /etc/passwd \-e \*(Aq$_ = "" if /^apache:/\*(Aq
.Ve
.PP
برای درج یک خط، آن را به ابتدا یا انتهای \f(CW$_\fR الحاق کنید. با این حال، افزودن
خطوط به انتهای فایل از این طریق نسبتاً دشوار است، چرا که مفهومی تحت عنوان
«آخرین خط فایل» وجود ندارد \- عبارت شما صرفاً دوباره فراخوانی نمی‌شود. اگر می‌خواهید
این کار را انجام دهید، ممکن است ترجیح دهید از روش اول (تنظیم \f(CW$EDITOR\fR) استفاده کنید.
.PP
متغیر \f(CW$lineno\fR حاوی شماره خط جاری است.
طبق سنت همیشگی، اولین خط فایل شماره \f(CW1\fR است.
.PP
مقدار بازگشتی از عبارت نادیده گرفته می‌شود، اما عبارت می‌تواند تابع \f(CW\*(C`die\*(C'\fR را
فراخوانی کند تا کل برنامه متوقف شود و فایل اصلی دست‌نخورده باقی بماند.
.PP
هنگام تطبیق انتهای خط به یاد داشته باشید که \f(CW$_\fR ممکن است حاوی \f(CW\*(C`\en\*(C'\fR
انتهایی، یا (برای فایل‌های DOS) حاوی \f(CW\*(C`\er\en\*(C'\fR باشد، یا اگر فایل به یک
خط جدید ختم نشود، هیچ‌کدام از این‌ها را نداشته باشد. بنابراین برای تطبیق یا
جایگزینی متنی در انتهای یک خط، از این عبارت منظم استفاده کنید:
.PP
.Vb 1
\& /some text(\er?\en)?$/
.Ve
.PP
یا به عنوان روش جایگزین، از تابع \f(CW\*(C`chomp\*(C'\fR در Perl استفاده کنید، با این احتیاط که
خود \f(CW$_\fR را chomp نکنید (زیرا این کار تمام خطوط جدید را از فایل حذف خواهد کرد):
.PP
.Vb 1
\& my $m = $_; chomp $m; $m =~ /some text$/
.Ve.SH "مسیرهای ویندوز (WINDOWS PATHS)"
.IX Header "WINDOWS PATHS"
دستور \&\f(CW\*(C`virt\-edit\*(C'\fR توانایی محدودی در درک حروف درایو و مسیرهای ویندوز (مانند \fIE:\efoo\ebar.txt\fR) دارد.
.PP
تنها و صرفاً اگر مهمان در حال اجرای ویندوز باشد، آن‌گاه:
.IP \(bu 4
پیشوندهای حرف درایو مانند \f(CW\*(C`C:\*(C'\fR با رجوع به رجیستری ویندوز (Windows Registry) به سیستم‌فایل صحیح تطبیق داده می‌شوند.
.IP \(bu 4
هر نویسهٔ بک‌اسلش (\f(CW\*(C`\e\*(C'\fR) در مسیر با یک اسلش رو به جلو جایگزین می‌شود تا libguestfs بتواند آن را پردازش کند.
.IP \(bu 4
مسیر بدون حساسیت به بزرگی و کوچکی حروف تطبیق داده می‌شود تا فایلی که باید ویرایش شود پیدا گردد.
.PP
برخی کاستی‌های شناخته‌شده وجود دارد:
.IP \(bu 4
ممکن است برخی از پیوندهای نمادین NTFS به درستی دنبال نشوند.
.IP \(bu 4
نقاط اتصال (junction points) در NTFS که در میان چند سیستم‌فایل قرار دارند دنبال نمی‌شوند.
.SH "استفاده از GUESTFISH (USING GUESTFISH)"
.IX Header "USING GUESTFISH"
ابزار \&\fBguestfish\fR\|(1) ابزاری قدرتمندتر و سطح‌پایین‌تر است که می‌توانید در صورت کار نکردن \f(CW\*(C`virt\-edit\*(C'\fR از آن استفاده کنید.
.PP
استفاده از \f(CW\*(C`virt\-edit\*(C'\fR تقریباً معادل اجرای دستور زیر است:
.PP
.Vb 1
\& guestfish \-\-rw \-i \-d domname edit /file
.Ve
.PP
که در آن \f(CW\*(C`domname\*(C'\fR نام ماشین مهمان libvirt، و \fI/file\fR مسیر کامل فایل است.
.PP
دستور بالا از قابلیت بازرسی مهمان (guest inspection) در libguestfs استفاده می‌کند و بنابراین روی مهمان‌هایی که libguestfs نمی‌تواند آن‌ها را بازرسی کند، یا مواردی چون ایمیج‌های دیسک دلخواهی که حاوی مهمان نیستند، کار نمی‌کند. برای ویرایش مستقیم یک فایل روی یک ایمیج دیسک، استفاده کنید از:
.PP
.Vb 1
\& guestfish \-\-rw \-a disk.img \-m /dev/sda1 edit /file
.Ve
.PP
که در آن \fIdisk.img\fR ایمیج دیسک، \fI/dev/sda1\fR سیستم‌فایل درون ایمیج دیسک برای ویرایش، و \fI/file\fR مسیر کامل فایل است.
.PP
دستور \&\f(CW\*(C`virt\-edit\*(C'\fR قادر به ایجاد فایل‌های جدید نیست. در عوض از دستورهای guestfish نظیر \&\f(CW\*(C`touch\*(C'\fR، \f(CW\*(C`write\*(C'\fR یا \f(CW\*(C`upload\*(C'\fR استفاده کنید:
.PP
.Vb 1
\& guestfish \-\-rw \-i \-d domname touch /newfile
\&
\& guestfish \-\-rw \-i \-d domname write /newfile "new content"
\&
\& guestfish \-\-rw \-i \-d domname upload localfile /newfile
.Ve
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
.ie n .IP """EDITOR""" 4
.el .IP \f(CWEDITOR\fR 4
.IX Item "EDITOR"
در صورت تعیین شدن، از این رشته به عنوان ویرایشگر استفاده می‌شود. ممکن است شامل آرگومان‌ها نیز باشد، مانند \f(CW"emacs \-nw"\fR
.Sp
اگر تعیین نشده باشد، از \f(CW\*(C`vi\*(C'\fR استفاده می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت، مقدار 0 و در صورت بروز خطا، مقداری غیرصفر برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBvirt\-cat\fR\|(1),
\&\fBvirt\-copy\-in\fR\|(1),
\&\fBvirt\-tar\-in\fR\|(1),
http://libguestfs.org,
\&\fBperl\fR\|(1),
\&\fBperlre\fR\|(1)..SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Richard W.M. Jones http://people.redhat.com/~rjones
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط «بنیاد نرم‌افزارهای آزاد» (Free Software Foundation) منتشر شده است؛ چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ متأخر دیگری، بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر «پروانه عمومی همگانی گنو» (GNU General Public License) را ببینید.
.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 را درون گزارش باگ قرار دهید.