1virt-get-kernel(1)          Virtualization Support          virt-get-kernel(1)
2
3
4

NAME

6       virt-get-kernel - Extract kernel and ramdisk from guests
7

SYNOPSIS

9        virt-get-kernel [--options] -d domname
10
11        virt-get-kernel [--options] -a disk.img
12

DESCRIPTION

14       This option extracts the kernel and initramfs from a guest.
15
16       The format of the disk image is automatically detected unless you
17       specify it by using the --format option.
18
19       In the case where the guest contains multiple kernels, the one with the
20       highest version number is chosen.  To extract arbitrary kernels from
21       the disk image, see guestfish(1).  To extract the entire "/boot"
22       directory of a guest, see virt-copy-out(1).
23

OPTIONS

25       --help
26           Display help.
27
28       -a file
29       --add file
30           Add file which should be a disk image from a virtual machine.
31
32           The format of the disk image is auto-detected.  To override this
33           and force a particular format use the --format option.
34
35       -a URI
36       --add URI
37           Add a remote disk.  The URI format is compatible with guestfish.
38           See "ADDING REMOTE STORAGE" in guestfish(1).
39
40       --colors
41       --colours
42           Use ANSI colour sequences to colourize messages.  This is the
43           default when the output is a tty.  If the output of the program is
44           redirected to a file, ANSI colour sequences are disabled unless you
45           use this option.
46
47       -c URI
48       --connect URI
49           If using libvirt, connect to the given URI.  If omitted, then we
50           connect to the default libvirt hypervisor.
51
52           If you specify guest block devices directly (-a), then libvirt is
53           not used at all.
54
55       -d guest
56       --domain guest
57           Add all the disks from the named libvirt guest.  Domain UUIDs can
58           be used instead of names.
59
60       --echo-keys
61           When prompting for keys and passphrases, virt-get-kernel normally
62           turns echoing off so you cannot see what you are typing.  If you
63           are not worried about Tempest attacks and there is no one else in
64           the room you can specify this flag to see what you are typing.
65
66       --format raw|qcow2|..
67       --format auto
68           The default for the -a option is to auto-detect the format of the
69           disk image.  Using this forces the disk format for the -a option on
70           the command line.
71
72           If you have untrusted raw-format guest disk images, you should use
73           this option to specify the disk format.  This avoids a possible
74           security problem with malicious guests (CVE-2010-3851).
75
76       --keys-from-stdin
77           Read key or passphrase parameters from stdin.  The default is to
78           try to read passphrases from the user by opening /dev/tty.
79
80       --machine-readable
81           This option is used to make the output more machine friendly when
82           being parsed by other programs.  See "MACHINE READABLE OUTPUT"
83           below.
84
85       -o directory
86       --output directory
87           This option specifies the output directory where kernel and
88           initramfs from the guest are written.
89
90           If not specified, the default output is the current directory.
91
92       --prefix prefix
93           This option specifies a prefix for the extracted files.
94
95           If a prefix is specified, then there will be a dash ("-") after the
96           prefix and before the rest of the file name; for example, a kernel
97           in the guest like "vmlinuz-3.19.0-20-generic" is saved as
98           "mydistro-vmlinuz-3.19.0-20-generic" when the prefix is "mydistro".
99
100           See also --unversioned-names.
101
102       -q
103       --quiet
104           Don’t print ordinary progress messages.
105
106       --unversioned-names
107           This option affects the destination file name of extracted files.
108
109           If enabled, files will be saved locally just with the base name;
110           for example, kernel and ramdisk in the guest like
111           "vmlinuz-3.19.0-20-generic" and "initrd.img-3.19.0-20-generic" are
112           saved respectively as "vmlinuz" and "initrd.img".
113
114           See also --prefix.
115
116       -v
117       --verbose
118           Enable verbose messages for debugging.
119
120       -V
121       --version
122           Display version number and exit.
123
124       -x  Enable tracing of libguestfs API calls.
125

MACHINE READABLE OUTPUT

127       The --machine-readable option can be used to make the output more
128       machine friendly, which is useful when calling virt-get-kernel from
129       other programs, GUIs etc.
130
131       Use the option on its own to query the capabilities of the virt-get-
132       kernel binary.  Typical output looks like this:
133
134        $ virt-get-kernel --machine-readable
135        virt-get-kernel
136
137       A list of features is printed, one per line, and the program exits with
138       status 0.
139

ENVIRONMENT VARIABLES

141       For other environment variables which affect all libguestfs programs,
142       see "ENVIRONMENT VARIABLES" in guestfs(3).
143

EXIT STATUS

145       This program returns 0 if successful, or non-zero if there was an
146       error.
147

SEE ALSO

149       guestfs(3), guestfish(1), guestmount(1), virt-copy-out(1),
150       http://libguestfs.org/.
151

AUTHOR

153       Richard W.M. Jones http://people.redhat.com/~rjones/
154
156       Copyright (C) 2013-2018 Red Hat Inc.
157

LICENSE

159       This program is free software; you can redistribute it and/or modify it
160       under the terms of the GNU General Public License as published by the
161       Free Software Foundation; either version 2 of the License, or (at your
162       option) any later version.
163
164       This program is distributed in the hope that it will be useful, but
165       WITHOUT ANY WARRANTY; without even the implied warranty of
166       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
167       General Public License for more details.
168
169       You should have received a copy of the GNU General Public License along
170       with this program; if not, write to the Free Software Foundation, Inc.,
171       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
172

BUGS

174       To get a list of bugs against libguestfs, use this link:
175       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
176
177       To report a new bug against libguestfs, use this link:
178       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
179
180       When reporting a bug, please supply:
181
182       ·   The version of libguestfs.
183
184       ·   Where you got libguestfs (eg. which Linux distro, compiled from
185           source, etc)
186
187       ·   Describe the bug accurately and give a way to reproduce it.
188
189       ·   Run libguestfs-test-tool(1) and paste the complete, unedited output
190           into the bug report.
191
192
193
194libguestfs-1.38.2                 2018-05-15                virt-get-kernel(1)
Impressum