tar

Documentation

Overview

Package tar provides method for unpacking tar files

Index

• Variables
• func Read(r io.Reader, dir string) error
• func Unpack(file, dir string) error

Examples

• Read
• Unpack

Variables

var (
	ErrNilReader   = fmt.Errorf("Reader can not be nil")
	ErrEmptyOutput = fmt.Errorf("Path to output directory can not be empty")
)

var AllowExternalLinks = false

AllowExternalLinks is flag for protection against links to files and directories outside target directory

var UpdateOwner = false

UpdateOwner is flag for restoring owner for files and directories

var UpdateTimes = true

UpdateOwner is flag for restoring mtime and atime

Functions

func Read

func Read(r io.Reader, dir string) error

Read reads compressed data using given reader and unpacks it to the given directory

Example

file := "file.tar"
fd, err := os.OpenFile(file, os.O_RDONLY, 0)

if err != nil {
	fmt.Printf("Error: Can't unpack %s: %v\n", file, err)
	return
}

err = Read(fd, "/home/bob/data")

if err != nil {
	fmt.Printf("Error: Can't unpack %s: %v\n", file, err)
	return
}

fmt.Printf("File %s successfully unpacked!\n", file)

func Unpack

func Unpack(file, dir string) error

Unpacks file to given directory

Example

file := "file.tar"
err := Unpack(file, "/home/bob/data")

if err != nil {
	fmt.Printf("Error: Can't unpack %s: %v\n", file, err)
	return
}

fmt.Printf("File %s successfully unpacked!\n", file)