filesystem

Documentation

Overview

Package filesystem provides utility functions for file system operations.

Index

• func CopyDir(source string, destination string) error
• func CopyFile(src, dst string) (retErr error)
• func CreateSymlinkOrCopy(source, target string) error
• func IsSymlink(path string) bool

Functions

func CopyDir

func CopyDir(source string, destination string) error

CopyDir recursively copies a directory tree, attempting to preserve permissions. Source directory must exist, destination directory must *not* exist. Uses Lstat on the source root to reject symlinks and prevent following links to attacker-controlled locations.

func CopyFile

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

CopyFile copies a single file from src to dst. Rejects symlinks as source to prevent symlink-based attacks. Uses Lstat pre-check for symlinks, then open-then-fstat for size validation.

func CreateSymlinkOrCopy

func CreateSymlinkOrCopy(source, target string) error

CreateSymlinkOrCopy creates a symlink from target to source, or falls back to copy on failure. Uses relative paths for portability. Works on Linux, macOS, and Windows (with fallback).

func IsSymlink

func IsSymlink(path string) bool

IsSymlink checks if the given path is a symbolic link