Manpages

НАЗВА

virt-log -- програма для показу файлів журналу віртуальної машини

КОРОТКИЙ ОПИС

virt-log [--параметри] -d назва_домену
virt-log [--параметри] -a диск.img [-a диск.img ...]

ОПИС

"virt-log" — інструмент командного рядка для показу файлів журналів з вказаної віртуальної машини (або образу диска).

Ця програма може працювати як зі звичайними текстовими файлами журналу (наприклад /var/log/messages), такі із файлами журналів у двійкових форматах, зокрема журналом systemd.

Для виведення вмісту файлів інших типів скористайтеся virt-cat(1). Для стеження (tail) за текстовими файлами журналу, скористайтеся virt-tail(1). Щоб скопіювати файли з віртуальної машини, скористайтеся virt-copy-out(1). Щоб вивести вміст реєстру Windows, скористайтеся virt-win-reg(1).

ПРИКЛАДИ

Показ журналу з гостьової системи повністю:

virt-log -d mydomain | less

Визначення IP-адреси DHCP, використаної віртуальною машиною:

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

ПАРАМЕТРИ

--help

Показати коротку довідку.

-a файл
--add
файл

Додати файл, який має бути образом диска з віртуальної машини. Якщо у віртуальній машині декілька блокових пристроїв, вам слід вказати їх усі за допомогою окремих записів параметра -a.

Формат образу диска визначається автоматично. Щоб перевизначити його і примусово використати певний формат, скористайтеся параметром --format=...

-a адреса
--add адреса

Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in guestfish(1).

--blocksize=512
--blocksize=4096
--blocksize

This parameter sets the sector size of the disk image. It affects all explicitly added subsequent disks after this parameter. Using --blocksize with no argument switches the disk sector size to the default value which is usually 512 bytes. See also "guestfs_add_drive_opts" in guestfs(3).

-c адреса
--connect
адреса

Якщо використовується libvirt, встановити з’єднання з вказаним URI. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.

Якщо вказати блокові пристрої гостьових систем безпосередньо (-a), libvirt не буде використовуватися взагалі.

-d гість
--domain
гість

Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна використовувати замість назв.

--echo-keys

Типово, якщо virt-log попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.

--format=raw|qcow2|..
--format

Типовим значенням для параметра -a є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів -a формату диска у наступному рядку команди. Використання параметра --format без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах -a.

Приклад:

virt-log --format=raw -a диск.img

примусове встановлення формату без обробки (без автоматичного визначення) для disk.img.

virt-log --format=raw -a диск.img --format -a інший.img

примусове встановлення формату без обробки (без автоматичного визначення) для diskimg і повернення до автоматичного визначення для another.img.

Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE-2010-3851).

--key SELECTOR

Specify a key for LUKS, to automatically open a LUKS device when using the inspection.
--key
NAME:key:KEY_STRING
--key
UUID:key:KEY_STRING
--key all:key:
KEY_STRING

"NAME" is the libguestfs device name (eg. "/dev/sda1"). "UUID" is the device UUID. "all" means try the key against any encrypted device.

Use the specified "KEY_STRING" as passphrase.

--key NAME:file:FILENAME
--key
UUID:file:FILENAME
--key all:file:
FILENAME

Read the passphrase from FILENAME.

--key NAME:clevis
--key
UUID:clevis
--key all:clevis

Attempt passphrase-less unlocking for the device with Clevis, over the network. Please refer to "ENCRYPTED DISKS" in guestfs(3) for more information on network-bound disk encryption (NBDE).

Note that if any such option is present on the command line, QEMU user networking will be automatically enabled for the libguestfs appliance.

--keys-from-stdin

Read key or passphrase parameters from stdin. The default is to try to read passphrases from the user by opening /dev/tty.

If there are multiple encrypted devices then you may need to supply multiple keys on stdin, one per line.

-v

--verbose

Увімкнути докладний показ повідомлень з метою діагностики.

-V

--version

Показати дані щодо версії і завершити роботу.

-x

Увімкнути трасування викликів програмного інтерфейсу libguestfs.

СТАН ВИХОДУ

Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.

ТАКОЖ ПЕРЕГЛЯНЬТЕ

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-2023 Red Hat Inc.

LICENSE

BUGS

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

The version of libguestfs.

Where you got libguestfs (eg. which Linux distro, compiled from source, etc)

Describe the bug accurately and give a way to reproduce it.

Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.