cp

Documentation

Overview

Package cp implements the cp core utility.

Index

• Variables
• func Copy(src, dst string) error
• func CopyTree(src, dst string) error
• func New() core.Command
• type Options
  • func (o Options) Copy(src, dst string) error
  • func (o Options) CopyTree(src, dst string) error

Variables

var Default = Options{}

Default are the default options. Default follows symlinks.

var ErrSkip = errors.New("skip")

ErrSkip can be returned by PreCallback to skip a file.

var NoFollowSymlinks = Options{
	NoFollowSymlinks: true,
}

NoFollowSymlinks is the default options with following symlinks turned off.

Functions

func Copy

func Copy(src, dst string) error

Copy src file to dst file using Default's config.

func CopyTree

func CopyTree(src, dst string) error

CopyTree recursively copies all files in the src tree to dst using Default's config.

func New

func New() core.Command

New creates a new cp command.

Types

type Options

type Options struct {
	// If NoFollowSymlinks is set, Copy copies the symlink itself rather
	// than following the symlink and copying the file it points to.
	NoFollowSymlinks bool

	// PreCallback is called on each file to be copied before it is copied
	// if specified.
	//
	// If PreCallback returns ErrSkip, the file is skipped and Copy returns
	// nil.
	//
	// If PreCallback returns another non-nil error, the file is not copied
	// and Copy returns the error.
	PreCallback func(src, dst string, srcfi os.FileInfo) error

	// PostCallback is called on each file after it is copied if specified.
	PostCallback func(src, dst string)

	// WorkingDir is the working directory for relative path resolution.
	WorkingDir string
}

Options are configuration options for how copying files should behave.

func (Options) Copy

func (o Options) Copy(src, dst string) error

Copy copies a file at src to dst.

func (Options) CopyTree

func (o Options) CopyTree(src, dst string) error

CopyTree recursively copies all files in the src tree to dst.