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

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

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

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

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

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

نمایش لاگ‌های کامل یک مهمان:

virt-log -d mydomain | less

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

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

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

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

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

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

افزودن تمام دیسک‌های مهمان نام‌برده‌شده در libvirt. می‌توان به جای نام، از UUID دامنه نیز استفاده کرد.
هنگام درخواست کلیدها و عبارات عبور، virt-log معمولاً نمایش کاراکترها (echoing) را غیرفعال می‌کند تا چیزی که تایپ می‌کنید دیده نشود. اگر نگران حملات تمپست (Tempest attacks) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این فلگ را مشخص کنید تا آنچه را تایپ می‌کنید ببینید.
حالت پیش‌فرض برای گزینه -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).

تعیین کلید برای LUKS، جهت بازگشایی خودکار دستگاه LUKS هنگام بازرسی سیستم.
"NAME" نام دستگاه در libguestfs است (مانند "/dev/sda1"). "UUID" شناسه یکتای دستگاه (UUID) است. "all" به معنای امتحان کردن کلید برای تمام دستگاه‌های رمزگذاری‌شده است.

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

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

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

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

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

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

این برنامه در صورت موفقیت مقدار ۰ و در صورت بروز خطا مقداری غیر از صفر برمی‌گرداند.

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

Richard W.M. Jones http://people.redhat.com/~rjones

Copyright (C) 2010-2025 Red Hat Inc.

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

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

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

برای دریافت فهرست اشکالات ثبت‌شده برای 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) و قرار دادن خروجی کامل و بدون ویرایش آن در گزارش اشکال.
2026-07-11 guestfs-tools-1.56.0