archive

package
v28.1.1+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 18, 2025 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Overview

Package archive provides helper functions for dealing with archive files.

Index

Constants

View Source 
const (
	Uncompressed = compression.None  // Deprecated: use [compression.None] instead.
	Bzip2        = compression.Bzip2 // Deprecated: use [compression.Bzip2] instead.
	Gzip         = compression.Gzip  // Deprecated: use [compression.Gzip] instead.
	Xz           = compression.Xz    // Deprecated: use [compression.Xz] instead.
	Zstd         = compression.Zstd  // Deprecated: use [compression.Zstd] instead.
)
View Source 
const (
	AUFSWhiteoutFormat    = archive.AUFSWhiteoutFormat    // Deprecated: use [archive.AUFSWhiteoutFormat] instead.
	OverlayWhiteoutFormat = archive.OverlayWhiteoutFormat // Deprecated: use [archive.OverlayWhiteoutFormat] instead.
)
View Source 
const (
	ChangeModify = archive.ChangeModify // Deprecated: use [archive.ChangeModify] instead.
	ChangeAdd    = archive.ChangeAdd    // Deprecated: use [archive.ChangeAdd] instead.
	ChangeDelete = archive.ChangeDelete // Deprecated: use [archive.ChangeDelete] instead.
)
View Source 
const (
	WhiteoutPrefix     = archive.WhiteoutPrefix     // Deprecated: use [archive.WhiteoutPrefix] instead.
	WhiteoutMetaPrefix = archive.WhiteoutMetaPrefix // Deprecated: use [archive.WhiteoutMetaPrefix] instead.
	WhiteoutLinkDir    = archive.WhiteoutLinkDir    // Deprecated: use [archive.WhiteoutLinkDir] instead.
	WhiteoutOpaqueDir  = archive.WhiteoutOpaqueDir  // Deprecated: use [archive.WhiteoutOpaqueDir] instead.
)
View Source 
const ImpliedDirectoryMode = archive.ImpliedDirectoryMode

ImpliedDirectoryMode represents the mode (Unix permissions) applied to directories that are implied by files in a tar, but that do not have their own header entry.

Deprecated: use archive.ImpliedDirectoryMode instead.

Variables

View Source 
var (
	ErrNotDirectory      = archive.ErrNotDirectory      // Deprecated: use [archive.ErrNotDirectory] instead.
	ErrDirNotExists      = archive.ErrDirNotExists      // Deprecated: use [archive.ErrDirNotExists] instead.
	ErrCannotCopyDir     = archive.ErrCannotCopyDir     // Deprecated: use [archive.ErrCannotCopyDir] instead.
	ErrInvalidCopySource = archive.ErrInvalidCopySource // Deprecated: use [archive.ErrInvalidCopySource] instead.
)

Functions

func ApplyLayer deprecated 

func ApplyLayer(dest string, layer io.Reader) (int64, error)

ApplyLayer parses a diff in the standard layer format from `layer`, and applies it to the directory `dest`.

Deprecated: use archive.ApplyLayer instead.

func ApplyUncompressedLayer deprecated added in v1.8.0 

func ApplyUncompressedLayer(dest string, layer io.Reader, options *TarOptions) (int64, error)

ApplyUncompressedLayer parses a diff in the standard layer format from `layer`, and applies it to the directory `dest`.

Deprecated: use archive.ApplyUncompressedLayer instead.

func Changes deprecated 

func Changes(layers []string, rw string) ([]archive.Change, error)

Changes walks the path rw and determines changes for the files in the path, with respect to the parent layers

Deprecated: use archive.Changes instead.

func ChangesDirs deprecated 

func ChangesDirs(newDir, oldDir string) ([]archive.Change, error)

ChangesDirs compares two directories and generates an array of Change objects describing the changes.

Deprecated: use archive.ChangesDirs instead.

func ChangesSize deprecated 

func ChangesSize(newDir string, changes []archive.Change) int64

ChangesSize calculates the size in bytes of the provided changes, based on newDir.

Deprecated: use archive.ChangesSize instead.

func CheckSystemDriveAndRemoveDriveLetter deprecated 

func CheckSystemDriveAndRemoveDriveLetter(path string) (string, error)

CheckSystemDriveAndRemoveDriveLetter verifies that a path is the system drive.

Deprecated: use archive.CheckSystemDriveAndRemoveDriveLetter instead.

func CompressStream deprecated 

func CompressStream(dest io.Writer, comp compression.Compression) (io.WriteCloser, error)

CompressStream compresses the dest with specified compression algorithm.

Deprecated: use compression.CompressStream instead.

func CopyInfoDestinationPath deprecated added in v1.8.0 

func CopyInfoDestinationPath(path string) (info archive.CopyInfo, err error)

CopyInfoDestinationPath stats the given path to create a CopyInfo struct representing that resource for the destination of an archive copy operation.

Deprecated: use archive.CopyInfoDestinationPath instead.

func CopyInfoSourcePath deprecated added in v1.8.0 

func CopyInfoSourcePath(path string, followLink bool) (archive.CopyInfo, error)

CopyInfoSourcePath stats the given path to create a CopyInfo struct. struct representing that resource for the source of an archive copy operation.

Deprecated: use archive.CopyInfoSourcePath instead.

func CopyResource deprecated added in v1.8.0 

func CopyResource(srcPath, dstPath string, followLink bool) error

CopyResource performs an archive copy from the given source path to the given destination path.

Deprecated: use archive.CopyResource instead.

func CopyTo deprecated added in v1.8.0 

func CopyTo(content io.Reader, srcInfo archive.CopyInfo, dstPath string) error

CopyTo handles extracting the given content whose entries should be sourced from srcInfo to dstPath.

Deprecated: use archive.CopyTo instead.

func DecompressStream deprecated 

func DecompressStream(arch io.Reader) (io.ReadCloser, error)

DecompressStream decompresses the archive and returns a ReaderCloser with the decompressed archive.

Deprecated: use compression.DecompressStream instead.

func DetectCompression deprecated 

func DetectCompression(source []byte) archive.Compression

DetectCompression detects the compression algorithm of the source.

Deprecated: use compression.Detect instead.

func ExportChanges 

func ExportChanges(dir string, changes []archive.Change, idMap idtools.IdentityMapping) (io.ReadCloser, error)

ExportChanges produces an Archive from the provided changes, relative to dir.

func FileInfoHeader deprecated 

func FileInfoHeader(name string, fi os.FileInfo, link string) (*tar.Header, error)

FileInfoHeader creates a populated Header from fi.

Deprecated: use archive.FileInfoHeader instead.

func FileInfoHeaderNoLookups deprecated 

func FileInfoHeaderNoLookups(fi os.FileInfo, link string) (*tar.Header, error)

FileInfoHeaderNoLookups creates a partially-populated tar.Header from fi.

Deprecated: use tarheader.FileInfoHeaderNoLookups instead.

func Generate deprecated 

func Generate(input ...string) (io.Reader, error)

Generate generates a new archive from the content provided as input.

Deprecated: use archive.Generate instead.

func GetRebaseName deprecated added in v1.10.0 

func GetRebaseName(path, resolvedPath string) (string, string)

GetRebaseName normalizes and compares path and resolvedPath.

Deprecated: use archive.GetRebaseName instead.

func IsArchivePath deprecated added in v1.10.0 

func IsArchivePath(path string) bool

IsArchivePath checks if the (possibly compressed) file at the given path starts with a tar file header.

Deprecated: use archive.IsArchivePath instead.

func IsEmpty deprecated 

func IsEmpty(rd io.Reader) (bool, error)

IsEmpty checks if the tar archive is empty (doesn't contain any entries).

Deprecated: use archive.IsEmpty instead.

func NewTarballer deprecated 

func NewTarballer(srcPath string, options *TarOptions) (*archive.Tarballer, error)

NewTarballer constructs a new tarballer using TarWithOptions.

Deprecated: use archive.Tarballer instead.

func PrepareArchiveCopy deprecated added in v1.8.0 

func PrepareArchiveCopy(srcContent io.Reader, srcInfo, dstInfo archive.CopyInfo) (dstDir string, content io.ReadCloser, err error)

PrepareArchiveCopy prepares the given srcContent archive.

Deprecated: use archive.PrepareArchiveCopy instead.

func PreserveTrailingDotOrSeparator deprecated added in v1.8.0 

func PreserveTrailingDotOrSeparator(cleanedPath string, originalPath string) string

PreserveTrailingDotOrSeparator returns the given cleaned path.

Deprecated: use archive.PreserveTrailingDotOrSeparator instead.

func ReadSecurityXattrToTarHeader deprecated 

func ReadSecurityXattrToTarHeader(path string, hdr *tar.Header) error

ReadSecurityXattrToTarHeader reads security.capability xattr from filesystem to a tar header

Deprecated: use archive.ReadSecurityXattrToTarHeader instead.

func RebaseArchiveEntries deprecated added in v1.10.0 

func RebaseArchiveEntries(srcContent io.Reader, oldBase, newBase string) io.ReadCloser

RebaseArchiveEntries rewrites the given srcContent archive replacing an occurrence of oldBase with newBase at the beginning of entry names.

Deprecated: use archive.RebaseArchiveEntries instead.

func ReplaceFileTarWrapper deprecated 

func ReplaceFileTarWrapper(inputTarStream io.ReadCloser, mods map[string]archive.TarModifierFunc) io.ReadCloser

ReplaceFileTarWrapper converts inputTarStream to a new tar stream.

Deprecated: use archive.ReplaceFileTarWrapper instead.

func ResolveHostSourcePath deprecated added in v1.10.0 

func ResolveHostSourcePath(path string, followLink bool) (resolvedPath, rebaseName string, _ error)

ResolveHostSourcePath decides real path need to be copied.

Deprecated: use archive.ResolveHostSourcePath instead.

func SplitPathDirEntry deprecated added in v1.8.0 

func SplitPathDirEntry(path string) (dir, base string)

SplitPathDirEntry splits the given path between its directory name and its basename.

Deprecated: use archive.SplitPathDirEntry instead.

func Tar deprecated 

func Tar(path string, compression archive.Compression) (io.ReadCloser, error)

Tar creates an archive from the directory at `path`, and returns it as a stream of bytes.

Deprecated: use archive.Tar instead.

func TarResource deprecated added in v1.8.0 

func TarResource(sourceInfo archive.CopyInfo) (content io.ReadCloser, err error)

TarResource archives the resource described by the given CopyInfo to a Tar archive.

Deprecated: use archive.TarResource instead.

func TarResourceRebase deprecated added in v1.8.0 

func TarResourceRebase(sourcePath, rebaseName string) (content io.ReadCloser, _ error)

TarResourceRebase is like TarResource but renames the first path element of items in the resulting tar archive to match the given rebaseName if not "".

Deprecated: use archive.TarResourceRebase instead.

func TarWithOptions deprecated 

func TarWithOptions(srcPath string, options *TarOptions) (io.ReadCloser, error)

TarWithOptions creates an archive with the given options.

Deprecated: use archive.TarWithOptions instead.

func ToArchiveOpt deprecated 

func ToArchiveOpt(options *TarOptions) *archive.TarOptions

ToArchiveOpt converts an TarOptions to a archive.TarOptions.

Deprecated: use archive.TarOptions instead, this utility is for internal use to transition to the github.com/moby/go-archive module.

func Unpack deprecated added in v1.3.3 

func Unpack(decompressedArchive io.Reader, dest string, options *TarOptions) error

Unpack unpacks the decompressedArchive to dest with options.

Deprecated: use archive.Unpack instead.

func UnpackLayer deprecated added in v1.3.3 

func UnpackLayer(dest string, layer io.Reader, options *TarOptions) (size int64, err error)

UnpackLayer unpack `layer` to a `dest`.

Deprecated: use archive.UnpackLayer instead.

func Untar deprecated 

func Untar(tarArchive io.Reader, dest string, options *TarOptions) error

Untar reads a stream of bytes from `archive`, parses it as a tar archive, and unpacks it into the directory at `dest`.

Deprecated: use archive.Untar instead.

func UntarUncompressed deprecated added in v1.8.0 

func UntarUncompressed(tarArchive io.Reader, dest string, options *TarOptions) error

UntarUncompressed reads a stream of bytes from `tarArchive`, parses it as a tar archive, and unpacks it into the directory at `dest`. The archive must be an uncompressed stream.

Deprecated: use archive.UntarUncompressed instead.

Types

type Archiver deprecated added in v1.3.2 

type Archiver struct {
	Untar     func(io.Reader, string, *TarOptions) error
	IDMapping idtools.IdentityMapping
}

Archiver implements the Archiver interface and allows the reuse of most utility functions of this package with a pluggable Untar function. Also, to facilitate the passing of specific id mappings for untar, an Archiver can be created with maps which will then be passed to Untar operations.

Deprecated: use archive.Archiver instead.

func NewDefaultArchiver deprecated 

func NewDefaultArchiver() *Archiver

NewDefaultArchiver returns a new Archiver without any IdentityMapping

Deprecated: use archive.NewDefaultArchiver instead.

func (*Archiver) CopyFileWithTar added in v1.3.2 

func (archiver *Archiver) CopyFileWithTar(src, dst string) (err error)

CopyFileWithTar emulates the behavior of the 'cp' command-line for a single file. It copies a regular file from path `src` to path `dst`, and preserves all its metadata.

func (*Archiver) CopyWithTar added in v1.3.2 

func (archiver *Archiver) CopyWithTar(src, dst string) error

CopyWithTar creates a tar archive of filesystem path `src`, and unpacks it at filesystem path `dst`. The archive is streamed directly with fixed buffering and no intermediary disk IO.

func (*Archiver) IdentityMapping 

func (archiver *Archiver) IdentityMapping() idtools.IdentityMapping

IdentityMapping returns the IdentityMapping of the archiver.

func (*Archiver) TarUntar added in v1.3.2 

func (archiver *Archiver) TarUntar(src, dst string) error

TarUntar is a convenience function which calls Tar and Untar, with the output of one piped into the other. If either Tar or Untar fails, TarUntar aborts and returns the error.

func (*Archiver) UntarPath added in v1.3.2 

func (archiver *Archiver) UntarPath(src, dst string) error

UntarPath untar a file from path to a destination, src is the source tar file path.

type Change deprecated 

type Change = archive.Change

Change represents a change.

Deprecated: use archive.Change instead.

type ChangeType deprecated 

type ChangeType = archive.ChangeType

ChangeType represents the change

Deprecated: use archive.ChangeType instead.

type Compression deprecated 

type Compression = compression.Compression

Compression is the state represents if compressed or not.

Deprecated: use compression.Compression instead.

type CopyInfo deprecated added in v1.8.0 

type CopyInfo = archive.CopyInfo

CopyInfo holds basic info about the source or destination path of a copy operation.

Deprecated: use archive.CopyInfo instead.

type FileInfo deprecated 

type FileInfo = archive.FileInfo

FileInfo describes the information of a file.

Deprecated: use archive.FileInfo instead.

type TarModifierFunc deprecated 

type TarModifierFunc = archive.TarModifierFunc

TarModifierFunc is a function that can be passed to ReplaceFileTarWrapper.

Deprecated: use archive.TarModifierFunc instead.

type TarOptions deprecated 

type TarOptions struct {
	IncludeFiles     []string
	ExcludePatterns  []string
	Compression      compression.Compression
	NoLchown         bool
	IDMap            idtools.IdentityMapping
	ChownOpts        *idtools.Identity
	IncludeSourceDir bool
	// WhiteoutFormat is the expected on disk format for whiteout files.
	// This format will be converted to the standard format on pack
	// and from the standard format on unpack.
	WhiteoutFormat archive.WhiteoutFormat
	// When unpacking, specifies whether overwriting a directory with a
	// non-directory is allowed and vice versa.
	NoOverwriteDirNonDir bool
	// For each include when creating an archive, the included name will be
	// replaced with the matching name from this map.
	RebaseNames map[string]string
	InUserNS    bool
	// Allow unpacking to succeed in spite of failures to set extended
	// attributes on the unpacked files due to the destination filesystem
	// not supporting them or a lack of permissions. Extended attributes
	// were probably in the archive for a reason, so set this option at
	// your own peril.
	BestEffortXattrs bool
}

TarOptions wraps the tar options.

Deprecated: use archive.TarOptions instead.

func TarResourceRebaseOpts deprecated 

func TarResourceRebaseOpts(sourceBase string, rebaseName string) *TarOptions

TarResourceRebaseOpts does not preform the Tar, but instead just creates the rebase parameters to be sent to TarWithOptions.

Deprecated: use archive.TarResourceRebaseOpts instead.

type Tarballer deprecated 

type Tarballer = archive.Tarballer

Tarballer is a lower-level interface to TarWithOptions.

Deprecated: use archive.Tarballer instead.

type WhiteoutFormat deprecated added in v1.12.0 

type WhiteoutFormat = archive.WhiteoutFormat

WhiteoutFormat is the format of whiteouts unpacked

Deprecated: use archive.WhiteoutFormat instead.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.