fileutil

Documentation

Index

• func AtomicWrite(path string, data []byte, perm os.FileMode) error
• func AtomicWriteExclusive(path string, data []byte, perm os.FileMode) error

Functions

func AtomicWrite

func AtomicWrite(path string, data []byte, perm os.FileMode) error

AtomicWrite writes data to path via a temporary file + rename for crash safety. The perm argument sets the final file permissions (e.g. 0644 for docs, 0755 for hooks).

func AtomicWriteExclusive

func AtomicWriteExclusive(path string, data []byte, perm os.FileMode) error

AtomicWriteExclusive writes data to path via a temporary file + hard link. Unlike AtomicWrite, it fails if path already exists (returns an error where os.IsExist reports true). This avoids the TOCTOU race inherent in Stat-then-Rename patterns.