atomicfile

Documentation

Overview

Package atomicfile writes files atomically via temp file + rename.

Index

• func WriteFile(name string, data []byte, mode os.FileMode) error
• func WriteFileRoot(root *os.Root, name string, data []byte, mode os.FileMode) error

Functions

func WriteFile

func WriteFile(name string, data []byte, mode os.FileMode) error

WriteFile writes data to path using a temporary file in the same directory then renaming into place. Parent directories are created as needed. mode is applied to the final file (default 0o644 if zero).

Prefer WriteFileRoot for paths under a sync tree; this helper is for absolute paths outside an os.Root (for example the index under StateDir).

func WriteFileRoot

func WriteFileRoot(root *os.Root, name string, data []byte, mode os.FileMode) error

WriteFileRoot writes data to a path relative to root using a temporary file in the same directory then renaming into place. Parent directories are created under root as needed. mode is applied to the final file (default 0o644 if zero).

name must be relative to root (slash-separated is preferred). All I/O goes through root so path components and symlinks cannot escape the root tree. name is validated with fs.ValidPath and filepath.IsLocal before any I/O.