virt-log(1)                 Virtualization Support                 virt-log(1)


نام (NAME)
       virt-log - نمایش فایل‌های لاگ ماشین‌های مجازی

خلاصه دستور (SYNOPSIS)
        virt-log [--options] -d domname

        virt-log [--options] -a disk.img [-a disk.img ...]

توضیحات (DESCRIPTION)
       دستور "virt-log" یک ابزار خط فرمانی برای نمایش فایل‌های لاگ از ماشین
       مجازی نام‌برده‌شده (یا ایمیج دیسک) است.

       این ابزار هر دو نوع فایل‌های لاگ متنی ساده (مانند /var/log/messages) و
       قالب‌های باینری مانند ژورنال systemd را درک کرده و نمایش می‌دهد.

       برای نمایش انواع دیگر فایل‌ها، از virt-cat(1) استفاده کنید. برای دنبال
       کردن (مشاهده زنده) لاگ‌های متنی، از virt-tail(1) استفاده کنید. برای کپی
       کردن فایل‌ها به خارج از ماشین مجازی، از virt-copy-out(1) استفاده کنید.
       برای نمایش محتوای رجیستری ویندوز، از virt-win-reg(1) استفاده کنید.

مثال‌ها (EXAMPLES)
       نمایش لاگ‌های کامل یک مهمان:

        virt-log -d mydomain | less

       یافتن آدرس IP که ماشین مجازی از طریق DHCP دریافت کرده است:

        virt-log -d mydomain | grep 'dhclient.*bound to'

گزینه‌ها (OPTIONS)
       --help
           نمایش راهنمای خلاصه.

       -a file
       --add file
           افزودن file که باید یک ایمیج دیسک از ماشین مجازی باشد. اگر ماشین
           مجازی دارای چندین دستگاه بلوکی است، باید همه آن‌ها را با گزینه‌های
           مجزای -a مشخص کنید.

           قالب ایمیج دیسک به صورت خودکار تشخیص داده می‌شود. برای لغو این حالت
           و اجبار به استفاده از قالبی خاص، از گزینه --format=.. استفاده کنید.

       -a URI
       --add URI
           افزودن دیسک ریموت و دوردست. بخش «ADDING REMOTE STORAGE» در
           guestfish(1) را ببینید.

       --blocksize=512
       --blocksize=4096
       --blocksize
           این پارامتر اندازه سکتور ایمیج دیسک را تنظیم می‌کند. این مقدار روی
           تمام دیسک‌های بعدی که پس از این پارامتر به صورت صریح اضافه می‌شوند
           اثر می‌گذارد. استفاده از --blocksize بدون آرگومان، اندازه سکتور دیسک
           را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است بازمی‌گرداند. همچنین بخش
           «guestfs_add_drive_opts» در guestfs(3) را ببینید.

       -c URI
       --connect URI
           در صورت استفاده از libvirt، به URI داده‌شده متصل می‌شود. در صورت عدم
           ذکر، به هایپروایزر پیش‌فرض libvirt متصل خواهیم شد.

           اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید (-a)، دیگر libvirt
           به هیچ وجه استفاده نمی‌شود.

       -d guest
       --domain guest
           افزودن تمام دیسک‌های مهمان نام‌برده‌شده در libvirt. می‌توان به جای نام،
           از UUID دامنه نیز استفاده کرد.

       --echo-keys
           هنگام درخواست کلیدها و عبارات عبور، virt-log معمولاً نمایش کاراکترها
           (echoing) را غیرفعال می‌کند تا چیزی که تایپ می‌کنید دیده نشود. اگر
           نگران حملات تمپست (Tempest attacks) نیستید و شخص دیگری در اتاق حضور
           ندارد، می‌توانید این فلگ را مشخص کنید تا آنچه را تایپ می‌کنید ببینید.

       --format=raw|qcow2|..
       --format
           حالت پیش‌فرض برای گزینه -a تشخیص خودکار قالب ایمیج دیسک است. استفاده
           از این گزینه، قالب دیسک را برای گزینه‌های -a بعدی در خط فرمان اجباری
           می‌کند. استفاده از --format بدون آرگومان، تشخیص را به حالت خودکار
           برای گزینه‌های بعدی -a بازمی‌گرداند.

           برای مثال:

            virt-log --format=raw -a disk.img

           قالب خام raw (بدون تشخیص خودکار) را برای disk.img اجبار می‌کند.

            virt-log --format=raw -a disk.img --format -a another.img

           قالب raw را برای disk.img اجبار کرده و برای another.img به تشخیص
           خودکار بازمی‌گردد.

           اگر ایمیج‌های دیسک مهمان با قالب raw غیرقابل اعتماد دارید، باید از
           این گزینه برای تعیین دقیق قالب دیسک استفاده کنید. این کار از یک
           مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE-2010-3851).

       --key SELECTOR
           تعیین کلید برای LUKS، جهت بازگشایی خودکار دستگاه LUKS هنگام بازرسی
           سیستم.

           --key NAME:key:KEY_STRING
           --key UUID:key:KEY_STRING
           --key all:key:KEY_STRING
               "NAME" نام دستگاه در libguestfs است (مانند "/dev/sda1").
               "UUID" شناسه یکتای دستگاه (UUID) است.  "all" به معنای امتحان
               کردن کلید برای تمام دستگاه‌های رمزگذاری‌شده است.

               از "KEY_STRING" مشخص‌شده به عنوان عبارت عبور استفاده می‌کند.

           --key NAME:file:FILENAME
           --key UUID:file:FILENAME
           --key all:file:FILENAME
               خواندن عبارت عبور از FILENAME.

           --key NAME:clevis
           --key UUID:clevis
           --key all:clevis
               تلاش برای بازگشایی قفل دستگاه بدون عبارت عبور از طریق Clevis
               روی شبکه. لطفاً برای اطلاعات بیشتر درباره رمزگذاری دیسک وابسته
               به شبکه (NBDE)، به بخش «ENCRYPTED DISKS» در guestfs(3) مراجعه
               کنید.

               توجه داشته باشید که اگر هر یک از این گزینه‌ها در خط فرمان وجود
               داشته باشد، شبکه کاربری QEMU به طور خودکار برای اپلاینس
               libguestfs فعال خواهد شد.

       --keys-from-stdin
           خواندن پارامترهای کلید یا عبارت عبور از ورودی استاندارد (stdin).
           حالت پیش‌فرض تلاش برای خواندن عبارت عبور از کاربر از طریق باز کردن
           /dev/tty است.

           اگر چندین دستگاه رمزگذاری‌شده وجود داشته باشد، ممکن است لازم باشد
           چندین کلید را در ورودی استاندارد، هر کدام در یک خط، وارد کنید.

       -v
       --verbose
           فعال‌سازی پیام‌های پرجزئیات برای اشکال‌زدایی.

       -V
       --version
           نمایش شماره نسخه و خروج.

       -x  فعال‌سازی ردگیری فراخوانی‌های API در libguestfs.

وضعیت خروج (EXIT STATUS)
       این برنامه در صورت موفقیت مقدار ۰ و در صورت بروز خطا مقداری غیر از صفر
       برمی‌گرداند.

همچنین ببینید (SEE ALSO)
       guestfs(3), guestfish(1), virt-cat(1), virt-copy-out(1), virt-tail(1),
       virt-tar-out(1), virt-win-reg(1), http://libguestfs.org

نویسنده (AUTHOR)
       Richard W.M. Jones http://people.redhat.com/~rjones

حق نشر (COPYRIGHT)
       Copyright (C) 2010-2025 Red Hat Inc.

مجوز (LICENSE)
       این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز
       عمومی همگانی گنو (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر
       شده است، بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ مجوز و چه (به انتخاب
       خودتان) هر نسخه بالاتر دیگری.

       این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه
       ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف
       خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

       شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت
       کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به نشانی زیر
       بنویسید: 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

اشکالات (BUGS)
       برای دریافت فهرست اشکالات ثبت‌شده برای libguestfs، از این پیوند استفاده
       کنید:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       هنگام گزارش اشکال، لطفاً موارد زیر را ارائه دهید:

       •   نسخه libguestfs.

       •   محل تهیه libguestfs (مانند توزیع لینوکس مورد استفاده، کامپایل‌شده از
           سورس و غیره).

       •   توصیف دقیق اشکال و ارائه روشی برای بازتولید آن.

       •   اجرای libguestfs-test-tool(1) و قرار دادن خروجی کامل و بدون ویرایش
           آن در گزارش اشکال.

guestfs-tools-1.56.0              2026-07-11                       virt-log(1)