virt-get-kernel(1) | Virtualization Support | virt-get-kernel(1) |
virt-get-kernel - Extract kernel and ramdisk from guests
virt-get-kernel [--options] -d domname virt-get-kernel [--options] -a disk.img
This option extracts the kernel and initramfs from a guest.
The format of the disk image is automatically detected unless you specify it by using the --format option.
In the case where the guest contains multiple kernels, the one with the highest version number is chosen. To extract arbitrary kernels from the disk image, see guestfish(1). To extract the entire "/boot" directory of a guest, see virt-copy-out(1).
The format of the disk image is auto-detected. To override this and force a particular format use the --format option.
If you specify guest block devices directly (-a), then libvirt is not used at all.
If you have untrusted raw-format guest disk images, you should use this option to specify the disk format. This avoids a possible security problem with malicious guests (CVE-2010-3851).
If there are multiple encrypted devices then you may need to supply multiple keys on stdin, one per line.
If not specified, the default output is the current directory.
If a prefix is specified, then there will be a dash ("-") after the prefix and before the rest of the file name; for example, a kernel in the guest like "vmlinuz-3.19.0-20-generic" is saved as "mydistro-vmlinuz-3.19.0-20-generic" when the prefix is "mydistro".
See also --unversioned-names.
If enabled, files will be saved locally just with the base name; for example, kernel and ramdisk in the guest like "vmlinuz-3.19.0-20-generic" and "initrd.img-3.19.0-20-generic" are saved respectively as "vmlinuz" and "initrd.img".
See also --prefix.
The --machine-readable option can be used to make the output more machine friendly, which is useful when calling virt-get-kernel from other programs, GUIs etc.
Use the option on its own to query the capabilities of the virt-get-kernel binary. Typical output looks like this:
$ virt-get-kernel --machine-readable virt-get-kernel
A list of features is printed, one per line, and the program exits with status 0.
It is possible to specify a format string for controlling the output; see "ADVANCED MACHINE READABLE OUTPUT" in guestfs(3).
For other environment variables which affect all libguestfs programs, see "ENVIRONMENT VARIABLES" in guestfs(3).
This program returns 0 if successful, or non-zero if there was an error.
guestfs(3), guestfish(1), guestmount(1), virt-copy-out(1), http://libguestfs.org/.
Richard W.M. Jones http://people.redhat.com/~rjones/
Copyright (C) 2013-2020 Red Hat Inc.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
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:
2023-05-23 | guestfs-tools-1.48.2 |