tar

Imports

Imports #

"syscall"
"time"
"io/fs"
"os/user"
"runtime"
"strconv"
"sync"
"syscall"
"bytes"
"fmt"
"strconv"
"strings"
"time"
"errors"
"fmt"
"io"
"io/fs"
"maps"
"path"
"slices"
"strings"
"time"
"errors"
"fmt"
"internal/godebug"
"io/fs"
"maps"
"math"
"path"
"reflect"
"strconv"
"strings"
"time"
"strings"
"bytes"
"io"
"path/filepath"
"strconv"
"strings"
"time"
"syscall"
"time"

Constants & Variables

ErrFieldTooLong var #

var ErrFieldTooLong = *ast.CallExpr

ErrHeader var #

var ErrHeader = *ast.CallExpr

ErrInsecurePath var #

var ErrInsecurePath = *ast.CallExpr

ErrWriteAfterClose var #

var ErrWriteAfterClose = *ast.CallExpr

ErrWriteTooLong var #

var ErrWriteTooLong = *ast.CallExpr

FormatGNU const #

FormatGNU represents the GNU header format. The GNU header format is older than the USTAR and PAX standards and is not compatible with them. The GNU format supports arbitrary file sizes, filenames of arbitrary encoding and length, sparse files, and other features. It is recommended that PAX be chosen over GNU unless the target application can only parse GNU formatted archives. Reference: https://www.gnu.org/software/tar/manual/html_node/Standard.html

const FormatGNU

FormatPAX const #

FormatPAX represents the PAX header format defined in POSIX.1-2001. PAX extends USTAR by writing a special file with Typeflag TypeXHeader preceding the original header. This file contains a set of key-value records, which are used to overcome USTAR's shortcomings, in addition to providing the ability to have sub-second resolution for timestamps. Some newer formats add their own extensions to PAX by defining their own keys and assigning certain semantic meaning to the associated values. For example, sparse file support in PAX is implemented using keys defined by the GNU manual (e.g., "GNU.sparse.map"). Reference: http://pubs.opengroup.org/onlinepubs/009695399/utilities/pax.html

const FormatPAX

FormatUSTAR const #

FormatUSTAR represents the USTAR header format defined in POSIX.1-1988. While this format is compatible with most tar readers, the format has several limitations making it unsuitable for some usages. Most notably, it cannot support sparse files, files larger than 8GiB, filenames larger than 256 characters, and non-ASCII filenames. Reference: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html#tag_20_92_13_06

const FormatUSTAR

FormatUnknown const #

FormatUnknown indicates that the format is unknown.

const FormatUnknown

TypeBlock const #

Type flags for Header.Typeflag.

const TypeBlock = '4'

TypeChar const #

Type flags for Header.Typeflag.

const TypeChar = '3'

TypeCont const #

Type '7' is reserved.

const TypeCont = '7'

TypeDir const #

Type flags for Header.Typeflag.

const TypeDir = '5'

TypeFifo const #

Type flags for Header.Typeflag.

const TypeFifo = '6'

TypeGNULongLink const #

Type flags for Header.Typeflag.

const TypeGNULongLink = 'K'

TypeGNULongName const #

Types 'L' and 'K' are used by the GNU format for a meta file used to store the path or link name for the next file. This package transparently handles these types.

const TypeGNULongName = 'L'

TypeGNUSparse const #

Type 'S' indicates a sparse file in the GNU format.

const TypeGNUSparse = 'S'

TypeLink const #

Type '1' to '6' are header-only flags and may not have a data body.

const TypeLink = '1'

TypeReg const #

Type '0' indicates a regular file.

const TypeReg = '0'

TypeRegA const #

Deprecated: Use TypeReg instead.

const TypeRegA = '\x00'

TypeSymlink const #

Type flags for Header.Typeflag.

const TypeSymlink = '2'

TypeXGlobalHeader const #

Type 'g' is used by the PAX format to store key-value records that are relevant to all subsequent files. This package only supports parsing and composing such headers, but does not currently support persisting the global state across files.

const TypeXGlobalHeader = 'g'

TypeXHeader const #

Type 'x' is used by the PAX format to store key-value records that are only relevant to the next file. This package transparently handles these types.

const TypeXHeader = 'x'

_ const #

Deliberately hide the meaning of constants from public API.

const _ Format = *ast.BinaryExpr

basicKeys var #

basicKeys is a set of the PAX keys for which we have built-in support. This does not contain "charset" or "comment", which are both PAX-specific, so adding them as first-class features of Header is unlikely. Users can use the PAXRecords field to set it themselves.

var basicKeys = map[string]bool{...}

blockSize const #

Size constants from various tar specifications.

const blockSize = 512

c_ISBLK const #

const c_ISBLK = 060000

c_ISCHR const #

const c_ISCHR = 020000

c_ISDIR const #

Common Unix mode constants; these are not defined in any common tar standard. Header.FileInfo understands these, but FileInfoHeader will never produce these.

const c_ISDIR = 040000

c_ISFIFO const #

const c_ISFIFO = 010000

c_ISGID const #

const c_ISGID = 02000

c_ISLNK const #

const c_ISLNK = 0120000

c_ISREG const #

const c_ISREG = 0100000

c_ISSOCK const #

const c_ISSOCK = 0140000

c_ISUID const #

Mode constants from the USTAR spec: See http://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html#tag_20_92_13_06

const c_ISUID = 04000

c_ISVTX const #

const c_ISVTX = 01000

errMissData var #

var errMissData = *ast.CallExpr

errUnrefData var #

var errUnrefData = *ast.CallExpr

errWriteHole var #

var errWriteHole = *ast.CallExpr

formatMax const #

Constants to identify various tar formats.

const formatMax

formatNames var #

var formatNames = map[Format]string{...}

formatSTAR const #

Schily's tar format, which is incompatible with USTAR. This does not cover STAR extensions to the PAX format; these fall under the PAX format.

const formatSTAR

formatV7 const #

The format of the original Unix V7 tar tool prior to standardization.

const formatV7

groupMap var #

userMap and groupMap caches UID and GID lookups for performance reasons. The downside is that renaming uname or gname by the OS never takes effect.

var groupMap sync.Map

magicGNU const #

Magics used to identify various formats.

const magicGNU = "ustar "

magicUSTAR const #

Magics used to identify various formats.

const magicUSTAR = "ustar\x00"

maxSpecialFileSize const #

Max length of a special file (PAX header, GNU long name or link). This matches the limit used by libarchive.

const maxSpecialFileSize = *ast.BinaryExpr