osutil

package
v0.14.54 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 5, 2018 License: MPL-2.0 Imports: 19 Imported by: 0

Documentation

Overview

Package osutil implements utilities for native OS support.

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrClosed  = errors.New("write to closed writer")
	TempPrefix = ".syncthing.tmp."
)

Functions

func Copy

func Copy(filesystem fs.Filesystem, from, to string) (err error)

Copy copies the file content from source to destination. Tries hard to succeed on various systems by temporarily tweaking directory permissions and removing the destination file when necessary.

func DebugSymlinkForTestsOnly added in v0.14.42

func DebugSymlinkForTestsOnly(oldname, newname string) error

DebugSymlinkForTestsOnly is not and should not be used in Syncthing code, hence the cumbersome name to make it obvious if this ever leaks. Its reason for existence is the Windows version, which allows creating symlinks when non-elevated.

func GetLans

func GetLans() ([]*net.IPNet, error)

func GetLatencyForURL added in v0.12.0

func GetLatencyForURL(addr string) (time.Duration, error)

GetLatencyForURL parses the given URL, tries opening a TCP connection to it and returns the time it took to establish the connection.

func HideConsole

func HideConsole()

func InWritableDir

func InWritableDir(fn func(string) error, fs fs.Filesystem, path string) error

InWritableDir calls fn(path), while making sure that the directory containing `path` is writable for the duration of the call.

func IsDeleted added in v0.14.46

func IsDeleted(ffs fs.Filesystem, name string) bool

func MaximizeOpenFileLimit

func MaximizeOpenFileLimit() (int, error)

MaximizeOpenFileLimit tries to set the resource limit RLIMIT_NOFILE (number of open file descriptors) to the max (hard limit), if the current (soft limit) is below the max. Returns the new (though possibly unchanged) limit, or an error if it could not be changed.

func NativeFilename

func NativeFilename(s string) string

func NormalizedFilename

func NormalizedFilename(s string) string

func Rename

func Rename(filesystem fs.Filesystem, from, to string) error

Rename moves a temporary file to its final place. Will make sure to delete the from file if the operation fails, so use only for situations like committing a temp file to its final location. Tries hard to succeed on various systems by temporarily tweaking directory permissions and removing the destination file when necessary.

func ResolveInterfaceAddresses added in v0.14.37

func ResolveInterfaceAddresses(network, nameOrMac string) []string

ResolveInterfaceAddresses returns available addresses of the given network type for a given interface.

func SetLowPriority added in v0.14.44

func SetLowPriority() error

SetLowPriority lowers the process CPU scheduling priority, and possibly I/O priority depending on the platform and OS.

func TCPPing added in v0.12.0

func TCPPing(address string) (time.Duration, error)

TCPPing returns the duration required to establish a TCP connection to the given host. ICMP packets require root privileges, hence why we use tcp.

func TempFile added in v0.14.37

func TempFile(filesystem fs.Filesystem, dir, prefix string) (f fs.File, err error)

TempFile creates a new temporary file in the directory dir with a name beginning with prefix, opens the file for reading and writing, and returns the resulting *os.File. If dir is the empty string, TempFile uses the default directory for temporary files (see os.TempDir). Multiple programs calling TempFile simultaneously will not choose the same file. The caller can use f.Name() to find the pathname of the file. It is the caller's responsibility to remove the file when no longer needed.

func TraversesSymlink(filesystem fs.Filesystem, name string) error

TraversesSymlink returns an error if any path component of name (including name itself) traverses a symlink.

func TryRename

func TryRename(filesystem fs.Filesystem, from, to string) error

TryRename renames a file, leaving source file intact in case of failure. Tries hard to succeed on various systems by temporarily tweaking directory permissions and removing the destination file when necessary.

Types

type AtomicWriter

type AtomicWriter struct {
	// contains filtered or unexported fields
}

An AtomicWriter is an *os.File that writes to a temporary file in the same directory as the final path. On successful Close the file is renamed to its final path. Any error on Write or during Close is accumulated and returned on Close, so a lazy user can ignore errors until Close.

func CreateAtomic

func CreateAtomic(path string) (*AtomicWriter, error)

CreateAtomic is like os.Create, except a temporary file name is used instead of the given name. The file is created with secure (0600) permissions.

func CreateAtomicFilesystem added in v0.14.37

func CreateAtomicFilesystem(filesystem fs.Filesystem, path string) (*AtomicWriter, error)

CreateAtomicFilesystem is like os.Create, except a temporary file name is used instead of the given name. The file is created with secure (0600) permissions.

func (*AtomicWriter) Close

func (w *AtomicWriter) Close() error

Close closes the temporary file and renames it to the final path. It is invalid to call Write() or Close() after Close().

func (*AtomicWriter) Write

func (w *AtomicWriter) Write(bs []byte) (int, error)

Write is like io.Writer, but is a no-op on an already failed AtomicWriter.

type NotADirectoryError added in v0.14.19

type NotADirectoryError struct {
	// contains filtered or unexported fields
}

NotADirectoryError is an error indicating an expected path is not a directory

func (NotADirectoryError) Error added in v0.14.19

func (e NotADirectoryError) Error() string

type ReplacingWriter

type ReplacingWriter struct {
	Writer io.Writer
	From   byte
	To     []byte
}

func (ReplacingWriter) Write

func (w ReplacingWriter) Write(bs []byte) (int, error)

type TraversesSymlinkError added in v0.14.19

type TraversesSymlinkError struct {
	// contains filtered or unexported fields
}

TraversesSymlinkError is an error indicating symlink traversal

func (TraversesSymlinkError) Error added in v0.14.19

func (e TraversesSymlinkError) Error() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL