CASYNC(1) casync CASYNC(1) (NAME) casync - (SYNOPSIS) casync [OPTIONS...] make [ARCHIVE | ARCHIVE_INDEX | BLOB_INDEX] [PATH] casync [OPTIONS...] extract [ARCHIVE | ARCHIVE_INDEX | BLOB_INDEX] [PATH] casync [OPTIONS...] list [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] casync [OPTIONS...] mtree [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] casync [OPTIONS...] stat [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] casync [OPTIONS...] digest [ARCHIVE | BLOB | ARCHIVE_INDEX | BLOB_INDEX | DIRECTORY] [PATH] casync [OPTIONS...] mount [ARCHIVE | ARCHIVE_INDEX] PATH casync [OPTIONS...] mkdev [BLOB | BLOB_INDEX] [NODE] casync [OPTIONS...] gc BLOB_INDEX | ARCHIVE_INDEX ... (DESCRIPTION) (Content-Addressable Data Synchronization Tool). (COMMANDS) casync make [ARCHIVE | ARCHIVE_INDEX] [DIRECTORY] casync make [BLOB_INDEX] FILE | DEVICE .catar (index) .caidx DIRECTORY .caibx FILE DEVICE . ( --what= ). DIRECTORY . .caidx .caibx .castr default.castr ( --store= ). --with-* --without-* . casync extract [ARCHIVE | ARCHIVE_INDEX] [DIRECTORY] casync extract BLOB_INDEX FILE | DEVICE .catar .caidx DIRECTORY BLOB_INDEX FILE DEVICE . DIRECTORY . --with-* --without-* . casync list [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] PATH ARCHIVE ARCHIVE_INDEX DIRECTORY . () (/) . : $ casync list /usr/share/doc/casync drwxr-xr-x -rw-r--r-- README.md -rw-r--r-- TODO casync mtree [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] list = (key=value) BSD mtree(5) : $ casync mtree /usr/share/doc/casync . type=dir mode=0755 uid=0 gid=0 time=1500343585.721189650 README.md type=file mode=0644 size=7286 uid=0 gid=0 time=1498175562.000000000 sha256digest=af75eacac1f00abf6adaa7510a2c7fe00a4636daf9ea910d69d96f0a4ae85df4 TODO type=file mode=0644 size=2395 uid=0 gid=0 time=1498175562.000000000 sha256digest=316f11a03c08ec39f0328ab1f7446bd048507d3fbeafffe7c32fad4942244b7d casync stat [ARCHIVE | ARCHIVE_INDEX | DIRECTORY] [PATH] PATH ARCHIVE ARCHIVE_INDEX DIRECTORY . (/) . : $ casync stat . File: . Mode: drwxrwxr-x FileAttr: ---------- FATAttr: --- Offset: 0 Time: 2017-07-17 22:53:30.723304050 User: zbyszek (1000) Group: zbyszek (1000) casync digest [BLOB | BLOB_INDEX | DIRECTORY] casync digest ARCHIVE | ARCHIVE_INDEX [PATH] (checksum) PATH ARCHIVE ARCHIVE_INDEX . (/) . : $ casync digest d1698b0c4c27163284abea5d1e369b92e89dd07cb74378638849800e0406baf7 $ casync digest . d1698b0c4c27163284abea5d1e369b92e89dd07cb74378638849800e0406baf7 casync mount [ARCHIVE | ARCHIVE_INDEX] PATH .catar .caidx PATH FUSE (mount) . casync mkdev [BLOB | BLOB_INDEX] [NODE] NODE BLOB_INDEX .caibx BLOB NBD . : $ sudo casync -v mkdev README.md Attached: /dev/nbd0 (in another terminal) $ sudo head -n1 /dev/nbd0 # casync -- Content Addressable Data Synchronizer casync mkdev (kill ) . casync gc ARCHIVE_INDEX | BLOB_INDEX ... (chunks) ( blob archive ). --store . . (OPTIONS) : --help, -h --version --log-level=, -l (debug info err) --verbose, -v --dry-run, -n gc ( ) --store=PATH (chunk store) --extra-store= --chunk-size=<[MIN:]AVG[:MAX]> // --digest= / (sha512-256 sha256) --compression= (zstd xz gzip) --seed= (seed) --cache= ( ) --cache-auto, -c --rate-limit-bps= --exclude-nodump=no nodump +d chattr(1) --exclude-submounts=yes (submounts) --exclude-file=no .caexclude --reflink=no (reflink) --hardlink=yes (hardlink) --punch-holes=no (sparse) --delete=no --undo-immutable=yes +i ( immutable) chattr(1) --seed-output=no --recursive=no --mkdir=no (mount) --uid-shift= / (UID/GID) --uid-range= UID/GID /: --what=archive --what=archive-index --what=blob (blob) --what=blob-index (blob index) --what=directory --what=help ( ) : --with=best --with=unix --with=fat FAT --with=chattr chattr(1) --with=fat-attrs FAT --with=privileged --with=fuse 'casync mount' (off) --without= --without=fat-attrs --without=privileged . --without=all . ( --with=all . --with=best .) : --with=<16bit-uids> UID/GID --with=<32bit-uids> UID/GID --with= / --with= --with= (s) --with= (ns) --with=<2sec-time> --with= --with= --with= --with= --with= (FIFO) --with= AF_UNIX --with= "hidden" FAT --with= "system" FAT --with= "archive" FAT --with= "append-only" --with= "disable access time" --with= "enable compression" --with= "disable copy-on-write" --with= "disable dumping" --with= "synchronous" --with= "immutable" --with= "synchronous" --with= "disable compression" --with= "project quota inheritance" --with= (subvolume) btrfs --with= btrfs --with= (xattrs) --with= (ACL) --with= SElinux --with= (file capabilities) --with= ext4/XFS ( : --without=16bit-uids --without=32bit-uids ...) (ARCHIVE FEATURES) --with= --without= . casync . (EXCLUDING FILES AND DIRECTORIES FROM ARCHIVING) : 1. API ( procfs sysfs cgroupfs devpts ... -- tmpfs/devtmpfs) . 2. FIFO --with= --without= . 3. +d chattr(1) --exclude-nodump=no . 4. --exclude-submounts=yes (submounts) . 5. .caexclude --exclude-file=no . .gitignore git : / # ( ) (globbing) / . / .caexclude . / .caexclude . .caexclude .caexclude . / . ! . ! . ! .caexclude . 1 August 12, 2026 CASYNC(1)