nbdkit-tar-plugin(1)

1nbdkit-tar-plugin(1)                NBDKIT                nbdkit-tar-plugin(1)
2
3
4

NAME

6       nbdkit-tar-plugin - read and write files inside tar files without
7       unpacking
8

SYNOPSIS

10        nbdkit tar tar=FILENAME.tar file=PATH_INSIDE_TAR
11

EXAMPLE

13   Serve a single file inside a tarball
14        nbdkit tar tar=file.tar file=some/disk.img
15        guestfish --format=raw -a nbd://localhost
16
17   Opening a disk image inside an OVA file
18       The popular "Open Virtual Appliance" (OVA) format is really an
19       uncompressed tar file containing (usually) VMDK-format files, so you
20       could access one file in an OVA like this:
21
22        $ tar tf rhel.ova
23        rhel.ovf
24        rhel-disk1.vmdk
25        rhel.mf
26        $ nbdkit -r tar tar=rhel.ova file=rhel-disk1.vmdk
27        $ guestfish --ro --format=vmdk -a nbd://localhost
28

DESCRIPTION

30       "nbdkit-tar-plugin" is a plugin which can read and writes files inside
31       an uncompressed tar file without unpacking the tar file.
32
33       The "tar" and "file" parameters are required, specifying the name of
34       the uncompressed tar file and the exact path of the file within the tar
35       file to access as a disk image.
36
37       This plugin will not work on compressed tar files.
38
39       Use the nbdkit -r flag to open the file readonly.  This is the safest
40       option because it guarantees that the tar file will not be modified.
41       Without -r writes will modify the tar file.
42
43       Also writing to the tar file does not change data checksums stored in
44       other files (the "rhel.mf" file in the example above), and as these
45       will become incorrect you probably won't be able to open the file with
46       another tool afterwards.
47
48       The disk image cannot be resized.
49

AUTHORS

55       Richard W.M. Jones.
56
57       Based on the virt-v2v OVA importer written by Tomáš Golembiovský.
58

COPYRIGHT

60       Copyright (C) 2017 Red Hat Inc.
61

LICENSE

63       Redistribution and use in source and binary forms, with or without
64       modification, are permitted provided that the following conditions are
65       met:
66
67       ·   Redistributions of source code must retain the above copyright
68           notice, this list of conditions and the following disclaimer.
69
70       ·   Redistributions in binary form must reproduce the above copyright
71           notice, this list of conditions and the following disclaimer in the
72           documentation and/or other materials provided with the
73           distribution.
74
75       ·   Neither the name of Red Hat nor the names of its contributors may
76           be used to endorse or promote products derived from this software
77           without specific prior written permission.
78
79       THIS SOFTWARE IS PROVIDED BY RED HAT AND CONTRIBUTORS ''AS IS'' AND ANY
80       EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
81       IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
82       PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL RED HAT OR CONTRIBUTORS BE
83       LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
84       CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
85       SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
86       BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
87       WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
88       OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
89       ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
90
91
92
93nbdkit-1.12.3                     2019-05-21              nbdkit-tar-plugin(1)