Skip to content

This release adds 1 notable feature for engineering teams evaluating rollout.

Published 2mo Backup & Recovery
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

backup cli copy-tool cross-platform deduplication file-copy
+14 more
file-transfer linux macos nas python remote-copy rsync-alternative scp-alternative ssh ssh-transfer synology tar-streaming usb-copy windows

ReleasePort's take

Light signal
editorial:auto 2mo

Fast Copy v3.1.2 introduces the `-R, --keep-parents` flag to preserve full source parent paths during multi-source and glob copies.

Why it matters: Enables retention of directory hierarchy in complex copy operations across mixed releases; relevant for workflows using fast-copy command line options.

Summary

AI summary

Updates Scope, Usage ```bash, and Produces /mnt/snap/etc/, /mnt/snap/var/log/, /mnt/snap/home/operator/ across a mixed release.

Changes in this release

Feature Medium

Adds `-R, --keep-parents` flag to preserve full source parent paths in multi-source and glob copies.

Adds `-R, --keep-parents` flag to preserve full source parent paths in multi-source and glob copies.

Source: llm_adapter@2026-05-24

Confidence: high

Bugfix Low

Single-source fast-copy commands ignore `--keep-parents` flag without effect.

Single-source fast-copy commands ignore `--keep-parents` flag without effect.

Source: granite4.1:30b@2026-05-24-audit

Confidence: low

Full changelog

v3.1.2 — 2026-05-24

Adds -R, --keep-parents to multi-source and glob copies. Without the
flag (unchanged default), each source is written under its basename:
fast-copy /etc /var/log dst/ produces dst/etc/ and dst/log/. With
the flag, each source's full parent path is preserved (rsync -R
semantics): the same command produces dst/etc/ and dst/var/log/.

Why this matters

The basename layout is great for Longhorn-style backups where every
source has a unique name (pvc-*). It's wrong for incident snapshots,
forensic captures, and any case where mixing sources from different
parent directories needs unambiguous provenance — dst/log/ does not
tell a future analyst whether the original was /var/log or
/usr/local/log, and two sources with the same basename would silently
merge. --keep-parents preserves the full path so the snapshot tree
mirrors the source filesystem exactly.

Scope

  • Affects multi-source mode (≥2 source paths) and glob mode (single
    quoted pattern fast-copy expands internally).
  • Single-source copies (fast-copy /var/log dst/) emit a one-line note
    and are unchanged — the flag has no observable effect there.
  • No change to any other code path: dedup, sparse-file detection,
    --use-sudo hardening, SSH transfers, and the v3.1.1 security
    posture are all identical.

Usage

# Incident snapshot — preserve full /etc, /var/log, /home/operator
fast-copy --use-sudo -R /etc /var/log /home/operator /mnt/snap/
# Produces /mnt/snap/etc/, /mnt/snap/var/log/, /mnt/snap/home/operator/

# Longhorn replicas (no flag needed — unique basenames already)
fast-copy /var/lib/longhorn/replicas/pvc-* /mnt/backup/

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track Fast_copy new release with new features

Get notified when new releases ship.

Sign up free

About Fast_copy new release with new features

All releases →

Related context

Beta — feedback welcome: [email protected]