From da7149a9747ee45737191e7246d581eaef63291c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hermann?= Date: Wed, 18 Mar 2026 09:51:01 +0100 Subject: [PATCH] doc: update readme --- docs/user-guide.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/user-guide.md b/docs/user-guide.md index 27b2f30..cc9dbff 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -585,9 +585,8 @@ Prefer `*_secret` fields and secret refs in `profiles.yaml`. Supported schemes: - `env://VAR_NAME` - `keychain://service/account` (macOS) - -`wincred://...` (Windows) and `secret-service://...` (Linux) are planned but not -yet available in the default CLI resolver. +- `wincred://target` (Windows) +- `secret-service://collection/item` (Linux) Legacy `*_env` fields are still read for backward compatibility, but new writes should use `*_secret`. @@ -668,6 +667,13 @@ directory (`-format dir`). By default, the format is inferred from `-output`. If `-output` ends with `.zip`, Cloudstic uses ZIP format; otherwise it restores to a directory. +In directory mode, Cloudstic creates parent directories automatically and, on +macOS and Linux, replays captured metadata on a best-effort basis (for example +mode bits, ownership, modification times, xattrs, and file flags where the +destination filesystem supports them). Existing files are skipped with warnings +instead of being overwritten, so rerunning the same restore into the same output +directory is safe. + ```bash # Restore the latest snapshot cloudstic restore @@ -1167,7 +1173,7 @@ cloudstic backup -source local:~/project -exclude-file .backupignore Cloudstic walks the directory recursively. Symbolic links are not followed. -**Extended file attributes:** By default, Cloudstic captures POSIX permissions (mode bits), numeric ownership (uid/gid), file creation time (btime, where supported), per-file flags, and extended attributes (xattrs). These are stored in each snapshot and will be used by future restore modes to faithfully recreate file metadata. To control what is captured: +**Extended file attributes:** By default, Cloudstic captures POSIX permissions (mode bits), numeric ownership (uid/gid), file creation time (btime, where supported), per-file flags, and extended attributes (xattrs). Directory restores on macOS and Linux replay this metadata on a best-effort basis where supported by the destination filesystem. Known OS-managed xattrs that are not meaningfully restorable, such as `com.apple.provenance`, are excluded automatically. To control what is captured: ```bash # Skip all POSIX metadata (mode, uid, gid, btime, flags)