README
¶
tarutil
This library is a collection of Go utilities to handle tar archives.
This library contains only code which can unpack tar archives with AUFS whiteouts.
The layer unpacking code is based on Docker's pkg/archive.
Documentation
¶
Index ¶
- func FilterTarUsingFilter(r io.Reader, f TarFilter) (io.Reader, error)
- func Lgetxattr(path string, attr string) ([]byte, error)
- func Lsetxattr(path string, attr string, data []byte, flags int) error
- func OpenAndUnpack(ctx context.Context, layerPath, dest string, options *Options) error
- func OpenAndUnpackMulti(ctx context.Context, layers []string, dest string, options *Options) error
- func Pack(ctx context.Context, source string, w io.Writer) error
- func Unpack(ctx context.Context, r io.Reader, dest string, options *Options) error
- type AUFSWhiteouts
- type Options
- type OverlayWhiteouts
- type TarFilter
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FilterTarUsingFilter ¶
FilterTarUsingFilter accepts a tar file in the io.Reader and a Tarfilter, and then runs the filter repeatedly on the reader.
func Lgetxattr ¶
Lgetxattr retrieves the value of the extended attribute identified by attr and associated with the given path in the file system. It will returns a nil slice and nil error if the xattr is not set.
func Lsetxattr ¶
Lsetxattr sets the value of the extended attribute identified by attr and associated with the given path in the file system.
func OpenAndUnpack ¶
OpenAndUnpack unpacks a specified file into the destination.
func OpenAndUnpackMulti ¶
OpenAndUnpackMulti unpacks multiple files into the destination.
Types ¶
type AUFSWhiteouts ¶
type AUFSWhiteouts struct {
// contains filtered or unexported fields
}
AUFSWhiteouts is a TarFilter to convert overlay whiteouts to aufs whiteouts.
func NewAUFSWhiteouts ¶
func NewAUFSWhiteouts() *AUFSWhiteouts
NewAUFSWhiteouts creates a new overlay whiteout filter.
func (*AUFSWhiteouts) Close ¶
func (o *AUFSWhiteouts) Close() error
Close closes the tar filter, finalizing any processing.
func (*AUFSWhiteouts) HandleEntry ¶
HandleEntry is the meat and potatoes of the filter; managing the overlay files.
func (*AUFSWhiteouts) SetTarWriter ¶
func (o *AUFSWhiteouts) SetTarWriter(tw *tar.Writer) error
SetTarWriter sets the tar writer for output processing.
type Options ¶
type Options struct {
NoLchown bool
}
Options controls the behavior of some tarball related operations.
type OverlayWhiteouts ¶
type OverlayWhiteouts struct {
// contains filtered or unexported fields
}
OverlayWhiteouts is a TarFilter to handle overlay whiteout files.
func NewOverlayWhiteouts ¶
func NewOverlayWhiteouts() *OverlayWhiteouts
NewOverlayWhiteouts creates a new overlay whiteout filter.
func (*OverlayWhiteouts) Close ¶
func (o *OverlayWhiteouts) Close() error
Close closes the tar filter, finalizing any processing.
func (*OverlayWhiteouts) HandleEntry ¶
HandleEntry is the meat and potatoes of the filter; managing the overlay files.
func (*OverlayWhiteouts) SetTarWriter ¶
func (o *OverlayWhiteouts) SetTarWriter(tw *tar.Writer) error
SetTarWriter sets the tar writer for output processing.
Source Files