3 # Copyright (C) 2009 Red Hat Inc.
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 2 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program; if not, write to the Free Software
17 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 use Sys::Guestfs::Lib qw(open_guest get_partitions resolve_windows_path
24 inspect_all_partitions inspect_partition
25 inspect_operating_systems mount_operating_system);
28 use Locale::TextDomain 'libguestfs';
34 virt-cat - Display a file in a virtual machine
38 virt-cat [--options] domname file
40 virt-cat [--options] disk.img [disk.img ...] file
44 C<virt-cat> is a command line tool to display the contents of C<file>
45 where C<file> exists in the named virtual machine (or disk image).
47 C<virt-cat> can be used to quickly view a single file. For more
48 complex cases you should look at the L<guestfish(1)> tool.
52 Display C</etc/fstab> file from inside the libvirt VM called
55 virt-cat mydomain /etc/fstab
57 List syslog messages from a VM:
59 virt-cat mydomain /var/log/messages | tail
61 Find out what DHCP IP address a VM acquired:
63 virt-cat mydomain /var/log/messages | grep 'dhclient: bound to' | tail
65 Find out what packages were recently installed:
67 virt-cat mydomain /var/log/yum.log | tail
69 Find out who is logged on inside a virtual machine:
71 virt-cat mydomain /var/run/utmp > /tmp/utmp
76 virt-cat mydomain /var/log/wtmp > /tmp/wtmp
97 Display version number and exit.
103 =item B<--connect URI> | B<-c URI>
105 If using libvirt, connect to the given I<URI>. If omitted, then we
106 connect to the default libvirt hypervisor.
108 If you specify guest block devices directly, then libvirt is not used
115 GetOptions ("help|?" => \$help,
116 "version" => \$version,
117 "connect|c=s" => \$uri,
119 pod2usage (1) if $help;
121 my $g = Sys::Guestfs->new ();
122 my %h = $g->version ();
123 print "$h{major}.$h{minor}.$h{release}$h{extra}\n";
127 pod2usage (__"virt-cat: no image, VM names or filenames to cat given")
130 my $filename = pop @ARGV;
134 $g = open_guest (\@ARGV, address => $uri);
136 $g = open_guest (\@ARGV);
141 # List of possible filesystems.
142 my @partitions = get_partitions ($g);
144 # Now query each one to build up a picture of what's in it.
146 inspect_all_partitions ($g, \@partitions,
147 use_windows_registry => 0);
149 my $oses = inspect_operating_systems ($g, \%fses);
151 my @roots = keys %$oses;
152 die __"no root device found in this operating system image" if @roots == 0;
153 die __"multiboot operating systems are not supported by virt-cat" if @roots > 1;
154 my $root_dev = $roots[0];
156 my $os = $oses->{$root_dev};
157 mount_operating_system ($g, $os);
159 # Allow this to fail in case eg. the file does not exist.
160 # NB: https://bugzilla.redhat.com/show_bug.cgi?id=501888
161 print $g->download($filename, "/dev/stdout");
168 L<Sys::Guestfs::Lib(3)>,
170 L<http://libguestfs.org/>.
174 Richard W.M. Jones L<http://et.redhat.com/~rjones/>
178 Copyright (C) 2009 Red Hat Inc.
180 This program is free software; you can redistribute it and/or modify
181 it under the terms of the GNU General Public License as published by
182 the Free Software Foundation; either version 2 of the License, or
183 (at your option) any later version.
185 This program is distributed in the hope that it will be useful,
186 but WITHOUT ANY WARRANTY; without even the implied warranty of
187 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
188 GNU General Public License for more details.
190 You should have received a copy of the GNU General Public License
191 along with this program; if not, write to the Free Software
192 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.