.\" -*- 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-diff 1"
.TH virt-diff 1 2026-07-11 guestfs-tools-1.56.0 "پشتیبانی از مجازی‌سازی"
.\" 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\-diff \- مقایسه تغییرات فایل‌ها در دو ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-diff [\-\-options] \-d domain1 \-D domain2
\&
\& virt\-diff [\-\-options] \-a disk1.img [\-a ...] \-A disk2.img [\-A ...]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\f(CW\*(C`virt\-diff\*(C'\fR
فهرست تفاوت‌های میان فایل‌ها را در دو ماشین مجازی یا ایمیج دیسک نمایش می‌دهد. کاربرد معمول آن نمایش تغییرات در یک ماشین مجازی پس از مدتی اجرا است؛ بدین صورت که ابتدا یک اسنپ‌شات گرفته می‌شود، ماشین مجازی اجرا می‌گردد و سپس با استفاده از این ابزار تغییرات میان وضعیت جدید ماشین مجازی و اسنپ‌شات قدیمی بررسی می‌شود.
.PP
این ابزار تفاوت‌ها در نام فایل‌ها، اندازه، جمع‌های کنترلی (checksums)، ویژگی‌های گسترش‌یافته (extended attributes)، محتوای فایل و موارد دیگر را در یک ماشین مجازی یا ایمیج دیسک پیدا می‌کند. با این حال، این ابزار بوت‌لودر، فضای استفاده‌نشده میان پارتیشن‌ها یا داخل فایل‌سیستم‌ها، سکتورهای مخفی و موارد مشابه را بررسی \fBنمی‌کند\fR. به عبارت دیگر، این ابزار یک ابزار امنیتی یا جرم‌یابی قانونی دیجیتال (forensics) نیست.
.PP
برای مشخص کردن دو سیستم مهمان، باید از گزینه‌های
.I \-a
یا
.I \-d
برای مهمان اول، و از گزینه‌های
.I \-A
یا
.I \-D
برای مهمان دوم استفاده کنید. حالت رایج به صورت زیر است:
.PP
.Vb 1
\& virt\-diff \-a old.img \-A new.img
.Ve
.PP
یا با استفاده از نام‌های شناخته‌شده در libvirt:
.PP
.Vb 1
\& virt\-diff \-d oldguest \-D newguest
.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
افزودن
.I file
که باید یک ایمیج دیسک از اولین ماشین مجازی باشد. اگر ماشین مجازی دارای چندین دستگاه بلوکی باشد، باید همه آن‌ها را با گزینه‌های مجزای
.I \-a
مشخص کنید.
.Sp
قالب ایمیج دیسک به طور خودکار تشخیص داده می‌شود. برای لغو این رفتار و تحمیل یک قالب خاص از گزینه
.I \-\-format=..
استفاده کنید.
.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" در
.BR guestfish (1)
را ببینید.
.IP \fB\-\-all\fR 4
.IX Item "--all"
معادل استفاده همزمان از
.IR \-\-extra\-stats ,
.IR \-\-times ,
.I \-\-uids
و
.IR \-\-xattrs .
.IP \fB\-\-atime\fR 4
.IX Item "--atime"
حالت پیش‌فرض نادیده گرفتن تغییرات در زمان دسترسی به فایل‌ها (atime) است، زیرا معمولاً اهمیت چندانی ندارند. استفاده از این فلگ تفاوت‌های atime را نیز نمایش می‌دهد.
.IP "\fB\-A\fR file" 4
.IX Item "-A file"
.PD 0
.IP "\fB\-A\fR URI" 4
.IX Item "-A URI"
.PD
افزودن یک ایمیج دیسک از دومین ماشین مجازی.
.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
این پارامتر اندازه سکتور ایمیج دیسک را تعیین می‌کند. این مقدار روی تمام دیسک‌هایی که پس از این پارامتر مشخص می‌شوند تاثیر می‌گذارد. استفاده از
.I \-\-blocksize
بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است بازمی‌گرداند. همچنین "guestfs_add_drive_opts" در
.BR guestfs (3)
را ببینید.
.IP \fB\-\-checksum\fR 4
.IX Item "--checksum"
.PD 0
.IP \fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
استفاده از جمع کنترلی (checksum) روی محتوای فایل‌ها برای تشخیص تغییر در محتوای فایل‌های معمولی.
.Sp
بدون آرگومان، مقدار پیش‌فرض
.I md5
است. با تعیین آرگومان می‌توانید نوع جمع کنترلی مورد نظر را انتخاب کنید. در صورت عدم استفاده از این فلگ، از زمان‌ها و اندازه فایل برای تعیین تغییر فایل استفاده می‌شود.
.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
در صورت استفاده از libvirt، به
.I URI
داده‌شده متصل می‌شود. در صورت عدم تعیین، به هایپروایزر پیش‌فرض libvirt متصل خواهد شد.
.Sp
اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید
.RB ( \-a )،
به هیچ وجه از libvirt استفاده نمی‌شود.
.IP \fB\-\-csv\fR 4
.IX Item "--csv"
نوشتن نتایج در قالب CSV (مقادیر جداشده با کاما). این قالب را می‌توان به سادگی در پایگاه‌های داده و صفحات گسترده وارد کرد، اما بخش "نکته‌ای درباره قالب CSV" در ادامه را مطالعه کنید.
.IP \fB\-\-dir\-links\fR 4
.IX Item "--dir-links"
حالت پیش‌فرض نادیده گرفتن تغییرات در تعداد پیوندهای ورودی‌های دایرکتوری است، زیرا معمولاً اهمیت چندانی ندارند. استفاده از این فلگ تغییرات فیلد nlink دایرکتوری‌ها را نشان می‌دهد.
.IP \fB\-\-dir\-times\fR 4
.IX Item "--dir-times"
حالت پیش‌فرض نادیده گرفتن تغییر زمان در ورودی‌های دایرکتوری است، زیرا معمولاً اهمیت چندانی ندارند. استفاده از این فلگ تغییرات فیلدهای زمانی دایرکتوری‌ها را نشان می‌دهد.
.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\-D\fR guest" 4
.IX Item "-D guest"
افزودن تمام دیسک‌های مهمان نام‌برده‌شده در libvirt به عنوان دومین مهمان. به جای نام می‌توان از UUID دامین نیز استفاده کرد.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و گذرواژه‌ها، virt\-diff به طور معمول بازتاب کاراکترها (echo) را خاموش می‌کند تا آنچه را تایپ می‌کنید نبینید. اگر نگران حملات تمپست (Tempest attacks) نیستید و فرد دیگری در اتاق حضور ندارد، می‌توانید از این گزینه برای مشاهده کاراکترهای تایپ‌شده استفاده کنید.
.IP \fB\-\-extra\-stats\fR 4
.IX Item "--extra-stats"
نمایش آمار و اطلاعات اضافی.
.IP \fB\-\-format=raw|qcow2|..\fR 4
.IX Item "--format=raw|qcow2|.."
.PD 0
.IP \fB\-\-format\fR 4
.IX Item "--format"
.PD
حالت پیش‌فرض برای گزینه‌های
.IR \-a / \-A
تشخیص خودکار قالب ایمیج دیسک است. استفاده از این گزینه قالب دیسک را برای گزینه‌های
.IR \-a / \-A
بعدی در خط فرمان تحمیل می‌کند. استفاده از
.I \-\-format
بدون آرگومان، رفتار را به تشخیص خودکار برای گزینه‌های بعدی
.IR \-a / \-A
بازمی‌گرداند.
.Sp
برای مثال:
.Sp
.Vb 1
\& virt\-diff \-\-format=raw \-a disk.img [...]
.Ve
.Sp
استفاده از قالب raw (بدون تشخیص خودکار) را برای
.I disk.img
اجباری می‌کند.
.Sp
.Vb 1
\& virt\-diff \-\-format=raw \-a disk.img \-\-format \-a another.img [...]
.Ve
.Sp
قالب raw را برای
.I disk.img
اجباری کرده و برای
.I another.img
به تشخیص خودکار بازمی‌گردد.
.Sp
اگر ایمیج‌های دیسک مهمان غیرقابل‌اعتمادی با قالب raw دارید، باید از این گزینه برای مشخص کردن قالب دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی در مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851).
.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
.IP \fB\-\-human\-readable\fR 4
.IX Item "--human-readable"
.PD
نمایش اندازه فایل‌ها در قالبی خوانا برای انسان.
.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).
\&\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
خواندن عبارت عبور از
.IR FILENAME .
.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" در
.BR guestfs (3)
مراجعه کنید.
.Sp
توجه داشته باشید که اگر هر یک از این گزینه‌ها در خط فرمان وجود داشته باشد، شبکه کاربری QEMU به طور خودکار برای تجهیزات libguestfs فعال خواهد شد.
.RE
.RS 4
.RE
.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
خواندن پارامترهای کلید یا عبارت عبور از ورودی استاندارد (stdin). حالت پیش‌فرض تلاش برای خواندن عبارت عبور از کاربر با باز کردن
.I /dev/tty
است.
.Sp
اگر چندین دستگاه رمزگذاری‌شده وجود دارد، ممکن است لازم باشد چندین کلید را در ورودی استاندارد، هر کدام در یک خط جداگانه، ارسال کنید.
.IP \fB\-\-times\fR 4
.IX Item "--times"
نمایش فیلدهای زمانی.
.IP \fB\-\-time\-days\fR 4
.IX Item "--time-days"
نمایش فیلدهای زمانی به صورت تعداد روزهای پیش از زمان فعلی (در صورت قرار داشتن در آینده، منفی خواهد بود).
.Sp
توجه داشته باشید که
\&\f(CW0\fR
در خروجی به معنای «تا ۱ روز پیش از اکنون» یا به بیانی دیگر، سن فایل بین ۰ تا ۸۶۳۹۹ ثانیه است.
.IP \fB\-\-time\-relative\fR 4
.IX Item "--time-relative"
نمایش فیلدهای زمانی به صورت تعداد ثانیه‌های پیش از زمان فعلی (در صورت قرار داشتن در آینده، منفی خواهد بود).
.IP \fB\-\-time\-t\fR 4
.IX Item "--time-t"
نمایش فیلدهای زمانی به صورت تعداد ثانیه‌ها از مبدا زمانی یونیکس (Unix epoch).
.IP \fB\-\-uids\fR 4
.IX Item "--uids"
نمایش فیلدهای UID و GID.
.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"
فعال‌سازی ردگیری (tracing) فراخوانی‌های API در libguestfs.
.IP \fB\-\-xattrs\fR 4
.IX Item "--xattrs"
نمایش ویژگی‌های گسترش‌یافته (extended attributes).
.SH "نکته‌ای درباره قالب CSV (NOTE ABOUT CSV FORMAT)"
.IX Header "NOTE ABOUT CSV FORMAT"
قالب مقادیر جداشده با کاما (CSV) قالبی فریبنده است. به \fIنظر می‌رسد\fR که تجزیه آن ساده باشد، اما قطعاً تجزیه آن آسان نیست.
.PP
باور غلط: کافی است فیلدها را بر اساس کاما جدا کنید. واقعیت: این روش به طور قابل‌اعتماد کار \fIنمی‌کند\fR. این مثال دارای دو ستون است:
.PP
.Vb 1
\& "foo,bar",baz
.Ve
.PP
باور غلط: فایل را خط به خط بخوانید. واقعیت: این روش به طور قابل‌اعتماد کار \fIنمی‌کند\fR. این مثال فقط یک ردیف است:
.PP
.Vb 2
\& "foo
\& bar",baz
.Ve
.PP
برای اسکریپت‌های شل، از
\&\f(CW\*(C`csvtool\*(C'\fR
استفاده کنید (https://github.com/Chris00/ocaml\-csv
که در توزیع‌های عمده لینوکس نیز بسته‌بندی شده است).
.PP
برای سایر زبان‌ها، از یک کتابخانه پردازش CSV استفاده کنید (مثلاً
\&\f(CW\*(C`Text::CSV\*(C'\fR
برای پرل یا کتابخانه توکار csv در پایتون).
.PP
اکثر برنامه‌های صفحه گسترده و پایگاه‌های داده می‌توانند داده‌های CSV را مستقیماً وارد کنند.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت مقدار ۰ و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBvirt\-cat\fR\|(1),
\&\fBvirt\-copy\-out\fR\|(1),
\&\fBvirt\-ls\fR\|(1),
\&\fBvirt\-tar\-out\fR\|(1),
http://libguestfs.org.
.SH "نویسنده (AUTHOR)"
.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) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه پس از آن، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما \fBبدون هرگونه ضمانت\fR؛ حتی بدون ضمانت ضمنی \fBقابلیت فروش\fR یا \fBتناسب برای یک هدف خاص\fR. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.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
اجرای
.BR libguestfs\-test\-tool (1)
و چسباندن خروجی \fBکامل و ویرایش‌نشده\fR در گزارش باگ.