tar

Documentation

Overview

Package tar contains helper functions for working with tar files

Index

• Constants
• Variables
• func ExtractFile(tr *tar.Reader, hdr *tar.Header, dir string, overwrite bool) error
• func ExtractFileFromTar(tr *tar.Reader, file string) ([]byte, error)
• func ExtractTar(tr *tar.Reader, dir string, overwrite bool, pwl PathWhitelistMap) error
• func HdrToTimespec(hdr *tar.Header) []syscall.Timespec
• func LUtimesNano(path string, ts []syscall.Timespec) error
• type PathWhitelistMap

Constants

const DEFAULT_DIR_MODE os.FileMode = 0755

Variables

var ErrNotSupportedPlatform = errors.New("platform and architecture is not supported")

Functions

func ExtractFile

func ExtractFile(tr *tar.Reader, hdr *tar.Header, dir string, overwrite bool) error

ExtractFile extracts the file described by hdr from the given tarball into the provided directory. If overwrite is true, existing files will be overwritten.

func ExtractFileFromTar

func ExtractFileFromTar(tr *tar.Reader, file string) ([]byte, error)

ExtractFileFromTar extracts a regular file from the given tar, returning its contents as a byte slice

func ExtractTar

func ExtractTar(tr *tar.Reader, dir string, overwrite bool, pwl PathWhitelistMap) error

ExtractTar extracts a tarball (from a tar.Reader) into the given directory if pwl is not nil, only the paths in the map are extracted. If overwrite is true, existing files will be overwritten.

func HdrToTimespec

func HdrToTimespec(hdr *tar.Header) []syscall.Timespec

func LUtimesNano

func LUtimesNano(path string, ts []syscall.Timespec) error

Types

type PathWhitelistMap

type PathWhitelistMap map[string]struct{}

Map of paths that should be whitelisted. The paths should be relative to the root of the tar file and should be cleaned (for example using filepath.Clean)