mirror of
https://github.com/restic/restic.git
synced 2024-08-23 20:57:24 +02:00
133 lines
4.4 KiB
Go
133 lines
4.4 KiB
Go
package fs
|
|
|
|
import (
|
|
"io"
|
|
"os"
|
|
"path/filepath"
|
|
"time"
|
|
)
|
|
|
|
// File is an open file on a file system.
|
|
type File interface {
|
|
io.Reader
|
|
io.Writer
|
|
io.Closer
|
|
|
|
Fd() uintptr
|
|
Readdirnames(n int) ([]string, error)
|
|
Readdir(int) ([]os.FileInfo, error)
|
|
Seek(int64, int) (int64, error)
|
|
Stat() (os.FileInfo, error)
|
|
}
|
|
|
|
// Mkdir creates a new directory with the specified name and permission bits.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Mkdir(name string, perm os.FileMode) error {
|
|
return os.Mkdir(fixpath(name), perm)
|
|
}
|
|
|
|
// Readlink returns the destination of the named symbolic link.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Readlink(name string) (string, error) {
|
|
return os.Readlink(fixpath(name))
|
|
}
|
|
|
|
// Remove removes the named file or directory.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Remove(name string) error {
|
|
return os.Remove(fixpath(name))
|
|
}
|
|
|
|
// RemoveAll removes path and any children it contains.
|
|
// It removes everything it can but returns the first error
|
|
// it encounters. If the path does not exist, RemoveAll
|
|
// returns nil (no error).
|
|
func RemoveAll(path string) error {
|
|
return os.RemoveAll(fixpath(path))
|
|
}
|
|
|
|
// Rename renames (moves) oldpath to newpath.
|
|
// If newpath already exists, Rename replaces it.
|
|
// OS-specific restrictions may apply when oldpath and newpath are in different directories.
|
|
// If there is an error, it will be of type *LinkError.
|
|
func Rename(oldpath, newpath string) error {
|
|
return os.Rename(fixpath(oldpath), fixpath(newpath))
|
|
}
|
|
|
|
// Symlink creates newname as a symbolic link to oldname.
|
|
// If there is an error, it will be of type *LinkError.
|
|
func Symlink(oldname, newname string) error {
|
|
return os.Symlink(fixpath(oldname), fixpath(newname))
|
|
}
|
|
|
|
// Link creates newname as a hard link to oldname.
|
|
// If there is an error, it will be of type *LinkError.
|
|
func Link(oldname, newname string) error {
|
|
return os.Link(fixpath(oldname), fixpath(newname))
|
|
}
|
|
|
|
// Stat returns a FileInfo structure describing the named file.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Stat(name string) (os.FileInfo, error) {
|
|
return os.Stat(fixpath(name))
|
|
}
|
|
|
|
// Lstat returns the FileInfo structure describing the named file.
|
|
// If the file is a symbolic link, the returned FileInfo
|
|
// describes the symbolic link. Lstat makes no attempt to follow the link.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Lstat(name string) (os.FileInfo, error) {
|
|
return os.Lstat(fixpath(name))
|
|
}
|
|
|
|
// Create creates the named file with mode 0666 (before umask), truncating
|
|
// it if it already exists. If successful, methods on the returned
|
|
// File can be used for I/O; the associated file descriptor has mode
|
|
// O_RDWR.
|
|
// If there is an error, it will be of type *PathError.
|
|
func Create(name string) (*os.File, error) {
|
|
return os.Create(fixpath(name))
|
|
}
|
|
|
|
// Open opens a file for reading.
|
|
func Open(name string) (File, error) {
|
|
return os.Open(fixpath(name))
|
|
}
|
|
|
|
// OpenFile is the generalized open call; most users will use Open
|
|
// or Create instead. It opens the named file with specified flag
|
|
// (O_RDONLY etc.) and perm, (0666 etc.) if applicable. If successful,
|
|
// methods on the returned File can be used for I/O.
|
|
// If there is an error, it will be of type *PathError.
|
|
func OpenFile(name string, flag int, perm os.FileMode) (*os.File, error) {
|
|
return os.OpenFile(fixpath(name), flag, perm)
|
|
}
|
|
|
|
// Walk walks the file tree rooted at root, calling walkFn for each file or
|
|
// directory in the tree, including root. All errors that arise visiting files
|
|
// and directories are filtered by walkFn. The files are walked in lexical
|
|
// order, which makes the output deterministic but means that for very
|
|
// large directories Walk can be inefficient.
|
|
// Walk does not follow symbolic links.
|
|
func Walk(root string, walkFn filepath.WalkFunc) error {
|
|
return filepath.Walk(fixpath(root), walkFn)
|
|
}
|
|
|
|
// RemoveIfExists removes a file, returning no error if it does not exist.
|
|
func RemoveIfExists(filename string) error {
|
|
err := os.Remove(filename)
|
|
if err != nil && os.IsNotExist(err) {
|
|
err = nil
|
|
}
|
|
return err
|
|
}
|
|
|
|
// Chtimes changes the access and modification times of the named file,
|
|
// similar to the Unix utime() or utimes() functions.
|
|
//
|
|
// The underlying filesystem may truncate or round the values to a less
|
|
// precise time unit. If there is an error, it will be of type *PathError.
|
|
func Chtimes(name string, atime time.Time, mtime time.Time) error {
|
|
return os.Chtimes(fixpath(name), atime, mtime)
|
|
}
|