virt-tar-in(1) Virtualization Support virt-tar-in(1)
virt-tar-in - Unpack a tarball into a virtual machine disk image.
virt-tar-in -a disk.img data.tar /destination
virt-tar-in -d domain data.tar /destination
zcat data.tar.gz | virt-tar-in -d domain - /destination
Using "virt-tar-in" on live virtual machines can be dangerous, potentially causing disk
corruption. The virtual machine must be shut down before you use this command.
"virt-tar-in" unpacks an uncompressed tarball into a virtual machine disk image or named
The first parameter is the tar file. Use "-" to read the tar file from standard input.
The second parameter is the absolute target directory to unpack into.
Upload a home directory to a guest:
virt-tar-in -d MyGuest homes.tar /home
JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH
This command is just a simple shell script wrapper around the guestfish(1) "tar-in"
command. For anything more complex than a trivial copy, you are probably better off using
Since the shell script just passes options straight to guestfish, read guestfish(1) to see
the full list of options.
guestfish(1), virt-cat(1), virt-copy-in(1), virt-copy-out(1), virt-edit(1),
virt-make-fs(1), virt-tar-out(1), http://libguestfs.org/.
Richard W.M. Jones ("rjones at redhat dot com")
Copyright (C) 2011-2012 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:
To report a new bug against libguestfs, use this link:
When reporting a bug, please supply:
o The version of libguestfs.
o Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
o Describe the bug accurately and give a way to reproduce it.
o Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug
libguestfs-1.22.6 2013-08-24 virt-tar-in(1)