1virt-tar-out(1)             Virtualization Support             virt-tar-out(1)
2
3
4

NAME

6       virt-tar-out - Pack a virtual machine disk image directory into a
7       tarball.
8

SYNOPSIS

10        virt-tar-out -a disk.img /dir files.tar
11
12        virt-tar-out -d domain /dir files.tar
13
14        virt-tar-out -d domain /dir - | gzip --best > files.tar.gz
15

DESCRIPTION

17       "virt-tar-out" packs a virtual machine disk image directory into a
18       tarball.
19
20       The first parameter is the absolute path of the virtual machine
21       directory.  The second parameter is the tar file to write.  Use "-" to
22       write to standard output.
23

EXAMPLES

25       Download the home directories from a guest:
26
27        virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz
28

JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH

30       This command is just a simple shell script wrapper around the
31       guestfish(1) "tar-out" command.  For anything more complex than a
32       trivial copy, you are probably better off using guestfish directly.
33

OPTIONS

35       Since the shell script just passes options straight to guestfish, read
36       guestfish(1) to see the full list of options.
37

SEE ALSO

39       guestfish(1), virt-cat(1), virt-copy-in(1), virt-copy-out(1),
40       virt-edit(1), virt-tar-in(1), http://libguestfs.org/.
41

AUTHORS

43       Richard W.M. Jones ("rjones at redhat dot com")
44

46       Copyright (C) 2011-2023 Red Hat Inc.
47

LICENSE

49       This program is free software; you can redistribute it and/or modify it
50       under the terms of the GNU General Public License as published by the
51       Free Software Foundation; either version 2 of the License, or (at your
52       option) any later version.
53
54       This program is distributed in the hope that it will be useful, but
55       WITHOUT ANY WARRANTY; without even the implied warranty of
56       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
57       General Public License for more details.
58
59       You should have received a copy of the GNU General Public License along
60       with this program; if not, write to the Free Software Foundation, Inc.,
61       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
62

BUGS

64       To get a list of bugs against libguestfs, use this link:
65       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
66
67       To report a new bug against libguestfs, use this link:
68       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
69
70       When reporting a bug, please supply:
71
72       •   The version of libguestfs.
73
74       •   Where you got libguestfs (eg. which Linux distro, compiled from
75           source, etc)
76
77       •   Describe the bug accurately and give a way to reproduce it.
78
79       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
80           into the bug report.
81
82
83
84libguestfs-1.50.1                 2023-02-21                   virt-tar-out(1)
Impressum