.\" -*- 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-log 1"
.TH virt-log 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\-log \- نمایش فایل‌های لاگ ماشین‌های مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& virt\-log [\-\-options] \-d domname
\&
\& virt\-log [\-\-options] \-a disk.img [\-a disk.img ...]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\f(CW\*(C`virt\-log\*(C'\fR
یک ابزار خط فرمانی برای نمایش فایل‌های لاگ از ماشین مجازی نام‌برده‌شده (یا ایمیج دیسک) است.
.PP
این ابزار هر دو نوع فایل‌های لاگ متنی ساده (مانند
\fI/var/log/messages\fR)
و قالب‌های باینری مانند ژورنال
systemd
را درک کرده و نمایش می‌دهد.
.PP
برای نمایش انواع دیگر فایل‌ها، از
\fBvirt\-cat\fR\|(1)
استفاده کنید. برای دنبال کردن (مشاهده زنده) لاگ‌های متنی، از
\fBvirt\-tail\fR\|(1)
استفاده کنید. برای کپی کردن فایل‌ها به خارج از ماشین مجازی، از
\fBvirt\-copy\-out\fR\|(1)
استفاده کنید. برای نمایش محتوای رجیستری ویندوز، از
\fBvirt\-win\-reg\fR\|(1)
استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
نمایش لاگ‌های کامل یک مهمان:
.PP
.Vb 1
\& virt\-log \-d mydomain | less
.Ve
.PP
یافتن آدرس IP که ماشین مجازی از طریق DHCP دریافت کرده است:
.PP
.Vb 1
\& virt\-log \-d mydomain | grep \*(Aqdhclient.*bound to\*(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 URI\fR" 4
.IX Item "-a URI"
.PD 0
.IP "\fB\-\-add URI\fR" 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
در صورت استفاده از libvirt، به
\fIURI\fR
داده‌شده متصل می‌شود. در صورت عدم ذکر، به هایپروایزر پیش‌فرض libvirt متصل خواهیم شد.
.Sp
اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید (\fI\-a\fR)، دیگر 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\-log
معمولاً نمایش کاراکترها (echoing) را غیرفعال می‌کند تا چیزی که تایپ می‌کنید دیده نشود. اگر نگران حملات تمپست (Tempest attacks) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این فلگ را مشخص کنید تا آنچه را تایپ می‌کنید ببینید.
.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\-log \-\-format=raw \-a disk.img
.Ve
.Sp
قالب خام raw (بدون تشخیص خودکار) را برای
\fIdisk.img\fR
اجبار می‌کند.
.Sp
.Vb 1
\& virt\-log \-\-format=raw \-a disk.img \-\-format \-a another.img
.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 هنگام بازرسی سیستم.
.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
مشخص‌شده به عنوان عبارت عبور استفاده می‌کند.
.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\-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 "وضعیت خروج (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\-tail\fR\|(1),
\&\fBvirt\-tar\-out\fR\|(1),
\&\fBvirt\-win\-reg\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) 2010\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بالاتر دیگری.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به نشانی زیر بنویسید:
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
آن در گزارش اشکال.