archive/tar

http://www.freebsd.org/cgi/man.cgi?query=tar&sektion=5
http://www.gnu.org/software/tar/manual/html_node/Standard.html
http://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html

package main

import (
	"archive/tar"
	"bytes"
	"fmt"
	"io"
	"log"
	"os"
)

func main() {
	// 创建一个缓冲区来写入我们的存档。
	buf := new(bytes.Buffer)

	// 创建一个新的tar存档。
	tw := tar.NewWriter(buf)

	// 将一些文件添加到存档中。
	var files = []struct {
		Name, Body string
	}{
		{"readme.txt", "This archive contains some text files."},
		{"gopher.txt", "Gopher names:\nGeorge\nGeoffrey\nGonzo"},
		{"todo.txt", "Get animal handling license."},
	}
	for _, file := range files {
		hdr := &tar.Header{
			Name: file.Name,
			Mode: 0600,
			Size: int64(len(file.Body)),
		}
		if err := tw.WriteHeader(hdr); err != nil {
			log.Fatalln(err)
		}
		if _, err := tw.Write([]byte(file.Body)); err != nil {
			log.Fatalln(err)
		}
	}
	// 确保在Close时检查错误。
	if err := tw.Close(); err != nil {
		log.Fatalln(err)
	}

	// 打开tar档案以供阅读。
	r := bytes.NewReader(buf.Bytes())
	tr := tar.NewReader(r)

	// 迭代档案中的文件。
	for {
		hdr, err := tr.Next()
		if err == io.EOF {
			// tar归档结束
			break
		}
		if err != nil {
			log.Fatalln(err)
		}
		fmt.Printf("Contents of %s:\n", hdr.Name)
		if _, err := io.Copy(os.Stdout, tr); err != nil {
			log.Fatalln(err)
		}
		fmt.Println()
	}

}

const (
        TypeReg           = '0'    // 普通文件
        TypeRegA          = '\x00' // 普通文件
        TypeLink          = '1'    // 硬链接(hard link)
        TypeSymlink       = '2'    // 符号链接
        TypeChar          = '3'    // 字符设备节点
        TypeBlock         = '4'    // 块设备节点
        TypeDir           = '5'    // 目录
        TypeFifo          = '6'    // fifo节点
        TypeCont          = '7'    // 保留
        TypeXHeader       = 'x'    // 扩展标题
        TypeXGlobalHeader = 'g'    // 全局扩展标题
        TypeGNULongName   = 'L'    // 下一个文件名称很长
        TypeGNULongLink   = 'K'    // 接下来将文件符号链接到一个带有长名字的文件
        TypeGNUSparse     = 'S'    // 稀疏文件(sparse file)
)

var (
        ErrWriteTooLong    = errors.New("archive/tar: write too long")
        ErrFieldTooLong    = errors.New("archive/tar: header field too long")
        ErrWriteAfterClose = errors.New("archive/tar: write after close")
)

var (
        ErrHeader = errors.New("archive/tar: invalid tar header")
)

type Header struct {
        Name       string    // 头文件条目的名称
        Mode       int64     // 许可和模式位
        Uid        int       // 所有者的用户ID
        Gid        int       // 所有者的组ID
        Size       int64     // 长度以字节为单位
        ModTime    time.Time // 修改时间
        Typeflag   byte      // 标题条目的类型
        Linkname   string    // 链接的目标名称
        Uname      string    // 所有者的用户名
        Gname      string    // 所有者的组名称
        Devmajor   int64     // 字符或块设备的主要数量
        Devminor   int64     // 少量的字符或块设备
        AccessTime time.Time // 访问时间
        ChangeTime time.Time // 状态更改时间
        Xattrs     map[string]string
}

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

func (h *Header) FileInfo() os.FileInfo

type Reader struct {
        // 包含已过滤或未导出的字段
}

func NewReader(r io.Reader) *Reader

func (tr *Reader) Next() (*Header, error)

func (tr *Reader) Read(b []byte) (int, error)

type Writer struct {
        // 包含过滤或未导出的字段
}

func NewWriter(w io.Writer) *Writer

func (tw *Writer) Close() error

func (tw *Writer) Flush() error

func (tw *Writer) Write(b []byte) (n int, err error)

func (tw *Writer) WriteHeader(hdr *Header) error