copy

Documentation

Index

• func CopyDir(dst, src string) error
• func CopyFile(src, dst string) (err error)
• func SameFile(a, b string) (bool, error)

Functions

func CopyDir

func CopyDir(dst, src string) error

CopyDir recursively copies all of the files within the directory given in src to the directory given in dst.

Both directories should already exist. If the destination directory is non-empty then the new files will merge in with the old, overwriting any files that have a relative path in common between source and destination.

Recursive copying of directories is inevitably a rather opinionated sort of operation, so this function won't be appropriate for all use-cases. Some of the "opinions" it has are described in the following paragraphs:

Symlinks in the source directory are recreated with the same target in the destination directory. If the symlink is to a directory itself, that directory is not recursively visited for further copying.

File and directory modes are not preserved exactly, but the executable flag is preserved for files on operating systems where it is significant.

Any "dot files" it encounters along the way are skipped, even on platforms that do not normally ascribe special meaning to files with names starting with dots.

Callers may rely on the above details and other undocumented details of this function, so if you intend to change it be sure to review the callers first and make sure they are compatible with the change you intend to make.

func CopyFile

func CopyFile(src, dst string) (err error)

CopyFile copies the contents of the file named src to the file named by dst. The file will be created if it does not already exist. If the destination file exists, all it's contents will be replaced by the contents of the source file. The file mode will be copied from the source and the copied data is synced/flushed to stable storage.

func SameFile

func SameFile(a, b string) (bool, error)

SameFile returns true if the two given paths refer to the same physical file on disk, using the unique file identifiers from the underlying operating system. For example, on Unix systems this checks whether the two files are on the same device and have the same inode.